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
                 kmaps            - Print kernel and module maps (perf script
                                    and perf report without browser)

           Write debug output to a specified file.

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),

       perf-annotate(1),perf-archive(1),perf-arm-spe(1), perf-bench(1),
       perf-buildid-cache(1), perf-buildid-list(1), perf-c2c(1),
       perf-config(1), perf-data(1), perf-diff(1), perf-evlist(1),
       perf-ftrace(1), perf-help(1), perf-inject(1), perf-intel-pt(1),
       perf-iostat(1), perf-kallsyms(1), perf-kmem(1), perf-kvm(1),
       perf-lock(1), perf-mem(1), perf-probe(1), perf-sched(1),
       perf-script(1), perf-test(1), perf-trace(1), perf-version(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 2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-13.)  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                           2024-02-08                        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)