perf

Examples (TL;DR)

• Display basic performance counter stats for a command: perf stat gcc hello.c
• Display system-wide real time performance counter profile: sudo perf top
• Run a command and record its profile into "perf.data": sudo perf record command
• Read "perf.data" (created by perf record) and display the profile: sudo perf report

tldr.sh

Synopsis

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

Options

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

--buildid-dir

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

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-top(1), perf-record(1), perf-report(1), perf-list(1)

Referenced By

kvm_stat(1), perf-bench(1), perf-buildid-cache(1), perf-config(1), perf-data(1), perf_event_open(2), perf-help(1), perf-lock(1), perf-probe(1), stress-ng(1).