From bcbca0e769901f0203540d5293af3d2c9329cc55 Mon Sep 17 00:00:00 2001 From: Mauro Ezequiel Moltrasio Date: Mon, 19 Jan 2026 12:38:42 +0100 Subject: [PATCH] docs: add kernel-support documentation A basic kernel-support.md file is added to the docs section to show what versions `fact` is expected to work on. --- docs/kernel-support.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/kernel-support.md diff --git a/docs/kernel-support.md b/docs/kernel-support.md new file mode 100644 index 0000000..4f2e682 --- /dev/null +++ b/docs/kernel-support.md @@ -0,0 +1,25 @@ +# `fact` kernel support + +At its current stage, `fact` uses features in the kernel that are quite +new in order to make development easier and faster at the cost of some +diminished compatibility. At a bare minimum, the kernel `fact` runs on +needs: +- Access to [BTF symbols](https://docs.ebpf.io/concepts/btf/) for + relocation. +- BPF support for [LSM hooks](https://docs.ebpf.io/linux/program-type/BPF_PROG_TYPE_LSM/), + which might need to be enabled at boot time. +- Support for [BPF trampolines](https://docs.ebpf.io/linux/concepts/trampolines/), + since this is how LSM hooks are attached. +- Support for some newer BPF helpers and features like `bpf_loop`, + `BPF_MAP_TYPE_RINGBUF`, etc. + +Nailing down a specific list of kernels `fact` supports at this time is +difficult, but the following distributions are actively tested against +and expected to work on: + +| Distro Name | Versions | Architecture | +|---|---|---| +| Fedora CoreOS | 43 | amd64, arm64 | +| RHCOS | 4.16+ | amd64 | +| RHEL | 9.6+, 10.0+ | amd64 | +| RHEL | 10.0+ | arm64 |