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

request_key.2: srcfix: FIXME updates 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-29 18:52:50 +02:00
parent 8c8033b102
commit 51b9f6c050
1 changed files with 13 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
man2/request_key.2
View File

@ -24,6 +24,8 @@ request_key \- request a key from the kernel's key management facility
No glibc wrapper is provided for this system call; see NOTES. No glibc wrapper is provided for this system call; see NOTES.
.SH DESCRIPTION .SH DESCRIPTION
.\" FIXME Is the request-key(8) program invoked in circumstances *other* than
.\" when triggered by request_key(2)?
.BR request_key () .BR request_key ()
attempts to find a key of the given attempts to find a key of the given
.I type .I type
@ -35,7 +37,15 @@ If the key is found or created,
attaches it to the keyring whose ID is specified in attaches it to the keyring whose ID is specified in
.I dest_keyring .I dest_keyring
and returns the key's serial number. and returns the key's serial number.
.P .\" FIXME Is 'keyring' allowed to be 0? Reading the source, it appears so.
.\"
.\" If the keyring specified in KEY_INSTANTIATE is 0, and the
.\" dest_keyring given to request_key(2) is 0, what is the result?
.\" Does KEYCTL_SET_REQKEY_KEYRING have any effect in this scenario?
.\"
.\" What is the interaction between the keyring specified in KEY_INSTANTIATE
.\" vs the keyring specified to request_key(2)
.BR request_key () .BR request_key ()
first recursively searches for a matching key in all of the keyrings first recursively searches for a matching key in all of the keyrings
attached to the calling process. attached to the calling process.
@ -211,6 +221,8 @@ specifying the payload and destination keyring.
.BR request_key () .BR request_key ()
can be accessed using the special key ID can be accessed using the special key ID
.BR KEY_SPEC_REQUESTOR_KEYRING .) .BR KEY_SPEC_REQUESTOR_KEYRING .)
.\" FIXME Should an instantiating program be using KEY_SPEC_REQUESTOR_KEYRING?
.\" I couldn't find a use in the keyutils git repo.
.RE .RE
.P .P
If these steps are unsuccessful, then an If these steps are unsuccessful, then an
@ -219,9 +231,6 @@ error will be returned to the caller of
.BR request_key () .BR request_key ()
and a temporary negative key will be installed in the keyring specified by and a temporary negative key will be installed in the keyring specified by
.IR dest_keyring . .IR dest_keyring .
.\" FIXME Is 'keyring' allowed to be NULL? Reading the source, it appears so,
.\" with the result that the key is linked into a default keyring
.\" as specified by KEYCTL_SET_REQKEY_KEYRING.
This will expire after a few seconds, but will cause subsequent calls to This will expire after a few seconds, but will cause subsequent calls to
.BR request_key () .BR request_key ()
to fail until it does. to fail until it does.