Struct trust_dns_client::rr::rdata::svcb::IpHint

#[repr(transparent)]
pub struct IpHint<T>(pub Vec<T, Global>);

   6.4.  "ipv4hint" and "ipv6hint"

  The "ipv4hint" and "ipv6hint" keys convey IP addresses that clients
  MAY use to reach the service.  If A and AAAA records for TargetName
  are locally available, the client SHOULD ignore these hints.
  Otherwise, clients SHOULD perform A and/or AAAA queries for
  TargetName as in Section 3, and clients SHOULD use the IP address in
  those responses for future connections.  Clients MAY opt to terminate
  any connections using the addresses in hints and instead switch to
  the addresses in response to the TargetName query.  Failure to use A
  and/or AAAA response addresses could negatively impact load balancing
  or other geo-aware features and thereby degrade client performance.

  The presentation "value" SHALL be a comma-separated list
  (Appendix A.1) of one or more IP addresses of the appropriate family
  in standard textual format [RFC5952].  To enable simpler parsing,
  this SvcParamValue MUST NOT contain escape sequences.

  The wire format for each parameter is a sequence of IP addresses in
  network byte order.  Like an A or AAAA RRSet, the list of addresses
  represents an unordered collection, and clients SHOULD pick addresses
  to use in a random order.  An empty list of addresses is invalid.

  When selecting between IPv4 and IPv6 addresses to use, clients may
  use an approach such as Happy Eyeballs [HappyEyeballsV2].  When only
  "ipv4hint" is present, IPv6-only clients may synthesize IPv6
  addresses as specified in [RFC7050] or ignore the "ipv4hint" key and
  wait for AAAA resolution (Section 3).  Recursive resolvers MUST NOT
  perform DNS64 ([RFC6147]) on parameters within a SVCB record.  For
  best performance, server operators SHOULD include an "ipv6hint"
  parameter whenever they include an "ipv4hint" parameter.

  These parameters are intended to minimize additional connection
  latency when a recursive resolver is not compliant with the
  requirements in Section 4, and SHOULD NOT be included if most clients
  are using compliant recursive resolvers.  When TargetName is the
  origin hostname or the owner name (which can be written as "."),
  server operators SHOULD NOT include these hints, because they are
  unlikely to convey any performance benefit.

Tuple Fields

0: Vec<T, Global>

Trait Implementations

impl<'r, T> BinDecodable<'r> for IpHint<T> where
    T: BinDecodable<'r>, 

pub fn read(decoder: &mut BinDecoder<'r>) -> Result<IpHint<T>, ProtoError>

The wire format for each parameter is a sequence of IP addresses in network byte order. Like an A or AAAA RRSet, the list of addresses represents an unordered collection, and clients SHOULD pick addresses to use in a random order. An empty list of addresses is invalid.

fn from_bytes(bytes: &'r [u8]) -> Result<Self, ProtoError>

Returns the object in binary form

impl<T> BinEncodable for IpHint<T> where
    T: BinEncodable, 

pub fn emit(&self, encoder: &mut BinEncoder<'_>) -> Result<(), ProtoError>

The wire format for each parameter is a sequence of IP addresses in network byte order. Like an A or AAAA RRSet, the list of addresses represents an unordered collection, and clients SHOULD pick addresses to use in a random order. An empty list of addresses is invalid.

fn to_bytes(&self) -> Result<Vec<u8, Global>, ProtoError>

Returns the object in binary form

impl<T> Clone for IpHint<T> where
    T: Clone, 

pub fn clone(&self) -> IpHint<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for IpHint<T> where
    T: Debug, 

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

Formats the value using the given formatter.

impl<T> Display for IpHint<T> where
    T: Display, 

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

The presentation “value” SHALL be a comma-separated list (Appendix A.1) of one or more IP addresses of the appropriate family in standard textual format RFC 5952. To enable simpler parsing, this SvcParamValue MUST NOT contain escape sequences.

impl<T> Hash for IpHint<T> where
    T: Hash, 

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T> PartialEq<IpHint<T>> for IpHint<T> where
    T: PartialEq<T>, 

pub fn eq(&self, other: &IpHint<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &IpHint<T>) -> bool

This method tests for !=.

impl<T> Eq for IpHint<T> where
    T: Eq, 

impl<T> StructuralEq for IpHint<T>

impl<T> StructuralPartialEq for IpHint<T>