mirror of https://github.com/mkerrisk/man-pages
keyctl.2: Improve KEYCTL_UNLINK details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
c336c20799
commit
2981a43ffc
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue