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.

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 returns error, it means we failed to send the request to the daemon as the channel closed. Retry probably won’t help. The caller should just note down the error 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 returns error, it means we failed to send the request to the daemon as the channel closed. Retry probably won’t help. The caller should just note down the error and move on.

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

Shuts down the daemon thread.

When returns error, the caller should just note down the error and move on. No need to retry.

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.