From 78ff4843bd15d5d4cebbf5289e7ca91bcdca8001 Mon Sep 17 00:00:00 2001 From: B Stack Date: Sat, 14 Oct 2017 15:38:29 -0400 Subject: arrange directory structure to current standards --- usr/share/doc/ddtools/README.txt | 51 +++++++++++++++++++++++++++++++++++++++ usr/share/doc/ddtools/version.txt | 1 + 2 files changed, 52 insertions(+) create mode 100644 usr/share/doc/ddtools/README.txt create mode 100644 usr/share/doc/ddtools/version.txt (limited to 'usr/share/doc') diff --git a/usr/share/doc/ddtools/README.txt b/usr/share/doc/ddtools/README.txt new file mode 100644 index 0000000..2dcb55c --- /dev/null +++ b/usr/share/doc/ddtools/README.txt @@ -0,0 +1,51 @@ +File: usr/share/ddtools/docs/README.txt +Package: ddtools +Author: bgstack15 +Startdate: 2017-05-26 +Title: Readme file for ddtools +Purpose: All packages should come with a readme +Usage: Read it. +Reference: README.txt +Improve: +Document: Below this line + +### WELCOME +ddtools is a suite of shell scripts that help manage dns and dhcpd. +Updatezone provides an easy way to update dns zone files. Intended primarily for bind9 zone files, experimentation is encouraged. +Instead of running the series of commands manually: rndc freeze, vi zonefile, rndc thaw and so on, use updatezone. +dhcpd-control helps manage paired dhcpd servers. + +### CONFIGURATION +The conf files belong in /etc/ddtools/. See example in /usr/share/ddtools/examples/. + +### USING THIS TOOL + +$ updatezone ipa.smith122.com +Where this file exists: /etc/ddtools/ipa.smith122.com.conf + + UZ_ZONE_NAME=ipa.smith122.com + UZ_FORWARD_ZONE=ipa.smith122.com + UZ_FORWARD_FILE=/var/named/data/db.ipa.smith122.com + UZ_REVERSE_ZONE=1.168.192.in-addr.arpa + UZ_REVERSE_FILE=/var/named/data/db.192.168.1 + UZ_SLAVE_COUNT=1 + UZ_SLAVE_1=dns2 + +The updatezone tool searches for the value of UZ_ZONE_NAME to declare a match and use that configuration file. +The zone definitions are used in the freeze/thaw/retransfer commands. + +This tool will only request updates for zones that are updated. Also, you do not need to adjust the serial number at all. The script will detect changes and then increment the serial number for you. + +You can also specify multiple zones on the command line. +$ updatezone ipa.smith122.com ad.smith122.com + +### NOTES + +### REFERENCE + +### CHANGELOG +2017-05-27 B Stack 0.0-2 +- Initial package construction + +2017-10-14 B Stack 0.0-3 +- Rearranged directory structure to match current standards diff --git a/usr/share/doc/ddtools/version.txt b/usr/share/doc/ddtools/version.txt new file mode 100644 index 0000000..eb8d937 --- /dev/null +++ b/usr/share/doc/ddtools/version.txt @@ -0,0 +1 @@ +0.0-3 -- cgit