]> git.ipfire.org Git - thirdparty/pdns.git/commitdiff
Add missing manpages
authorPieter Lexis <pieter.lexis@powerdns.com>
Thu, 23 Apr 2015 14:43:27 +0000 (16:43 +0200)
committerPieter Lexis <pieter.lexis@powerdns.com>
Thu, 23 Apr 2015 16:51:48 +0000 (18:51 +0200)
docs/Makefile.am
docs/manpages/dnsbulktest.1.md [new file with mode: 0644]
docs/manpages/dnsgram.1.md [new file with mode: 0644]
docs/manpages/dnsscan.1.md [new file with mode: 0644]
docs/manpages/nsec3dig.1.md [new file with mode: 0644]
docs/manpages/saxfr.1.md [new file with mode: 0644]

index 34f81e31f5a51438c691bf466a2b421fedf5d572..297e4d83eaaf6ade59b60479e5408c3889e89567 100644 (file)
@@ -1,11 +1,18 @@
-MANPAGES_TARGET = dnsdist.1 \
+MANPAGES_TARGET = dnsbulktest.1 \
+       dnsdist.1 \
+       dnsgram.1 \
        dnsreplay.1 \
+       dnsscan.1 \
        dnsscope.1 \
        dnstcpbench.1 \
        dnswasher.1 \
+       nsec3dig.1 \
        pdns_control.1 \
+       pdns_recursor.1 \
        pdnssec.1 \
        pdns_server.1 \
+       rec_control.1 \
+       saxfr.1 \
        zone2ldap.1 \
        zone2sql.1
 
diff --git a/docs/manpages/dnsbulktest.1.md b/docs/manpages/dnsbulktest.1.md
new file mode 100644 (file)
index 0000000..6e3a10a
--- /dev/null
@@ -0,0 +1,27 @@
+% DNSBULKTEST(1)
+% PowerDNS.com BV
+% April 2015
+
+# NAME
+**dnsbulktest** - A debugging tool for intermittent resolver failures
+
+# SYNOPSIS
+**dnsbulktest** [*OPTION*]... *IPADDRESS* *PORT* [*LIMIT*]
+
+# DESCRIPTION
+**dnsbulktest** sends a large amount of different queries (for up to *LIMIT*
+different domains) to the nameserver at *IPADDRESS* on port *PORT*. It reads the
+domain names from STDIN in the alexa topX format and outputs statistics on STDOUT.
+
+# OPTIONS
+--help, -h
+:    Show a summary of options.
+
+--quiet, -q
+:    Don't show information on individual queries.
+
+--type, -t *TYPE*
+:    Query the nameserver for *TYPE*, A by default.
+
+--envoutput, -e
+:    Write results on STDOUT as shell environment variables
diff --git a/docs/manpages/dnsgram.1.md b/docs/manpages/dnsgram.1.md
new file mode 100644 (file)
index 0000000..d10928d
--- /dev/null
@@ -0,0 +1,19 @@
+% DNSGRAM(1)
+% PowerDNS.com BV
+% April 2015
+
+# NAME
+**dnsgram** - A debugging tool for intermittent resolver failures
+
+# SYNOPSIS
+**dnsgram** *INFILE*...
+
+# DESCRIPTION
+**dnsgram** takes one or more *INFILE*s in PCAP format and generates statistics
+on 5 second segments allowing the study of intermittent resolver issues.
+
+# OPTIONS
+None
+
+# SEE ALSO
+pcap(3PCAP), tcpdump(8)
diff --git a/docs/manpages/dnsscan.1.md b/docs/manpages/dnsscan.1.md
new file mode 100644 (file)
index 0000000..ad80394
--- /dev/null
@@ -0,0 +1,20 @@
+% DNSSCAN(1)
+% PowerDNS.com BV
+% April 2015
+
+# NAME
+**dnsscan** - List the amount of queries per qtype in a pcap
+
+# SYNOPSIS
+**dnsscan** *INFILE*...
+
+# DESCRIPTION
+**dnsscan** takes one or more *INFILE*s in PCAP format and generates a list of
+the number of queries per qtype.
+
+# OPTIONS
+None
+
+# SEE ALSO
+pcap(3PCAP), tcpdump(8)
+
diff --git a/docs/manpages/nsec3dig.1.md b/docs/manpages/nsec3dig.1.md
new file mode 100644 (file)
index 0000000..314c51d
--- /dev/null
@@ -0,0 +1,17 @@
+% NSEC3DIG(1)
+% PowerDNS.com BV
+% April 2015
+
+# NAME
+**nsec3dig** - Show and validate NSEC3 proofs
+
+# SYNOPSIS
+**nsec3dig** *IPADDRESS* *PORT* *QNAME* *QTYPE* [recurse]
+
+# DESCRIPTION
+**nsec3dig** sends a query for *QNAME* and *QTYPE* to the nameserver at *IPADDRESS*
+on port *PORT* and prints whether and why the NSEC3 proofs are correct. Using the
+'recurse' option sets the Recursion Desired (RD) bit in the query.
+
+# EXAMPLE
+`nsec3dig 8.8.8.8 53 doesntexist.isoc.nl TXT recurse`
diff --git a/docs/manpages/saxfr.1.md b/docs/manpages/saxfr.1.md
new file mode 100644 (file)
index 0000000..1be1683
--- /dev/null
@@ -0,0 +1,24 @@
+% SAXFR(1)
+% PowerDNS.com BV
+% April 2015
+
+# NAME
+**saxfr** - Perform AXFRs and show information about it
+
+# SYNOPSIS
+**saxfr** *IPADDRESS* *PORT* *ZONE* [*OPTIONS*]
+
+# DESCRIPTION
+**saxfr** does a zone-transfer (AXFR) of *ZONE* from the nameserver at *IPADDRESS*
+on port *PORT* and displays the transferred zone with NSEC3 information truncated.
+See below how to show this information.
+
+# OPTIONS
+showdetails
+:    Show all the data in the NSEC3 and DNSKEY RDATA.
+
+showflags
+:    Show the NSEC3 flags in the RDATA.
+
+unhash
+:    Unhash the NSEC3 names to the normal names.