1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
bpftool
=======
This is a mirror of [bpf-next Linux source tree's
`tools/bpf/bpftool`](https://git.kernel.org/pub/scm/linux/kernel/git/bpf/bpf-next.git/tree/tools/bpf/bpftool)
directory, plus its few dependencies from under `kernel/bpf/`, and its
supporting header files.
All the gory details of syncing can be found in `scripts/sync-kernel.sh`
script.
Some header files in this repo (`include/linux/*.h`) are reduced versions of
their counterpart files at
[bpf-next](https://git.kernel.org/pub/scm/linux/kernel/git/bpf/bpf-next.git/)'s
`tools/include/linux/*.h` to make compilation successful.
BPF/bpftool usage and questions
-------------------------------
Please check out [the manual pages](docs) for documentation about bpftool. A
number of example invocations are also displayed in [this blog
post](https://qmonnet.github.io/whirl-offload/2021/09/23/bpftool-features-thread/).
All general BPF questions, including kernel functionality, bpftool features and
usage, should be sent to bpf@vger.kernel.org mailing list. You can subscribe to
it [here](http://vger.kernel.org/vger-lists.html#bpf) and search its archive
[here](https://lore.kernel.org/bpf/). Please search the archive before asking
new questions. It very well might be that this was already addressed or
answered before.
bpf@vger.kernel.org is monitored by many more people and they will happily try
to help you with whatever issue you have. This repository's PRs and issues
should be opened only for dealing with issues pertaining to specific way this
bpftool mirror repo is set up and organized.
Dependencies
------------
Required:
- libelf
- zlib
Optional:
- libbfd (for dumping JIT-compiled program instructions)
- libcap (for better feature probing)
- kernel BTF information (for profiling programs or showing PIDs of processes
referencing BPF objects)
- clang/LLVM (idem)
Build
[](https://github.com/libbpf/bpftool/actions/workflows/build.yaml)
-----
### Initialize libbpf submodule
This repository uses libbpf as a submodule. You can initialize it when cloning
bpftool:
```console
$ git clone --recurse-submodules https://github.com/libbpf/bpftool.git
```
Alternatively, if you have already cloned the repository, you can initialize
the submodule by running the following command from within the repository:
```console
$ git submodule update --init
```
### Build bpftool
To build bpftool:
```console
$ cd src
$ make
```
To build and install bpftool on the system:
```console
$ cd src
# make install
```
Building bpftool in a separate directory is supported via the `OUTPUT` variable:
```console
$ mkdir /tmp/bpftool
$ cd src
$ OUTPUT=/tmp/bpftool make
```
Most of the output is suppressed by default, but detailed building logs can be
displayed by passing `V=1`:
```console
$ cd src
$ make V=1
```
Additional compilation flags can be passed to the command line if required. For
example, we can create a static build with the following commands:
```console
$ cd src
$ EXTRA_CFLAGS=--static make
```
Note that to use the LLVM disassembler with static builds, we need a static
version of the LLVM library installed on the system:
1. Download a precompiled LLVM release or build it locally.
- Download the appropriate
[release of LLVM](https://releases.llvm.org/download.html) for your
platform, for example on x86_64 with LLVM 15.0.0:
```console
$ curl -LO https://github.com/llvm/llvm-project/releases/download/llvmorg-15.0.0/clang+llvm-15.0.0-x86_64-linux-gnu-rhel-8.4.tar.xz
$ tar xvf clang+llvm-15.0.0-x86_64-linux-gnu-rhel-8.4.tar.xz
$ mv clang+llvm-15.0.0-x86_64-linux-gnu-rhel-8.4 llvm_build
```
- Alternatively, clone and build the LLVM libraries locally.
```console
$ git clone https://github.com/llvm/llvm-project.git
$ mkdir llvm_build
$ cmake -S llvm-project/llvm -B llvm_build -DCMAKE_BUILD_TYPE=Release
$ make -j -C llvm_build llvm-config llvm-libraries
```
2. Build bpftool with `EXTRA_CFLAGS` set to `--static`, and by passing the
path to the relevant `llvm-config`.
```console
$ cd bpftool
$ LLVM_CONFIG=../../llvm_build/bin/llvm-config EXTRA_CFLAGS=--static make -j -C src
```
### Build bpftool's man pages
The man pages for bpftool can be built with:
```console
$ cd docs
$ make
```
They can be installed on the system with:
```console
$ cd docs
# make install
```
License
-------
This work is dual-licensed under the GNU GPL v2.0 (only) license and the
BSD 2-clause license. You can choose between one of them if you use this work.
`SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)`
|
