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
|
# Dependency support policy
This document outlines our policy for supporting bpftrace's major dependencies.
Our support policy for minor dependencies are done on a case by case basis,
usually at distro/user request.
## Linux kernel
**Minimum kernel version: 5.15**
The linux kernel is bpftrace's biggest runtime dependency.
While we would like to support the oldest LTS kernel version, we also want to make
sure bpftrace is keeping up with the latest features. As a compromise bpftrace
supports stable kernels and the 4 most recent LTS kernels. Users that require support on older kernels can often simply use [older versions of bpftrace](https://github.com/bpftrace/bpftrace/releases).
The source of truth on EOL dates and LTS kernels is https://www.kernel.org/.
For features that have clear boundaries (eg. new builtins or helpers), bpftrace
is free to opportunistically depend on newer kernels as long as there is a
reasonable runtime fallback strategy or detailed error message.
## LLVM (dynamically linked)
LLVM is bpftrace's biggest build time dependency. The project always supports
the latest LLVM release as soon as it's practical (available in CI). We support
some number of previous LLVM releases. Given LLVM's twice annual release
cadence, we have historically supported somewhere around the last 3 years'
worth. We do not provide a hard guarantee, but it's probably safe to the
versions from the previous year will be supported.
## LLVM (statically linked)
In contrast to dynamically linked LLVM, statically linked LLVM is significantly
more difficult to maintain. As a consequence, we only support a single LLVM
release in the static build configuration.
We do not yet have a policy on when the LLVM version is updated, but we will
document any changes in the release notes.
Please consult [static.sh][0] for the source of truth.
[0]: https://github.com/bpftrace/bpftrace/blob/master/.github/include/static.sh
|
