OSDN Git Service

abe97d56242dffe69cf4dcf01e41a56fde4af452
[linuxjm/LDP_man-pages.git] / po4a / keyutils / po / ja.po
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.
5 #
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: PACKAGE VERSION\n"
9 "POT-Creation-Date: 2013-08-15 19:31+0900\n"
10 "PO-Revision-Date: 2013-07-30 00:28+0900\n"
11 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
12 "Language-Team: LANGUAGE <LL@li.org>\n"
13 "Language: \n"
14 "MIME-Version: 1.0\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
17
18 #. type: TH
19 #: build/C/man2/add_key.2:11
20 #, no-wrap
21 msgid "ADD_KEY"
22 msgstr "ADD_KEY"
23
24 #. type: TH
25 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:21
26 #: build/C/man2/request_key.2:11
27 #, no-wrap
28 msgid "2010-02-25"
29 msgstr "2010-02-25"
30
31 #. type: TH
32 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:21
33 #: build/C/man2/request_key.2:11
34 #, no-wrap
35 msgid "Linux"
36 msgstr "Linux"
37
38 #. type: TH
39 #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:21
40 #: build/C/man2/request_key.2:11
41 #, no-wrap
42 msgid "Linux Key Management Calls"
43 msgstr "Linux Key Management Calls"
44
45 #. type: SH
46 #: build/C/man2/add_key.2:12 build/C/man2/keyctl.2:22
47 #: build/C/man2/request_key.2:12
48 #, no-wrap
49 msgid "NAME"
50 msgstr "名前"
51
52 #. type: Plain text
53 #: build/C/man2/add_key.2:14
54 msgid "add_key - add a key to the kernel's key management facility"
55 msgstr ""
56
57 #. type: SH
58 #: build/C/man2/add_key.2:14 build/C/man2/keyctl.2:24
59 #: build/C/man2/request_key.2:14
60 #, no-wrap
61 msgid "SYNOPSIS"
62 msgstr "書式"
63
64 #. type: Plain text
65 #: build/C/man2/add_key.2:17 build/C/man2/keyctl.2:27
66 #: build/C/man2/request_key.2:17
67 #, no-wrap
68 msgid "B<#include E<lt>keyutils.hE<gt>>\n"
69 msgstr "B<#include E<lt>keyutils.hE<gt>>\n"
70
71 #. type: Plain text
72 #: build/C/man2/add_key.2:21
73 #, no-wrap
74 msgid ""
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"
78 msgstr ""
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"
82
83 #. type: SH
84 #: build/C/man2/add_key.2:22 build/C/man2/keyctl.2:30
85 #: build/C/man2/request_key.2:22
86 #, no-wrap
87 msgid "DESCRIPTION"
88 msgstr "説明"
89
90 #. type: Plain text
91 #: build/C/man2/add_key.2:35
92 msgid ""
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."
96 msgstr ""
97
98 #. type: Plain text
99 #: build/C/man2/add_key.2:38
100 msgid ""
101 "The key type may reject the data if it's in the wrong format or in some "
102 "other way invalid."
103 msgstr ""
104
105 #. type: Plain text
106 #: build/C/man2/add_key.2:46
107 msgid ""
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 "
112 "keyring."
113 msgstr ""
114
115 #. type: Plain text
116 #: build/C/man2/add_key.2:51
117 msgid ""
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:"
120 msgstr ""
121
122 #. type: TP
123 #: build/C/man2/add_key.2:51 build/C/man2/request_key.2:74
124 #, no-wrap
125 msgid "B<KEY_SPEC_THREAD_KEYRING>"
126 msgstr "B<KEY_SPEC_THREAD_KEYRING>"
127
128 #. type: Plain text
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."
131 msgstr ""
132
133 #. type: TP
134 #: build/C/man2/add_key.2:54 build/C/man2/request_key.2:77
135 #, no-wrap
136 msgid "B<KEY_SPEC_PROCESS_KEYRING>"
137 msgstr "B<KEY_SPEC_PROCESS_KEYRING>"
138
139 #. type: Plain text
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."
142 msgstr ""
143
144 #. type: TP
145 #: build/C/man2/add_key.2:57 build/C/man2/request_key.2:80
146 #, no-wrap
147 msgid "B<KEY_SPEC_SESSION_KEYRING>"
148 msgstr "B<KEY_SPEC_SESSION_KEYRING>"
149
150 #. type: Plain text
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."
153 msgstr ""
154
155 #. type: TP
156 #: build/C/man2/add_key.2:60 build/C/man2/request_key.2:83
157 #, no-wrap
158 msgid "B<KEY_SPEC_USER_KEYRING>"
159 msgstr "B<KEY_SPEC_USER_KEYRING>"
160
161 #. type: Plain text
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."
164 msgstr ""
165
166 #. type: TP
167 #: build/C/man2/add_key.2:63 build/C/man2/request_key.2:86
168 #, no-wrap
169 msgid "B<KEY_SPEC_USER_SESSION_KEYRING>"
170 msgstr "B<KEY_SPEC_USER_SESSION_KEYRING>"
171
172 #. type: Plain text
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."
175 msgstr ""
176
177 #. type: SH
178 #: build/C/man2/add_key.2:66
179 #, no-wrap
180 msgid "KEY TYPES"
181 msgstr ""
182
183 #. type: Plain text
184 #: build/C/man2/add_key.2:69
185 msgid ""
186 "There are a number of key types available in the core key management code, "
187 "and these can be specified to this function:"
188 msgstr ""
189
190 #. type: TP
191 #: build/C/man2/add_key.2:69
192 #, no-wrap
193 msgid "B<``user''>"
194 msgstr "B<``user''>"
195
196 #. type: Plain text
197 #: build/C/man2/add_key.2:80
198 msgid ""
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."
204 msgstr ""
205
206 #. type: TP
207 #: build/C/man2/add_key.2:80
208 #, no-wrap
209 msgid "B<``keyring''>"
210 msgstr "B<``keyring''>"
211
212 #. type: Plain text
213 #: build/C/man2/add_key.2:89
214 msgid ""
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."
218 msgstr ""
219
220 #. type: SH
221 #: build/C/man2/add_key.2:89 build/C/man2/keyctl.2:91
222 #: build/C/man2/request_key.2:94
223 #, no-wrap
224 msgid "RETURN VALUE"
225 msgstr "返り値"
226
227 #. type: Plain text
228 #: build/C/man2/add_key.2:95
229 msgid ""
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."
233 msgstr ""
234
235 #. type: SH
236 #: build/C/man2/add_key.2:95 build/C/man2/keyctl.2:97
237 #: build/C/man2/request_key.2:100
238 #, no-wrap
239 msgid "ERRORS"
240 msgstr "エラー"
241
242 #. type: TP
243 #: build/C/man2/add_key.2:96 build/C/man2/keyctl.2:114
244 #: build/C/man2/request_key.2:123
245 #, no-wrap
246 msgid "B<ENOKEY>"
247 msgstr "B<ENOKEY>"
248
249 #. type: Plain text
250 #: build/C/man2/add_key.2:99
251 msgid "The keyring doesn't exist."
252 msgstr ""
253
254 #. type: TP
255 #: build/C/man2/add_key.2:99 build/C/man2/keyctl.2:105
256 #: build/C/man2/request_key.2:111
257 #, no-wrap
258 msgid "B<EKEYEXPIRED>"
259 msgstr "B<EKEYEXPIRED>"
260
261 #. type: Plain text
262 #: build/C/man2/add_key.2:102
263 msgid "The keyring has expired."
264 msgstr ""
265
266 #. type: TP
267 #: build/C/man2/add_key.2:102 build/C/man2/keyctl.2:111
268 #: build/C/man2/request_key.2:117
269 #, no-wrap
270 msgid "B<EKEYREVOKED>"
271 msgstr "B<EKEYREVOKED>"
272
273 #. type: Plain text
274 #: build/C/man2/add_key.2:105
275 msgid "The keyring has been revoked."
276 msgstr ""
277
278 #. type: TP
279 #: build/C/man2/add_key.2:105
280 #, no-wrap
281 msgid "B<EINVAL>"
282 msgstr "B<EINVAL>"
283
284 #. type: Plain text
285 #: build/C/man2/add_key.2:108
286 msgid "The payload data was invalid."
287 msgstr ""
288
289 #. type: TP
290 #: build/C/man2/add_key.2:108 build/C/man2/request_key.2:120
291 #, no-wrap
292 msgid "B<ENOMEM>"
293 msgstr "B<ENOMEM>"
294
295 #. type: Plain text
296 #: build/C/man2/add_key.2:111 build/C/man2/request_key.2:123
297 msgid "Insufficient memory to create a key."
298 msgstr ""
299
300 #. type: TP
301 #: build/C/man2/add_key.2:111 build/C/man2/keyctl.2:101
302 #: build/C/man2/request_key.2:107
303 #, no-wrap
304 msgid "B<EDQUOT>"
305 msgstr "B<EDQUOT>"
306
307 #. type: Plain text
308 #: build/C/man2/add_key.2:115 build/C/man2/request_key.2:111
309 msgid ""
310 "The key quota for this user would be exceeded by creating this key or "
311 "linking it to the keyring."
312 msgstr ""
313
314 #. type: TP
315 #: build/C/man2/add_key.2:115 build/C/man2/keyctl.2:98
316 #: build/C/man2/request_key.2:101
317 #, no-wrap
318 msgid "B<EACCES>"
319 msgstr "B<EACCES>"
320
321 #. type: Plain text
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."
324 msgstr ""
325
326 #. type: SH
327 #: build/C/man2/add_key.2:118 build/C/man2/keyctl.2:117
328 #: build/C/man2/request_key.2:126
329 #, no-wrap
330 msgid "LINKING"
331 msgstr "LINKING"
332
333 #. type: Plain text
334 #: build/C/man2/add_key.2:126 build/C/man2/keyctl.2:125
335 #: build/C/man2/request_key.2:134
336 msgid ""
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."
340 msgstr ""
341
342 #. type: SH
343 #: build/C/man2/add_key.2:126 build/C/man2/keyctl.2:125
344 #: build/C/man2/request_key.2:134
345 #, no-wrap
346 msgid "SEE ALSO"
347 msgstr "関連項目"
348
349 #. type: Plain text
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)"
353
354 #. type: SH
355 #: build/C/man2/add_key.2:130 build/C/man2/keyctl.2:151
356 #: build/C/man2/request_key.2:139
357 #, no-wrap
358 msgid "COLOPHON"
359 msgstr "この文書について"
360
361 #. type: Plain text
362 #: build/C/man2/add_key.2:137 build/C/man2/keyctl.2:158
363 #: build/C/man2/request_key.2:146
364 #, fuzzy
365 #| msgid ""
366 #| "This page is part of release 3.52 of the Linux I<man-pages> project.  A "
367 #| "description of the project, and information about reporting bugs, can be "
368 #| "found at \\%http://www.kernel.org/doc/man-pages/."
369 msgid ""
370 "This page is part of release 3.53 of the Linux I<man-pages> project.  A "
371 "description of the project, and information about reporting bugs, can be "
372 "found at \\%http://www.kernel.org/doc/man-pages/."
373 msgstr ""
374 "この man ページは Linux I<man-pages> プロジェクトのリリース 3.52 の一部\n"
375 "である。プロジェクトの説明とバグ報告に関する情報は\n"
376 "http://www.kernel.org/doc/man-pages/ に書かれている。"
377
378 #. type: TH
379 #: build/C/man2/keyctl.2:21
380 #, no-wrap
381 msgid "KEYCTL"
382 msgstr "KEYCTL"
383
384 #. type: Plain text
385 #: build/C/man2/keyctl.2:24
386 msgid "keyctl - manipulate the kernel's key management facility"
387 msgstr ""
388
389 #. type: Plain text
390 #: build/C/man2/keyctl.2:29
391 #, no-wrap
392 msgid "B<long keyctl(int >I<cmd>B<, ...);>\n"
393 msgstr "B<long keyctl(int >I<cmd>B<, ...);>\n"
394
395 #. type: Plain text
396 #: build/C/man2/keyctl.2:33
397 msgid "B<keyctl>()  has a number of functions available:"
398 msgstr ""
399
400 #. type: TP
401 #: build/C/man2/keyctl.2:33
402 #, no-wrap
403 msgid "B<KEYCTL_GET_KEYRING_ID>"
404 msgstr "B<KEYCTL_GET_KEYRING_ID>"
405
406 #. type: Plain text
407 #: build/C/man2/keyctl.2:36
408 msgid "Ask for a keyring's ID."
409 msgstr ""
410
411 #. type: TP
412 #: build/C/man2/keyctl.2:36
413 #, no-wrap
414 msgid "B<KEYCTL_JOIN_SESSION_KEYRING>"
415 msgstr "B<KEYCTL_JOIN_SESSION_KEYRING>"
416
417 #. type: Plain text
418 #: build/C/man2/keyctl.2:39
419 msgid "Join or start named session keyring."
420 msgstr ""
421
422 #. type: TP
423 #: build/C/man2/keyctl.2:39
424 #, no-wrap
425 msgid "B<KEYCTL_UPDATE>"
426 msgstr "B<KEYCTL_UPDATE>"
427
428 #. type: Plain text
429 #: build/C/man2/keyctl.2:42
430 msgid "Update a key."
431 msgstr ""
432
433 #. type: TP
434 #: build/C/man2/keyctl.2:42
435 #, no-wrap
436 msgid "B<KEYCTL_REVOKE>"
437 msgstr "B<KEYCTL_REVOKE>"
438
439 #. type: Plain text
440 #: build/C/man2/keyctl.2:45
441 msgid "Revoke a key."
442 msgstr ""
443
444 #. type: TP
445 #: build/C/man2/keyctl.2:45
446 #, no-wrap
447 msgid "B<KEYCTL_CHOWN>"
448 msgstr "B<KEYCTL_CHOWN>"
449
450 #. type: Plain text
451 #: build/C/man2/keyctl.2:48
452 msgid "Set ownership of a key."
453 msgstr ""
454
455 #. type: TP
456 #: build/C/man2/keyctl.2:48
457 #, no-wrap
458 msgid "B<KEYCTL_SETPERM>"
459 msgstr "B<KEYCTL_SETPERM>"
460
461 #. type: Plain text
462 #: build/C/man2/keyctl.2:51
463 msgid "Set perms on a key."
464 msgstr ""
465
466 #. type: TP
467 #: build/C/man2/keyctl.2:51
468 #, no-wrap
469 msgid "B<KEYCTL_DESCRIBE>"
470 msgstr "B<KEYCTL_DESCRIBE>"
471
472 #. type: Plain text
473 #: build/C/man2/keyctl.2:54
474 msgid "Describe a key."
475 msgstr ""
476
477 #. type: TP
478 #: build/C/man2/keyctl.2:54
479 #, no-wrap
480 msgid "B<KEYCTL_CLEAR>"
481 msgstr "B<KEYCTL_CLEAR>"
482
483 #. type: Plain text
484 #: build/C/man2/keyctl.2:57
485 msgid "Clear contents of a keyring."
486 msgstr ""
487
488 #. type: TP
489 #: build/C/man2/keyctl.2:57
490 #, no-wrap
491 msgid "B<KEYCTL_LINK>"
492 msgstr "B<KEYCTL_LINK>"
493
494 #. type: Plain text
495 #: build/C/man2/keyctl.2:60
496 msgid "Link a key into a keyring."
497 msgstr ""
498
499 #. type: TP
500 #: build/C/man2/keyctl.2:60
501 #, no-wrap
502 msgid "B<KEYCTL_UNLINK>"
503 msgstr "B<KEYCTL_UNLINK>"
504
505 #. type: Plain text
506 #: build/C/man2/keyctl.2:63
507 msgid "Unlink a key from a keyring."
508 msgstr ""
509
510 #. type: TP
511 #: build/C/man2/keyctl.2:63
512 #, no-wrap
513 msgid "B<KEYCTL_SEARCH>"
514 msgstr "B<KEYCTL_SEARCH>"
515
516 #. type: Plain text
517 #: build/C/man2/keyctl.2:66
518 msgid "Search for a key in a keyring."
519 msgstr ""
520
521 #. type: TP
522 #: build/C/man2/keyctl.2:66
523 #, no-wrap
524 msgid "B<KEYCTL_READ>"
525 msgstr "B<KEYCTL_READ>"
526
527 #. type: Plain text
528 #: build/C/man2/keyctl.2:69
529 msgid "Read a key or keyring's contents."
530 msgstr ""
531
532 #. type: TP
533 #: build/C/man2/keyctl.2:69
534 #, no-wrap
535 msgid "B<KEYCTL_INSTANTIATE>"
536 msgstr "B<KEYCTL_INSTANTIATE>"
537
538 #. type: Plain text
539 #: build/C/man2/keyctl.2:72
540 msgid "Instantiate a partially constructed key."
541 msgstr ""
542
543 #. type: TP
544 #: build/C/man2/keyctl.2:72
545 #, no-wrap
546 msgid "B<KEYCTL_NEGATE>"
547 msgstr "B<KEYCTL_NEGATE>"
548
549 #. type: Plain text
550 #: build/C/man2/keyctl.2:75
551 msgid "Negate a partially constructed key."
552 msgstr ""
553
554 #. type: TP
555 #: build/C/man2/keyctl.2:75
556 #, no-wrap
557 msgid "B<KEYCTL_SET_REQKEY_KEYRING>"
558 msgstr "B<KEYCTL_SET_REQKEY_KEYRING>"
559
560 #. type: Plain text
561 #: build/C/man2/keyctl.2:78
562 msgid "Set default request-key keyring."
563 msgstr ""
564
565 #. type: TP
566 #: build/C/man2/keyctl.2:78
567 #, no-wrap
568 msgid "B<KEYCTL_SET_TIMEOUT>"
569 msgstr "B<KEYCTL_SET_TIMEOUT>"
570
571 #. type: Plain text
572 #: build/C/man2/keyctl.2:81
573 msgid "Set timeout on a key."
574 msgstr ""
575
576 #. type: TP
577 #: build/C/man2/keyctl.2:81
578 #, no-wrap
579 msgid "B<KEYCTL_ASSUME_AUTHORITY>"
580 msgstr "B<KEYCTL_ASSUME_AUTHORITY>"
581
582 #. type: Plain text
583 #: build/C/man2/keyctl.2:84
584 msgid "Assume authority to instantiate key."
585 msgstr ""
586
587 #. type: Plain text
588 #: build/C/man2/keyctl.2:91
589 msgid ""
590 "These are wrapped by B<libkeyutils> into individual functions to permit "
591 "compiler the compiler to check types.  See the B<See Also> section at the "
592 "bottom."
593 msgstr ""
594
595 #. type: Plain text
596 #: build/C/man2/keyctl.2:97
597 msgid ""
598 "On success B<keyctl>()  returns the serial number of the key it found.  On "
599 "error, the value -1 will be returned and errno will have been set to an "
600 "appropriate error."
601 msgstr ""
602
603 #. type: Plain text
604 #: build/C/man2/keyctl.2:101
605 msgid "A key operation wasn't permitted."
606 msgstr ""
607
608 #. type: Plain text
609 #: build/C/man2/keyctl.2:105
610 msgid ""
611 "The key quota for the caller's user would be exceeded by creating a key or "
612 "linking it to the keyring."
613 msgstr ""
614
615 #. type: Plain text
616 #: build/C/man2/keyctl.2:108
617 msgid "An expired key was found or specified."
618 msgstr ""
619
620 #. type: TP
621 #: build/C/man2/keyctl.2:108 build/C/man2/request_key.2:114
622 #, no-wrap
623 msgid "B<EKEYREJECTED>"
624 msgstr "B<EKEYREJECTED>"
625
626 #. type: Plain text
627 #: build/C/man2/keyctl.2:111
628 msgid "A rejected key was found or specified."
629 msgstr ""
630
631 #. type: Plain text
632 #: build/C/man2/keyctl.2:114
633 msgid "A revoked key was found or specified."
634 msgstr ""
635
636 #. type: Plain text
637 #: build/C/man2/keyctl.2:117
638 msgid "No matching key was found or an invalid key was specified."
639 msgstr ""
640
641 #. type: Plain text
642 #: build/C/man2/keyctl.2:151
643 msgid ""
644 "B<keyctl>(1), B<add_key>(2), B<request_key>(2), B<keyctl_set_timeout>(3), "
645 "B<keyctl_chown>(3), B<keyctl_clear>(3), B<keyctl_describe>(3), "
646 "B<keyctl_describe_alloc>(3), B<keyctl_get_keyring_ID>(3), "
647 "B<keyctl_instantiate>(3), B<keyctl_join_session_keyring>(3), B<keyctl_link>"
648 "(3), B<keyctl_negate>(3), B<keyctl_revoke>(3), B<keyctl_search>(3), "
649 "B<keyctl_setperm>(3), B<keyctl_set_reqkey_keyring>(3), B<keyctl_set_timeout>"
650 "(3), B<keyctl_read>(3), B<keyctl_read_alloc>(3), B<keyctl_unlink>(3), "
651 "B<keyctl_update>(3), B<request-key>(8)"
652 msgstr ""
653
654 #. type: TH
655 #: build/C/man2/request_key.2:11
656 #, no-wrap
657 msgid "REQUEST_KEY"
658 msgstr "REQUEST_KEY"
659
660 #. type: Plain text
661 #: build/C/man2/request_key.2:14
662 msgid "request_key - request a key from the kernel's key management facility"
663 msgstr ""
664
665 #. type: Plain text
666 #: build/C/man2/request_key.2:21
667 #, no-wrap
668 msgid ""
669 "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
670 "B<                         const char *>I<callout_info>B<,>\n"
671 "B<                         key_serial_t >I<keyring>B<);>\n"
672 msgstr ""
673 "B<key_serial_t request_key(const char *>I<type>B<, const char *>I<description>B<,>\n"
674 "B<                         const char *>I<callout_info>B<,>\n"
675 "B<                         key_serial_t >I<keyring>B<);>\n"
676
677 #. type: Plain text
678 #: build/C/man2/request_key.2:31
679 msgid ""
680 "B<request_key>()  asks the kernel to find a key of the given I<type> that "
681 "matches the specified I<description> and, if successful, to attach it to the "
682 "nominated I<keyring> and to return its serial number."
683 msgstr ""
684
685 #. type: Plain text
686 #: build/C/man2/request_key.2:36
687 msgid ""
688 "B<request_key>()  first recursively searches all the keyrings attached to "
689 "the calling process in the order thread-specific keyring, process-specific "
690 "keyring and then session keyring for a matching key."
691 msgstr ""
692
693 #. type: Plain text
694 #: build/C/man2/request_key.2:44
695 msgid ""
696 "If B<request_key>()  is called from a program invoked by B<request_key>()  "
697 "on behalf of some other process to generate a key, then the keyrings of that "
698 "other process will be searched next, using that other process's UID, GID, "
699 "groups and security context to control access."
700 msgstr ""
701
702 #. type: Plain text
703 #: build/C/man2/request_key.2:52
704 msgid ""
705 "The keys in each keyring searched are checked for a match before any child "
706 "keyrings are recursed into.  Only keys that are B<searchable> for the caller "
707 "may be found, and only B<searchable> keyrings may be searched."
708 msgstr ""
709
710 #. type: Plain text
711 #: build/C/man2/request_key.2:61
712 msgid ""
713 "If the key is not found then, if I<callout_info> is set, this function will "
714 "attempt to look further afield.  In such a case, the I<callout_info> is "
715 "passed to a user-space service such as B</sbin/request-key> to generate the "
716 "key."
717 msgstr ""
718
719 #. type: Plain text
720 #: build/C/man2/request_key.2:69
721 msgid ""
722 "If that is unsuccessful also, then an error will be returned, and a "
723 "temporary negative key will be installed in the nominated I<keyring>.  This "
724 "will expire after a few seconds, but will cause subsequent calls to "
725 "B<request_key>()  to fail until it does."
726 msgstr ""
727
728 #. type: Plain text
729 #: build/C/man2/request_key.2:74
730 msgid ""
731 "The I<keyring> serial number may be that of a valid keyring to which the "
732 "caller has write permission, or it may be a special keyring ID:"
733 msgstr ""
734
735 #. type: Plain text
736 #: build/C/man2/request_key.2:94
737 msgid ""
738 "If a key is created, no matter whether it's a valid key or a negative key, "
739 "it will displace any other key of the same type and description from the "
740 "destination I<keyring>."
741 msgstr ""
742
743 #. type: Plain text
744 #: build/C/man2/request_key.2:100
745 msgid ""
746 "On success B<request_key>()  returns the serial number of the key it found.  "
747 "On error, the value -1 will be returned and errno will have been set to an "
748 "appropriate error."
749 msgstr ""
750
751 #. type: TP
752 #: build/C/man2/request_key.2:104
753 #, no-wrap
754 msgid "B<EINTR>"
755 msgstr "B<EINTR>"
756
757 #. type: Plain text
758 #: build/C/man2/request_key.2:107
759 msgid "The request was interrupted by a signal."
760 msgstr ""
761
762 #. type: Plain text
763 #: build/C/man2/request_key.2:114
764 msgid "An expired key was found, but no replacement could be obtained."
765 msgstr ""
766
767 #. type: Plain text
768 #: build/C/man2/request_key.2:117
769 msgid "The attempt to generate a new key was rejected."
770 msgstr ""
771
772 #. type: Plain text
773 #: build/C/man2/request_key.2:120
774 msgid "A revoked key was found, but no replacement could be obtained."
775 msgstr ""
776
777 #. type: Plain text
778 #: build/C/man2/request_key.2:126
779 msgid "No matching key was found."
780 msgstr ""
781
782 #. type: Plain text
783 #: build/C/man2/request_key.2:139
784 msgid "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"
785 msgstr "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"