Enum ListenerError 

pub enum ListenerError {
    Resolver(CertificateResolverError),
    PemParse(String),
    TemplateParse(String, TemplateError),
    BuildRustls(String),
    Activation {
        address: SocketAddr,
        error: String,
    },
    SocketRegistration(Error),
    AddFrontend(RouterError),
    RemoveFrontend(RouterError),
    InvalidValue {
        field: &'static str,
        reason: &'static str,
    },
    HstsEnabledRequired,
}

returned by the HTTP, HTTPS and TCP listeners

Variants

Resolver(CertificateResolverError)

PemParse(String)

TemplateParse(String, TemplateError)

BuildRustls(String)

Activation

Fields

address: SocketAddr

error: String

SocketRegistration(Error)

AddFrontend(RouterError)

RemoveFrontend(RouterError)

InvalidValue

Fields

field: &'static str

reason: &'static str

HstsEnabledRequired

UpdateHttpsListenerConfig.hsts was present but its enabled field was unset. Per the partial-update contract, enabled is the explicit-disambiguator between “explicit disable” (false) and “explicit enable” (true); the patch handler refuses an enabled = None block rather than silently picking one.

Trait Implementations

impl Debug for ListenerError

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

Formats the value using the given formatter.

impl Display for ListenerError

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

Formats the value using the given formatter.

impl Error for ListenerError

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 From<StateError> for ListenerError

Lift control-plane validation errors into listener-level errors so the worker can surface the same message without duplicating the match. Non-InvalidValue variants fall back to a generic InvalidValue — they are not expected on the worker’s update_config path (state lookups happen on the master) but we avoid panicking if one slips through.

fn from(err: StateError) -> Self

Converts to this type from the input type.