is_sudo 0.0.2

Checks whether the process is running as root/sudo/admin permission in Windows and Unix systems
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

#![allow(clippy::bool_comparison)]

/// Cross platform representation of the state the current program running
#[derive(Debug, PartialEq, Eq)]
pub enum RunningAs {
    /// Root (Linux/Mac OS/Unix) or Administrator (Windows)
    Root,
    /// Running as a normal user
    User,
}

#[cfg(windows)]
mod window;

#[cfg(any(test, unix))]
fn running_as_from_unix_ids(_uid: u32, euid: u32) -> RunningAs {
    if euid == 0 {
        RunningAs::Root
    } else {
        RunningAs::User
    }
}

#[cfg(any(test, windows))]
fn running_as_from_elevation(is_elevated: bool) -> RunningAs {
    if is_elevated {
        RunningAs::Root
    } else {
        RunningAs::User
    }
}

#[cfg(unix)]
/// This checks whether the current process is running as sudo or not.
/// Returns the RunningAs enum as result
/// # Examples
/// ```rust
/// use is_sudo::RunningAs;
/// let running_as = is_sudo::check();
/// match running_as {
///     RunningAs::Root => println!("Running as root"),
///     RunningAs::User => println!("Running as user"),
/// }
/// ```
pub fn check() -> RunningAs {
    let uid = unsafe { libc::getuid() } as u32;
    let euid = unsafe { libc::geteuid() } as u32;

    running_as_from_unix_ids(uid, euid)
}

#[cfg(windows)]
/// This checks whether the current process is running as admin(root) or not.
/// Returns the RunningAs enum as result
/// # Examples
/// ```rust
/// use is_sudo::RunningAs;
/// let running_as = is_sudo::check();
/// match running_as {
///     RunningAs::Root => println!("Running as root"),
///     RunningAs::User => println!("Running as user"),
/// }
/// ```
pub fn check() -> RunningAs {
    running_as_from_elevation(window::is_app_elevated())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn unix_ids_report_root_for_root_process() {
        assert_eq!(running_as_from_unix_ids(0, 0), RunningAs::Root);
    }

    #[test]
    fn unix_ids_report_root_for_sudo_process() {
        assert_eq!(running_as_from_unix_ids(1000, 0), RunningAs::Root);
    }

    #[test]
    fn unix_ids_report_user_when_privileges_are_dropped() {
        assert_eq!(running_as_from_unix_ids(0, 1000), RunningAs::User);
    }

    #[test]
    fn unix_ids_report_user_for_regular_user() {
        assert_eq!(running_as_from_unix_ids(1000, 1000), RunningAs::User);
    }

    #[test]
    fn elevation_reports_root_when_process_is_elevated() {
        assert_eq!(running_as_from_elevation(true), RunningAs::Root);
    }

    #[test]
    fn elevation_reports_user_when_process_is_not_elevated() {
        assert_eq!(running_as_from_elevation(false), RunningAs::User);
    }

    #[cfg(unix)]
    #[test]
    fn check_matches_unix_helper() {
        let uid = unsafe { libc::getuid() } as u32;
        let euid = unsafe { libc::geteuid() } as u32;

        assert_eq!(check(), running_as_from_unix_ids(uid, euid));
    }
}