Struct trust_dns_proto::rr::rdata::svcb::IpHint

source ·
#[repr(transparent)]
pub struct IpHint<T>(pub Vec<T>);
Expand description
   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>

Trait Implementations§

source§

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

source§

fn read(decoder: &mut BinDecoder<'r>) -> ProtoResult<Self>

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.

source§

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

Returns the object in binary form
source§

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

source§

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

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.

source§

fn to_bytes(&self) -> ProtoResult<Vec<u8>>

Returns the object in binary form
source§

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

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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.

source§

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

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

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

source§

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

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

source§

impl<T> StructuralPartialEq for IpHint<T>

Auto Trait Implementations§

§

impl<T> Freeze for IpHint<T>

§

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

§

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

§

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

§

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

§

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

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

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

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

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

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more