Skip to content

crondaemon/dines

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dines

Build Status Coverage Status

Dines is the definitive answer to DNS testing. It allows the creation of any DNS packet with the possibility to fuzz some fields. Used in shell scripts allows also the creation of fake DNS servers that answer in custom ways.

Compilation

To compile dines:

autoreconf -i
./configure
make

To run dines tests:

make tests

Usage

This is the help from dines.

Fields with (F) can be fuzzed. (Example --txid F)
Fields with (F<n>) can be fuzzed for a specific length (Example --question F20,A,IN)
Fields with (R) are repeatable. (Example --answer)
Fields with (A) are calculated automatically.

Usage:
	CLIENT MODE: ./dines [<params>] <dns server>
	SERVER MODE: ./dines [<params>] --server=<port>

Params:

[IP]
--src-ip=<ip>: Source IP (AF)

[UDP]
--sport=<port>: source port (A)
--dport=<port>: destination port (A)

[DNS]
--txid=<id>: transaction id (AF)
--no-rd: no recursion desired (A)
--num-questions=<n>: number of questions (AF)
--question=<domain(F<n>)>,<type(F)>,<class(F)>: question domain

--num-ans=<n>: number of answers (AF)
--answer(R)=<domain(F<n>)>,<type(F)>,<class(F)>,<ttl(F)>,<rdata>: a DNS answer
--answer(R)=<domain(F<n>)>,<type(F)>,<class(F)>,<ttl(F)>,<rdatalen>,<rdata>: a DNS answer

--num-auth=<n>: number of authoritative records (AF)
--auth(R)=<domain|F<n>>,<type>,<class(F)>,<ttl(F)>,<rdata>: a DNS authoritative record
--auth(R)=<domain|F<n>>,<type>,<class(F)>,<ttl(F)>,<rdatalen>,<rdata>: a DNS authoritative record

--num-add=<n>: number of additional records (AF)
--additional(R)=<domain(F<n>)>,<type(F)>,<class(F)>,<ttl(F)>,<rdata>: a DNS additional record
--additional(R)=<domain(F<n>)>,<type(F)>,<class(F)>,<ttl(F)>,<rdatalen>,<rdata>: a DNS additional record

--server=<port>: run in server mode on port (A)

[MISC]
--num=<n>: number of packets (0 = infinite)
--delay=<usec>: delay between packets
--verbose: be verbose
--help: this help

Examples:
	./dines --question=www.example.com 1.2.3.4
	sudo ./dines --server
	./dines --server=30000
	./dines --server --answer=www.example.com,A,IN,64,1.2.3.4
	sudo ./dines --server --question www.example.com --answer www.example.com,A,IN,64,1.2.3.4 --upstream 8.8.8.8 --verbose

To generate a question, issue the following command:

./dines --question www.test.com,A,IN --num 1 192.168.1.1

that asks for domain www.test.com, sending 1 packet only. To generate an answer, one can use the following command

sudo ./dines --question www.test.com,1,1 --num 1
    --answer www.test.com,1,1,256,192.168.1.1
    --answer www.test.com,1,1,256,192.168.1.2 192.168.1.2

The switches related to resource records can be repeated multiple times. When resource record switches are used in short mode (without rdatalen), rdata is converted according to the query type. Qtype A is converted as an IP address, NS as a DNS name, and so on. To inject binary data directly, the extended mode can be used, as in the following example

./dines --question www.test.com,NULL,IN --num 1
    --answer www.test.com,NULL,IN,0,10,$'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a'
    192.168.1.2

Server Mode

Since version 0.5, dines supports server mode, that implements a minimalistic DNS server that serves arbitrary data. The syntax is the very same as in client mode: to activate server mode the user must specify --server with the UDP port the server listens on.

Related Projects

namescan: massive dns open relay scanner

About

Dines is the definitive answer to DNS testing

Resources

License

GPL-2.0, GPL-3.0 licenses found

Licenses found

GPL-2.0
LICENSE
GPL-3.0
COPYING

Stars

Watchers

Forks

Packages

No packages published