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 .RS
.TP .TP
.B KEY_SPEC_THREAD_KEYRING .B KEY_SPEC_THREAD_KEYRING
Look up the calling thread's thread-specific keyring. This specifies the calling thread's thread-specific keyring.
See See
.BR thread_keyring (7). .BR thread_keyring (7).
.TP .TP
.B KEY_SPEC_PROCESS_KEYRING .B KEY_SPEC_PROCESS_KEYRING
Look up the caller's process-specific keyring. This specifies the caller's process-specific keyring.
See See
.BR process_keyring (7). .BR process_keyring (7).
.TP .TP
.B KEY_SPEC_SESSION_KEYRING .B KEY_SPEC_SESSION_KEYRING
Look up the caller's session-specific keyring. This specifies the caller's session-specific keyring.
See See
.BR session_keyring (7). .BR session_keyring (7).
.TP .TP
.B KEY_SPEC_USER_KEYRING .B KEY_SPEC_USER_KEYRING
Look up the caller's UID-specific keyring. This specifies the caller's UID-specific keyring.
See See
.BR user_keyring (7). .BR user_keyring (7).
.TP .TP
.B KEY_SPEC_USER_SESSION_KEYRING .B KEY_SPEC_USER_SESSION_KEYRING
Look up the caller's UID-session keyring. This specifies the caller's UID-session keyring.
See See
.BR user_session_keyring (7). .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 .RE
.IP .IP
If the key specified in If the key specified in
@ -716,46 +728,8 @@ Instead of valid existing keyring IDs, the source
.RI ( arg2 ) .RI ( arg2 )
and destination and destination
.RI ( arg5 ) .RI ( arg5 )
keyrings can be one of the following special keyring IDs: keyrings can be one of the special keyring IDs listed under
.RS .BR KEYCTL_GET_KEYRING_ID .
.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
.IP .IP
This operation is exposed by This operation is exposed by
.I libkeyutils .I libkeyutils
@ -771,7 +745,7 @@ The ID of the key whose payload is to be read is specified in
.IR key_serial_t ). .IR key_serial_t ).
This can be the ID of an existing key, This can be the ID of an existing key,
or any of the special key IDs listed for or any of the special key IDs listed for
.BR KEYCTL_SEARCH . .BR KEYCTL_GET_KEYRING_ID .
.\" including KEY_SPEC_REQKEY_AUTH_KEY .\" including KEY_SPEC_REQKEY_AUTH_KEY
The payload is placed in the buffer pointed by The payload is placed in the buffer pointed by