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

.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
Commit	Line	Data
b4588d5c GP	1	.TH dnsfilter 1
	2
	3	.SH NAME
	4	dnsfilter \- reverse-resolves IP addresses, converting them to host names.
	5
	6	.SH SYNOPSIS
	7	.B dnsfilter
	8	[
	9	.I opts
	10	]
	11
	12	.SH DESCRIPTION
	13	.B dnsfilter
	14	reads a series of lines from stdin,
	15	converts an IP address to a host name at the beginning of each line,
	16	and prints the results to stdout.
	17
	18	If a line does not begin with an IP address,
	19	.B dnsfilter
	20	leaves the line alone.
	21	If an IP address does not have a host name listed in DNS,
	22	.B dnsfilter
	23	leaves the line alone.
	24	If an IP address has a host name listed in DNS,
	25	.B dnsfilter
	26	inserts an equals sign and the host name
	27	before the first space or tab in the line.
	28	If a DNS lookup fails temporarily,
	29	.B dnsfilter
	30	inserts a colon and a dash-separated error message
	31	before the first space or tab in the line.
	32
	33	While
	34	.B dnsfilter
	35	is looking up an address in DNS,
	36	it reads ahead in the input and looks for more addresses to look up in parallel.
	37
	38	.SH OPTIONS
	39
	40	.I opts
	41	is a series of getopt-style options:
	42
	43	.TP
	44	.B \-c \fIn
	45	Do at most
	46	.I n
	47	DNS queries in parallel.
	48	Default: 10.
	49
	50	.TP
	51	.B -l \fIn
	52	Read ahead at most
	53	.I n
	54	lines.
	55	Default: 1000.
	56
	57	.SH SEE ALSO
	58	dnsip(1),
	59	dnsipq(1),
	60	dnsname(1),
	61	dnsmx(1),
	62	dnstxt(1),
	63	dnsqr(1),
	64	dnsq(1),
65	dnstrace(1)
66
67	http://cr.yp.to/djbdns.html