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