Home | History | Annotate | Line # | Download | only in contrib 
      1 This is NSD contributions directory and it contains various additions
      2 to NSD that are not a part of the official distribution but may be
      3 helpful.
      4 
      5 USE AT YOUR OWN RISK.
      6 
      7 * nsd.spec: a rpm specfile to generate binary and source rpms. 
      8   Put the source tarball in  /usr/src/redhat/SOURCES. Then 
      9   	rpmbuild -ba nsd.spec
     10 
     11 * nsd.init: a shell script that can start, stop, restart the NSD daemon.
     12   It uses signals, and can be used in rc.d init scripts (depends on platform).
     13 
     14 * nsd.zones2nsd.conf: a python script to convert NSD 2 nsd.zones config files
     15   to NSD 3 nsd.conf config files. Do not forget to set nsd_zones_name and
     16   key_dir variables at the top of the script. 
     17 
     18 * bind2nsd: a slightly abridged form is included; find the full source
     19   at http://bind2nsd.sourceforge.net.  The bind2nsd scripts translate 
     20   DNS information in BIND format to NSD format, and then copy that 
     21   translation to an NSD server. The goal is to make it simple to run
     22   redundant BIND and NSD servers and keep them in sync, using only the
     23   BIND configuration files
     24 
     25 * nsd_munin_ : plugin for munin statistics report
     26   You must have given --enable-bind8-stats (default is on) to configure.
     27   Copy the file to /usr/share/munin/plugins (or you munin node dir).
     28   You may also need to create a number of symbolic links under the names
     29   of the graphs you want to create (documented at head of file).
     30 
     31 * nsd.service : example systemd service script for NSD.
     32 
     33 * patch_for_s6_startup_and_other_service_supervisors.diff : patch to
     34   use -r option for nsd to signal readiness with READY_FD, from Cameron Nemo.
     35   Apply with patch -p0 < contrib/patch_for_s6_startup_and_other_service_supervisors.diff
     36 
     37 * autocomplete_nsd-control.bash : It completes options, all commands and zone
     38   arguments for commands. From Christian Weiske. To use it, call:
     39   source contrib/autocomplete_nsd-control.bash
     40 
     41 * bug390.patch:
     42   Patch that returns a superfluous NSEC3 RR on wildcard queries
     43 
     44   This patch exists because there is a bug in the Bind9 resolver, before
     45   version 9.9.0. Bind9 before that version can not validate NSEC3 wildcard
     46   answer responses, it needs a superfluous NSEC3 RR. This patch will make
     47   NSD provide that NSEC3 RR.
     48 
     49   The patch was useful before there was a fix for the BIND resolver, to
     50   work around the issue. It is no longer useful after BIND got fixed in
     51   version 9.9.0 around 2013-05-16.
     52 
     53 * contrib/nsd-tmpfiles.conf.in, contrib/nsd.openrc.conf, contrib/nsd.openrc.in:
     54   An OpenRC service script and config file.
     55 
     56   The service script is integrated with the build system so that the
     57   correct paths are obtained from ./configure and do not need to be
     58   hard-coded.
     59 
     60   The nsd-tmpfiles.conf file is for both systemd and OpenRC. If installed,
     61   this will create at a boot a temporary "nsd" directory writable by the
     62   nsd user. This makes it easier to use a local control socket because
     63   the user no longer has to worry about creating the directory where
     64   the socket will live.
     65