Januscape — Tracking-Website für den Linux-KVM/x86-Guest-to-Host-Escape

Quellcode für den Januscape-Patch-Status-Tracker: eine einseitige Website, die verzeichnet, welche Distributionen einen Fix für den KVM/x86-Guest-to-Host-Escape im Linux-Kernel ausgeliefert haben.

Wo die Fakten zu finden sind

Alles über den Bug — CVE-IDs, betroffene und behobene Versionen, Upstream-Fix-Commits, Credits für Entdeckung und Offenlegung sowie der aktuelle Patch-Status pro Distribution — gehört zur Tracker-Seite, nicht zu dieser README:

• Gerendert: https://kimmo.cloud/januscape/
• Quelle: site/content/_index.md

Bearbeite diese Datei; alles andere in diesem Repository ist Build-Infrastruktur.

Keines davon wird hier absichtlich wiederholt. Die Tracker-Seite wird überarbeitet, sobald CVEs vergeben werden und Distributionen Fixes ausliefern — bei den aktiv aktualisierten Trackern zweimal täglich durch den Auto-Update-Agent — daher würde jede in dieser README festgehaltene Kopie still vor sich hin veralten. Widerstehe der Versuchung, eine Zusammenfassung erneut hinzuzufügen.

Der Deployment-Plan und der aktuelle Einrichtungszustand befinden sich in WEBSITE.md.

Lokale Entwicklung

Erfordert Hugo extended (≥ 0.146.0) und Go (damit Hugo Modules das PaperMod-Theme abrufen können).

Mit Nix (empfohlen)

nix develop          # dev shell: hugo, go, git, resvg
cd site
hugo server          # local preview at http://localhost:1313/januscape/

Wenn du direnv verwendest, führe einmal direnv allow aus, und die Dev-Shell aktiviert sich automatisch, sobald du in das Repository cd-st.

Ohne Nix

Installiere Hugo extended ≥ 0.146.0 und Go ≥ 1.24 selbst und führe dann Folgendes aus:

cd site
hugo server          # http://localhost:1313/januscape/

Build und Veröffentlichung

make build       # local build into site/public/
make dist        # build, then rsync to haig:/januscape/
make banner      # re-rasterise the social banner SVG → PNG (needs resvg + Roboto)

make dist führt zuerst make build aus. make banner wird nur nach dem Bearbeiten von site/assets/januscape-tracker.svg benötigt; das gerenderte PNG ist eingecheckt.

Repository-Struktur

.
├── flake.nix              # Nix dev environment (hugo, go, git, resvg + RPM tools)
├── .envrc                 # direnv hook → `use flake`
├── .gitignore
├── Makefile               # `make build`, `make dist`, `make banner`
├── LICENSE                # CC BY 4.0
├── README.md              # this file
├── CLAUDE.md              # project instructions for Claude Code
├── WEBSITE.md             # publication plan / decisions log
├── scripts/               # auto-update agent: prompt + driver
├── systemd/               # user-level timer + service units
└── site/                  # Hugo project
    ├── hugo.toml
    ├── content/
    │   └── _index.md      # the tracker (single page)
    ├── assets/css/extended/custom.css   # PaperMod CSS overrides
    ├── assets/januscape-tracker.svg     # social-banner source (→ make banner)
    ├── static/januscape-tracker.png     # rendered OpenGraph banner (committed)
    ├── layouts/partials/  # PaperMod overrides (post_meta, extend_footer)
    ├── go.mod, go.sum     # Hugo Modules — pulls PaperMod theme
    └── …                  # standard Hugo skeleton

Lizenz

CC BY 4.0 — teilen und bearbeiten mit Namensnennung.