Re: [patch 09/11] perf_event_open.2: 4.1 add PERF_RECORD_ITRACE_START

From: Michael Kerrisk (man-pages)
Date: Wed Oct 14 2015 - 02:45:48 EST


On 07/23/2015 07:15 PM, Vince Weaver wrote:
>
>
> This manpage patch relates to the addition of the PERF_RECORD_ITRACE_START
> record type in the following commit:

Thanks, Vince. Applied.

Cheers,

Michael


> 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,
>


--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/