README revision 3e480b2f811fb4898af49983abf43f0894bb29e5
59663800d2ec04777dae2791dd92aa563faf94c8Evan HuntBIND 9
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND version 9 is a major rewrite of nearly all aspects of the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User underlying BIND architecture. Some of the important features of
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND 9 are:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - DNS Security
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User DNSSEC (signed zones)
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User TSIG (signed DNS requests)
06dca180fb438fa26dc4198398753f50d161ffabTinderbox User
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User - IP version 6
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User Answers DNS queries on IPv6 sockets
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User IPv6 resource records (A6, DNAME, etc.)
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User Bitstring Labels
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User Experimental IPv6 Resolver Library
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - DNS Protocol Enhancements
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User IXFR, DDNS, Notify, EDNS0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Improved standards conformance
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - Views
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User One server process can provide multiple "views" of
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User the DNS namespace, e.g. an "inside" view to certain
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User clients, and an "outside" view to others.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - Multiprocessor Support
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - Improved Portability Architecture
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND version 9 development has been underwritten by the following
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User organizations:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Sun Microsystems, Inc.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Hewlett Packard
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Compaq Computer Corporation
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User IBM
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Process Software Corporation
4100890e5aacfb7e5e80f651b26fa057d542560bEvan Hunt Silicon Graphics, Inc.
4100890e5aacfb7e5e80f651b26fa057d542560bEvan Hunt Network Associates, Inc.
4100890e5aacfb7e5e80f651b26fa057d542560bEvan Hunt U.S. Defense Information Systems Agency
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User USENIX Association
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Stichting NLnet - NLnet Foundation
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Nominum, Inc.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox UserBIND 9.3.0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND 9.3.0 has a number of new features over 9.2,
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User including:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User NOTE:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User * Zones containing MD and MF will now be rejected.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý * dig, nslookup name. now report "Not Implemented" as
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý NOTIMP rather than NOTIMPL. This will have impact on scripts
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý that are looking for NOTIMPL.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej SurýBIND 9.2.0
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý BIND 9.2.0 has a number of new features over 9.1,
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý including:
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý - The size of the cache can now be limited using the
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý "max-cache-size" option.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý - The server can now automatically convert RFC1886-style
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý recursive lookup requests into RFC2874-style lookups,
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User when enabled using the new option "allow-v6-synthesis".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User This allows stub resolvers that support AAAA records
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User but not A6 record chains or binary labels to perform
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User lookups in domains that make use of these IPv6 DNS
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User features.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - Performance has been improved.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - The man pages now use the more portable "man" macros
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User rather than the "mandoc" macros, and are installed
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User by "make install".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - The named.conf parser has been completely rewritten.
e609b6b32bc8455692e1497a4568c68d7bfb9f36Evan Hunt It now supports "include" directives in more
e609b6b32bc8455692e1497a4568c68d7bfb9f36Evan Hunt places such as inside "view" statememnts, and it no
e609b6b32bc8455692e1497a4568c68d7bfb9f36Evan Hunt longer has any reserved words.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - The "rndc status" command is now implemented.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User - rndc can now be configured automatically.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý - A BIND 8 compatible stub resolver library is now
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý included in lib/bind.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý - OpenSSL has been removed from the distribution. This
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý means that to use DNSSEC, OpenSSL must be installed and
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý the --with-openssl option must be supplied to configure.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý This does not apply to the use of TSIG, which does not
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý require OpenSSL.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý - The source distribution now builds on Windows NT/2000.
2baa66562a2f119edffded961d3391f87ff98ec0Ondřej Surý See win32utils/readme1.txt and win32utils/win32-build.txt
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User for details.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User This distribution also includes a new lightweight stub
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User resolver library and associated resolver daemon that fully
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User support forward and reverse lookups of both IPv4 and IPv6
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User addresses. This library is considered experimental and
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User is not a complete replacement for the BIND 8 resolver library.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Applications that use the BIND 8 res_* functions to perform
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User DNS lookups or dynamic updates still need to be linked against
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User the BIND 8 libraries. For DNS lookups, they can also use the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User new "getrrsetbyname()" API.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND 9.2 is capable of acting as an authoritative server
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User for DNSSEC secured zones. This functionality is believed to
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User be stable and complete except for lacking support for
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User verifications involving wildcard records in secure zones.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User When acting as a caching server, BIND 9.2 can be configured
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User to perform DNSSEC secure resolution on behalf of its clients.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User This part of the DNSSEC implementation is still considered
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User experimental. For detailed information about the state of the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User DNSSEC implementation, see the file doc/misc/dnssec.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User There are a few known bugs:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User On some systems, IPv6 and IPv4 sockets interact in
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User unexpected ways. For details, see doc/misc/ipv6.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User To reduce the impact of these problems, the server
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User no longer listens for requests on IPv6 addresses
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User by default. If you need to accept DNS queries over
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User IPv6, you must specify "listen-on-v6 { any; };"
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User in the named.conf options statement.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User FreeBSD prior to 4.2 (and 4.2 if running as non-root)
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User and OpenBSD prior to 2.8 log messages like
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User "fcntl(8, F_SETFL, 4): Inappropriate ioctl for device".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User This is due to a bug in "/dev/random" and impacts the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User server's DNSSEC support.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User OS X 10.1.4 (Darwin 5.4), OS X 10.1.5 (Darwin 5.5) and
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User OS X 10.2 (Darwin 6.0) reports errors like
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User "fcntl(3, F_SETFL, 4): Operation not supported by device".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User This is due to a bug in "/dev/random" and impacts the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User server's DNSSEC support.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User --with-libtool does not work on AIX.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User A bug in the Windows 2000 DNS server can cause zone transfers
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User from a BIND 9 server to a W2K server to fail. For details,
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User see the "Zone Transfers" section in doc/misc/migration.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User For a detailed list of user-visible changes from
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User previous releases, see the CHANGES file.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox UserBuilding
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND 9 currently requires a UNIX system with an ANSI C compiler,
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User basic POSIX support, and a 64 bit integer type.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User We've had successful builds and tests on the following systems:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User AIX 4.3
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User COMPAQ Tru64 UNIX 4.0D
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User COMPAQ Tru64 UNIX 5 (with IPv6 EAK)
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User FreeBSD 3.4-STABLE, 3.5, 4.0, 4.1
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User HP-UX 11
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User IRIX64 6.5
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User NetBSD 1.5
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Red Hat Linux 6.0, 6.1, 6.2, 7.0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Solaris 2.6, 7, 8
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Windows NT/W2K
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Additionally, we have unverified reports of success building
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User previous versions of BIND 9 from users of the following systems:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User AIX 5L
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User SuSE Linux 7.0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Slackware Linux 7.x, 8.0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Red Hat Linux 7.1
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Debian GNU/Linux 2.2 and 3.0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Mandrake 8.1
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User OpenBSD 2.6, 2.8, 2.9
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User UnixWare 7.1.1
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User HP-UX 10.20
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BSD/OS 4.2
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Mac OS X 10.1
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User To build, just
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User ./configure
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User make
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Do not use a parallel "make".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Several environment variables that can be set before running
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User configure will affect compilation:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User CC
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User The C compiler to use. configure tries to figure
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User out the right one for supported systems.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User CFLAGS
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User C compiler flags. Defaults to include -g and/or -O2
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User as supported by the compiler.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User STD_CINCLUDES
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User System header file directories. Can be used to specify
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User where add-on thread or IPv6 support is, for example.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Defaults to empty string.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User STD_CDEFINES
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Any additional preprocessor symbols you want defined.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Defaults to empty string.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Possible settings:
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Change the default syslog facility of named/lwresd.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User e.g. -DISC_FACILITY=LOG_LOCAL0
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User To build shared libraries, specify "--with-libtool" on the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User configure command line.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User For the server to support DNSSEC, you need to build it
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User with crypto support. You must have OpenSSL 0.9.5a
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User or newer installed and specify "--with-openssl" on the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User configure command line. If OpenSSL is installed under
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User a nonstandard prefix, you can tell configure where to
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User look for it using "--with-openssl=/prefix".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User To build libbind (the BIND 8 resolver library), specify
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User "--enable-libbind" on the configure command line.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User On some platforms, BIND 9 can be built with multithreading
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User support, allowing it to take advantage of multiple CPUs.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User You can specify whether to build a multithreaded BIND 9
3440cf9c60cd5d35634e7f274fd3eccbba2173a5Evan Hunt by specifying "--enable-threads" or "--disable-threads"
3440cf9c60cd5d35634e7f274fd3eccbba2173a5Evan Hunt on the configure command line. The default is operating
a03f4b1ea4f1a4a70963fbeb606841c217f9e5f3Evan Hunt system dependent.
a03f4b1ea4f1a4a70963fbeb606841c217f9e5f3Evan Hunt
a03f4b1ea4f1a4a70963fbeb606841c217f9e5f3Evan Hunt If your operating system has integrated support for IPv6, it
a03f4b1ea4f1a4a70963fbeb606841c217f9e5f3Evan Hunt will be used automatically. If you have installed KAME IPv6
a03f4b1ea4f1a4a70963fbeb606841c217f9e5f3Evan Hunt separately, use "--with-kame[=PATH]" to specify its location.
3440cf9c60cd5d35634e7f274fd3eccbba2173a5Evan Hunt
ad309e8dfa0601d6053aaa12770a98a6940f89deEvan Hunt "make install" will install "named" and the various BIND 9 libraries.
ad309e8dfa0601d6053aaa12770a98a6940f89deEvan Hunt By default, installation is into /usr/local, but this can be changed
ad309e8dfa0601d6053aaa12770a98a6940f89deEvan Hunt with the "--prefix" option when running "configure".
ad309e8dfa0601d6053aaa12770a98a6940f89deEvan Hunt
ad309e8dfa0601d6053aaa12770a98a6940f89deEvan Hunt You may specify the option "--sysconfdir" to set the directory
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User where configuration files like "named.conf" go by default,
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User and "--localstatedir" to set the default parent directory
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User of "run/named.pid". For backwards compatibility with BIND 8,
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User --sysconfdir defaults to "/etc" and --localstatedir defaults to
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User "/var" if no --prefix option is given. If there is a --prefix
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User option, sysconfdir defaults to "$prefix/etc" and localstatedir
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User defaults to "$prefix/var".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User To see additional configure options, run "configure --help".
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Note that the help message does not reflect the BIND 8
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User compatibility defaults for sysconfdir and localstatedir.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User If you're planning on making changes to the BIND 9 source, you
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User should also "make depend". If you're using Emacs, you might find
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User "make tags" helpful.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User If you need to re-run configure please run "make distclean" first.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User This will ensure that all the option changes take.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Building with gcc is not supported, unless gcc is the vendor's usual
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User compiler (e.g. the various BSD systems, Linux).
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User A limited test suite can be run with "make test". Many of
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User the tests require you to configure a set of virtual IP addresses
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User on your system, and some require Perl; see bin/tests/system/README
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User for details.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox UserDocumentation
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User The BIND 9 Administrator Reference Manual is included with the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User source distribution in DocBook XML and HTML format, in the
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User doc/arm directory.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Some of the programs in the BIND 9 distribution have man pages
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User in their directories. In particular, the command line
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User options of "named" are documented in /bin/named/named.8.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User There is now also a set of man pages for the lwres library.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User If you are upgrading from BIND 8, please read the migration
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User notes in doc/misc/migration. If you are upgrading from
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User BIND 4, read doc/misc/migration-4to9.
06dca180fb438fa26dc4198398753f50d161ffabTinderbox User
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User Frequently asked questions and their answers can be found in
06dca180fb438fa26dc4198398753f50d161ffabTinderbox User FAQ.
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox UserBug Reports and Mailing Lists
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User
350e5eecadfc5ee72b11b2cc46828c9a0bcd717cTinderbox User Bugs reports should be sent to
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User bind9-bugs@isc.org
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User To join the BIND 9 Users mailing list, send mail to
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User bind9-users-request@isc.org
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User archives of which can be found via
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User http://www.isc.org/ml-archives/
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User If you're planning on making changes to the BIND 9 source
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User code, you might want to join the BIND Workers mailing list.
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User Send mail to
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User bind-workers-request@isc.org
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User
0fc4b96b2b7f8cb79c3a1f41c53534acacbf6451Tinderbox User