Files
rust-discovery/docs/server-time-source.md
T
2026-11-15 00:24:47 +01:00

12 KiB
Raw Blame History

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:

{
  "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, pktlength.c, addressing.h und 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 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.

Tatsächlich nativ: vier Provider-Vertragsunits auf Cloud-Linux

2026-11-15. Der neue unabhängig geprüfte Runner deploy/time_source_linux_acceptance.py, SHA256 94f8b020780689dc002415b253fdffc67b6152175a039f5864f9afeb31a323c5, verwendet die sieben eingefrorenen Inputs des gezielten275e6661-Checkpoints. InputmanifestSHA256 bec674868abb3de37310368c18259660c5fd073b806afa53e82aa21faca7d922; Releaseexe1169896Byte/SHA256 1e529e2a82ba845e3b0573e358461d5a7490ca8663df5534039eddb05a17e2d4.

Originalfall fe3f5082-bc1d-4455-9fcf-9d35f6154756: tatsächlich prepare, einmal execute und separater read ausgeführt. 4/4,0ignored/filtered, Exit0 auf der Cloud-Linux-VM als UID0; Rückabruf vollständig. Die gesamte native Viererliste war vor Ausführung exakt gebunden. Bekannte drei RMM-Prozesse, Kontrollbytes, Boot sowie Datenbank-/Lock-Dateiidentitäten blieben gleich. Keine RMM-Jobs, Dienststeuerung oder Produktdateitausche.

FallmanifestSHA256 f7b2415d8186c9d20786848adabb12a8cf8961c465edaccb1fbd216db4917c19; ExecuteSHA256 b740d465ca0c638d296480b213b43076f4a3aea6e74b23238f2c7ea3b4f5e91f; ReadbackSHA256 c0d44f80a606d620fb542befdd99b495e6ce3cc45d198694caf1ab423d9cf22d. Rohbelege und Originalquellen bleiben privat. Kein neuer gesamter Workspace- nachweis: zusätzliche Broker-/HTTPänderungen sind getrennte Quellenstände.

Die vier Units prüfen Parser-/Zeitbracketdaten und ausschließlich eigene Socket-Fixtures einschließlich tatsächlicher Namenersetzung/FD-Cleanup. Kein NativeTimeSource::open/sample, kein echtes Chrony oder adjtimex in diesem Lauf. Der neue native OS-/Validatornachweis ersetzt nicht die offene reale ARM64-Serverprobe mit provisioniertem Pin und frischer gemeinsamer Chrony-/Kernelqualität.