| 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 |