Commit bcdacab6 authored by Michal Rostecki's avatar Michal Rostecki Committed by Daniel Borkmann

bpftool: Update documentation of "bpftool feature" command

Update documentation of "bpftool feature" command with information about
new arguments: "full".
Signed-off-by: default avatarMichal Rostecki <mrostecki@opensuse.org>
Signed-off-by: default avatarDaniel Borkmann <daniel@iogearbox.net>
Reviewed-by: default avatarQuentin Monnet <quentin@isovalent.com>
Link: https://lore.kernel.org/bpf/20200226165941.6379-4-mrostecki@opensuse.org
parent 368cb0e7
...@@ -19,19 +19,24 @@ SYNOPSIS ...@@ -19,19 +19,24 @@ SYNOPSIS
FEATURE COMMANDS FEATURE COMMANDS
================ ================
| **bpftool** **feature probe** [*COMPONENT*] [**macros** [**prefix** *PREFIX*]] | **bpftool** **feature probe** [*COMPONENT*] [**full**] [**macros** [**prefix** *PREFIX*]]
| **bpftool** **feature help** | **bpftool** **feature help**
| |
| *COMPONENT* := { **kernel** | **dev** *NAME* } | *COMPONENT* := { **kernel** | **dev** *NAME* }
DESCRIPTION DESCRIPTION
=========== ===========
**bpftool feature probe** [**kernel**] [**macros** [**prefix** *PREFIX*]] **bpftool feature probe** [**kernel**] [**full**] [**macros** [**prefix** *PREFIX*]]
Probe the running kernel and dump a number of eBPF-related Probe the running kernel and dump a number of eBPF-related
parameters, such as availability of the **bpf()** system call, parameters, such as availability of the **bpf()** system call,
JIT status, eBPF program types availability, eBPF helper JIT status, eBPF program types availability, eBPF helper
functions availability, and more. functions availability, and more.
By default, bpftool **does not run probes** for
**bpf_probe_write_user**\ () and **bpf_trace_printk**\()
helpers which print warnings to kernel logs. To enable them
and run all probes, the **full** keyword should be used.
If the **macros** keyword (but not the **-j** option) is If the **macros** keyword (but not the **-j** option) is
passed, a subset of the output is dumped as a list of passed, a subset of the output is dumped as a list of
**#define** macros that are ready to be included in a C **#define** macros that are ready to be included in a C
...@@ -44,16 +49,12 @@ DESCRIPTION ...@@ -44,16 +49,12 @@ DESCRIPTION
Keyword **kernel** can be omitted. If no probe target is Keyword **kernel** can be omitted. If no probe target is
specified, probing the kernel is the default behaviour. specified, probing the kernel is the default behaviour.
Note that when probed, some eBPF helpers (e.g. **bpftool feature probe dev** *NAME* [**full**] [**macros** [**prefix** *PREFIX*]]
**bpf_trace_printk**\ () or **bpf_probe_write_user**\ ()) may
print warnings to kernel logs.
**bpftool feature probe dev** *NAME* [**macros** [**prefix** *PREFIX*]]
Probe network device for supported eBPF features and dump Probe network device for supported eBPF features and dump
results to the console. results to the console.
The two keywords **macros** and **prefix** have the same The keywords **full**, **macros** and **prefix** have the
role as when probing the kernel. same role as when probing the kernel.
**bpftool feature help** **bpftool feature help**
Print short help message. Print short help message.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment