README revision 2ecf7f63a01ca8a96d76f7d2d4de0fa37f3e3fab
a48fa4b49c58246b297e0fd38e5fb85b985379f1Bob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob HalleyBIND 9
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
b90dd6c0a9df584619d3c47be7c9417f55d5ccf6Bob Halley BIND version 9 is a major rewrite of nearly all aspects of the
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson underlying BIND architecture. Some of the important features of
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson BIND 9 are:
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson - DNS Security
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson DNSSEC (signed zones)
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson TSIG (signed DNS requests)
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson - IP version 6
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Answers DNS queries on IPv6 sockets
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson IPv6 resource records (A6, DNAME, etc.)
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Bitstring Labels
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Experimental IPv6 Resolver Library
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson - DNS Protocol Enhancements
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson IXFR, DDNS, Notify, EDNS0
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Improved standards conformance
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson - Views
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson One server process can provide multiple "views" of
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson the DNS namespace, e.g. an "inside" view to certain
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson clients, and an "outside" view to others.
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson - Multiprocessor Support
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson - Improved Portability Architecture
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
b90dd6c0a9df584619d3c47be7c9417f55d5ccf6Bob Halley
b90dd6c0a9df584619d3c47be7c9417f55d5ccf6Bob Halley BIND version 9 development has been underwritten by the following
b90dd6c0a9df584619d3c47be7c9417f55d5ccf6Bob Halley organizations:
b90dd6c0a9df584619d3c47be7c9417f55d5ccf6Bob Halley
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Sun Microsystems, Inc.
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Hewlett Packard
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Compaq Computer Corporation
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson IBM
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Process Software Corporation
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Silicon Graphics, Inc.
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson Network Associates, Inc.
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson U.S. Defense Information Systems Agency
70680fa51b0147c726b939b72b2420249429756aBob Halley USENIX Association
70680fa51b0147c726b939b72b2420249429756aBob Halley Stichting NLnet - NLnet Foundation
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
16803617e47c83272013e45ba8eb83a3b11983edAndreas Gustafsson
e5256e34b4a26a26088b2dc5ca621b42c0750256Andreas GustafssonBIND 9.1.0a1
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
e5256e34b4a26a26088b2dc5ca621b42c0750256Andreas Gustafsson This is an unreleased alpha version of BIND 9.1.0.
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
e5256e34b4a26a26088b2dc5ca621b42c0750256Andreas Gustafsson For a detailed list of user-visible changes from
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence previous releases, see the CHANGES file.
b90dd6c0a9df584619d3c47be7c9417f55d5ccf6Bob Halley
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob HalleyBuilding
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
8db66dc4eb654a2e295eaeab3aaf96e24c9ae7b7Bob Halley BIND 9 currently requires a UNIX system with an ANSI C compiler,
8db66dc4eb654a2e295eaeab3aaf96e24c9ae7b7Bob Halley basic POSIX support, and a good pthreads implementation.
8db66dc4eb654a2e295eaeab3aaf96e24c9ae7b7Bob Halley
501da430e2f16f496f8e8d1b57ab77f78428c682David Lawrence We've had successful builds and tests on the following systems:
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley AIX 4.3
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley COMPAQ Tru64 UNIX 4.0D
e5256e34b4a26a26088b2dc5ca621b42c0750256Andreas Gustafsson COMPAQ Tru64 UNIX 5 (with IPv6 EAK)
2ecf7f63a01ca8a96d76f7d2d4de0fa37f3e3fabOlafur Gudmundsson FreeBSD 3.4-STABLE, 3.5, 4.0, 4.1
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley HP-UX 11
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley IRIX64 6.5
d80ccd47ad4b526f82590b6c182b4dd80006712eAndreas Gustafsson NetBSD-current (with unproven-pthreads-0.17)
a81d239754610b4e50892149bf8a570b257f6555Bob Halley Red Hat Linux 6.0, 6.1, 6.2
997e3113b7c91ec94e6274d31735f122e6e8209cAndreas Gustafsson Solaris 2.6, 7, 8
d80ccd47ad4b526f82590b6c182b4dd80006712eAndreas Gustafsson
a0cad57966364095e4367f568389a8bd84afb2afAndreas Gustafsson Additionally, we have unverified reports of success from users
a0cad57966364095e4367f568389a8bd84afb2afAndreas Gustafsson of the following systems:
a0cad57966364095e4367f568389a8bd84afb2afAndreas Gustafsson
a0cad57966364095e4367f568389a8bd84afb2afAndreas Gustafsson Slackware Linux 7.0 with 2.4.0-test6 kernel and glibc 2.1.3
a0cad57966364095e4367f568389a8bd84afb2afAndreas Gustafsson
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley To build, just
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley ./configure
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley make
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence Several environment variables that can be set before running
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence configure will affect compilation:
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence CC
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence The C compiler to use. configure tries to figure
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence out the right one for supported systems.
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence CFLAGS
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence C compiler flags. Defaults to include -g and/or -O2
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence as supported by the compiler.
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence STD_CINCLUDES
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence System header file directories. Can be used to specify
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence where add-on thread or IPv6 support is, for example.
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence Defaults to empty string.
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence STD_CDEFINES
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence Any additional preprocessor symbols you want defined.
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence Defaults to empty string.
b70fc17acec2c036bb35a937ba00fbcf10848859David Lawrence
69930116e30137705d3b87d05cbfbc5712386fdeAndreas Gustafsson To build shared libraries, specify "--with-libtool" on the
69930116e30137705d3b87d05cbfbc5712386fdeAndreas Gustafsson configure command line.
69930116e30137705d3b87d05cbfbc5712386fdeAndreas Gustafsson
e21262ae8af5d12f64a2242e26338f36901ba4ccAndreas Gustafsson If your operating system has integrated support for IPv6, it
e21262ae8af5d12f64a2242e26338f36901ba4ccAndreas Gustafsson will be used automatically. If you have installed KAME IPv6
e21262ae8af5d12f64a2242e26338f36901ba4ccAndreas Gustafsson separately, use "--with-kame[=PATH]" to specify its location.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence
69930116e30137705d3b87d05cbfbc5712386fdeAndreas Gustafsson To see additional configure options, run "configure --help".
9e87fd676ee62e6e11d29611731b80839fc305b3David Lawrence
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley "make install" will install "named" and the various BIND 9 libraries.
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley By default, installation is into /usr/local, but this can be changed
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley with the "--prefix" option when running "configure".
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
5f5bb44065a3e7f506e4afd4d81c89da2931bf1bBob Halley If you're planning on making changes to the BIND 9 source, you
5f5bb44065a3e7f506e4afd4d81c89da2931bf1bBob Halley should also "make depend". If you're using Emacs, you might find
5f5bb44065a3e7f506e4afd4d81c89da2931bf1bBob Halley "make tags" helpful.
5f5bb44065a3e7f506e4afd4d81c89da2931bf1bBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley Building with gcc is not supported, unless gcc is the vendor's usual
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley compiler (e.g. the various BSD systems, Linux).
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
fe82c227f69c4a95d9db2f64f07e55daaf9499e6Bob Halley Parts of the library can be tested by running "make test" from the
9b19b39170eaf78ae1baf39acca0be462c2faa4cAndreas Gustafsson bin/tests subdirectory.
9b19b39170eaf78ae1baf39acca0be462c2faa4cAndreas Gustafsson
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas GustafssonDocumentation
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson The BIND 9 Administrator Reference Manual is included with the
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson source distribution in HTML and plain text format, in the
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson doc/arm directory. A PDF version can be downloaded separately
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson at <http://www.nominum.com/resources/>.
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson Some of the programs in the BIND 9 distribution have man pages
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson under the doc/man directory. In particular, the command line
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson options of "named" are documented in doc/man/bind/named.8.
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson The man pages are currently not installed automatically by
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson "make install".
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson If you are upgrading from BIND 8, please read the migration
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson notes in doc/misc/migration.
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas Gustafsson
413d5565ba2af24f12dc54d6e6807af7f1a39867Andreas GustafssonBug Reports and Mailing Lists
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley Bugs reports should be sent to
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley bind9-bugs@isc.org
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley To join the BIND 9 Users mailing list, send mail to
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley bind9-users-request@isc.org
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley If you're planning on making changes to the BIND 9 source
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley code, you might want to join the BIND 9 Workers mailing list.
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley Send mail to
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley bind9-workers-request@isc.org
36983956d7c3d9e294903eeda29548f67ac17daeBob Halley
a48fa4b49c58246b297e0fd38e5fb85b985379f1Bob Halley