[patch 01/11] perf_event_open.2: 4.1 PERF_SAMPLE_BRANCH_CALL_STACK

[patch 01/11] perf_event_open.2: 4.1 PERF_SAMPLE_BRANCH_CALL_STACK

[Vince Weaver]

This manpage patch relates to the addition of the
PERF_SAMPLE_BRANCH_CALL_STACK functionaliry added in the
following commit:

	commit 2c44b1936bb3b135a3fac8b3493394d42e51cf70
	Author: Peter Zijlstra <peterz@infradead.org>

	perf/x86/intel: Expose LBR callstack to user space tooling
    
	With LBR call stack feature enable, there are three callchain options.
	Enable the 3rd callchain option (LBR callstack) to user space tooling.
    
	Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org>
	Cc: Jiri Olsa <jolsa@redhat.com>
	Cc: Arnaldo Carvalho de Melo <acme@kernel.org>
	Cc: Andy Lutomirski <luto@amacapital.net>
	Cc: Kan Liang <kan.liang@intel.com>
	Cc: Linus Torvalds <torvalds@linux-foundation.org>
	Cc: Paul Mackerras <paulus@samba.org>
	Cc: Vince Weaver <vincent.weaver@maine.edu>
	Cc: linux-api@vger.kernel.org
	Link: http://lkml.kernel.org/r/20141105093759.GQ10501@worktop.programming.kicks-ass.net
	Signed-off-by: Ingo Molnar <mingo@kernel.org>

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index 856ec64..71bfb17 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -1240,6 +1240,11 @@ Branch in transactional memory transaction.
 .BR PERF_SAMPLE_BRANCH_NO_TX " (since Linux 3.11)"
 .\" commit 135c5612c460f89657c4698fe2ea753f6f667963
 Branch not in transactional memory transaction.
+.BR PERF_SAMPLE_BRANCH_CALL_STACK " (since Linux 4.1)"
+.\" commit 2c44b1936bb3b135a3fac8b3493394d42e51cf70
+Branch is part of a hardware generated call stack.
+This requires hardware support, currently only found
+on Intel x86 Haswell or newer.
 .RE
 
 .TP

Re: [patch 01/11] perf_event_open.2: 4.1 PERF_SAMPLE_BRANCH_CALL_STACK

[Michael Kerrisk (man-pages)]

On 07/23/2015 07:08 PM, Vince Weaver wrote:
> 
> This manpage patch relates to the addition of the 
> PERF_SAMPLE_BRANCH_CALL_STACK functionaliry added in the following
> commit:
> 
> commit 2c44b1936bb3b135a3fac8b3493394d42e51cf70 Author: Peter
> Zijlstra <peterz@infradead.org>
> 
> perf/x86/intel: Expose LBR callstack to user space tooling
> 
> With LBR call stack feature enable, there are three callchain
> options. Enable the 3rd callchain option (LBR callstack) to user
> space tooling.

Thanks, Vince. Applied.

Cheers,

Michael


> Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org> Cc: Jiri
> Olsa <jolsa@redhat.com> Cc: Arnaldo Carvalho de Melo
> <acme@kernel.org> Cc: Andy Lutomirski <luto@amacapital.net> Cc: Kan
> Liang <kan.liang@intel.com> Cc: Linus Torvalds
> <torvalds@linux-foundation.org> Cc: Paul Mackerras
> <paulus@samba.org> Cc: Vince Weaver <vincent.weaver@maine.edu> Cc:
> linux-api@vger.kernel.org Link:
> http://lkml.kernel.org/r/20141105093759.GQ10501@worktop.programming.kicks-ass.net
>
> Signed-off-by: Ingo Molnar <mingo@kernel.org>
> Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
> 
> diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index
> 856ec64..71bfb17 100644 --- a/man2/perf_event_open.2 +++
> b/man2/perf_event_open.2 @@ -1240,6 +1240,11 @@ Branch in
> transactional memory transaction. .BR PERF_SAMPLE_BRANCH_NO_TX "
> (since Linux 3.11)" .\" commit
> 135c5612c460f89657c4698fe2ea753f6f667963 Branch not in transactional
> memory transaction. +.BR PERF_SAMPLE_BRANCH_CALL_STACK " (since Linux
> 4.1)" +.\" commit 2c44b1936bb3b135a3fac8b3493394d42e51cf70 +Branch is
> part of a hardware generated call stack. +This requires hardware
> support, currently only found +on Intel x86 Haswell or newer. .RE
> 
> .TP -- To unsubscribe from this list: send the line "unsubscribe
> linux-man" in the body of a message to majordomo@vger.kernel.org More
> majordomo info at  http://vger.kernel.org/majordomo-info.html
> 


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