From 8510e3345480cd2f8f374678eb930ac0d17eff80 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Sun, 15 Nov 2026 11:16:07 +0100 Subject: [PATCH] Document explicit active KVM clock trust proposal for user decision --- docs/windows-kvm-clock-contract-proposal.md | 45 +++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/windows-kvm-clock-contract-proposal.md diff --git a/docs/windows-kvm-clock-contract-proposal.md b/docs/windows-kvm-clock-contract-proposal.md new file mode 100644 index 0000000..e279f44 --- /dev/null +++ b/docs/windows-kvm-clock-contract-proposal.md @@ -0,0 +1,45 @@ +# Windows auf KVM: konkreter Zeitvertrag zur Entscheidung + +Stand2026-11-15. **Vorschlag, nicht angenommen oder aktiviert.** Ergänzt die [Kalibrierungsbewertung](windows-signed-clock-calibration-assessment.md) für die inzwischen identifizierte Plattform. Kein Kalibrierungswert, keine VM-/Konfigurationsänderung und kein Gatewechsel. Der konservative [Frischefix](time-attestation-freshness-results.md) ist ein getrennter bereits implementierter Quellschritt. + +## Bestätigte Plattform und Recherchegrenze + +Root hat mit ausdrücklich erlaubten lesenden Hostabfragen `qemu:///system`, die laufende Domäne `win11-test`, KVM/QEMU6.2.0 und libvirt8.0 bestätigt. Gemeldet sind `pc-q35-6.2`, `host-passthrough` mit `migratable=on`, RTC-Lokalzeitoffset/`catchup`, PIT-`delay`, HPET aus und Hyper-V-Clock an. Die Hyper-V-Konfiguration enthält relaxed/vapic/spinlocks; im XML steht keine VMGenID. Diese Angaben stammen aus Roots tatsächlichem Nachweis, nicht aus einer hier nochmals ausgeführten Hostabfrage. Ganze XML-/VNC-/Schlüsselkonfigurationen wurden hier nicht gelesen. Keine QMP-Abfrage oder zusätzliche VM-Erhebung war für die fehlende numerische Zusicherung nötig. + +## Was die passenden Primärquellen zusichern + +Die **QEMU6.2.0**-Dokumentation beschreibt `hv-time` als Bereitstellung von Hyper-V-Referenzzähler und Reference-TSC-Seite je Gast. Das ist ein Schnittstellen-/Performancevertrag, keine numerische SI-Fehlerschranke. Die dort beschriebene Migration/Re-enlightenment-Unterstützung hängt zusätzlich von TSC-Frequenz/-Skalierung ab. `hv-relaxed` beeinflusst Watchdogverhalten und ist keine Genauigkeitsqualifikation. [QEMU6.2.0, ursprüngliche Hyper-V-Dokumentation](https://raw.githubusercontent.com/qemu/qemu/v6.2.0/docs/hyperv.txt). + +KVMs PVclock-Vertrag definiert Hostmonotonie einschließlich Schlafzeit, Umrechnung aus TSC und optionale Stable-/Pausedflags. Er gibt keinen universellen maximalen relativen Frequenzfehler für diesen Host vor. Er beschreibt zudem eine andere verfügbare Schnittstelle; daraus folgt nicht, welchen internen Pfad Windows tatsächlich für alle drei Precise-Getter gewählt hat. [KVM-MSR-Vertrag](https://docs.kernel.org/virt/kvm/x86/msr.html). + +Die KVM-Zeitvirtualisierungsdokumentation behandelt Hardware-/Frequenz-/Virtualisierungsrisiken und nötige stabile Referenzen. Eine konfigurierte virtuelle Zeitquelle ersetzt keinen konkret belegten numerischen Fehlerbound. [Linux-KVM: Timekeeping Virtualization](https://docs.kernel.org/virt/kvm/x86/timekeeping.html). + +libvirt warnt bei `host-passthrough` vor Migration zwischen unterschiedlichen Plattformen; `migratable=on` beseitigt dieses Risiko ausdrücklich nicht. Timer-Tickpolicies beschreiben den Umgang mit verzögerten Ticks, keine physikalische Genauigkeitsgarantie. [libvirt: CPU model and topology / Time keeping](https://www.libvirt.org/formatdomain.html). + +Die Microsoft-Unterscheidung zwischen OS-Zeitdarstellung, Auflösung und tatsächlicher Frequenzgenauigkeit bleibt damit relevant. Die für Gäste vorausgesetzte korrekte Hypervisorimplementierung ist eine Vertrauensannahme, kein automatisch gewonnener numerischer Kalibrierungswert. [Microsoft: Acquiring high-resolution time stamps](https://learn.microsoft.com/en-us/windows/win32/sysinfo/acquiring-high-resolution-time-stamps). + +**Ergebnis:** Auch dieses konkretisierte Profil liefert keinen harten numerischen `base_error_ns`. Weder „Hyper-V-Clock an“, ein CPU-Featureflag, nominelle Frequenz noch die128 tatsächlichen Roh-Captures rechtfertigen eine erfundene Zahl. Eine weitere QMP-CPU-Modellexpansion könnte Verfügbarkeit beschreiben; sie würde die physikalische Fehlerschranke nicht liefern. Eine Aussage über tatsächlich vorliegende Hardwaregenauigkeit, alle Hostpatches oder den gewählten Windowsinternen Getterpfad wurde hier nicht behauptet. + +## Kleinster expliziter MVP-Vorschlag + +Der bisherige Vertrag bleibt ohne Entscheidung unverändert gesperrt. Für einen praxistauglichen, klar begrenzten MVP wäre als **neue ausdrückliche Produktentscheidung** folgendes Profil möglich: + +> Für diese Windows-KVM-Testumgebung vertraue ich den dokumentierten Windows-Zeit-APIs und einer korrekt laufenden Hardware-/KVM-/QEMU-Zeitbasis als nomineller Intervalluhr. Eine zusätzliche unabhängige physikalische Frequenzkalibrierung ist für dieses Profil keine Voraussetzung. Die tatsächlichen Software-Capturebrackets bleiben begrenzt und werden konservativ gerechnet. Die UTC-Qualifikation kommt weiterhin ausschließlich vom getrennt signierten, tatsächlich qualifizierten Server. Dieses Profil gilt nur im aktiven Betrieb ohne VM-Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend. Solche Betriebsereignisse sind während laufender Agent-/Helperprozesse nicht unterstützt. Vor einem erneuten Betrieb nach einem solchen Ereignis sind beide Prozesse zu beenden und frisch zu starten; eigene neue Challenges und normaler unabhängiger Sync bleiben Pflicht. Keine dieser Maßnahmen erfolgt durch die vorliegende Entscheidung automatisch. + +Diese Zustimmung wäre bewusst **keine Behauptung gemessener physikalischer Genauigkeit**. Der Fehlervertrag würde explizit auf dem Vertrauen in die korrekte nominelle OS-/Hardware-/Hypervisor-Zeitskala beruhen. Das ist eine gegenüber der bisher zusätzlich verlangten unabhängig numerisch qualifizierten Timerschranke geänderte Annahme und braucht die Entscheidung des Users. Eine reine Betriebszusage „kein Suspend“ allein löst den numerischen Nachweis nicht. + +Der genehmigte Plan, WebUI-Genehmigung, unabhängiger SYSTEM-Helper, Geräte-/Tenantbindung, CSPRNG-Nonces, Boot-/Prozess-/Connectionfences, tatsächliche Serverqualität, vollständiges UTC-Intervall, maximale1s/100ms-Frische und50ms-Softwarecapturebudget bleiben erhalten. Ihre physikalische Konservativität wäre ausdrücklich **bedingt durch diese angenommene korrekte OS-Zeitskala**; das Profil darf sie nicht als unabhängig nachgemessene SI-Garantie darstellen. Beobachtete Rückwärts-/Schlaf-/Wallstepdiskontinuitäten bleiben sperrend. Ohne VMGenID wird keine lückenlose automatische Erkennung eines gespeicherten und wiederhergestellten laufenden Gastzustands behauptet. + +## Nötiger enger Implementierungsschnitt nach einer Zustimmung + +Ein solches Profil darf nicht durch Eintragen einer beliebigen positiven Zahl in das heutige `Calibration.base_error_ns` vorgetäuscht werden. Die geschützte Windows-Zeitkonfiguration müsste es als eigenen versionierten Qualifikationsmodus ausweisen, etwa `trusted_os_active_guest`, statt „physikalisch kalibriert“. Rollen-/Imagehash, tatsächliche Plattform-/Rohbelegreferenz und Betriebsannahmen müssen gebunden sein. Die vorhandene Konfiguration darf diesen neuen Modus nicht ohne explizite Version/Opt-in akzeptieren. Es gibt keinen automatischen Producer oder aktuell ausgerechneten Installationswert. + +Unter diesem Modus würde der Code nur die tatsächlich eigenen vollständigen Capturebrackets und exakte ganzzahlige Umrechnung im vertrauten OS-Zählerraum budgetieren; eine nicht nachgewiesene Restunsicherheit dürfte nicht als gemessene Konstante hinzugefügt werden. Das verändert den bisherigen Loadervertrag und benötigt deshalb Quellreview und neue Linux-first-/Windows-Nachweise. Ob und wie ein nachweisbarer diskreter/API-Zuordnungsrest als eigener Term nötig ist, muss dabei gegen den explizit angenommenen OS-API-Vertrag geprüft werden. Eine körperliche Genauigkeit folgt nicht aus100ns-Darstellung. Bis zur Entscheidung und dieser Prüfung wird kein Konfigurationsfile erzeugt und kein Codepfad geöffnet. + +Wer den bisherigen unabhängig numerischen Vertrag beibehalten möchte, braucht stattdessen einen passenden Hersteller-/Plattformfehlervertrag oder eine unabhängige Referenzqualifikation mit ausdrücklich begrenzter Stabilität und Gültigkeit. Dieser Nachweis liegt derzeit weiterhin nicht vor; zusätzliche interne Samples ersetzen ihn nicht. + +## Konkrete Entscheidungsfrage für den User + +„Darf ich für unsere aktive Windows-KVM-Test-VM ein ausdrücklich gekennzeichnetes Profil verwenden, das den dokumentierten Windows-/KVM-Zeit-APIs vertraut und keine unabhängige physikalische Timerkalibrierung behauptet? Pause, Save/Restore, Snapshot-Rückkehr, Migration und Host-Suspend sind dabei mit laufenden Agent-/Helperprozessen nicht unterstützt. Signierter Serververgleich, kurze Fristen, getrennte Helperprüfung und jede WebUI-Jobgenehmigung bleiben bestehen. Erst nach deiner Entscheidung würde ich den engen Profilvertrag implementieren und real abnehmen; aktuell bleibt alles geschlossen.“ + +Tatsächlich ausgeführt wurde in diesem Schritt ausschließlich die Prüfung der passenden Primärquellen und das Erstellen dieses Vorschlags. Keine eigene virsh-/QMP-/VM-Aktion, kein Build, keine Gitaktion und keine Änderung am eingefrorenen passiven Paarcontroller `bea5384c…`.