freebsd-dev/contrib/bind/INSTALL

$Id: INSTALL,v 8.8 1997/06/01 20:34:25 vixie Exp vixie $

THE FILES:
----------
INSTALL		-- This file
README		-- Release announcements, tips and traps (some out of date)
OPTIONS		-- The options that can be turned on and off
RUNSON		-- What machines/compilers is BIND known to build on
TODO		-- Have spare time?  Consider contributing to the project!
BSD/*           -- How to integrate BIND into a 4.4BSD or 4.4BSD-Lite
contrib/*       -- Useful BIND-related contributions
doc/info/*	-- Platform-dependent build hints
doc/*           -- other RFCs, drafts, papers and

INTRODUCTION:
-------------
BIND used to be extremely difficult to build.  That changed around
version 4.9.3.  These are the instructions on how to compile the
software.  For information on how to create your configuration files
(resolv.conf, named.boot, and zone files) see the doc/bog directory for
the complete "BIND Operations Guide".  You might also consider getting
"DNS and BIND" by C.  Liu and P.  Albitz from O'Reilly & Associates,
Sebastopol, CA, ISBN 0-937175-82-X 1992

Note:	If you maintain a BSD or are otherwise running a 4.4BSD-based system
	and want to integrate BIND into it, check out BSD/README.

BUILDING & INSTALLING:
----------------------
1.  (optional) If you are going to compile for multiple platforms, you
can make a symbolic link tree for each platform to save disk space.  To
create a directory called "sun4.dir", do:
	make DST=sun4.dir links
Now "cd sun4.dir" and you can do everything as if you had a complete
copy of the source.  Just be careful if you are modifying a file, make
sure you turn any links into files:
	mv file file.tmp ; cp file.tmp file ; rm file.tmp

2. (optional) If you have a typical site, you should find yourself only
editing Makefile and conf/options.h.  Make backups of them now:

	mv conf/options.h conf/options.h.dist
	cp conf/options.h.dist conf/options.h
	chmod u+w conf/options.h

	mv Makefile Makefile.dist
	cp Makefile.dist Makefile
	chmod u+w Makefile

3.  Edit "conf/options.h" and turn on any options that you want.  The
defaults are pretty reasonable for most installations.

4.  Edit "Makefile".  The default build parameters are given for 4.4 BSD. 
They should be overridden (not edited!).  Do this by going to the
section that describes your operating system and uncoment the
appropriate lines.  Add any other variables (for example, some people
add "DISTHELP=/usr/local/lib".)  If in doubt, use the default!  Read
the comments carefully!

5.  "make" should build everything.  Consider putting "./bin" in your
path if "make depend" fails and you think bin/mkdep will help you out.

	*** NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE ***

	The next step (#6) will burn down files which were supplied with
	your operating system.  You should run the suggested "-n" first
	and make sure you have saved any files you want to save.

	*** NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE ***

6.  "make install" will install everything.  You might first do
"make -n install" to see what commands would be executed by "make install"
to make sure you understand where everything is about to be installed.

7.  (optional, SunOS 4, SunOS 5, NetBSD-1.x, IRIX, Linix only): You can
integrate the new resolver (client-side) code into the shared libraries
of your operating system so that all dynamicly linked programs take
advantage of the new resolver.  Read shres/<osname>/INSTALL to find out
how to do it.



HOW TO GET HELP:
----------------
The "bind-users@vix.com" mailing list was created especially for people to
talk about and ask questions about installation, maintenance, etc.  It is
highly recommended that you first help yourself by reading the BOG (doc/bog)
or a book on DNS and BIND.

To be added to this mailing list, send mail to <bind-users-request@vix.com>

Note that the bind-users mailing list is also available on Usenet as
	comp.protocols.dns.bind
and that we would all prefer that you read it that way if you possibly can.

This INSTALL was...
	originally written on 15Jul94 by Tom Limoncelli <tal@bell-labs.com>
	changed in minor ways 23Dec95 by Christopher Davis <ckd@kei.com>
	and then changed by Tom Limoncelli again 16Oct96.