xref: /linux/tools/perf/Documentation/perf-ftrace.txt (revision fcc8487d477a3452a1d0ccbdd4c5e0e1e3cb8bed)
1perf-ftrace(1)
2=============
3
4NAME
5----
6perf-ftrace - simple wrapper for kernel's ftrace functionality
7
8
9SYNOPSIS
10--------
11[verse]
12'perf ftrace' <command>
13
14DESCRIPTION
15-----------
16The 'perf ftrace' command is a simple wrapper of kernel's ftrace
17functionality.  It only supports single thread tracing currently and
18just reads trace_pipe in text and then write it to stdout.
19
20The following options apply to perf ftrace.
21
22OPTIONS
23-------
24
25-t::
26--tracer=::
27	Tracer to use: function_graph or function.
28
29-v::
30--verbose=::
31        Verbosity level.
32
33-p::
34--pid=::
35	Trace on existing process id (comma separated list).
36
37-a::
38--all-cpus::
39	Force system-wide collection.  Scripts run without a <command>
40	normally use -a by default, while scripts run with a <command>
41	normally don't - this option allows the latter to be run in
42	system-wide mode.
43
44-C::
45--cpu=::
46	Only trace for the list of CPUs provided.  Multiple CPUs can
47	be provided as a comma separated list with no space like: 0,1.
48	Ranges of CPUs are specified with -: 0-2.
49	Default is to trace on all online CPUs.
50
51
52SEE ALSO
53--------
54linkperf:perf-record[1], linkperf:perf-trace[1]
55