1096c35aa8
The -D/--graph-depth option is to set max graph depth. The following
example traces max 2-depth of page fault handler.
$ sudo perf ftrace -G __do_page_fault -D 2 -- hello
...
0) | __do_page_fault() {
0) 0.063 us | down_read_trylock();
0) 0.251 us | find_vma();
0) 5.374 us | handle_mm_fault();
0) 0.054 us | up_read();
0) 7.463 us | }
...
Signed-off-by: Namhyung Kim <namhyung@kernel.org>
Tested-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Masami Hiramatsu <mhiramat@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Steven Rostedt <rostedt@goodmis.org>
Cc: kernel-team@lge.com
Link: http://lkml.kernel.org/r/20170618142302.25390-4-namhyung@kernel.org
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
88 lines
2.3 KiB
Plaintext
88 lines
2.3 KiB
Plaintext
perf-ftrace(1)
|
|
=============
|
|
|
|
NAME
|
|
----
|
|
perf-ftrace - simple wrapper for kernel's ftrace functionality
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf ftrace' <command>
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
The 'perf ftrace' command is a simple wrapper of kernel's ftrace
|
|
functionality. It only supports single thread tracing currently and
|
|
just reads trace_pipe in text and then write it to stdout.
|
|
|
|
The following options apply to perf ftrace.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
-t::
|
|
--tracer=::
|
|
Tracer to use: function_graph or function.
|
|
|
|
-v::
|
|
--verbose=::
|
|
Verbosity level.
|
|
|
|
-p::
|
|
--pid=::
|
|
Trace on existing process id (comma separated list).
|
|
|
|
-a::
|
|
--all-cpus::
|
|
Force system-wide collection. Scripts run without a <command>
|
|
normally use -a by default, while scripts run with a <command>
|
|
normally don't - this option allows the latter to be run in
|
|
system-wide mode.
|
|
|
|
-C::
|
|
--cpu=::
|
|
Only trace for the list of CPUs provided. Multiple CPUs can
|
|
be provided as a comma separated list with no space like: 0,1.
|
|
Ranges of CPUs are specified with -: 0-2.
|
|
Default is to trace on all online CPUs.
|
|
|
|
-T::
|
|
--trace-funcs=::
|
|
Only trace functions given by the argument. Multiple functions
|
|
can be given by using this option more than once. The function
|
|
argument also can be a glob pattern. It will be passed to
|
|
'set_ftrace_filter' in tracefs.
|
|
|
|
-N::
|
|
--notrace-funcs=::
|
|
Do not trace functions given by the argument. Like -T option,
|
|
this can be used more than once to specify multiple functions
|
|
(or glob patterns). It will be passed to 'set_ftrace_notrace'
|
|
in tracefs.
|
|
|
|
-G::
|
|
--graph-funcs=::
|
|
Set graph filter on the given function (or a glob pattern).
|
|
This is useful for the function_graph tracer only and enables
|
|
tracing for functions executed from the given function.
|
|
This can be used more than once to specify multiple functions.
|
|
It will be passed to 'set_graph_function' in tracefs.
|
|
|
|
-g::
|
|
--nograph-funcs=::
|
|
Set graph notrace filter on the given function (or a glob pattern).
|
|
Like -G option, this is useful for the function_graph tracer only
|
|
and disables tracing for function executed from the given function.
|
|
This can be used more than once to specify multiple functions.
|
|
It will be passed to 'set_graph_notrace' in tracefs.
|
|
|
|
-D::
|
|
--graph-depth=::
|
|
Set max depth for function graph tracer to follow
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-record[1], linkperf:perf-trace[1]
|