Files
rust-discovery/docs/server-time-source.md
T
2026-11-14 23:39:41 +01:00

178 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Nativer Linux-Zeitprovider: Quellencheckpoint
Der neue Quellpfad `crates/time-source-linux` beobachtet eine fest provisionierte
Chrony-Instanz und den Linux-Kernel lesend. Er ist weder eine Zeitstellung noch
ein Jobgrant. Dieser Stand ist implementierter, lokal geprüfter, noch nicht nativ
qualifizierter Quellcode. Es wurde durch diesen Implementierungsauftrag keine tatsächliche
Chrony-Abfrage, Provisionierung, Dienstaktion oder VM-Änderung ausgeführt.
Die tatsächlichen lokalen Dockerprüfungen sind unten getrennt dokumentiert.
Der Codec-Nachweis ersetzt diesen Providernachweis nicht.
`NativeTimeSource::open()` benötigt einen engen Root-Brokerprozess. Der
unprivilegierte Anwendungsserver wird dadurch nicht zu Root. Die Runtime-
Brokerintegration und die getrennte Zeit-Signierschlüsselprovisionierung sind
separate Arbeitspakete. `sample()` liefert ausschließlich nach erfolgreicher
authentisierter Beobachtung einen privat konstruierten `QualifiedSample`.
UTC, Fehlerobergrenze, tatsächliches Referenzalter, Boot-ID sowie Monoton-/
Boottime-Erfassungszeiten sind lesbar; Caller können keine Qualifikation per
Boolean oder eigenem Konstruktor erzeugen. Der Broker muss Zeit bis zum
Signieren konservativ ergänzen, Frische und Boot erneut prüfen und den
Sourcezustand ohne Holdover verwenden. Dieser Typ allein autorisiert keinen
HTTP-Aufrufer und keine Agentaktion.
## Festes Provisionierungsprofil
Die folgende Konfiguration beschreibt Voraussetzungen, keinen ausgeführten
Bootstrap. `/etc/rmm-time-source/chrony-pin.json` muss eine reguläre,
root-eigene Datei mit Modus0600 und genau einem Link unter geschützter
root-eigener Verzeichniskette sein. Striktes JSON-Schema1, keine Zusatzfelder:
```json
{
"schema_version": 1,
"daemon_pid": 1234,
"daemon_birth_ticks": 123456,
"daemon_uid": 999,
"daemon_gid": 999,
"daemon_image_sha256": "<64 kleingeschriebene Hexzeichen>"
}
```
Die Zahlen sind ausschließlich Platzhalter. Ein Operator muss die tatsächlichen
Werte unabhängig aus der vorgesehenen Instanz prüfen. Der Imagepfad ist fest
`/usr/sbin/chronyd`. PID-Startzeit, alle vier UID-/GID-Werte, lebendes pidfd,
gehaltenes und aktuelles `/proc/PID/exe`, aktueller fester Imagepfad und SHA256
müssen übereinstimmen. Die geschützte Binärdatei wird vor und nach der Abfrage
geprüft. Neustart, Konto-/Imagewechsel oder unklarer Zustand bleiben deny;
keine automatische PID- oder Pinübernahme. Root muss einen neuen vertrauens-
würdigen Pin separat provisionieren und die Providerinstanz neu eröffnen.
Ziel ist ausschließlich `/run/chrony/chronyd.sock`. Seine Identität und
Verzeichniskette werden vor und nach der Abfrage geprüft. Nicht-root-eigene
Verzeichnisse müssen dem gepinnten Chrony-Konto gehören; kein Gruppen- oder
Fremdschreibrecht. Der Socket muss dem gepinnten Daemonkonto gehören und darf
keine Rechte für Fremde haben. Andere Images oder Layouts bleiben vorerst
nicht unterstützt, ohne permissiven Fallback.
Der vom Rootoperator separat anzulegende Clientbereich ist
`/run/rmm-time-source/clients`, root:ChronyGID0710 unter geschützter root-eigener
Kette. Eine einzelne Zufallsadresse `tracking-<UUID>.sock` wird einmalig dort
gebunden, root:ChronyGID0660 gesetzt und mit Device/Inode/Name/Konto/Modus
gehalten. Chrony erhält nur Traversierungsrecht am Verzeichnis und Socket-
zugriff; es kann dort keine Namen ändern. Vor jedem Namespacezugriff werden
gehaltener Verzeichnis-FD und aktueller Pfad verglichen. Cleanup konsumiert
seine einmalige Autorität vor der Prüfung und verwendet ausschließlich
`unlinkat` für die exakt eigene Identität. Unklarer Cleanup bleibt liegen;
kein Retry, rekursives Entfernen oder Übernehmen fremder Dateien. Vor Beginn
wird das Clientverzeichnis exklusiv per nonblocking flock am gehaltenen
Verzeichnis-FD gesperrt und muss leer sein. Ein unbekannter Rest blockiert
auch neue Instanzen. Die laufende Providerinstanz bleibt nach einem unklaren
Clientpfad sticky gesperrt; keine neue UUID-Schleife.
## Drahtvertrag und Qualität
Primärquellen: Chrony [candm.h](https://github.com/mlichvar/chrony/blob/master/candm.h),
[pktlength.c](https://github.com/mlichvar/chrony/blob/master/pktlength.c),
[addressing.h](https://github.com/mlichvar/chrony/blob/master/addressing.h) und
[util.c](https://github.com/mlichvar/chrony/blob/master/util.c).
Ein einzelner Unix-Datagrammaufruf verwendet Version6, Tracking-Befehl33,
Antworttyp5 und eine zufällige32-Bit-Sequenz. Request und erfolgreiche Antwort
sind jeweils104Bytes; das Requestpadding gehört dazu. Kein Retry, Shellaufruf,
CLI, UDP-/IP-Fallback, frei wählbarer Befehl oder Zeitsetter. `SO_PASSCRED` und
`recvmsg` verlangen genau eine unveränderte Kernel-Credential mit gepinnter
PID/UID/GID. Fremde Sequenz, fehlerhafte Status-/Headerfelder, abgeschnittene
Nutz- oder Kontrolldaten und fehlende Credentials verweigern.
Die ursprünglich vorgesehene abstrakte Linux-Autobindadresse wird nicht
verwendet. Die Chrony-[Socketimplementierung](https://github.com/mlichvar/chrony/blob/master/socket.c)
behandelt Unix-Rückadressen als C-Strings und rekonstruiert sie mit `strlen`;
eine mit NUL beginnende abstrakte Clientadresse verliert dadurch ihren Namen.
Dieser reine Quellenbefund wurde auch in4.6.1 geprüft, nicht als reales
fehlgeschlagenes Runtimeexperiment ausgegeben. Die technische Entscheidung
des Hauptagenten erlaubt stattdessen den engen sichtbaren Clientbereich oben.
Das Trackingalter wird aus Chronys tatsächlicher Referenzzeit berechnet,
nicht aus Abfragezeit oder Pollintervall. Unsynchronisiert, lokale Referenz/
Refclock, Nullreferenz, Nicht-Netzwerkquelle, Loopback, ungültiger Stratum,
Leapstatus, Zukunftszeit oder ein Alter über1h verweigern. Die spezialisierte
Draht-Floatdarstellung wird als exakte ganzzahlige rationale Größe mit
Aufrundung nach Nanosekunden dekodiert, einschließlich negativer Korrektur;
negative Verzögerung/Dispersion oder Overflow verweigern.
Vor und nach der Abfrage wird `adjtimex` ausschließlich mit modes0 abgefragt:
Status0–4, weder `STA_UNSYNC` noch `STA_CLOCKERR`, gültiger `maxerror`.
REALTIME, MONOTONIC und BOOTTIME werden zeitlich eingegrenzt beobachtet;
Bootwechsel, Rücksprung, Suspendabweichung, unpassende Wanduhrdifferenz und
überschrittenes Gesamtbudget verweigern. Eine Erfassung darf höchstens10ms,
das ist ausschließlich das gemessene Erfassungsfenster, keine Zusage
physikalischer Timerqualität oder Kalibrierung. Die gesamte Abfrage
einschließlich Auth-/Nachprüfung und Cleanup darf höchstens
100ms dauern. Fehlerobergrenze ist konservativ aufgerundet:
Betrag der Chrony-Korrektur + Rootdispersion + halbe Rootverzögerung + größter
Kernel-maxerror + vollständige verstrichene Abfrage-/Nachprüfzeit. Über500ms
verweigert. Nachlauf bis Signierung ist zusätzliche Brokerpflicht; es gibt
keine erfundene Timerkalibrierung und keinen Offline-Lease.
## Tatsächlich lokal ausgeführt
Im unveränderten Offline-Buildimage
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`,
Quellmount read-only, UID1000, eigenes `devstate/provider-target`:
- `cargo test --locked --offline -p rmm-time-source-linux --all-targets`:
4bestanden,0fehlgeschlagen,0ignoriert,0gefiltert. Parserbindung und signed-Float-
Grenzen; synthetische Zeitbracket-Fehler; ausschließlich eigener temporärer
Socket mit echter Namenersetzung und genauem Inodecleanup.
- `cargo clippy --locked --offline -p rmm-time-source-linux --all-targets -- -D warnings`:
bestanden ohne Warnungsunterdrückung.
- Gezieltes `rustfmt --edition2024 --check --config skip_children=true` der
drei eigenen Rustdateien: bestanden.
Der erste Compilerlauf meldete den konkreten `pread`-Offsettypkonflikt
`i64/isize`; er wurde explizit konvertiert und danach bestanden alle obigen
Prüfungen. Die Tests rufen weder den echten Chrony-Provider noch `adjtimex`
auf. Kein Rootlauf, keine Dienstinstallation, keine Server-/Clientwirkung.
## Verbleibende reale Gates
Unabhängiger Quellenreview,
Linux-first-Nachweis mit tatsächlichem Chrony-/Kernelzustand, geschützte
Provisionierung, Broker- und mTLS-HTTP-Anschluss sowie unabhängige Agent-/
SYSTEM-Verifikation bleiben getrennt. Fehlende Plattformqualität bleibt deny.
WebUI-Genehmigung und sämtliche ursprünglichen Clock-/Jobgrenzen bleiben
bestehen. Auf dem Notebook wird kein RMM-Dienst oder Agent installiert.
## Unabhängiger Quellenreview und gezielter Parserfix
Die enge unabhängige Prüfung korrigierte ausschließlich konkrete Fehlerpfade:
Chrony-Ownerausnahme nur am letzten `/run/chrony`-Verzeichnisteil, gebundene
Ancillary-Grenzen vor Credentiallesen sowie sticky Cleanupfence und exklusiver
Verzeichnislock/Leerverzeichnisprüfung. Keine unbekannten Namen automatisch
entfernen oder bei unklarem Cleanup neue UUID-Dateien anhäufen.
Danach wurden zusätzlich IPv4-mapped und IPv4-compatible Loopback-/
Unspecified-Adressen im IPv6-Feld verweigert. Der bestehende Parserfall prüft
vier Gegenfälle und zwei erlaubte Netzwerkdarstellungen; Testzahl bleibt4.
Neuer ReceiptSHA256
`275e6661ad1342cf63df573cab4309ca49d1f7a1066ee2d03fdf686ac58370a6`;
lokale4/4,Clippy,Fmt und Release-Link bestanden. Originale4041333 bleibt
historisch unverändert. Kein nativer Provider-/Kernelquery durch diese Tests.
Der Quellenreview ist abgeschlossen; tatsächliche Providerqualität bleibt offen.
## Getrennter tatsächlicher Kernelbefund auf dem Server
Im nur lesenden Originalfall `09f56716-6175-41f6-8217-5de46854aaf1` wurde auf
dem festgelegten ARM64-Server genau eine Kernelabfrage mit modes0 ausgeführt.
Gemeldet: state0/flags0, kein STA_UNSYNC/STA_CLOCKERR,
maxerror55773us,esterror544us. Eigenes monotones Erfassungsfenster128082ns.
ResultatSHA256
`5422ab7182fd7ff7896f56ce61ea3fe96e9b3a9ef236c39f74a6add8a538a61b`.
Keine Zeitstellung, kein Resync, keine Dienst-/Anwendungsänderung.
Das ist ein einmaliger ABI-begrenzter LP64-Diagnosebefund. Er bildet mit dem
älteren separaten Chrony-CLI-Beleg keine neue gemeinsame native Qualitätsprobe.
Kein signierter Beleg oder freigegebenes Clockgate daraus. Der neue native
Provider muss diese Kernel- und Chronyprüfung selbst frisch zusammen ausführen.