Enum ProxyError 

pub enum ProxyError {
    SoftStop {
        proxy_protocol: String,
        error: String,
    },
    HardStop {
        proxy_protocol: String,
        error: String,
    },
    NoListenerFound(ListenerKey),
    ListenerAlreadyPresent,
    AddListener(ListenerError),
    AddCluster(ListenerError),
    ListenerActivation {
        address: SocketAddr,
        listener_error: ListenerError,
    },
    WrongInputFrontend {
        front: Box<RequestHttpFrontend>,
        error: String,
    },
    AddFrontend(ListenerError),
    RemoveFrontend(ListenerError),
    AddCertificate(CertificateResolverError),
    RemoveCertificate(CertificateResolverError),
    ReplaceCertificate(CertificateResolverError),
    WrongCertificateFingerprint(FromHexError),
    UnsupportedMessage,
    Lock(String),
    BindToSocket(SocketAddr, ServerBindError),
    RegisterListener(Error),
    UnactivatedListener,
    HstsOnPlainHttp(SocketAddr),
    InvalidTcpFrontend {
        address: SocketAddr,
        reason: String,
    },
}

Returned by the HTTP, HTTPS and TCP proxies

Variants

SoftStop

Fields

proxy_protocol: String

error: String

HardStop

Fields

proxy_protocol: String

error: String

NoListenerFound(ListenerKey)

Names the listener key: the address, plus %<interface> for a listener bound to one.

ListenerAlreadyPresent

AddListener(ListenerError)

AddCluster(ListenerError)

ListenerActivation

Fields

address: SocketAddr

listener_error: ListenerError

WrongInputFrontend

Fields

front: Box<RequestHttpFrontend>

error: String

AddFrontend(ListenerError)

RemoveFrontend(ListenerError)

AddCertificate(CertificateResolverError)

RemoveCertificate(CertificateResolverError)

ReplaceCertificate(CertificateResolverError)

WrongCertificateFingerprint(FromHexError)

UnsupportedMessage

Lock(String)

BindToSocket(SocketAddr, ServerBindError)

RegisterListener(Error)

UnactivatedListener

HstsOnPlainHttp(SocketAddr)

HSTS (RFC 6797) was attached to a frontend on a plain-HTTP listener. RFC 6797 §7.2 forbids Strict-Transport-Security on plaintext-HTTP responses; the worker rejects the request rather than ship a non-conformant policy. The TOML loader rejects the same shape at config-load time (command/src/config.rs::ConfigError::HstsOnPlainHttp); this arm catches the same misconfiguration when the request reaches the worker over the IPC channel without going through the TOML path (e.g. via sozu frontend http add).

InvalidTcpFrontend

A TCP AddTcpFrontend would corrupt this listener’s SNI/ALPN routing invariants (sozu-proxy/sozu#1279): mixing a no-SNI catch-all with SNI-scoped routes, an alpn-scoped frontend with no sni to preread against, or an ALPN protocol / catch-all that overlaps an existing route on the same (address, sni). TOML config-load already rejects the same shapes (command/src/config.rs::ConfigError), but AddTcpFrontend can also arrive directly over the command socket or via LoadState replay of a hand-edited/stale state file, bypassing config.rs entirely — see TcpListener::validate_new_tcp_front (lib/src/tcp.rs).

Fields

address: SocketAddr

reason: String

Trait Implementations

impl Debug for ProxyError

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

Formats the value using the given formatter.

impl Display for ProxyError

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

Formats the value using the given formatter.

impl Error for ProxyError

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.