This repository contains GitHub Actions workflows, scripts and test policy for Linux kernel BPF CI. It orchestrates kernel builds, BPF/sched_ext selftests, bpftool checks and veristat comparisons. Kernel source and the reusable VM launcher live in other repositories.
Kernel Patches Daemon (KPD) copies these CI files into kernel mirrors such as
kernel-patches/bpf, where patch-series PRs and base pushes execute them. PRs in
this repository validate changes using a downloaded kernel tree. The workflow
conditions and matrix determine which tests run in each context.
| Path | Purpose |
|---|---|
| .github/workflows | Entry points and reusable build/test/review workflows |
| .github/scripts | Matrix generation, runner placement and workflow helpers |
| ci/vmtest/configs | Kernel configs, selftest exclusions and kernel-splat policy |
| ci/veristat | Corpus preparation, measurement and baseline reporting |
| ci/diffs | Kernel patches applied before CI builds |
| ci/claude | AI review and investigation tooling |
Agents should read AGENTS.md before editing.
From the repository root, with Python 3 and Black installed:
python3 -m unittest ci/veristat/tests/*.py
black --check .Check changed shell scripts with Bash and the ShellCheck options in lint.yml, and validate workflow syntax and wiring. Changes to workflow execution, artifacts or baselines also need a GitHub Actions run; feature-branch pushes alone do not exercise all PR/base-push paths.
- kernel-patches/bpf: kernel mirror tracking upstream BPF trees.
- KPD: connects Patchwork with GitHub, reports CI results and sends notifications.
- libbpf/ci: reusable build/test actions and VM setup.
- kernel-patches/runner: runner images and setup.
- danobi/vmtest: QEMU-based VM launcher.
The tested kernel supplies BPF selftests and veristat and sched_ext selftests. The GCC BPF backend is tested separately.