Struct ServiceRecords 

#[non_exhaustive]
pub struct ServiceRecords { /* private fields */ }

Records advertised by a single registered service.

Implementations

impl ServiceRecords

pub fn new( service_type: Name, instance: Name, host: Name, port: u16, ttl_secs: u32, ) -> ServiceRecords

Construct a new record bundle with the required fields. Optional fields (records, txt, priority, weight) start empty/default.

service_type is the DNS-SD PTR owner, e.g. _ipp._tcp.local.. It must be the parent label sequence of instance.

pub fn service_type(&self) -> &Name

The DNS-SD service type (PTR owner), e.g. _ipp._tcp.local..

pub fn instance(&self) -> &Name

The instance name (e.g. MyPrinter._ipp._tcp.local.).

pub fn host(&self) -> &Name

The SRV target hostname.

pub const fn port(&self) -> u16

The service port.

pub const fn priority(&self) -> u16

SRV priority field.

pub const fn weight(&self) -> u16

SRV weight field.

pub const fn ttl_secs(&self) -> u32

Record TTL in seconds.

pub fn a_addrs_slice(&self) -> &[Ipv4Addr]

Slice of IPv4 addresses.

pub fn aaaa_addrs_slice(&self) -> &[Ipv6Addr]

Slice of IPv6 addresses.

pub fn aaaa_scopes_slice(&self) -> &[u32]

Slice of per-AAAA interface scope ids (one entry per AAAA address; parallel to Self::aaaa_addrs_slice). A scope of 0 means “unscoped / any interface” — appropriate for global addresses or when the caller does not know which interface the link-local will be published on.

Used by Endpoint to disambiguate IPv6 link-local self-loopback on multi-homed hosts.

pub fn txt_segments(&self) -> impl Iterator<Item = &[u8]>

TXT segments as an iterator over byte slices.

pub fn add_a(&mut self, addr: Ipv4Addr) -> &mut ServiceRecords

Append an IPv4 address.

pub fn add_aaaa(&mut self, addr: Ipv6Addr) -> &mut ServiceRecords

Append an IPv6 address with an unspecified interface scope.

Equivalent to Self::add_aaaa_scoped with scope_id = 0. For link-local addresses on multi-homed hosts prefer Self::add_aaaa_scoped so self-loopback detection can distinguish your own packets from peer packets that share the same numeric link-local on another interface.

pub fn add_aaaa_scoped( &mut self, addr: Ipv6Addr, scope_id: u32, ) -> &mut ServiceRecords

Append an IPv6 address bound to a specific interface scope.

scope_id is typically the receiving interface index (the same value the host’s if_nametoindex(3) returns). Endpoint::handle matches self-loopback for link-local sources by (address, scope) so a peer’s identical link-local on a different interface is NOT misclassified as self.

A scope_id of 0 keeps the legacy behaviour (matches any interface). For global / unique-local IPv6 the scope is effectively ignored.

pub fn add_txt_segment(&mut self, segment: Vec<u8>) -> &mut ServiceRecords

Append a TXT segment.

pub fn subtype_names(&self) -> &[Name]

The RFC 6763 §7.1 subtype browse names registered for this service (each the full <subtype>._sub.<service_type> form).

pub fn add_subtype( &mut self, subtype: &str, ) -> Result<&mut ServiceRecords, NameError>

Register a DNS-SD subtype (RFC 6763 §7.1). subtype is the subtype label (e.g. "_printer"); the full browse name <subtype>._sub.<service_type> is derived from the current service type and stored. The service then advertises a shared PTR <browse_name> -> instance and answers browse queries for it.

Returns a NameError if the derived <subtype>._sub.<service_type> is not a valid DNS name (e.g. an over-long label or total length).

pub fn set_priority(&mut self, v: u16) -> &mut ServiceRecords

Set SRV priority.

pub fn set_weight(&mut self, v: u16) -> &mut ServiceRecords

Set SRV weight.

pub fn set_ttl_secs(&mut self, v: u32) -> &mut ServiceRecords

Set TTL in seconds.

pub fn set_instance(&mut self, name: Name) -> &mut ServiceRecords

Replace the instance name (used during conflict-driven rename).

Trait Implementations

impl Clone for ServiceRecords

fn clone(&self) -> ServiceRecords

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceRecords

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

Formats the value using the given formatter.

impl Eq for ServiceRecords

impl PartialEq for ServiceRecords

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ServiceRecords