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, SHA2567b8019c151f3953261b3afbbea1b59ca7112ab09c7a2911d24d17921d6fd6adf. - Version1.1.0: ASCII
RustDiscovery EXE fixture 1.1.0\r\n, SHA256e1da48d2a8b89d66db822c24dc2ef7a0cfc13bce11875f15157d03081979d3f0. - Registry HKLM64
SOFTWARE\RustDiscovery\ExeFixture, genau7Werte und keine Unterkeys:ProductId=RustDiscovery.ExeFixture,Version,PayloadSHA256,Architecture=x64,Context=machinejeweilsREG_SZ;PayloadBytes=33undNoReboot=1jeweilsREG_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.