aboutsummaryrefslogtreecommitdiff
path: root/lib/libc/sys/ptrace.2
diff options
context:
space:
mode:
authorJohn Baldwin <jhb@FreeBSD.org>2016-07-28 20:51:29 +0000
committerJohn Baldwin <jhb@FreeBSD.org>2016-07-28 20:51:29 +0000
commit57fe078650a3d01f2c04555b274dae4ac6eff0d1 (patch)
tree0d845bcc365f8364f56f58750750acddee74ef05 /lib/libc/sys/ptrace.2
parent0e3b89198859199bcdd54838848e2e6c63d69517 (diff)
downloadsrc-57fe078650a3d01f2c04555b274dae4ac6eff0d1.tar.gz
src-57fe078650a3d01f2c04555b274dae4ac6eff0d1.zip
Note that not all optional ptrace events use SIGTRAP.
New child processes attached due to PTRACE_FORK use SIGSTOP instead of SIGTRAP. All other ptrace events use SIGTRAP.
Notes
Notes: svn path=/head/; revision=303461
Diffstat (limited to 'lib/libc/sys/ptrace.2')
-rw-r--r--lib/libc/sys/ptrace.214
1 files changed, 12 insertions, 2 deletions
diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2
index fc5382d1193c..74798d27cfff 100644
--- a/lib/libc/sys/ptrace.2
+++ b/lib/libc/sys/ptrace.2
@@ -2,7 +2,7 @@
.\" $NetBSD: ptrace.2,v 1.2 1995/02/27 12:35:37 cgd Exp $
.\"
.\" This file is in the public domain.
-.Dd July 18, 2016
+.Dd July 28, 2016
.Dt PTRACE 2
.Os
.Sh NAME
@@ -74,11 +74,15 @@ A traced process may report additional signal stops corresponding to
events in the traced process.
These additional signal stops are reported as
.Dv SIGTRAP
+or
+.Dv SIGSTOP
signals.
The tracing process can use the
.Dv PT_LWPINFO
request to determine which events are associated with a
.Dv SIGTRAP
+or
+.Dv SIGSTOP
signal.
Note that multiple events may be associated with a single signal.
For example, events indicated by the
@@ -88,10 +92,16 @@ and
.Dv PL_FLAG_EXEC
flags are also reported as a system call exit event
.Pq Dv PL_FLAG_SCX .
+The signal stop for a new child process enabled via
+.Dv PTRACE_FORK
+will report a
+.Dv SIGSTOP
+signal.
+All other additional signal stops use
+.Dv SIGTRAP .
.Pp
Each traced process has a tracing event mask.
An event in the traced process only reports a
-.Dv SIGTRAP
signal stop if the corresponding flag is set in the tracing event mask.
The current set of tracing event flags include:
.Bl -tag -width ".Dv PTRACE_SYSCALL"