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

keyctl.2: Improve KEYCTL_SET_TIMEOUT details 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-19 17:17:39 +02:00
parent 329c2892c0
commit adee707302
1 changed files with 18 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
man2/keyctl.2
View File

@ -851,23 +851,33 @@ via the function
.BR keyctl_set_reqkey_keyring (3).
.TP
.BR KEYCTL_SET_TIMEOUT " (since Linux 2.6.16)"
Set timeout on a key.
ID of a key provided in the
Set a timeout on a key.
The ID of the key is specified in
.I arg2
argument (cast to
.IR key_serial_t ),
timeout value (in seconds from current time) provided in the
(cast to
.IR key_serial_t ).
The timeout value, in seconds from the current time,
is specified in
.I arg3
argument (cast to
(cast to
.IR "unsigned int" ).
Specifying the timeout value as 0 clears any existing timeout on the key.
The caller must either have the
.I setattr
permission or hold an instantiation authorization token for the key.
permission on the key
or hold an instantiation authorization token for the key (see
.BR request_key (2)).
A timeout value of 0 clears the timeout.
The key and any links to the key will be
automatically garbage collected after the timeout expires.
Subsequent attempts to access the key will then fail with the error
.BR EKEYEXPIRED .
This operation cannot be used to set timeouts on negative, revoked,
or expired keys.
The arguments
.IR arg4