Imported Debian patch 1:1.05-8
[hcoop/zz_old/debian/djbdns.git] / debian / djbdns-man / rbldns.8
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