README revision 8d0d941054982cff5235a9033040ac35c3f06a50
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
fd9b6f253eac9dae2e1ad19d49aaa922d5d4f274Mark Andrews IPv6 resource records (AAAA)
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
276a77c22af98c78403883b16a82646a0d5b29abPaul Vixie Nominum, Inc.
40d01ce8f3a1889f5799d9b22b26d5398fa75a1bBob Halley
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan HuntBIND 9.3.0
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt BIND 9.3.0 has a number of new features over 9.2,
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt including:
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt DNSSEC is now DS based.
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt See doc/draft/draft-ietf-dnsext-dnssec-*
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt
bcfb2cead57dcc6b678abbf0161c1cab989d6de1Mark Andrews DNSSEC lookaside validation.
bcfb2cead57dcc6b678abbf0161c1cab989d6de1Mark Andrews
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt check-names is now implemented.
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt rrset-order in more complete.
6cdaeb94d4d12b72b919f3c7099f7c47c172b59bEvan Hunt
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews IPv4/IPv6 transition support, dual-stack-servers.
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews IXFR deltas can now be generated when loading master files,
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews ixfr-from-differences.
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews It is now possible to specify the size of a journal, max-journal-size.
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews It is now possible to define a named set of master servers to be
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews used in masters clause, masters.
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews The advertised EDNS UDP size can now be set, edns-udp-size.
2fff8b8280779a25fbdb891b2d3d9b435d2084f0Tatuya JINMEI 神明達哉
2fff8b8280779a25fbdb891b2d3d9b435d2084f0Tatuya JINMEI 神明達哉 allow-v6-synthesis has been obsoleted.
19bcb91965916ed8f0a47da2284ddaecce70bc69Evan Hunt
19bcb91965916ed8f0a47da2284ddaecce70bc69Evan Hunt NOTE:
9c114f36dab6bc6fc024b46680cfdd246efc880cEvan Hunt * Zones containing MD and MF will now be rejected.
5a8bebe00df211d4fdac3edc36cf35e1d5af42e0Mark Andrews * dig, nslookup name. now report "Not Implemented" as
ffc65cc90db78a67171e3d91f63f2e92d09d2d38Evan Hunt NOTIMP rather than NOTIMPL. This will have impact on scripts
ffc65cc90db78a67171e3d91f63f2e92d09d2d38Evan Hunt that are looking for NOTIMPL.
767c53c304b86460d72eeec7d3304172cdd904bdEvan Hunt
767c53c304b86460d72eeec7d3304172cdd904bdEvan Hunt libbind: corresponds to that from BIND 8.4.5.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark AndrewsBIND 9.2.0
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews BIND 9.2.0 has a number of new features over 9.1,
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews including:
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - The size of the cache can now be limited using the
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews "max-cache-size" option.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - The server can now automatically convert RFC1886-style
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews recursive lookup requests into RFC2874-style lookups,
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews when enabled using the new option "allow-v6-synthesis".
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews This allows stub resolvers that support AAAA records
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews but not A6 record chains or binary labels to perform
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews lookups in domains that make use of these IPv6 DNS
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews features.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - Performance has been improved.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - The man pages now use the more portable "man" macros
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews rather than the "mandoc" macros, and are installed
9ab3b369d941e5b97fd6694ca3f3aedf5c7f3a7bMark Andrews by "make install".
9ab3b369d941e5b97fd6694ca3f3aedf5c7f3a7bMark Andrews
9ab3b369d941e5b97fd6694ca3f3aedf5c7f3a7bMark Andrews - The named.conf parser has been completely rewritten.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews It now supports "include" directives in more
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews places such as inside "view" statements, and it no
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews longer has any reserved words.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - The "rndc status" command is now implemented.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - rndc can now be configured automatically.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - A BIND 8 compatible stub resolver library is now
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews included in lib/bind.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - OpenSSL has been removed from the distribution. This
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews means that to use DNSSEC, OpenSSL must be installed and
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews the --with-openssl option must be supplied to configure.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews This does not apply to the use of TSIG, which does not
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews require OpenSSL.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews - The source distribution now builds on Windows NT/2000.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews See win32utils/readme1.txt and win32utils/win32-build.txt
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews for details.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews This distribution also includes a new lightweight stub
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews resolver library and associated resolver daemon that fully
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews support forward and reverse lookups of both IPv4 and IPv6
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews addresses. This library is considered experimental and
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews is not a complete replacement for the BIND 8 resolver library.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Applications that use the BIND 8 res_* functions to perform
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews DNS lookups or dynamic updates still need to be linked against
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews the BIND 8 libraries. For DNS lookups, they can also use the
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews new "getrrsetbyname()" API.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews BIND 9.2 is capable of acting as an authoritative server
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews for DNSSEC secured zones. This functionality is believed to
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews be stable and complete except for lacking support for
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews verifications involving wildcard records in secure zones.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews When acting as a caching server, BIND 9.2 can be configured
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews to perform DNSSEC secure resolution on behalf of its clients.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews This part of the DNSSEC implementation is still considered
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews experimental. For detailed information about the state of the
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews DNSSEC implementation, see the file doc/misc/dnssec.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews There are a few known bugs:
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews On some systems, IPv6 and IPv4 sockets interact in
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews unexpected ways. For details, see doc/misc/ipv6.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews To reduce the impact of these problems, the server
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews no longer listens for requests on IPv6 addresses
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews by default. If you need to accept DNS queries over
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews IPv6, you must specify "listen-on-v6 { any; };"
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews in the named.conf options statement.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews FreeBSD prior to 4.2 (and 4.2 if running as non-root)
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews and OpenBSD prior to 2.8 log messages like
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews "fcntl(8, F_SETFL, 4): Inappropriate ioctl for device".
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews This is due to a bug in "/dev/random" and impacts the
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews server's DNSSEC support.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews OS X 10.1.4 (Darwin 5.4), OS X 10.1.5 (Darwin 5.5) and
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews OS X 10.2 (Darwin 6.0) reports errors like
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews "fcntl(3, F_SETFL, 4): Operation not supported by device".
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews This is due to a bug in "/dev/random" and impacts the
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews server's DNSSEC support.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews --with-libtool does not work on AIX.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews A bug in the Windows 2000 DNS server can cause zone transfers
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews from a BIND 9 server to a W2K server to fail. For details,
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews see the "Zone Transfers" section in doc/misc/migration.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews For a detailed list of user-visible changes from
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews previous releases, see the CHANGES file.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark AndrewsBuilding
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews BIND 9 currently requires a UNIX system with an ANSI C compiler,
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews basic POSIX support, and a 64 bit integer type.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews We've had successful builds and tests on the following systems:
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews AIX 4.3
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews COMPAQ Tru64 UNIX 4.0D
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews COMPAQ Tru64 UNIX 5 (with IPv6 EAK)
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews FreeBSD 3.4-STABLE, 3.5, 4.0, 4.1
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews HP-UX 11
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews IRIX64 6.5
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews NetBSD 1.5
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Red Hat Linux 6.0, 6.1, 6.2, 7.0
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Solaris 2.6, 7, 8
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Windows NT/W2K
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Additionally, we have unverified reports of success building
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews previous versions of BIND 9 from users of the following systems:
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews AIX 5L
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews SuSE Linux 7.0
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Slackware Linux 7.x, 8.0
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Red Hat Linux 7.1
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Debian GNU/Linux 2.2 and 3.0
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Mandrake 8.1
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews OpenBSD 2.6, 2.8, 2.9
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews UnixWare 7.1.1
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews HP-UX 10.20
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews BSD/OS 4.2
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Mac OS X 10.1
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews To build, just
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews ./configure
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews make
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Do not use a parallel "make".
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Several environment variables that can be set before running
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews configure will affect compilation:
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews CC
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews The C compiler to use. configure tries to figure
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews out the right one for supported systems.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews CFLAGS
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews C compiler flags. Defaults to include -g and/or -O2
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews as supported by the compiler.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews STD_CINCLUDES
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews System header file directories. Can be used to specify
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews where add-on thread or IPv6 support is, for example.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Defaults to empty string.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews STD_CDEFINES
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Any additional preprocessor symbols you want defined.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Defaults to empty string.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Possible settings:
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Change the default syslog facility of named/lwresd.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews -DISC_FACILITY=LOG_LOCAL0
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews Enable DNSSEC signature chasing support in dig.
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews -DDIG_SIGCHASE=1 (sets -DDIG_SIGCHASE_TD=1 and
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews -DDIG_SIGCHASE_BU=1)
309a3b5808b3e7666d219665c28768e5c0997f14Mark Andrews
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews To build shared libraries, specify "--with-libtool" on the
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews configure command line.
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews For the server to support DNSSEC, you need to build it
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews with crypto support. You must have OpenSSL 0.9.5a
3b71206de9478a75ba735391498959bc54d542a2Mark Andrews or newer installed and specify "--with-openssl" on the
3b71206de9478a75ba735391498959bc54d542a2Mark Andrews configure command line. If OpenSSL is installed under
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews a nonstandard prefix, you can tell configure where to
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews look for it using "--with-openssl=/prefix".
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews To build libbind (the BIND 8 resolver library), specify
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews "--enable-libbind" on the configure command line.
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews On some platforms, BIND 9 can be built with multithreading
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews support, allowing it to take advantage of multiple CPUs.
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews You can specify whether to build a multithreaded BIND 9
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews by specifying "--enable-threads" or "--disable-threads"
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews on the configure command line. The default is operating
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews system dependent.
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews If your operating system has integrated support for IPv6, it
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews will be used automatically. If you have installed KAME IPv6
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews separately, use "--with-kame[=PATH]" to specify its location.
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews "make install" will install "named" and the various BIND 9 libraries.
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews By default, installation is into /usr/local, but this can be changed
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews with the "--prefix" option when running "configure".
c3e0aed7da9ca312a3b25a4eee13573dca04c318Mark Andrews
c3e0aed7da9ca312a3b25a4eee13573dca04c318Mark Andrews You may specify the option "--sysconfdir" to set the directory
c3e0aed7da9ca312a3b25a4eee13573dca04c318Mark Andrews where configuration files like "named.conf" go by default,
c3e0aed7da9ca312a3b25a4eee13573dca04c318Mark Andrews and "--localstatedir" to set the default parent directory
c3e0aed7da9ca312a3b25a4eee13573dca04c318Mark Andrews of "run/named.pid". For backwards compatibility with BIND 8,
c3e0aed7da9ca312a3b25a4eee13573dca04c318Mark Andrews --sysconfdir defaults to "/etc" and --localstatedir defaults to
1676408640d8283c9f17eec0b183e1302ea7fd70Mark Andrews "/var" if no --prefix option is given. If there is a --prefix
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews option, sysconfdir defaults to "$prefix/etc" and localstatedir
c45ca0b839adc61c7902aad0969de36921b292b0Mark Andrews defaults to "$prefix/var".
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
1c9afb96b58f450f8861007e5135dee1447e680fAndreas Gustafsson To see additional configure options, run "configure --help".
1c9afb96b58f450f8861007e5135dee1447e680fAndreas Gustafsson Note that the help message does not reflect the BIND 8
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson compatibility defaults for sysconfdir and localstatedir.
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson If you're planning on making changes to the BIND 9 source, you
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson should also "make depend". If you're using Emacs, you might find
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson "make tags" helpful.
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson If you need to re-run configure please run "make distclean" first.
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson This will ensure that all the option changes take.
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson Building with gcc is not supported, unless gcc is the vendor's usual
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson compiler (e.g. the various BSD systems, Linux).
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson * gcc-3.2.1 and gcc-3.1.1 is known to cause problems with solaris-x86.
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson * gcc prior to gcc-3.2.3 ultrasparc generates incorrect code at -02.
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson A limited test suite can be run with "make test". Many of
8c4f1fa179f8f2fc56a9fa9294682a080e8756eeAndreas Gustafsson the tests require you to configure a set of virtual IP addresses
672a41b5fef7722803645c1f0ca132972f0f940aAndreas Gustafsson on your system, and some require Perl; see bin/tests/system/README
8a01f10278e0c794fe1d488bab2f97185f272e26Andreas Gustafsson for details.
8a01f10278e0c794fe1d488bab2f97185f272e26Andreas Gustafsson
b587e1d83f007ce68a9ae93097c461d8eb7aa373Mark Andrews
8a01f10278e0c794fe1d488bab2f97185f272e26Andreas GustafssonDocumentation
8a01f10278e0c794fe1d488bab2f97185f272e26Andreas Gustafsson
18b393da86f452303036b5fe6feb6c1e5f6b2c02Andreas Gustafsson The BIND 9 Administrator Reference Manual is included with the
18b393da86f452303036b5fe6feb6c1e5f6b2c02Andreas Gustafsson source distribution in DocBook XML and HTML format, in the
81fb2f5544552e67d7be673e353e399789e203e7Brian Wellington doc/arm directory.
81fb2f5544552e67d7be673e353e399789e203e7Brian Wellington
00205e27e84603f75eed46268a5100e86883f06bAndreas Gustafsson Some of the programs in the BIND 9 distribution have man pages
00205e27e84603f75eed46268a5100e86883f06bAndreas Gustafsson in their directories. In particular, the command line
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson options of "named" are documented in /bin/named/named.8.
317ebe84d581e59f5cb63bc6c1556a479bbb179aAndreas Gustafsson There is now also a set of man pages for the lwres library.
317ebe84d581e59f5cb63bc6c1556a479bbb179aAndreas Gustafsson
317ebe84d581e59f5cb63bc6c1556a479bbb179aAndreas Gustafsson If you are upgrading from BIND 8, please read the migration
317ebe84d581e59f5cb63bc6c1556a479bbb179aAndreas Gustafsson notes in doc/misc/migration. If you are upgrading from
317ebe84d581e59f5cb63bc6c1556a479bbb179aAndreas Gustafsson BIND 4, read doc/misc/migration-4to9.
faca6b801dcace871c8a98c8ee1bba8d7e2994a5Brian Wellington
ce249202297281e4b5aad3c310008ed16f810096Evan Hunt Frequently asked questions and their answers can be found in
cca68b1ff68cd4342705b71015f603c7389d040cAndreas Gustafsson FAQ.
cca68b1ff68cd4342705b71015f603c7389d040cAndreas Gustafsson
5f25ebaaa087893f8f57cc558c4b36eab6c26988Andreas Gustafsson
ecbfd32d3710d539f19a9323f16cf43a095580bdAndreas GustafssonBug Reports and Mailing Lists
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson Bugs reports should be sent to
ecbfd32d3710d539f19a9323f16cf43a095580bdAndreas Gustafsson
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson bind9-bugs@isc.org
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson To join the BIND Users mailing list, send mail to
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson bind-users-request@isc.org
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson archives of which can be found via
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson
c54c1eaf26d5a7fc123c4af3712353156a766df1Mark Andrews http://www.isc.org/ops/lists/
c54c1eaf26d5a7fc123c4af3712353156a766df1Mark Andrews
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson If you're planning on making changes to the BIND 9 source
4d5f44e7933f4cb691e8f4cf3b4b5f61c27e2b1cAndreas Gustafsson code, you might want to join the BIND Workers mailing list.
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson Send mail to
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson bind-workers-request@isc.org
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson
3b8932de20e12b07f9d874d5538d30e1fac9a9f4Andreas Gustafsson