alistair23-linux/tools/bpf/bpftool/Documentation
Quentin Monnet ba95c74524 tools: bpftool: add "prog run" subcommand to test-run programs
Add a new "bpftool prog run" subcommand to run a loaded program on input
data (and possibly with input context) passed by the user.

Print output data (and output context if relevant) into a file or into
the console. Print return value and duration for the test run into the
console.

A "repeat" argument can be passed to run the program several times in a
row.

The command does not perform any kind of verification based on program
type (Is this program type allowed to use an input context?) or on data
consistency (Can I work with empty input data?), this is left to the
kernel.

Example invocation:

    # perl -e 'print "\x0" x 14' | ./bpftool prog run \
            pinned /sys/fs/bpf/sample_ret0 \
            data_in - data_out - repeat 5
    0000000 0000 0000 0000 0000 0000 0000 0000      | ........ ......
    Return value: 0, duration (average): 260ns

When one of data_in or ctx_in is "-", bpftool reads from standard input,
in binary format. Other formats (JSON, hexdump) might be supported (via
an optional command line keyword like "data_fmt_in") in the future if
relevant, but this would require doing more parsing in bpftool.

v2:
- Fix argument names for function check_single_stdin(). (Yonghong)

Signed-off-by: Quentin Monnet <quentin.monnet@netronome.com>
Reviewed-by: Jakub Kicinski <jakub.kicinski@netronome.com>
Acked-by: Yonghong Song <yhs@fb.com>
Signed-off-by: Daniel Borkmann <daniel@iogearbox.net>
2019-07-05 23:48:07 +02:00
..
bpftool-btf.rst tools: bpftool: add -d option to get debug output from libbpf 2019-05-28 11:02:21 +02:00
bpftool-cgroup.rst bpftool: support cgroup sockopt 2019-06-27 15:25:17 -07:00
bpftool-feature.rst tools: bpftool: add -d option to get debug output from libbpf 2019-05-28 11:02:21 +02:00
bpftool-map.rst tools: bpftool: add -d option to get debug output from libbpf 2019-05-28 11:02:21 +02:00
bpftool-net.rst tools: bpftool: add -d option to get debug output from libbpf 2019-05-28 11:02:21 +02:00
bpftool-perf.rst tools: bpftool: add -d option to get debug output from libbpf 2019-05-28 11:02:21 +02:00
bpftool-prog.rst tools: bpftool: add "prog run" subcommand to test-run programs 2019-07-05 23:48:07 +02:00
bpftool.rst tools: bpftool: make -d option print debug output from verifier 2019-05-28 11:03:26 +02:00
Makefile treewide: Add SPDX license identifier - Makefile/Kconfig 2019-05-21 10:50:46 +02:00