7 releases

0.3.2 Oct 10, 2022
0.3.1 Sep 15, 2022
0.3.0 Aug 6, 2021
0.2.0 Oct 2, 2020
0.1.0 Apr 27, 2020

#3 in #mdns

Download history 35/week @ 2023-06-05 32/week @ 2023-06-12 99/week @ 2023-06-19 43/week @ 2023-06-26 46/week @ 2023-07-03 48/week @ 2023-07-10 63/week @ 2023-07-17 45/week @ 2023-07-24 43/week @ 2023-07-31 44/week @ 2023-08-07 69/week @ 2023-08-14 138/week @ 2023-08-21 81/week @ 2023-08-28 56/week @ 2023-09-04 34/week @ 2023-09-11 56/week @ 2023-09-18

249 downloads per month
Used in rs-matter

MIT/Apache

200KB
6K SLoC

Astro DNS-SD

Build Status License Cargo Documentation

Minimal but friendly safe wrapper around dns-sd(Bonjour, mDNS, Zeroconf DNS) APIs.

Documentation

Features

Complete

  • Service registration
  • TXTRecord support for service registration via HashMap
  • Service browsing

Todo

  • Record creation
  • Name resolution
  • Port map
  • Tests
  • Documentation

Build Requirements

astro-dnssd requires the Bonjour SDK (as of 0.3 on windows, it's optional, see win-bonjour feature flag)

  • Windows: Download the SDK here
  • Linux: Install avahi-compat-libdns_sd for your distro of choice.

Technical Background

This website provides a good overview of the DNS-SD protocol.

Example

use astro_dnssd::DNSServiceBuilder;
use env_logger::Env;
use std::thread::sleep;
use std::time::Duration;

fn main() {
    env_logger::from_env(Env::default().default_filter_or("trace")).init();
    println!("Registering service...");
    let service = DNSServiceBuilder::new("_http._tcp", 8080)
        .with_key_value("status".into(), "open".into())
        .register();

    {
        match service {
            Ok(service) => {
                println!("Registered... waiting 20s");
                sleep(Duration::from_secs(20));
                println!("Dropping... {:?}", service);
            }
            Err(e) => {
                println!("Error registering: {:?}", e);
            }
        }
    }
    log::info!("Drop should have happened");
    sleep(Duration::from_secs(5));
}

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.4–1.2MB
~24K SLoC