[hcoop/zz_old/debian/djbdns.git] / debian / djbdns-man / rbldns.8

.TH rbldns 8

.SH NAME
rbldns \- an IP-address-listing DNS server

.SH DESCRIPTION
.B rbldns
is an IP-address-listing DNS server.
It accepts iterative DNS queries
from hosts around the Internet asking about various IP addresses.
It provides responses showing whether the addresses
are on a locally configured list,
such as RBL or DUL.

.SH Configuration
Normally 
.B rbldns
is set up by the
.BR rbldns-conf (8)
program.

.B rbldns
runs chrooted in the directory
specified by the 
.I $ROOT
environment variable,
under the uid and gid
specified by the 
.I $UID
and 
.I $GID
environment variables.

.B rbldns
listens for incoming UDP packets
addressed to port 53 of 
.IR $IP .
It does not listen for TCP queries.

.B rbldns
handles domains of the form
.IR d.c.b.a\fR.\fIbase
where 
.I a.b.c.d
is the IP address in question
and 
.I base
is given by the 
.I $BASE
environment variable.

.B rbldns
rejects
inverse queries, non-Internet-class queries, truncated packets,
packets that contain anything other than a single query,
query types other than A, TXT, or *,
and queries for domains outside 
.IR $BASE .
It looks up other queries inside 
.IR data.cdb ,
a binary file created by
.BR rbldns-data (8).

.SH SEE ALSO
rbldns-conf(8),
rbldns-data(8)

http://cr.yp.to/djbdns.html
Commit	Line	Data
b4588d5c GP	1	.TH rbldns 8
	2
	3	.SH NAME
	4	rbldns \- an IP-address-listing DNS server
	5
	6	.SH DESCRIPTION
	7	.B rbldns
	8	is an IP-address-listing DNS server.
	9	It accepts iterative DNS queries
	10	from hosts around the Internet asking about various IP addresses.
	11	It provides responses showing whether the addresses
	12	are on a locally configured list,
	13	such as RBL or DUL.
	14
	15	.SH Configuration
	16	Normally
	17	.B rbldns
	18	is set up by the
	19	.BR rbldns-conf (8)
	20	program.
	21
	22	.B rbldns
	23	runs chrooted in the directory
	24	specified by the
	25	.I $ROOT
	26	environment variable,
	27	under the uid and gid
	28	specified by the
	29	.I $UID
	30	and
	31	.I $GID
	32	environment variables.
	33
	34	.B rbldns
	35	listens for incoming UDP packets
	36	addressed to port 53 of
	37	.IR $IP .
	38	It does not listen for TCP queries.
	39
	40	.B rbldns
	41	handles domains of the form
	42	.IR d.c.b.a\fR.\fIbase
	43	where
	44	.I a.b.c.d
	45	is the IP address in question
	46	and
	47	.I base
	48	is given by the
	49	.I $BASE
	50	environment variable.
	51
	52	.B rbldns
	53	rejects
	54	inverse queries, non-Internet-class queries, truncated packets,
	55	packets that contain anything other than a single query,
	56	query types other than A, TXT, or *,
	57	and queries for domains outside
	58	.IR $BASE .
	59	It looks up other queries inside
	60	.IR data.cdb ,
	61	a binary file created by
	62	.BR rbldns-data (8).
	63
	64	.SH SEE ALSO
65	rbldns-conf(8),
66	rbldns-data(8)
67
68	http://cr.yp.to/djbdns.html