From 6932aac3d28ff686bbc50916a4f7b0274c6bf3a1 Mon Sep 17 00:00:00 2001 From: Vince Weaver Date: Thu, 23 Jul 2015 13:15:18 -0400 Subject: [PATCH] perf_event_open.2: 4.1 add PERF_RECORD_ITRACE_START This manpage patch relates to the addition of the PERF_RECORD_ITRACE_START record type in the following commit: commit ec0d7729bbaed4b9d2d3fada693278e13a3d1368 Author: Alexander Shishkin perf: Add ITRACE_START record to indicate that tracing has started Signed-off-by: Alexander Shishkin Signed-off-by: Peter Zijlstra (Intel) Cc: Borislav Petkov Cc: Frederic Weisbecker Cc: H. Peter Anvin Cc: Kaixu Xia Cc: Linus Torvalds Cc: Mike Galbraith Cc: Paul Mackerras Cc: Robert Richter Cc: Stephane Eranian Cc: Thomas Gleixner Cc: acme@infradead.org Cc: adrian.hunter@intel.com Cc: kan.liang@intel.com Cc: markus.t.metzger@intel.com Cc: mathieu.poirier@linaro.org Link: http://lkml.kernel.org/r/1421237903-181015-15-git-send-email-alexander.shishkin@linux.intel.com Signed-off-by: Ingo Molnar Signed-off-by: Vince Weaver Signed-off-by: Michael Kerrisk --- man2/perf_event_open.2 | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index dae9b23fc..fe7dde169 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,