From: Pieter Lexis Date: Tue, 22 Jul 2014 09:10:15 +0000 (+0200) Subject: Fix xmlto warning (Closes #1596) X-Git-Tag: auth-3.4.0-rc1~44^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F1597%2Fhead;p=thirdparty%2Fpdns.git Fix xmlto warning (Closes #1596) This also dos2unix'es dnstcpbench.1.txt and fixes the manpage so it only contains a single AUTHOR section --- diff --git a/pdns/docs/dnstcpbench.1.txt b/pdns/docs/dnstcpbench.1.txt index 4393a8f072..c966d46212 100644 --- a/pdns/docs/dnstcpbench.1.txt +++ b/pdns/docs/dnstcpbench.1.txt @@ -1,6 +1,5 @@ -DNSTCPBENCH(1) +DNSTCPBENCH(1) ============== -bert hubert NAME ---- @@ -9,69 +8,69 @@ dnstcpbench - tool to perform TCP benchmarking of nameservers SYNOPSIS -------- 'dnstcpbench' [--help] [--file=filename] [--verbose] [--udp-first, -u] [--workers] [--timeout-msec] remote-ip-address [remote-port] - + DESCRIPTION ----------- -dnstcpbench reads DNS queries (by default from standard input) and sends -them out in parallel to a remote nameserver. By default TCP/IP is used, but -optionally, UDP is tried first, which allows for the benchmarking of TCP/IP -fallback. - -The input format is one query per line: qname single-space qtype. An -example: - www.powerdns.com ANY - powerdns.com MX - -When benchmarking extended runs, it may be necessary to enable TIME_WAIT -recycling, as TCP/IP port tuples may otherwise run out. On Linux this is -performed by running: - - # echo 1 > /proc/sys/net/ipv4/tcp_tw_recycle - -The equivalent for IPv6 is not known. - - +dnstcpbench reads DNS queries (by default from standard input) and sends +them out in parallel to a remote nameserver. By default TCP/IP is used, but +optionally, UDP is tried first, which allows for the benchmarking of TCP/IP +fallback. + +The input format is one query per line: qname single-space qtype. An +example: + www.powerdns.com ANY + powerdns.com MX + +When benchmarking extended runs, it may be necessary to enable TIME_WAIT +recycling, as TCP/IP port tuples may otherwise run out. On Linux this is +performed by running: + + # echo 1 > /proc/sys/net/ipv4/tcp_tw_recycle + +The equivalent for IPv6 is not known. + + OPTIONS ------- - --f,--file:: - Filename from which to read queries. Defaults to standard input if - unspecified. - --h,--help:: - Provide a helpful message - ---timeout-msec:: + +-f,--file:: + Filename from which to read queries. Defaults to standard input if + unspecified. + +-h,--help:: + Provide a helpful message + +--timeout-msec:: Number of milliseconds to wait for an answer --udp-first, -u:: - Attempt resolution via UDP first, only do TCP if truncated answer is + Attempt resolution via UDP first, only do TCP if truncated answer is received - + -v,--verbose:: Be wordy on what the program is doing - ---workers:: - Number of parallel worker threads to use. - - -Remote IP address can be IPv4 or IPv6. Remote port defaults to 53. - -STATISTICAL OUTPUT ------------------- -The program reports both mean and median numbers for queries per second and -UDP and TCP latency. Each query only counts once, even if it is tried over -UDP first. This effectively means that passing '-u' can lower query rates if -many queries get shunted to TCP. - + +--workers:: + Number of parallel worker threads to use. + + +Remote IP address can be IPv4 or IPv6. Remote port defaults to 53. + +STATISTICAL OUTPUT +------------------ +The program reports both mean and median numbers for queries per second and +UDP and TCP latency. Each query only counts once, even if it is tried over +UDP first. This effectively means that passing '-u' can lower query rates if +many queries get shunted to TCP. + BUGS ---- -Currently the timeout code does not actually perform non-blocking connects -or writes. So a slow connect or slow writes will still cause low -performance and delays. - -Median queries per second statistics are reported as 0 for sub-second runs. - +Currently the timeout code does not actually perform non-blocking connects +or writes. So a slow connect or slow writes will still cause low +performance and delays. + +Median queries per second statistics are reported as 0 for sub-second runs. + AUTHOR ------ Written by PowerDNS.COM BV, bert hubert,