table of contents
BPFTOOL(8) | BPFTOOL(8) |
NAME¶
BPFTOOL - tool for inspection and simple manipulation of eBPF programs and maps
SYNOPSIS¶
bpftool batch file FILE
bpftool version
OBJECT := { map | program | link | cgroup | perf | net | feature | btf | gen | struct_ops | iter }
OPTIONS := { { -V | --version } | { -j | --json } [{ -p | --pretty }] | { -d | --debug } }
MAP-COMMANDS := { show | list | create | dump | update | lookup | getnext | delete | pin | event_pipe | help }
PROG-COMMANDS := { show | list | dump jited | dump xlated | pin | load | attach | detach | help }
LINK-COMMANDS := { show | list | pin | detach | help }
CGROUP-COMMANDS := { show | list | attach | detach | help }
PERF-COMMANDS := { show | list | help }
NET-COMMANDS := { show | list | help }
FEATURE-COMMANDS := { probe | help }
BTF-COMMANDS := { show | list | dump | help }
GEN-COMMANDS := { object | skeleton | help }
STRUCT-OPS-COMMANDS := { show | list | dump | register | unregister | help }
ITER-COMMANDS := { pin | help }
DESCRIPTION¶
Note that format of the output of all tools is not guaranteed to be stable and should not be depended upon.
OPTIONS¶
- -h, --help
- Print short help message (similar to bpftool help).
- -V, --version
- Print version number (similar to bpftool version), and optional features that were included when bpftool was compiled. Optional features include linking against libbfd to provide the disassembler for JIT-ted programs (bpftool prog dump jited) and usage of BPF skeletons (some features like bpftool prog profile or showing pids associated to BPF objects may rely on it).
- -j, --json
- Generate JSON output. For commands that cannot produce JSON, this option has no effect.
- -p, --pretty
- Generate human-readable JSON output. Implies -j.
- -d, --debug
- Print all logs available, even debug-level information. This includes logs from libbpf as well as from the verifier, when attempting to load programs.
- -m, --mapcompat
- Allow loading maps with unknown map definitions.
- -n, --nomount
- Do not automatically attempt to mount any virtual file system (such as tracefs or BPF virtual file system) when necessary.