docs(goobj): document the GOOBJ object file format

2026-09-21 19:19:53 +02:00
parent 123a16e346
commit 03a964bb2d
3 changed files with 669 additions and 3 deletions
@@ -9,6 +9,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

 ### Added

+- **GOOBJ format specification.**  [docs/GOOBJ.md](docs/GOOBJ.md)
+  documents the Go object file format in full: both containers, the 96
+  byte header and all 19 blocks, every structure with its byte
+  offsets, symbol kinds and flag bits, all 106 relocation types with
+  the weak variants, aux symbols, the FuncInfo payload, the pc-value
+  table encoding, the content hashes and the builtin table, all
+  verified byte for byte against objects produced by Go 1.27.1's own
+  tools.
 - **Macro expansion and include splicing.**  `gasm asm`, `gasm diff` and
  `gasm audit-instructions` now preprocess assembly the way the
  toolchain does: object and parameterised `#define` macros expand at