Enum I2pError 

#[non_exhaustive]
pub enum I2pError {
    AlreadyRunning,
    InvalidAppName,
    WorkerPanicked,
    DestinationCreationFailed,
    KeyGenerationFailed,
    ConnectFailed,
    DestinationClosed,
    Io(Error),
}

Errors that can occur while starting the router, creating a destination, or using a stream.

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.

AlreadyRunning

Another I2pRouter is still running in this process. Once the last clone of it has been dropped, a fresh start succeeds.

The exception is a router whose start panicked inside libi2pd: the globals are then in an unknown state, and every later start in that process returns this error rather than re-initializing over them.

InvalidAppName

The application name contained an interior NUL byte and can’t cross the C ABI.

WorkerPanicked

The blocking worker task backing an async call panicked – a bug in this crate or libi2pd.

DestinationCreationFailed

libi2pd failed to create the destination. Its API reports no further detail.

KeyGenerationFailed

libi2pd failed to generate a new destination keypair.

ConnectFailed

Destination::connect timed out or failed – most often because a tunnel had to be built over the live network first, which takes seconds to minutes.

DestinationClosed

The destination was dropped while an accept was pending.

Io(Error)

An I/O error occurred reading/writing a persistent keys file.

Trait Implementations

impl Debug for I2pError

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

Formats the value using the given formatter.

impl Display for I2pError

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

Formats the value using the given formatter.

impl Error for I2pError

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.