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