README revision 949eefdda49701c14579d1fd251bd09df0751c2f
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews BIND version 9 is a major rewrite of nearly all aspects of the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein underlying BIND architecture. Some of the important features of
0b062f4990db5cc6db2fe3398926f71b92a67407Brian Wellington - DNS Security
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein DNSSEC (signed zones)
9016767f4e15191b7c763b8a4ad36a57dc2705a2Mark Andrews TSIG (signed DNS requests)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - IP version 6
9016767f4e15191b7c763b8a4ad36a57dc2705a2Mark Andrews Answers DNS queries on IPv6 sockets
9016767f4e15191b7c763b8a4ad36a57dc2705a2Mark Andrews IPv6 resource records (AAAA)
9016767f4e15191b7c763b8a4ad36a57dc2705a2Mark Andrews Experimental IPv6 Resolver Library
0b062f4990db5cc6db2fe3398926f71b92a67407Brian Wellington - DNS Protocol Enhancements
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein IXFR, DDNS, Notify, EDNS0
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Improved standards conformance
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User One server process can provide multiple "views" of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the DNS namespace, e.g. an "inside" view to certain
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User clients, and an "outside" view to others.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - Multiprocessor Support
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - Improved Portability Architecture
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein BIND version 9 development has been underwritten by the following
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User organizations:
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Sun Microsystems, Inc.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Hewlett Packard
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Compaq Computer Corporation
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews Process Software Corporation
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater Silicon Graphics, Inc.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater Network Associates, Inc.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein U.S. Defense Information Systems Agency
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User USENIX Association
ad671240d635376dd8681550eebee799d2e3d1fdAutomatic Updater Stichting NLnet - NLnet Foundation
ad671240d635376dd8681550eebee799d2e3d1fdAutomatic Updater For a summary of functional enhancements in previous
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User releases, see the HISTORY file.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User For a detailed list of user-visible changes from
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User previous releases, see the CHANGES file.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater BIND 9.9.0 includes a number of changes from BIND 9.8 and earlier
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater releases. New features include:
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews - Inline signing, allowing automatic DNSSEC signing of
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater master zones without modification of the zonefile, or
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater "bump in the wire" signing in slaves.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - NXDOMAIN redirection.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - New 'rndc flushtree' command clears all data under a given
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater name from the DNS cache.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - New 'rndc sync' command dumps pending changes in a dynamic
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater zone to disk without a freeze/thaw cycle.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - New 'rndc signing' command displays or clears signing status
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater records in 'auto-dnssec' zones.
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater - NSEC3 parameters for 'auto-dnssec' zones can now be set prior
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater to signing, eliminating the need to initially sign with NSEC.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Startup time improvements on large authoritative servers.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - Slave zones are now saved in raw format by default.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Several improvements to response policy zones (RPZ).
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater - Improved hardware scalability by using multiple threads
731cc132f22dbc9e0ecd7035dce314a61076d31bAutomatic Updater to listen for queries and using finer-grained client locking
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - The 'also-notify' option now takes the same syntax as
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User 'masters', so it can used named masterlists and TSIG keys.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - 'dnssec-signzone -D' writes an output file containing only DNSSEC
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater data, which can be included by the primary zone file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - 'dnssec-signzone -R' forces removal of signatures that are
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User not expired but were created by a key which no longer exists.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - 'dnssec-signzone -X' allows a separate expiration date to
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt be specified for DNSKEY signatures from other signatures.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - New '-L' option to dnssec-keygen, dnssec-settime, and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein dnssec-keyfromlabel sets the default TTL for the key.
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater - dnssec-dsfromkey now supports reading from standard input,
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt to make it easier to convert DNSKEY to DS.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - RFC 1918 reverse zones have been added to the empty-zones
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater table per RFC 6303.
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews - Dynamic updates can now optionally set the zone's SOA serial
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews number to the current UNIX time.
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt - DLZ modules can now retrieve the source IP address of
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User the querying client.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - 'request-ixfr' option can now be set at the per-zone level.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - 'dig +rrcomments' turns on comments about DNSKEY records,
6478b87fd23bcd3ab74c25b261021fe19a239c4fTinderbox User indicating their key ID, algorithm and function
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - Simplified nsupdate syntax and added readline support
b272d38cc5d24f64c0647a9afb340c21c4b9aaf7Evan Hunt BIND 9.8.0 includes a number of changes from BIND 9.7 and earlier
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User releases. New features include:
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - Built-in trust anchor for the root zone, which can be
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein switched on via "dnssec-validation auto;"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Support for DNS64.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Support for response policy zones (RPZ).
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Support for writable DLZ zones.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Improved ease of configuration of GSS/TSIG for
2f8d63983c297c62630044d28a6f66676b4d339dMark Andrews interoperability with Active Directory
2f8d63983c297c62630044d28a6f66676b4d339dMark Andrews - Support for GOST signing algorithm for DNSSEC.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - Removed RTT Banding from server selection algorithm.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - New "static-stub" zone type.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - Allow configuration of resolver timeouts via
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater "resolver-query-timeout" option.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - The DLZ "dlopen" driver is now built by default.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater - Added a new include file with function typedefs
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews for the DLZ "dlopen" driver.
aaaf8d4f4873d21e55c3ffb4f656203d08339865Mark Andrews - Made "--with-gssapi" default.
8e821eea5f57ac47a94305aa7ab0c3570d92a311Automatic Updater - More verbose error reporting from DLZ LDAP.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User BIND 9 currently requires a UNIX system with an ANSI C compiler,
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater basic POSIX support, and a 64 bit integer type.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater We've had successful builds and tests on the following systems:
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater COMPAQ Tru64 UNIX 5.1B
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Fedora Core 6
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein FreeBSD 4.10, 5.2.1, 6.2
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Mac OS X 10.5
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein NetBSD 3.x, 4.0-beta, 5.0-beta
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User OpenBSD 3.3 and up
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater Solaris 8, 9, 9 (x86), 10
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User Ubuntu 7.04, 7.10
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Windows XP/2003/2008
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User NOTE: As of BIND 9.5.1, 9.4.3, and 9.3.6, older versions of
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Windows, including Windows NT and Windows 2000, are no longer
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User We have recent reports from the user community that a supported
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User version of BIND will build and run on the following systems:
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User CentOS 4, 4.5, 5
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Darwin 9.0.0d1/ARM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Debian 4, 5, 6
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Fedora Core 5, 7, 8
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein FreeBSD 6, 7, 8
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater HP-UX 11.23 PA
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User MacOS X 10.5, 10.6, 10.7
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater Red Hat Enterprise Linux 4, 5, 6
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User SCO OpenServer 5.0.6
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater Slackware 9, 10
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein To build, just
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Do not use a parallel "make".
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Several environment variables that can be set before running
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User configure will affect compilation:
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The C compiler to use. configure tries to figure
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater out the right one for supported systems.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User C compiler flags. Defaults to include -g and/or -O2
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein as supported by the compiler.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User System header file directories. Can be used to specify
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater where add-on thread or IPv6 support is, for example.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Defaults to empty string.
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater Any additional preprocessor symbols you want defined.
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater Defaults to empty string.
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User Possible settings:
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User Change the default syslog facility of named/lwresd.
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User -DISC_FACILITY=LOG_LOCAL0
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Enable DNSSEC signature chasing support in dig.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -DDIG_SIGCHASE=1 (sets -DDIG_SIGCHASE_TD=1 and
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User -DDIG_SIGCHASE_BU=1)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Disable dropping queries from particular well known ports.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -DNS_CLIENT_DROPPORT=0
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Sibling glue checking in named-checkzone is enabled by default.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein To disable the default check set. -DCHECK_SIBLING=0
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User named-checkzone checks out-of-zone addresses by default.
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater To disable this default set. -DCHECK_LOCAL=0
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User To create the default pid files in ${localstatedir}/run rather
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater than ${localstatedir}/run/{named,lwresd}/ set.
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater -DNS_RUN_PID_DIR=0
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User Enable workaround for Solaris kernel bug about /dev/poll
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater -DISC_SOCKET_USE_POLLWATCH=1
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater The watch timeout is also configurable, e.g.,
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater -DISC_SOCKET_POLLWATCH_TIMEOUT=20
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater Linker flags. Defaults to empty string.
575e15fed997a3ad1cb35c5b9ef34ab24ce47e72Automatic Updater The following need to be set when cross compiling.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User The native C compiler.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein BUILD_CFLAGS (optional)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein BUILD_CPPFLAGS (optional)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Possible Settings:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein -DNEED_OPTARG=1 (optarg is not declared in <unistd.h>)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein BUILD_LDFLAGS (optional)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein BUILD_LIBS (optional)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein To build shared libraries, specify "--with-libtool" on the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein configure command line.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater For the server to support DNSSEC, you need to build it
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User with crypto support. You must have OpenSSL 0.9.5a
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater or newer installed and specify "--with-openssl" on the
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater configure command line. If OpenSSL is installed under
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater a nonstandard prefix, you can tell configure where to
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater look for it using "--with-openssl=/prefix".
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater On some platforms it is necessary to explictly request large
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater file support to handle files bigger than 2GB. This can be
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User done by "--enable-largefile" on the configure command line.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User On some platforms, BIND 9 can be built with multithreading
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein support, allowing it to take advantage of multiple CPUs.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein You can specify whether to build a multithreaded BIND 9
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein by specifying "--enable-threads" or "--disable-threads"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User on the configure command line. The default is operating
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater system dependent.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Support for the "fixed" rrset-order option can be enabled
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater or disabled by specifying "--enable-fixed-rrset" or
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater "--disable-fixed-rrset" on the configure command line.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater The default is "disabled", to reduce memory footprint.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater If your operating system has integrated support for IPv6, it
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater will be used automatically. If you have installed KAME IPv6
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater separately, use "--with-kame[=PATH]" to specify its location.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater "make install" will install "named" and the various BIND 9 libraries.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater By default, installation is into /usr/local, but this can be changed
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater with the "--prefix" option when running "configure".
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein You may specify the option "--sysconfdir" to set the directory
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User where configuration files like "named.conf" go by default,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and "--localstatedir" to set the default parent directory
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein of "run/named.pid". For backwards compatibility with BIND 8,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein --sysconfdir defaults to "/etc" and --localstatedir defaults to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein "/var" if no --prefix option is given. If there is a --prefix
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User option, sysconfdir defaults to "$prefix/etc" and localstatedir
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein defaults to "$prefix/var".
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein To see additional configure options, run "configure --help".
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Note that the help message does not reflect the BIND 8
6f1205897504b8f50b1785975482c995888dd630Tinderbox User compatibility defaults for sysconfdir and localstatedir.
6f1205897504b8f50b1785975482c995888dd630Tinderbox User If you're planning on making changes to the BIND 9 source, you
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User should also "make depend". If you're using Emacs, you might find
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein "make tags" helpful.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User If you need to re-run configure please run "make distclean" first.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User This will ensure that all the option changes take.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater Building with gcc is not supported, unless gcc is the vendor's usual
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater compiler (e.g. the various BSD systems, Linux).
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater Known compiler issues:
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater * gcc-3.2.1 and gcc-3.1.1 is known to cause problems with solaris-x86.
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater * gcc prior to gcc-3.2.3 ultrasparc generates incorrect code at -02.
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater * gcc-3.3.5 powerpc generates incorrect code at -02.
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User * Irix, MipsPRO 7.4.1m is known to cause problems.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater A limited test suite can be run with "make test". Many of
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User the tests require you to configure a set of virtual IP addresses
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater on your system, and some require Perl; see bin/tests/system/README
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater SunOS 4 requires "printf" to be installed to make the shared
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater libraries. sh-utils-1.16 provides a "printf" which compiles
5a24d24c8fba3480d707c0c902379ddb36501e12Automatic Updater The BIND 9 Administrator Reference Manual is included with the
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater source distribution in DocBook XML and HTML format, in the
bbbf2e27d3a981163dab139497d6b2dc85449db0Tinderbox User Some of the programs in the BIND 9 distribution have man pages
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User in their directories. In particular, the command line
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater options of "named" are documented in /bin/named/named.8.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User There is now also a set of man pages for the lwres library.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater If you are upgrading from BIND 8, please read the migration
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater notes in doc/misc/migration. If you are upgrading from
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Frequently asked questions and their answers can be found in
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater Additional information on various subjects can be found
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User in the other README files.
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater A detailed list of all changes to BIND 9 is included in the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User file CHANGES, with the most recent changes listed first.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater Change notes include tags indicating the category of the
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater change that was made; these categories are:
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [func] New feature
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [bug] General bug fix
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [security] Fix for a significant security flaw
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [experimental] Used for new features when the syntax
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater or other aspects of the design are still
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User in flux and may change
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [port] Portability enhancement
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [maint] Updates to built-in data such as root
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User server addresses and keys
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [tuning] Changes to built-in configuration defaults
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater and constants to improve performanceo
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [protocol] Updates to the DNS protocol such as new
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater [test] Changes to the automatic tests, not
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User affecting server functionality
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User [cleanup] Minor corrections and refactoring
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [doc] Documentation
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein In general, [func] and [experimental] tags will only appear
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein in new-feature releases (i.e., those with version numbers
90153b6536f7a5078e1c157c980110dbcd7fe205Mark Andrews ending in zero). Some new functionality may be backported to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein older releases on a case-by-case basis. All other change
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User types may be applied to all currently-supported releases.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserBug Reports and Mailing Lists
8ffa8320abcc17ae593af566cb946a58fe293860Brian Wellington Bugs reports should be sent to
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User bind9-bugs@isc.org
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User To join the BIND Users mailing list, send mail to
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User bind-users-request@isc.org
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein archives of which can be found via
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If you're planning on making changes to the BIND 9 source
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein code, you might want to join the BIND Workers mailing list.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein bind-workers-request@isc.org