po4a/keyutils/po/keyutils.pot

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