add crash notes + symbolize tool + symbolized hook dll; README symbol build section
This commit is contained in:
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user