---
name: "perf_4.19-ftrace"
section: "1"
platform: "linux"
package: "linux-perf-4.19"
version: "4.19.249-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/perf_4.19-ftrace"
---

# perf\_4.19-ftrace(1)

simple wrapper for kernel's ftrace functionality

## NAME

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

## SYNOPSIS

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

[perf-record(1)](/perf-record/1.md), [perf-trace(1)](/perf-trace/1.md)