Struct simple_mdns::ServiceDiscovery

pub struct ServiceDiscovery { /* fields omitted */ }

Service Discovery implementation using DNS-SD. This implementation advertise all the registered addresses, query for the same service on the same network and keeps a cache of known service instances

Notice that this crate does not provide any means of finding your own ip address. There are crates that provide this kind of feature.

Example

use simple_mdns::ServiceDiscovery;
use std::net::SocketAddr;
use std::str::FromStr;

let mut discovery = ServiceDiscovery::new("a", "_mysrv._tcp.local", 60).expect("Invalid Service Name");
discovery.add_service_info(SocketAddr::from_str("192.168.1.22:8090").unwrap().into());

Implementations

impl ServiceDiscovery

pub fn new(
    instance_name: &'static str,
    service_name: &'static str,
    resource_ttl: u32
) -> Result<Self, SimpleMdnsError>

Creates a new ServiceDiscovery by providing instance, service_name, resource ttl and loopback activation. instance_name and service_name will be composed together in order to advertise this instance, like instance_name.service_name

instance_name must be in the standard specified by the mdns RFC and short, example: _my_inst service_name must be in the standard specified by the mdns RFC, example: _my_service._tcp.local resource_ttl refers to the amount of time in seconds your service will be cached in the dns responder. set enable_loopback to true if you may have more than one instance of your service running in the same machine

pub fn add_service_info(&mut self, service_info: InstanceInformation)

Add the service info to discovery and immediately advertise the service

pub fn remove_service_from_discovery(&mut self)

Remove all addresses from service discovery

pub fn get_known_services(&self) -> Vec<InstanceInformation>

Return the addresses of all known services