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: 2012-03-22 04:25+0900\n"
10 "PO-Revision-Date: 2012-03-20 00:04+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:10
25 #: build/C/man2/add_key.2:10 build/C/man2/keyctl.2:10
26 #: build/C/man2/request_key.2:10
32 #: build/C/man2/add_key.2:10 build/C/man2/keyctl.2:10
33 #: build/C/man2/request_key.2:10
39 #: build/C/man2/add_key.2:10 build/C/man2/keyctl.2:10
40 #: build/C/man2/request_key.2:10
42 msgid "Linux Key Management Calls"
43 msgstr "Linux Key Management Calls"
46 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:11
47 #: build/C/man2/request_key.2:11
53 #: build/C/man2/add_key.2:13
54 msgid "add_key - Add a key to the kernel's key management facility"
58 #: build/C/man2/add_key.2:13 build/C/man2/keyctl.2:13
59 #: build/C/man2/request_key.2:13
65 #: build/C/man2/add_key.2:16 build/C/man2/keyctl.2:16
66 #: build/C/man2/request_key.2:16
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:20
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<, key_serial_t >I<keyring>B<);>\n"
78 "B<key_serial_t add_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
79 "B< const void *>I<payload>B<, size_t >I<plen>B<,>\n"
80 "B< key_serial_t >I<keyring>B<);>\n"
82 "B<key_serial_t add_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
83 "B<const void *>I<payload>B<, size_t >I<plen>B<, key_serial_t >I<keyring>B<);>\n"
86 #: build/C/man2/add_key.2:20 build/C/man2/keyctl.2:18
87 #: build/C/man2/request_key.2:20
93 #: build/C/man2/add_key.2:33
95 "B<add_key>() asks the kernel to create or update a key of the given I<type> "
96 "and I<description>, instantiate it with the I<payload> of length I<plen>, "
97 "and to attach it to the nominated I<keyring> and to return its serial number."
101 #: build/C/man2/add_key.2:36
103 "The key type may reject the data if it's in the wrong format or in some "
108 #: build/C/man2/add_key.2:44
110 "If the destination I<keyring> already contains a key that matches the "
111 "specified I<type> and I<description> then, if the key type supports it, that "
112 "key will be updated rather than a new key being created; if not, a new key "
113 "will be created and it will displace the link to the extant key from the "
118 #: build/C/man2/add_key.2:49
120 "The destination I<keyring> serial number may be that of a valid keyring to "
121 "which the caller has write permission, or it may be a special keyring ID:"
125 #: build/C/man2/add_key.2:49 build/C/man2/request_key.2:70
127 msgid "B<KEY_SPEC_THREAD_KEYRING>"
128 msgstr "B<KEY_SPEC_THREAD_KEYRING>"
131 #: build/C/man2/add_key.2:52 build/C/man2/request_key.2:73
132 msgid "This specifies the caller's thread-specific keyring."
136 #: build/C/man2/add_key.2:52 build/C/man2/request_key.2:73
138 msgid "B<KEY_SPEC_PROCESS_KEYRING>"
139 msgstr "B<KEY_SPEC_PROCESS_KEYRING>"
142 #: build/C/man2/add_key.2:55 build/C/man2/request_key.2:76
143 msgid "This specifies the caller's process-specific keyring."
147 #: build/C/man2/add_key.2:55 build/C/man2/request_key.2:76
149 msgid "B<KEY_SPEC_SESSION_KEYRING>"
150 msgstr "B<KEY_SPEC_SESSION_KEYRING>"
153 #: build/C/man2/add_key.2:58 build/C/man2/request_key.2:79
154 msgid "This specifies the caller's session-specific keyring."
158 #: build/C/man2/add_key.2:58 build/C/man2/request_key.2:79
160 msgid "B<KEY_SPEC_USER_KEYRING>"
161 msgstr "B<KEY_SPEC_USER_KEYRING>"
164 #: build/C/man2/add_key.2:61 build/C/man2/request_key.2:82
165 msgid "This specifies the caller's UID-specific keyring."
169 #: build/C/man2/add_key.2:61 build/C/man2/request_key.2:82
171 msgid "B<KEY_SPEC_USER_SESSION_KEYRING>"
172 msgstr "B<KEY_SPEC_USER_SESSION_KEYRING>"
175 #: build/C/man2/add_key.2:64 build/C/man2/request_key.2:85
176 msgid "This specifies the caller's UID-session keyring."
180 #: build/C/man2/add_key.2:64
186 #: build/C/man2/add_key.2:67
188 "There are a number of key types available in the core key management code, "
189 "and these can be specified to this function:"
193 #: build/C/man2/add_key.2:67
199 #: build/C/man2/add_key.2:80
201 "Keys of the user-defined key type may contain a blob of arbitrary data, and "
202 "the I<description> may be any valid string, though it is preferred that the "
203 "description be prefixed with a string representing the service to which the "
204 "key is of interest and a colon (for instance ``B<afs:mykey>''). The "
205 "I<payload> may be empty or B<NULL> for keys of this type."
209 #: build/C/man2/add_key.2:80
211 msgid "B<``keyring''>"
212 msgstr "B<``keyring''>"
215 #: build/C/man2/add_key.2:89
217 "Keyrings are special key types that may contain links to sequences of other "
218 "keys of any type. If this interface is used to create a keyring, then a "
219 "B<NULL> I<payload> should be specified, and I<plen> should be zero."
223 #: build/C/man2/add_key.2:89 build/C/man2/keyctl.2:79
224 #: build/C/man2/request_key.2:90
230 #: build/C/man2/add_key.2:96
232 "On success B<add_key>() returns the serial number of the key it created or "
233 "updated. On error, the value B<-1> will be returned and errno will have "
234 "been set to an appropriate error."
238 #: build/C/man2/add_key.2:96 build/C/man2/keyctl.2:86
239 #: build/C/man2/request_key.2:97
245 #: build/C/man2/add_key.2:97 build/C/man2/keyctl.2:103
246 #: build/C/man2/request_key.2:120
252 #: build/C/man2/add_key.2:100
253 msgid "The keyring doesn't exist."
257 #: build/C/man2/add_key.2:100 build/C/man2/keyctl.2:94
258 #: build/C/man2/request_key.2:108
260 msgid "B<EKEYEXPIRED>"
261 msgstr "B<EKEYEXPIRED>"
264 #: build/C/man2/add_key.2:103
265 msgid "The keyring has expired."
269 #: build/C/man2/add_key.2:103 build/C/man2/keyctl.2:100
270 #: build/C/man2/request_key.2:114
272 msgid "B<EKEYREVOKED>"
273 msgstr "B<EKEYREVOKED>"
276 #: build/C/man2/add_key.2:106
277 msgid "The keyring has been revoked."
281 #: build/C/man2/add_key.2:106
287 #: build/C/man2/add_key.2:109
288 msgid "The payload data was invalid."
292 #: build/C/man2/add_key.2:109 build/C/man2/request_key.2:117
298 #: build/C/man2/add_key.2:112 build/C/man2/request_key.2:120
299 msgid "Insufficient memory to create a key."
303 #: build/C/man2/add_key.2:112 build/C/man2/keyctl.2:90
304 #: build/C/man2/request_key.2:104
310 #: build/C/man2/add_key.2:116 build/C/man2/request_key.2:108
312 "The key quota for this user would be exceeded by creating this key or "
313 "linking it to the keyring."
317 #: build/C/man2/add_key.2:116 build/C/man2/keyctl.2:87
318 #: build/C/man2/request_key.2:98
324 #: build/C/man2/add_key.2:119 build/C/man2/request_key.2:101
325 msgid "The keyring wasn't available for modification by the user."
329 #: build/C/man2/add_key.2:119 build/C/man2/keyctl.2:106
330 #: build/C/man2/request_key.2:123
336 #: build/C/man2/add_key.2:127 build/C/man2/keyctl.2:114
337 #: build/C/man2/request_key.2:131
339 "Although this is a Linux system call, it is not present in I<libc> but can "
340 "be found rather in I<libkeyutils>. When linking, B<-lkeyutils> should be "
341 "specified to the linker."
345 #: build/C/man2/add_key.2:127 build/C/man2/keyctl.2:114
346 #: build/C/man2/request_key.2:131
352 #: build/C/man2/add_key.2:131
353 msgid "B<keyctl>(1), B<keyctl>(2), B<request_key>(2)"
354 msgstr "B<keyctl>(1), B<keyctl>(2), B<request_key>(2)"
357 #: build/C/man2/add_key.2:131 build/C/man2/keyctl.2:160
358 #: build/C/man2/request_key.2:136
364 #: build/C/man2/add_key.2:138 build/C/man2/keyctl.2:167
365 #: build/C/man2/request_key.2:143
367 "This page is part of release 3.37 of the Linux I<man-pages> project. A "
368 "description of the project, and information about reporting bugs, can be "
369 "found at http://www.kernel.org/doc/man-pages/."
373 #: build/C/man2/keyctl.2:10
379 #: build/C/man2/keyctl.2:13
380 msgid "keyctl - Manipulate the kernel's key management facility"
384 #: build/C/man2/keyctl.2:18
386 msgid "B<long keyctl(int >I<cmd>B<, ...);>\n"
387 msgstr "B<long keyctl(int >I<cmd>B<, ...);>\n"
390 #: build/C/man2/keyctl.2:21
391 msgid "B<keyctl>() has a number of functions available:"
395 #: build/C/man2/keyctl.2:21
397 msgid "B<KEYCTL_GET_KEYRING_ID\t>"
398 msgstr "B<KEYCTL_GET_KEYRING_ID\t>"
401 #: build/C/man2/keyctl.2:24
402 msgid "Ask for a keyring's ID."
406 #: build/C/man2/keyctl.2:24
408 msgid "B<KEYCTL_JOIN_SESSION_KEYRING\t>"
409 msgstr "B<KEYCTL_JOIN_SESSION_KEYRING\t>"
412 #: build/C/man2/keyctl.2:27
413 msgid "Join or start named session keyring."
417 #: build/C/man2/keyctl.2:27
419 msgid "B<KEYCTL_UPDATE\t\t\t>"
420 msgstr "B<KEYCTL_UPDATE\t\t\t>"
423 #: build/C/man2/keyctl.2:30
424 msgid "Update a key."
428 #: build/C/man2/keyctl.2:30
430 msgid "B<KEYCTL_REVOKE\t\t\t>"
431 msgstr "B<KEYCTL_REVOKE\t\t\t>"
434 #: build/C/man2/keyctl.2:33
435 msgid "Revoke a key."
439 #: build/C/man2/keyctl.2:33
441 msgid "B<KEYCTL_CHOWN\t\t\t>"
442 msgstr "B<KEYCTL_CHOWN\t\t\t>"
445 #: build/C/man2/keyctl.2:36
446 msgid "Set ownership of a key."
450 #: build/C/man2/keyctl.2:36
452 msgid "B<KEYCTL_SETPERM\t\t\t>"
453 msgstr "B<KEYCTL_SETPERM\t\t\t>"
456 #: build/C/man2/keyctl.2:39
457 msgid "Set perms on a key."
461 #: build/C/man2/keyctl.2:39
463 msgid "B<KEYCTL_DESCRIBE\t\t\t>"
464 msgstr "B<KEYCTL_DESCRIBE\t\t\t>"
467 #: build/C/man2/keyctl.2:42
468 msgid "Describe a key."
472 #: build/C/man2/keyctl.2:42
474 msgid "B<KEYCTL_CLEAR\t\t\t>"
475 msgstr "B<KEYCTL_CLEAR\t\t\t>"
478 #: build/C/man2/keyctl.2:45
479 msgid "Clear contents of a keyring."
483 #: build/C/man2/keyctl.2:45
485 msgid "B<KEYCTL_LINK\t\t\t>"
486 msgstr "B<KEYCTL_LINK\t\t\t>"
489 #: build/C/man2/keyctl.2:48
490 msgid "Link a key into a keyring."
494 #: build/C/man2/keyctl.2:48
496 msgid "B<KEYCTL_UNLINK\t\t\t>"
497 msgstr "B<KEYCTL_UNLINK\t\t\t>"
500 #: build/C/man2/keyctl.2:51
501 msgid "Unlink a key from a keyring."
505 #: build/C/man2/keyctl.2:51
507 msgid "B<KEYCTL_SEARCH\t\t\t>"
508 msgstr "B<KEYCTL_SEARCH\t\t\t>"
511 #: build/C/man2/keyctl.2:54
512 msgid "Search for a key in a keyring."
516 #: build/C/man2/keyctl.2:54
518 msgid "B<KEYCTL_READ\t\t\t>"
519 msgstr "B<KEYCTL_READ\t\t\t>"
522 #: build/C/man2/keyctl.2:57
523 msgid "Read a key or keyring's contents."
527 #: build/C/man2/keyctl.2:57
529 msgid "B<KEYCTL_INSTANTIATE\t\t>"
530 msgstr "B<KEYCTL_INSTANTIATE\t\t>"
533 #: build/C/man2/keyctl.2:60
534 msgid "Instantiate a partially constructed key."
538 #: build/C/man2/keyctl.2:60
540 msgid "B<KEYCTL_NEGATE\t\t\t>"
541 msgstr "B<KEYCTL_NEGATE\t\t\t>"
544 #: build/C/man2/keyctl.2:63
545 msgid "Negate a partially constructed key."
549 #: build/C/man2/keyctl.2:63
551 msgid "B<KEYCTL_SET_REQKEY_KEYRING\t>"
552 msgstr "B<KEYCTL_SET_REQKEY_KEYRING\t>"
555 #: build/C/man2/keyctl.2:66
556 msgid "Set default request-key keyring."
560 #: build/C/man2/keyctl.2:66
562 msgid "B<KEYCTL_SET_TIMEOUT\t\t>"
563 msgstr "B<KEYCTL_SET_TIMEOUT\t\t>"
566 #: build/C/man2/keyctl.2:69
567 msgid "Set timeout on a key."
571 #: build/C/man2/keyctl.2:69
573 msgid "B<KEYCTL_ASSUME_AUTHORITY\t\t>"
574 msgstr "B<KEYCTL_ASSUME_AUTHORITY\t\t>"
577 #: build/C/man2/keyctl.2:72
578 msgid "Assume authority to instantiate key."
582 #: build/C/man2/keyctl.2:79
584 "These are wrapped by B<libkeyutils> into individual functions to permit "
585 "compiler the compiler to check types. See the B<See Also> section at the "
590 #: build/C/man2/keyctl.2:86
592 "On success B<keyctl>() returns the serial number of the key it found. On "
593 "error, the value B<-1> will be returned and errno will have been set to an "
598 #: build/C/man2/keyctl.2:90
599 msgid "A key operation wasn't permitted."
603 #: build/C/man2/keyctl.2:94
605 "The key quota for the caller's user would be exceeded by creating a key or "
606 "linking it to the keyring."
610 #: build/C/man2/keyctl.2:97
611 msgid "An expired key was found or specified."
615 #: build/C/man2/keyctl.2:97 build/C/man2/request_key.2:111
617 msgid "B<EKEYREJECTED>"
618 msgstr "B<EKEYREJECTED>"
621 #: build/C/man2/keyctl.2:100
622 msgid "A rejected key was found or specified."
626 #: build/C/man2/keyctl.2:103
627 msgid "A revoked key was found or specified."
631 #: build/C/man2/keyctl.2:106
632 msgid "No matching key was found or an invalid key was specified."
636 #: build/C/man2/keyctl.2:116
637 msgid "B<keyctl>(1),"
638 msgstr "B<keyctl>(1),"
641 #: build/C/man2/keyctl.2:118
642 msgid "B<add_key>(2),"
643 msgstr "B<add_key>(2),"
646 #: build/C/man2/keyctl.2:120
647 msgid "B<request_key>(2),"
648 msgstr "B<request_key>(2),"
651 #: build/C/man2/keyctl.2:122
652 msgid "B<keyctl_get_keyring_ID>(3),"
653 msgstr "B<keyctl_get_keyring_ID>(3),"
656 #: build/C/man2/keyctl.2:124
657 msgid "B<keyctl_join_session_keyring>(3),"
658 msgstr "B<keyctl_join_session_keyring>(3),"
661 #: build/C/man2/keyctl.2:126
662 msgid "B<keyctl_update>(3),"
663 msgstr "B<keyctl_update>(3),"
666 #: build/C/man2/keyctl.2:128
667 msgid "B<keyctl_revoke>(3),"
668 msgstr "B<keyctl_revoke>(3),"
671 #: build/C/man2/keyctl.2:130
672 msgid "B<keyctl_chown>(3),"
673 msgstr "B<keyctl_chown>(3),"
676 #: build/C/man2/keyctl.2:132
677 msgid "B<keyctl_setperm>(3),"
678 msgstr "B<keyctl_setperm>(3),"
681 #: build/C/man2/keyctl.2:134
682 msgid "B<keyctl_describe>(3),"
683 msgstr "B<keyctl_describe>(3),"
686 #: build/C/man2/keyctl.2:136
687 msgid "B<keyctl_clear>(3),"
688 msgstr "B<keyctl_clear>(3),"
691 #: build/C/man2/keyctl.2:138
692 msgid "B<keyctl_link>(3),"
693 msgstr "B<keyctl_link>(3),"
696 #: build/C/man2/keyctl.2:140
697 msgid "B<keyctl_unlink>(3),"
698 msgstr "B<keyctl_unlink>(3),"
701 #: build/C/man2/keyctl.2:142
702 msgid "B<keyctl_search>(3),"
703 msgstr "B<keyctl_search>(3),"
706 #: build/C/man2/keyctl.2:144
707 msgid "B<keyctl_read>(3),"
708 msgstr "B<keyctl_read>(3),"
711 #: build/C/man2/keyctl.2:146
712 msgid "B<keyctl_instantiate>(3),"
713 msgstr "B<keyctl_instantiate>(3),"
716 #: build/C/man2/keyctl.2:148
717 msgid "B<keyctl_negate>(3),"
718 msgstr "B<keyctl_negate>(3),"
721 #: build/C/man2/keyctl.2:150
722 msgid "B<keyctl_set_reqkey_keyring>(3),"
723 msgstr "B<keyctl_set_reqkey_keyring>(3),"
726 #: build/C/man2/keyctl.2:152
727 msgid "B<keyctl_set_timeout>(3),"
728 msgstr "B<keyctl_set_timeout>(3),"
731 #: build/C/man2/keyctl.2:154
732 msgid "B<keyctl_assume_authority>(3),"
733 msgstr "B<keyctl_assume_authority>(3),"
736 #: build/C/man2/keyctl.2:156
737 msgid "B<keyctl_describe_alloc>(3),"
738 msgstr "B<keyctl_describe_alloc>(3),"
741 #: build/C/man2/keyctl.2:158
742 msgid "B<keyctl_read_alloc>(3),"
743 msgstr "B<keyctl_read_alloc>(3),"
746 #: build/C/man2/keyctl.2:160
747 msgid "B<request-key>(8)"
748 msgstr "B<request-key>(8)"
751 #: build/C/man2/request_key.2:10
757 #: build/C/man2/request_key.2:13
758 msgid "request_key - Request a key from the kernel's key management facility"
762 #: build/C/man2/request_key.2:20
765 #| "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
766 #| "B<const char *>I<callout_info>B<, key_serial_t >I<keyring>B<);>\n"
768 "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
769 "B< const char *>I<callout_info>B<,>\n"
770 "B< key_serial_t >I<keyring>B<);>\n"
772 "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
773 "B<const char *>I<callout_info>B<, key_serial_t >I<keyring>B<);>\n"
776 #: build/C/man2/request_key.2:29
778 "B<request_key>() asks the kernel to find a key of the given I<type> that "
779 "matches the specified I<description> and, if successful, to attach it to the "
780 "nominated I<keyring> and to return its serial number."
784 #: build/C/man2/request_key.2:34
786 "B<request_key>() first recursively searches all the keyrings attached to "
787 "the calling process in the order thread-specific keyring, process-specific "
788 "keyring and then session keyring for a matching key."
792 #: build/C/man2/request_key.2:42
794 "If B<request_key>() is called from a program invoked by B<request_key>() "
795 "on behalf of some other process to generate a key, then the keyrings of that "
796 "other process will be searched next, using that other process's UID, GID, "
797 "groups and security context to control access."
801 #: build/C/man2/request_key.2:49
803 "The keys in each keyring searched are checked for a match before any child "
804 "keyrings are recursed into. Only keys that are B<searchable> for the caller "
805 "may be found, and only B<searchable> keyrings may be searched."
809 #: build/C/man2/request_key.2:57
811 "If the key is not found then, if I<callout_info> is set, this function will "
812 "attempt to look further afield. In such a case, the I<callout_info> is "
813 "passed to a userspace service such as B</sbin/request-key> to generate the "
818 #: build/C/man2/request_key.2:65
820 "If that is unsuccessful also, then an error will be returned, and a "
821 "temporary negative key will be installed in the nominated I<keyring>. This "
822 "will expire after a few seconds, but will cause subsequent calls to "
823 "B<request_key>() to fail until it does."
827 #: build/C/man2/request_key.2:70
829 "The I<keyring> serial number may be that of a valid keyring to which the "
830 "caller has write permission, or it may be a special keyring ID:"
834 #: build/C/man2/request_key.2:90
836 "If a key is created, no matter whether it's a valid key or a negative key, "
837 "it will displace any other key of the same type and description from the "
838 "destination I<keyring>."
842 #: build/C/man2/request_key.2:97
844 "On success B<request_key>() returns the serial number of the key it found. "
845 "On error, the value B<-1> will be returned and errno will have been set to "
846 "an appropriate error."
850 #: build/C/man2/request_key.2:101
856 #: build/C/man2/request_key.2:104
857 msgid "The request was interrupted by a signal."
861 #: build/C/man2/request_key.2:111
862 msgid "An expired key was found, but no replacement could be obtained."
866 #: build/C/man2/request_key.2:114
867 msgid "The attempt to generate a new key was rejected."
871 #: build/C/man2/request_key.2:117
872 msgid "A revoked key was found, but no replacement could be obtained."
876 #: build/C/man2/request_key.2:123
877 msgid "No matching key was found."
881 #: build/C/man2/request_key.2:136
882 msgid "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"
883 msgstr "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"