table of contents
PERF-FTRACE(1) | perf Manual | PERF-FTRACE(1) |
NAME¶
perf-ftrace - simple wrapper for kernel's ftrace functionality
SYNOPSIS¶
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¶
06/04/2024 | perf |