building(dnsutl)					      building(dnsutl)



NAME
	dnsutl - utilities to make DNS easier to configure

SPACE REQUIREMENTS
	You will need about 7MB	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 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.

   BEFORE YOU START
	It is assumed that you have GNU	Groff 1.14 (or later) installed.  This
	is used	to format the documentation, so	if you don't care about	this,
	don't worry.  You can get GNU Groff from any of	the GNU	mirrors	around
	the world.

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.

	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 1.14 or later,
	which understands for -I include search	directory command line
	options.

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 become	root
	and use	the
		# make install
		...lots	of output...
		#
	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.8.D001
		...warranty disclaimer...
		%
	command.  Please do not	send this example; run the program for the
	exact version number.

COPYRIGHT
	dnsutl version 1.8
	Copyright (C) 1990, 1991, 1992,	1993, 1994, 1995, 1996,	1999, 2000,
	2001, 2003, 2004, 2005,	2006 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/



							      building(dnsutl)
