1PERF-FTRACE(1)                    perf Manual                   PERF-FTRACE(1)
2
3
4

NAME

6       perf-ftrace - simple wrapper for kernel's ftrace functionality
7

SYNOPSIS

9       perf ftrace <command>
10

DESCRIPTION

12       The perf ftrace command is a simple wrapper of kernel’s ftrace
13       functionality. It only supports single thread tracing currently and
14       just reads trace_pipe in text and then write it to stdout.
15
16       The following options apply to perf ftrace.
17

OPTIONS

19       -t, --tracer=
20           Tracer to use: function_graph or function.
21
22       -v, --verbose=
23           Verbosity level.
24
25       -p, --pid=
26           Trace on existing process id (comma separated list).
27
28       -a, --all-cpus
29           Force system-wide collection. Scripts run without a <command>
30           normally use -a by default, while scripts run with a <command>
31           normally don’t - this option allows the latter to be run in
32           system-wide mode.
33
34       -C, --cpu=
35           Only trace for the list of CPUs provided. Multiple CPUs can be
36           provided as a comma separated list with no space like: 0,1. Ranges
37           of CPUs are specified with -: 0-2. Default is to trace on all
38           online CPUs.
39
40       -T, --trace-funcs=
41           Only trace functions given by the argument. Multiple functions can
42           be given by using this option more than once. The function argument
43           also can be a glob pattern. It will be passed to set_ftrace_filter
44           in tracefs.
45
46       -N, --notrace-funcs=
47           Do not trace functions given by the argument. Like -T option, this
48           can be used more than once to specify multiple functions (or glob
49           patterns). It will be passed to set_ftrace_notrace in tracefs.
50
51       -G, --graph-funcs=
52           Set graph filter on the given function (or a glob pattern). This is
53           useful for the function_graph tracer only and enables tracing for
54           functions executed from the given function. This can be used more
55           than once to specify multiple functions. It will be passed to
56           set_graph_function in tracefs.
57
58       -g, --nograph-funcs=
59           Set graph notrace filter on the given function (or a glob pattern).
60           Like -G option, this is useful for the function_graph tracer only
61           and disables tracing for function executed from the given function.
62           This can be used more than once to specify multiple functions. It
63           will be passed to set_graph_notrace in tracefs.
64
65       -D, --graph-depth=
66           Set max depth for function graph tracer to follow
67

SEE ALSO

69       perf-record(1), perf-trace(1)
70
71
72
73perf                              09/24/2019                    PERF-FTRACE(1)
Impressum