mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-05-03 12:24:37 -04:00
c8caa0bb4b
Bring minor improvements to bpftool documentation. Fix or harmonise
formatting, update map types (including in interactive help), improve
description for "map create", fix a build warning due to a missing line
after the double-colon for the "bpftool prog profile" example,
complete/harmonise/sort the list of related bpftool man pages in
footers.
v2:
- Remove (instead of changing) mark-up on "value" in bpftool-map.rst,
when it does not refer to something passed on the command line.
- Fix an additional typo ("hexadeximal") in the same file.
Signed-off-by: Quentin Monnet <quentin@isovalent.com>
Signed-off-by: Daniel Borkmann <daniel@iogearbox.net>
Link: https://lore.kernel.org/bpf/20200511161536.29853-3-quentin@isovalent.com
122 lines
2.8 KiB
ReStructuredText
122 lines
2.8 KiB
ReStructuredText
================
|
|
bpftool-link
|
|
================
|
|
-------------------------------------------------------------------------------
|
|
tool for inspection and simple manipulation of eBPF links
|
|
-------------------------------------------------------------------------------
|
|
|
|
:Manual section: 8
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
**bpftool** [*OPTIONS*] **link** *COMMAND*
|
|
|
|
*OPTIONS* := { { **-j** | **--json** } [{ **-p** | **--pretty** }] | { **-f** | **--bpffs** } }
|
|
|
|
*COMMANDS* := { **show** | **list** | **pin** | **help** }
|
|
|
|
LINK COMMANDS
|
|
=============
|
|
|
|
| **bpftool** **link { show | list }** [*LINK*]
|
|
| **bpftool** **link pin** *LINK* *FILE*
|
|
| **bpftool** **link help**
|
|
|
|
|
| *LINK* := { **id** *LINK_ID* | **pinned** *FILE* }
|
|
|
|
|
|
DESCRIPTION
|
|
===========
|
|
**bpftool link { show | list }** [*LINK*]
|
|
Show information about active links. If *LINK* is
|
|
specified show information only about given link,
|
|
otherwise list all links currently active on the system.
|
|
|
|
Output will start with link ID followed by link type and
|
|
zero or more named attributes, some of which depend on type
|
|
of link.
|
|
|
|
**bpftool link pin** *LINK* *FILE*
|
|
Pin link *LINK* as *FILE*.
|
|
|
|
Note: *FILE* must be located in *bpffs* mount. It must not
|
|
contain a dot character ('.'), which is reserved for future
|
|
extensions of *bpffs*.
|
|
|
|
**bpftool link help**
|
|
Print short help message.
|
|
|
|
OPTIONS
|
|
=======
|
|
-h, --help
|
|
Print short generic help message (similar to **bpftool help**).
|
|
|
|
-V, --version
|
|
Print version number (similar to **bpftool version**).
|
|
|
|
-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**.
|
|
|
|
-f, --bpffs
|
|
When showing BPF links, show file names of pinned
|
|
links.
|
|
|
|
-n, --nomount
|
|
Do not automatically attempt to mount any virtual file system
|
|
(such as tracefs or BPF virtual file system) when necessary.
|
|
|
|
-d, --debug
|
|
Print all logs available, even debug-level information. This
|
|
includes logs from libbpf.
|
|
|
|
EXAMPLES
|
|
========
|
|
**# bpftool link show**
|
|
|
|
::
|
|
|
|
10: cgroup prog 25
|
|
cgroup_id 614 attach_type egress
|
|
|
|
**# bpftool --json --pretty link show**
|
|
|
|
::
|
|
|
|
[{
|
|
"type": "cgroup",
|
|
"prog_id": 25,
|
|
"cgroup_id": 614,
|
|
"attach_type": "egress"
|
|
}
|
|
]
|
|
|
|
|
|
|
| **# bpftool link pin id 10 /sys/fs/bpf/link**
|
|
| **# ls -l /sys/fs/bpf/**
|
|
|
|
::
|
|
|
|
-rw------- 1 root root 0 Apr 23 21:39 link
|
|
|
|
|
|
SEE ALSO
|
|
========
|
|
**bpf**\ (2),
|
|
**bpf-helpers**\ (7),
|
|
**bpftool**\ (8),
|
|
**bpftool-btf**\ (8),
|
|
**bpftool-cgroup**\ (8),
|
|
**bpftool-feature**\ (8),
|
|
**bpftool-gen**\ (8),
|
|
**bpftool-iter**\ (8),
|
|
**bpftool-map**\ (8),
|
|
**bpftool-net**\ (8),
|
|
**bpftool-perf**\ (8),
|
|
**bpftool-prog**\ (8),
|
|
**bpftool-struct_ops**\ (8)
|