Struct Group

pub struct Group {
    pub name: String,
    pub passwd: CString,
    pub gid: Gid,
    pub mem: Vec<String>,
}

Representation of a Group, based on libc::group

Fields

name: String

Group name

passwd: CString

Group password

gid: Gid

Group ID

mem: Vec<String>

List of Group members

Implementations

impl Group

unsafe fn members(mem: *mut *mut c_char) -> Vec<String>

unsafe fn from_anything<F>(f: F) -> Result<Option<Self>>

where F: Fn(*mut group, *mut c_char, size_t, *mut *mut group) -> c_int,

Safety

If f writes to its *mut *mut libc::group parameter, then it must also initialize the value pointed to by its *mut libc::group parameter.

pub fn from_gid(gid: Gid) -> Result<Option<Self>>

Get a group by GID.

Internally, this function calls getgrgid_r(3)

Examples

use nix::unistd::{Gid, Group};
// Returns an Result<Option<Group>>, thus the double unwrap.
let res = Group::from_gid(Gid::from_raw(0)).unwrap().unwrap();
assert!(res.name == "root");

pub fn from_name(name: &str) -> Result<Option<Self>>

Get a group by name.

Internally, this function calls getgrnam_r(3)

Examples

use nix::unistd::Group;
// Returns an Result<Option<Group>>, thus the double unwrap.
let res = Group::from_name("root").unwrap().unwrap();
assert!(res.name == "root");

Trait Implementations

impl Clone for Group

fn clone(&self) -> Group

Returns a duplicate 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 From<&group> for Group

fn from(gr: &group) -> Group

Converts to this type from the input type.

impl PartialEq for Group

fn eq(&self, other: &Group) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Group

impl StructuralPartialEq for Group