Struct FileEntry

pub struct FileEntry {
    pub file_len: u64,
    pub mode: u32,
    /* private fields */
}

Description of a single file (or directory or symlink etc).

The Display trait formats an entry like in ls -l, and like in rsync directory listings.

Fields

file_len: u64

Length of the file, in bytes.

mode: u32

Unix mode, containing the file type and permissions.

Implementations

impl FileEntry

pub fn name_bytes(&self) -> &[u8]

Returns the file name, as a byte string, in the (remote) OS’s encoding.

rsync doesn’t constrain the encoding, so this will typically, but not necessarily be UTF-8.

pub fn name_lossy_string(&self) -> Cow<'_, str>

Returns the file name, with un-decodable bytes converted to Unicode replacement characters.

For the common case of UTF-8 names, this is simply the name, but if the remote end uses a different encoding the name may be mangled.

This is suitable for printing, but might not be suitable for use as a destination file name.

pub fn is_file(&self) -> bool

Returns true if this entry describes a plain file.

pub fn is_dir(&self) -> bool

Returns true if this entry describes a directory.

pub fn is_symlink(&self) -> bool

Returns true if this entry describes a symlink.

pub fn unix_mtime(&self) -> u32

Returns the modification time, in seconds since the Unix epoch.

pub fn mtime(&self) -> DateTime<Local>

Returns the modification time as a chrono::DateTime associated to the local timezone.

Trait Implementations

impl Debug for FileEntry

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

Formats the value using the given formatter.

impl Display for FileEntry

Display this entry in a format like that of ls, and like rsync uses in listing directories:

drwxr-x---         420 2020-05-02 07:25:17 rsyn

The modification time is shown in the local timezone.

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

Formats the value using the given formatter.

impl PartialEq for FileEntry

fn eq(&self, other: &FileEntry) -> 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 FileEntry

impl StructuralPartialEq for FileEntry