252 lines
14 KiB
Markdown
252 lines
14 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 ein einzelner Socketinode des gepinnten Daemonkontos sein
|
||
und darf weder Gruppen- noch Fremdschreibrecht haben. Lese-/Ausführungsbits
|
||
wie beim tatsächlich beobachteten Modus0755 verleihen auf Linux kein Recht,
|
||
ein Datagramm zu senden; dafür ist Schreibrecht am Pathnamesocket erforderlich
|
||
([Linux unix(7)](https://man7.org/linux/man-pages/man7/unix.7.html)). Der Server
|
||
verwendet tatsächlich das gehaltene Chronyverzeichnis UID/GID9890700; dessen
|
||
Identität sowie sämtliche übrigen Ancestry-/Credentialprüfungen bleiben Pflicht. 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.
|
||
|
||
|
||
## 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.
|
||
|
||
## Tatsächlich nativ: Socketberechtigungsfix auf Cloud-Linux
|
||
|
||
2026-11-15, Originalfall `8ee39b4f-daed-4953-b90f-c04a7b2857c1`:
|
||
alle vier vollständig gelisteten Provider-Vertragsprüfungen auf der
|
||
tatsächlichen Cloud-Linux-VM als UID0 bestanden,0 fehlgeschlagen,0 ignoriert,
|
||
0 gefiltert. Separater Originalfall-Readback vollständig; bekannte Runtimezeugen
|
||
vorher/nachher/aktuell unverändert. Der bestehende Sockettest enthält jetzt
|
||
ausdrücklich0755 positiv sowie0775/0757 negativ. Root-/Daemonidentitäten,
|
||
gehaltene Verzeichnis-/Socketinodes, Singlelink und SCM-Credentials werden
|
||
nicht durch eine Berechtigungsausnahme ersetzt. Auf dem Server wurde keine
|
||
Chrony-Datei oder -Berechtigung geändert.
|
||
|
||
Qualifizierte Nativequelle-SHA256
|
||
`f1fede6a260c4f91c4bf647f2dcadb63520cdadff22c0130327ecd7cae57921b`.
|
||
Lokale eingefrorene Releasequalification7a8cb5be-41b3-400a-bd9b-b4b6f505a6e9,
|
||
Receipt-SHA256
|
||
`74759e286ba7c9762fe4c455da952a0e62de48f55ea643e0a8f435d2128497a5`,
|
||
Sieben-Inputmanifest
|
||
`c0067889fa6e79e5b1dc2ad46685613fd0b379b30a4541670f635140405718d9`.
|
||
Diese Inputs enthalten auch die zum Freezezeitpunkt gesicherte Dokumentfassung;
|
||
nachfolgende Ergebnisdokumentation ist kein Compilerinput. ELF1169800Bytes,
|
||
SHA256 `9bd41ff166aeaae45fdf3dda2d72b04fc30e5ef87a181fe733c47e511a836d59`.
|
||
Neuer Operator `deploy/time_source_socket_linux_acceptance.py`, SHA256
|
||
`eef43096cac8a83751f844d810b97a3f68025786ca64ff34f82be59280ca1aa8`.
|
||
|
||
Der Lauf verwendet eigene Parser-/Clock-/Socketfixtures. Er öffnet keine
|
||
echte NativeTimeSource, fragt weder tatsächliches Chrony noch die Kernelzeit
|
||
ab und qualifiziert keinen signierten Zeitanker oder Windowsclock. Reale
|
||
Serverprobe und nachfolgender Broker-/mTLS-Roundtrip bleiben offene Schritte.
|
||
|
||
Ausführungsreceipt-SHA256 `0decb992bfbfa88389da1949fddb491f2ec02a30abc9f4cce886d1f645768e07`.
|
||
|
||
Separater Rückabruf-SHA256 `88728b6659d506ba96140dd1924a089969e63fcd6f6d308109c4603ec4043da8`.
|