1CALIDNS(1)               PowerDNS Authoritative Server              CALIDNS(1)
2
3
4

NAME

6       calidns - A DNS recursor testing tool
7

SYNOPSIS

9       calidns [OPTIONS] QUERY_FILE DESTINATION INITIAL_QPS HITRATE
10

DESCRIPTION

12       calidns  reads  queries  from  QUERY_FILE and sends them as a recursive
13       query to DESTINATION (an IPv4 or IPv6 address, optionally with  a  port
14       number),  starting at INITIAL_QPS queries per second and aims to have a
15       cache hitrate of HITRATE percent.
16
17       It will then try to determine the maximum amount of queries per  second
18       the recursor can handle with the aforementioned HITRATE.
19

QUERY_FILE FORMAT

21       The  format  of the QUERY_FILE is very simple, it should contain "QNAME
22       QTYPE" tuples, one per line. For example:
23
24          powerdns.com A
25          powerdns.com AAAA
26          google.com A
27
28       This is similar to Alexa top 1 million list.
29

OPTIONS

31       --ecs <SUBNET>
32              Add EDNS Client Subnet option to outgoing queries  using  random
33              addresses from the specified SUBNET range (IPv4 only).
34
35       --ecs-from-file
36              Read  IP  or  subnet  values from the query file and add them as
37              EDNS Client Subnet option to outgoing queries.
38
39       --increment <NUM>
40              On every subsequent run, multiply the number of queries per sec‐
41              ond by NUM. By default, this is 1.1.
42
43       --maximum-qps <NUM>
44              Stop  incrementing once this rate has been reached, to provide a
45              stable load.
46
47       --minimum-success-rate <NUM>
48              Stop the test as soon as  the  success  rate  drops  below  this
49              value, in percent.
50
51       --plot-file <FILE>
52              Write results to the specified file.
53
54       --quiet
55              Whether to run quietly, outputting only the maximum QPS reached.
56              This option is  mostly  useful  when  used  with  --minimum-suc‐
57              cess-rate.
58
59       --want-recursion
60              Set  this  flag  to send queries with the Recursion Desired flag
61              set.
62

AUTHOR

64       PowerDNS.COM BV
65

67       2001-2021, PowerDNS.COM BV
68
69
70
71
72                                 Nov 09, 2021                       CALIDNS(1)
Impressum