17 releases

Uses old Rust 2015

0.5.5 Oct 31, 2023
0.5.4 Dec 9, 2022
0.5.2 Aug 16, 2022
0.4.4 Mar 1, 2022
0.1.2 May 23, 2017

#9 in Unix APIs

Download history 35112/week @ 2024-02-26 29233/week @ 2024-03-04 35708/week @ 2024-03-11 38193/week @ 2024-03-18 38843/week @ 2024-03-25 44045/week @ 2024-04-01 34298/week @ 2024-04-08 36926/week @ 2024-04-15 38254/week @ 2024-04-22 35775/week @ 2024-04-29 34013/week @ 2024-05-06 39105/week @ 2024-05-13 39808/week @ 2024-05-20 34723/week @ 2024-05-27 38053/week @ 2024-06-03 40191/week @ 2024-06-10

154,765 downloads per month
Used in 163 crates (45 directly)

MIT license

88KB
2K SLoC

This crate provides a safe interface for reading and writing information to the kernel using the sysctl interface.

Build Status

Current Version

FreeBSD, Linux, macOS and iOS are supported. Contributions for improvements and other platforms are welcome.

Documentation

Documentation is available on docs.rs

Usage

Add to Cargo.toml

[dependencies]
sysctl = "*"

macOS/iOS

  • Due to limitations in the sysctl(3) API, many of the methods of the Ctl take a mutable reference to self on macOS/iOS.
  • Sysctl descriptions are not available on macOS/iOS and Linux.
  • Some tests failures are ignored, as the respective sysctls do not exist on macos.

Example

sysctl comes with several examples, see the examples folder:

  • value.rs: shows how to get a sysctl value
  • value_as.rs: parsing values as structures
  • value_string.rs: parsing values as string. Use this for cross platform compatibility since all sysctls are strings on Linux.
  • value_oid_as.rs: getting a sysctl from OID constants from the libc crate.
  • set_value.rs: shows how to set a sysctl value
  • struct.rs: reading data into a struct
  • temperature.rs: parsing temperatures
  • iterate.rs: showcases iteration over the sysctl tree

Run with:

$ cargo run --example iterate

Or to use in your program:

extern crate sysctl;
use sysctl::Sysctl;

fn main() {
    let ctl = sysctl::Ctl::new("kern.osrevision").unwrap();
    println!("Description: {}", ctl.description().unwrap());
    println!("Value: {}", ctl.value_string().unwrap());
}

Dependencies

~0.5–8.5MB
~64K SLoC