From d1d5839dbb3bcb512af24ba21afb5b1df7d2b2e9 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Mon, 17 Oct 2016 16:17:48 +0200 Subject: [PATCH] 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 --- man2/keyctl.2 | 41 +++++++++++++++++++++++++++-------------- 1 file changed, 27 insertions(+), 14 deletions(-) diff --git a/man2/keyctl.2 b/man2/keyctl.2 index cca22d8a6..73e20bc82 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -397,21 +397,34 @@ argument (converted to .I int type) should contain one of the following values, defined in .IR : - -.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.