calidns man page

calidns — A DNS recursor testing tool




calidns reads queries from QUERY_FILE and sends them as a recursive query to DESTINATION (an IPv4 or IPv6 address, optionally with a port number), starting at INITIAL_QPS queries per second and aims to have a cache hitrate of HITRATE percent.

It will then try to determine the maximum amount of queries per second the recursor can handle with the aforementioned HITRATE.

Query_file Format

The format of the QUERY_FILE is very simple, it should contain "QNAME QTYPE" tuples, one per line. For example: A AAAA A

This is similar to Alexa top 1 million list.


--ecs <SUBNET>

Add EDNS Client Subnet option to outgoing queries using random addresses from the specified SUBNET range (IPv4 only).


Read IP or subnet values from the query file and add them as EDNS Client Subnet option to outgoing queries.

--increment <NUM>

On every subsequent run, multiply the number of queries per second by NUM. By default, this is 1.1.

--maximum-qps <NUM>

Stop incrementing once this rate has been reached, to provide a stable load.

--minimum-success-rate <NUM>

Stop the test as soon as the success rate drops below this value, in percent.

--plot-file <FILE>

Write results to the specified file.


Whether to run quietly, outputting only the maximum QPS reached. This option is mostly useful when used with --minimum-success-rate.


Set this flag to send queries with the Recursion Desired flag set.



Referenced By


Nov 29, 2019 4.2 PowerDNS Authoritative Server