keyctl.2: Improve KEYCTL_UNLINK details

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-19 13:15:03 +02:00
parent c336c20799
commit 2981a43ffc
1 changed files with 13 additions and 10 deletions

View File

@ -570,22 +570,25 @@ via the function
.BR keyctl_link (3). .BR keyctl_link (3).
.TP .TP
.B KEYCTL_UNLINK .B KEYCTL_UNLINK
Unlink a key (provided in the Unlink a key from a keyring.
The ID of the key to be unlinked is specified in
.I arg2 .I arg2
argument cast to (cast to
.I key_serial_t .IR key_serial_t );
type) from a keyring (provided in the the ID of the keyring from which it is to be unlinked is specified in
.I arg3 .I arg3
argument cast to (cast to
.I key_serial_t .IR key_serial_t ).
type).
If the key is not currently linked into the keyring, an error results.
The caller must have The caller must have
.I write .I write
permission on the keyring from which the key is being removed. permission on the keyring from which the key is being removed.
If the last link If the last link to a key is removed,
to a key is removed, then that key will be scheduled for destruction. then that key will be scheduled for destruction.
The arguments The arguments
.IR arg4 .IR arg4
@ -1165,7 +1168,7 @@ and the keyring is full.
.I option .I option
is is
.B KEYCTL_UNLINK .B KEYCTL_UNLINK
and the key requested for unlinking isn't linked to the keyring. and the key to be unlinked isn't linked to the keyring.
.TP .TP
.B EINVAL .B EINVAL
.I option .I option