12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 |
- perf-ftrace(1)
- =============
- NAME
- ----
- perf-ftrace - simple wrapper for kernel's ftrace functionality
- SYNOPSIS
- --------
- [verse]
- '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
- --------
- linkperf:perf-record[1], linkperf:perf-trace[1]
|