Files
rust-discovery/docs/agent-updater-linux-port.md
T
2026-11-14 22:40:41 +01:00

240 lines
15 KiB
Markdown

# Linux-OS-Port des unabhängigen Updaters
Stand2026-11-14: neue Bibliothek `rmm-updater-linux`, auf Auftrag des Hauptagenten
isoliert neben Domain/Core und Server/WebUI implementiert. **Noch kein laufender
Updaterdienst und keine Applyabnahme.** Native Linux-first-Abnahme und sämtliche
Zielaktionen bleiben beim Hauptagenten. Der vorhandene Releaseverifier, dessen
Native-Runner sowie der separat qualifizierte achtteilige Handoffkernel bleiben
unverändert.
**Aktueller lokaler Quellenstand nach unabhängigem Review:** Der weiter unten
erhaltene4-Fälle-Beleg ist historisch. Ein echter Same-PID-Exec-Bindungsfehler
wurde korrigiert, mit dem alten Code reproduziert und im neuen lokalen
5-Fälle-Nachweis geschlossen. Dieser lokale Schritt allein ist kein nativer
VM- oder Applynachweis; die danach separat durch Root ausgeführte native
OS-Unitqualifikation ist am Ende ergänzt.
## Implementierte Betriebssystemstrecke
`files` öffnet jede Verzeichniskomponente mit gehaltenem `openat`-Dirfd,
`O_NOFOLLOW` und `O_CLOEXEC`. Rootgeschützte installierte Verzeichnisse dürfen
keine gruppen-/weltbeschreibbaren Vorfahren haben. Dateiprüfungen binden
Device/Inode, UID/GID, Modus, vorhandene Linkzahl, Länge und SHA256; Hashing
benutzt höchstens32KiB Lesepuffer. Historisch gebundene Hardlinks werden nicht
pauschal verboten. Neue Stages haben genau einen Link.
Die vier Produktionsziele sind geschlossen: Agent, gemeinsame Helperbinary,
Fullkonfiguration und Fullpin. Aus einem Request kommt kein Zielpfad.
Staging entsteht exklusiv im **gleichen gehaltenen Installationsverzeichnis**,
mit exaktem EOF/Längen-/Hashnachweis, ursprünglichen Besitz-/Moduswerten und
Datei-/Directory-fsync. Fehlerhafte/partielle Stages bleiben erhalten und
werden nicht automatisch wiederverwendet oder gelöscht. Der eingebettete
Downloadreader muss selbst IOzeit und Kanalabbruch begrenzen; die Bibliothek
prüft das ursprüngliche Boot-/Monotonbudget zwischen IOschritten, kann aber
keinen beliebig blockierenden fremden `Read`-Aufruf unterbrechen.
Ein Austausch verlangt einen tatsächlich gehaltenen `LedgerGuard`. Vor jedem
Namespaceeingriff werden dessen aktuelle Dateiidentität, weiterhin gestoppte
Reader und Budget geprüft. Der Vorgänger wird mit `RENAME_NOREPLACE` unter
seinem erhaltenen Inode auf einen festen Backupnamen verschoben; danach wird
die verifizierte Stage ebenfalls ohne Überschreiben an den Originalpfad
verschoben. Jede Phase benötigt vorher den dauerhaften `DurableEffectFence`.
Ein Crash zwischen den Renames ist ausdrücklich **kein atomarer Bundleswap**:
Vorgänger und Stage bleiben nachlesbar, neuer Execute-/Resumeversuch verboten.
Ein zulässiges einmaliges Rollback benötigt eine eigene vorab gebundene Fence;
es erhält beide Codegenerationen und verändert keine Zustandsdatei oder Floor.
`process` bindet echte `pidfd`s, ein gehaltenes `/proc/PID`-Verzeichnis,
Prozessgeburt, alle UID/GIDwerte und ein gehaltenes Rootimage. Exithinweise
und nachträgliche Abweichung verweigern. Imagehashing verwendet `pread`, damit
parallele Nachlese keinen gemeinsam verschobenen Dateioffset verwendet.
Nicht unterstützte Kernel erhalten keinen PID-/Prozessnamenfallback.
Vor und nach dem Hashen wird das **aktuell ausgewählte** `/proc/PID/exe`
erneut durch das gehaltene Proc-Verzeichnis geöffnet und per Device/Inode
gegen das ursprüngliche Image gebunden; Geburt, Konten und pidfd werden
danach nochmals geprüft. Ein noch lesbarer alter Image-FD allein genügt nicht:
`execve` behält PID, Geburt und Credentials, wechselt aber die Codegeneration.
`services` kennt ausschließlich Agent/General/Full und optional den bereits
inaktiven, deaktivierten APT-Reader. General und Full müssen dieselbe
Helpergeneration haben. Geladene Unit und sämtliche Drop-ins werden als
geschützte Fileproofs gebunden; Running/PID/Invocation-ID, native Prozesszeugen
und tatsächliche Konten werden unabhängig nachgelesen. Ein Rootpeer genügt
nicht: `SO_PEERCRED` muss zur aktuellen konkreten Helper-/Updater-Dienstinstanz
mit gehaltenem Prozess passen. Der stabile Updater ist getrennt, UID/GID0,
und gehört niemals zum Stopset.
Stop und Start benutzen feste argv an `/usr/bin/systemctl`, keine Shell oder
freien Kommandos. Es gibt keine Enable-, Reboot- oder APT-Startoperation.
Stop startet genau eine Systemdanforderung pro gebundenem alten Dienst und
beobachtet danach dessen tatsächliches Ende. Nach vollständigem Code-/Pinpaar
und Ledger-Rückgabe startet der enge Anschluss General, Full und Agent einmal.
Timeout des eigenen Clients beendet nur dessen gehaltenen pidfd-Prozess;
Systemd kann den Auftrag bereits übernommen haben. **Jeder Fehler nach
möglicher Übergabe bleibt unklar; nie still wiederholen oder als Nichtstart
ausgeben.**
`LedgerGuard` öffnet ausschließlich vorhandene `consumption.sqlite` und
`executor.lock` unter `/var/lib/rmm-helper`. Kein Create/Truncate, kein neuer
Journal-ID-Slot. Exklusive `flock`-Übernahme erfolgt erst nach bestätigtem Stop
aller installierten Reader und bindet beide exakten Dateiidentitäten. Die
Lebensdauer leiht `StoppedServices`; ein gleichzeitiger Start derselben
Kontrollinstanz ist so ausgeschlossen. Vor Abgabe muss die eingebettete Fence
den ursprünglichen `LedgerReturnIntent` dauerhaft gespeichert haben.
## Lokaler Kanal und noch fehlende Integration
Der implementierte IPC-Transport bindet ausschließlich den vorher separat
provisionierten privaten Rootpfad `/run/rmm-agent-updater/control.sock`.
Vorhandene Sockets werden weder entfernt noch wiederverwendet. Vor Parsing und
Dispatch wird der tatsächliche aktuelle Helperdienst mit SO_PEERCRED und
gehaltenen Prozess-/Unitzeugen authentisiert. Der Client authentisiert den
fest provisionierten Updater unabhängig vor dem Senden und vergleicht seine
Antwort mit genau diesem Participantbeleg. Ein begrenzter Längenheader erlaubt
höchstens32KiB und eine Anfrage pro Verbindung. Methods sind Describe, Activate,
Read und Health; keine Approval-, Pfad-, Befehls- oder neue Startgranterteilung.
`ready` bleibt zwingend false. Activate-IOfehler erlaubt ausschließlich Read.
Es wird bewusst **keine permissive Engine/Fence und kein unfertiges Daemonbinary**
ausgeliefert. Der Core-Eigentümer integriert Originalsignaturen, aktuelle
TrustedClock/Trustpolicy, immutable Handoff/Delegation im bestehenden Ledger,
alleinigen logischen Owner, feste Staging-/Fullrendererzeugen und den
evidenz-only SignedSync-/Inventarhealthbeleg. Die beiden nativen Rename-Intents
pro Datei sind zusätzliche vorhandene-ledger-gebundene Effectintents, keine
Verdoppelung der begrenzten16 Handoffevents. Ein verlorener Writer oder
definitives Unknown wird niemals durch diese OSbeobachtungen geheilt.
Noch offen: konkrete Core-Fence-/Engineimplementierung, monotone Floor- und
InstalledRecordpublikation, Dienstbootstrap/stabiles Binary, tatsächliche
Systemd-/IPC-/Staging-/Dateitausch-/Rückgabekette und zulässiger Rollback im
WebUI-genehmigten Updateversuch. Der Loopback-/Rootbootstrapweg ist keine
Jobgenehmigung. Notebook bleibt ausschließlich Entwicklungsrechner.
## Tatsächlich lokal geprüft
Isolierter Offline-Buildcontainer aus dem vorhandenen Image
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`.
Private eingefrorene Quellkopie mit nur Domain/Handoff/Linuxport als
Workspacemembers, unveränderten Dependencyversionen; der private Lock wurde
dort offline aufgelöst, ursprünglicher Workspace/Lock durch diesen Subagenten
nicht verändert. Eigener Targetpfad `devstate/agent-updater-linux/target`.
Bestanden: Releasebuild und **4/4** Prüfungen, keine Skips/Filter, Clippy mit
`-D warnings`, Formatcheck. Die beiden echten OSprüfungen betreffen ausschließlich
neue private `/run`-Unitfixtures und einen eigenen gehaltenen Sleep-Prozess:
Symlink-/Namensersatz-/Modusverweigerung, erhaltene gebundene Hardlinks,
PID-/Geburts-/Image-/Konten-/Exitbindung und ursprüngliche Deadline. Der dritte
Fall verweigert übergroße, doppelte, unbekannte und ungebundene IPCfelder.
Der vierte nutzt ausschließlich ein lokales Unix-Socketpaar und belegt, dass
fragmentierte Nachrichten die feste Gesamtlesefrist nicht durch einzelne
erfolgreiche Bytes verlängern können; es läuft kein lauschender IPCserver.
Die ursprüngliche Jobfrist begrenzt dabei auch jeden einzelnen blockierenden
Socketaufruf; der zweite Teilfall belegt die kürzere Jobfrist gegenüber der
längeren Framefrist.
Dabei fand er einen echten Serde-Fehler: eine leere Unitvariante ignorierte
Zusatzfelder; die strikte leere Structvariante ist korrigiert und nachgeprüft.
Erster Compilerlauf meldete einen mehrdeutigen `File::by_ref`; typisiert
korrigiert. Clippy forderte einen typisierten Stagingdescriptor statt acht
einzelner Argumente; kein Lint wurde unterdrückt.
Keine lokale oder native Dienst-/IPCserversitzung, kein Aufruf von Systemd,
kein Zugriff auf echte RMM-Zieldateien, kein Releaseapply und keine VM-Aktion.
Diese Nachweise sind keine Abnahme der noch fehlenden Runtimeintegration.
Der create-only Nachweis liegt privat unter
`devstate/agent-updater-linux/qualification-19449c78-6919-4e25-8750-cd3c450fb68e/`.
Er bindet die tatsächlich verwendete eingefrorene Quellkopie, Befehle,
Exitcodes und stdout/stderr. Linuxport-Quellsatz:
`699276d3d3e467143d8ccf0fcb3b51949d3c2fffb1f7d0f0a167239ea2b10404`;
Receipt: `ff569473d0ca8179948429f1fc78404e09c1666e4053b6efe672edf079696adc`;
qualifiziertes lokales Unitbinary:
`25e9de040b8a461291efb9566c02b6b3c2cb98d032ae8d071278dbbc0b2642cf`.
Der frühere lokale 3-Fälle-Nachweis bleibt unverändert als historischer Stand
erhalten und qualifiziert diese neuere Quelle nicht.
## Fortschreibung: Same-PID-Exec-Gegenbeleg und Korrektur
Der unabhängige Review fand, dass `HeldProcess::verify` zunächst nur das alte
gehaltene Image erneut hashte. Ein `execve` im gleichen Prozess blieb dadurch
unentdeckt. Die Korrektur bindet das aktuelle Kernel-Exeziel vor und nach dem
Hashen an den ursprünglichen Dateizeugen und prüft die übrige Prozessidentität
erneut. Es gibt keinen Prozessnamen-/PID-Fallback oder gelockerten Proc-Zugriff.
Die neue echte OSprobe startet ausschließlich einen eigenen Bashprozess,
öffnet dessen pidfd/Image/Geburts-/UID-/GIDzeugnisse und lässt ihn über seine
eigene Pipe nach `/usr/bin/sleep` execen. Ein neuer unabhängiger Zeuge bestätigt
dieselbe PID, Geburt und Konten, ein weiter lebendes pidfd sowie den tatsächlich
geänderten Imagehash. Der alte Zeuge muss verweigern. Die Kindumgebung ist
geleert; ein RAII-Wächter beendet und wartet ausschließlich dieses eigene Kind
auch bei einem Testpanic. Keine RMM-Dienste oder fremden PIDs werden berührt.
Tatsächlich lokal ausgeführt, isolierter Offlinecontainer mit eingefrorener
Domain-/Handoff-/Linuxport-Quellkopie: korrigiert **5/5 ohne Skips/Filter**, Clippy
`-D warnings` und Formatcheck bestanden. Danach wurde ausschließlich in dieser
privaten Kopie `process.rs` durch die Originalquelle des erhaltenen4er-Belegs
ersetzt. Die neue Execprobe scheiterte erwartungsgemäß mit Exit101 genau an
`held.verify().is_err()`. Nach Rückkehr zur korrigierten Quelle bestanden erneut
alle5Fälle. Das ursprüngliche4er-Receipt und dessen Binärdatei bleiben erhalten.
Enger unabhängiger Re-Review des Fixes und seiner Belege: **PASS**.
Neuer create-only Beleg:
`devstate/updater-linux-execfix-aa106c58-8c96-4c8a-8490-635b1d143f07/receipt.json`,
SHA256 `f705ba03e5043a411fc3a0642197fc4f16da8627e1e5cbfbac78ed125ecb650c`.
Finale lokale Unitexe:1538320Bytes, SHA256
`b11b57e6399dcfcfb255619a8fba558beea6a57e4f1ee997ee9c63c769a1e882`.
Snapshot und ursprüngliche Logs einschließlich des erwarteten Gegenfehlers
bleiben privat erhalten. Nicht ausgeführt: VM, Systemd, IPCserver, Daemon,
Releaseapply oder Deployment. Gerade der tatsächliche Generalhelperkontext
kann andere Proc-/Capabilitygrenzen besitzen; ein isolierter Rootcontainer
qualifiziert diesen noch nicht. Fehlender Proc-/Imagezugriff muss verweigern,
keine Sandboxlockerung aus diesem lokalen Erfolg ableiten.
## Anschließend tatsächlich auf Cloud-Linux geprüft
Root führte die eingefrorene finale5er-Unitexe anschließend separat auf der
festgelegten Linux-Cloud-VM als UID0 aus: Fall
`ec030323-85df-4b38-9e70-87be330033c2`, genau5bestanden,0Skips/Filter.
Eine getrennte Same-case-Nachlese war identisch. Keine RMM-Jobs, kein Apply,
keine Dienststeuerung oder Änderung der laufenden Agent-/Helpergenerationen.
Der Fullhelper blieb aktiv, seine Unit weiterhin disabled; daraus folgt kein
Autostartnachweis. Der vollständige von Root veröffentlichte Originalbericht
wird bytegleich übernommen: [Native Linux-OS5](agent-updater-linux-native-results.md)
(Maincommit `c35c440`). Historische lokale Belege bleiben unverändert.
Das ist ein nativer OS-Unitnachweis, ausdrücklich **keine Qualifikation des
restriktiven tatsächlichen Generalhelper-Dienstkontexts**, der konkreten
IPC-Peers, Engine/Fence oder Releaseaktivierung. Diese Gates bleiben offen.
## Enges additives Stage-Reopen: lokal6/6, native Folgeprüfung offen
Nach dem erhaltenen nativen5er-Stand wurde ausschließlich `files.rs` erweitert.
`Staged::reopen_bound` rekonstruiert gehaltene Beobachtungen aus dem geschützten
Originalhandoffbundle: feste Rollenzielverzeichnisse, ursprüngliche Rootdatei,
exakte Stageidentität mit nlink1, gleiche Metadaten und Originalhashes. Bereits
vorhandene previous-/rejected-Namen verweigern; es wird weder geschrieben noch
ein teilweiser früherer Austausch als neuer Stageversuch interpretiert.
Die zusätzliche echte lokale OSprobe verwendet nur neue öffentliche Dummydateien
in einem eigenen privaten `/run`-Verzeichnis des isolierten Rootcontainers.
Der öffentliche Einstieg verweigert dieses fremde Rollenzielverzeichnis; die
private gemeinsame FD-Prüfung besteht zunächst. Eine namensgleiche Stagekopie
mit gleichen Bytes und anderer Dateiidentität sowie danach ein zusätzlicher
Stagehardlink verweigern jeweils. Kein Agent/Helperdienst, Fremdprozess, Host-
Packageupdate oder RMM-Job wurde dafür gestartet.
Tatsächlich lokal aus eingefrorenem Quellpaket ausgeführt: Release6/6 ohne
Skips/Filter, Clippy mit -D warnings und Formatprüfung PASS. Neuer Originalbeleg:
`devstate/agent-updater-linux/qualification-os6-0b3c8018-b08f-4917-80b8-0e3169a0f813/receipt.json`,
SHA256 `c3e1ee619ef01630b296aaf7669d04f39ea952b1ec2d7adc1a791f69f6a6ee08`.
Finale Unitexe `qualified-os6-tests`:1555392Bytes, SHA256
`c78d24d9b3f543fc4eba3fa1d02bf82e72aea26493ae689f2fc82ee1067d33fc`.
OSquellsatzSHA256 `5ad19b05dbc1277d6fdbf29fa3bb852ac00b34d43af94fca3220617662ed45a3`.
Die einzige geänderte OSdatei `files.rs` hat27138Bytes und SHA256
`f29a89d5e1a6fda9d24e74a0c0d4f2949d82e2e80c0052a11d1e3891467a69b7`.
Die frühere native5er-Abnahme bleibt historisch und qualifiziert diese neue
Quelle nicht. Für genau diesen neuen6er-Stand ist der tatsächliche Cloud-
VMnachweis noch offen; ebenso tatsächlicher Full-/Updater-Dienstkontext,
geschlossene Readercensus, konkrete Engine und Apply. Ein erfolgreicher lokaler
Reopen verleiht keine Start-, Retry-, Restore- oder allgemeine Readyautorität.