summaryrefslogtreecommitdiffstats
path: root/tools/perf/Documentation/perf-check.txt
blob: 10f69fb6850bcc8cadf0a66d3fc22d30e0e031d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
perf-check(1)
===============

NAME
----
perf-check - check if features are present in perf

SYNOPSIS
--------
[verse]
'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_DWARF_SUPPORT
                dwarf_getlocations      /  HAVE_DWARF_GETLOCATIONS_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_DWARF_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'