Astro DNS-SD

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

Documentation

Features

Complete

• Service registration
• TXTRecord support for service registration

In Progress

• Service browsing

Todo

• How to check for more (select() on socket, but has to be win32 friendly)
• Record creation
• Name resolution
• Port map
• Tests
• Documentation
• Pure Rust TXT code?
• Interior mutability? (Can we reduce the &mut arguments some?)

Build Requirements

astro-dnssd requires the Bonjour SDK.

• 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

rust use astro_dnssd::register::DNSServiceBuilder; use astro_dnssd::txt::TXTRecord; let mut txt = TXTRecord::new(); let _ = txt.insert("s", Some("open")); let mut service = DNSServiceBuilder::new("_rust._tcp") .with_port(2048) .with_name("MyRustService") .with_txt_record(txt) .build() .unwrap(); let _result = service.register(|reply| match reply { Ok(reply) => println!("Successful reply: {:?}", reply), Err(e) => println!("Error registering: {:?}", e), }); loop { service.process_result(); }

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

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.