# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2012-03-22 04:25+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: build/C/man2/add_key.2:10 #, no-wrap msgid "ADD_KEY" msgstr "" #. type: TH #: build/C/man2/add_key.2:10 build/C/man2/keyctl.2:10 build/C/man2/request_key.2:10 #, no-wrap msgid "2010-02-25" msgstr "" #. type: TH #: build/C/man2/add_key.2:10 build/C/man2/keyctl.2:10 build/C/man2/request_key.2:10 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: build/C/man2/add_key.2:10 build/C/man2/keyctl.2:10 build/C/man2/request_key.2:10 #, no-wrap msgid "Linux Key Management Calls" msgstr "" #. type: SH #: build/C/man2/add_key.2:11 build/C/man2/keyctl.2:11 build/C/man2/request_key.2:11 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:13 msgid "add_key - Add a key to the kernel's key management facility" msgstr "" #. type: SH #: build/C/man2/add_key.2:13 build/C/man2/keyctl.2:13 build/C/man2/request_key.2:13 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:16 build/C/man2/keyctl.2:16 build/C/man2/request_key.2:16 #, no-wrap msgid "B<#include Ekeyutils.hE>\n" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:20 #, no-wrap msgid "" "BIB<, const char " "*>IB<,>\n" "B< const void *>IB<, size_t >IB<,>\n" "B< key_serial_t >IB<);>\n" msgstr "" #. type: SH #: build/C/man2/add_key.2:20 build/C/man2/keyctl.2:18 build/C/man2/request_key.2:20 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:33 msgid "" "B() asks the kernel to create or update a key of the given I " "and I, instantiate it with the I of length I, " "and to attach it to the nominated I and to return its serial " "number." msgstr "" #. type: Plain text #: build/C/man2/add_key.2:36 msgid "" "The key type may reject the data if it's in the wrong format or in some " "other way invalid." msgstr "" #. type: Plain text #: build/C/man2/add_key.2:44 msgid "" "If the destination I already contains a key that matches the " "specified I and I then, if the key type supports it, that " "key will be updated rather than a new key being created; if not, a new key " "will be created and it will displace the link to the extant key from the " "keyring." msgstr "" #. type: Plain text #: build/C/man2/add_key.2:49 msgid "" "The destination I serial number may be that of a valid keyring to " "which the caller has write permission, or it may be a special keyring ID:" msgstr "" #. type: TP #: build/C/man2/add_key.2:49 build/C/man2/request_key.2:70 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:52 build/C/man2/request_key.2:73 msgid "This specifies the caller's thread-specific keyring." msgstr "" #. type: TP #: build/C/man2/add_key.2:52 build/C/man2/request_key.2:73 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:55 build/C/man2/request_key.2:76 msgid "This specifies the caller's process-specific keyring." msgstr "" #. type: TP #: build/C/man2/add_key.2:55 build/C/man2/request_key.2:76 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:58 build/C/man2/request_key.2:79 msgid "This specifies the caller's session-specific keyring." msgstr "" #. type: TP #: build/C/man2/add_key.2:58 build/C/man2/request_key.2:79 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:61 build/C/man2/request_key.2:82 msgid "This specifies the caller's UID-specific keyring." msgstr "" #. type: TP #: build/C/man2/add_key.2:61 build/C/man2/request_key.2:82 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:64 build/C/man2/request_key.2:85 msgid "This specifies the caller's UID-session keyring." msgstr "" #. type: SH #: build/C/man2/add_key.2:64 #, no-wrap msgid "KEY TYPES" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:67 msgid "" "There are a number of key types available in the core key management code, " "and these can be specified to this function:" msgstr "" #. type: TP #: build/C/man2/add_key.2:67 #, no-wrap msgid "B<``user''>" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:80 msgid "" "Keys of the user-defined key type may contain a blob of arbitrary data, and " "the I may be any valid string, though it is preferred that the " "description be prefixed with a string representing the service to which the " "key is of interest and a colon (for instance ``B''). The " "I may be empty or B for keys of this type." msgstr "" #. type: TP #: build/C/man2/add_key.2:80 #, no-wrap msgid "B<``keyring''>" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:89 msgid "" "Keyrings are special key types that may contain links to sequences of other " "keys of any type. If this interface is used to create a keyring, then a " "B I should be specified, and I should be zero." msgstr "" #. type: SH #: build/C/man2/add_key.2:89 build/C/man2/keyctl.2:79 build/C/man2/request_key.2:90 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:96 msgid "" "On success B() returns the serial number of the key it created or " "updated. On error, the value B<-1> will be returned and errno will have " "been set to an appropriate error." msgstr "" #. type: SH #: build/C/man2/add_key.2:96 build/C/man2/keyctl.2:86 build/C/man2/request_key.2:97 #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: build/C/man2/add_key.2:97 build/C/man2/keyctl.2:103 build/C/man2/request_key.2:120 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:100 msgid "The keyring doesn't exist." msgstr "" #. type: TP #: build/C/man2/add_key.2:100 build/C/man2/keyctl.2:94 build/C/man2/request_key.2:108 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:103 msgid "The keyring has expired." msgstr "" #. type: TP #: build/C/man2/add_key.2:103 build/C/man2/keyctl.2:100 build/C/man2/request_key.2:114 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:106 msgid "The keyring has been revoked." msgstr "" #. type: TP #: build/C/man2/add_key.2:106 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:109 msgid "The payload data was invalid." msgstr "" #. type: TP #: build/C/man2/add_key.2:109 build/C/man2/request_key.2:117 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:112 build/C/man2/request_key.2:120 msgid "Insufficient memory to create a key." msgstr "" #. type: TP #: build/C/man2/add_key.2:112 build/C/man2/keyctl.2:90 build/C/man2/request_key.2:104 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:116 build/C/man2/request_key.2:108 msgid "" "The key quota for this user would be exceeded by creating this key or " "linking it to the keyring." msgstr "" #. type: TP #: build/C/man2/add_key.2:116 build/C/man2/keyctl.2:87 build/C/man2/request_key.2:98 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:119 build/C/man2/request_key.2:101 msgid "The keyring wasn't available for modification by the user." msgstr "" #. type: SH #: build/C/man2/add_key.2:119 build/C/man2/keyctl.2:106 build/C/man2/request_key.2:123 #, no-wrap msgid "LINKING" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:127 build/C/man2/keyctl.2:114 build/C/man2/request_key.2:131 msgid "" "Although this is a Linux system call, it is not present in I but can " "be found rather in I. When linking, B<-lkeyutils> should be " "specified to the linker." msgstr "" #. type: SH #: build/C/man2/add_key.2:127 build/C/man2/keyctl.2:114 build/C/man2/request_key.2:131 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:131 msgid "B(1), B(2), B(2)" msgstr "" #. type: SH #: build/C/man2/add_key.2:131 build/C/man2/keyctl.2:160 build/C/man2/request_key.2:136 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: build/C/man2/add_key.2:138 build/C/man2/keyctl.2:167 build/C/man2/request_key.2:143 msgid "" "This page is part of release 3.37 of the Linux I project. A " "description of the project, and information about reporting bugs, can be " "found at http://www.kernel.org/doc/man-pages/." msgstr "" #. type: TH #: build/C/man2/keyctl.2:10 #, no-wrap msgid "KEYCTL" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:13 msgid "keyctl - Manipulate the kernel's key management facility" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:18 #, no-wrap msgid "BIB<, ...);>\n" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:21 msgid "B() has a number of functions available:" msgstr "" #. type: TP #: build/C/man2/keyctl.2:21 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:24 msgid "Ask for a keyring's ID." msgstr "" #. type: TP #: build/C/man2/keyctl.2:24 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:27 msgid "Join or start named session keyring." msgstr "" #. type: TP #: build/C/man2/keyctl.2:27 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:30 msgid "Update a key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:30 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:33 msgid "Revoke a key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:33 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:36 msgid "Set ownership of a key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:36 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:39 msgid "Set perms on a key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:39 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:42 msgid "Describe a key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:42 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:45 msgid "Clear contents of a keyring." msgstr "" #. type: TP #: build/C/man2/keyctl.2:45 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:48 msgid "Link a key into a keyring." msgstr "" #. type: TP #: build/C/man2/keyctl.2:48 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:51 msgid "Unlink a key from a keyring." msgstr "" #. type: TP #: build/C/man2/keyctl.2:51 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:54 msgid "Search for a key in a keyring." msgstr "" #. type: TP #: build/C/man2/keyctl.2:54 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:57 msgid "Read a key or keyring's contents." msgstr "" #. type: TP #: build/C/man2/keyctl.2:57 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:60 msgid "Instantiate a partially constructed key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:60 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:63 msgid "Negate a partially constructed key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:63 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:66 msgid "Set default request-key keyring." msgstr "" #. type: TP #: build/C/man2/keyctl.2:66 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:69 msgid "Set timeout on a key." msgstr "" #. type: TP #: build/C/man2/keyctl.2:69 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:72 msgid "Assume authority to instantiate key." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:79 msgid "" "These are wrapped by B into individual functions to permit " "compiler the compiler to check types. See the B section at the " "bottom." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:86 msgid "" "On success B() returns the serial number of the key it found. On " "error, the value B<-1> will be returned and errno will have been set to an " "appropriate error." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:90 msgid "A key operation wasn't permitted." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:94 msgid "" "The key quota for the caller's user would be exceeded by creating a key or " "linking it to the keyring." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:97 msgid "An expired key was found or specified." msgstr "" #. type: TP #: build/C/man2/keyctl.2:97 build/C/man2/request_key.2:111 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:100 msgid "A rejected key was found or specified." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:103 msgid "A revoked key was found or specified." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:106 msgid "No matching key was found or an invalid key was specified." msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:116 msgid "B(1)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:118 msgid "B(2)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:120 msgid "B(2)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:122 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:124 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:126 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:128 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:130 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:132 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:134 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:136 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:138 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:140 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:142 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:144 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:146 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:148 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:150 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:152 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:154 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:156 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:158 msgid "B(3)," msgstr "" #. type: Plain text #: build/C/man2/keyctl.2:160 msgid "B(8)" msgstr "" #. type: TH #: build/C/man2/request_key.2:10 #, no-wrap msgid "REQUEST_KEY" msgstr "" #. type: Plain text #: build/C/man2/request_key.2:13 msgid "request_key - Request a key from the kernel's key management facility" msgstr "" #. type: Plain text #: build/C/man2/request_key.2:20 #, no-wrap msgid "" "BIB<, const char " "*>IB<,>\n" "B< const char *>IB<,>\n" "B< key_serial_t >IB<);>\n" msgstr "" #. type: Plain text #: build/C/man2/request_key.2:29 msgid "" "B() asks the kernel to find a key of the given I that " "matches the specified I and, if successful, to attach it to the " "nominated I and to return its serial number." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:34 msgid "" "B() first recursively searches all the keyrings attached to " "the calling process in the order thread-specific keyring, process-specific " "keyring and then session keyring for a matching key." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:42 msgid "" "If B() is called from a program invoked by B() " "on behalf of some other process to generate a key, then the keyrings of that " "other process will be searched next, using that other process's UID, GID, " "groups and security context to control access." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:49 msgid "" "The keys in each keyring searched are checked for a match before any child " "keyrings are recursed into. Only keys that are B for the caller " "may be found, and only B keyrings may be searched." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:57 msgid "" "If the key is not found then, if I is set, this function will " "attempt to look further afield. In such a case, the I is " "passed to a userspace service such as B to generate the " "key." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:65 msgid "" "If that is unsuccessful also, then an error will be returned, and a " "temporary negative key will be installed in the nominated I. This " "will expire after a few seconds, but will cause subsequent calls to " "B() to fail until it does." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:70 msgid "" "The I serial number may be that of a valid keyring to which the " "caller has write permission, or it may be a special keyring ID:" msgstr "" #. type: Plain text #: build/C/man2/request_key.2:90 msgid "" "If a key is created, no matter whether it's a valid key or a negative key, " "it will displace any other key of the same type and description from the " "destination I." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:97 msgid "" "On success B() returns the serial number of the key it found. " "On error, the value B<-1> will be returned and errno will have been set to " "an appropriate error." msgstr "" #. type: TP #: build/C/man2/request_key.2:101 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man2/request_key.2:104 msgid "The request was interrupted by a signal." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:111 msgid "An expired key was found, but no replacement could be obtained." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:114 msgid "The attempt to generate a new key was rejected." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:117 msgid "A revoked key was found, but no replacement could be obtained." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:123 msgid "No matching key was found." msgstr "" #. type: Plain text #: build/C/man2/request_key.2:136 msgid "B(1), B(2), B(2), B(8)" msgstr ""