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

72 lines
4.2 KiB
Markdown

# 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.