Enum StunError 

pub enum StunError {
    Truncated,
    BadMagicCookie,
    TransactionIdMismatch,
    NoMappedAddress,
    UnexpectedType(u16),
    Io(String),
    Timeout,
}

Errors decoding a STUN message or performing a Binding transaction (SPEC.md §2.8).

Exhaustive and NOT #[non_exhaustive]: dig-nat re-exports this type and some of its consumers match on it exhaustively, so adding a variant is a breaking change tracked by SemVer rather than absorbed silently.

Variants

Truncated

The datagram was shorter than a valid STUN message / attribute.

BadMagicCookie

The magic cookie did not match — not a STUN (RFC 5389) message.

TransactionIdMismatch

The transaction id in the response did not match the request (possible spoof / stale reply).

NoMappedAddress

The message parsed but carried no usable mapped address: either no (XOR-)MAPPED-ADDRESS attribute at all, OR (for crate::query_reflexive_address only) a parsed address that failed the reflexive-usability guard (SPEC.md §5 — e.g. loopback, link-local, multicast, a documentation range, or port == 0).

UnexpectedType(u16)

The message type was not the one the caller expected (a Binding success response when parsing a response; a Binding request when parsing a request), or an attribute’s address family byte was neither IPv4 nor IPv6.

Io(String)

Underlying socket I/O error (stringified so StunError stays Clone/Eq).

Timeout

The transaction did not complete within the deadline.

Trait Implementations

impl Clone for StunError

fn clone(&self) -> StunError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StunError

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

Formats the value using the given formatter.

impl Display for StunError

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

Formats the value using the given formatter.

impl Eq for StunError

impl Error for StunError

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<StunError> for SignedQueryError

fn from(source: StunError) -> Self

Converts to this type from the input type.

impl From<StunError> for CredentialError

fn from(source: StunError) -> Self

Converts to this type from the input type.

impl PartialEq for StunError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StunError