# dnsperf

**Repository Path**: birdy-wang/dnsperf

## Basic Information

- **Project Name**: dnsperf
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-17
- **Last Updated**: 2025-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

dnsperf
======
A DNS performance tool.

### Introduction
Dnsperf is a single-process dns load testing and benchmarking utility. It was designed to measure the performance of your
DNS Server or Local DNS Server by send a configured number of queries.
Performance measures contains elapsed time, its transation rate, its concurrrency and the percentage of successful queries.
These measures are reported at the end of each testing.

### Usage
Dnsperf supports the following command line options:

**-s**
    Specifies the DNS server's IP address. The default IP is `127.0.0.1`.  
**-p**
    Specifies the DNS server's port. The default Port is `53`.  
**-d**
    Specifies the input data file. Input data file contains `query domain` and `query type`.  
**-t**
    Specifies the timeout for query completion in millisecond. The default timeout is `3000ms`.  
**-Q**
    Specifies the max number of queries to be send. The default number is `1000`.  
**-c**
    Specifies the number of concurrent queries. The default number is `100`. Dnsperf will randomly pick a `query domain` from data file as QNAME.  
**-l**
    Specifies how long to run tests in seconds. The default number is infinite.  
**-e**
    This will sets the real client IP in query string following the rules defined in [edns-client-subnet].  

**-i**
    Specifies interval of queries in seconds. The default number is zero. This option is not supported currently.  
**-P**
    Specifies the transport layer protocol to send DNS queries, `udp` or `tcp`. As we know, although UDP is the suggested protocol, DNS queries can be send either by UDP or TCP. The default is `udp`. `tcp` is not supported currently, and it is coming soon.  
**-f**
    Specify address family of DNS transport, `inet` or `inet6`. The default is `inet`. `inet6` is not supported currently.  
**-v**
    Verbose: report the RCODE of each response on stdout.  
**-h**
    Print the usage of dnsperf.  

### Data file format
An example of data file format is shown in file `a.out` in project directory.
In the file, the line begin with `#` is recgonized as comment. Each useful line contains two columns. The first column is the `domain name` to be queried, and the second column is the `query type`.  
The `query type` currently supported includes:  `A`,`NS`,`MD`,`MF`,`CNAME`,`SOA`,`MB`,`MG`,`MR`,`NULL`,`WKS`,`PTR`,`HINFO`,`MINFO`,`MX`,`TXT`,`AAAA`,`SRV`,`NAPTR`,`A6`,`ASFR`,`MAILB`,`MAILA`,`ANY`.

### Performance Statistics
Performance statistics will displayed on your `stdin` after testing. The following is a sample outputs.
```sh
DNS Performance Testing Tool

[Status] Processing query data
[Status] Sending queries to 127.0.0.1:53
time up
[Status]DNS Query Performance Testing Finish
[Result]Queries sent:		35650
[Result]Queries completed:	35578
[Result]Complete percentage:	99.80%

[Result]Elapsed time(s):	1.00000

[Result]Queries Per Second:	35650.0000
```
The outputs is easy to comprehend.

### Author
Cobblau, <keycobing@gmail.com>

[edns-client-subnet]: http://www.afasterinternet.com/ietfdraft.htm