Format:Go buildinfo
| Developer | The Go Authors |
|---|---|
| Versions | pointer form up to Go 1.17, inline form from Go 1.18 |
| Magic | FF 20 47 6F 20 62 75 69 6C 64 69 6E 66 3A ("\xff Go buildinf:"), 16-byte aligned |
| Endianness | flag bit 0 (pointer form only); inline strings are varint-prefixed |
| License | BSD-3-Clause (reference reader: debug/buildinfo) |
| On this wiki | Facts · Code · Notes · Topics |
The 32-byte-header blob that the Go linker puts in every Go executable (ELF section .go.buildinfo, Mach-O __go_buildinfo, a data section in PE): the magic "\xff Go buildinf:", a flags byte and, since Go 1.18, the Go toolchain version and the module/build-settings text stored inline. It is what `go version -m` and runtime/debug.ReadBuildInfo read, and the quickest way to date a Go binary even when it is stripped.
Overview
Every executable written by the Go linker (cmd/link) carries a build-info blob that the standard library can read back without running the program: debug/buildinfo.ReadFile (used by go version -m file) and runtime/debug.ReadBuildInfo inside the program. It names the Go toolchain version (go1.24.0), and, for module-aware builds, the main module path and version, every dependency module with its version and hash, and the build settings (-buildmode, -compiler, CGO_ENABLED, GOARCH, GOOS, vcs.revision, vcs.time, ...). The blob lives in a data section of its own, so it survives stripping. It complements Format:Go pclntab (function names and line tables) and belongs to the build of Library:Go runtime: the runtime version and the toolchain version are the same string.
Locating the blob
The blob starts with the 14 bytes FF 20 47 6F 20 62 75 69 6C 64 69 6E 66 3A (\xff Go buildinf:) at an offset that is a multiple of 16. The reference reader (DataStart and searchMagic in src/debug/buildinfo/buildinfo.go) looks only at hits on 16-byte boundaries and reads the file in 1 MB chunks. Where it looks first depends on the container:
- ELF: section
.go.buildinfo. - Mach-O: section
__go_buildinfo. - PE: the first writable, initialised data section (no dedicated section name).
- XCOFF: the
STYP_DATAsection. Plan 9: sectiondata.
In a raw memory dump or an unknown container, search the whole file for the magic and keep a hit whose offset is a multiple of 16.
Header (32 bytes)
| Offset | Size | Field |
|---|---|---|
| 0 | 14 | magic \xff Go buildinf:
|
| 14 | 1 | ptrSize (4 or 8; used only by the pointer form) |
| 15 | 1 | flags |
| 16 | ptrSize | versPtr (pointer form only) |
| 16+ptrSize | ptrSize | modPtr (pointer form only) |
The flags byte: bit 0 is the byte order of the pointer form (0 little, 1 big); bit 1 (0x2) selects the string form: 0 = pointer form, 2 = inline form.
Inline form (Go 1.18 and later, flags & 2)
The header is padded to 32 bytes and followed directly by two strings, each a uvarint length and the bytes: first the Go version, then the module info. A reader that finds flags 0x02 (or 0x03 for big-endian targets) can ignore ptrSize.
Pointer form (Go up to 1.17, flags & 2 == 0)
versPtr and modPtr are virtual addresses (ptrSize bytes, in the byte order given by flag bit 0) of Go string headers (pointer, length) elsewhere in the binary, so the file must be mapped through its section table to follow them (relocations apply in PIE builds). ptrSize other than 4 or 8 means "not a Go executable" to the reference reader.
Module info text
The second string is the module information: if it is at least 33 bytes long and byte len-17 is \n, the real text is the part between a 16-byte start marker and a 16-byte end marker (30 77 AF 0C 92 74 08 02 41 E1 C1 07 E6 D6 18 E6 and F9 32 43 31 86 18 20 72 00 82 42 10 41 16 D8 F2, infoStart and infoEnd in cmd/go/internal/modload), which exist so that the linker-injected text can be found in a binary. The text is tab-separated lines, as printed by go version -m: path, mod, dep, => (replace) and build lines. The reader reports the Go version from the first string even if the module text is absent (non-module builds, or text without the markers).
Code & repositories
- https://github.com/golang/go @
dfc6f7db9bd75868ffb5cbc9501a2f4899122d2f· license: BSD-3-Clause
The Go source tree; src/debug/buildinfo/buildinfo.go is the reference reader of the build-info blob, src/cmd/go/internal/modload/build.go holds the module-info markers.
Tested on: source read, not run: source read at the pinned commit (sparse checkout of src/debug/buildinfo and src/cmd/go/internal/modload); nothing built or run · checked 2026-10-18; last activity 2026-10-17
Pitfalls
- A stripped or UPX-packed Go binary can lose the section name but still has the magic inside its data; searching for the magic works regardless.
-trimpathremoves local paths from the text but not the version or the module list.-ldflags=-s -wdoes not remove the blob.- A false hit is possible in any file that contains the Go linker's own source or a copy of this string; check the 16-byte alignment and the flags byte.
Open questions
- Unverified: the header version bit is documented only as "since 1.18"; the exact Go release that first wrote the module text (go1.13
go version -m) and the layout of 1.13-1.17 pointer-form binaries were not checked against real binaries.
Evidence & references
- golang/go
src/debug/buildinfo/buildinfo.goat commit dfc6f7db9bd75868ffb5cbc9501a2f4899122d2f (header comment, flags constants,searchMagic,DataStart);src/cmd/go/internal/modload/build.go(infoStart,infoEnd). - Not tested on real binaries in this session; read from the source only.