Enum TransferError 

pub enum TransferError {
    Network(String),
    Timeout(Duration),
    Status {
        status: u16,
        retry_after: Option<Duration>,
    },
    RemoteChanged(String),
    Protocol(String),
    Io(String),
    Cancelled,
}

Variants

Network(String)

Connection reset, DNS failure, TLS handshake failure, network down.

Timeout(Duration)

No bytes arrived within the read timeout.

Status

The server answered, unhappily.

Fields

status: u16

retry_after: Option<Duration>

RemoteChanged(String)

Validators say we are no longer looking at the same bytes. Retrying cannot fix this and continuing would corrupt the file.

Protocol(String)

The server broke the HTTP contract — ignored Range, returned a Content-Range that does not match what we asked for, sent more bytes than it promised.

Io(String)

Local disk problem.

Cancelled

Graceful shutdown, not really a failure.

Implementations

impl TransferError

pub fn is_retryable(&self) -> bool

PRD §14: retry connection resets, timeouts, DNS failures, 408, 429, 5xx. Nothing else.

pub fn retry_after(&self) -> Option<Duration>

Server-suggested delay, honoured when present (PRD §14).

pub fn from_reqwest(err: &Error) -> Self

Trait Implementations

impl Debug for TransferError

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

Formats the value using the given formatter.

impl Display for TransferError

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

Formats the value using the given formatter.

impl Error for TransferError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.