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).
.TP
.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
argument cast to
.I key_serial_t
type) from a keyring (provided in the
(cast to
.IR key_serial_t );
the ID of the keyring from which it is to be unlinked is specified in
.I arg3
argument cast to
.I key_serial_t
type).
(cast to
.IR key_serial_t ).
If the key is not currently linked into the keyring, an error results.
The caller must have
.I write
permission on the keyring from which the key is being removed.
If the last link
to a key is removed, then that key will be scheduled for destruction.
If the last link to a key is removed,
then that key will be scheduled for destruction.
The arguments
.IR arg4
@ -1165,7 +1168,7 @@ and the keyring is full.
.I option
is
.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
.B EINVAL
.I option