keyctl.2: Rework KEYCTL_SET_REQKEY_KEYRING values as a list

We don't (IIUC) need the numeric values, just the constant
names. Reformatting as a list make things more readable.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-17 16:17:48 +02:00
parent 461a8ce535
commit d1d5839dbb
1 changed files with 27 additions and 14 deletions

View File

@ -397,21 +397,34 @@ argument (converted to
.I int
type) should contain one of the following values, defined in
.IR <linux/keyring.h> :
.nf
.in +4n
#define KEY_REQKEY_DEFL_NO_CHANGE -1 /* No change */
#define KEY_REQKEY_DEFL_DEFAULT 0 /* Default keyring */
#define KEY_REQKEY_DEFL_THREAD_KEYRING 1 /* Thread-specific keyring */
#define KEY_REQKEY_DEFL_PROCESS_KEYRING 2 /* Process-specific keyring */
#define KEY_REQKEY_DEFL_SESSION_KEYRING 3 /* Session-specific keyring */
#define KEY_REQKEY_DEFL_USER_KEYRING 4 /* UID-specific keyring */
#define KEY_REQKEY_DEFL_USER_SESSION_KEYRING 5 /* Session keyring of UID */
.RS
.TP 33
.BR KEY_REQKEY_DEFL_NO_CHANGE
No change.
.TP
.BR KEY_REQKEY_DEFL_DEFAULT
Default keyring.
.TP
.BR KEY_REQKEY_DEFL_THREAD_KEYRING
Thread-specific keyring.
.TP
.BR KEY_REQKEY_DEFL_PROCESS_KEYRING
Process-specific keyring.
.TP
.BR KEY_REQKEY_DEFL_SESSION_KEYRING
Session-specific keyring.
.TP
.BR KEY_REQKEY_DEFL_USER_KEYRING
UID-specific keyring.
.TP
.BR KEY_REQKEY_DEFL_USER_SESSION_KEYRING 5
Session keyring of UID.
.TP
.BR KEY_REQKEY_DEFL_REQUESTOR_KEYRING " (since Linux 2.6.29)"
'\" 8bbf4976b59fc9fc2861e79cab7beb3f6d647640
#define KEY_REQKEY_DEFL_REQUESTOR_KEYRING 7 /* since 2.6.29: requestor keyring */
.in
.fi
Requestor keyring.
.RE
.IP
All other values (including still-unsupported
.BR KEY_REQKEY_DEFL_GROUP_KEYRING )
are invalid.