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