1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
8 "Project-Id-Version: PACKAGE VERSION\n"
9 "POT-Creation-Date: 2013-07-15 16:07+0900\n"
10 "PO-Revision-Date: 2013-07-15 16:31+0900\n"
11 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
12 "Language-Team: LANGUAGE <LL@li.org>\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
19 #: build/C/man2/add_key.2:11
25 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:21
26 #: build/C/man2/request_key.2:11
32 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:21
33 #: build/C/man2/request_key.2:11
39 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:21
40 #: build/C/man2/request_key.2:11
42 msgid "Linux Key Management Calls"
43 msgstr "Linux Key Management Calls"
46 #: build/C/man2/add_key.2:12 build/C/man2/keyctl.2:22
47 #: build/C/man2/request_key.2:12
53 #: build/C/man2/add_key.2:14
54 msgid "add_key - add a key to the kernel's key management facility"
58 #: build/C/man2/add_key.2:14 build/C/man2/keyctl.2:24
59 #: build/C/man2/request_key.2:14
65 #: build/C/man2/add_key.2:17 build/C/man2/keyctl.2:27
66 #: build/C/man2/request_key.2:17
68 msgid "B<#include E<lt>keyutils.hE<gt>>\n"
69 msgstr "B<#include E<lt>keyutils.hE<gt>>\n"
72 #: build/C/man2/add_key.2:21
75 "B<key_serial_t add_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
76 "B< const void *>I<payload>B<, size_t >I<plen>B<,>\n"
77 "B< key_serial_t >I<keyring>B<);>\n"
79 "B<key_serial_t add_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
80 "B< const void *>I<payload>B<, size_t >I<plen>B<,>\n"
81 "B< key_serial_t >I<keyring>B<);>\n"
84 #: build/C/man2/add_key.2:22 build/C/man2/keyctl.2:30
85 #: build/C/man2/request_key.2:22
91 #: build/C/man2/add_key.2:35
93 "B<add_key>() asks the kernel to create or update a key of the given I<type> "
94 "and I<description>, instantiate it with the I<payload> of length I<plen>, "
95 "and to attach it to the nominated I<keyring> and to return its serial number."
99 #: build/C/man2/add_key.2:38
101 "The key type may reject the data if it's in the wrong format or in some "
106 #: build/C/man2/add_key.2:46
108 "If the destination I<keyring> already contains a key that matches the "
109 "specified I<type> and I<description> then, if the key type supports it, that "
110 "key will be updated rather than a new key being created; if not, a new key "
111 "will be created and it will displace the link to the extant key from the "
116 #: build/C/man2/add_key.2:51
118 "The destination I<keyring> serial number may be that of a valid keyring to "
119 "which the caller has write permission, or it may be a special keyring ID:"
123 #: build/C/man2/add_key.2:51 build/C/man2/request_key.2:74
125 msgid "B<KEY_SPEC_THREAD_KEYRING>"
126 msgstr "B<KEY_SPEC_THREAD_KEYRING>"
129 #: build/C/man2/add_key.2:54 build/C/man2/request_key.2:77
130 msgid "This specifies the caller's thread-specific keyring."
134 #: build/C/man2/add_key.2:54 build/C/man2/request_key.2:77
136 msgid "B<KEY_SPEC_PROCESS_KEYRING>"
137 msgstr "B<KEY_SPEC_PROCESS_KEYRING>"
140 #: build/C/man2/add_key.2:57 build/C/man2/request_key.2:80
141 msgid "This specifies the caller's process-specific keyring."
145 #: build/C/man2/add_key.2:57 build/C/man2/request_key.2:80
147 msgid "B<KEY_SPEC_SESSION_KEYRING>"
148 msgstr "B<KEY_SPEC_SESSION_KEYRING>"
151 #: build/C/man2/add_key.2:60 build/C/man2/request_key.2:83
152 msgid "This specifies the caller's session-specific keyring."
156 #: build/C/man2/add_key.2:60 build/C/man2/request_key.2:83
158 msgid "B<KEY_SPEC_USER_KEYRING>"
159 msgstr "B<KEY_SPEC_USER_KEYRING>"
162 #: build/C/man2/add_key.2:63 build/C/man2/request_key.2:86
163 msgid "This specifies the caller's UID-specific keyring."
167 #: build/C/man2/add_key.2:63 build/C/man2/request_key.2:86
169 msgid "B<KEY_SPEC_USER_SESSION_KEYRING>"
170 msgstr "B<KEY_SPEC_USER_SESSION_KEYRING>"
173 #: build/C/man2/add_key.2:66 build/C/man2/request_key.2:89
174 msgid "This specifies the caller's UID-session keyring."
178 #: build/C/man2/add_key.2:66
184 #: build/C/man2/add_key.2:69
186 "There are a number of key types available in the core key management code, "
187 "and these can be specified to this function:"
191 #: build/C/man2/add_key.2:69
197 #: build/C/man2/add_key.2:80
199 "Keys of the user-defined key type may contain a blob of arbitrary data, and "
200 "the I<description> may be any valid string, though it is preferred that the "
201 "description be prefixed with a string representing the service to which the "
202 "key is of interest and a colon (for instance ``B<afs:mykey>''). The "
203 "I<payload> may be empty or NULL for keys of this type."
207 #: build/C/man2/add_key.2:80
209 msgid "B<``keyring''>"
210 msgstr "B<``keyring''>"
213 #: build/C/man2/add_key.2:89
215 "Keyrings are special key types that may contain links to sequences of other "
216 "keys of any type. If this interface is used to create a keyring, then a "
217 "NULL I<payload> should be specified, and I<plen> should be zero."
221 #: build/C/man2/add_key.2:89 build/C/man2/keyctl.2:91
222 #: build/C/man2/request_key.2:94
228 #: build/C/man2/add_key.2:95
230 "On success B<add_key>() returns the serial number of the key it created or "
231 "updated. On error, the value -1 will be returned and errno will have been "
232 "set to an appropriate error."
236 #: build/C/man2/add_key.2:95 build/C/man2/keyctl.2:97
237 #: build/C/man2/request_key.2:100
243 #: build/C/man2/add_key.2:96 build/C/man2/keyctl.2:114
244 #: build/C/man2/request_key.2:123
250 #: build/C/man2/add_key.2:99
251 msgid "The keyring doesn't exist."
255 #: build/C/man2/add_key.2:99 build/C/man2/keyctl.2:105
256 #: build/C/man2/request_key.2:111
258 msgid "B<EKEYEXPIRED>"
259 msgstr "B<EKEYEXPIRED>"
262 #: build/C/man2/add_key.2:102
263 msgid "The keyring has expired."
267 #: build/C/man2/add_key.2:102 build/C/man2/keyctl.2:111
268 #: build/C/man2/request_key.2:117
270 msgid "B<EKEYREVOKED>"
271 msgstr "B<EKEYREVOKED>"
274 #: build/C/man2/add_key.2:105
275 msgid "The keyring has been revoked."
279 #: build/C/man2/add_key.2:105
285 #: build/C/man2/add_key.2:108
286 msgid "The payload data was invalid."
290 #: build/C/man2/add_key.2:108 build/C/man2/request_key.2:120
296 #: build/C/man2/add_key.2:111 build/C/man2/request_key.2:123
297 msgid "Insufficient memory to create a key."
301 #: build/C/man2/add_key.2:111 build/C/man2/keyctl.2:101
302 #: build/C/man2/request_key.2:107
308 #: build/C/man2/add_key.2:115 build/C/man2/request_key.2:111
310 "The key quota for this user would be exceeded by creating this key or "
311 "linking it to the keyring."
315 #: build/C/man2/add_key.2:115 build/C/man2/keyctl.2:98
316 #: build/C/man2/request_key.2:101
322 #: build/C/man2/add_key.2:118 build/C/man2/request_key.2:104
323 msgid "The keyring wasn't available for modification by the user."
327 #: build/C/man2/add_key.2:118 build/C/man2/keyctl.2:117
328 #: build/C/man2/request_key.2:126
334 #: build/C/man2/add_key.2:126 build/C/man2/keyctl.2:125
335 #: build/C/man2/request_key.2:134
337 "Although this is a Linux system call, it is not present in I<libc> but can "
338 "be found rather in I<libkeyutils>. When linking, B<-lkeyutils> should be "
339 "specified to the linker."
343 #: build/C/man2/add_key.2:126 build/C/man2/keyctl.2:125
344 #: build/C/man2/request_key.2:134
350 #: build/C/man2/add_key.2:130
351 msgid "B<keyctl>(1), B<keyctl>(2), B<request_key>(2)"
352 msgstr "B<keyctl>(1), B<keyctl>(2), B<request_key>(2)"
355 #: build/C/man2/add_key.2:130 build/C/man2/keyctl.2:151
356 #: build/C/man2/request_key.2:139
362 #: build/C/man2/add_key.2:137 build/C/man2/keyctl.2:158
363 #: build/C/man2/request_key.2:146
365 "This page is part of release 3.52 of the Linux I<man-pages> project. A "
366 "description of the project, and information about reporting bugs, can be "
367 "found at \\%http://www.kernel.org/doc/man-pages/."
369 "この man ページは Linux I<man-pages> プロジェクトのリリース 3.52 の一部\n"
370 "である。プロジェクトの説明とバグ報告に関する情報は\n"
371 "http://www.kernel.org/doc/man-pages/ に書かれている。"
374 #: build/C/man2/keyctl.2:21
380 #: build/C/man2/keyctl.2:24
381 msgid "keyctl - manipulate the kernel's key management facility"
385 #: build/C/man2/keyctl.2:29
387 msgid "B<long keyctl(int >I<cmd>B<, ...);>\n"
388 msgstr "B<long keyctl(int >I<cmd>B<, ...);>\n"
391 #: build/C/man2/keyctl.2:33
392 msgid "B<keyctl>() has a number of functions available:"
396 #: build/C/man2/keyctl.2:33
398 msgid "B<KEYCTL_GET_KEYRING_ID>"
399 msgstr "B<KEYCTL_GET_KEYRING_ID>"
402 #: build/C/man2/keyctl.2:36
403 msgid "Ask for a keyring's ID."
407 #: build/C/man2/keyctl.2:36
409 msgid "B<KEYCTL_JOIN_SESSION_KEYRING>"
410 msgstr "B<KEYCTL_JOIN_SESSION_KEYRING>"
413 #: build/C/man2/keyctl.2:39
414 msgid "Join or start named session keyring."
418 #: build/C/man2/keyctl.2:39
420 msgid "B<KEYCTL_UPDATE>"
421 msgstr "B<KEYCTL_UPDATE>"
424 #: build/C/man2/keyctl.2:42
425 msgid "Update a key."
429 #: build/C/man2/keyctl.2:42
431 msgid "B<KEYCTL_REVOKE>"
432 msgstr "B<KEYCTL_REVOKE>"
435 #: build/C/man2/keyctl.2:45
436 msgid "Revoke a key."
440 #: build/C/man2/keyctl.2:45
442 msgid "B<KEYCTL_CHOWN>"
443 msgstr "B<KEYCTL_CHOWN>"
446 #: build/C/man2/keyctl.2:48
447 msgid "Set ownership of a key."
451 #: build/C/man2/keyctl.2:48
453 msgid "B<KEYCTL_SETPERM>"
454 msgstr "B<KEYCTL_SETPERM>"
457 #: build/C/man2/keyctl.2:51
458 msgid "Set perms on a key."
462 #: build/C/man2/keyctl.2:51
464 msgid "B<KEYCTL_DESCRIBE>"
465 msgstr "B<KEYCTL_DESCRIBE>"
468 #: build/C/man2/keyctl.2:54
469 msgid "Describe a key."
473 #: build/C/man2/keyctl.2:54
475 msgid "B<KEYCTL_CLEAR>"
476 msgstr "B<KEYCTL_CLEAR>"
479 #: build/C/man2/keyctl.2:57
480 msgid "Clear contents of a keyring."
484 #: build/C/man2/keyctl.2:57
486 msgid "B<KEYCTL_LINK>"
487 msgstr "B<KEYCTL_LINK>"
490 #: build/C/man2/keyctl.2:60
491 msgid "Link a key into a keyring."
495 #: build/C/man2/keyctl.2:60
497 msgid "B<KEYCTL_UNLINK>"
498 msgstr "B<KEYCTL_UNLINK>"
501 #: build/C/man2/keyctl.2:63
502 msgid "Unlink a key from a keyring."
506 #: build/C/man2/keyctl.2:63
508 msgid "B<KEYCTL_SEARCH>"
509 msgstr "B<KEYCTL_SEARCH>"
512 #: build/C/man2/keyctl.2:66
513 msgid "Search for a key in a keyring."
517 #: build/C/man2/keyctl.2:66
519 msgid "B<KEYCTL_READ>"
520 msgstr "B<KEYCTL_READ>"
523 #: build/C/man2/keyctl.2:69
524 msgid "Read a key or keyring's contents."
528 #: build/C/man2/keyctl.2:69
530 msgid "B<KEYCTL_INSTANTIATE>"
531 msgstr "B<KEYCTL_INSTANTIATE>"
534 #: build/C/man2/keyctl.2:72
535 msgid "Instantiate a partially constructed key."
539 #: build/C/man2/keyctl.2:72
541 msgid "B<KEYCTL_NEGATE>"
542 msgstr "B<KEYCTL_NEGATE>"
545 #: build/C/man2/keyctl.2:75
546 msgid "Negate a partially constructed key."
550 #: build/C/man2/keyctl.2:75
552 msgid "B<KEYCTL_SET_REQKEY_KEYRING>"
553 msgstr "B<KEYCTL_SET_REQKEY_KEYRING>"
556 #: build/C/man2/keyctl.2:78
557 msgid "Set default request-key keyring."
561 #: build/C/man2/keyctl.2:78
563 msgid "B<KEYCTL_SET_TIMEOUT>"
564 msgstr "B<KEYCTL_SET_TIMEOUT>"
567 #: build/C/man2/keyctl.2:81
568 msgid "Set timeout on a key."
572 #: build/C/man2/keyctl.2:81
574 msgid "B<KEYCTL_ASSUME_AUTHORITY>"
575 msgstr "B<KEYCTL_ASSUME_AUTHORITY>"
578 #: build/C/man2/keyctl.2:84
579 msgid "Assume authority to instantiate key."
583 #: build/C/man2/keyctl.2:91
585 "These are wrapped by B<libkeyutils> into individual functions to permit "
586 "compiler the compiler to check types. See the B<See Also> section at the "
591 #: build/C/man2/keyctl.2:97
593 "On success B<keyctl>() returns the serial number of the key it found. On "
594 "error, the value -1 will be returned and errno will have been set to an "
599 #: build/C/man2/keyctl.2:101
600 msgid "A key operation wasn't permitted."
604 #: build/C/man2/keyctl.2:105
606 "The key quota for the caller's user would be exceeded by creating a key or "
607 "linking it to the keyring."
611 #: build/C/man2/keyctl.2:108
612 msgid "An expired key was found or specified."
616 #: build/C/man2/keyctl.2:108 build/C/man2/request_key.2:114
618 msgid "B<EKEYREJECTED>"
619 msgstr "B<EKEYREJECTED>"
622 #: build/C/man2/keyctl.2:111
623 msgid "A rejected key was found or specified."
627 #: build/C/man2/keyctl.2:114
628 msgid "A revoked key was found or specified."
632 #: build/C/man2/keyctl.2:117
633 msgid "No matching key was found or an invalid key was specified."
637 #: build/C/man2/keyctl.2:151
639 "B<keyctl>(1), B<add_key>(2), B<request_key>(2), B<keyctl_set_timeout>(3), "
640 "B<keyctl_chown>(3), B<keyctl_clear>(3), B<keyctl_describe>(3), "
641 "B<keyctl_describe_alloc>(3), B<keyctl_get_keyring_ID>(3), "
642 "B<keyctl_instantiate>(3), B<keyctl_join_session_keyring>(3), B<keyctl_link>"
643 "(3), B<keyctl_negate>(3), B<keyctl_revoke>(3), B<keyctl_search>(3), "
644 "B<keyctl_setperm>(3), B<keyctl_set_reqkey_keyring>(3), B<keyctl_set_timeout>"
645 "(3), B<keyctl_read>(3), B<keyctl_read_alloc>(3), B<keyctl_unlink>(3), "
646 "B<keyctl_update>(3), B<request-key>(8)"
650 #: build/C/man2/request_key.2:11
656 #: build/C/man2/request_key.2:14
657 msgid "request_key - request a key from the kernel's key management facility"
661 #: build/C/man2/request_key.2:21
664 "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
665 "B< const char *>I<callout_info>B<,>\n"
666 "B< key_serial_t >I<keyring>B<);>\n"
668 "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
669 "B< const char *>I<callout_info>B<,>\n"
670 "B< key_serial_t >I<keyring>B<);>\n"
673 #: build/C/man2/request_key.2:31
675 "B<request_key>() asks the kernel to find a key of the given I<type> that "
676 "matches the specified I<description> and, if successful, to attach it to the "
677 "nominated I<keyring> and to return its serial number."
681 #: build/C/man2/request_key.2:36
683 "B<request_key>() first recursively searches all the keyrings attached to "
684 "the calling process in the order thread-specific keyring, process-specific "
685 "keyring and then session keyring for a matching key."
689 #: build/C/man2/request_key.2:44
691 "If B<request_key>() is called from a program invoked by B<request_key>() "
692 "on behalf of some other process to generate a key, then the keyrings of that "
693 "other process will be searched next, using that other process's UID, GID, "
694 "groups and security context to control access."
698 #: build/C/man2/request_key.2:52
700 "The keys in each keyring searched are checked for a match before any child "
701 "keyrings are recursed into. Only keys that are B<searchable> for the caller "
702 "may be found, and only B<searchable> keyrings may be searched."
706 #: build/C/man2/request_key.2:61
708 "If the key is not found then, if I<callout_info> is set, this function will "
709 "attempt to look further afield. In such a case, the I<callout_info> is "
710 "passed to a user-space service such as B</sbin/request-key> to generate the "
715 #: build/C/man2/request_key.2:69
717 "If that is unsuccessful also, then an error will be returned, and a "
718 "temporary negative key will be installed in the nominated I<keyring>. This "
719 "will expire after a few seconds, but will cause subsequent calls to "
720 "B<request_key>() to fail until it does."
724 #: build/C/man2/request_key.2:74
726 "The I<keyring> serial number may be that of a valid keyring to which the "
727 "caller has write permission, or it may be a special keyring ID:"
731 #: build/C/man2/request_key.2:94
733 "If a key is created, no matter whether it's a valid key or a negative key, "
734 "it will displace any other key of the same type and description from the "
735 "destination I<keyring>."
739 #: build/C/man2/request_key.2:100
741 "On success B<request_key>() returns the serial number of the key it found. "
742 "On error, the value -1 will be returned and errno will have been set to an "
747 #: build/C/man2/request_key.2:104
753 #: build/C/man2/request_key.2:107
754 msgid "The request was interrupted by a signal."
758 #: build/C/man2/request_key.2:114
759 msgid "An expired key was found, but no replacement could be obtained."
763 #: build/C/man2/request_key.2:117
764 msgid "The attempt to generate a new key was rejected."
768 #: build/C/man2/request_key.2:120
769 msgid "A revoked key was found, but no replacement could be obtained."
773 #: build/C/man2/request_key.2:126
774 msgid "No matching key was found."
778 #: build/C/man2/request_key.2:139
779 msgid "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"
780 msgstr "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"
782 #~ msgid "B<keyctl>(1),"
783 #~ msgstr "B<keyctl>(1),"
785 #~ msgid "B<add_key>(2),"
786 #~ msgstr "B<add_key>(2),"
788 #~ msgid "B<request_key>(2),"
789 #~ msgstr "B<request_key>(2),"
791 #~ msgid "B<keyctl_get_keyring_ID>(3),"
792 #~ msgstr "B<keyctl_get_keyring_ID>(3),"
794 #~ msgid "B<keyctl_join_session_keyring>(3),"
795 #~ msgstr "B<keyctl_join_session_keyring>(3),"
797 #~ msgid "B<keyctl_update>(3),"
798 #~ msgstr "B<keyctl_update>(3),"
800 #~ msgid "B<keyctl_revoke>(3),"
801 #~ msgstr "B<keyctl_revoke>(3),"
803 #~ msgid "B<keyctl_chown>(3),"
804 #~ msgstr "B<keyctl_chown>(3),"
806 #~ msgid "B<keyctl_setperm>(3),"
807 #~ msgstr "B<keyctl_setperm>(3),"
809 #~ msgid "B<keyctl_describe>(3),"
810 #~ msgstr "B<keyctl_describe>(3),"
812 #~ msgid "B<keyctl_clear>(3),"
813 #~ msgstr "B<keyctl_clear>(3),"
815 #~ msgid "B<keyctl_link>(3),"
816 #~ msgstr "B<keyctl_link>(3),"
818 #~ msgid "B<keyctl_unlink>(3),"
819 #~ msgstr "B<keyctl_unlink>(3),"
821 #~ msgid "B<keyctl_search>(3),"
822 #~ msgstr "B<keyctl_search>(3),"
824 #~ msgid "B<keyctl_read>(3),"
825 #~ msgstr "B<keyctl_read>(3),"
827 #~ msgid "B<keyctl_instantiate>(3),"
828 #~ msgstr "B<keyctl_instantiate>(3),"
830 #~ msgid "B<keyctl_negate>(3),"
831 #~ msgstr "B<keyctl_negate>(3),"
833 #~ msgid "B<keyctl_set_reqkey_keyring>(3),"
834 #~ msgstr "B<keyctl_set_reqkey_keyring>(3),"
836 #~ msgid "B<keyctl_set_timeout>(3),"
837 #~ msgstr "B<keyctl_set_timeout>(3),"
839 #~ msgid "B<keyctl_assume_authority>(3),"
840 #~ msgstr "B<keyctl_assume_authority>(3),"
842 #~ msgid "B<keyctl_describe_alloc>(3),"
843 #~ msgstr "B<keyctl_describe_alloc>(3),"
845 #~ msgid "B<keyctl_read_alloc>(3),"
846 #~ msgstr "B<keyctl_read_alloc>(3),"
848 #~ msgid "B<request-key>(8)"
849 #~ msgstr "B<request-key>(8)"