83 lines · plain
1perf-check(1)2===============3 4NAME5----6perf-check - check if features are present in perf7 8SYNOPSIS9--------10[verse]11'perf check' [<options>]12'perf check' {feature <feature_list>} [<options>]13 14DESCRIPTION15-----------16With no subcommands given, 'perf check' command just prints the command17usage on the standard output.18 19If the subcommand 'feature' is used, then status of feature is printed20on the standard output (unless '-q' is also passed), ie. whether it is21compiled-in/built-in or not.22Also, 'perf check feature' returns with exit status 0 if the feature23is built-in, otherwise returns with exit status 1.24 25SUBCOMMANDS26-----------27 28feature::29 30 Print whether feature(s) is compiled-in or not, and also returns with an31 exit status of 0, if passed feature(s) are compiled-in, else 1.32 33 It expects a feature list as an argument. There can be a single feature34 name/macro, or multiple features can also be passed as a comma-separated35 list, in which case the exit status will be 0 only if all of the passed36 features are compiled-in.37 38 The feature names/macros are case-insensitive.39 40 Example Usage:41 perf check feature libtraceevent42 perf check feature HAVE_LIBTRACEEVENT43 perf check feature libtraceevent,bpf44 45 Supported feature names/macro:46 aio / HAVE_AIO_SUPPORT47 bpf / HAVE_LIBBPF_SUPPORT48 bpf_skeletons / HAVE_BPF_SKEL49 debuginfod / HAVE_DEBUGINFOD_SUPPORT50 dwarf / HAVE_DWARF_SUPPORT51 dwarf_getlocations / HAVE_DWARF_GETLOCATIONS_SUPPORT52 dwarf-unwind / HAVE_DWARF_UNWIND_SUPPORT53 auxtrace / HAVE_AUXTRACE_SUPPORT54 libaudit / HAVE_LIBAUDIT_SUPPORT55 libbfd / HAVE_LIBBFD_SUPPORT56 libcapstone / HAVE_LIBCAPSTONE_SUPPORT57 libcrypto / HAVE_LIBCRYPTO_SUPPORT58 libdw-dwarf-unwind / HAVE_DWARF_SUPPORT59 libelf / HAVE_LIBELF_SUPPORT60 libnuma / HAVE_LIBNUMA_SUPPORT61 libopencsd / HAVE_CSTRACE_SUPPORT62 libperl / HAVE_LIBPERL_SUPPORT63 libpfm4 / HAVE_LIBPFM64 libpython / HAVE_LIBPYTHON_SUPPORT65 libslang / HAVE_SLANG_SUPPORT66 libtraceevent / HAVE_LIBTRACEEVENT67 libunwind / HAVE_LIBUNWIND_SUPPORT68 lzma / HAVE_LZMA_SUPPORT69 numa_num_possible_cpus / HAVE_LIBNUMA_SUPPORT70 syscall_table / HAVE_SYSCALL_TABLE_SUPPORT71 zlib / HAVE_ZLIB_SUPPORT72 zstd / HAVE_ZSTD_SUPPORT73 74OPTIONS75-------76-q::77--quiet::78 Do not print any messages or warnings79 80 This can be used along with subcommands such as 'perf check feature'81 to hide unnecessary output in test scripts, eg.82 'perf check feature --quiet libtraceevent'83