NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | COLOPHON

PERF-FTRACE(1)                   perf Manual                  PERF-FTRACE(1)

NAME         top

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

SYNOPSIS         top

       perf ftrace <command>

DESCRIPTION         top

       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         top

       -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         top

       perf-record(1), perf-trace(1)

COLOPHON         top

       This page is part of the perf (Performance analysis tools for Linux
       (in Linux source tree)) project.  Information about the project can
       be found at ⟨https://perf.wiki.kernel.org/index.php/Main_Page⟩.  If
       you have a bug report for this manual page, send it to
       linux-kernel@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository 
       ⟨http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git⟩ on
       2017-09-15.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to man-pages@man7.org

perf                             09/14/2017                   PERF-FTRACE(1)