Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 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 | |
Quentin Monnet | 0641c3c | 2017-10-23 09:24:16 -0700 | [diff] [blame] | 13 | **bpftool** [*OPTIONS*] *OBJECT* { *COMMAND* | **help** } |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 14 | |
Quentin Monnet | 47ff7ac | 2017-10-23 09:24:15 -0700 | [diff] [blame] | 15 | **bpftool** **batch file** *FILE* |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 16 | |
Quentin Monnet | 47ff7ac | 2017-10-23 09:24:15 -0700 | [diff] [blame] | 17 | **bpftool** **version** |
Quentin Monnet | 821cfbb | 2017-10-19 15:46:26 -0700 | [diff] [blame] | 18 | |
Yonghong Song | b04df40 | 2018-05-24 11:21:58 -0700 | [diff] [blame^] | 19 | *OBJECT* := { **map** | **program** | **cgroup** | **perf** } |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 20 | |
Quentin Monnet | 0641c3c | 2017-10-23 09:24:16 -0700 | [diff] [blame] | 21 | *OPTIONS* := { { **-V** | **--version** } | { **-h** | **--help** } |
| 22 | | { **-j** | **--json** } [{ **-p** | **--pretty** }] } |
| 23 | |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 24 | *MAP-COMMANDS* := |
Jakub Kicinski | 6ebe6db | 2018-01-02 14:48:36 -0800 | [diff] [blame] | 25 | { **show** | **list** | **dump** | **update** | **lookup** | **getnext** | **delete** |
Jakub Kicinski | f412eed | 2018-05-03 18:37:16 -0700 | [diff] [blame] | 26 | | **pin** | **event_pipe** | **help** } |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 27 | |
Jakub Kicinski | 6ebe6db | 2018-01-02 14:48:36 -0800 | [diff] [blame] | 28 | *PROG-COMMANDS* := { **show** | **list** | **dump jited** | **dump xlated** | **pin** |
Roman Gushchin | 49a086c | 2017-12-13 15:18:53 +0000 | [diff] [blame] | 29 | | **load** | **help** } |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 30 | |
Jakub Kicinski | 6ebe6db | 2018-01-02 14:48:36 -0800 | [diff] [blame] | 31 | *CGROUP-COMMANDS* := { **show** | **list** | **attach** | **detach** | **help** } |
Roman Gushchin | 5ccda64 | 2017-12-13 15:18:54 +0000 | [diff] [blame] | 32 | |
Yonghong Song | b04df40 | 2018-05-24 11:21:58 -0700 | [diff] [blame^] | 33 | *PERF-COMMANDS* := { **show** | **list** | **help** } |
| 34 | |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 35 | DESCRIPTION |
| 36 | =========== |
| 37 | *bpftool* allows for inspection and simple modification of BPF objects |
| 38 | on the system. |
| 39 | |
| 40 | Note that format of the output of all tools is not guaranteed to be |
| 41 | stable and should not be depended upon. |
| 42 | |
Quentin Monnet | a2bc2e5 | 2017-10-23 09:24:06 -0700 | [diff] [blame] | 43 | OPTIONS |
| 44 | ======= |
| 45 | -h, --help |
| 46 | Print short help message (similar to **bpftool help**). |
| 47 | |
| 48 | -v, --version |
| 49 | Print version number (similar to **bpftool version**). |
| 50 | |
Quentin Monnet | 0641c3c | 2017-10-23 09:24:16 -0700 | [diff] [blame] | 51 | -j, --json |
| 52 | Generate JSON output. For commands that cannot produce JSON, this |
| 53 | option has no effect. |
| 54 | |
| 55 | -p, --pretty |
| 56 | Generate human-readable JSON output. Implies **-j**. |
| 57 | |
Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 58 | SEE ALSO |
| 59 | ======== |
Roman Gushchin | 5ccda64 | 2017-12-13 15:18:54 +0000 | [diff] [blame] | 60 | **bpftool-map**\ (8), **bpftool-prog**\ (8), **bpftool-cgroup**\ (8) |
Yonghong Song | b04df40 | 2018-05-24 11:21:58 -0700 | [diff] [blame^] | 61 | **bpftool-perf**\ (8) |