Imported Debian patch 1:1.05-8

[hcoop/zz_old/debian/djbdns.git] / debian / djbdns-man / dnsfilter.1

diff --git a/debian/djbdns-man/dnsfilter.1 b/debian/djbdns-man/dnsfilter.1
new file mode 100644 (file)
index 0000000..f3783f5
--- /dev/null
+++ b/debian/djbdns-man/dnsfilter.1
@@ -0,0 +1,67 @@
+.TH dnsfilter 1
+
+.SH NAME
+dnsfilter \- reverse-resolves IP addresses, converting them to host names.
+
+.SH SYNOPSIS
+.B dnsfilter 
+[
+.I opts
+]
+
+.SH DESCRIPTION
+.B dnsfilter
+reads a series of lines from stdin,
+converts an IP address to a host name at the beginning of each line,
+and prints the results to stdout.
+
+If a line does not begin with an IP address,
+.B dnsfilter
+leaves the line alone.
+If an IP address does not have a host name listed in DNS,
+.B dnsfilter
+leaves the line alone.
+If an IP address has a host name listed in DNS,
+.B dnsfilter
+inserts an equals sign and the host name
+before the first space or tab in the line.
+If a DNS lookup fails temporarily,
+.B dnsfilter
+inserts a colon and a dash-separated error message
+before the first space or tab in the line.
+
+While 
+.B dnsfilter
+is looking up an address in DNS,
+it reads ahead in the input and looks for more addresses to look up in parallel.
+
+.SH OPTIONS
+ 
+.I opts
+is a series of getopt-style options:
+
+.TP
+.B \-c \fIn
+Do at most 
+.I n
+DNS queries in parallel.
+Default: 10.
+
+.TP
+.B -l \fIn
+Read ahead at most 
+.I n
+lines.
+Default: 1000.
+
+.SH SEE ALSO
+dnsip(1),
+dnsipq(1),
+dnsname(1),
+dnsmx(1),
+dnstxt(1),
+dnsqr(1),
+dnsq(1),
+dnstrace(1)
+
+http://cr.yp.to/djbdns.html