Files
rust-discovery/tools/windows-exe-fixture/README.md
T
2026-11-14 15:12:01 +01:00

4.2 KiB

Eigene EXE-Fixture: nur Artefaktauthoring

Stand 2026-11-14. Dieser eigenständige C-Quelltext ist nicht in Domain, Agent, Helper, Policy, Capability oder Backend eingebunden. Spezifikation1.19 bleibt der enge MSI-Vertrag; dieses zusätzliche EXE-Artefakt erteilt keine Ausführungserlaubnis und ändert diesen Vertrag nicht. Keine Installation auf Notebook oder VM durch den Builder. Die späteren EXE-Rezept-/Provider-/WebUI- und nativen Fehlerabnahmen fehlen.

Die beiden fest kompilierten Versionen 10 / 11 bedeuten1.0.0 /1.1.0. Einziger Installeraufruf ist jeweils --quiet --norestart in genau dieser Reihenfolge. Es gibt keinen Pfad-, URL-, Command-, Repair-, Uninstall- oder Rebootparameter. Der Prozess muss tatsächlich SYSTEM sein. Kein Netzwerk, Dienststart, Unterprozess oder Neustartaufruf.

Feste eigene Nachbedingungen, getrennt vom MSI:

  • Datei C:\Program Files\RustDiscoveryFixtures\exe-payload.txt, genau33Bytes.
  • Version1.0.0: ASCII RustDiscovery EXE fixture 1.0.0\r\n, SHA256 7b8019c151f3953261b3afbbea1b59ca7112ab09c7a2911d24d17921d6fd6adf.
  • Version1.1.0: ASCII RustDiscovery EXE fixture 1.1.0\r\n, SHA256 e1da48d2a8b89d66db822c24dc2ef7a0cfc13bce11875f15157d03081979d3f0.
  • Registry HKLM64 SOFTWARE\RustDiscovery\ExeFixture, genau7Werte und keine Unterkeys: ProductId=RustDiscovery.ExeFixture, Version, PayloadSHA256, Architecture=x64, Context=machine jeweilsREG_SZ; PayloadBytes=33 und NoReboot=1 jeweilsREG_DWORD. Registry ist unabhängig von der Nutzdatei lesbar.
Zielartefakt Vollständiger Ausgangsbestand Entscheidung
1.0 Key und Datei fehlen Erstinstallation
1.0 Registry und Datei exakt1.0 Noop, keine Writeoperation
1.0 Exakt1.1 oder irgendein Teil-/Fremdzustand Verweigern
1.1 Registry und Datei exakt1.0 Upgrade auf1.1
1.1 Registry und Datei exakt1.1 Noop, keine Writeoperation
1.1 Leer oder irgendein Teil-/Fremdzustand Verweigern

Der bestehende geschützte Fixtureordner muss vorab vorhanden sein; der Installer repariert keine Ordner/ACL. Gehaltene Elternhandles verweigern Umbenennung, Reparse- und Hardlinkblätter werden verweigert, nur SYSTEM/Administrators dürfen an Zielobjekten schreiben. Die Nutzdatei wird beim Upgrade anhand ihrer ursprünglichen File-ID und Bytes erneut geprüft und exklusiv gegen weitere Writer gehalten. Registrylinks/Fremdwerte werden nicht übernommen. Neue eigene Datei-/Registryobjekte bekommen SYS/Admin-Schreibrechte und Benutzer-Leserechte; eine vorhandene ACL wird nicht verändert.

Nicht atomar: Nutzdatei und Registry sind getrennte Wirkungen. Exit0 bedeutet nur das vom Fixtureprozess selbst bestätigte vollständige Ergebnis oder Noop; ein künftiger Provider muss Registry und Datei unabhängig nachprüfen. Exit10 verweigert vor einer eigenen Mutation. Exit20 bedeutet mögliche/teilweise Wirkung nach der ersten Datei-/Keymutation, ausdrücklich unknown, kein Retry, Rollback, Repair oder Freigabe des ursprünglichen Versuchs. Timeout/Prozessverlust nach Übergabe kann unabhängig vom Exit ebenfalls unknown bedeuten. Diese eigenen Exitcodes sind keine MSI-Exitsemantik.

Lokaler Build

Geplanter Builderaufruf: python3 tools/windows-exe-fixture/build.py. Der Builder verwendet nur das gepinnte vorhandene GNU-Buildimage, Netzwerk aus, keine Hostinstallation. Er kompiliert/runnt zuerst den reinen Linux-Guard, kompiliert dessen Windows-PE sowie beide Installer, erhält Original- und Stripdateien und speichert einen create-only privaten Quell-/Compiler-/Hash- Beleg unter devstate/windows-exe-fixture/build-<UUID>/. Er führt keine Windows-EXE aus. Gehashte Fixtureartefakte sind zunächst bewusst unsigniert; das ist kein Produktions-Signier- oder Installationsnachweis.

contract_test.c prüft ausschließlich die feste Zustands-/CLI-Matrix, ohne Datei/Registry/Netz und ohne Simulation einer Installerwirkung. Derselbe Guard muss später zuerst auf der Cloud-Linux-VM, danach auf der Windows-VM laufen. Native HKLM64-/ACL-/File-ID-/Install-/Upgrade-/Noop-/Teilwirkungsnachweise sind noch offen. Jede tatsächliche Installation benötigt einen neuen festen Plan und die reale WebUI-Genehmigung; Bootstrap/SFTP allein ist kein Paketnachweis.