Enum mail_smtp::error::MailSendError

pub enum MailSendError {
    Mail(MailError),
    Smtp(LogicError),
    Connecting(ConnectingFailed),
    Io(Error),
}

Error used when sending a mail fails.

Failing to encode a mail before sending it also counts as a MailSendError, as it's done "on the fly" when sending a mail.

Variants

Mail(MailError)

Something is wrong with the mail instance (e.g. it can't be encoded).

This can happen for a number of reasons including:

1. Missing header fields.
2. Invalid header fields.
3. Encoding header fields fails.
4. Loading resources failed (resources like e.g. appendix, logo embedded in html mail, etc.)

Smtp(LogicError)

Sending the mail failed.

This can happen for a number of reasons including:

1. Server rejects mail transaction because of send or receiver address or body data (e.g. body to long).
2. Mail address requires smtputf8 support, which is not given.
3. Server rejects sending the mail for other reasons (it's closing, overloaded etc.).

Connecting(ConnectingFailed)

Setting up the connection failed.

Failures can include but are not limited to:

• Connecting with TCP failed.
• Starting TLS failed.
• Server does not want to be used (e.g. failure on sending EHLO).
• Authentication failed.

Io(Error)

An I/O error happened while using the connection.

This is mainly for I/O errors after the setup of the connection was successful, which normally includes sending Ehlo and Auth commands.

Trait Implementations

impl Debug for MailSendError

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

Formats the value using the given formatter.

impl Display for MailSendError

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

Formats the value using the given formatter.

impl Fail for MailSendError

fn name(&self) -> Option<&str>

Returns the "name" of the error.

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

Returns a reference to the underlying cause of this failure, if it is an error that wraps other errors.

fn backtrace(&self) -> Option<&Backtrace>

Returns a reference to the Backtrace carried by this failure, if it carries one.

fn context<D>(self, context: D) -> Context<D> where
    D: Display + Send + Sync + 'static, 

Provides context for this failure.

fn compat(self) -> Compat<Self>

Wraps this failure in a compatibility wrapper that implements std::error::Error.

impl From<ConnectingFailed> for MailSendError

fn from(err: ConnectingFailed) -> Self

Performs the conversion.

impl From<Error> for MailSendError

fn from(err: Error) -> Self

Performs the conversion.

impl From<GeneralError> for MailSendError

fn from(err: GeneralError) -> Self

Performs the conversion.

impl From<LogicError> for MailSendError

fn from(err: LogicError) -> Self

Performs the conversion.

impl From<MailError> for MailSendError

fn from(err: MailError) -> Self

Performs the conversion.