10 releases
0.4.0 | Apr 1, 2024 |
---|---|
0.3.1 | Feb 28, 2020 |
0.3.0 | Dec 19, 2019 |
0.2.0 | Nov 9, 2019 |
0.1.2 | Dec 13, 2016 |
#15 in Operating systems
2,802,591 downloads per month
Used in 1,598 crates
(231 directly)
13KB
226 lines
hostname
Cross-platform system's host name functions in Rust
Supported platforms
- POSIX-compliant systems
(Linux, macOS, Android, FreeBSD, OpenBSD, NetBSD, Solaris, Redox, and so on) - Windows
Rust version requirements
Since version 0.4.0
this crate requires Rust version 1.67.0
or greater.
This version is explicitly tested in CI
and may be bumped in any major or minor release as needed.
Maintaining compatibility with older compilers is a priority though,
so the bar for bumping the minimum supported version is set very high.
Any changes to the supported minimum version will be called out in the release notes.
Usage
Add the following dependency to your Cargo manifest:
[dependencies]
hostname = "^0.4"
Crate API provides two simple functions for retrieving and setting the system's host name:
use std::io;
fn main() -> io::Result<()> {
// Retrieve the hostname
dbg!(hostname::get()?);
// And set a new one
hostname::set("potato")?;
Ok(())
}
License
hostname is primarily distributed under the terms of the MIT license (LICENSE or http://opensource.org/licenses/MIT).
Dependencies
~0–35MB
~523K SLoC