From dccdd5902963757aa1101b93fc3697d7a8f3b16e Mon Sep 17 00:00:00 2001 From: CSRG Date: Mon, 31 Aug 1992 03:04:26 -0800 Subject: [PATCH] BSD 4_4_Lite2 development Work on file usr/src/contrib/bind-4.9.2/contrib/tic/README Synthesized-from: CSRG/cd3/4.4BSD-Lite2 --- usr/src/contrib/bind-4.9.2/contrib/tic/README | 83 +++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 usr/src/contrib/bind-4.9.2/contrib/tic/README diff --git a/usr/src/contrib/bind-4.9.2/contrib/tic/README b/usr/src/contrib/bind-4.9.2/contrib/tic/README new file mode 100644 index 0000000000..2f8ca5780c --- /dev/null +++ b/usr/src/contrib/bind-4.9.2/contrib/tic/README @@ -0,0 +1,83 @@ +# Copyright (c) 1992 by Texas Internet Consulting +# This code may be freely copied and used so long as this +# copyright notice is attached. This code may not be sold +# without the express written permission of Texas Internet Consulting. +# Texas Internet Consulting makes no warranty as to the correctness +# nor the applicability of this code for any purpose. + +Generic host configuration files. + +This is a brief overview of a set of utilities used to manage +host files when running DNS or NIS nameservice or both. + +File description: + +README - this file +etc.named - files installed in /etc/named +gendns - shell script to generate DNS tables +genstatic - shell script to generate static host file +make_rev - automatically creates the reverse DNS map +poke_ns.c - C program to help manage DNS servers +readinfo - shell script to extract fields from hst files +updatehosts - shell scrip to automate host update + +This host database system organizes host information in a set of +flat tables. All host updates are made in these tables. From these +tables both the static host table and the DNS database files are created. +This eliminates potential errors caused by having to maintain two sets of +host tables. + +The static host table is used to update NIS maps, if you run NIS. It can +also be used on machines which may not have DNS or NIS support. + +Install the scripts in /usr/local/etc. Compile and install poke_ns in +/usr/local/etc making it setuid to root, but only executable by the group +of users which will be maintainingg the host database. Do not make it +executable by everyone. Check the define NAMED and be sure it points to +the pathname for your nameserver. + +The next step is to install the files in etc.named in the /etc/named +directory or the directory where the DNS database files will be maintained. + +Now populate the host database files. These files are organized like a +relational database and consist of several files. They are all under SCCS +control and must be checked out to be populated. Be sure and check the +files back in under SCCS before continuing. + +hosts.main - the main host file. Required fields are the host and IP +address field. Note the #FIELDS line. This describes the fields to the +readinfo script which extracts particular fields from the host.* files. +Each field is described by its fieldname, followed by an optional prefix=, +suffix=, or no= descriptor. The prefix= and suffix= describe what will be +prepended or appended to the field value when readinfo outputs the field. +For host names the suffix is equal to the default domain. For host +addresses the prefix is equal to the network number. This facility is a +useful shorthand. The no= field gives a character which says to display +the host value as given and ignore any prefix or suffix. For example if +your default domain is tic.com and you have a host named tic.com enter it +in the file as @tic.com@. + +hosts.cname - host alias file. This has two fields the real host name +followed an alias for the host. If a host has more than a single alias, +renteer the host name followed by the second alias. + +hosts.mx - DNS MX information is entered here. This file has three fields: +the domain name to MX for, the priority of the MX record and the host to +forward mail to for this domain. + +The other hosts.* and remaining files are helper files +for creating the static host tables and DNS files. No data needs to be entered into them. + +Create a file in nisservers of the host names for NIS servers for doing +host lookups. If you have no NIS servers performing this function do not +create this file. + +Run the command updatehosts -u. This will generate the DNS tables and +start the DNS server or cause the currently running server to reload its +data files. If you are replacing an existing DNS server it is best to +bring it down first before typing this command. When you update the host +files in the future, type updatehosts followed by the names of the files +which need to be updated. e.g. updatehosts hosts.main. This can be done in +any directory. Updatehosts knows how to find the files. The -u option is +used when you want to update the server without modifying any files or you +modified the files by manually running SCCS. -- 2.20.1