72 lines
4.2 KiB
Markdown
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.
|