Commit | Line | Data |
---|---|---|
b4588d5c GP |
1 | .TH rbldns-conf 8 |
2 | ||
3 | .SH NAME | |
4 | rbldns-conf \- sets up an IP-address-listing DNS service. | |
5 | ||
6 | .SH SYNOPSIS | |
7 | .B rbldns-conf | |
8 | .I acct | |
9 | .I logacct | |
10 | .I D | |
11 | .I ip | |
12 | .I base | |
13 | ||
14 | .SH DESCRIPTION | |
15 | .B rbldns-conf | |
16 | creates a service directory | |
17 | .I D | |
18 | that runs | |
19 | .BR rbldns (8). | |
20 | The name | |
21 | .I D | |
22 | must start with a slash | |
23 | and must not contain any special characters. | |
24 | Normally | |
25 | .I D | |
26 | is | |
27 | .IR /etc/rbldns . | |
28 | ||
29 | You can run the service under | |
30 | .BR svscan (8) | |
31 | by using the | |
32 | .BR update-service (8) | |
33 | program on Debian GNU/Linux | |
34 | ||
35 | update-service --add | |
36 | .I D | |
37 | ||
38 | or by creating a symbolic link in the | |
39 | .BR svscan (8) | |
40 | directory (normally /service or /etc/service), e.g.: | |
41 | ||
42 | ln -s | |
43 | .I D | |
44 | /service | |
45 | ||
46 | The service will start within five seconds, | |
47 | and will be restarted upon reboot. | |
48 | You can use | |
49 | .BR svc (8) | |
50 | to control the service. | |
51 | ||
52 | .B rbldns-conf | |
53 | arranges for | |
54 | .BR rbldns (8) | |
55 | to chroot to | |
56 | .IR D /root | |
57 | and to run under the uid and gid of | |
58 | .IR acct . | |
59 | The name | |
60 | .I acct | |
61 | must not contain any special characters. | |
62 | ||
63 | .B rbldns-conf | |
64 | creates | |
65 | .IR D /root/Makefile | |
66 | to run | |
67 | .BR rbldns-data (8) | |
68 | upon request. | |
69 | ||
70 | .B rbldns-conf | |
71 | arranges for | |
72 | .BR rbldns (8) | |
73 | to listen for UDP packets on port 53 of | |
74 | .IR ip , | |
75 | and to send outgoing packets from | |
76 | .IR ip . | |
77 | ||
78 | .B rbldns-conf | |
79 | arranges for | |
80 | .BR rbldns (8) | |
81 | to answer queries under the | |
82 | .I base | |
83 | domain. | |
84 | The name | |
85 | .I base | |
86 | must not contain any special characters. | |
87 | ||
88 | .B rbldns-conf | |
89 | creates an automatically rotated log directory in | |
90 | .IR D /log/main. | |
91 | The logs are owned by | |
92 | .IR logacct . | |
93 | The corresponding | |
94 | .BR multilog (8) | |
95 | processes run under the uid and gid of | |
96 | .IR logacct . | |
97 | The name | |
98 | .I logacct | |
99 | must not contain any special characters. | |
100 | ||
101 | .SH SEE ALSO | |
102 | rbldns(8), | |
103 | rbldns-data(8) | |
104 | svscan(8), | |
105 | svc(8), | |
106 | multilog(8), | |
107 | axfrdns-conf(8), | |
108 | dnscache-conf(8), | |
109 | tinydns-conf(8), | |
110 | walldns-conf(8), | |
111 | update-service(8) | |
112 | ||
113 | http://cr.yp.to/djbdns.html |