diff --git a/man2/keyctl.2 b/man2/keyctl.2 index acebb09db..5397b8cfd 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -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