coreutils_core 0.1.0

A crate with abstractions to implement UNIX core utilities
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

//! Module with abstractions to safely deal with processes.
#[cfg(not(any(target_os = "fuchsia")))]
use std::ffi::CString;
use std::{convert::TryInto, io};

use crate::{
    libc,
    os::{
        group::{Error as GrError, Group, Groups},
        passwd::{Error as PwError, Passwd},
        Gid,
    },
};

#[cfg(not(any(target_os = "fuchsia", target_os = "haiku")))]
pub mod priority;

/// Change the root of the running process to `newroot`.
///
/// # Errors
/// If a internal call set a errno (I/O OS error), an error variant will be returned.
#[cfg(not(any(target_os = "fuchsia")))]
pub fn change_root(newroot: &str) -> io::Result<()> {
    std::env::set_current_dir(newroot)?;

    let error = unsafe {
        libc::chroot(CString::new(".").unwrap().as_bytes_with_nul().as_ptr() as *const libc::c_char)
    };

    match error {
        0 => Ok(()),
        _ => Err(io::Error::last_os_error()),
    }
}

/// Set the `user` for the current process.
///
/// # Errors
/// If a internal call set a errno (I/O OS error) or it fails to get [`Passwd`], an error
/// variant will be returned.
///
/// [`Passwd`]: ../passwd/struct.Passwd.html
pub fn set_user(user: &str) -> Result<(), PwError> {
    let user = Passwd::from_name(user)?;

    match unsafe { libc::setuid(user.uid()) } {
        0 => Ok(()),
        _ => Err(PwError::Io(io::Error::last_os_error())),
    }
}

/// Set the `groups` for the current process.
///
/// # Errors
/// If a internal call set a errno (I/O OS error) or it fails to get [`Groups`], an error
/// variant will be returned.
pub fn set_groups(groups: &[&str]) -> Result<(), GrError> {
    let groups = Groups::from_group_list(&groups)?;
    let groups: Vec<Gid> = groups.iter().map(|g| g.id()).collect();

    match unsafe { libc::setgroups(groups.len().try_into().unwrap(), groups.as_ptr()) } {
        0 => Ok(()),
        _ => Err(GrError::Io(io::Error::last_os_error())),
    }
}

/// Set the `group` for the current process.
///
/// # Errors
/// If a internal call set a errno (I/O OS error) or it fails to get [`Group`], an error
/// variant will be returned.
pub fn set_group(group: &str) -> Result<(), GrError> {
    let group = Group::from_name(group)?;

    match unsafe { libc::setgid(group.id()) } {
        0 => Ok(()),
        _ => Err(GrError::Io(io::Error::last_os_error())),
    }
}