Struct IdNameMap 

pub struct IdNameMap { /* private fields */ }

uid → user name and gid → group name, parsed from an image’s account files.

Implementations

impl IdNameMap

pub fn from_filesystem(fs: &mut dyn Filesystem) -> Self

Read /etc/passwd and /etc/group from fs and build the maps. Missing or unreadable files yield an empty map rather than an error — this is a display nicety, never a hard dependency.

pub fn is_empty(&self) -> bool

True when neither file yielded a single entry — the caller should just show raw numbers.

pub fn user(&self, uid: u32) -> Option<&str>

The user name for uid, if known.

pub fn group(&self, gid: u32) -> Option<&str>

The group name for gid, if known.

pub fn format_owner(&self, uid: u32, gid: u32) -> String

"root:wheel (0:0)" when both names are known, degrading gracefully to "root:0 (0:0)" or "0:0" as names are missing. Always shows the raw numbers so nothing is hidden.

Trait Implementations

impl Clone for IdNameMap

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IdNameMap

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

Formats the value using the given formatter.

impl Default for IdNameMap

fn default() -> Self

Returns the “default value” for a type.