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)"