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

15 KiB

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 pidfds, 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 (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.