Struct ResolvedAddrs 

pub struct ResolvedAddrs { /* private fields */ }

Every address a name resolved to, in the order the resolver returned them.

Resolution used to end in .next(), which threw away everything after the first candidate. That is enough for an ip:port literal, but a hostname with several A/AAAA records — a relay behind round-robin DNS, or a dual-stack host whose first record is an unreachable IPv6 address — resolved to one address and then failed against it, with the working candidates never tried.

The dial loops below this were always able to try every address: both each_addr and the uni-stream providers iterate a ToSocketAddrs and only report the last error once every candidate has failed. They just never received more than one. So this type is the whole of the fix: carry the list to them, and they do the rest.

Guaranteed non-empty, so a caller never has to handle a resolution that succeeded with nothing in it. Cheap to clone — the addresses are shared, not copied — because every tunnel worker and every retry needs its own handle.

Implementations

impl ResolvedAddrs

pub fn from_candidates(addrs: Vec<SocketAddr>) -> Option<Self>

Build from candidates already resolved elsewhere, rejecting an empty list.

For callers that resolve through another address trait — the tunnel internals take a generic ToSocketAddrs at their public boundary — and need the result in this non-empty form.

pub fn as_slice(&self) -> &[SocketAddr]

The candidates, for handing to each_addr or a ToSocketAddrs bound.

&[SocketAddr] is what both address traits in play accept, and it is Copy, which the A: ToSocketAddrs + Copy bounds on the tunnel internals require. A Vec is neither.

pub fn primary(&self) -> SocketAddr

The first candidate.

For the places that genuinely need one address rather than a list: a SocketAddr field on a status record, a preflight probe, a log line. Not for dialling — that is what Self::as_slice is for.

Trait Implementations

impl Clone for ResolvedAddrs

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolvedAddrs

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

Formats the value using the given formatter.

impl Display for ResolvedAddrs

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

Renders the primary address, with a count when candidates were dropped.

Log lines pass these through %, and a bare Debug dump of a one-element list reads worse than the address itself.

impl Eq for ResolvedAddrs

impl From<SocketAddr> for ResolvedAddrs

fn from(addr: SocketAddr) -> Self

Converts to this type from the input type.

impl PartialEq for ResolvedAddrs

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ResolvedAddrs