keyctl.2: Improve KEYCTL_REVOKE details

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-18 17:44:15 +02:00
parent 581f820339
commit cbf0e35e65
1 changed files with 13 additions and 3 deletions

View File

@ -160,12 +160,17 @@ via the function
.B KEYCTL_REVOKE
Revoke the key with the ID provided in
.I arg2
(converted to
(cast as
.IR key_serial_t ).
The caller must have
.IR write " or " setattr
permission on they key.
.IR write
or
.IR setattr
permission on the key.
.\" FIXME Keys with the KEY_FLAG_KEEP bit set cause an EPERM
.\" error for KEYCTL_REVOKE. Does this need to be documented?
.\" (It's not clear how KEY_FLAG_KEEP gets set.)
The arguments
.IR arg3 ,
@ -173,6 +178,11 @@ The arguments
and
.IR arg5
are ignored.
This operation is exposed by
.I libkeyutils
via the function
.BR keyctl_revoke (3).
.TP
.B KEYCTL_CHOWN
Set the ownership of a key.