Struct UserSpec 

pub struct UserSpec { /* private fields */ }

The identity the packaged application is expected to run as.

The fields are private because the name is rendered verbatim into /etc/passwd and /etc/group, which are colon- and newline-delimited. A value that reached those files unchecked could declare a second account — including a uid-0 one with a shell — in an image whose whole point is that it contains nothing unaudited. Construct one with UserSpec::parse or UserSpec::new, both of which enforce that invariant.

Implementations

impl UserSpec

pub fn uid(&self) -> u32

pub fn gid(&self) -> u32

pub fn name(&self) -> &str

pub fn group(&self) -> &str

pub fn new(name: &str, uid: u32, gid: u32) -> Result<UserSpec, Error>

A checked identity. The name must be a portable account name, and must not contradict the two accounts every image already has.

pub fn parse(value: &str) -> Result<UserSpec, Error>

Accepts uid, uid:gid and name:uid:gid.

Trait Implementations

impl Clone for UserSpec

fn clone(&self) -> UserSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UserSpec

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

Formats the value using the given formatter.

impl Display for UserSpec

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

Canonical name:uid:gid form, which UserSpec::parse round-trips.

impl Eq for UserSpec

impl PartialEq for UserSpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UserSpec