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

NAME

6       dnsreplay - A PowerDNS nameserver debugging tool
7

SYNOPSIS

9       dnsreplay [OPTION]... FILENAME ADDRESS [PORT]
10

DESCRIPTION

12       This  program  takes recorded questions and answers and replays them to
13       the specified nameserver and reporting afterwards which  percentage  of
14       answers matched, were worse or better.
15
16       dnsreplay  compares  the answers and some other metrics with the actual
17       ones with those found in the dumpfile.
18
19       By default it only replay queries with recursion-desired flag set.
20

OPTIONS

22       FILENAME
23              is expected to be an PCAP file. The queries are send to the  DNS
24              server specified as ADDRESS and PORT.
25
26       ADDRESS
27              IPv4 or IPv6 address of the nameserver to replay FILENAME to.
28
29       PORT   if omitted, 53 will be used.
30
31       --help, -h
32              Show summary of options.
33
34       --ecs-mask <VAL>
35              When  EDNS  forwarding  an IP address, mask out first octet with
36              this value
37
38       --ecs-stamp <FLAG>
39              Add original IP address as EDNS Client Subnet Option  when  for‐
40              warding to reference server
41
42       --packet-limit <NUM>
43              Stop  after  replaying  NUM packets. Default for NUM is 0, which
44              means no limit.
45
46       --pcap-dns-port <VAL>
47              Look at packets from or to this port in the PCAP. Default is 53.
48
49       --quiet <FLAG>
50              If FLAG is set to 1. dnsreplay will not be very noisy  with  its
51              output. This is the default.
52
53       --recursive <FLAG>
54              If FLAG is set to 1. dnsreplay will only replay queries with re‐
55              cursion desired flag set. This is the default.
56
57       --source-from-pcap <FLAG>
58              If FLAG is set to 1. dnsreplay will send  the  replayed  queries
59              from  the  source  IP address and port present in the PCAP file.
60              This requires IP_TRANSPARENT support. Default is 0  which  means
61              replayed queries will be sent from a local address.
62
63       --source-ip <VAL>
64              Send  the  replayed queries from the source IP specified in VAL.
65              Default is to send them from a local address.
66
67       --source-port <VAL>
68              Send the replayed queries from the source port specified in VAL.
69              Default is to send from a random port selected by the kernel.
70
71       --speedup <FACTOR>
72              Replay queries with this speedup FACTOR. Default is 1.
73
74       --timeout-msec <MSEC>
75              Wait at least MSEC milliseconds for a reply. Default is 500.
76

BUGS

78       dnsreplay  has  no  certain handling for timeouts. It handles around at
79       most 65536 outstanding answers.
80

SEE ALSO

82       pcap(3PCAP), tcpdump(8), dnswasher(1)
83

AUTHOR

85       PowerDNS.COM BV
86

88       2001-2023, PowerDNS.COM BV
89
90
91
92
93                                 Oct 05, 2023                     DNSREPLAY(1)
Impressum