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