perf/Documentation/perf-ftrace.txt

1 perf-ftrace(1)
5 ----
6 perf-ftrace - simple wrapper for kernel's ftrace functionality
10 --------
15 -----------
23 -------
25 -t::
26 --tracer=::
27 	Tracer to use when neither -G nor -F option is not
30 -v::
31 --verbose=::
34 -F::
35 --funcs::
36         List available functions to trace. It accepts a pattern to
37         only list interested functions.
39 -p::
40 --pid=::
43 --tid=::
46 -D::
47 --delay::
50 -a::
51 --all-cpus::
52 	Force system-wide collection.  Scripts run without a <command>
53 	normally use -a by default, while scripts run with a <command>
54 	normally don't - this option allows the latter to be run in
55 	system-wide mode.
57 -C::
58 --cpu=::
61 	Ranges of CPUs are specified with -: 0-2.
64 -m::
65 --buffer-size::
66 	Set the size of per-cpu tracing buffer, <size> is expected to
67 	be a number with appended unit character - B/K/M/G.
69 --inherit::
72 -T::
73 --trace-funcs=::
75 	function (or a glob pattern). Multiple functions can be given
80 -N::
81 --notrace-funcs=::
82 	Select function tracer and do not trace functions given by the
83 	argument.  Like -T option, this can be used more than once to
84 	specify multiple functions (or glob patterns).  It will be
87 --func-opts::
89 	  call-graph - Display kernel stack trace for function tracer.
90 	  irq-info   - Display irq context info for function tracer.
92 -G::
93 --graph-funcs=::
96 	functions executed from the given function. This can be used more
97 	than once to specify multiple functions. It will be passed to
100 -g::
101 --nograph-funcs=::
103 	given function (or a glob pattern). Like -G option, this is useful
106 	specify multiple functions. It will be passed to 'set_graph_notrace'
109 --graph-opts::
111 	  nosleep-time - Measure on-CPU time only for function_graph tracer.
112 	  noirqs       - Ignore functions that happen inside interrupt.
113 	  verbose      - Show process names, PIDs, timestamps, etc.
114 	  thresh=<n>   - Setup trace duration threshold in microseconds.
115 	  depth=<n>    - Set max depth for function graph tracer to follow.
118 --------
119 linkperf:perf-record[1], linkperf:perf-trace[1]