Struct Entry 

pub struct Entry {

    pub name: PathStr,
    pub kind: FileType,
    pub mtime: Time,
    pub mode: Mode,
    pub user: User,
    pub group: Group,
    pub size: u64,
    pub inode: Option<u64>,
    pub nlink: Option<u64>,
    pub device: Option<Device>,
    pub special_device: Option<Device>,
    pub checksums: Option<Vec<Checksum>>,
    pub ctime: Option<Time>,
    pub atime: Option<Time>,
    pub btime: Option<Time>,
    pub link_target: Option<String>,
    pub link_real: Option<String>,
}

Fields

name: PathStr

The entry’s file path

kind: FileType

The type of the file

Depending on the file type, entries may automatically make use of (or disregard entirely) certain fields. For example:

• Directories, symlinks, sockets, character/block special and named pipes do not yield a size fields
• Only files which are character/block special yield device.special fields

mtime: Time

Time of the file’s last ‘modification’

Represents the last time the actual content of the file was modified, e.g.: it was written/appended to, truncated, etc

mode: Mode

The file’s mode/permissions

user: User

The file’s owning user

group: Group

The file’s owning group

size: u64

inode: Option<u64>

The file’s inode number

nlink: Option<u64>

Number of hard links

device: Option<Device>

The device the file is on

special_device: Option<Device>

The special device (character/block) if applicable

checksums: Option<Vec<Checksum>>

Hashes of the file

ctime: Option<Time>

Time of the file’s last ‘change’

Unlike mtime, which tracks file content updates, ctime is updated whenever permissions/ownership (chmod/chown), extended attributes, link count (nlink) or the file’s path/location change.

atime: Option<Time>

Time of the file’s last access

btime: Option<Time>

Time of the file’s creation

link_target: Option<String>

If the file is a symlink, the target of the link

link_real: Option<String>

If the file is a symlink, the fully resolved target path

This is likely to point outside of the directory tree

Implementations

impl Entry

pub fn new<P>(file: P, conf: Option<&EntryConfig>) -> Result<Self, Error>

where P: AsRef<Path>,

Create a new entry given a path and optionally a configration

pub fn compare<P>( &self, path: P, conf: Option<&EntryConfig>, ) -> Result<Comparison, Error>

where P: AsRef<Path>,

Check this entry against an on-disk file, yielding a Comparison between them

Trait Implementations

impl Clone for Entry

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 Entry

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

Formats the value using the given formatter.

impl Default for Entry

fn default() -> Self

Returns the “default value” for a type.

impl Display for Entry

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

Formats the value using the given formatter.

impl Eq for Entry

impl Hash for Entry

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Entry

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Entry

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Entry

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Entry