Struct users::Group

pub struct Group { /* private fields */ }

Information about a particular group.

For more information, see the module documentation.

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.

Examples

use users::Group;

let group = Group::new(102, "database");

pub fn gid(&self) -> gid_t

Returns this group’s ID.

Examples

use users::Group;

let group = Group::new(102, "database");
assert_eq!(group.gid(), 102);

pub fn name(&self) -> &OsStr

Returns this group’s name.

Examples

use std::ffi::OsStr;
use users::Group;

let group = Group::new(102, "database");
assert_eq!(group.name(), OsStr::new("database"));

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.