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

keyctl.2: Improve KEYCTL_UPDATE details 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-18 17:30:47 +02:00
parent f9fa5a664f
commit 581f820339
1 changed files with 16 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
man2/keyctl.2
View File

@ -125,27 +125,37 @@ via the function
.TP
.B KEYCTL_UPDATE
Update a key's data payload.
The
.I arg2
argument (converted to
argument (cast as
.IR key_serial_t )
should contain the key ID.
specifies the ID of the key to be updated.
The
.I arg3
argument is interpreted as a pointer to the new payload and
argument (cast as
.IR "void\ *" )
points to the new payload and
.I arg4
(converted to
(cast as
.IR size_t )
should contain the payload size in bytes.
contains the new payload size in bytes.
The caller must have
.I write
permission on the key specified and the key type must support updating.
.\" FIXME What does the following mean?
A negative key can be positively instantiated with this call.
The
.I arg5
argument is ignored.
This operation is exposed by
.I libkeyutils
via the function
.BR keyctl_update (3).
.TP
.B KEYCTL_REVOKE
Revoke the key with the ID provided in
@ -844,7 +854,7 @@ did not exist, and
.I arg3
was zero (meaning don't create the key if it didn't exist).
.TP
.B ENOTSUPP
.B EOPNOTSUPP
.I option
is
.B KEYCTL_UPDATE