#service-discovery #mdns #discovery #zeroconf #dns-sd

mdns-sd

mDNS Service Discovery library with no async runtime dependency

41 releases (10 breaking)

0.11.1 May 14, 2024
0.10.5 Mar 25, 2024
0.10.2 Dec 28, 2023
0.10.0 Nov 28, 2023
0.1.0 Oct 17, 2021

#143 in Network programming

Download history 1292/week @ 2024-02-14 1290/week @ 2024-02-21 1470/week @ 2024-02-28 1256/week @ 2024-03-06 1279/week @ 2024-03-13 1532/week @ 2024-03-20 1284/week @ 2024-03-27 1476/week @ 2024-04-03 1241/week @ 2024-04-10 1487/week @ 2024-04-17 1148/week @ 2024-04-24 1570/week @ 2024-05-01 1824/week @ 2024-05-08 1831/week @ 2024-05-15 1568/week @ 2024-05-22 1363/week @ 2024-05-29

6,850 downloads per month
Used in 25 crates (13 directly)

Apache-2.0 OR MIT

210KB
4K SLoC

mdns-sd

Build Cargo docs.rs Rust version: 1.63+

This is a small implementation of mDNS (Multicast DNS) based service discovery in safe Rust, with a small set of dependencies. Some highlights:

  • supports both the client (querier) and the server (responder) uses.
  • supports macOS, Linux and Windows.
  • supports IPv4 and IPv6.
  • works with both sync and async code.
  • no dependency on any async runtimes.

Approach

We are not using async/.await internally, instead we create a new thread to run a mDNS daemon.

The API interacts with the daemon via flume channels that work easily with both sync and async code. For more details, please see the documentation.

Compatibility and Limitations

This implementation is based on the following RFCs:

This is still beta software. We focus on the common use cases at hand. And we tested with some existing common tools (e.g. Avahi on Linux, dns-sd on MacOS, and Bonjour library on iOS) to verify the basic compatibility.

Currently this library has the following limitations:

  • Only support multicast, no unicast send/recv.

License

Licensed under either of

at your option.

Contribution

Contributions are welcome! Please open an issue in GitHub if any questions.

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

Dependencies

~0.7–8MB
~57K SLoC