users 0.5.3

Library for getting information on Unix users and groups
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

use std::sync::Arc;

pub use libc::{uid_t, gid_t, c_int};

use super::{User, Group};

/// Trait for producers of users.
pub trait Users {

    /// Returns a User if one exists for the given user ID; otherwise, returns None.
    fn get_user_by_uid(&self, uid: uid_t) -> Option<Arc<User>>;

    /// Returns a User if one exists for the given username; otherwise, returns None.
    fn get_user_by_name(&self, username: &str) -> Option<Arc<User>>;

    /// Returns the user ID for the user running the process.
    fn get_current_uid(&self) -> uid_t;

    /// Returns the username of the user running the process.
    fn get_current_username(&self) -> Option<Arc<String>>;

    /// Returns the effective user id.
    fn get_effective_uid(&self) -> uid_t;

    /// Returns the effective username.
    fn get_effective_username(&self) -> Option<Arc<String>>;
}

/// Trait for producers of groups.
pub trait Groups {

    /// Returns a Group object if one exists for the given group ID; otherwise, returns None.
    fn get_group_by_gid(&self, gid: gid_t) -> Option<Arc<Group>>;

    /// Returns a Group object if one exists for the given groupname; otherwise, returns None.
    fn get_group_by_name(&self, group_name: &str) -> Option<Arc<Group>>;

    /// Returns the group ID for the user running the process.
    fn get_current_gid(&self) -> gid_t;

    /// Returns the group name of the user running the process.
    fn get_current_groupname(&self) -> Option<Arc<String>>;

    /// Returns the effective group id.
    fn get_effective_gid(&self) -> gid_t;

    /// Returns the effective group name.
    fn get_effective_groupname(&self) -> Option<Arc<String>>;
}