|dnscache-conf(8)||System Manager's Manual||dnscache-conf(8)|
dnscache-conf - sets up a DNS cache service.
dnscache-conf acct logacct D [ ip ]
This is a reference page. For tutorial information, see the
home computers (http://cr.yp.to/djbdns/run-cache-home.html),
external caches (http://cr.yp.to/djbdns/run-cache-x.html), or
upgrading from BIND (http://cr.yp.to/djbdns/run-cache-bind-1.html).
dnscache-conf creates a service directory D that runs dnscache(8). The name D must start with a slash and must not contain any special characters. Normally D is /etc/dnscache.
update-service --add D
or by creating a symbolic link in the svscan(8) directory (normally /service or /etc/service), e.g.:
ln -s D /service
The service will start within five seconds, and will be restarted upon reboot. You can use svc(8) to control the service.
dnscache-conf arranges for dnscache(8) to chroot to D/root and to run under the uid and gid of acct. The name acct must not contain any special characters.
dnscache-conf arranges for dnscache(8) to listen for UDP packets and TCP connections on port 53 of ip.
ip is optional; if it is not supplied, dnscache-conf arranges for dnscache(8) to listen on 127.0.0.1.
dnscache-conf creates D/root/ip/127.0.0.1 so that dnscache(8) will accept queries from 127.0.0.1.
dnscache-conf puts 128 bytes of not-particularly-secret data into D/seed and arranges for dnscache(8) to pass D/seed to dns_random_init(3). If your system has a good source of random data, you can replace D/seed with 128 bytes of data from that source.
dnscache-conf creates an automatically rotated log directory in D/log/main. The logs are owned by logacct. The corresponding multilog(8) processes run under the uid and gid of logacct. The name logacct must not contain any special characters.