|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | COLOPHON |
PERF-FTRACE(1) perf Manual PERF-FTRACE(1)
perf-ftrace - simple wrapper for kernel's ftrace functionality
perf ftrace <command>
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.
-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
perf-record(1), perf-trace(1)
This page is part of the perf (Performance analysis tools for Linux
(in Linux source tree)) project. Information about the project can
be found at ⟨https://perf.wiki.kernel.org/index.php/Main_Page⟩. If
you have a bug report for this manual page, send it to
linux-kernel@vger.kernel.org. This page was obtained from the
project's upstream Git repository
⟨http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git⟩ on
2017-07-05. If you discover any rendering problems in this HTML ver‐
sion of the page, or you believe there is a better or more up-to-date
source for the page, or you have corrections or improvements to the
information in this COLOPHON (which is not part of the original man‐
ual page), send a mail to man-pages@man7.org
perf 07/05/2017 PERF-FTRACE(1)