Struct MockPwdGrpProvider 

pub struct MockPwdGrpProvider(/* private fields */);

Mock provider of passwd/group data

An implementor of PwdGrpProvider which doesn’t look at the real system databases.

The Default contains just dummy entries for root.

You can pre-program it with passwd and group data.

The mock provider has interior mutability, so the trait can take non-mut references.

Note: this affects only the methods on PwdGrpProvider, not the plain functions in the pwd-grp crate toplevel.

Example

use pwd_grp::Group;
use pwd_grp::mock::MockPwdGrpProvider;
use pwd_grp::PwdGrpProvider as _;

let mock = MockPwdGrpProvider::new();
assert_eq!(mock.getgrnam::<String>("root").unwrap().unwrap().gid, 0);

mock.add_to_groups([Group {
    name: "wombats".to_string(),
    passwd: "*".to_string(),
    gid: 42,
    mem: vec!["alice".to_string()].into(),
    ..Group::blank()
}]);
let grent: Group = mock.getgrgid(42).unwrap().unwrap();
assert_eq!(grent.passwd, "*");

Implementations

impl MockPwdGrpProvider

pub fn new() -> Self

Create a new MockPwdGrpProvider containing dummy entries for root

impl MockPwdGrpProvider

pub fn new_empty() -> Self

Create a new empty MockPwdGrpProvider

All lookups will return None

pub fn add_to_passwds<I>(&self, data: impl IntoIterator<Item = I>)

where I: Into<Passwd<Box<[u8]>>>,

Append entries to the mock passwd database

pub fn add_to_groups<I>(&self, data: impl IntoIterator<Item = I>)

where I: Into<Group<Box<[u8]>>>,

Append entries to the mock group database

pub fn set_uids(&self, uids: RealEffectiveSavedIds)

Set the mock uids

pub fn set_gids(&self, gids: RealEffectiveSavedIds)

Set the mock gids

pub fn set_supplementary_groups(&self, supplementary_groups: Vec<uid_t>)

Set the mock supplementary_groups

Trait Implementations

impl Clone for MockPwdGrpProvider

fn clone(&self) -> MockPwdGrpProvider

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MockPwdGrpProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MockPwdGrpProvider

fn default() -> MockPwdGrpProvider

Returns the “default value” for a type.

impl PwdGrpProvider for MockPwdGrpProvider

fn getpwnam<S: PwdGrpString>( &self, name: impl AsRef<<S as Deref>::Target>, ) -> Result<Option<Passwd<S>>>

Look up a passwd entry by name, returning strings as S

fn getpwuid<S: PwdGrpString>(&self, uid: uid_t) -> Result<Option<Passwd<S>>>

Look up a passwd entry by uid, returning strings as S

fn getgrnam<S: PwdGrpString>( &self, name: impl AsRef<<S as Deref>::Target>, ) -> Result<Option<Group<S>>>

Look up a group entry by name, returning strings as S

fn getgrgid<S: PwdGrpString>(&self, gid: uid_t) -> Result<Option<Group<S>>>

Look up a group entry by gid, returning strings as S

fn getuid(&self) -> uid_t

Get the current process’s (real) uid

fn geteuid(&self) -> uid_t

Get the current process’s effective uid

fn getresuid(&self) -> (uid_t, uid_t, uid_t)

Get the current process’s real, effective and saved set-uid

fn getgid(&self) -> uid_t

Get the current process’s (real) gid

fn getegid(&self) -> uid_t

Get the current process’s effective gid

fn getresgid(&self) -> (uid_t, uid_t, uid_t)

Get the current process’s real, effective and saved set-gid

fn getgroups(&self) -> Result<Vec<uid_t>>

Get the current process’s supplementary group list

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 8 bytes