2016-10-21 20:55:26

by Vince Weaver

[permalink] [raw]
Subject: [patch] perf_event_open.2: add PERF_SAMPLE_BRANCH_CALL branch sample type


Linux 4.4 (c229bf9dc179d2023e185c0f705bdf68484c1e73) added
the PERF_SAMPLE_BRANCH_CALL branch sample type, which confusingly
is a direct-call only subset of what PERF_SAMPLE_BRANCH_ANY_CALL
provides.

Signed-off-by: Vince Weaver <[email protected]>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index fade28c..8d985b3 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -1256,14 +1256,18 @@ following bits must be set.
Any branch type.
.TP
.B PERF_SAMPLE_BRANCH_ANY_CALL
-Any call branch.
-.TP
-.B PERF_SAMPLE_BRANCH_ANY_RETURN
-Any return branch.
+Any call branch (includes direct calls, indirect calls, and far jumps).
.TP
.B PERF_SAMPLE_BRANCH_IND_CALL
Indirect calls.
.TP
+.BR PERF_SAMPLE_BRANCH_CALL " (since Linux 4.4)"
+.\" commit c229bf9dc179d2023e185c0f705bdf68484c1e73
+Direct calls.
+.TP
+.B PERF_SAMPLE_BRANCH_ANY_RETURN
+Any return branch.
+.TP
.BR PERF_SAMPLE_BRANCH_IND_JUMP " (since Linux 4.2)"
.\" commit c9fdfa14c3792c0160849c484e83aa57afd80ccc
Indirect jumps.


Subject: Re: [patch] perf_event_open.2: add PERF_SAMPLE_BRANCH_CALL branch sample type

Hi Vince,

On 10/21/2016 10:55 PM, Vince Weaver wrote:
>
> Linux 4.4 (c229bf9dc179d2023e185c0f705bdf68484c1e73) added
> the PERF_SAMPLE_BRANCH_CALL branch sample type, which confusingly
> is a direct-call only subset of what PERF_SAMPLE_BRANCH_ANY_CALL
> provides.

Thanks. Applied.

Cheers,

Michael


> Signed-off-by: Vince Weaver <[email protected]>
>
> diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
> index fade28c..8d985b3 100644
> --- a/man2/perf_event_open.2
> +++ b/man2/perf_event_open.2
> @@ -1256,14 +1256,18 @@ following bits must be set.
> Any branch type.
> .TP
> .B PERF_SAMPLE_BRANCH_ANY_CALL
> -Any call branch.
> -.TP
> -.B PERF_SAMPLE_BRANCH_ANY_RETURN
> -Any return branch.
> +Any call branch (includes direct calls, indirect calls, and far jumps).
> .TP
> .B PERF_SAMPLE_BRANCH_IND_CALL
> Indirect calls.
> .TP
> +.BR PERF_SAMPLE_BRANCH_CALL " (since Linux 4.4)"
> +.\" commit c229bf9dc179d2023e185c0f705bdf68484c1e73
> +Direct calls.
> +.TP
> +.B PERF_SAMPLE_BRANCH_ANY_RETURN
> +Any return branch.
> +.TP
> .BR PERF_SAMPLE_BRANCH_IND_JUMP " (since Linux 4.2)"
> .\" commit c9fdfa14c3792c0160849c484e83aa57afd80ccc
> Indirect jumps.
>


--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/