From 7289930f200ea673c9ecb45de4a6e79d3a0d4383 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 9 Jun 2020 13:33:23 +0200 Subject: [PATCH] prctl.2: Fixes to Dave Martin's patch Signed-off-by: Michael Kerrisk --- man2/prctl.2 | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/man2/prctl.2 b/man2/prctl.2 index 14e75d540..c9d66811c 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -984,7 +984,7 @@ generic authentication \(lqA\(rq key. .IP As a special case, if .I arg2 -is zero then all the keys are reset. +is zero, then all the keys are reset. Since new keys could be added in future, this is the recommended way to completely wipe the existing keys when establishing a clean execution context. @@ -997,7 +997,7 @@ since resets all the pointer authentication keys. .IP The remaining arguments -.IR arg3 ", " arg4 " and " arg5 +.IR arg3 ", " arg4 ", and " arg5 must all be zero. .IP If the arguments are invalid, @@ -1005,13 +1005,16 @@ and in particular if .I arg2 contains set bits that are unrecognized or that correspond to a key not available on this platform, -the call fails with error +then the call fails with error .BR EINVAL . .IP .B Warning: Because the compiler or run-time environment may be using some or all of the keys, a successful +may crash the calling process. +The conditions for using it safely are complex and system-dependent. +Don't use it unless you know what you are doing. .IP For more information, see the kernel source file .I Documentation/arm64/pointer\-authentication.rst @@ -1020,9 +1023,6 @@ For more information, see the kernel source file .I Documentation/arm64/pointer\-authentication.txt before Linux 5.3). .B PR_PAC_RESET_KEYS -may crash the calling process. -The conditions for using it safely are complex and system-dependent. -Don't use it unless you know what you are doing. .\" prctl PR_SET_PDEATHSIG .TP .BR PR_SET_PDEATHSIG " (since Linux 2.1.57)"