manpages for dnsscope, dnswasher, dnsreplay, contributed by joerg jungermann!

git-svn-id: svn://svn.powerdns.com/pdns/trunk/pdns@2726 d19b8d6e-7fed-0310-83ef-9ca221ded41b

diff --git a/pdns/docs/dnsreplay.8 b/pdns/docs/dnsreplay.8
new file mode 100644 (file)
index 0000000..9ae7410
--- /dev/null
+++ b/pdns/docs/dnsreplay.8
@@ -0,0 +1,47 @@
+.TH DNSREPLAY 8 "September 2012" "PowerDNS"
+.SH NAME
+dnswasher \- A PowerDNS nameserver debugging tool
+.SH SYNOPSIS
+.B dnsreplay  \fI[options]\fR \fIfilename\fR \fIip-address\fR \fI[port]\fR
+.SH DESCRIPTION
+This program takes recorded questions and answers and replays them to a specified 
+nameserver and reporting afterwards which percentage of answers matched, were worse or better. 
+
+\fIfilename\fR is expected to be an PCAP file.
+The queries are send to the DNS server specified as  \fIip-address\fR and \fI[port]\fR.
+\fIip-address\fR is mandatory. If  \fI[port]\fR is omitted, 53 will be used.
+dnsreplay compares the answers and some other metrics with the actual ones with those found in the dumpfile.
+
+By default it only replay queries with recursion-desired flag set.
+.SH OPTIONS
+.TP
+.B \-\-help | \-h
+.br
+Show summary of options.
+.TP
+.B \-\-packet\-limit  \fInum\fR
+.br
+Stop after replaying \fInum\fR packets. Default for \fInum\fR is 0, which means no limit.
+.TP
+.B \-\-quiet  \fIflag\fR
+.br
+If \fIflag\fR is set to 1. dnsreplay will not be very noisy with its output. This is the default.
+.TP
+.B \-\-recursive  \fIflag\fR
+.br
+If \fIflag\fR is set to 1. dnsreplay will only replay queries with recursion desired flag set. This is the default.
+.TP
+.B \-\-speedup \fIfactor\fR
+.br
+Replay queries with this speedup factor. Default is 1.
+.TP
+.B \-\-timeout-msec \fItime\fR
+.br
+Wait at least this many milliseconds for a reply. Default is 500.
+.SH BUGS
+dnsreplay has no certain handling for timeouts. It handles around at most 65536 outstanding answers.
+.SH SEE ALSO
+pcap(3PCAP), tcpdump(8), dnswascher(8)
+.SH AUTHORS
+This manpage was written by Joerg Jungermann (jj+debian At borkum.net) for the 
+Debian Project and the PowerDNS versatile DNS server.

diff --git a/pdns/docs/dnsscope.8 b/pdns/docs/dnsscope.8
new file mode 100644 (file)
index 0000000..a50e13a
--- /dev/null
+++ b/pdns/docs/dnsscope.8
@@ -0,0 +1,14 @@
+.TH DNSSCOPE 8 "September 2012" "PowerDNS"
+.SH NAME
+dnsscope \- A PowerDNS nameserver debugging tool
+.SH SYNOPSIS
+.B dnsscope  \fI[infile]\fR
+.SH DESCRIPTION
+dnsscope takes an \fIinfile\fR in PCAP format. It generates some simple statistics outputs these to STDOUT.
+.SH OPTIONS
+None.
+.SH SEE ALSO
+pcap(3PCAP), tcpdump(8)
+.SH AUTHORS
+This manpage was written by Joerg Jungermann (jj+debian At borkum.net) for the 
+Debian Project and the PowerDNS versatile DNS server.

diff --git a/pdns/docs/dnswasher.8 b/pdns/docs/dnswasher.8
new file mode 100644 (file)
index 0000000..39af22b
--- /dev/null
+++ b/pdns/docs/dnswasher.8
@@ -0,0 +1,17 @@
+.TH DNSWASHER 8 "September 2012" "PowerDNS"
+.SH NAME
+dnswasher \- A PowerDNS nameserver debugging tool
+.SH SYNOPSIS
+.B dnswasher  \fI[infile]\fR  \fI[outfile]\fR
+.SH DESCRIPTION
+dnswasher takes an \fIinfile\fR in PCAP format and writtes out \fIoutfile\fR 
+also in PCAP format. It copies all network traffic found in \fIinfile\fR to  \fIoutfile\fR
+except for non DNS traffic.
+This might be handy when creating bug reports or test cases for DNS software e.g. PowerDNS.
+.SH OPTIONS
+None.
+.SH SEE ALSO
+pcap(3PCAP), tcpdump(8)
+.SH AUTHORS
+This manpage was written by Joerg Jungermann (jj+debian At borkum.net) for the 
+Debian Project and the PowerDNS versatile DNS server.