NAME

       dnscache-conf - sets up a DNS cache service.

SYNOPSIS

       dnscache-conf acct logacct D [ ip ]

DESCRIPTION

       This is a reference page.  For tutorial information, see the instructions for
       workstations (http://cr.yp.to/djbdns/run-cache.html),
       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.

       You can run the service under svscan(8) by using the update-service(8) program  on  Debian
       GNU/Linux

       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.

SEE ALSO

       dnscache(8),  svscan(8),  svc(8),  multilog(8),  axfrdns-conf(8), rbldns-conf(8), tinydns-
       conf(8), walldns-conf(8), update-service(8)

       http://cr.yp.to/djbdns.html

                                                                                 dnscache-conf(8)