linux-man.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] ptrace.2: if SEIZE was used, initial auto-attach stop is EVENT_STOP
@ 2013-07-02 10:51 Denys Vlasenko
       [not found] ` <1372762277-31981-1-git-send-email-dvlasenk-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
  0 siblings, 1 reply; 2+ messages in thread
From: Denys Vlasenko @ 2013-07-02 10:51 UTC (permalink / raw)
  To: Michael Kerrisk
  Cc: Denys Vlasenko, linux-man-u79uwXL29TY76Z2rM5mHXA, Oleg Nesterov,
	Jan Kratochvil, Dmitry V. Levin

For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.

Mention the same thing again in the description of PTRACE_EVENT_STOP.

Signed-off-by: Denys Vlasenko <dvlasenk-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
CC: linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
CC: Oleg Nesterov <oleg-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
CC: Jan Kratochvil <jan.kratochvil-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
CC: Dmitry V. Levin <ldv-u2l5PoMzF/Vg9hUCZPvPmw@public.gmane.org>
---
 man2/ptrace.2 | 32 ++++++++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 79d14cc..55c4fe2 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -340,7 +340,12 @@ Stop the tracee at the next
 .BR clone (2)
 and automatically start tracing the newly cloned process,
 which will start with a
-.BR SIGSTOP .
+.BR SIGSTOP ,
+or
+.B PTRACE_EVENT_STOP
+if
+.B PTRACE_SEIZE
+was used.
 A
 .BR waitpid (2)
 by the tracer will return a
@@ -421,7 +426,12 @@ Stop the tracee at the next
 .BR fork (2)
 and automatically start tracing the newly forked process,
 which will start with a
-.BR SIGSTOP .
+.BR SIGSTOP ,
+or
+.B PTRACE_EVENT_STOP
+if
+.B PTRACE_SEIZE
+was used.
 A
 .BR waitpid (2)
 by the tracer will return a
@@ -449,7 +459,12 @@ Stop the tracee at the next
 .BR vfork (2)
 and automatically start tracing the newly vforked process,
 which will start with a
-.BR SIGSTOP .
+.BR SIGSTOP ,
+or
+.B PTRACE_EVENT_STOP
+if
+.B PTRACE_SEIZE
+was used.
 A
 .BR waitpid (2)
 by the tracer will return a
@@ -1208,7 +1223,16 @@ to finish exiting.
 .B PTRACE_EVENT_STOP
 Stop induced by
 .B PTRACE_INTERRUPT
-command, or group-stop (only if attached using PTRACE_SEIZE).
+command, group-stop, or initial ptrace-stop when a new child is attached
+(only if attached using
+.BR PTRACE_SEIZE ).
+Note that unlike other
+.B PTRACE_EVENT
+stops, this stop has
+.I WSTOPSIG(status)
+other than
+.B SIGTRAP
+if it reports a group-stop.
 .LP
 .B PTRACE_GETSIGINFO
 on
-- 
1.8.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

^ permalink raw reply related	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2013-07-10 18:50 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-07-02 10:51 [PATCH] ptrace.2: if SEIZE was used, initial auto-attach stop is EVENT_STOP Denys Vlasenko
     [not found] ` <1372762277-31981-1-git-send-email-dvlasenk-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
2013-07-10 18:50   ` Michael Kerrisk

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).