1 perf-check(1) 1 perf-check(1)
2 =============== 2 ===============
3 3
4 NAME 4 NAME
5 ---- 5 ----
6 perf-check - check if features are present in 6 perf-check - check if features are present in perf
7 7
8 SYNOPSIS 8 SYNOPSIS
9 -------- 9 --------
10 [verse] 10 [verse]
11 'perf check' [<options>] 11 'perf check' [<options>]
12 'perf check' {feature <feature_list>} [<option 12 'perf check' {feature <feature_list>} [<options>]
13 13
14 DESCRIPTION 14 DESCRIPTION
15 ----------- 15 -----------
16 With no subcommands given, 'perf check' comman 16 With no subcommands given, 'perf check' command just prints the command
17 usage on the standard output. 17 usage on the standard output.
18 18
19 If the subcommand 'feature' is used, then stat 19 If the subcommand 'feature' is used, then status of feature is printed
20 on the standard output (unless '-q' is also pa 20 on the standard output (unless '-q' is also passed), ie. whether it is
21 compiled-in/built-in or not. 21 compiled-in/built-in or not.
22 Also, 'perf check feature' returns with exit s 22 Also, 'perf check feature' returns with exit status 0 if the feature
23 is built-in, otherwise returns with exit statu 23 is built-in, otherwise returns with exit status 1.
24 24
25 SUBCOMMANDS 25 SUBCOMMANDS
26 ----------- 26 -----------
27 27
28 feature:: 28 feature::
29 29
30 Print whether feature(s) is compiled-i 30 Print whether feature(s) is compiled-in or not, and also returns with an
31 exit status of 0, if passed feature(s) 31 exit status of 0, if passed feature(s) are compiled-in, else 1.
32 32
33 It expects a feature list as an argume 33 It expects a feature list as an argument. There can be a single feature
34 name/macro, or multiple features can a 34 name/macro, or multiple features can also be passed as a comma-separated
35 list, in which case the exit status wi 35 list, in which case the exit status will be 0 only if all of the passed
36 features are compiled-in. 36 features are compiled-in.
37 37
38 The feature names/macros are case-inse 38 The feature names/macros are case-insensitive.
39 39
40 Example Usage: 40 Example Usage:
41 perf check feature libtraceeve 41 perf check feature libtraceevent
42 perf check feature HAVE_LIBTRA 42 perf check feature HAVE_LIBTRACEEVENT
43 perf check feature libtraceeve 43 perf check feature libtraceevent,bpf
44 44
45 Supported feature names/macro: 45 Supported feature names/macro:
46 aio / HAV 46 aio / HAVE_AIO_SUPPORT
47 bpf / HAV 47 bpf / HAVE_LIBBPF_SUPPORT
48 bpf_skeletons / HAV 48 bpf_skeletons / HAVE_BPF_SKEL
49 debuginfod / HAV 49 debuginfod / HAVE_DEBUGINFOD_SUPPORT
50 dwarf / HAV 50 dwarf / HAVE_DWARF_SUPPORT
51 dwarf_getlocations / HAV 51 dwarf_getlocations / HAVE_DWARF_GETLOCATIONS_SUPPORT
52 dwarf-unwind / HAV 52 dwarf-unwind / HAVE_DWARF_UNWIND_SUPPORT
53 auxtrace / HAV 53 auxtrace / HAVE_AUXTRACE_SUPPORT
54 libaudit / HAV 54 libaudit / HAVE_LIBAUDIT_SUPPORT
55 libbfd / HAV 55 libbfd / HAVE_LIBBFD_SUPPORT
56 libcapstone / HAV 56 libcapstone / HAVE_LIBCAPSTONE_SUPPORT
57 libcrypto / HAV 57 libcrypto / HAVE_LIBCRYPTO_SUPPORT
58 libdw-dwarf-unwind / HAV 58 libdw-dwarf-unwind / HAVE_DWARF_SUPPORT
59 libelf / HAV 59 libelf / HAVE_LIBELF_SUPPORT
60 libnuma / HAV 60 libnuma / HAVE_LIBNUMA_SUPPORT
61 libopencsd / HAV 61 libopencsd / HAVE_CSTRACE_SUPPORT
62 libperl / HAV 62 libperl / HAVE_LIBPERL_SUPPORT
63 libpfm4 / HAV 63 libpfm4 / HAVE_LIBPFM
64 libpython / HAV 64 libpython / HAVE_LIBPYTHON_SUPPORT
65 libslang / HAV 65 libslang / HAVE_SLANG_SUPPORT
66 libtraceevent / HAV 66 libtraceevent / HAVE_LIBTRACEEVENT
67 libunwind / HAV 67 libunwind / HAVE_LIBUNWIND_SUPPORT
68 lzma / HAV 68 lzma / HAVE_LZMA_SUPPORT
69 numa_num_possible_cpus / HAV 69 numa_num_possible_cpus / HAVE_LIBNUMA_SUPPORT
70 syscall_table / HAV 70 syscall_table / HAVE_SYSCALL_TABLE_SUPPORT
71 zlib / HAV 71 zlib / HAVE_ZLIB_SUPPORT
72 zstd / HAV 72 zstd / HAVE_ZSTD_SUPPORT
73 73
74 OPTIONS 74 OPTIONS
75 ------- 75 -------
76 -q:: 76 -q::
77 --quiet:: 77 --quiet::
78 Do not print any messages or warnings 78 Do not print any messages or warnings
79 79
80 This can be used along with subcommand 80 This can be used along with subcommands such as 'perf check feature'
81 to hide unnecessary output in test scr 81 to hide unnecessary output in test scripts, eg.
82 'perf check feature --quiet libtraceev 82 'perf check feature --quiet libtraceevent'
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.