Provided by: djbdns_1.05-8ubuntu1_i386 bug

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)