'\" t
.\"     Title: perf-ftrace
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.10
.\"      Date: 2019-10-02
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF_5.3\-FTRACE" "1" "2019-10-02" "perf" "perf Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
perf\-ftrace \- simple wrapper for kernel\(aqs ftrace functionality
.SH "SYNOPSIS"
.sp
.sp
.nf
\fIperf ftrace\fP <command>
.fi
.br
.SH "DESCRIPTION"
.sp
The \fIperf ftrace\fP command is a simple wrapper of kernel\(cqs ftrace
functionality.  It only supports single thread tracing currently and
just reads trace_pipe in text and then write it to stdout.
.sp
The following options apply to perf ftrace.
.SH "OPTIONS"
.sp
\-t, \-\-tracer=
.RS 4
Tracer to use: function_graph or function.
.RE
.sp
\-v, \-\-verbose=
.RS 4
Verbosity level.
.RE
.sp
\-p, \-\-pid=
.RS 4
Trace on existing process id (comma separated list).
.RE
.sp
\-a, \-\-all\-cpus
.RS 4
Force system\-wide collection.  Scripts run without a <command>
normally use \-a by default, while scripts run with a <command>
normally don\(cqt \- this option allows the latter to be run in
system\-wide mode.
.RE
.sp
\-C, \-\-cpu=
.RS 4
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.
.RE
.sp
\-T, \-\-trace\-funcs=
.RS 4
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
\fIset_ftrace_filter\fP in tracefs.
.RE
.sp
\-N, \-\-notrace\-funcs=
.RS 4
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 \fIset_ftrace_notrace\fP
in tracefs.
.RE
.sp
\-G, \-\-graph\-funcs=
.RS 4
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 \fIset_graph_function\fP in tracefs.
.RE
.sp
\-g, \-\-nograph\-funcs=
.RS 4
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 \fIset_graph_notrace\fP in tracefs.
.RE
.sp
\-D, \-\-graph\-depth=
.RS 4
Set max depth for function graph tracer to follow
.RE
.SH "SEE ALSO"
.sp
perf\-record(1), perf\-trace(1)