Enum rustls::TLSError

pub enum TLSError {
    InappropriateMessage {
        expect_types: Vec<ContentType>,
        got_type: ContentType,
    },
    InappropriateHandshakeMessage {
        expect_types: Vec<HandshakeType>,
        got_type: HandshakeType,
    },
    CorruptMessage,
    CorruptMessagePayload(ContentType),
    NoCertificatesPresented,
    DecryptError,
    PeerIncompatibleError(String),
    PeerMisbehavedError(String),
    AlertReceived(AlertDescription),
    WebPKIError(Error),
    InvalidSCT(Error),
    General(String),
    FailedToGetCurrentTime,
    InvalidDNSName(String),
    HandshakeNotComplete,
    PeerSentOversizedRecord,
}

rustls reports protocol errors using this type.

Variants

InappropriateMessage

Fields

expect_types: Vec<ContentType>

Which types we expected

got_type: ContentType

What type we received

We received a TLS message that isn’t valid right now. expect_types lists the message types we can expect right now. got_type is the type we found. This error is typically caused by a buggy TLS stack (the peer or this one), a broken network, or an attack.

InappropriateHandshakeMessage

Fields

expect_types: Vec<HandshakeType>

Which handshake type we expected

got_type: HandshakeType

What handshake type we received

We received a TLS handshake message that isn’t valid right now. expect_types lists the handshake message types we can expect right now. got_type is the type we found.

CorruptMessage

The peer sent us a syntactically incorrect TLS message.

CorruptMessagePayload(ContentType)

The peer sent us a TLS message with invalid contents.

NoCertificatesPresented

The peer didn’t give us any certificates.

DecryptError

We couldn’t decrypt a message. This is invariably fatal.

PeerIncompatibleError(String)

The peer doesn’t support a protocol version/feature we require. The parameter gives a hint as to what version/feature it is.

PeerMisbehavedError(String)

The peer deviated from the standard TLS protocol. The parameter gives a hint where.

AlertReceived(AlertDescription)

We received a fatal alert. This means the peer is unhappy.

WebPKIError(Error)

The presented certificate chain is invalid.

InvalidSCT(Error)

The presented SCT(s) were invalid.

General(String)

A catch-all error for unlikely errors.

FailedToGetCurrentTime

We failed to figure out what time it currently is.

InvalidDNSName(String)

A syntactically-invalid DNS hostname was given.

HandshakeNotComplete

This function doesn’t work until the TLS handshake is complete.

PeerSentOversizedRecord

The peer sent an oversized record/fragment.

Trait Implementations

impl Clone for TLSError

fn clone(&self) -> TLSError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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 description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

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

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl PartialEq<TLSError> for TLSError

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for TLSError