PERF(1)

✨ NAME ✨

okay so bestie, this is the PERF(1) page — the manual for perf, which is literally Performance analysis tools for Linux. main character energy fr fr 👑💅

---

🌸 SYNOPSIS 🌸

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

---

🎀 OPTIONS 🎀

• -h, --help — runs the perf help command. help bestie out 💖
• -v, --version — displays the perf version. periodt.
• -vv — prints the compiled-in status of libraries. yes, two v's, she's extra 💅
• --exec-path — displays or sets the exec path.
• --html-path — displays the html documentation path.
• -p, --paginate — sets up the pager. cozy scrolling vibes ✨
• --no-pager — does not set the pager. no pager, no problem.
• --buildid-dir — sets up the buildid cache directory. it has higher priority than the buildid.dir config file option. noted, bestie 🫶
• --list-cmds — lists the most commonly used perf commands.
• --list-opts — lists available perf options.
• --debugfs-dir — sets the debugfs directory, or sets the environment variable PERF_DEBUGFS_DIR.
• --debug — sets up a debug variable (see the list below) in value range (0, 10). use it like this:

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

• --debug-file — writes debug output to a specified file.

---

🦋 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. literally the whole performance-analysis buffet, no cap 💖✨

---

🌈 SEE ALSO 🌈

• perf-stat(1)
• perf-top(1)
• perf-record(1)
• perf-report(1)
• perf-list(1)
• perf-amd-ibs(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)

---

okay that's the whole page, bestie 🫶 this one comes from the perf manual, dated 10/31/2026, and it's page PERF(1) — iconic, honestly. 💅🎀