This manpage patch relates to the addition of the PERF_RECORD_ITRACE_START record type in the following commit: commit ec0d7729bbaed4b9d2d3fada693278e13a3d1368 Author: Alexander Shishkin <alexander.shishkin@xxxxxxxxxxxxxxx> perf: Add ITRACE_START record to indicate that tracing has started Signed-off-by: Alexander Shishkin <alexander.shishkin@xxxxxxxxxxxxxxx> Signed-off-by: Peter Zijlstra (Intel) <peterz@xxxxxxxxxxxxx> Cc: Borislav Petkov <bp@xxxxxxxxx> Cc: Frederic Weisbecker <fweisbec@xxxxxxxxx> Cc: H. Peter Anvin <hpa@xxxxxxxxx> Cc: Kaixu Xia <kaixu.xia@xxxxxxxxxx> Cc: Linus Torvalds <torvalds@xxxxxxxxxxxxxxxxxxxx> Cc: Mike Galbraith <efault@xxxxxx> Cc: Paul Mackerras <paulus@xxxxxxxxx> Cc: Robert Richter <rric@xxxxxxxxxx> Cc: Stephane Eranian <eranian@xxxxxxxxxx> Cc: Thomas Gleixner <tglx@xxxxxxxxxxxxx> Cc: acme@xxxxxxxxxxxxx Cc: adrian.hunter@xxxxxxxxx Cc: kan.liang@xxxxxxxxx Cc: markus.t.metzger@xxxxxxxxx Cc: mathieu.poirier@xxxxxxxxxx Link: http://lkml.kernel.org/r/1421237903-181015-15-git-send-email-alexander.shishkin@xxxxxxxxxxxxxxx Signed-off-by: Ingo Molnar <mingo@xxxxxxxxxx> Signed-off-by: Vince Weaver <vincent.weaver@xxxxxxxxx> diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index 19c5c23..8ef9ec6 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -2505,6 +2505,29 @@ buffer size. if set then the data returned has overwritten previous data. .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, -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
