Enum ServiceUpdate 

#[non_exhaustive]
pub enum ServiceUpdate {
    Established,
    Renamed(ServiceRenamed),
    Conflict,
    HostConflict,
}

Available on crate features compio or embassy-no-atomic or embassy or smol or smoltcp-no-atomic or smoltcp or tokio only.

Common, runtime-agnostic protocol types — re-exported from mdns_proto for ergonomics. Service / query specs, records, names, and update events are identical for every driver, so they live at the crate root; the runtime-specific entry points (the endpoint constructor and its handle types) live in the per-runtime driver modules (tokio, smol) or driver crates (compio, smoltcp, embassy). These require a proto storage tier, which every runtime / driver feature enables, so the re-export is gated on having one. App-level events emitted by Service::poll().

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Established

Probing completed without conflict; the service is now advertised.

Renamed(ServiceRenamed)

Probing detected a conflict; the service rebranded to a new name.

Conflict

A conflict cannot be resolved automatically (e.g. tiebreak space exhausted). The caller must intervene.

HostConflict

A peer claimed our host name (A/AAAA owner) during probing.

The service does NOT rename itself automatically. The caller must resolve the conflict by choosing a new host name and re-registering, or by deferring to the peer.

Implementations

impl ServiceUpdate

pub const fn is_established(&self) -> bool

Returns true if this value is of type Established. Returns false otherwise

pub const fn is_renamed(&self) -> bool

Returns true if this value is of type Renamed. Returns false otherwise

pub const fn is_conflict(&self) -> bool

Returns true if this value is of type Conflict. Returns false otherwise

pub const fn is_host_conflict(&self) -> bool

Returns true if this value is of type HostConflict. Returns false otherwise

impl ServiceUpdate

pub fn unwrap_established(self)

Unwraps this value to the ServiceUpdate::Established variant. Panics if this value is of any other type.

pub fn unwrap_established_ref(&self)

Unwraps this reference to the ServiceUpdate::Established variant. Panics if this value is of any other type.

pub fn unwrap_renamed(self) -> ServiceRenamed

Unwraps this value to the ServiceUpdate::Renamed variant. Panics if this value is of any other type.

pub fn unwrap_renamed_ref(&self) -> &ServiceRenamed

Unwraps this reference to the ServiceUpdate::Renamed variant. Panics if this value is of any other type.

pub fn unwrap_conflict(self)

Unwraps this value to the ServiceUpdate::Conflict variant. Panics if this value is of any other type.

pub fn unwrap_conflict_ref(&self)

Unwraps this reference to the ServiceUpdate::Conflict variant. Panics if this value is of any other type.

pub fn unwrap_host_conflict(self)

Unwraps this value to the ServiceUpdate::HostConflict variant. Panics if this value is of any other type.

pub fn unwrap_host_conflict_ref(&self)

Unwraps this reference to the ServiceUpdate::HostConflict variant. Panics if this value is of any other type.

impl ServiceUpdate

pub fn try_unwrap_established(self) -> Result<(), TryUnwrapError<ServiceUpdate>>

Attempts to unwrap this value to the ServiceUpdate::Established variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_established_ref( &self, ) -> Result<(), TryUnwrapError<&ServiceUpdate>>

Attempts to unwrap this reference to the ServiceUpdate::Established variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_renamed( self, ) -> Result<ServiceRenamed, TryUnwrapError<ServiceUpdate>>

Attempts to unwrap this value to the ServiceUpdate::Renamed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_renamed_ref( &self, ) -> Result<&ServiceRenamed, TryUnwrapError<&ServiceUpdate>>

Attempts to unwrap this reference to the ServiceUpdate::Renamed variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_conflict(self) -> Result<(), TryUnwrapError<ServiceUpdate>>

Attempts to unwrap this value to the ServiceUpdate::Conflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_conflict_ref( &self, ) -> Result<(), TryUnwrapError<&ServiceUpdate>>

Attempts to unwrap this reference to the ServiceUpdate::Conflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_host_conflict( self, ) -> Result<(), TryUnwrapError<ServiceUpdate>>

Attempts to unwrap this value to the ServiceUpdate::HostConflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

pub fn try_unwrap_host_conflict_ref( &self, ) -> Result<(), TryUnwrapError<&ServiceUpdate>>

Attempts to unwrap this reference to the ServiceUpdate::HostConflict variant. Returns a [TryUnwrapError] with the original value if this value is of any other type.

Trait Implementations

impl Clone for ServiceUpdate

fn clone(&self) -> ServiceUpdate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceUpdate

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

Formats the value using the given formatter.