Files
rust-discovery/docs/agent-updater-worker.md
T
2026-11-15 11:40:53 +01:00

211 lines
13 KiB
Markdown

# Linux-Worker: konkreter Zwischenstand
2026-11-14, Spezifikation1.21. `crates/updater-worker` ergänzt die eingefrorenen
Linux-OS-Primitiven; es ist noch kein ausgelieferter Updaterdienst und keine
Applycapability. Keine Zielaktion oder Genehmigung durch diesen Quellschnitt.
## Implementiert
`NativeClock` verwendet eine tatsächlich lesende `adjtimex`-Abfrage samt
Synchronisations-/Fehlergrenze und vergleicht die laufende Wanduhr mit dem
monotonen ursprünglichen Prozessbezug. IPC-/Serverzeit ist kein Ersatz.
`Original` prüft den erhaltenen Originalrequest einschließlich Originalsignatur
bei dessen unveränderlichem Verbrauchszeitpunkt. Exakte Rekonstruktion des alten
Startzeugen, Plan-/Job-/Versuchs-/Grant-/Authorizationbindung, Generationen,
Codepaar, Fulltransition und ursprünglicher Boot müssen stimmen. Aktuelle Uhr,
Boot und Gesamtfrist bleiben vor späteren Schritten verpflichtend; der alte
Startzeitpunkt ist ausdrücklich kein erneuertes Startfenster.
`RetainedSet` hält Dateideskriptoren und Parent-/Dateiidentitäten. Für Schlüssel
und Konfiguration werden zusätzliche Metadatenstempel verglichen, ohne private
Schlüsselbytes zu lesen oder auszugeben; mutable Datenbanken dürfen bei gleicher
Dateiidentität fortschreiten. Die konkrete vollständig erforderliche Dateiliste
muss aus separat geprüfter lokaler Provisionierung kommen. Eine Teilmenge ist
kein vollständiger History-/PKI-Erhaltungsnachweis.
`FullFiles` liest die konkreten geschützten Rawconfig-/Rawpinbytes sowie die
unabhängig provisionierte öffentliche Jobsignierkeydatei. Der vorhandene reine
Fullrenderer muss exakt den vor WebUI-Genehmigung gebundenen Transitionbeleg
ergeben. Nur dessen exakte Config-/Pinbytes werden create-only gestaged.
`StableParticipant` verlangt den tatsächlichen eigenen MainPID des festen
Updaterdiensts mit Prozessgeburt, aktuellem Image, Konto und Unitkomposition.
Die ursprüngliche konkrete Helperinstanz wird ebenso gegen die atomare
Delegation geprüft. `/proc`-/Capabilityfehler werden verweigert; kein UID0-,
Prozessname- oder installierter-Dateipfad-Fallback. Getrennte tatsächliche
General-/Full-/Updater-Dienstkontexte sind noch nativ zu qualifizieren.
`TrustState` lädt ausschließlich geschützte feste Policy-/Keyring-/Healthpin-
und InstalledRecord-Dateien. Originale rohe Hashes bleiben maßgeblich. Die
initiale Baseline benötigt ihre gesonderte Ed25519-Domänensignatur; aktuelle
Schlüsselwiderrufe/-bereiche und Releaseverifikation werden unabhängig geprüft.
Health-/Release-/Jobkeys werden getrennt geprüft. Historische read-only Lader
sind von aktueller Candidate-/Clock-/Boot-/Revocationprüfung getrennt und
erteilen keine Wirkungserlaubnis. `qualify_history` lädt kanonische Rawrecords
am festen geschützten `records/<sha>.json`-Pfad, begrenzt auf64Records/2MiB,
und prüft die vollständige Originalledger-/Baseline-/Health-/Outcome-Kette.
Der originale Fullguard muss dies vor Verbrauch/Stopclaims tun; der Updater
wiederholt es unter dem tatsächlich übernommenen Guard vor dem ersten Swap.
Keine Floorableitung aus einem bloß geparsten Record, kein Releaseprivatkey
auf dem Client. Die getrennte TLS-Keyprovisionierung bleibt ein Bootstrapgate.
`FileWitnesses` bindet die vier tatsächlich vorhandenen Original-/Stageproofs.
Es liest vor jedem einzelnen Schritt unabhängig Original, Stage, erhaltenes
Backup oder neues Ziel nach. Historisch gebundene Hardlinks werden erhalten.
`OwnedLedger` öffnet ausschließlich die vorhandene `consumption.sqlite` ohne
CREATE, nachdem ein echter Linux-OS-Guard alle installierten Reader gestoppt
bestätigt hat. Derselbe Ledger-/Lockinode, Originalstart, vollständiger
Handoffhead und null weitere offene Verbräuche bleiben Pflicht. Der konkrete
Coreguard verifiziert tatsächliche Prozesse, Dateien und Statezeugnisse vor
append-only Handoff-CAS und nativen Effectintents im selben Ledger.
`LedgerFence` verwendet die konkreten Core-APIs `claim_native_effect` und
`observe_native_effect`. Pro Datei bleibt genau ein Kernel-ReplaceIntent;
SavePredecessor und PublishReplacement erhalten getrennte dauerhafte native
Intents und Nachlese. Ein fehlgeschlagener/mehrdeutiger Schritt vergiftet den
laufenden Fence; keine Resume-/Retrykonstruktion aus einem Teilintent.
Hinzugekommen sind eine konkrete streng gebundene Full-Control-Bridge auf dem
bestehenden festen Maintenancesocket und kanonische wiederöffnungsfähige
Witnessbundles. Die Bridge prüft tatsächlichen Fullpeer/PID/Geburt/Image,
Challenge, Originaltupel und monotonen vollständigen Präfix; Request32KiB,
Reply1536KiB sowie gesamte IOfrist sind begrenzt. Ein verlorener mutierender
Reply berechtigt keinen Retry. Header und ursprüngliche Dateistamps bleiben
create-only unter dem Originalgrant geschützt; echte Nachlese bleibt getrennt.
`prepare_return_and_close` persistiert Returnintent plus genau drei Startclaims
atomar und schließt SQLite vor der wirklichen Guardabgabe. Das nichtklonbare
Rückgabeticket enthält keinen Borrow des alten Guards. Der Startfence prüft
freigegebenen Lock, vollständiges Paar und General/Full/Agent genau einmal;
vor Agentstart wird der neue Full erneut lesend zum Originalversuch befragt.
Native Startresultate werden als tatsächliche gehaltene Prozesse vor/nach der
Fullquittung nachgeprüft. Dieser Anschluss ist noch kein gestarteter Enginepfad.
## Offen und standardmäßig verweigert
Vollständige Engine/Daemonhülle und originale aktivierungsgebundene Stageaufnahme,
Stopfence/Drive-Schleife außerhalb des alten synchronen Helpercalls,
drei Stopbeobachtungen vor AllStopped und die vollständige Runtimeverdrahtung
von Guardabgabe/Starts/Full-Observer/Health/Outcome sind noch offen.
Floor-/InstalledRecordpublikation braucht zusätzlich die geschlossenen
originalen nativen Intents nach Health und erhaltende Record-CAS. Die History-
Prüfung ist Quell-/Unitfunktion; ihr tatsächlicher Runtime-/Archivanschluss muss
vor Folgeupdates separat vollständig nachgewiesen werden.
Der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackübergang.
`RestorePredecessor` bleibt deshalb auch bei vorab gebundener Recoveryoption
verweigert; Fehler/Unknown erteilen keinen impliziten Rollback oder Neustart.
Das ist eine offene Apply-/Produktanforderung, kein abgeschlossener Updater.
## Tatsächliche lokale Prüfung
Offlinecontainer aus bestehendem Image
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
Der konkrete Ledger-/Native-Fenceanschluss hat
`cargo check --locked --offline -p rmm-updater-worker --all-targets`
tatsächlich bestanden. Der vollständige aktuelle Checkpoint einschließlich
TrustState bestand danach Clippy mit `-D warnings` für alle Crate-Targets.
Ein Box-Typfehler und zwei unnötige `as_ref`-Aufrufe wurden
korrigiert, ohne Typ- oder Lintunterdrückung.
Der unabhängige Rootreview fand danach einen konkreten historischen
Baselineblocker: `active_release=None` bei `floor=baseline_sequence`
verweigert im unveränderten Frozenverifier jede legitime Baseline. Die tatsächliche
historische Prüfung bindet jetzt die exakte aktive Baseline-Sequenz und deren
Manifesthash; der Floor bleibt unverändert und Kandidaten bleiben aktuell.
Der gezielte reale Ed25519-Gegenbeleg benutzt einen kanonischen separat
baseline-signierten InstalledRecord und echte Release-Signaturen. Die private
Rückmutation auf den alten `None`-Kontext scheiterte erwartungsgemäß genau an der
Baselineprüfung (Exit101); derselbe Release-Test mit Korrektur bestand **1/1**.
Neuer aktueller Kandidat oberhalb des Floors besteht, gleiche/niedrigere Sequenz
mit anderen Bytes, abgelaufenes Angebot und widerrufener Baselinekey werden
verweigert. Release-Test, Clippy `-D warnings` und Formatcheck bestanden aus
derselben privaten Quellkopie. Kein Frozenverifier wurde dafür verändert.
Privater Nachweis:
`devstate/agent-updater-worker/baseline-fix-1fcc8bb2-57fe-4425-b166-f416dc1b4703/`.
Neuer Übergabecheckpoint nach Bridge/Bundle/Returnticket, historischem
Unknown-only-Split und Historyreviewfixes: private eingefrorene Quellkopie
`devstate/agent-updater-worker/handoff-43ade361-9726-4fb4-8e97-cae19c22c6d0/`.
Release **3/3**, keine Skips/Filter, Clippy `-D warnings` und Formatcheck
tatsächlich bestanden. Fälle: signierter Baseline-/Floor-Gegenbeleg, wirklicher
State-Inode-/Originalstamp-Reopen und vollständig signierte History inklusive
konkreter Tamper-/Rollback-/Fork-/Claim-/Completionfehler bei unveränderten
SQLite-Änderungszählern. Receipt-SHA256:
`30425acbffaa05578fd17ee25a2e3f42976fe4237423e874635c49aa0fcb4990`.
Workerquellsatz:
`793efb917979ca59e95cdf0ff01d75b16c75a79d8392bc557f0864728d558cf1`.
Die erste private Kopie fehlte um die `include_str`-Goldenfixture; der daraus
resultierende Compilerfehler bleibt mit seinen Originallogs erhalten. Nach
Ergänzung exakt derselben Repo-Fixture wurden die genannten Checks ausgeführt.
Private Verzeichnisse700/Dateien600/qualifizierte Exe500 sind explizit gesetzt.
Keine Engine gestartet, kein systemd-Aufruf, keine echte Zieldatei geändert,
keine VM/SSH-/Job-/WebUI-Aktion und kein nativer Worker-/Applynachweis.
Der native Linux-OS5-Nachweis qualifiziert weiterhin dessen eigene eingefrorene
Primitiven und ersetzt keine Worker-/Dienstkontextabnahme.
## Anschließender gemeinsamer Runtimeanschluss
Die historische3er-Qualifikation oben bleibt unverändert. Danach wurden die
feste Recordtransition und der konkrete Full-Namespace-/Fenceadapter verbunden;
der gemeinsame lokale200er-Lauf enthält5Workerfälle. Die2zusätzlichen Root-/run-
FS-Fälle beweisen getrennte echte Recordrenames/Originalinodeerhalt und Abweisung
von namensgleichen Ersatzdateien/Currentkollisionen ohne Resume. Sie qualifizieren
keine echte UI-/Job-/Service-/Rootguardwirkung und umgehen ausdrücklich den
öffentlichen authentisierten BuiltRecordeingang. Aktueller Source-/Nachweisstand
und restliche Engine-/Admission-/Rollback-/Nativegates:
[Runtimefortschreibung](agent-updater-runtime-source.md).
## Einmalige Queue-/Drivefolge und vorhandene Agent-Singletonsperre
Am2026-11-15 liegt `worker::engine::Runtime` als noch gesperrter Quellschnitt
vor. Der vorhandene IPC-Activatehandler queuet ausschließlich den originalen
Handoff; die private Drivefolge ist erst nach vollständig geschriebenem Reply
und geschlossener Accepted-Verbindung erreichbar. Eine verlorene Antwort
verwirft die Queue und sperrt dieselbe Runtime. Die erste Fullbridge-Lesung
übernimmt den tatsächlich authentisierten Originalpräfix; vorher sind alle
mutierenden Methoden gesperrt und kein Event wird aus Headerdaten erfunden.
Die Folge verbindet Originalsignatur-/Policy-/Floor-/Dateibeobachtungen, alle
drei Full-Stopclaims vor irgendeinem Stop, die tatsächlichen Stopbeobachtungen
im Originalledger nach Guardübernahme, AllStopped/Owns, vier getrennte
Save-/Publishpaare, Pair, Return-/Startreservation, tatsächlichen DBclose und
flockdrop, General→Full→Agent und neue Full-Start-/Health-/Recordbestätigung.
Es gibt keinen Resume oder Restore. Ein Fehler bei den Fileübergängen versucht
unter dem noch gehaltenen Originalguard genau einen Unknown-CAS und startet
keinen Dienst neu. Native Dienst-/Fehlerfolgen sind damit noch nicht bewiesen.
Zusätzlich wird die vorhandene `/var/lib/rmm-agent-remote/agent.lock` aus dem
OriginalRetainedSet gebunden: unveränderter Inode, UID993/GID984/0600/nlink1,
0Bytes und privater Parent. Nach echtem StoppedServices-Beleg nimmt der Worker
diese vorhandene Sperre exklusiv ohne CREATE. Sie bleibt über Root-DB/Swap/
DBclose/Rootlockreturn gehalten und wird vor der festen Startfolge zurückgegeben.
Der Agent hält schon heute seine ursprüngliche Singletondatei vor beiden
Agent-SQLiteöffnungen; keine ACL, Agentdatei oder Sperrrolle wurde geändert.
Der ursprüngliche Quellencheckpoint verweigerte den Eintritt explizit mit
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die Fortschreibung verbindet jetzt die
Registry sowie tatsächliche Task-/FD-/maps-Census vor den Stops und unter beiden
gehaltenen ursprünglichen Sperren danach. Diese Quellintegration ist lokal
geprüft, jedoch noch nicht als installierter Dienst-/Hostkontext qualifiziert.
Eine bekannte Unitliste allein ersetzt keinen Census. Keine CLI oder
RMM-Admission ruft diese Runtime auf; Applycaps bleiben geschlossen. Offen sind
insbesondere extern qualifizierte kompatible Bootstrapregistry und Hostkontexte,
ursprüngliche Full-Admission, Staging-/Downloadproducer, passiver gültiger
Updatezustand, V2-Rollbackvertrag vor dem ersten Bootstrap, Unsicherheits-
Namespaces und tatsächlicher Linux-Apply. Aktueller Nachweis und enger geplanter
nativer Zweierlauf: [Readercensus](agent-updater-reader-census-results.md).
Lokaler Nachweis liegt unter
`devstate/updater-engine-source-6a8bb902-4db4-4d93-8843-450ba1dd5622/`.
Der7er-Workerlauf umfasst jetzt auch den **öffentlichen** BuiltRecordbuilder:
Originalsignierter Job und echte vollständig signierte History ergeben exakt
die erwarteten Rawrecordbytes. Ein für einen fremden externen Healthkey gültiger
Journal bleibt unter dem Originaljobkey unzulässig; geänderter Head/prior wird
verweigert. Ein separater echter Container-FS-Fall belegt die Agent-Singleton-
Aliasblockade und Ablehnung eines gleichbyteigen Inodeersatzes. Dies sind lokale
Krypto-/FS-Verträge; sie führen die Queue-/Drive-/Dienstfolge nicht aus.