commit 1a5dcff8e440fab2d7e9bdefe646ba3943fc122a (tree)
parent 013a22896015619e23858ae3fbfc92317af574eb
Author: Jan200101 <sentrycraft123@gmail.com>
Date: Sat, 5 Apr 2025 22:11:07 +0200
std.Build: update build-id flag description
it now denotes:
- all supported styles
- what a given style outputs
- what formats a given style supports
Diffstat:
2 files changed, 14 insertions(+), 8 deletions(-)
diff --git a/lib/compiler/build_runner.zig b/lib/compiler/build_runner.zig
@@ -1373,10 +1373,13 @@ fn usage(b: *std.Build, out_stream: anytype) !void {
\\ --zig-lib-dir [arg] Override path to Zig lib directory
\\ --build-runner [file] Override path to build runner
\\ --seed [integer] For shuffling dependency traversal order (default: random)
- \\ --build-id[=style] At a minor link-time expense, coordinates stripped binaries
- \\ fast, uuid, sha1, md5 with debug symbols via a '.note.gnu.build-id' section
- \\ 0x[hexstring] Maximum 32 bytes
- \\ none (default) Disable build-id
+ \\ --build-id[=style] At a minor link-time expense, embeds a build ID in binaries
+ \\ fast 8-byte non-cryptographic hash (COFF, ELF, WASM)
+ \\ sha1, tree 20-byte cryptographic hash (ELF, WASM)
+ \\ md5 16-byte cryptographic hash (ELF)
+ \\ uuid 16-byte random UUID (ELF, WASM)
+ \\ 0x[hexstring] Constant ID, maximum 32 bytes (ELF, WASM)
+ \\ none (default) No build ID
\\ --debug-log [scope] Enable debugging the compiler
\\ --debug-pkg-config Fail if unknown pkg-config flags encountered
\\ --debug-rt Debug compiler runtime libraries
diff --git a/src/main.zig b/src/main.zig
@@ -570,10 +570,13 @@ const usage_build_generic =
\\ -fno-allow-shlib-undefined Disallows undefined symbols in shared libraries
\\ -fallow-so-scripts Allows .so files to be GNU ld scripts
\\ -fno-allow-so-scripts (default) .so files must be ELF files
- \\ --build-id[=style] At a minor link-time expense, coordinates stripped binaries
- \\ fast, uuid, sha1, md5 with debug symbols via a '.note.gnu.build-id' section
- \\ 0x[hexstring] Maximum 32 bytes
- \\ none (default) Disable build-id
+ \\ --build-id[=style] At a minor link-time expense, embeds a build ID in binaries
+ \\ fast 8-byte non-cryptographic hash (COFF, ELF, WASM)
+ \\ sha1, tree 20-byte cryptographic hash (ELF, WASM)
+ \\ md5 16-byte cryptographic hash (ELF)
+ \\ uuid 16-byte random UUID (ELF, WASM)
+ \\ 0x[hexstring] Constant ID, maximum 32 bytes (ELF, WASM)
+ \\ none (default) No build ID
\\ --eh-frame-hdr Enable C++ exception handling by passing --eh-frame-hdr to linker
\\ --no-eh-frame-hdr Disable C++ exception handling by passing --no-eh-frame-hdr to linker
\\ --emit-relocs Enable output of relocation sections for post build tools
