aboutsummaryrefslogtreecommitdiff
path: root/tools/perf/Documentation/perf-inject.txt
diff options
context:
space:
mode:
authorGravatar Raul Silvera <rsilvera@google.com> 2022-08-15 22:59:22 +0000
committerGravatar Arnaldo Carvalho de Melo <acme@redhat.com> 2022-10-04 08:55:19 -0300
commit8012243e62b5e13bded3ce8a3b69d28f8ea694fe (patch)
treee41402c23f7a8161f5d211520efb92dd61abf13e /tools/perf/Documentation/perf-inject.txt
parentMerge tag 'statx-dioalign-for-linus' of git://git.kernel.org/pub/scm/linux/ke... (diff)
downloadlinux-8012243e62b5e13bded3ce8a3b69d28f8ea694fe.tar.gz
linux-8012243e62b5e13bded3ce8a3b69d28f8ea694fe.tar.bz2
linux-8012243e62b5e13bded3ce8a3b69d28f8ea694fe.zip
perf inject: Add a command line option to specify build ids.
This commit adds the option --known-build-ids to perf inject. It allows the user to explicitly specify the build id for a given path, instead of retrieving it from the current system. This is useful in cases where a perf.data file is processed on a different system from where it was collected, or if some of the binaries are no longer available. The build ids and paths are specified in pairs in the command line. Using the file:// specifier, build ids can be loaded from a file directly generated by perf buildid-list. This is convenient to copy build ids from one perf.data file to another. ** Example: In this example we use perf record to create two perf.data files, one with build ids and another without, and use perf buildid-list and perf inject to copy the build ids from the first file to the second. $ perf record ls /tmp $ perf record --no-buildid -o perf.data.no-buildid ls /tmp $ perf buildid-list > build-ids.txt $ perf inject -b --known-build-ids='file://build-ids.txt' \ -i perf.data.no-buildid -o perf.data.buildid Signed-off-by: Raul Silvera <rsilvera@google.com> Acked-by: Namhyung Kim <namhyung@kernel.org> Cc: Adrian Hunter <adrian.hunter@intel.com> Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com> Cc: Ingo Molnar <mingo@redhat.com> Cc: James Clark <james.clark@arm.com> Cc: Jiri Olsa <jolsa@kernel.org> Cc: Mark Rutland <mark.rutland@arm.com> Cc: Peter Zijlstra <peterz@infradead.org> Link: https://lore.kernel.org/r/20220815225922.2118745-1-rsilvera@google.com Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Diffstat (limited to 'tools/perf/Documentation/perf-inject.txt')
-rw-r--r--tools/perf/Documentation/perf-inject.txt7
1 files changed, 6 insertions, 1 deletions
diff --git a/tools/perf/Documentation/perf-inject.txt b/tools/perf/Documentation/perf-inject.txt
index ffc293fdf61d..70e2ac3cc91a 100644
--- a/tools/perf/Documentation/perf-inject.txt
+++ b/tools/perf/Documentation/perf-inject.txt
@@ -27,9 +27,14 @@ OPTIONS
--build-ids::
Inject build-ids into the output stream
---buildid-all:
+--buildid-all::
Inject build-ids of all DSOs into the output stream
+--known-build-ids=::
+ Override build-ids to inject using these comma-separated pairs of
+ build-id and path. Understands file://filename to read these pairs
+ from a file, which can be generated with perf buildid-list.
+
-v::
--verbose::
Be more verbose.