Struct nix::unistd::User

pub struct User {    
    pub name: String,
    pub passwd: CString,
    pub uid: Uid,
    pub gid: Gid,
    pub gecos: CString,
    pub dir: PathBuf,
    pub shell: PathBuf,
}
Documentation

Representation of a User, based on libc::passwd

The reason some fields in this struct are String and others are CString is because some fields are based on the user’s locale, which could be non-UTF8, while other fields are guaranteed to conform to NAME_REGEX, which only contains ASCII.

Fields

pub name: String

Username

pub passwd: CString

User password (probably encrypted)

pub uid: Uid

User ID

pub gid: Gid

Group ID

pub gecos: CString

User information

pub dir: PathBuf

Home directory

pub shell: PathBuf

Path to shell

Implementations

impl User
pub fn from_uid(uid: Uid) -> Result<Option<Self>>

Get a user by UID.

Internally, this function calls getpwuid_r(3)

Examples

use nix::unistd::{Uid, User};
// Returns an Result<Option<User>>, thus the double unwrap.
let res = User::from_uid(Uid::from_raw(0)).unwrap().unwrap();
assert!(res.name == "root");
pub fn from_name(name: &str) -> Result<Option<Self>>

Get a user by name.

Internally, this function calls getpwnam_r(3)

Examples

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

Trait Implementations

impl Clone for User
fn clone(&Self) -> User
impl Debug for User
fn fmt(&Self, f: &mut $crate::fmt::Formatter<'_>) -> $crate::fmt::Result
impl From<&passwd> for User
fn from(pw: &libc::passwd) -> User
impl From<User> for libc::passwd
fn from(u: User) -> Self
impl PartialEq<User> for User
fn eq(&Self, other: &User) -> bool
fn ne(&Self, other: &User) -> bool

Auto Trait Implementations

impl RefUnwindSafe for User
impl Send for User
impl Sync for User
impl Unpin for User
impl UnwindSafe for User

Blanket Implementations

impl<T> Any for T
where
    T: 'static + ?Sized,
fn type_id(&Self) -> TypeId
impl<T> Borrow<T> for T
where
    T: ?Sized,
fn borrow(&Self) -> &T
impl<T> BorrowMut<T> for T
where
    T: ?Sized,
fn borrow_mut(&mut Self) -> &mut T
impl<T> From<T> for T
fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where
    U: From<T>,
fn into(Self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T
where
    T: Clone,
type Owned = T
fn to_owned(&Self) -> T
fn clone_into(&Self, target: &mut T)
impl<T, U> TryFrom<U> for T
where
    U: Into<T>,
type Error = Infallible
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
impl<T, U> TryInto<U> for T
where
    U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
fn try_into(Self) -> Result<U, <U as TryFrom<T>>::Error>