ptrace.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 65bf060c4a50f588e9b928dc6e1168901b94c4d5..d3b2ca955721574ce5c6ccfa853a72d84965a0e2 100644 (file)
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -2115,6 +2115,19 @@ or calling
 .BR process_vm_writev (2).
 .RB ( PTRACE_MODE_ATTACH
 was effectively the default before Linux 2.6.27.)
+.\"
+.\" Regarding the above description of the distinction between
+.\" PTRACE_MODE_READ and PTRACE_MODE_ATTACH, Stephen Smalley notes:
+.\"
+.\"     That was the intent when the distinction was introduced, but it doesn't
+.\"     appear to have been properly maintained, e.g. there is now a common
+.\"     helper lock_trace() that is used for
+.\"     /proc/pid/{stack,syscall,personality} but checks PTRACE_MODE_ATTACH, and
+.\"     PTRACE_MODE_ATTACH is also used in timerslack_ns_write/show().  Likely
+.\"     should review and make them consistent.  There was also some debate
+.\"     about proper handling of /proc/pid/fd.  Arguably that one might belong
+.\"     back in the _ATTACH camp.
+.\"
 .PP
 Note that all of the
 .BR PTRACE_MODE_*