Struct mdns_sd::ServiceDaemon

pub struct ServiceDaemon { /* fields omitted */ }

A daemon thread for mDNS

This struct provides a handle and an API to the daemon. It is cloneable.

Implementations

impl ServiceDaemon

pub fn new() -> Result<Self>

Creates a new daemon.

The daemon (re)uses the default mDNS port 5353. To keep it simple, we don’t ask callers to set the port.

pub fn browse(&self, service_type: &str) -> Result<Receiver<ServiceEvent>>

Starts browsing for a specific service type.

Returns a channel Receiver to receive events about the service. The caller can call .try_recv() on this receiver to handle events in an async environment or call .recv() in a sync environment.

When a new instance is found, the daemon automatically tries to resolve, i.e. finding more details, i.e. SRV records and TXT records.

pub fn stop_browse(&self, ty_domain: &str) -> Result<()>

Stops searching for a specific service type.

When an error is returned, the caller should retry only when the error is Error::Again, otherwise should log and move on.

pub fn register(&self, service_info: ServiceInfo) -> Result<()>

Registers a service provided by this host.

pub fn unregister(&self, fullname: &str) -> Result<Receiver<UnregisterStatus>>

Unregisters a service. This is a graceful shutdown of a service.

Returns a channel receiver that is used to receive the status code of the unregister.

When an error is returned, the caller should retry only when the error is Error::Again, otherwise should log and move on.

pub fn shutdown(&self) -> Result<()>

Shuts down the daemon thread.

When an error is returned, the caller should retry only when the error is Error::Again, otherwise should log and move on.

Trait Implementations

impl Clone for ServiceDaemon

fn clone(&self) -> ServiceDaemon

Returns a copy of the value.

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

Performs copy-assignment from source.