Enum NetworkGuardError 

pub enum NetworkGuardError {
    InvalidHost(String),
    InvalidPort,
    NoAddresses {
        host: String,
        port: u16,
    },
    PortMismatch {
        expected: u16,
        address: SocketAddr,
    },
    LiteralMismatch {
        literal: IpAddr,
        address: SocketAddr,
    },
    CloudMetadata {
        host: String,
        reason: String,
    },
    PrivateHostDenied(String),
    PrivateHostResolvedPublic(String),
    PrivateNetworkDenied {
        host: String,
        reason: String,
    },
    MixedAddressClasses,
}

Why a host or its resolved address set is unsafe to dial.

This is the typed sibling of the validators’ anyhow errors, for callers that must branch on the reason rather than only report it.

Variants

InvalidHost(String)

The host is empty, malformed, or not a canonical DNS name/IP literal.

InvalidPort

Port zero is never a valid outbound destination.

NoAddresses

DNS returned no addresses.

Fields

host: String

port: u16

PortMismatch

A resolver returned an address for a different port.

Fields

expected: u16

address: SocketAddr

LiteralMismatch

A literal IP resolved to a different IP.

Fields

literal: IpAddr

address: SocketAddr

CloudMetadata

The answer set reaches a cloud metadata endpoint, directly or through a configured NAT64 prefix. Never allowed, whatever the private opt-in.

Fields

host: String

reason: String

PrivateHostDenied(String)

A syntactically local hostname was not explicitly authorized.

PrivateHostResolvedPublic(String)

A local hostname unexpectedly resolved only to public addresses.

PrivateNetworkDenied

The answer set contains a non-globally-routable address and private access was not authorized for this host.

Fields

host: String

reason: String

MixedAddressClasses

DNS returned both globally routable and private/local addresses.

Trait Implementations

impl Clone for NetworkGuardError

fn clone(&self) -> NetworkGuardError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkGuardError

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

Formats the value using the given formatter.

impl Display for NetworkGuardError

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

Formats the value using the given formatter.

impl Eq for NetworkGuardError

impl Error for NetworkGuardError

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 PartialEq for NetworkGuardError

fn eq(&self, other: &NetworkGuardError) -> 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 NetworkGuardError