Linux 5.1.15
[linux/fpc-iii.git] / tools / bpf / bpftool / Documentation / bpftool.rst
blob4f2188845dd8338f435db3c7ac07e742e9b3ecbd
1 ================
2 BPFTOOL
3 ================
4 -------------------------------------------------------------------------------
5 tool for inspection and simple manipulation of eBPF programs and maps
6 -------------------------------------------------------------------------------
8 :Manual section: 8
10 SYNOPSIS
11 ========
13         **bpftool** [*OPTIONS*] *OBJECT* { *COMMAND* | **help** }
15         **bpftool** **batch file** *FILE*
17         **bpftool** **version**
19         *OBJECT* := { **map** | **program** | **cgroup** | **perf** | **net** | **feature** }
21         *OPTIONS* := { { **-V** | **--version** } | { **-h** | **--help** }
22         | { **-j** | **--json** } [{ **-p** | **--pretty** }] }
24         *MAP-COMMANDS* :=
25         { **show** | **list** | **create** | **dump** | **update** | **lookup** | **getnext**
26         | **delete** | **pin** | **event_pipe** | **help** }
28         *PROG-COMMANDS* := { **show** | **list** | **dump jited** | **dump xlated** | **pin**
29         | **load** | **attach** | **detach** | **help** }
31         *CGROUP-COMMANDS* := { **show** | **list** | **attach** | **detach** | **help** }
33         *PERF-COMMANDS* := { **show** | **list** | **help** }
35         *NET-COMMANDS* := { **show** | **list** | **help** }
37         *FEATURE-COMMANDS* := { **probe** | **help** }
39 DESCRIPTION
40 ===========
41         *bpftool* allows for inspection and simple modification of BPF objects
42         on the system.
44         Note that format of the output of all tools is not guaranteed to be
45         stable and should not be depended upon.
47 OPTIONS
48 =======
49         -h, --help
50                   Print short help message (similar to **bpftool help**).
52         -v, --version
53                   Print version number (similar to **bpftool version**).
55         -j, --json
56                   Generate JSON output. For commands that cannot produce JSON, this
57                   option has no effect.
59         -p, --pretty
60                   Generate human-readable JSON output. Implies **-j**.
62         -m, --mapcompat
63                   Allow loading maps with unknown map definitions.
65         -n, --nomount
66                   Do not automatically attempt to mount any virtual file system
67                   (such as tracefs or BPF virtual file system) when necessary.
70 SEE ALSO
71 ========
72         **bpf**\ (2),
73         **bpf-helpers**\ (7),
74         **bpftool-prog**\ (8),
75         **bpftool-map**\ (8),
76         **bpftool-cgroup**\ (8),
77         **bpftool-feature**\ (8),
78         **bpftool-net**\ (8),
79         **bpftool-perf**\ (8)