Merge branch 'codex/agent-updater'
Rust development slice / linux (push) Failing after 7s

This commit is contained in:
2026-11-15 11:52:38 +01:00
14 changed files with 2778 additions and 58 deletions
+108
View File
@@ -0,0 +1,108 @@
# Linux-Readercensus: lokaler Quellenstand und geplanter nativer Nachweis
Stand2026-11-15, Spezifikation1.22. Keine Zielinstallation, Dienständerung,
RMM-Ausführung oder Applyabnahme wurde in diesem Arbeitsschritt vorgenommen.
Die WebUI-Genehmigungsgrenze bleibt unverändert.
Registry und Census sind mit der vorhandenen Worker-Enginequelle verbunden.
Die Registry bindet Originalrohbytes, Bootstrapreceipt, Readervertrag,
Hostnamespaces und exakte Unit-/Dropinkomposition. Aktuelle TGIDs und sämtliche
Task-FD-Tabellen werden begrenzt und erneut auf Identität geprüft; auch eine
Datei mit geschlossenem FD bleibt über ihren mmap-Inode ein Reader. Unbekannte,
unlesbare, wechselnde oder unvollständige Beobachtungen verweigern. Fremde
Cmdlines, Umgebungen und map-Pfade werden nicht ausgegeben.
Der vorhandene Root-Executorflock und die ursprüngliche Agent-Singletonsperre
bleiben beide unter dem nicht frei konstruierbaren `ClosedReaders`-Beleg gehalten,
bevor der Updater SQLite öffnet. Der Readervertrag fordert außerdem den
Roothelperflock vor seinen SQLiteöffnungen und jeder SQL-/Effektoperation und
die Agent-Sperre lebenslang vor beiden Agentdatenbanken. Dies ist kein globales
Versprechen über zukünftige privilegierte Fremdprozesse.
## Tatsächlich lokal geprüft
Im isolierten Offline-Rustcontainer, Quellmount read-only, unveränderte
Docker-Seccomp-Policy, eigene tmpfs für `/run`, `/tmp` und `/var/lib`:
- Locked all-targets Check, Release-Link, Clippy `-D warnings`, Formatcheck: PASS.
- Vollständige Release-Workerliste10, tatsächlich10bestanden,0Fehler,
0ignoriert,0gefiltert.
- Die Prozessfixtures belegen bestehende FDs, anschließend mmap nach FDclose
sowie einen Reader in einer privaten FD-Tabelle eines einzelnen Threads.
Der TGID-only-Gegenfall findet diesen Threadreader ausdrücklich nicht;
die vollständige Taskprüfung findet ihn.
Der erste Lauf unter `reader-census-ba31b221-79c4-4702-b6d6-09bb94bba7fc`
bestand9/10. Der eigene Threadfixture wurde am Docker-Seccomp-Verbot für
`unshare(CLONE_FILES)` mit EPERM abgewiesen. Ausschließlich im Testfixture wurde
stattdessen `close_range(UINT_MAX,UINT_MAX,CLOSE_RANGE_UNSHARE)` verwendet:
die gleiche eigene FD-Tabellenseparation, ohne eine tatsächlich mögliche
FDnummer zu schließen. Keine Sandboxregel, Capability oder Produktionsprüfung
wurde gelockert. Die Produktionsbytes vor `#[cfg(test)]` blieben identisch.
Die Semantik folgt [close_range(2)](https://man7.org/linux/man-pages/man2/close_range.2.html).
Der ursprüngliche Fehlerbeleg bleibt erhalten.
Finaler eingefrorener Privatfall:
`devstate/agent-updater-worker/reader-census-final-da31051b-269f-4fb5-947d-94c8ad162c2a/`.
Er enthält71Originalinputs mit Vor-/Nachhashprüfung, alle Logs und das tatsächlich
lokal ausgeführte Release-Test-ELF. Receipt SHA256
`9020992e888d0b22e71db88cab78f255e273be2a4a7856d43616b387c36c74ae`,
Inputs SHA256 `382714b09349e448441345abbac6d99c0d523e98bdabaa78290b400768bac8f7`,
ELF7.888.096Bytes/SHA256
`e83fd334b005d81ac917389de2a1c7486bea3f62ae45d77bccbd331e131e4304`.
## Geplant, nicht ausgeführt: zwei Cloud-Linux-Prozessguards
`deploy/updater_reader_census_linux_acceptance.py` ist lokal vorbereitet im
Originalfall `168a4171-dbe3-46ef-8978-850797d0625c`. Vor Zielausführung muss Root
seinen unabhängigen Runnerreview abschließen. Keine Zugangsdaten wurden für
Prepare gelesen, kein Zielaufruf vorgenommen.
Der Runner prüft zuerst die vollständige Liste aller10Tests des exakt gebundenen
ELF. Anschließend läuft ausschließlich der feste Filter `census_process::tests::`:
- `actual_proc_probe_detects_existing_descriptors_and_mapped_inode_without_exporting_paths`
- `private_thread_fd_table_cannot_hide_a_reader_from_the_group_probe`
Erforderlich sind2bestanden und8gefiltert. Die anderen acht Tests dürfen auf der
VM nicht laufen: Einige lokale Fixtures verwenden feste Produktzustandspfade.
Die zwei ausgewählten Tests verwenden nur eigene Create-once-UUIDdateien unter
`/run`, eigene FDs, eigenen mmap und einen eigenen Fixturethread. Keine SQLopen,
Jobs oder Dienststeuerung. Der Runner läuft als Root mit NoNewPrivileges und
führt nach einmaligem Eintritt keine Wiederholung aus. Nach verlorener Antwort
ist ausschließlich Read des Originalfalls zulässig.
Vorher/Nachher werden Boot, Ubuntu24.04/x86-64, drei bekannte Dienstgenerationen
mit Konten/Images, geschlossener APT-Helfer, vier geschützte Control-Dateien,
drei DB-Identitäten sowie ursprünglicher Root- und Agentlock verglichen.
Control-Bytes sind gehasht; bei den laufenden DBs werden Identitäten geprüft,
keine Bytegleichheit oder vollständige SQL-Historie behauptet. Der begrenzte
Prozessnachweis ersetzt weder einen kompletten Hostcensus noch native
Full-/Updaterdienstkontexte oder einen Updatejob.
## Weiterhin offen
Extern qualifizierte kompatible Bootstrapregistry und geschützter Hostkontext,
native Dienst-/Namespace-/Capabilitykontexte, ursprüngliche Full-Admission und
Runtimeentrypoint, Staging-/Downloadproducer, gültige passive Updatebeobachtung,
Unknown-only-Recordnamespace-Adjudikation, ein vor dem ersten Apply lesbarer
V2-Rollbackvertrag sowie tatsächlicher WebUI-genehmigter Linux-Apply mit
Health-/Erhaltungsnachweis. V1-Restore bleibt deny. Kein erfolgreicher nativer
Apply und keine fertige Updaterbereitschaft folgen aus diesen lokalen Guards.
## Tatsächlich auf Cloud-Linux ausgeführt
Originalfall `168a4171-dbe3-46ef-8978-850797d0625c`: vor Ausführung volle
10er-Liste verglichen, danach genau beide Prozesscensus-Guards tatsächlich
als UID0 bestanden;2PASS/0failed/ignored,8andere ausdrücklich gefiltert.
Execute-Receipt
`d6bdda0bddac74f9364fa6ec3287ed0cfa9964ae02a98cc174e95929dc94f9d5`.
Separater Originalrückabruf bestätigte das Ergebnis und erhaltene aktuelle
Runtime-/Control-/State-/Lockidentitäten, Receipt
`8cbe7f4d79c238e3ad73a9c7152dcb415decbeeb1a8a1691fcc43ae4ee6c6a47`.
Die eigenen kurzlebigen Prozess-/Thread-/FD-/mmap-Fixtures wurden geprüft;
keine RMM-Dienste gesteuert, keine Projekt-SQLite geöffnet oder Agentdatei
ersetzt. Dieser Nachweis qualifiziert weder den vollständigen Host-/
Dienstcensus noch Admission, Apply, Record-Unknown-Adjudikation oder Rollback.
Die zuvor genannten offenen Gates bleiben offen.
+108
View File
@@ -0,0 +1,108 @@
# Geschützte Linux-Readerregistry: Quellenbaustein
Stand2026-11-15, Spezifikation1.22. `worker::reader_registry` implementiert nur
Registry-/Unit-/Aktivierungspfadprüfung. Kein Bootstrap, Dienstcontrol, SQLopen,
Updaterstart, Apply oder Capability folgt daraus. Die vollständige aktuelle
Task-/FD-/maps-Census und die tatsächlich gehaltenen ursprünglichen Root- und
Agentlocks sind zusätzlich Pflicht. Die lokale Enginequelle verbindet diese
Bausteine inzwischen; ohne extern qualifizierte Bootstrapregistry, tatsächliche
Dienst-/Hostkontexte und ursprünglichen Admissionanschluss bleiben die
Produktcapabilities `not_configured`. Siehe
[aktuellen Readercensusnachweis](agent-updater-reader-census-results.md).
Der Aufruf `QualifiedRegistry::load(&LocalUpdatePolicy)` liest ausschließlich
`/etc/rmm-agent-updater/reader-registry.json` unter root-eigener, gegen fremdes
Schreiben geschützter Ancestry. Originalrohbytes höchstens64KiB, root0, regulär,
ein Link; deren exakter SHA muss `policy.reader_registry_sha256` entsprechen.
Damit bindet der vor WebUI-Genehmigung gespeicherte Policyhash die Registry
transitiv. Gehaltene Dateien/Parent-FDs, Rawbytes und aktuelle Metadatastempel
bleiben erhalten; `verify_protected()` prüft unveränderte originale Namen,
Device/Inodes, Konten/Modi/Linkzahlen, Größe, Zeitstempel und Bytes. Kein Caller-
Boolean oder aus einem Registryfeld abgeleitetes Alleinvertrauen.
Schema1 und Profil `linux_shared_readers_v1` besitzen exakt:
- `bootstrap_receipt_sha256`: exakt der Bootstrap-Qualificationreceipthash aus
`policy.initial_baseline.decode().record.activation_evidence`.
- `reader_contract_sha256`: Hash der unveränderlichen öffentlichen Bytekonstante
`READER_CONTRACT`, über `reader_contract_sha256()` unabhängig berechenbar.
- `host_context`: `census::HostContext` mit extern bootstrapqualifizierten
Proc-/User-/PID-/Cgroup-Namespace-Device/Inodes; aktuelle eigene gleiche
Metadaten allein sind keine Bootstrapqualifikation.
- `units`: die unten festgelegten21 Units in dieser Reihenfolge.
- `rollback_timers`: höchstens32 weitere historisch bekannte, sortierte eindeutige
`rmm-general-startup-rollback-<kanonische-v4-UUID>.timer`-Einträge.
Jeder Uniteintrag enthält `unit`, `unit_file_state`, `composition`, `triggers`
und `triggered_by`. Beziehungen sind sortierte eindeutige bekannte Registrynamen,
keine freie Dateiauswahl oder zukünftige Readererlaubnis. `composition` ist exakt
wie im unveränderten OSport die geordnete `Vec<(path, FileProof)>`: Fragment
zuerst, dann tatsächliche DropInPaths-Reihenfolge. Der Hash derselben JSON-
Bytefolge muss bei den Policydiensten passen; FileProof enthält insbesondere
Original-Device/Inode, nicht nur ContentSHA. Geschützte systemd-Fragmente und
höchstens16 `.conf`-Dropins werden unter den bekannten systemd-Systemverzeichnissen
gebunden, insgesamt höchstens128 Blätter. Global-/Prefixdropins sind möglich,
aber kein unbekannter Zusatz wird ignoriert. Leere Komposition und leerer
UnitFileState sind ausschließlich bei einem absent/not-found-Nichtreader gültig.
Die21 Einträge sind zunächst diese7 Services: Agentremote, Helpercloud,
Fullmaintenance, Updater, APThelper, Legacy`rmm-agent` und
Legacy`rmm-helper-dev-test`. Danach folgen für dieselben7 Basen jeweils `.socket`
und `.timer`. Vollständige feste Namen stehen in der Quellkonstante `SERVICES`.
`rmm-mvp-test.service` ist eine Wartungsfixture, kein registrierter Reader;
dieser Baustein fragt sie nicht ab und steuert sie niemals.
Der feste Readervertrag bindet: Roothelper erwerben das bestehende
`executor.lock` vor SQLiteopen und jeder SQL-/Effektoperation; der Agent hält
die vorhandene `agent.lock` schon vor Öffnung beider Agentdatenbanken lebenslang;
alle erlaubten Reader verstehen Update-/Handoff-/Inflightdecoder. Registry-
Parsing beweist diese Code-/Bootstrapeigenschaften nicht selbst. Die tatsächliche
separat qualifizierte Baseline, Originalsignaturen und Census/Locks bleiben
Pflicht. Eine Registry oder ein flock allein verspricht keine globale Abwesenheit
zukünftiger exec-Aufrufe oder willentlicher vertrauenswürdiger Rootneustarts.
`verify_admission` verlangt genau Agent/General/Full/Updater loaded/active/running
mit echten ServiceMainPIDs, ControlPID0, ohne ausstehenden Start-/Controljob.
`verify_stopped` verlangt Agent/General/Full inactive/dead mit tatsächlichen
Main-/ControlPIDs0; der Updater bleibt aktiv. Der originale UnitFileState bleibt
für alle vier exakt gebunden, enabled oder disabled. Ein aktivierter Full- oder
Updaterdienst muss deshalb nicht heimlich enabled werden. APT ist optional nur
als tatsächlich gebundener Policydienst vorhanden, bleibt geschlossen und
gehört niemals ins Startset. Legacyservices und Gegenstücke sind absent oder
loaded/inactive/dead/disabled; aktuelle unbekannte Rollbacktimer verweigern.
Die read-only Systemdaufrufe sind ausschließlich `/usr/bin/systemctl --system
--no-ask-password --no-pager --full show --all` mit festen Properties/Namen und
zwei begrenzte `list-units`-/`list-unit-files`-Aufrufe mit festem historischem
Rollbacktimerpattern. Kein Shellglob, Pager, Authdialog, start/stop/enable oder
freie Commandline. Jede eigene Abfrage hat10s und das zusätzliche ursprüngliche
`Budget`; stdout/stderr je16KiB. Nur der eigene gehaltene pidfd-Prozess wird bei
Abbruch beendet, keine fremde PID übernommen. Statuswerte und fremde Prozess-
oder Mappfade werden nicht in Fehlermeldungen ausgegeben.
Typen werden nicht erfunden: Service besitzt MainPID und ControlPID, Socket
nur ControlPID und eine tatsächliche aktuelle Verbindungsanzahl; Timer besitzt
keine PID-Eigenschaft. Fehlende anwendbare Properties verweigern. Timer/dead
bedeutet im [Systemd-Primärvertrag](https://github.com/systemd/systemd/blob/main/src/core/timer.c)
disarmierte Timereventquellen; Socket/dead ist keine Listenactivation. Es wird
kein nicht vorhandenes MainPID als gemessene0 ausgegeben.
[DBus-Typvertrag](https://www.freedesktop.org/software/systemd/man/latest/org.freedesktop.systemd1.html).
Die ausgewählte `Job`-Property muss vorhanden sein; deren leere Ausgabe mit
`--all` ist Systemctls Darstellung des tatsächlichen Nulljobs.
[Primärformatter](https://github.com/systemd/systemd/blob/main/src/systemctl/systemctl-show.c).
`Triggers`/`TriggeredBy` sind strukturelle Beziehungen und werden exakt gegen
die Registry gebunden. Ihre Namen allein werden nicht als laufendes Ereignis
missverstanden. Alle relevanten registrierten Aktivierungsquellen müssen
unabhängig geschlossen sein; offene oder unbekannte Pfade verweigern. Allgemeine
WantedBy-Systemtargets werden damit nicht pauschal zu zu stoppenden Readern.
Alle Statusfelder werden vor und nach der Prüfung identisch erneut gelesen,
Registry/Unitblätter sowie aktueller Hostkontext erneut geprüft. Das ist eine
begrenzte Momentaufnahme unter den weiteren Originalgrenzen, kein Futureexec-
oder lückenloser Kernel-Snapshotbeweis.
Dieser Worker hat keine Target-/SSH-/Job-/Scope-/Dienst-/Policyaktion oder
Systemdprobe ausgeführt. Compiler-/Format-/Clippyprüfung und unabhängiger
Quellenreview werden durch den koordinierenden Owner nach diesem Quellenhandoff
ausgeführt und separat berichtet. Die kleine Parserprobe verwendet ausschließlich
synthetische Statusbytes, keine tatsächliche Registry oder laufende Units.
+21 -2
View File
@@ -135,9 +135,28 @@ unveröffentlicht; kein Cloud-VM-Apply, kein Produktfertig- oder Produktionsnach
Nach dem gepushten gemeinsamen Checkpoint8e93c9e und dem erhaltenden Mainmerge
07d6118 ist die bisher offene Enginefolge als konkrete Workerquelle verbunden.
Ihr Eintritt bleibt explizit `UPDATE_READER_CENSUS_NOT_CONFIGURED`; weder
Daemonentrypoint noch Job-/Applycapability wird aktiviert. Die genaue
Dieser historische Stand sperrte den Eintritt explizit mit
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die folgende lokale Fortschreibung hat
Registry und Readercensus im Quellpfad verbunden; weiterhin wird weder ein
Daemonentrypoint noch eine Job-/Applycapability aktiviert. Die genaue
Queue-/Reply-/Stop-/Lock-/Swap-/Start-/Healthfolge und vorhandene separate
Agent-Singletonsperre stehen in [worker](agent-updater-worker.md). Der neu
geprüfte öffentliche Recordbuilder löst die zuvor dort genannte fehlende
positive authentisierte Eingangsprobe. Keine reale Applyabnahme folgt daraus.
## Fortschreibung2026-11-15: Readerregistry und vollständige Task-FD-Prüfung
Der gemeinsame Quellsatz verbindet Registryprüfung, ursprüngliche Agent- und
Root-Executorsperre sowie TGID-/TID-FD-/maps-Prüfung mit der bestehenden Engine.
Vor SQLiteöffnung verlangt der Ledgerport den nicht frei konstruierbaren
`ClosedReaders`-Beleg und den tatsächlich gehaltenen ursprünglichen Rootguard.
Das ist ein lokaler Quellen-/Vertragspunkt, kein gestarteter Dispatcher und
keine Zusage über zukünftige privilegierte Fremdprozesse.
Der eingefrorene71-Input-Quellsatz besteht lokal alle10 vorhandenen Workerguards,
locked all-targets Check, Release-Link, Clippy mit `-D warnings` und Formatcheck.
Ein eigener Runner ist ausschließlich für zwei eigene native Prozessfixtures
vorbereitet; er ist noch nicht ausgeführt. Details, frühere fehlgeschlagene
Fixtureprüfung und verbleibende MVP-Gates stehen im
[Readercensusnachweis](agent-updater-reader-census-results.md).
+11 -7
View File
@@ -186,14 +186,18 @@ DBclose/Rootlockreturn gehalten und wird vor der festen Startfolge zurückgegebe
Der Agent hält schon heute seine ursprüngliche Singletondatei vor beiden
Agent-SQLiteöffnungen; keine ACL, Agentdatei oder Sperrrolle wurde geändert.
**Explizite Sperre dieses Checkpoints:** `Runtime::serve_one` verweigert mit
`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Geschützte kompatible Bootstrapregistry
plus vollständige aktuelle PID-/FD-/maps-Census und Nachstopbeobachtung unter
beiden tatsächlichen Sperren fehlen noch. Eine bekannte Unitliste ersetzt
keinen Census. Keine CLI oder RMM-Admission ruft diese Runtime auf; Applycaps
bleiben geschlossen. Ebenso offen: Staging-/Downloadproducer, passiver gültiger
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, qualifizierte Dienstkontexte und tatsächlicher Linux-Apply.
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/`.