aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2024-07-03 15:45:36 +0200
committerAlejandro Colomar <alx@kernel.org>2024-08-21 23:51:06 +0200
commit4a8cf6035a1f4fc3ceadb9b022d4e15cd996db84 (patch)
tree8d7e9e217670ef7cb68077c233987a5643342773
parent8d2c08518b7a3d1534994d9eb6c8edcc272b1c98 (diff)
downloadman-pages-4a8cf6035a1f4fc3ceadb9b022d4e15cd996db84.tar.gz
KEYCTL_UPDATE.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man2const/KEYCTL_UPDATE.2const46
1 files changed, 12 insertions, 34 deletions
diff --git a/man/man2const/KEYCTL_UPDATE.2const b/man/man2const/KEYCTL_UPDATE.2const
index 540e9ba270..e59522fdaf 100644
--- a/man/man2const/KEYCTL_UPDATE.2const
+++ b/man/man2const/KEYCTL_UPDATE.2const
@@ -20,45 +20,27 @@ Standard C library
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.P
-.BI "long syscall(SYS_keyctl, KEYCTL_UPDATE, unsigned long " arg2 ,
-.BI " unsigned long " arg3 ", unsigned long " arg4 );
+.BI "long syscall(SYS_keyctl, KEYCTL_UPDATE, key_serial_t " key ,
+.BI " void " payload [. size "], size_t " size );
.fi
.SH DESCRIPTION
-.TP
-.BR KEYCTL_UPDATE " (since Linux 2.6.10)"
Update a key's data payload.
-.IP
-The
-.I arg2
-argument (cast to
-.IR key_serial_t )
+.P
+.I key
specifies the ID of the key to be updated.
-The
-.I arg3
-argument (cast to
-.IR "void\ *" )
+.I payload
points to the new payload and
-.I arg4
-(cast to
-.IR size_t )
+.I size
contains the new payload size in bytes.
-.IP
+.P
The caller must have
.I write
permission on the key specified and the key type must support updating.
-.IP
-A negatively instantiated key (see the description of
-.BR KEYCTL_REJECT )
+.P
+A negatively instantiated key
+(see
+.BR KEYCTL_REJECT (2const))
can be positively instantiated with this operation.
-.IP
-The
-.I arg5
-argument is ignored.
-.IP
-This operation is exposed by
-.I libkeyutils
-via the function
-.BR keyctl_update (3).
.SH RETURN VALUE
On success,
0 is returned.
@@ -68,11 +50,7 @@ On error, \-1 is returned, and
is set to indicate the error.
.SH ERRORS
.TP
-.B EOPNOTSUPP
-.I operation
-was
-.B KEYCTL_UPDATE
-and the key type does not support updating.
+The key type does not support updating.
.SH VERSIONS
A wrapper is provided in the
.I libkeyutils