rsdns is a Rust library for interacting with DNS servers.
Its main goal is to query the Domain Name System and return the results in easily consumable Rust types.
rsdns strives to be simple and fast. To be simple rsdns keeps a minimal API. To be fast rsdns aims to allow DNS message parsing with minimal overhead.
There are crates which implement asynchronous DNS clients, but are built for a single async runtime. This somewhat blocks usage of such client in an application built around another runtime. rsdns closes this gap and genuinely supports three different async runtimes. Moreover, rsdns has an independent synchronous client as well.
- Minimal API
- Asynchronous DNS clients for
tokio,async-stdandsmol - Blocking client implemented with
std::net - Zero memory allocations when parsing records with no variable size fields
- Sockets can be bound to network interfaces by name (available on operating
systems with
SO_BINDTODEVICEsupport) - Minimal set of dependencies
rsdns comes with a small command-line tool ch4. ch4 uses rsdns to query the Domain Name System, and shows the results in a zone-file format. It can be used as a simple substitute for dig, especially on platforms where dig is not originally supported.
- RFC 1035 - the foundation of DNS protocol:
A,NS,TXT,CNAME,SOA,MX,PTR,ANYetc. - RFC 1101, RFC 1123 - allow leading digits in domain name labels
- RFC 2181 - RRSet definition and TTL handling
- RFC 2671, RFC 6891 - EDNS0
- RFC 3596 -
AAAA - RFC 7766 - DNS Transport over TCP, TCP message length field handling
The following is a short list of features planned for the near future.
- Zero memory allocation for all essential data-types records
- RFC 2782 -
SRV - RFC 6844 -
CAA - RFC 7208 -
SPF
The changelog is maintained in CHANGELOG.md
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.
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.