Struct users::Group

pub struct Group {
    pub name_arc: Arc<OsString>,
    /* private fields */
}

Information about a particular group.

Fields

name_arc: Arc<OsString>

This group’s name, as an owned OsString possibly shared with a cache. Prefer using the name() accessor to using this field, if possible.

Implementations

impl Group

pub fn new<S: AsRef<OsStr> + ?Sized>(gid: gid_t, name: &S) -> Self

Create a new Group with the given group ID and name, with the rest of the fields filled in with dummy values.

This method does not actually create a new group on the system—it should only be used for comparing groups in tests.

pub fn gid(&self) -> gid_t

Returns this group’s ID.

pub fn name(&self) -> &OsStr

Returns this group’s name.

Trait Implementations

impl Clone for Group

fn clone(&self) -> Group

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Group

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

Formats the value using the given formatter.

impl GroupExt for Group

fn members(&self) -> &[OsString]

Returns a slice of the list of users that are in this group as their non-primary group.

fn add_member<S: AsRef<OsStr> + ?Sized>(self, member: &S) -> Self

Adds a new member to this group.