Debian Codegraph @

src/drool.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 command
41 [
42 .I options
43 ] <
44 .I arguments
45 >
46 .SH DESCRIPTION
47 .B drool
48 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 COMMANDS
64 .B drool
65 is divided into various commands for different scenarios.
66 Each command has it's own man-page, may take different arguments and may
67 have additional options.
68 .TP
69 .B replay
70 Replay DNS from a PCAP file, see
71 .IR drool-replay (1).
72 .TP
73 .B respdiff
74 Replay DNS and store the responses along with the responses found in the PCAP
75 for analysis with the
76 .I respdiff
77 tool-chain, see
78 .IR drool-respdiff (1).
79 .SH OPTIONS
80 These options are generic for all
81 .B drool
82 commands.
83 .TP
84 .B \-\-csv
85 Output statistics as CSV.
86 .TP
87 .B \-\-json
88 Output statistics as JSON.
89 .TP
90 .B \-v \-\-verbose
91 Enable verbose logging, can be given multiple times to increase verbosity level.
92 .TP
93 .B \-h \-\-help
94 Print help and exit.
95 .TP
96 .B \-V \-\-version
97 Print version and exit.
98 .SH EXIT VALUES
99 0 \- no error
100 .br
101 1 \- generic error
102 .SH SEE ALSO
103 drool-replay(1)
104 .SH AUTHORS
105 Jerry Lundström, DNS-OARC
106 .LP
107 Maintained by DNS-OARC
108 .LP
109 .RS
110 .I https://www.dns-oarc.net/
111 .RE
112 .LP
113 .SH BUGS
114 For issues and feature requests please use:
115 .LP
116 .RS
117 .I @PACKAGE_URL@
118 .RE
119 .LP
120 For question and help please use:
121 .LP
122 .RS
123 .I @PACKAGE_BUGREPORT@
124 .RE
125 .LP