- Shell 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FkTwGF7p9eULDs8m4Li21a |
||
| .forgejo/workflows | ||
| patches | ||
| scripts | ||
| .gitignore | ||
| PKG_REVISION | ||
| README.md | ||
ubuntu-pmtu-patch
Gepatchte geneve- und vxlan-Module für den Ubuntu-26.04-Kernel (resolute, Flavour generic).
Problem
Seit der Bridged-PMTUD in skb_tunnel_check_pmtu() schicken VXLAN-/Geneve-Ports an einer Bridge selbst ICMP „Fragmentation needed" bzw. ICMPv6 „Packet too big" an die Inner-Hosts. Das passiert auch dann, wenn das Outer-DF-Bit gar nicht gesetzt ist und das Outer-Paket problemlos fragmentiert werden könnte. Minimale TCP-Stacks (ESP32, Arduino, lwIP und Co.) setzen DF, kommen mit diesen ICMPs aber nicht klar und hängen dann.
Was der Patch macht
Der Patch steht unter patches/. Beide Treiber bekommen einen Helper, über den der PMTU-Check läuft. Bei Geneve wird das Outer-DF jetzt vor dem Check bestimmt (geneve_get_df()). Das Verhalten steuern zwei Modulparameter, getrennt pro Modul:
| Parameter | Werte | Wirkung bei Outer-DF = 0 (IPv4-Underlay) |
|---|---|---|
pmtud_mode |
0 |
Upstream-Verhalten, PMTUD immer aktiv |
1 (Default) |
keine ICMP-Replies an Bridge-Ports; die Inner-PMTU wird weiter aktualisiert | |
2 |
PMTU-Check komplett überspringen, analog zu ip_tunnel mit DF=0 |
|
pmtud_ipv6_frag |
N (Default) |
IPv6-Underlay wie upstream (IPv6 kennt kein DF) |
Y |
IPv6-Underlay wird wie DF=0 behandelt, das Outer-IPv6 wird lokal fragmentiert (ignore_df). Experimentell. |
Ist das Outer-DF gesetzt (df set, df inherit mit DF-Inner, oder collect_md mit DF-Flag), bleibt alles wie upstream.
Damit der Patch greift, muss das Outer-DF auf dem Tunnel aus sein:
ip link add gnv0 type geneve id 100 remote 192.0.2.1 df unset # Default
ip link add vx0 type vxlan id 100 remote 192.0.2.1 dstport 4789 df unset
Parameter zur Laufzeit ändern bzw. dauerhaft setzen:
echo 2 > /sys/module/geneve/parameters/pmtud_mode
echo "options geneve pmtud_mode=1" > /etc/modprobe.d/pmtud-tunnels.conf
echo "options vxlan pmtud_mode=1" >> /etc/modprobe.d/pmtud-tunnels.conf
Pakete
Die CI baut pro Ubuntu-Kernel-ABI fertige Module, ganz ohne DKMS auf den Zielhosts:
pmtud-tunnels-modules-<abi>-generic: die Module unter/lib/modules/<abi>-generic/updates/pmtud-tunnels/. Übersearch updates ubuntu built-inin/etc/depmod.d/ubuntu.confhaben sie Vorrang vor den Stock-Modulen.pmtud-tunnels-generic: ein Metapaket, das immer auf die neueste ABI zeigt.
Kommt ein neuer Ubuntu-Kernel, bevor die CI das passende Paket gebaut hat, lädt dieser Kernel einfach die Stock-Module. Er bootet also ungepatcht, aber funktionsfähig.
Die Paketversion lautet <ubuntu-kernel-version>+pmtu<PKG_REVISION>, z.B. 7.0.0-38.38+pmtu1.
Auf einem Host einbinden
sudo curl -fsSL https://git.bocc.de/api/packages/jochen/debian/repository.key \
-o /etc/apt/keyrings/forgejo-jochen.asc
echo "deb [signed-by=/etc/apt/keyrings/forgejo-jochen.asc] https://git.bocc.de/api/packages/jochen/debian resolute main" \
| sudo tee /etc/apt/sources.list.d/pmtud-tunnels.list
# Bei privatem Account/Registry zusätzlich:
printf 'machine git.bocc.de\nlogin jochen\npassword <read:package-Token>\n' \
| sudo tee /etc/apt/auth.conf.d/forgejo.conf && sudo chmod 600 /etc/apt/auth.conf.d/forgejo.conf
sudo apt update && sudo apt install pmtud-tunnels-generic
Danach bei aktiven Tunneln die Module neu laden (modprobe -r vxlan geneve) oder neu starten. Prüfen lässt sich das Ergebnis mit:
modinfo -F filename geneve vxlan # .../updates/pmtud-tunnels/...
cat /sys/module/geneve/parameters/pmtud_mode
CI (.forgejo/workflows/build.yml)
Die CI läuft täglich, bei Push auf main (Patches, Skripte, PKG_REVISION) und manuell. Ein Lauf:
- ermittelt im Container
ubuntu:26.04die neueste Version vonlinux-headers-generic(scripts/resolve.sh), - bricht ab, wenn genau diese Paketversion schon in der Registry liegt,
- holt
drivers/net/geneve.cunddrivers/net/vxlan/auslinux_<upstream>.orig.tar.gzundlinux_<ver>.diff.gzim Ubuntu-Archiv. Das Ergebnis ist identisch mit dem TagUbuntu-<ver>im Ubuntu-Kernel-Git, und der Download geht schnell und zuverlässig; ein voller Klon von Launchpad bricht oft ab. Alternativ gehtSOURCE=git. Danach werden die Patches angewendet, strikt ohne Fuzz. Schlägt das fehl, wird der Build rot. - prüft, dass es pro Treiber nur noch genau einen Aufruf von
skb_tunnel_check_pmtu()gibt, nämlich im Helper. So fällt eine neue Aufrufstelle in Ubuntu/upstream sofort auf. - baut gegen
linux-headers-<abi>-genericmit derselben GCC-Hauptversion wie der Kernel, prüft vermagic und Parameter, signiert optional und paketiert, - lädt die Pakete in die Forgejo-Debian-Registry hoch.
Manuell lässt sich mit kernel_version eine bestimmte Version bauen. force baut neu, auch wenn die Version schon veröffentlicht ist. Ein Upload derselben Version wird von der Registry allerdings abgelehnt (409), also für einen echten Neubau PKG_REVISION erhöhen.
Benötigte Secrets (Repo → Einstellungen → Actions → Secrets)
| Secret | Pflicht | Inhalt |
|---|---|---|
REPO_REGISTRY_TOKEN |
ja | Access-Token mit Scope write:package für die Registry von jochen. Fehlt es, schlagen geplante und Push-Läufe fehl; nur ein manueller Lauf baut dann ohne Upload. |
MODSIGN_KEY |
nein | PEM-Private-Key zum Signieren der Module (Secure Boot) |
MODSIGN_CERT |
nein | dazugehöriges Zertifikat (PEM) |
Der Job läuft auf dem Runner mit Label podman (wie in deinen anderen Repos) und startet den eigentlichen Build per podman run in ubuntu:26.04 (scripts/ci.sh). Der Runner-Host braucht also podman und Zugriff auf docker.io und archive.ubuntu.com/security.ubuntu.com.
Secure Boot
Ohne Signatur verweigert ein Kernel mit aktivem Secure Boot (Lockdown) das Laden der Module. Einmalig einen Schlüssel erzeugen, als Secrets hinterlegen und auf jedem Host per MOK enrollen:
openssl req -new -x509 -newkey rsa:4096 -nodes -days 3650 \
-subj "/CN=pmtud-tunnels module signing/" \
-addext "extendedKeyUsage=1.3.6.1.4.1.2312.16.1.2" \
-keyout modsign.key -out modsign.crt
openssl x509 -in modsign.crt -outform DER -out modsign.der
sudo mokutil --import modsign.der # Passwort setzen, beim Reboot im MOK-Manager bestätigen
Lokal bauen
Das geht in einem Ubuntu-26.04-System oder -Container als root:
apt-get install -y git ca-certificates curl make kmod dpkg-dev
bash scripts/build.sh "$(bash scripts/resolve.sh)" # oder z.B. 7.0.0-38.38
ls out/
Patch ändern
patches/*.diff sind git diff-Dateien gegen den Ubuntu-Kernelbaum (-p1). Nach einer Änderung PKG_REVISION erhöhen. Bricht ein neuer Ubuntu-Tag das Anwenden, den Patch gegen diesen Tag rebasen.
Grenzen
- Gebaut wird nur
amd64und der Flavourgeneric. HWE-,lowlatency- und Cloud-Kernel kommen aus anderen Source-Paketen und Git-Bäumen. - Ubuntu bringt im VXLAN-Treiber den Fan-Patch mit. Deshalb stammen die Quellen bewusst aus dem Ubuntu-Tag und nicht aus upstream.
- Die Build-Warnung „compiler differs" ist kosmetisch: Es ist derselbe GCC unter anderem Namen. BTF wird für die Module übersprungen, weil die Header-Pakete kein
vmlinuxenthalten. Das betrifft nur BPF-Tracing auf Modultypen. pmtud_ipv6_frag=Yist ungetestet.