Module Name: src
Committed By: kamil
Date: Tue Nov 1 13:51:13 UTC 2016
Modified Files:
src/lib/libc/sys: ptrace.2
Log Message:
Document PT_SET_EVENT_MASK, PT_GET_EVENT_MASK and PT_GET_PROCESS_STATE
These descriptions are imported from OpenBSD.
Approved by <christos>
Sponsored by <The NetBSD Foundation>
To generate a diff of this commit:
cvs rdiff -u -r1.37 -r1.38 src/lib/libc/sys/ptrace.2
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/sys/ptrace.2
diff -u src/lib/libc/sys/ptrace.2:1.37 src/lib/libc/sys/ptrace.2:1.38
--- src/lib/libc/sys/ptrace.2:1.37 Thu Jul 2 03:50:21 2015
+++ src/lib/libc/sys/ptrace.2 Tue Nov 1 13:51:13 2016
@@ -1,4 +1,4 @@
-.\" $NetBSD: ptrace.2,v 1.37 2015/07/02 03:50:21 christos Exp $
+.\" $NetBSD: ptrace.2,v 1.38 2016/11/01 13:51:13 kamil Exp $
.\"
.\" This file is in the public domain.
.Dd July 1, 2015
@@ -308,6 +308,57 @@ Stops a process before and after executi
.It Dv PT_SYSCALLEMU
Intercept and ignore a system call before it has been executed, for use with
.Dv PT_SYSCALL .
+.It Dv PT_SET_EVENT_MASK
+This request can be used to specify which events in the traced process
+should be reported to the tracing process.
+These events are specified in a
+.Dq Li "struct ptrace_event"
+defined as:
+.Bd -literal -offset indent
+typedef struct ptrace_event {
+ int pe_set_event;
+} ptrace_event_t;
+.Ed
+.Pp
+Where
+.Fa pe_set_event
+is the set of events to be reported.
+This set is formed by OR'ing together the following values:
+.Bl -tag -width 18n
+.It PTRACE_FORK
+Report
+.Xr fork 2 .
+.El
+.Pp
+A pointer to this structure is passed in
+.Fa addr .
+The
+.Fa data
+argument should be set to
+.Li sizeof(struct ptrace_event) .
+.It Dv PT_GET_EVENT_MASK
+This request can be used to determine which events in the traced
+process will be reported.
+The information is read into the
+.Dq Li struct ptrace_event
+pointed to by
+.Fa addr .
+The
+.Fa data
+argument should be set to
+.Li sizeof(struct ptrace_event) .
+.It Dv PT_GET_PROCESS_STATE
+This request reads the state information associated with the event
+that stopped the traced process.
+The information is reported in a
+.Dq Li "struct ptrace_state"
+defined as:
+.Bd -literal -offset indent
+typedef struct ptrace_state {
+ int pe_report_event;
+ pid_t pe_other_pid;
+} ptrace_state_t;
+.Ed
.El
.Pp
Additionally, the following requests exist but are
