Struct TransferResult 

pub struct TransferResult {
    pub bytes_transferred: u64,
    pub duration_ms: u64,
    pub mtime_preserved: bool,
    pub durable: bool,
}

Result of an SCP file transfer operation.

Fields

bytes_transferred: u64

Number of bytes transferred.

duration_ms: u64

Total duration in milliseconds.

mtime_preserved: bool

Whether the remote modification time was applied to the local file.

G-SCP-R01: the product documented mtime preservation as a guarantee while the implementation discarded the failure at two nesting levels. Destination filesystems that cannot represent the operation — FAT32, exFAT, some bind mounts, WSL interop paths — silently produced a file with the wrong timestamp, and a build pipeline deciding whether to recompile by mtime comparison took the wrong branch with the symptom appearing far from the cause. Reporting the outcome resolves the contradiction without failing transfers that are otherwise complete and correct.

Always true for uploads and whenever the remote sent no timestamps: there was nothing to preserve, so nothing was lost.

durable: bool

Whether the parent directory was successfully fsynced after the atomic rename.

G-SCP-R02: the rename is atomic, but until the directory entry is flushed a crash can leave the file missing even though the CLI already reported exit 0. The fsync was best-effort by design and invisible by accident; an agent had no way to know whether the success it received was durable.

Trait Implementations

impl Clone for TransferResult

fn clone(&self) -> TransferResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransferResult

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

Formats the value using the given formatter.

impl Default for TransferResult

fn default() -> Self

Defaults describe “nothing was attempted, so nothing failed”.

The booleans default to true because every non-SCP-download path either has no local file to stamp or no rename to flush. Defaulting them to false would have reported spurious durability loss on uploads.