Add an "-m" option to "perf buildid-list".
PATCH 1/1 Add an "-m" option to "perf buildid-list".
This new option displays all of the information needed to do external BuildID-based symbolization of kernel stack traces, such as those collected by bpf_get_stackid(). For each kernel module plus the main kernel, it displays the BuildID, the start and end virtual addresses of that module's text range (rounded out to page boundaries), and the pathname of the module.
When run as a non-privileged user, the actual addresses of the modules' text ranges are not available, so the tools displays "0, <text length>" for kernel modules and "0, ffffffffffffffff" for the kernel itself.
Sample output:
root# perf buildid-list -mcf6df852fd4da122d616153353cc8f560fd12fe0 ffffffffa5400000 ffffffffa6001e27 [kernel.kallsyms] 1aa7209aa2acb067d66ed6cf7676d65066384d61 ffffffffc0087000 ffffffffc008b000 /lib/modules/5.15.15-1rodete2-amd64/kernel/crypto/sha512_generic.ko 3857815b5bf0183697b68f8fe0ea06121644041e ffffffffc008c000 ffffffffc0098000 /lib/modules/5.15.15-1rodete2-amd64/kernel/arch/x86/crypto/sha512-ssse3.ko 4081fde0bca2bc097cb3e9d1efcb836047d485f1 ffffffffc0099000 ffffffffc009f000 /lib/modules/5.15.15-1rodete2-amd64/kernel/drivers/acpi/button.ko 1ef81ba4890552ea6b0314f9635fc43fc8cef568 ffffffffc00a4000 ffffffffc00aa000 /lib/modules/5.15.15-1rodete2-amd64/kernel/crypto/cryptd.ko cc5c985506cb240d7d082b55ed260cbb851f983e ffffffffc00af000 ffffffffc00b6000 /lib/modules/5.15.15-1rodete2-amd64/kernel/drivers/i2c/busses/i2c-piix4.ko [...]
--- .../perf/Documentation/perf-buildid-list.txt | 3 ++ tools/perf/builtin-buildid-list.c | 33 ++++++++++++++++++- tools/perf/util/dso.c | 23 +++++++++++++ tools/perf/util/dso.h | 2 ++ tools/perf/util/machine.c | 13 ++++++++ tools/perf/util/machine.h | 5 +++ 6 files changed, 78 insertions(+), 1 deletion(-)
tools/perf/Documentation/perf-buildid-list.txt +3 -0
@@ -33,6 +33,9 @@ OPTIONS -k:: --kernel:: Show running kernel build id. +-m:: +--modules:: + Show buildid, start/end text address, and path of kernel and modules. -v:: --verbose:: Be more verbose.
tools/perf/builtin-buildid-list.c +32 -1
@@ -12,6 +12,7 @@#include "util/build-id.h" #include "util/debug.h" #include "util/dso.h" +#include "util/map.h" #include <subcmd/pager.h> #include <subcmd/parse-options.h> #include "util/session.h"
@@ -20,6 +21,29 @@#include <errno.h> #include <linux/err.h> +static int buildid__map_cb (struct map *map,void *arg__maybe_unused ) +{ +struct build_id build_id; +char bid_buf[SBUILD_ID_SIZE ]; +char modpath[255 ]; + +dso__get_build_id (map->dso, &build_id); +build_id__sprintf (&build_id, bid_buf); +dso__get_long_name (map->dso, modpath,sizeof (modpath)); +printf ("%s %16lx %16lx %s\n" , bid_buf, map->start, map->end, modpath); + +return 0 ; +} + +static void buildid__show_kernel_modules (void ) +{ +struct machine *machine; + + machine =machine__new_host (); +machine__for_each_kernel_map (machine, buildid__map_cb,NULL ); +machine__delete (machine); +} +static int sysfs__fprintf_build_id (FILE *fp) {char sbuild_id[SBUILD_ID_SIZE ];
@@ -99,6 +123,7 @@ static int perf_session__list_build_ids(bool force, bool with_hits)int cmd_buildid_list (int argc,const char **argv) {bool show_kernel = false; +bool show_modules = false;bool with_hits = false;bool force = false;const struct option options[] = {
@@ -106,6 +131,8 @@ int cmd_buildid_list(int argc, const char **argv)OPT_STRING ('i' ,"input" , &input_name,"file" ,"input file name" ),OPT_BOOLEAN ('f' ,"force" , &force,"don't complain, do it" ),OPT_BOOLEAN ('k' ,"kernel" , &show_kernel,"Show current kernel build id" ), +OPT_BOOLEAN ('m' ,"modules" , &show_modules, +"Show build id of current kernel + modules" ),OPT_INCR ('v' ,"verbose" , &verbose,"be more verbose" ), OPT_END() };
@@ -117,8 +144,12 @@ int cmd_buildid_list(int argc, const char **argv) argc =parse_options (argc, argv, options, buildid_list_usage,0 );setup_pager (); -if (show_kernel) +if (show_kernel) {return !(sysfs__fprintf_build_id (stdout) >0 ); + }else if (show_modules) { +buildid__show_kernel_modules (); +return 0 ; + }return perf_session__list_build_ids (force, with_hits); }
tools/perf/util/dso.c +23 -0
@@ -1227,6 +1227,19 @@ void dso__set_long_name(struct dso *dso, const char *name, bool name_allocated)dso__set_long_name_id (dso, name,NULL , name_allocated); } +void dso__get_long_name (const struct dso *dso,char *name,size_t len) +{ +if (len ==0 ) +return ; +if (dso->long_name ==NULL ) { + name[0 ] ='\0' ; +return ; + } + +strncpy (name, dso->long_name, len); + name[len -1 ] ='\0' ; +} +void dso__set_short_name (struct dso *dso,const char *name,bool name_allocated) {if (name ==NULL )
@@ -1359,6 +1372,16 @@ void dso__set_build_id(struct dso *dso, struct build_id *bid) dso->has_build_id =1 ; } +void dso__get_build_id (struct dso *dso,struct build_id *bid) +{ +if (dso->has_build_id) { + *bid = dso->bid; + }else { + bid->size =0 ; +memset (bid->data,0 ,sizeof (*bid->data)); + } +} +bool dso__build_id_equal (const struct dso *dso,struct build_id *bid) {if (dso->bid.size > bid->size && dso->bid.size ==BUILD_ID_SIZE ) {
tools/perf/util/dso.h +2 -0
@@ -237,6 +237,7 @@ void dso__delete(struct dso *dso);int dso__cmp_id (struct dso *a,struct dso *b);void dso__set_short_name (struct dso *dso,const char *name,bool name_allocated);void dso__set_long_name (struct dso *dso,const char *name,bool name_allocated); +void dso__get_long_name (const struct dso *dso,char *name,size_t len);int dso__name_len (const struct dso *dso);
@@ -263,6 +264,7 @@ void dso__set_sorted_by_name(struct dso *dso);void dso__sort_by_name (struct dso *dso);void dso__set_build_id (struct dso *dso,struct build_id *bid); +void dso__get_build_id (struct dso *dso,struct build_id *bid);bool dso__build_id_equal (const struct dso *dso,struct build_id *bid);void dso__read_running_kernel_build_id (struct dso *dso,struct machine *machine);
tools/perf/util/machine.c +13 -0
@@ -3232,3 +3232,16 @@ int machine__for_each_dso(struct machine *machine, machine__dso_t fn, void *priv }return err; } + +int machine__for_each_kernel_map (struct machine *machine,machine__map_t fn,void *priv) +{ +struct maps *maps =machine__kernel_maps (machine); +struct map *map; +int err =0 ; + +for (map =maps__first (maps); map !=NULL ; map =map__next (map)) { +if (fn (map, priv)) + err =-1 ; + } +return err; +}
tools/perf/util/machine.h +5 -0
@@ -259,6 +259,11 @@ typedef int (*machine__dso_t)(struct dso *dso, struct machine *machine, void *print machine__for_each_dso (struct machine *machine,machine__dso_t fn,void *priv); + +typedef int (*machine__map_t )(struct map *map,void *priv); +int machine__for_each_kernel_map (struct machine *machine,machine__map_t fn, +void *priv); +int machine__for_each_thread (struct machine *machine,int (*fn)(struct thread *thread,void *p),void *priv);
base-commit: e0c1b8f9eba88173b30ba42eb492fd20582cf376
Signature · 1 line
2.36.0.464.gb9c8b46e94-goog
Arnaldo Carvalho de Melo
maintainerEm Tue, May 03, 2022 at 02:37:04PM -0700, Blake Jones escreveu:
Quoted 37 lines
This new option displays all of the information needed to do external BuildID-based symbolization of kernel stack traces, such as those collected by
bpf_get_stackid(). For each kernel module plus the main kernel, it displays the BuildID, the start and end virtual addresses of that module's text range (rounded out to page boundaries), and the pathname of the module.When run as a non-privileged user, the actual addresses of the modules' text ranges are not available, so the tools displays "0, <text length>" for kernel modules and "0, ffffffffffffffff" for the kernel itself.
Sample output:
root# perf buildid-list -m
cf6df852fd4da122d616153353cc8f560fd12fe0ffffffffa5400000ffffffffa6001e27[kernel.kallsyms]1aa7209aa2acb067d66ed6cf7676d65066384d61ffffffffc0087000ffffffffc008b000/lib/modules/5.15.15-1rodete2-amd64/kernel/crypto/sha512_generic.ko3857815b5bf0183697b68f8fe0ea06121644041effffffffc008c000ffffffffc0098000/lib/modules/5.15.15-1rodete2-amd64/kernel/arch/x86/crypto/sha512-ssse3.ko4081fde0bca2bc097cb3e9d1efcb836047d485f1ffffffffc0099000ffffffffc009f000/lib/modules/5.15.15-1rodete2-amd64/kernel/drivers/acpi/button.ko1ef81ba4890552ea6b0314f9635fc43fc8cef568ffffffffc00a4000ffffffffc00aa000/lib/modules/5.15.15-1rodete2-amd64/kernel/crypto/cryptd.kocc5c985506cb240d7d082b55ed260cbb851f983effffffffc00af000ffffffffc00b6000/lib/modules/5.15.15-1rodete2-amd64/kernel/drivers/i2c/busses/i2c-piix4.ko[...]Signed-off-by Blake Jones <[email protected]>--- .../perf/Documentation/perf-buildid-list.txt | 3 ++ tools/perf/builtin-buildid-list.c | 33 ++++++++++++++++++- tools/perf/util/dso.c | 23 +++++++++++++ tools/perf/util/dso.h | 2 ++ tools/perf/util/machine.c | 13 ++++++++ tools/perf/util/machine.h | 5 +++ 6 files changed, 78 insertions(+), 1 deletion(-)tools/perf/Documentation/perf-buildid-list.txt +0
-0
tools/perf/Documentation/perf-buildid-list.txt OPTIONS · line 38
Quoted 6 lines
tools/perf/Documentation/perf-buildid-list.txt +3
-0@@ -33,6 +33,9 @@ OPTIONS -k:: --kernel:: Show running kernel build id. +-m:: +--modules:: + Show buildid, start/end text address, and path of kernel and modules.
Hi,
Wouldn't it be better to have -m show just modules, name +
buildid, then have -v show more verbose info, i.e. the start, end and switch from just the module name to its full path?
Then to get what your patch produces now one would use:
$ perf buildid-list -kmv
That would be more flexible, wdyt?
- Arnaldo
Quoted 178 lines
tools/perf/Documentation/perf-buildid-list.txt +0
-0-v:: --verbose:: Be more verbose.tools/perf/builtin-buildid-list.c +32
-1@@ -12,6 +12,7 @@#include "util/build-id.h" #include "util/debug.h" #include "util/dso.h" +#include "util/map.h" #include <subcmd/pager.h> #include <subcmd/parse-options.h> #include "util/session.h" @@ -20,6 +21,29 @@#include <errno.h> #include <linux/err.h> +static int buildid__map_cb (struct map *map,void *arg__maybe_unused ) +{ +struct build_id build_id; +char bid_buf[SBUILD_ID_SIZE ]; +char modpath[255 ]; + +dso__get_build_id (map->dso, &build_id); +build_id__sprintf (&build_id, bid_buf); +dso__get_long_name (map->dso, modpath,sizeof (modpath)); +printf ("%s %16lx %16lx %s\n" , bid_buf, map->start, map->end, modpath); + +return 0 ; +} + +static void buildid__show_kernel_modules (void ) +{ +struct machine *machine; + + machine =machine__new_host (); +machine__for_each_kernel_map (machine, buildid__map_cb,NULL ); +machine__delete (machine); +} +static int sysfs__fprintf_build_id (FILE *fp) {char sbuild_id[SBUILD_ID_SIZE ];@@ -99,6 +123,7 @@ static int perf_session__list_build_ids(bool force, bool with_hits)int cmd_buildid_list (int argc,const char **argv) {bool show_kernel = false; +bool show_modules = false;bool with_hits = false;bool force = false;const struct option options[] = {@@ -106,6 +131,8 @@ int cmd_buildid_list(int argc, const char **argv)OPT_STRING ('i' ,"input" , &input_name,"file" ,"input file name" ),OPT_BOOLEAN ('f' ,"force" , &force,"don't complain, do it" ),OPT_BOOLEAN ('k' ,"kernel" , &show_kernel,"Show current kernel build id" ), +OPT_BOOLEAN ('m' ,"modules" , &show_modules, +"Show build id of current kernel + modules" ),OPT_INCR ('v' ,"verbose" , &verbose,"be more verbose" ), OPT_END() };@@ -117,8 +144,12 @@ int cmd_buildid_list(int argc, const char **argv) argc =parse_options (argc, argv, options, buildid_list_usage,0 );setup_pager (); -if (show_kernel) +if (show_kernel) {return !(sysfs__fprintf_build_id (stdout) >0 ); + }else if (show_modules) { +buildid__show_kernel_modules (); +return 0 ; + }return perf_session__list_build_ids (force, with_hits); }tools/perf/util/dso.c +23
-0@@ -1227,6 +1227,19 @@ void dso__set_long_name(struct dso *dso, const char *name, bool name_allocated)dso__set_long_name_id (dso, name,NULL , name_allocated); } +void dso__get_long_name (const struct dso *dso,char *name,size_t len) +{ +if (len ==0 ) +return ; +if (dso->long_name ==NULL ) { + name[0 ] ='\0' ; +return ; + } + +strncpy (name, dso->long_name, len); + name[len -1 ] ='\0' ; +} +void dso__set_short_name (struct dso *dso,const char *name,bool name_allocated) {if (name ==NULL )@@ -1359,6 +1372,16 @@ void dso__set_build_id(struct dso *dso, struct build_id *bid) dso->has_build_id =1 ; } +void dso__get_build_id (struct dso *dso,struct build_id *bid) +{ +if (dso->has_build_id) { + *bid = dso->bid; + }else { + bid->size =0 ; +memset (bid->data,0 ,sizeof (*bid->data)); + } +} +bool dso__build_id_equal (const struct dso *dso,struct build_id *bid) {if (dso->bid.size > bid->size && dso->bid.size ==BUILD_ID_SIZE ) {tools/perf/util/dso.h +2
-0@@ -237,6 +237,7 @@ void dso__delete(struct dso *dso);int dso__cmp_id (struct dso *a,struct dso *b);void dso__set_short_name (struct dso *dso,const char *name,bool name_allocated);void dso__set_long_name (struct dso *dso,const char *name,bool name_allocated); +void dso__get_long_name (const struct dso *dso,char *name,size_t len);int dso__name_len (const struct dso *dso);@@ -263,6 +264,7 @@ void dso__set_sorted_by_name(struct dso *dso);void dso__sort_by_name (struct dso *dso);void dso__set_build_id (struct dso *dso,struct build_id *bid); +void dso__get_build_id (struct dso *dso,struct build_id *bid);bool dso__build_id_equal (const struct dso *dso,struct build_id *bid);void dso__read_running_kernel_build_id (struct dso *dso,struct machine *machine);tools/perf/util/machine.c +13
-0@@ -3232,3 +3232,16 @@ int machine__for_each_dso(struct machine *machine, machine__dso_t fn, void *priv }return err; } + +int machine__for_each_kernel_map (struct machine *machine,machine__map_t fn,void *priv) +{ +struct maps *maps =machine__kernel_maps (machine); +struct map *map; +int err =0 ; + +for (map =maps__first (maps); map !=NULL ; map =map__next (map)) { +if (fn (map, priv)) + err =-1 ; + } +return err; +}tools/perf/util/machine.h +5
-0@@ -259,6 +259,11 @@ typedef int (*machine__dso_t)(struct dso *dso, struct machine *machine, void *print machine__for_each_dso (struct machine *machine,machine__dso_t fn,void *priv); + +typedef int (*machine__map_t )(struct map *map,void *priv); +int machine__for_each_kernel_map (struct machine *machine,machine__map_t fn, +void *priv); +int machine__for_each_thread (struct machine *machine,int (*fn)(struct thread *thread,void *p),void *priv);base-commit:
e0c1b8f9eba88173b30ba42eb492fd20582cf376Signature · 1 line
2.36.0.464.gb9c8b46e94-goog
Signature · 1 line
- Arnaldo
Thanks for taking a look at this!
Quoted 11 lines · Arnaldo Carvalho de Melo
Em Tue, May 03, 2022 at 02:37:04PM -0700, Blake Jones escreveu:
Quoted 3 lines
+-m:: +--modules:: + Show buildid, start/end text address, and path of kernel and modules.Hi,
Wouldn't it be better to have -m show just modules, name +
buildid, then have -v show more verbose info, i.e. the start, end and switch from just the module name to its full path?
Quoted 5 lines
Then to get what your patch produces now one would use:
$ perf buildid-list -kmv
That would be more flexible, wdyt?
I'm open to using "-v" like this if you think it would be useful; is there a use case you have in mind for the non-verbose mode? For doing external symbolization of stack traces, the BuildID isn't useful without also knowing the starting and ending addresses.
If "-m" only showed information about modules and not about the kernel, then "perf buildid-list -km" (without "-v") would have different output formats for the kernel and for the modules. So I'm inclined to have "-m" include information about the kernel as well as the modules.
How does that sound?
Blake
Ian Rogers
reviewerQuoted 27 lines · Blake Jones
Thanks for taking a look at this!
Quoted 11 lines · Arnaldo Carvalho de Melo
Em Tue, May 03, 2022 at 02:37:04PM -0700, Blake Jones escreveu:
Quoted 3 lines
+-m:: +--modules:: + Show buildid, start/end text address, and path of kernel and modules.Hi,
Wouldn't it be better to have -m show just modules, name +
buildid, then have -v show more verbose info, i.e. the start, end and switch from just the module name to its full path?Quoted 5 lines
Then to get what your patch produces now one would use:
$ perf buildid-list -kmv
That would be more flexible, wdyt?
I'm open to using "-v" like this if you think it would be useful; is there a use case you have in mind for the non-verbose mode? For doing external symbolization of stack traces, the BuildID isn't useful without also knowing the starting and ending addresses.
Quoted 8 lines
If "-m" only showed information about modules and not about the kernel, then "perf buildid-list -km" (without "-v") would have different output formats for the kernel and for the modules. So I'm inclined to have "-m" include information about the kernel as well as the modules.
How does that sound?
Blake
Using "-m" sounds okay to me, Arnaldo?
Thanks,
Ian