ver-stub-tool

CLI tool for injecting version data into binaries using ver-stub.

Installation

cargo install ver-stub-tool
rustup component add llvm-tools

Example Usage

Patch a binary directly

cargo build --release
ver-stub --all-git --build-timestamp patch target/release/my-bin

This produces a patched binary at target/release/my-bin.bin.

Generate section data file

For use with cargo objcopy or other tools:

ver-stub --all-git --build-timestamp -o target/ver_stub_data
cargo objcopy --release --bin my-bin -- --update-section ver_stub=target/ver_stub_data my-bin.bin

Options

This tool exposes CLI parameters for the functionality in ver-stub-build. Run ver-stub --help for the full list of options.

Reproducible Builds

For reproducible builds, two environment variables are supported:

• VER_STUB_IDEMPOTENT: If set, build timestamp/date are never included (always None). This is the simplest option for fully reproducible builds.

• VER_STUB_BUILD_TIME: Override the build timestamp with a fixed value. Accepts unix timestamps or RFC 3339 datetimes.

VER_STUB_IDEMPOTENT takes precedence if both are set.

See Also

• ver-stub - Runtime library for reading version data
• ver-stub-build - Build script helper (used by this tool)
• Main documentation - Full usage instructions and examples