Enum UpstreamError 

pub enum UpstreamError {
    Timeout,
    Io(Error),
    TransportNotEnabled(UpstreamTransport),
    TlsHandshake(String),
    NoTokioRuntime,
}

Typed upstream-forward error.

Mapped at the super::run_one_shot call site to a SERVFAIL response for the workload plus a dns_query CloudEvent stamped reasonCode: upstream_failure. The variant discriminator is stable so follow-up slots can refine the event’s reason text without re-shaping the matrix.

Variants

Timeout

Upstream did not answer within the configured budget.

Io(Error)

Lower-level I/O failure (refused, unreachable, transport reset).

TransportNotEnabled(UpstreamTransport)

Operator selected a transport this build does not implement — typed SERVFAIL discriminator (D9 in the dispatch ledger).

TlsHandshake(String)

rustls handshake failed (cert chain rejected, SNI mismatch, protocol error). Distinct from Self::Io so triage can tell “the resolver answered but with a bad cert” from “the resolver didn’t answer”.

NoTokioRuntime

Async transport invoked outside a tokio runtime — programming error in production (the supervisor always runs inside one) but explicit rather than panicking.

Trait Implementations

impl Debug for UpstreamError

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

Formats the value using the given formatter.

impl Display for UpstreamError

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

Formats the value using the given formatter.

impl Error for UpstreamError

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<Error> for UpstreamError

fn from(e: Error) -> Self

Converts to this type from the input type.