hanaasagi/machine-uid

Get machine id without root permission

machine-uid

Get os native machine id without root permission.

About machine id

In Linux, machine id is a single newline-terminated, hexadecimal, 32-character, lowercase ID. When decoded from hexadecimal, this corresponds to a 16-byte/128-bit value. This ID may not be all zeros. This ID uniquely identifies the host. It should be considered "confidential", and must not be exposed in untrusted environments. And do note that the machine id can be re-generated by root.

Please note that on *nix platforms, this library does not require any dependencies, but on Windows, it requires the winreg dependency. So if you only need to build the *nix version, you can use version 0.3.0.

Usage

use machine_uid;

fn main() {
    let id: String = machine_uid::get().unwrap();
    println!("{}", id);
}

How it works

It get machine id from following source:

Linux or who use systemd:

cat /var/lib/dbus/machine-id # or /etc/machine-id

BSD:

cat /etc/hostid # or kenv -q smbios.system.uuid

OSX:

ioreg -rd1 -c IOPlatformExpertDevice | grep IOPlatformUUID

Windows:

(Get-ItemProperty -Path Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography).MachineGuid

Supported Platform

I have tested in following platform:

• Debian 8
• OS X 10.6
• FeeBSD 10.4
• Fedora 28
• Windows 10

Changelog

v0.5.1

• Upgrade winreg to 0.50 #9
• Upgrade bindgen to 0.66 #8

v0.5.0

• Fix cross-compilation issue #7

v0.4.0

• Fix x86 program run on x64 #4

v0.3.0

• Upgrade winreg to 0.11

v0.2.0

• Added support for Windows

License

MIT License Copyright (c) 2018, Hanaasagi

machine-uid's Issues

Error while cross compiling to Windows from MacOS

Hey there,

since I updated the crate version to 0.4.0 I get the following error when invoking cargo build with the following flags

cargo build --release --target x86_64-pc-windows-gnu

I'm using MacOS Ventura + the latest stable Rust toolchains.

  = note: /opt/homebrew/Cellar/mingw-w64/11.0.0/toolchain-x86_64/bin/x86_64-w64-mingw32-ld: target/x86_64-pc-windows-gnu/release/deps/libmachine_uid-298ed35685296eff.rlib(machine_uid-298ed35685296eff.machine_uid.1208bef349eb5abc-cgu.2.rcgu.o):machine_uid.1208be:(.text+0x54): undefined reference to `MachineUidIsWow64'
          collect2: error: ld returned 1 exit status

  = note: some `extern` functions couldn't be found; some native libraries may need to be installed or have their path specified
  = note: use the `-l` flag to specify native libraries to link
  = note: use the `cargo:rustc-link-lib` directive to specify the native libraries to link with Cargo (see https://doc.rust-lang.org/cargo/reference/build-scripts.html#cargorustc-link-libkindname)

I guess this was introduced via PR #4 .

My current solution is to simply downgrade to version 0.3.0.

Support Android?

Is it possible to add android support?