PERF(1)                          perf Manual                         PERF(1)

NAME         top

       perf - Performance analysis tools for Linux

SYNOPSIS         top

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

OPTIONS         top

           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

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

       -v, --version
           Display perf version.

       -h, --help
           Run perf help command.

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
       2017-03-13.  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

perf                             02/18/2017                          PERF(1)