Debian Codegraph @

src/drool-replay.1in

raw
1 .\" DNS Reply Tool (drool)
2 .\"
3 .\" Copyright (c) 2017-2021, OARC, Inc.
4 .\" Copyright (c) 2017, Comcast Corporation
5 .\" All rights reserved.
6 .\"
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
9 .\" are met:
10 .\"
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
13 .\"
14 .\" 2. Redistributions in binary form must reproduce the above copyright
15 .\" notice, this list of conditions and the following disclaimer in
16 .\" the documentation and/or other materials provided with the
17 .\" distribution.
18 .\"
19 .\" 3. Neither the name of the copyright holder nor the names of its
20 .\" contributors may be used to endorse or promote products derived
21 .\" from this software without specific prior written permission.
22 .\"
23 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24 .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
26 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
27 .\" COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
28 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
29 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31 .\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
33 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34 .\" POSSIBILITY OF SUCH DAMAGE.
35 .\"
36 .TH drool 1 "@PACKAGE_VERSION@" "DNS Replay Tool"
37 .SH NAME
38 drool \- DNS Replay Tool
39 .SH SYNOPSIS
40 .B drool replay
41 [
42 .I options
43 ]
44 .B file
45 .B host
46 .B port
47 .SH DESCRIPTION
48 \fBdrool\fR can replay DNS traffic from packet capture (PCAP) files and send
49 it to a specified server, with options such as to manipulate the timing
50 between packets, as well as loop packets infinitely or for a set number
51 of iterations.
52 This tool's goal is to be able to produce a high amount of UDP packets per
53 second and TCP sessions per second on common hardware.
54
55 The purpose can be to simulate Distributed Denial of Service (DDoS) attacks
56 on the DNS and measure normal DNS querying.
57 For example, the tool could enable you to take a snapshot of a DDoS and be
58 able to replay it later to test if new code or hardening techniques are
59 useful, safe & effective.
60 Another example is to be able to replay a packet stream for a bug that is
61 sequence- and/or timing-related in order to validate the efficacy of
62 subsequent bug fixes.
63 .SH OPTIONS
64 These options are specific for the
65 .B replay
66 command, see
67 .IR drool (1)
68 for generic options.
69 .TP
70 .B \-D
71 Show DNS queries and responses as processing goes.
72 .TP
73 .B \-n \-\-no\-responses
74 Do not wait for responses before sending next request.
75 .TP
76 .B \-\-no\-tcp
77 Do not use TCP.
78 .TP
79 .B \-\-no\-udp
80 Do not use UDP.
81 .TP
82 .B \-T \-\-threads
83 Use threads.
84 .TP
85 .B \-\-tcp\-threads N
86 Set the number of TCP threads to use, default 2.
87 .TP
88 .B \-\-udp\-threads N
89 Set the number of UDP threads to use, default 4.
90 .TP
91 .B \-\-timeout N.N
92 Set timeout for waiting on responses [seconds.nanoseconds], default 10.0.
93 .TP
94 .B \-t \-\-timing mode[=option]
95 Set the timing mode, see TIMING MODES.
96 .SH EXAMPLES
97 .TP
98 .B drool replay \-\-timing multiply=0.5 \-\-no\-tcp file.pcap 127.0.0.1 53
99
100 Send all DNS queries twice as fast as found in the PCAP file to localhost
101 using UDP.
102 .TP
103 .B drool replay \-\-timing keep \-\-no\-udp file.pcap 127.0.0.1 53
104
105 Send all DNS queries over TCP to localhost as they were recorded.
106 .TP
107 .B drool replay \-\-no\-tcp \-\-no\-responses \-\-threads \-\-udp\-threads 3 file.pcap 127.0.0.1 53
108
109 Take all DNS queries found in the PCAP file and send them as fast as possible
110 over UDP to localhost by ignoring both timings, replies and starting 3 threads
111 that will simultaneously send queries.
112 .SH TIMING MODES
113 .TP
114 .B ignore
115 Set the timing mode to ignore all timings and try to send traffic as fast
116 as possible (default).
117 .TP
118 .B keep
119 Set the timing mode to try and keep up with interval between the traffic
120 received.
121 .TP
122 .B add=<nanoseconds>
123 Set the timing mode to add the given nanoseconds to the interval between
124 the traffic received.
125 .TP
126 .B reduce=<nanoseconds>
127 Set the timing mode to reduce the interval between the traffic received
128 with the given nanoseconds.
129 .TP
130 .B multiply=<float>
131 Set the timing mode to multiply the interval between the traffic received,
132 this can be thought as percent with 1.00 being 100% of the interval, 2.00
133 being 200%, 0.10 being 10% and so on.
134 .TP
135 .B fixed=<nanoseconds>
136 Set the timing between packets to the given nanoseconds.
137 .SH SEE ALSO
138 drool(1)
139 .SH AUTHORS
140 Jerry Lundström, DNS-OARC
141 .LP
142 Maintained by DNS-OARC
143 .LP
144 .RS
145 .I https://www.dns-oarc.net/
146 .RE
147 .LP
148 .SH BUGS
149 For issues and feature requests please use:
150 .LP
151 .RS
152 \fI@PACKAGE_URL@\fP
153 .RE
154 .LP
155 For question and help please use:
156 .LP
157 .RS
158 \fI@PACKAGE_BUGREPORT@\fP
159 .RE
160 .LP