Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
@@ -1,108 +0,0 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user