#dns #client


A small, simple and secure DNS client library

18 releases

0.1.17 Dec 15, 2021
0.1.16 Oct 16, 2021
0.1.15 Aug 26, 2021
0.1.9 Dec 21, 2020
0.1.2 Nov 9, 2018

#105 in Unix APIs

Download history 51/week @ 2022-11-27 77/week @ 2022-12-04 118/week @ 2022-12-11 77/week @ 2022-12-18 120/week @ 2022-12-25 166/week @ 2023-01-01 83/week @ 2023-01-08 83/week @ 2023-01-15 207/week @ 2023-01-22 161/week @ 2023-01-29 173/week @ 2023-02-05 229/week @ 2023-02-12 171/week @ 2023-02-19 127/week @ 2023-02-26 146/week @ 2023-03-05 97/week @ 2023-03-12

570 downloads per month
Used in 9 crates (5 directly)

ISC license

996 lines

A simple and secure DNS client for Rust

API documentation

This is a DNS client crate. Some people may call that a stub resolver.

It can resolve IPv4 and IPv6 addresses. But unlike std::net::ToSocketAddrs, it directly contacts upstream servers, and doesn't depend on the system resolver. Which, in the worst case, could be systemd.

Instead, your application fully controls what upstream resolvers will be used.

It can also send raw queries, and return raw responses, retrying over multiple server candidates if necessary.

DNSClient carefully checks the consistency of every single packet it receives.

It will not let clients initiate zone transfers. It may prevent funky DNS implementations from crashing or being exploited when a malicious query or response is received.

It also transparently falls back to TCP when a truncated response is received.

Finally, its API couldn't be any simpler.

DNSClient comes with a synchronous interface (sync::*) as well as anasynchronous interface (async::*).

Cargo features:

  • async: use async-std as an async backend
  • async-tokio: use tokio as an async backend


~198K SLoC