perf(1) — Linux manual page


PERF(1)                          perf Manual                         PERF(1)

NAME         top

       perf - Performance analysis tools for Linux

SYNOPSIS         top

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

OPTIONS         top

       -h, --help
           Run perf help command.

       -v, --version
           Display perf version.

           Print the compiled-in status of libraries.

           Display or set exec path.

           Display html documentation path.

       -p, --paginate
           Set up pager.

           Do not set pager.

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

           List the most commonly used perf commands.

           List available perf options.

           Set debugfs directory or set environment variable

           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         top

       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         top

       perf-stat(1), perf-top(1), perf-record(1), perf-report(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 ⟨⟩.  If
       you have a bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git repository
       ⟨⟩ on
       2020-11-01.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-11-01.)  If you discover any
       rendering problems in this HTML version 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 manual page), send a mail to

perf                             2020-09-17                          PERF(1)

Pages that refer to this page: perf-bench(1)perf-config(1)perf-data(1)perf-help(1)perf-lock(1)perf_event_open(2)