perf-check - Man Page
check if features are present in perf
Synopsis
perf check [<options>] perf check {feature <feature_list>} [<options>]
Description
With no subcommands given, perf check command just prints the command usage on the standard output.
If the subcommand feature is used, then status of feature is printed on the standard output (unless -q is also passed), ie. whether it is compiled-in/built-in or not. Also, perf check feature returns with exit status 0 if the feature is built-in, otherwise returns with exit status 1.
Subcommands
- feature
Print whether feature(s) is compiled-in or not, and also returns with an exit status of 0, if passed feature(s) are compiled-in, else 1.
It expects a feature list as an argument. There can be a single feature name/macro, or multiple features can also be passed as a comma-separated list, in which case the exit status will be 0 only if all of the passed features are compiled-in.
The feature names/macros are case-insensitive.
Example Usage: perf check feature libtraceevent perf check feature HAVE_LIBTRACEEVENT perf check feature libtraceevent,bpf
Supported feature names/macro: aio / HAVE_AIO_SUPPORT bpf / HAVE_LIBBPF_SUPPORT bpf_skeletons / HAVE_BPF_SKEL debuginfod / HAVE_DEBUGINFOD_SUPPORT dwarf / HAVE_LIBDW_SUPPORT dwarf_getlocations / HAVE_LIBDW_SUPPORT dwarf-unwind / HAVE_DWARF_UNWIND_SUPPORT auxtrace / HAVE_AUXTRACE_SUPPORT libaudit / HAVE_LIBAUDIT_SUPPORT libbfd / HAVE_LIBBFD_SUPPORT libcapstone / HAVE_LIBCAPSTONE_SUPPORT libcrypto / HAVE_LIBCRYPTO_SUPPORT libdw-dwarf-unwind / HAVE_LIBDW_SUPPORT libelf / HAVE_LIBELF_SUPPORT libnuma / HAVE_LIBNUMA_SUPPORT libopencsd / HAVE_CSTRACE_SUPPORT libperl / HAVE_LIBPERL_SUPPORT libpfm4 / HAVE_LIBPFM libpython / HAVE_LIBPYTHON_SUPPORT libslang / HAVE_SLANG_SUPPORT libtraceevent / HAVE_LIBTRACEEVENT libunwind / HAVE_LIBUNWIND_SUPPORT lzma / HAVE_LZMA_SUPPORT numa_num_possible_cpus / HAVE_LIBNUMA_SUPPORT syscall_table / HAVE_SYSCALL_TABLE_SUPPORT zlib / HAVE_ZLIB_SUPPORT zstd / HAVE_ZSTD_SUPPORT
Options
- -q, ā--quiet
Do not print any messages or warnings
This can be used along with subcommands such as 'perf check feature' to hide unnecessary output in test scripts, eg. 'perf check feature --quiet libtraceevent'
Info
12/04/2024 perf Manual