linux/tools/perf/Documentation
Ian Rogers 53b00ff358 perf record: Make --buildid-mmap the default
Support for build IDs in mmap2 perf events has been present since
Linux v5.12:
https://lore.kernel.org/lkml/20210219194619.1780437-1-acme@kernel.org/
Build ID mmap events don't avoid the need to inject build IDs for DSO
touched by samples as the build ID cache is populated by perf
record. They can avoid some cases of symbol mis-resolution caused by
the file system changing from when a sample occurred and when the DSO
is sought.

Unlike the --buildid-mmap option, this chnage doesn't disable the
build ID cache but it does disable the processing of samples looking
for DSOs to inject build IDs for. To disable the build ID cache the -B
(--no-buildid) option should be used.

Making this option the default was raised on the list in:
https://lore.kernel.org/linux-perf-users/CAP-5=fXP7jN_QrGUcd55_QH5J-Y-FCaJ6=NaHVtyx0oyNh8_-Q@mail.gmail.com/

Signed-off-by: Ian Rogers <irogers@google.com>
Link: https://lore.kernel.org/r/20250724163302.596743-9-irogers@google.com
Signed-off-by: Namhyung Kim <namhyung@kernel.org>
2025-07-25 10:37:56 -07:00
..
android.txt
arm-coresight.txt
asciidoc.conf
asciidoctor-extensions.rb
build-docdep.perl
build-xed.txt
Build.txt
callchain-overhead-calculation.txt perf report: Add latency and parallelism profiling documentation 2025-02-18 14:04:32 -08:00
cat-texi.perl
cpu-and-latency-overheads.txt perf report: Add latency and parallelism profiling documentation 2025-02-18 14:04:32 -08:00
db-export.txt
examples.txt
guest-files.txt
guestmount.txt
intel-bts.txt
intel-hybrid.txt perf tools: Fix up some comments and code to properly use the event_source bus 2025-02-19 13:23:43 -08:00
intel-pt.txt
itrace.txt
jit-interface.txt
jitdump-specification.txt
Makefile
manpage-1.72.xsl
manpage-base.xsl
manpage-bold-literal.xsl
manpage-normal.xsl
manpage-suppress-sp.xsl
perf-amd-ibs.txt perf mem: Document new output fields (op, cache, mem, dtlb, snoop) 2025-06-16 14:05:10 -03:00
perf-annotate.txt perf annotate: Add --code-with-type option. 2025-03-13 00:19:51 -07:00
perf-archive.txt
perf-arm-spe.txt
perf-bench.txt
perf-buildid-cache.txt
perf-buildid-list.txt
perf-c2c.txt perf mem/c2c amd: Add ldlat support 2025-04-29 22:30:46 -03:00
perf-check.txt tools: Remove libcrypto dependency 2025-06-26 10:51:41 -07:00
perf-config.txt perf intel-pt: Do not default to recording all switch events 2025-05-12 14:18:16 -03:00
perf-daemon.txt
perf-data.txt
perf-diff.txt
perf-dlfilter.txt
perf-evlist.txt
perf-ftrace.txt perf: ftrace: add graph tracer options args/retval/retval-hex/retaddr 2025-07-22 17:47:22 -07:00
perf-help.txt
perf-inject.txt
perf-intel-pt.txt
perf-iostat.txt
perf-kallsyms.txt
perf-kmem.txt
perf-kvm.txt
perf-kwork.txt
perf-list.txt perf parse-events: Allow the cpu term to be a PMU or CPU range 2025-07-24 13:41:35 -07:00
perf-lock.txt perf lock contention: Reject more than 10ms delays for safety 2025-05-31 08:45:24 -03:00
perf-mem.txt perf mem: Document new output fields (op, cache, mem, dtlb, snoop) 2025-06-16 14:05:10 -03:00
perf-probe.txt
perf-record.txt perf record: Make --buildid-mmap the default 2025-07-25 10:37:56 -07:00
perf-report.txt perf report: Add 'tgid' sort key 2025-05-13 17:51:32 -03:00
perf-sched.txt
perf-script-perl.txt
perf-script-python.txt
perf-script.txt perf script: Update brstack syntax documentation 2025-03-14 10:41:08 -07:00
perf-stat.txt perf stat: Fix uncore aggregation number 2025-06-27 16:14:10 -07:00
perf-test.txt perf test: Improve verbose documentation 2025-01-16 11:01:03 -08:00
perf-timechart.txt
perf-top.txt
perf-trace.txt perf trace: Remove --map-dump documentation 2025-06-09 11:18:19 -07:00
perf-version.txt
perf.data-directory-format.txt
perf.data-file-format.txt perf record: Add 8-byte aligned event type PERF_RECORD_COMPRESSED2 2025-05-16 17:31:40 -03:00
perf.txt
perfconfig.example
security.txt
tips.txt perf report: Add latency and parallelism profiling documentation 2025-02-18 14:04:32 -08:00
topdown.txt