Add gated agent update planning, preserved handoff and Linux worker ports
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -0,0 +1,206 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user