add crash notes + symbolize tool + symbolized hook dll; README symbol build section

This commit is contained in:
2026-10-06 19:12:03 +08:00
parent ea618c1462
commit 54a229a3c5
4 changed files with 129 additions and 1 deletions
+20 -1
View File
@@ -17,7 +17,7 @@ Grab the tarball from the [latest release](https://gitea.mygoband.com/carrydela/
check `sha256sum`, extract, put `mint` on your PATH:
```bash
curl -fLO https://gitea.mygoband.com/carrydela/mint-linux/releases/download/v0.1.0/mint-linux-x86_64.tar.gz
curl -fLO https://gitea.mygoband.com/carrydela/mint-linux/releases/download/v0.1.1/mint-linux-x86_64.tar.gz
sha256sum -c mint-linux-x86_64.tar.gz.sha256 # download the .sha256 alongside
tar -xzf mint-linux-x86_64.tar.gz
install -m 0755 mint /usr/local/bin/
@@ -52,6 +52,25 @@ the hook DLL is embedded into the Linux binary via Cargo artifact dependency
itself to `FSD/Binaries/Win64/x3daudio1_7.dll` when installing mods.
Binary is stripped.
## Symbol build (crash triage)
To resolve crash offsets (e.g. `X3DAudio1_7.dll + 0x521F15` from a Proton crash log)
into Rust symbols, build the hook with debug info and symbolize:
```bash
# one-off profile override (see [profile.release.package.hook] in Cargo.toml)
cargo +nightly-2026-04-24 build --package mint --release
# symbolize RVAs against the debug hook.dll (image base 0x180000000)
python3.12 symbolize_hook.py <hook.dll> 0x521f15 0x57bff 0x54351
# or directly:
x86_64-w64-mingw32-addr2line -Cfipe <hook.dll> 0x180521f15 0x180057bff 0x180054351
```
A debug-symbolized DLL matching the shipped code layout is attached to the
release as `hook-debug-symbolized.dll`. See `CRASH-NOTES.md` for the
MINT HOOK FAILED analysis.
## Files
- `install.sh` — one-click installer (see above)