Enum TlsError 

#[non_exhaustive]
pub enum TlsError {
    ClosedWithoutNotify,
    InappropriateHandshakeMessage,
    InitialConnect(Error, ServerName<'static>, u16),
    NoResponse,
    Open(Error),
    Receive(Error),
    Send(Error),
    ServerCertificate(CertificateError),
    ShutdownFailed(Error),
    TimedOut(ServerName<'static>, u16, Duration),
}

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.

ClosedWithoutNotify

The server closed the connection before sending close_notify. This could mean an attacker caused a premature closure and the message was truncated, or the remote server simply forgot to send the alert. [RFC 8446 § 6.1]

Erroring out when close_notify is missing is comparable to cURL’s behavior with HTTP/1.1 over TLS. Like HTTP/1.1, the Gemini network protocol does not have any way of indicating beforehand how much data the client should expect, so close_notify is its only mechanism for informing the client that transmission is complete and that data was not truncated, before closing the socket. [curl#4427], [curl#11586], [curl/TODO]

InappropriateHandshakeMessage

Received an inappropriate handshake message from the server.

InitialConnect(Error, ServerName<'static>, u16)

Failed to connect to the remote.

NoResponse

The server replied with nothing, or didn’t reply at all.

Open(Error)

Failed to open a TCP socket.

Receive(Error)

Failed to read data from the server.

Send(Error)

Failed to send data to the server.

ServerCertificate(CertificateError)

Could not read or validate the certificate.

ShutdownFailed(Error)

Failed to shut down the TCP connection.

TimedOut(ServerName<'static>, u16, Duration)

Timed out while opening a socket or awaiting a response.

Trait Implementations

impl Debug for TlsError

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

Formats the value using the given formatter.

impl Display for TlsError

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

Formats the value using the given formatter.

impl Error for TlsError

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<H: ResponseHandler> From<TlsError> for SendError<H>

fn from(value: TlsError) -> Self

Converts to this type from the input type.