Enum PeerMisbehaved

#[non_exhaustive]
pub enum PeerMisbehaved {
    AttemptedDowngradeToTls12WhenTls13IsSupported,
    BadCertChainExtensions,
    DisallowedEncryptedExtension,
    DuplicateClientHelloExtensions,
    DuplicateEncryptedExtensions,
    DuplicateHelloRetryRequestExtensions,
    DuplicateNewSessionTicketExtensions,
    DuplicateServerHelloExtensions,
    DuplicateServerNameTypes,
    EarlyDataAttemptedInSecondClientHello,
    EarlyDataExtensionWithoutResumption,
    EarlyDataOfferedWithVariedCipherSuite,
    HandshakeHashVariedAfterRetry,
    IllegalHelloRetryRequestWithEmptyCookie,
    IllegalHelloRetryRequestWithNoChanges,
    IllegalHelloRetryRequestWithOfferedGroup,
    IllegalHelloRetryRequestWithUnofferedCipherSuite,
    IllegalHelloRetryRequestWithUnofferedNamedGroup,
    IllegalHelloRetryRequestWithUnsupportedVersion,
    IllegalHelloRetryRequestWithWrongSessionId,
    IllegalMiddleboxChangeCipherSpec,
    IllegalTlsInnerPlaintext,
    IncorrectBinder,
    InvalidMaxEarlyDataSize,
    InvalidKeyShare,
    KeyEpochWithPendingFragment,
    KeyUpdateReceivedInQuicConnection,
    MessageInterleavedWithHandshakeMessage,
    MissingBinderInPskExtension,
    MissingKeyShare,
    MissingPskModesExtension,
    MissingQuicTransportParameters,
    OfferedDuplicateKeyShares,
    OfferedEarlyDataWithOldProtocolVersion,
    OfferedEmptyApplicationProtocol,
    OfferedIncorrectCompressions,
    PskExtensionMustBeLast,
    PskExtensionWithMismatchedIdsAndBinders,
    RefusedToFollowHelloRetryRequest,
    RejectedEarlyDataInterleavedWithHandshakeMessage,
    ResumptionAttemptedWithVariedEms,
    ResumptionOfferedWithVariedCipherSuite,
    ResumptionOfferedWithVariedEms,
    ResumptionOfferedWithIncompatibleCipherSuite,
    SelectedDifferentCipherSuiteAfterRetry,
    SelectedInvalidPsk,
    SelectedTls12UsingTls13VersionExtension,
    SelectedUnofferedApplicationProtocol,
    SelectedUnofferedCipherSuite,
    SelectedUnofferedCompression,
    SelectedUnofferedKxGroup,
    SelectedUnofferedPsk,
    SelectedUnusableCipherSuiteForVersion,
    ServerHelloMustOfferUncompressedEcPoints,
    ServerNameDifferedOnRetry,
    ServerNameMustContainOneHostName,
    SignedKxWithWrongAlgorithm,
    SignedHandshakeWithUnadvertisedSigScheme,
    TooMuchEarlyDataReceived,
    UnexpectedCleartextExtension,
    UnsolicitedCertExtension,
    UnsolicitedEncryptedExtension,
    UnsolicitedSctList,
    UnsolicitedServerHelloExtension,
    WrongGroupForKeyShare,
}

The set of cases where we failed to make a connection because we thought the peer was misbehaving.

This is non_exhaustive: we might add or stop using items here in minor versions. We also don’t document what they mean. Generally a user of rustls shouldn’t vary its behaviour on these error codes, and there is nothing it can do to improve matters.

Please file a bug against rustls if you see Error::PeerMisbehaved in the wild.

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.

AttemptedDowngradeToTls12WhenTls13IsSupported

BadCertChainExtensions

DisallowedEncryptedExtension

DuplicateClientHelloExtensions

DuplicateEncryptedExtensions

DuplicateHelloRetryRequestExtensions

DuplicateNewSessionTicketExtensions

DuplicateServerHelloExtensions

DuplicateServerNameTypes

EarlyDataAttemptedInSecondClientHello

EarlyDataExtensionWithoutResumption

EarlyDataOfferedWithVariedCipherSuite

HandshakeHashVariedAfterRetry

IllegalHelloRetryRequestWithEmptyCookie

IllegalHelloRetryRequestWithNoChanges

IllegalHelloRetryRequestWithOfferedGroup

IllegalHelloRetryRequestWithUnofferedCipherSuite

IllegalHelloRetryRequestWithUnofferedNamedGroup

IllegalHelloRetryRequestWithUnsupportedVersion

IllegalHelloRetryRequestWithWrongSessionId

IllegalMiddleboxChangeCipherSpec

IllegalTlsInnerPlaintext

IncorrectBinder

InvalidMaxEarlyDataSize

InvalidKeyShare

KeyEpochWithPendingFragment

KeyUpdateReceivedInQuicConnection

MessageInterleavedWithHandshakeMessage

MissingBinderInPskExtension

MissingKeyShare

MissingPskModesExtension

MissingQuicTransportParameters

OfferedDuplicateKeyShares

OfferedEarlyDataWithOldProtocolVersion

OfferedEmptyApplicationProtocol

OfferedIncorrectCompressions

PskExtensionMustBeLast

PskExtensionWithMismatchedIdsAndBinders

RefusedToFollowHelloRetryRequest

RejectedEarlyDataInterleavedWithHandshakeMessage

ResumptionAttemptedWithVariedEms

ResumptionOfferedWithVariedCipherSuite

ResumptionOfferedWithVariedEms

ResumptionOfferedWithIncompatibleCipherSuite

SelectedDifferentCipherSuiteAfterRetry

SelectedInvalidPsk

SelectedTls12UsingTls13VersionExtension

SelectedUnofferedApplicationProtocol

SelectedUnofferedCipherSuite

SelectedUnofferedCompression

SelectedUnofferedKxGroup

SelectedUnofferedPsk

SelectedUnusableCipherSuiteForVersion

ServerHelloMustOfferUncompressedEcPoints

ServerNameDifferedOnRetry

ServerNameMustContainOneHostName

SignedKxWithWrongAlgorithm

SignedHandshakeWithUnadvertisedSigScheme

TooMuchEarlyDataReceived

UnexpectedCleartextExtension

UnsolicitedCertExtension

UnsolicitedEncryptedExtension

UnsolicitedSctList

UnsolicitedServerHelloExtension

WrongGroupForKeyShare

Trait Implementations

impl Clone for PeerMisbehaved

fn clone(&self) -> PeerMisbehaved

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PeerMisbehaved

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

Formats the value using the given formatter.

impl From<PeerMisbehaved> for Error

fn from(e: PeerMisbehaved) -> Self

Converts to this type from the input type.

impl PartialEq for PeerMisbehaved

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PeerMisbehaved