---
name: "perf_5.10"
section: "1"
platform: "linux"
package: "linux-perf-5.10"
version: "5.10.223-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/perf_5.10"
---

# perf\_5.10(1)

Performance analysis tools for Linux

## NAME

perf - Performance analysis tools for Linux

## SYNOPSIS

```
perf [--version] [--help] [OPTIONS] COMMAND [ARGS]
```

## OPTIONS

- \-h, --help

  Run perf help command.

- \-v, --version

  Display perf version.

- \-vv

  Print the compiled-in status of libraries.

- \--exec-path

  Display or set exec path.

- \--html-path

  Display html documentation path.

- \-p, --paginate

  Set up pager.

- \--no-pager

  Do not set pager.

- \--buildid-dir

  Setup buildid cache directory. It has higher priority than buildid.dir config file option.

- \--list-cmds

  List the most commonly used perf commands.

- \--list-opts

  List available perf options.

- \--debugfs-dir

  Set debugfs directory or set environment variable PERF\_DEBUGFS\_DIR.

- \--debug

  Setup debug variable (see list below) in value range (0, 10). Use like: --debug verbose   # sets verbose = 1 --debug verbose=2 # sets verbose = 2

  ```
  List of debug variables allowed to set:
    verbose          - general debug messages
    ordered-events   - ordered events object debug messages
    data-convert     - data convert command debug messages
    stderr           - write debug output (option -v) to stderr
                       in browser mode
    perf-event-open  - Print perf_event_open() arguments and
                       return value
  ```

## DESCRIPTION

Performance counters for Linux are a new kernel-based subsystem that provide a framework for all things performance analysis. It covers hardware level (CPU/PMU, Performance Monitoring Unit) features and software features (software counters, tracepoints) as well.

## SEE ALSO

[perf-stat(1)](/perf-stat/1.md), [perf-top(1)](/perf-top/1.md), [perf-record(1)](/perf-record/1.md), [perf-report(1)](/perf-report/1.md), [perf-list(1)](/perf-list/1.md)