Enum Error 

#[non_exhaustive]
pub enum Error {
    Identity {
        detail: String,
    },
    PortInUse {
        port: u16,
    },
    Listen {
        port: u16,
        detail: String,
    },
    DiscoveryUnavailable {
        detail: String,
    },
    TrustStore {
        detail: String,
    },
    InvalidFingerprint,
    NotListed,
    AllowNotDefault,
    DeviceNearby,
    DeviceNotNearby,
    DeviceBlocked,
    NoUsableAddress,
    InvalidIdentity {
        peer: String,
    },
    PeerPlaintext {
        peer: String,
    },
    PeerIdentityMismatch {
        peer: String,
    },
    PeerUnreachable {
        peer: String,
        detail: String,
    },
    PeerLost {
        peer: String,
        detail: String,
    },
    PeerAnswer {
        peer: String,
        status: u16,
    },
    PeerReply {
        peer: String,
    },
    PeerNeedsPin {
        peer: String,
    },
    PeerBusy {
        peer: String,
    },
    PeerTooLarge {
        peer: String,
    },
    PeerRateLimited {
        peer: String,
    },
    FileRefused {
        peer: String,
        file: String,
    },
    FileDamaged {
        peer: String,
        file: String,
    },
    FileStopped {
        file: String,
        detail: String,
    },
    TooManyFiles {
        max: usize,
    },
    NothingToSend,
    NotFileOrFolder {
        path: String,
    },
    Damaged {
        file: String,
    },
    Internal {
        detail: String,
    },
    Unreadable {
        path: String,
        detail: String,
    },
    SenderStopped,
    Unverified {
        max_files: usize,
        max_bytes: u64,
    },
    SaveFailed {
        file: String,
        detail: String,
    },
    Interrupted {
        file: String,
        detail: String,
    },
    Mark {
        file: String,
        detail: String,
    },
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Identity

The stored certificate and key do not form a usable identity.

Fields

detail: String

PortInUse

The listen port is held by another program.

Fields

port: u16

Listen

The listen port could not be bound for another reason.

Fields

port: u16

detail: String

DiscoveryUnavailable

The discovery socket could not be opened; devices that find this one first still work.

Fields

detail: String

TrustStore

The device list could not be written to the trust store path.

Fields

detail: String

InvalidFingerprint

A device key was not a 64-character SHA-256 in hex.

NotListed

A device record was asked for that has no record.

AllowNotDefault

The default state was set to Allow; only single devices may be allowed.

DeviceNearby

Forgetting a record is refused while that device is on the network.

DeviceNotNearby

The send target is not on the network.

DeviceBlocked

The send target is set to Deny.

NoUsableAddress

The device announced no usable address.

InvalidIdentity

The device’s identity is not a valid fingerprint.

Fields

peer: String

PeerPlaintext

The device answered over plain HTTP. Sends are refused without TLS.

Fields

peer: String

PeerIdentityMismatch

The certificate the device presented is not the one its fingerprint names. Distinct from an unreachable device: the address answered with another key.

Fields

peer: String

PeerUnreachable

The device could not be connected to.

Fields

peer: String

detail: String

PeerLost

The connection to the device failed after it was made.

Fields

peer: String

detail: String

PeerAnswer

The device answered with a status the protocol does not define here.

Fields

peer: String

status: u16

PeerReply

The device’s answer could not be parsed.

Fields

peer: String

PeerNeedsPin

The device asks for a PIN, which is not supported.

Fields

peer: String

PeerBusy

The device is busy with another transfer.

Fields

peer: String

PeerTooLarge

The device refused the request as too large for an unproven sender.

Fields

peer: String

PeerRateLimited

The device is rate limiting requests.

Fields

peer: String

FileRefused

The device refused one file.

Fields

peer: String

file: String

FileDamaged

The device reported that one file arrived damaged.

Fields

peer: String

file: String

FileStopped

Sending one file stopped.

Fields

file: String

detail: String

TooManyFiles

More entries than the send limit.

Fields

max: usize

NothingToSend

Nothing to send after expanding the selection.

NotFileOrFolder

A chosen path is neither a file nor a folder.

Fields

path: String

Damaged

A received file’s checksum did not match the one the sender named.

Fields

file: String

Internal

An internal failure that should not happen (serializing our own message).

Fields

detail: String

Unreadable

A chosen path could not be read.

Fields

path: String

detail: String

SenderStopped

The sender stopped responding while a transfer was open.

Unverified

A request from an unproven sender named too much (receive side).

Fields

max_files: usize

max_bytes: u64

SaveFailed

A received file could not be saved.

Fields

file: String

detail: String

Interrupted

A received file was cut off mid-transfer.

Fields

file: String

detail: String

Mark

A received file could not be marked as coming from outside the computer. An unproven sender’s file is then not kept.

Fields

file: String

detail: String

Trait Implementations

impl Clone for Error

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 Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

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.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Error

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Error