xref: /netbsd-src/external/bsd/nsd/dist/contrib/README (revision 811a4a0195236f69295602fbee687a174d42af9b)
1This is NSD contributions directory and it contains various additions
2to NSD that are not a part of the official distribution but may be
3helpful.
4
5USE 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