5 stable releases

1.0.5 Jun 16, 2022

#32 in #dns-lookup

MIT license

12KB
200 lines

DNSBench

DNSBench is a simple command line utility that benchmarks DNS servers to determine the fastest round-trip time out of each of them. DNS lookup is a pivotal part of today's internet as DNS servers are the phonebooks of the internet. Each time you visit a webpage, your browser sends a query to a DNS server and it returns the IP address of the website's origin server you are trying to visit. If this DNS resolving process takes a long time, this can result in a degraded experience for the user.

Compiling from source

If you are on another platform, compile the binary yourself to try it out:

git clone https://github.com/tropicbliss/dnsbench
cd dnsbench
cargo build --release

Compiling from source requires the latest stable version of Rust. Older Rust versions may be able to compile buckshot, but they are not guaranteed to keep working.

The binary will be located in target/release.

Alternatively:

cargo install dnsbench

Usage

USAGE:
    dnsbench.exe [OPTIONS] --domain-name <DOMAIN_NAME> --file <FILE>

OPTIONS:
    -a, --attempts <ATTEMPTS>          Number of requests to run for each DNS server [default: 10]
    -d, --domain-name <DOMAIN_NAME>    Dummy domain name to lookup
    -f, --file <FILE>                  File containing newline delimited DNS addresses to measure
    -h, --help                         Print help information
    -r, --rate-limit <RATE_LIMIT>      Rate limited delay between each query of the same DNS server
                                       in seconds [default: 5]
    -V, --version                      Print version information

Before running this program, you must create a file that contains the IP addresses of the DNS servers you want to benchmark. Each IP address should be on a separate line.

# ip.txt
1.1.1.1
8.8.8.8

Example

  • Passing the path of the IP address text file (ip.txt) as a command line argument and using www.wikipedia.org as a dummy domain to test against.
./dnsbench -d www.wikipedia.org -f ip.txt

Dependencies

~18–28MB
~407K SLoC