#build #uuid #binary #representing #obtain #segment #uniquely

sys build_id

Obtain a UUID uniquely representing the build of the current binary

8 releases

0.2.1 Nov 24, 2019
0.2.0 Oct 18, 2019
0.1.5 Aug 1, 2019
0.1.4 Jul 26, 2019
0.1.1 Jul 26, 2018

#1699 in Development tools

Download history 304/week @ 2023-12-04 848/week @ 2023-12-11 470/week @ 2023-12-18 154/week @ 2023-12-25 335/week @ 2024-01-01 232/week @ 2024-01-08 193/week @ 2024-01-15 746/week @ 2024-01-22 169/week @ 2024-01-29 298/week @ 2024-02-05 400/week @ 2024-02-12 183/week @ 2024-02-19 235/week @ 2024-02-26 358/week @ 2024-03-04 648/week @ 2024-03-11 781/week @ 2024-03-18

2,037 downloads per month
Used in 11 crates (via relative)

MIT/Apache

11KB
106 lines

build_id

Crates.io MIT / Apache 2.0 licensed Build Status

Docs

Obtain a Uuid uniquely representing the build of the current binary.

This is intended to be used to check that different processes are indeed invocations of identically laid out binaries.

As such:

  • It is guaranteed to be identical within multiple invocations of the same binary.
  • It is guaranteed to be different across binaries with different code or data segments or layout.
  • Equality is unspecified if the binaries have identical code and data segments and layout but differ immaterially (e.g. if a timestamp is included in the binary at compile time).

Examples

let local_build_id = build_id::get();
if local_build_id == remote_build_id {
	println!("We're running the same binary as remote!");
} else {
	println!("We're running a different binary to remote");
}

Note

This looks first for linker-inserted build ID / binary UUIDs (i.e. .note.gnu.build-id on Linux; LC_UUID in Mach-O; etc), falling back to hashing the whole binary.

License

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.5–1.2MB
~19K SLoC