keyctl.2: Improve KEYCTL_READ details

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-19 13:57:52 +02:00
parent 4f5a5b13ac
commit 8baa481508
1 changed files with 12 additions and 9 deletions

View File

@ -710,21 +710,24 @@ via the function
.BR keyctl_search (3).
.TP
.BR KEYCTL_READ " (since Linux 2.6.11)"
Read the payload of the key whose ID is provided in the
Read the payload data of a key.
The ID of the key whose payload is to be read is specified in
.I arg2
argument (cast to
(cast to
.IR key_serial_t ).
The payload is placed in the buffer pointed by the
The payload is placed in the buffer pointed by
.I arg3
argument (cast to
(cast to
.IR "char\ *" );
the size of that buffer must be provided in the
the size of that buffer must be specified in
.I arg4
argument (cast to
(cast to
.IR size_t ).
The key must either grant the caller
.I read
permission, or it must grant the caller
permission, or grant the caller
.I search
permission when searched for from the process keyrings.
@ -1135,8 +1138,8 @@ irrespective of the provided buffer size.
The ID of the key that was found.
.TP
.B KEYCTL_READ
The amount of data that is available in the key, irrespective of the provided
buffer size.
The amount of data that is available in the key,
irrespective of the provided buffer size.
.TP
.B KEYCTL_SET_REQKEY_KEYRING
Old setting (one of