Enum ImapSessionOpenError 

pub enum ImapSessionOpenError {
    StartTlsOverTls,
    StartTlsInjection,
    UnsupportedMechanism(SaslMechanism),
    UrlMissingHost(String),
    UrlUnsupportedScheme(String, String),
    InvalidLoginCredentials(ValidationError),
    StartTls(ImapStartTlsError),
    Greeting(ImapGreetingGetError),
    Capability(ImapCapabilityGetError),
    Login(ImapLoginError),
    AuthAnonymous(ImapAuthAnonymousError),
    AuthLogin(ImapAuthLoginError),
    AuthPlain(ImapAuthPlainError),
    AuthOauthbearer(ImapAuthOauthbearerError),
    AuthXoauth2(ImapAuthXoauth2Error),
    AuthScramSha256(ImapAuthScramSha256Error),
}

Failure causes while opening an IMAP session.

Variants

StartTlsOverTls

STARTTLS was requested on a transport that is already TLS.

StartTlsInjection

The server sent bytes past the STARTTLS tagged response.

RFC 3501 §6.2.1 forbids them, so their presence means an attacker injected plaintext commands the server will replay inside the TLS session. The upgrade is refused rather than performed.

UnsupportedMechanism(SaslMechanism)

Credentials were given for a mechanism this crate does not frame.

io-sasl computes more mechanisms than IMAP wires up here; the ones left out are named rather than silently skipped, so a caller learns which of its credentials this crate cannot use.

UrlMissingHost(String)

Available on crate feature url only.

The URL carries no host to connect to.

UrlUnsupportedScheme(String, String)

Available on crate feature url only.

The URL scheme is none of imap, imaps and unix.

InvalidLoginCredentials(ValidationError)

The LOGIN user or password failed imap-types validation.

StartTls(ImapStartTlsError)

The STARTTLS coroutine failed.

Greeting(ImapGreetingGetError)

The greeting coroutine failed.

Capability(ImapCapabilityGetError)

The CAPABILITY coroutine failed.

Login(ImapLoginError)

The LOGIN coroutine failed.

AuthAnonymous(ImapAuthAnonymousError)

The SASL ANONYMOUS coroutine failed.

AuthLogin(ImapAuthLoginError)

The SASL LOGIN coroutine failed.

AuthPlain(ImapAuthPlainError)

The SASL PLAIN coroutine failed.

AuthOauthbearer(ImapAuthOauthbearerError)

The SASL OAUTHBEARER coroutine failed.

AuthXoauth2(ImapAuthXoauth2Error)

The SASL XOAUTH2 coroutine failed.

AuthScramSha256(ImapAuthScramSha256Error)

Available on crate feature scram only.

The SASL SCRAM-SHA-256 coroutine failed.

Trait Implementations

impl Debug for ImapSessionOpenError

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

Formats the value using the given formatter.

impl Display for ImapSessionOpenError

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

Formats the value using the given formatter.

impl Error for ImapSessionOpenError

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 From<ImapAuthAnonymousError> for ImapSessionOpenError

fn from(source: ImapAuthAnonymousError) -> Self

Converts to this type from the input type.

impl From<ImapAuthLoginError> for ImapSessionOpenError

fn from(source: ImapAuthLoginError) -> Self

Converts to this type from the input type.

impl From<ImapAuthOauthbearerError> for ImapSessionOpenError

fn from(source: ImapAuthOauthbearerError) -> Self

Converts to this type from the input type.

impl From<ImapAuthPlainError> for ImapSessionOpenError

fn from(source: ImapAuthPlainError) -> Self

Converts to this type from the input type.

impl From<ImapAuthScramSha256Error> for ImapSessionOpenError

fn from(source: ImapAuthScramSha256Error) -> Self

Converts to this type from the input type.

impl From<ImapAuthXoauth2Error> for ImapSessionOpenError

fn from(source: ImapAuthXoauth2Error) -> Self

Converts to this type from the input type.

impl From<ImapCapabilityGetError> for ImapSessionOpenError

fn from(source: ImapCapabilityGetError) -> Self

Converts to this type from the input type.

impl From<ImapGreetingGetError> for ImapSessionOpenError

fn from(source: ImapGreetingGetError) -> Self

Converts to this type from the input type.

impl From<ImapLoginError> for ImapSessionOpenError

fn from(source: ImapLoginError) -> Self

Converts to this type from the input type.

impl From<ImapSessionOpenError> for ImapClientError

Available on crate feature client only.

fn from(source: ImapSessionOpenError) -> Self

Converts to this type from the input type.

impl From<ImapStartTlsError> for ImapSessionOpenError

fn from(source: ImapStartTlsError) -> Self

Converts to this type from the input type.

impl From<ValidationError> for ImapSessionOpenError

fn from(source: ValidationError) -> Self

Converts to this type from the input type.