Struct ServiceBinding 

pub struct ServiceBinding { /* private fields */ }

Available on crate features dns and std only.

Decoded RDATA shared by SVCB and HTTPS resource records.

This client-side wire model is intentionally parse-only. DNS record construction and authoritative-server encoding are outside its scope.

Implementations

impl ServiceBinding

pub fn parse_rdata( rdata: &[u8], ) -> Result<ServiceBinding, ServiceBindingParseError>

Parse one complete borrowed SVCB-compatible RDATA value.

The RDATA is copied once into shared immutable storage. Use ServiceBinding::parse_rdata_bytes when the caller already owns Bytes to avoid that copy.

pub fn parse_rdata_bytes( rdata: &Bytes, ) -> Result<ServiceBinding, ServiceBindingParseError>

Parse one complete, owned SVCB-compatible RDATA value without copying opaque parameter bytes.

This enforces the wire-format and self-consistency requirements in RFC 9460 Sections 2.2, 2.4.3, 7, and 8. RFC 9848 ECHConfigList framing is also checked, without interpreting version-specific TLS contents.

pub const fn priority(&self) -> u16

Return the record’s SvcPriority.

pub const fn target(&self) -> &Name

Return the record’s TargetName.

pub const fn params(&self) -> &[SvcParam]

Return the record’s service parameters in numeric key order.

pub const fn is_alias_mode(&self) -> bool

Return whether this record is in AliasMode.

pub const fn is_service_mode(&self) -> bool

Return whether this record is in ServiceMode.

pub fn param(&self, key: SvcParamKey) -> Option<&SvcParam>

Look up a parameter by numeric key.

pub fn mandatory_keys(&self) -> Option<&[SvcParamKey]>

Return the explicitly mandatory keys, if present.

pub fn alpn_protocols(&self) -> Option<&AlpnList>

Return the advertised ALPN protocol identifiers, if present.

pub fn has_no_default_alpn(&self) -> bool

Return whether the protocol mapping’s default ALPN set is suppressed.

pub fn port(&self) -> Option<u16>

Return the alternative endpoint port, if present.

pub fn ipv4_hints(&self) -> Option<&[Ipv4Addr]>

Return the advertised IPv4 address hints, if present.

pub fn ech_config_list(&self) -> Option<&Bytes>

Return the framed ECHConfigList, if present.

pub fn ipv6_hints(&self) -> Option<&[Ipv6Addr]>

Return the advertised IPv6 address hints, if present.

Trait Implementations

impl Clone for ServiceBinding

fn clone(&self) -> ServiceBinding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceBinding

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

Formats the value using the given formatter.

impl Display for ServiceBinding

Formats a human-readable service-binding diagnostic.

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

Formats the value using the given formatter.

impl Eq for ServiceBinding

impl PartialEq for ServiceBinding

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ServiceBinding