keyctl.2: Further details for KEYCTL_GET_KEYRING_ID

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-24 15:47:05 +02:00
parent 6cec06d03a
commit 63eab5d8dd
1 changed files with 32 additions and 2 deletions

View File

@ -55,8 +55,38 @@ This operation looks up the special key whose ID is provided in
.I arg2
(cast to
.IR key_serial_t )
and (if it is found) the ID of corresponding real key is returned
and (if it is found) the ID of the corresponding real key is returned
as the function result.
The following values may be specified in
.IR arg2 :
.RS
.TP
.B KEY_SPEC_THREAD_KEYRING
Look up 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.
See
.BR process_keyring (7).
.TP
.B KEY_SPEC_SESSION_KEYRING
Look up 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.
See
.BR user_keyring (7).
.TP
.B KEY_SPEC_USER_SESSION_KEYRING
Look up the caller's UID-session keyring.
See
.BR user_session_keyring (7).
.RE
.IP
If the key specified in
.I arg2
does not exist, then a new key is created if the