178 lines
10 KiB
Markdown
178 lines
10 KiB
Markdown
# 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.
|