| 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 | |
| Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 19 | *OBJECT* := { **map** | **program** } |
| 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* := |
| Quentin Monnet | 47ff7ac | 2017-10-23 09:24:15 -0700 | [diff] [blame] | 25 | { **show** | **dump** | **update** | **lookup** | **getnext** | **delete** |
| 26 | | **pin** | **help** } |
| Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 27 | |
| Quentin Monnet | 47ff7ac | 2017-10-23 09:24:15 -0700 | [diff] [blame] | 28 | *PROG-COMMANDS* := { **show** | **dump jited** | **dump xlated** | **pin** |
| 29 | | **help** } |
| Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 30 | |
| 31 | DESCRIPTION |
| 32 | =========== |
| 33 | *bpftool* allows for inspection and simple modification of BPF objects |
| 34 | on the system. |
| 35 | |
| 36 | Note that format of the output of all tools is not guaranteed to be |
| 37 | stable and should not be depended upon. |
| 38 | |
| Quentin Monnet | a2bc2e5 | 2017-10-23 09:24:06 -0700 | [diff] [blame] | 39 | OPTIONS |
| 40 | ======= |
| 41 | -h, --help |
| 42 | Print short help message (similar to **bpftool help**). |
| 43 | |
| 44 | -v, --version |
| 45 | Print version number (similar to **bpftool version**). |
| 46 | |
| Quentin Monnet | 0641c3c | 2017-10-23 09:24:16 -0700 | [diff] [blame] | 47 | -j, --json |
| 48 | Generate JSON output. For commands that cannot produce JSON, this |
| 49 | option has no effect. |
| 50 | |
| 51 | -p, --pretty |
| 52 | Generate human-readable JSON output. Implies **-j**. |
| 53 | |
| Jakub Kicinski | ff69c21 | 2017-10-04 20:10:05 -0700 | [diff] [blame] | 54 | SEE ALSO |
| 55 | ======== |
| 56 | **bpftool-map**\ (8), **bpftool-prog**\ (8) |