This manpage patch relates to the addition of the PERF_RECORD_ITRACE_START
record type in the following commit:
commit ec0d7729bbaed4b9d2d3fada693278e13a3d1368
Author: Alexander Shishkin <[email protected]>
perf: Add ITRACE_START record to indicate that tracing has started
Signed-off-by: Alexander Shishkin <[email protected]>
Signed-off-by: Peter Zijlstra (Intel) <[email protected]>
Cc: Borislav Petkov <[email protected]>
Cc: Frederic Weisbecker <[email protected]>
Cc: H. Peter Anvin <[email protected]>
Cc: Kaixu Xia <[email protected]>
Cc: Linus Torvalds <[email protected]>
Cc: Mike Galbraith <[email protected]>
Cc: Paul Mackerras <[email protected]>
Cc: Robert Richter <[email protected]>
Cc: Stephane Eranian <[email protected]>
Cc: Thomas Gleixner <[email protected]>
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Cc: [email protected]
Link: http://lkml.kernel.org/r/1421237903-181015-15-git-send-email-alexander.shishkin@linux.intel.com
Signed-off-by: Ingo Molnar <[email protected]>
Signed-off-by: Vince Weaver <[email protected]>
diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -2356,6 +2356,29 @@
buffer size.
.RE
.RE
+.TP
+.BR PERF_RECORD_ITRACE_START " (since Linux 4.1)"
+\" ec0d7729bbaed4b9d2d3fada693278e13a3d1368
+This record indicates which process has initiated an instruction
+trace event, allowing tools to properly correlate the instruction
+addresses in the AUX buffer with the proper executable.
+
+.in +4n
+.nf
+struct {
+ struct perf_event_header header;
+ u32 pid;
+ u32 tid;
+};
+.fi
+.RS
+.TP
+.I pid
+process id of the thread starting an instruction trace.
+.TP
+.I tid
+thread id of the thread starting an instruction trace.
+.RE
.RE
.SS Overflow handling
Events can be set to notify when a threshold is crossed,