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-05-01 04:38+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:132
 334 msgid "B<keyctl>(1), B<keyctl>(2), B<request_key>(2)"
 335 msgstr ""
 336
 337 #. type: SH
 338 #: build/C/man2/add_key.2:132 build/C/man2/keyctl.2:161 build/C/man2/request_key.2:137
 339 #, no-wrap
 340 msgid "COLOPHON"
 341 msgstr ""
 342
 343 #. type: Plain text
 344 #: build/C/man2/add_key.2:139 build/C/man2/keyctl.2:168 build/C/man2/request_key.2:144
 345 msgid ""
 346 "This page is part of release 3.40 of the Linux I<man-pages> project.  A "
 347 "description of the project, and information about reporting bugs, can be "
 348 "found at http://www.kernel.org/doc/man-pages/."
 349 msgstr ""
 350
 351 #. type: TH
 352 #: build/C/man2/keyctl.2:10
 353 #, no-wrap
 354 msgid "KEYCTL"
 355 msgstr ""
 356
 357 #. type: Plain text
 358 #: build/C/man2/keyctl.2:13
 359 msgid "keyctl - Manipulate the kernel's key management facility"
 360 msgstr ""
 361
 362 #. type: Plain text
 363 #: build/C/man2/keyctl.2:18
 364 #, no-wrap
 365 msgid "B<long keyctl(int >I<cmd>B<, ...);>\n"
 366 msgstr ""
 367
 368 #. type: Plain text
 369 #: build/C/man2/keyctl.2:22
 370 msgid "B<keyctl>()  has a number of functions available:"
 371 msgstr ""
 372
 373 #. type: TP
 374 #: build/C/man2/keyctl.2:22
 375 #, no-wrap
 376 msgid "B<KEYCTL_GET_KEYRING_ID>"
 377 msgstr ""
 378
 379 #. type: Plain text
 380 #: build/C/man2/keyctl.2:25
 381 msgid "Ask for a keyring's ID."
 382 msgstr ""
 383
 384 #. type: TP
 385 #: build/C/man2/keyctl.2:25
 386 #, no-wrap
 387 msgid "B<KEYCTL_JOIN_SESSION_KEYRING>"
 388 msgstr ""
 389
 390 #. type: Plain text
 391 #: build/C/man2/keyctl.2:28
 392 msgid "Join or start named session keyring."
 393 msgstr ""
 394
 395 #. type: TP
 396 #: build/C/man2/keyctl.2:28
 397 #, no-wrap
 398 msgid "B<KEYCTL_UPDATE>"
 399 msgstr ""
 400
 401 #. type: Plain text
 402 #: build/C/man2/keyctl.2:31
 403 msgid "Update a key."
 404 msgstr ""
 405
 406 #. type: TP
 407 #: build/C/man2/keyctl.2:31
 408 #, no-wrap
 409 msgid "B<KEYCTL_REVOKE>"
 410 msgstr ""
 411
 412 #. type: Plain text
 413 #: build/C/man2/keyctl.2:34
 414 msgid "Revoke a key."
 415 msgstr ""
 416
 417 #. type: TP
 418 #: build/C/man2/keyctl.2:34
 419 #, no-wrap
 420 msgid "B<KEYCTL_CHOWN>"
 421 msgstr ""
 422
 423 #. type: Plain text
 424 #: build/C/man2/keyctl.2:37
 425 msgid "Set ownership of a key."
 426 msgstr ""
 427
 428 #. type: TP
 429 #: build/C/man2/keyctl.2:37
 430 #, no-wrap
 431 msgid "B<KEYCTL_SETPERM>"
 432 msgstr ""
 433
 434 #. type: Plain text
 435 #: build/C/man2/keyctl.2:40
 436 msgid "Set perms on a key."
 437 msgstr ""
 438
 439 #. type: TP
 440 #: build/C/man2/keyctl.2:40
 441 #, no-wrap
 442 msgid "B<KEYCTL_DESCRIBE>"
 443 msgstr ""
 444
 445 #. type: Plain text
 446 #: build/C/man2/keyctl.2:43
 447 msgid "Describe a key."
 448 msgstr ""
 449
 450 #. type: TP
 451 #: build/C/man2/keyctl.2:43
 452 #, no-wrap
 453 msgid "B<KEYCTL_CLEAR>"
 454 msgstr ""
 455
 456 #. type: Plain text
 457 #: build/C/man2/keyctl.2:46
 458 msgid "Clear contents of a keyring."
 459 msgstr ""
 460
 461 #. type: TP
 462 #: build/C/man2/keyctl.2:46
 463 #, no-wrap
 464 msgid "B<KEYCTL_LINK>"
 465 msgstr ""
 466
 467 #. type: Plain text
 468 #: build/C/man2/keyctl.2:49
 469 msgid "Link a key into a keyring."
 470 msgstr ""
 471
 472 #. type: TP
 473 #: build/C/man2/keyctl.2:49
 474 #, no-wrap
 475 msgid "B<KEYCTL_UNLINK>"
 476 msgstr ""
 477
 478 #. type: Plain text
 479 #: build/C/man2/keyctl.2:52
 480 msgid "Unlink a key from a keyring."
 481 msgstr ""
 482
 483 #. type: TP
 484 #: build/C/man2/keyctl.2:52
 485 #, no-wrap
 486 msgid "B<KEYCTL_SEARCH>"
 487 msgstr ""
 488
 489 #. type: Plain text
 490 #: build/C/man2/keyctl.2:55
 491 msgid "Search for a key in a keyring."
 492 msgstr ""
 493
 494 #. type: TP
 495 #: build/C/man2/keyctl.2:55
 496 #, no-wrap
 497 msgid "B<KEYCTL_READ>"
 498 msgstr ""
 499
 500 #. type: Plain text
 501 #: build/C/man2/keyctl.2:58
 502 msgid "Read a key or keyring's contents."
 503 msgstr ""
 504
 505 #. type: TP
 506 #: build/C/man2/keyctl.2:58
 507 #, no-wrap
 508 msgid "B<KEYCTL_INSTANTIATE>"
 509 msgstr ""
 510
 511 #. type: Plain text
 512 #: build/C/man2/keyctl.2:61
 513 msgid "Instantiate a partially constructed key."
 514 msgstr ""
 515
 516 #. type: TP
 517 #: build/C/man2/keyctl.2:61
 518 #, no-wrap
 519 msgid "B<KEYCTL_NEGATE>"
 520 msgstr ""
 521
 522 #. type: Plain text
 523 #: build/C/man2/keyctl.2:64
 524 msgid "Negate a partially constructed key."
 525 msgstr ""
 526
 527 #. type: TP
 528 #: build/C/man2/keyctl.2:64
 529 #, no-wrap
 530 msgid "B<KEYCTL_SET_REQKEY_KEYRING>"
 531 msgstr ""
 532
 533 #. type: Plain text
 534 #: build/C/man2/keyctl.2:67
 535 msgid "Set default request-key keyring."
 536 msgstr ""
 537
 538 #. type: TP
 539 #: build/C/man2/keyctl.2:67
 540 #, no-wrap
 541 msgid "B<KEYCTL_SET_TIMEOUT>"
 542 msgstr ""
 543
 544 #. type: Plain text
 545 #: build/C/man2/keyctl.2:70
 546 msgid "Set timeout on a key."
 547 msgstr ""
 548
 549 #. type: TP
 550 #: build/C/man2/keyctl.2:70
 551 #, no-wrap
 552 msgid "B<KEYCTL_ASSUME_AUTHORITY>"
 553 msgstr ""
 554
 555 #. type: Plain text
 556 #: build/C/man2/keyctl.2:73
 557 msgid "Assume authority to instantiate key."
 558 msgstr ""
 559
 560 #. type: Plain text
 561 #: build/C/man2/keyctl.2:80
 562 msgid ""
 563 "These are wrapped by B<libkeyutils> into individual functions to permit "
 564 "compiler the compiler to check types.  See the B<See Also> section at the "
 565 "bottom."
 566 msgstr ""
 567
 568 #. type: Plain text
 569 #: build/C/man2/keyctl.2:87
 570 msgid ""
 571 "On success B<keyctl>()  returns the serial number of the key it found.  On "
 572 "error, the value B<-1> will be returned and errno will have been set to an "
 573 "appropriate error."
 574 msgstr ""
 575
 576 #. type: Plain text
 577 #: build/C/man2/keyctl.2:91
 578 msgid "A key operation wasn't permitted."
 579 msgstr ""
 580
 581 #. type: Plain text
 582 #: build/C/man2/keyctl.2:95
 583 msgid ""
 584 "The key quota for the caller's user would be exceeded by creating a key or "
 585 "linking it to the keyring."
 586 msgstr ""
 587
 588 #. type: Plain text
 589 #: build/C/man2/keyctl.2:98
 590 msgid "An expired key was found or specified."
 591 msgstr ""
 592
 593 #. type: TP
 594 #: build/C/man2/keyctl.2:98 build/C/man2/request_key.2:112
 595 #, no-wrap
 596 msgid "B<EKEYREJECTED>"
 597 msgstr ""
 598
 599 #. type: Plain text
 600 #: build/C/man2/keyctl.2:101
 601 msgid "A rejected key was found or specified."
 602 msgstr ""
 603
 604 #. type: Plain text
 605 #: build/C/man2/keyctl.2:104
 606 msgid "A revoked key was found or specified."
 607 msgstr ""
 608
 609 #. type: Plain text
 610 #: build/C/man2/keyctl.2:107
 611 msgid "No matching key was found or an invalid key was specified."
 612 msgstr ""
 613
 614 #. type: Plain text
 615 #: build/C/man2/keyctl.2:117
 616 msgid "B<keyctl>(1),"
 617 msgstr ""
 618
 619 #. type: Plain text
 620 #: build/C/man2/keyctl.2:119
 621 msgid "B<add_key>(2),"
 622 msgstr ""
 623
 624 #. type: Plain text
 625 #: build/C/man2/keyctl.2:121
 626 msgid "B<request_key>(2),"
 627 msgstr ""
 628
 629 #. type: Plain text
 630 #: build/C/man2/keyctl.2:123
 631 msgid "B<keyctl_get_keyring_ID>(3),"
 632 msgstr ""
 633
 634 #. type: Plain text
 635 #: build/C/man2/keyctl.2:125
 636 msgid "B<keyctl_join_session_keyring>(3),"
 637 msgstr ""
 638
 639 #. type: Plain text
 640 #: build/C/man2/keyctl.2:127
 641 msgid "B<keyctl_update>(3),"
 642 msgstr ""
 643
 644 #. type: Plain text
 645 #: build/C/man2/keyctl.2:129
 646 msgid "B<keyctl_revoke>(3),"
 647 msgstr ""
 648
 649 #. type: Plain text
 650 #: build/C/man2/keyctl.2:131
 651 msgid "B<keyctl_chown>(3),"
 652 msgstr ""
 653
 654 #. type: Plain text
 655 #: build/C/man2/keyctl.2:133
 656 msgid "B<keyctl_setperm>(3),"
 657 msgstr ""
 658
 659 #. type: Plain text
 660 #: build/C/man2/keyctl.2:135
 661 msgid "B<keyctl_describe>(3),"
 662 msgstr ""
 663
 664 #. type: Plain text
 665 #: build/C/man2/keyctl.2:137
 666 msgid "B<keyctl_clear>(3),"
 667 msgstr ""
 668
 669 #. type: Plain text
 670 #: build/C/man2/keyctl.2:139
 671 msgid "B<keyctl_link>(3),"
 672 msgstr ""
 673
 674 #. type: Plain text
 675 #: build/C/man2/keyctl.2:141
 676 msgid "B<keyctl_unlink>(3),"
 677 msgstr ""
 678
 679 #. type: Plain text
 680 #: build/C/man2/keyctl.2:143
 681 msgid "B<keyctl_search>(3),"
 682 msgstr ""
 683
 684 #. type: Plain text
 685 #: build/C/man2/keyctl.2:145
 686 msgid "B<keyctl_read>(3),"
 687 msgstr ""
 688
 689 #. type: Plain text
 690 #: build/C/man2/keyctl.2:147
 691 msgid "B<keyctl_instantiate>(3),"
 692 msgstr ""
 693
 694 #. type: Plain text
 695 #: build/C/man2/keyctl.2:149
 696 msgid "B<keyctl_negate>(3),"
 697 msgstr ""
 698
 699 #. type: Plain text
 700 #: build/C/man2/keyctl.2:151
 701 msgid "B<keyctl_set_reqkey_keyring>(3),"
 702 msgstr ""
 703
 704 #. type: Plain text
 705 #: build/C/man2/keyctl.2:153
 706 msgid "B<keyctl_set_timeout>(3),"
 707 msgstr ""
 708
 709 #. type: Plain text
 710 #: build/C/man2/keyctl.2:155
 711 msgid "B<keyctl_assume_authority>(3),"
 712 msgstr ""
 713
 714 #. type: Plain text
 715 #: build/C/man2/keyctl.2:157
 716 msgid "B<keyctl_describe_alloc>(3),"
 717 msgstr ""
 718
 719 #. type: Plain text
 720 #: build/C/man2/keyctl.2:159
 721 msgid "B<keyctl_read_alloc>(3),"
 722 msgstr ""
 723
 724 #. type: Plain text
 725 #: build/C/man2/keyctl.2:161
 726 msgid "B<request-key>(8)"
 727 msgstr ""
 728
 729 #. type: TH
 730 #: build/C/man2/request_key.2:10
 731 #, no-wrap
 732 msgid "REQUEST_KEY"
 733 msgstr ""
 734
 735 #. type: Plain text
 736 #: build/C/man2/request_key.2:13
 737 msgid "request_key - Request a key from the kernel's key management facility"
 738 msgstr ""
 739
 740 #. type: Plain text
 741 #: build/C/man2/request_key.2:20
 742 #, no-wrap
 743 msgid ""
 744 "B<key_serial_t request_key(const char *>I<type>B<, const char "
 745 "*>I<description>B<,>\n"
 746 "B<                         const char *>I<callout_info>B<,>\n"
 747 "B<                         key_serial_t >I<keyring>B<);>\n"
 748 msgstr ""
 749
 750 #. type: Plain text
 751 #: build/C/man2/request_key.2:30
 752 msgid ""
 753 "B<request_key>()  asks the kernel to find a key of the given I<type> that "
 754 "matches the specified I<description> and, if successful, to attach it to the "
 755 "nominated I<keyring> and to return its serial number."
 756 msgstr ""
 757
 758 #. type: Plain text
 759 #: build/C/man2/request_key.2:35
 760 msgid ""
 761 "B<request_key>()  first recursively searches all the keyrings attached to "
 762 "the calling process in the order thread-specific keyring, process-specific "
 763 "keyring and then session keyring for a matching key."
 764 msgstr ""
 765
 766 #. type: Plain text
 767 #: build/C/man2/request_key.2:43
 768 msgid ""
 769 "If B<request_key>()  is called from a program invoked by B<request_key>()  "
 770 "on behalf of some other process to generate a key, then the keyrings of that "
 771 "other process will be searched next, using that other process's UID, GID, "
 772 "groups and security context to control access."
 773 msgstr ""
 774
 775 #. type: Plain text
 776 #: build/C/man2/request_key.2:50
 777 msgid ""
 778 "The keys in each keyring searched are checked for a match before any child "
 779 "keyrings are recursed into.  Only keys that are B<searchable> for the caller "
 780 "may be found, and only B<searchable> keyrings may be searched."
 781 msgstr ""
 782
 783 #. type: Plain text
 784 #: build/C/man2/request_key.2:58
 785 msgid ""
 786 "If the key is not found then, if I<callout_info> is set, this function will "
 787 "attempt to look further afield.  In such a case, the I<callout_info> is "
 788 "passed to a userspace service such as B</sbin/request-key> to generate the "
 789 "key."
 790 msgstr ""
 791
 792 #. type: Plain text
 793 #: build/C/man2/request_key.2:66
 794 msgid ""
 795 "If that is unsuccessful also, then an error will be returned, and a "
 796 "temporary negative key will be installed in the nominated I<keyring>.  This "
 797 "will expire after a few seconds, but will cause subsequent calls to "
 798 "B<request_key>()  to fail until it does."
 799 msgstr ""
 800
 801 #. type: Plain text
 802 #: build/C/man2/request_key.2:71
 803 msgid ""
 804 "The I<keyring> serial number may be that of a valid keyring to which the "
 805 "caller has write permission, or it may be a special keyring ID:"
 806 msgstr ""
 807
 808 #. type: Plain text
 809 #: build/C/man2/request_key.2:91
 810 msgid ""
 811 "If a key is created, no matter whether it's a valid key or a negative key, "
 812 "it will displace any other key of the same type and description from the "
 813 "destination I<keyring>."
 814 msgstr ""
 815
 816 #. type: Plain text
 817 #: build/C/man2/request_key.2:98
 818 msgid ""
 819 "On success B<request_key>()  returns the serial number of the key it found.  "
 820 "On error, the value B<-1> will be returned and errno will have been set to "
 821 "an appropriate error."
 822 msgstr ""
 823
 824 #. type: TP
 825 #: build/C/man2/request_key.2:102
 826 #, no-wrap
 827 msgid "B<EINTR>"
 828 msgstr ""
 829
 830 #. type: Plain text
 831 #: build/C/man2/request_key.2:105
 832 msgid "The request was interrupted by a signal."
 833 msgstr ""
 834
 835 #. type: Plain text
 836 #: build/C/man2/request_key.2:112
 837 msgid "An expired key was found, but no replacement could be obtained."
 838 msgstr ""
 839
 840 #. type: Plain text
 841 #: build/C/man2/request_key.2:115
 842 msgid "The attempt to generate a new key was rejected."
 843 msgstr ""
 844
 845 #. type: Plain text
 846 #: build/C/man2/request_key.2:118
 847 msgid "A revoked key was found, but no replacement could be obtained."
 848 msgstr ""
 849
 850 #. type: Plain text
 851 #: build/C/man2/request_key.2:124
 852 msgid "No matching key was found."
 853 msgstr ""
 854
 855 #. type: Plain text
 856 #: build/C/man2/request_key.2:137
 857 msgid "B<keyctl>(1), B<add_key>(2), B<keyctl>(2), B<request-key>(8)"
 858 msgstr ""