Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

perf inject: Clarify build-id options a little bit

Update the documentation of --build-id and --buildid-all options to
clarify the difference between them. The former requires full sample
processing to find which DSOs are actually used. While the latter simply
injects every DSO's build-id from MMAP{,2} records, skipping SAMPLEs.

Reviewed-by: Adrian Hunter <adrian.hunter@intel.com>
Signed-off-by: Namhyung Kim <namhyung@kernel.org>
Cc: Ian Rogers <irogers@google.com>
Cc: Ingo Molnar <mingo@kernel.org>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Stephane Eranian <eranian@google.com>
Link: https://lore.kernel.org/r/20220923173142.805896-3-namhyung@kernel.org
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>

authored by

Namhyung Kim and committed by
Arnaldo Carvalho de Melo
fd941521 d031a00a

+4 -2
+4 -2
tools/perf/Documentation/perf-inject.txt
··· 25 25 ------- 26 26 -b:: 27 27 --build-ids:: 28 - Inject build-ids into the output stream 28 + Inject build-ids of DSOs hit by samples into the output stream. 29 + This means it needs to process all SAMPLE records to find the DSOs. 29 30 30 31 --buildid-all:: 31 - Inject build-ids of all DSOs into the output stream 32 + Inject build-ids of all DSOs into the output stream regardless of hits 33 + and skip SAMPLE processing. 32 34 33 35 --known-build-ids=:: 34 36 Override build-ids to inject using these comma-separated pairs of