240 lines
15 KiB
Markdown
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.
|