LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

keyctl.2: Consolidate list of special keyring IDs to a single location 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-28 13:03:00 +02:00
parent 0c1af0231f
commit 303ec07a21
1 changed files with 20 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
man2/keyctl.2
View File

@ -78,29 +78,41 @@ The following values may be specified in
.RS
.TP
.B KEY_SPEC_THREAD_KEYRING
Look up the calling thread's thread-specific keyring.
This specifies the calling thread's thread-specific keyring.
See
.BR thread_keyring (7).
.TP
.B KEY_SPEC_PROCESS_KEYRING
Look up the caller's process-specific keyring.
This specifies the caller's process-specific keyring.
See
.BR process_keyring (7).
.TP
.B KEY_SPEC_SESSION_KEYRING
Look up the caller's session-specific keyring.
This specifies the caller's session-specific keyring.
See
.BR session_keyring (7).
.TP
.B KEY_SPEC_USER_KEYRING
Look up the caller's UID-specific keyring.
This specifies the caller's UID-specific keyring.
See
.BR user_keyring (7).
.TP
.B KEY_SPEC_USER_SESSION_KEYRING
Look up the caller's UID-session keyring.
This specifies the caller's UID-session keyring.
See
.BR user_session_keyring (7).
.TP
.BR KEY_SPEC_REQKEY_AUTH_KEY " (since Linux 2.6.16)"
.\" commit b5f545c880a2a47947ba2118b2509644ab7a2969
This specifies the authorization key created by
.BR request_key (2)
and passed to the process it spawns to generate a key.
.TP
.BR KEY_SPEC_REQUESTOR_KEYRING " (since Linux 2.6.29)"
.\" commit 8bbf4976b59fc9fc2861e79cab7beb3f6d647640
This specifies the key ID for the
.BR request_key (2)
destination keyring.
.RE
.IP
If the key specified in
@ -716,46 +728,8 @@ Instead of valid existing keyring IDs, the source
.RI ( arg2 )
and destination
.RI ( arg5 )
keyrings can be one of the following special keyring IDs:
.RS
.TP
.B KEY_SPEC_THREAD_KEYRING
This specifies the calling thread's thread-specific keyring.
See
.BR thread_keyring (7).
.TP
.B KEY_SPEC_PROCESS_KEYRING
This specifies the caller's process-specific keyring.
See
.BR process_keyring (7).
.TP
.B KEY_SPEC_SESSION_KEYRING
This specifies the caller's session-specific keyring.
See
.BR session_keyring (7).
.TP
.B KEY_SPEC_USER_KEYRING
This specifies the caller's UID-specific keyring.
See
.BR user_keyring (7).
.TP
.B KEY_SPEC_USER_SESSION_KEYRING
This specifies the caller's UID-session keyring.
See
.BR user_session_keyring (7).
.TP
.BR KEY_SPEC_REQKEY_AUTH_KEY " (since Linux 2.6.16)"
.\" commit b5f545c880a2a47947ba2118b2509644ab7a2969
This specifies the authorization key created by
.BR request_key (2)
and passed to the process it spawns to generate a key.
.TP
.BR KEY_SPEC_REQUESTOR_KEYRING " (since Linux 2.6.29)"
.\" commit 8bbf4976b59fc9fc2861e79cab7beb3f6d647640
This specifies the key ID for the
.BR request_key (2)
destination keyring.
.RE
keyrings can be one of the special keyring IDs listed under
.BR KEYCTL_GET_KEYRING_ID .
.IP
This operation is exposed by
.I libkeyutils
@ -771,7 +745,7 @@ The ID of the key whose payload is to be read is specified in
.IR key_serial_t ).
This can be the ID of an existing key,
or any of the special key IDs listed for
.BR KEYCTL_SEARCH .
.BR KEYCTL_GET_KEYRING_ID .
.\" including KEY_SPEC_REQKEY_AUTH_KEY
The payload is placed in the buffer pointed by