6 releases (breaking)
0.5.1 | Aug 8, 2023 |
---|---|
0.5.0 | Jul 29, 2023 |
0.4.0 | Jul 11, 2023 |
0.3.0 | Mar 30, 2023 |
0.1.0 | Oct 2, 2018 |
#209 in Filesystem
12,004 downloads per month
Used in 16 crates
(10 directly)
11KB
129 lines
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
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
Dependencies
~0–9.5MB
~82K SLoC