microfetch 0.4.13

Microscopic fetch tool in Rust, for NixOS systems, with special emphasis on speed
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

pub mod colors;
pub mod desktop;
pub mod release;
pub mod syscall;
pub mod system;
pub mod uptime;

use std::mem::MaybeUninit;

/// Wrapper for `libc::utsname` with safe accessor methods
pub struct UtsName(libc::utsname);

impl UtsName {
  /// Calls `uname` syscall and returns a `UtsName` wrapper
  ///
  /// # Errors
  ///
  /// Returns an error if the `uname` syscall fails
  pub fn uname() -> Result<Self, std::io::Error> {
    let mut uts = MaybeUninit::uninit();
    if unsafe { libc::uname(uts.as_mut_ptr()) } != 0 {
      return Err(std::io::Error::last_os_error());
    }
    Ok(Self(unsafe { uts.assume_init() }))
  }

  #[must_use]
  pub const fn nodename(&self) -> &std::ffi::CStr {
    unsafe { std::ffi::CStr::from_ptr(self.0.nodename.as_ptr()) }
  }

  #[must_use]
  pub const fn sysname(&self) -> &std::ffi::CStr {
    unsafe { std::ffi::CStr::from_ptr(self.0.sysname.as_ptr()) }
  }

  #[must_use]
  pub const fn release(&self) -> &std::ffi::CStr {
    unsafe { std::ffi::CStr::from_ptr(self.0.release.as_ptr()) }
  }

  #[must_use]
  pub const fn machine(&self) -> &std::ffi::CStr {
    unsafe { std::ffi::CStr::from_ptr(self.0.machine.as_ptr()) }
  }
}