


building(dnsutl)				 building(dnsutl)


NAME
	dnsutl - utilities to make DNS easier to configure

SPACE REQUIREMENTS
	You will need about 1MB	to unpack and build the	dnsutl
	package.  Your milage may vary.

SITE CONFIGURATION
	The dnsutl package is configured using the configure
	program	included in this distribution.

	The configure shell script attempts to guess correct
	values for various system-dependent variables used during
	compilation, and creates the Makefile and common/config.h
	files.	It also	creates	a shell	script config.status that
	you can	run in the future to recreate the current
	configuration.

	Normally, you just cd to the directory containing
	dnsutl's source	code and type
		% ./configure
		...lots	of output...
		%
	If you're using	csh on an old version of System	V, you
	might need to type
		% sh configure
		...lots	of output...
		%
	instead	to prevent csh from trying to execute configure
	itself.

	Running	configure takes	a minute or two.  While	it is
	running, it prints some	messages that tell what	it is
	doing.	If you don't want to see the messages, run
	configure with the --quiet option; for example,
		% ./configure --quiet
		%

	To compile the dnsutl package in a different directory
	from the one containing	the source code, you must use a
	version	of make	that supports the VPATH	variable, such as
	GNU make.  cd to the directory where you want the object
	files and executables to go and	run the	configure script.
	configure automatically	checks for the source code in the
	directory that configure is in and in ..  (the parent
	directory).  If	for some reason	configure is not in the
	source code directory that you are configuring,	then it
	will report that it can't find the source code.	 In that
	case, run configure with the option --srcdir=DIR, where
	DIR is the directory that contains the source code.

	By default, configure will arrange for the make	install
	command	to install the dnsutl package's	files in
	/usr/local/bin,	/usr/local/man,	etc.  You can specify an



								1





building(dnsutl)				 building(dnsutl)


	installation prefix other than /usr/local by giving
	configure the option --prefix=PATH.

	You can	specify	separate installation prefixes for
	architecture-specific files and	architecture-independent
	files.	If you give configure the option --exec-
	prefix=PATH the	dnsutl package will use	PATH as	the
	prefix for installing programs and libraries.  Data files
	and documentation will still use the regular prefix.
	Normally, all files are	installed using	the same prefix.

	configure ignores any other arguments that you give it.

	On systems that	require	unusual	options	for compilation
	or linking that	the dnsutl package's configure script
	does not know about, you can give configure initial
	values for variables by	setting	them in	the environment.
	In Bourne-compatible shells, you can do	that on	the
	command	line like this:
		$ CC='gcc -traditional'	LIBS=-lposix ./configure
		...lots	of output...
		$
	Here are the make variables that you might want	to
	override with environment variables when running
	configure.

	Variable: CC
		C compiler program.  The default is cc.

	Variable: LIBS
		Libraries to link with,	in the form -lfoo -lbar.
		The configure script will append to this, rather
		than replace it.

	If you need to do unusual things to compile the	package,
	the author encourages you to figure out	how configure
	could check whether to do them,	and mail diffs or
	instructions to	the author so that they	can be included
	in the next release.

BUILDING DNSUTL
	All you	should need to do is use the
		% make
		...lots	of output...
		%
	command	and wait.  When	this finishes you should see a
	directory called bin containing	several	files including:
	dns-hosts, dns-ng, and dns-rev.









								2





building(dnsutl)				 building(dnsutl)


	You can	remove the program binaries and	object files from
	the source directory by	using the
		% make clean
		...lots	of output...
		%
	command.  To remove all	of the above files, and	also
	remove the Makefile and	common/config.h	and config.status
	files, use the
		% make distclean
		...lots	of output...
		%
	command.

	The file aux/configure.in is used to create configure by
	a GNU program called autoconf.	You only need to know
	this if	you want to regenerate configure using a newer
	version	of autoconf.

   Things That Can Go Wrong
	The configure script looks for a program called
	``soelim'', which is used to remove include directives
	from (n)roff input.  It	uses it	when constructing the
	files to install for the man(1)	pages.	The rather bold
	assumption is made that	you are	using GNU Groff, with the
	patch for -I include search directory command line
	options.  The patch may	be obtained from
	http://www.canb.auug.org.au/~millerp/groff-1.11a.patch

TESTING	DNSUTL
	The dnsutl package comes with a	test suite.  To	run this
	test suite, use	the command
		% make sure
		...lots	of output...
		Passed All Tests
		%

	The tests take a few seconds each, with	a few very fast,
	and a couple very slow,	but it varies greatly depending
	on your	CPU.

	If all went well, the message
		Passed All Tests
	should appear at the end of the	make.

INSTALLING DNSUTL
	As explained in	the SITE CONFIGURATION section,	above,
	the dnsutl package is installed	under the /usr/local tree
	by default.  Use the --prefix=PATH option to configure if
	you want some other path.

	All that is required to	install	the dnsutl package is to
	use the
		% make install
		...lots	of output...



								3





building(dnsutl)				 building(dnsutl)


		%
	command.  Control of the directories used may be found in
	the first few lines of the Makefile file if you	want to
	bypass the configure script.

GETTING	HELP
	If you need assistance with the	dnsutl program,	please do
	not hesitate to	contact	the author at
		Peter Miller <millerp@canb.auug.org.au>
	Any and	all feedback is	welcome.

	When reporting problems, please	include	the version
	number given by	the
		% dns-hosts -version
		dns-hosts version 1.6.D001
		...warranty disclaimer...
		%
	command.  Please do not	send this example; run the
	program	for the	exact version number.

COPYRIGHT
	dnsutl version 1.6
	Copyright (C) 1990, 1991, 1992,	1993, 1994, 1995, 1996,
	1999, 2000 Peter Miller; All rights reserved.

	The dnsutl package is distributed in the hope that it
	will be	useful,	but WITHOUT ANY	WARRANTY; without even
	the implied warranty of	MERCHANTABILITY	or FITNESS FOR A
	PARTICULAR PURPOSE.  See the GNU General Public	License
	for more details.

	It should be in	the LICENSE file included with this
	distribution.

AUTHOR
	Peter Miller   E-Mail:	 millerp@canb.auug.org.au
	/\/\*		  Web:	 http://www.canb.auug.org.au/~millerp/




















								4


