contrib/bind9/README

   1 BIND 9
   2
   3         BIND version 9 is a major rewrite of nearly all aspects of the
   4         underlying BIND architecture.  Some of the important features of
   5         BIND 9 are:
   6
   7                 - DNS Security
   8                         DNSSEC (signed zones)
   9                         TSIG (signed DNS requests)
  10
  11                 - IP version 6
  12                         Answers DNS queries on IPv6 sockets
  13                         IPv6 resource records (AAAA)
  14                         Experimental IPv6 Resolver Library
  15
  16                 - DNS Protocol Enhancements
  17                         IXFR, DDNS, Notify, EDNS0
  18                         Improved standards conformance
  19
  20                 - Views
  21                         One server process can provide multiple "views" of
  22                         the DNS namespace, e.g. an "inside" view to certain
  23                         clients, and an "outside" view to others.
  24
  25                 - Multiprocessor Support
  26
  27                 - Improved Portability Architecture
  28
  29
  30         BIND version 9 development has been underwritten by the following
  31         organizations:
  32
  33                 Sun Microsystems, Inc.
  34                 Hewlett Packard
  35                 Compaq Computer Corporation
  36                 IBM
  37                 Process Software Corporation
  38                 Silicon Graphics, Inc.
  39                 Network Associates, Inc.
  40                 U.S. Defense Information Systems Agency
  41                 USENIX Association
  42                 Stichting NLnet - NLnet Foundation
  43                 Nominum, Inc.
  44
  45         For a summary of functional enhancements in previous
  46         releases, see the HISTORY file.
  47
  48         For a detailed list of user-visible changes from
  49         previous releases, see the CHANGES file.
  50
  51 BIND 9.8.1
  52
  53         BIND 9.8.1 includes a number of bug fixes and enhancements from
  54         BIND 9.8 and earlier releases.  New features include:
  55
  56         - The DLZ "dlopen" driver is now built by default.
  57         - Added a new include file with function typedefs
  58           for the DLZ "dlopen" driver.
  59         - Made "--with-gssapi" default.
  60         - More verbose error reporting from DLZ LDAP.
  61
  62 BIND 9.8.0
  63
  64         BIND 9.8.0 includes a number of changes from BIND 9.7 and earlier
  65         releases.  New features include:
  66
  67         - Built-in trust anchor for the root zone, which can be
  68           switched on via "dnssec-validation auto;"
  69         - Support for DNS64.
  70         - Support for response policy zones (RPZ).
  71         - Support for writable DLZ zones.
  72         - Improved ease of configuration of GSS/TSIG for
  73           interoperability with Active Directory
  74         - Support for GOST signing algorithm for DNSSEC.
  75         - Removed RTT Banding from server selection algorithm.
  76         - New "static-stub" zone type.
  77         - Allow configuration of resolver timeouts via
  78           "resolver-query-timeout" option.
  79
  80 BIND 9.7.0
  81
  82         BIND 9.7.0 includes a number of changes from BIND 9.6 and earlier
  83         releases.  Most are intended to simplify DNSSEC configuration.
  84
  85         New features include:
  86
  87         - Fully automatic signing of zones by "named".
  88         - Simplified configuration of DNSSEC Lookaside Validation (DLV).
  89         - Simplified configuration of Dynamic DNS, using the "ddns-confgen"
  90           command line tool or the "local" update-policy option.  (As a side
  91           effect, this also makes it easier to configure automatic zone
  92           re-signing.)
  93         - New named option "attach-cache" that allows multiple views to
  94           share a single cache.
  95         - DNS rebinding attack prevention.
  96         - New default values for dnssec-keygen parameters.
  97         - Support for RFC 5011 automated trust anchor maintenance
  98         - Smart signing: simplified tools for zone signing and key
  99           maintenance.
 100         - The "statistics-channels" option is now available on Windows.
 101         - A new DNSSEC-aware libdns API for use by non-BIND9 applications
 102         - On some platforms, named and other binaries can now print out
 103           a stack backtrace on assertion failure, to aid in debugging.
 104         - A "tools only" installation mode on Windows, which only installs
 105           dig, host, nslookup and nsupdate.
 106         - Improved PKCS#11 support, including Keyper support and explicit
 107           OpenSSL engine selection.
 108
 109         Known issues in this release:
 110
 111         - In rare cases, DNSSEC validation can leak memory.  When this
 112           happens, it will cause an assertion failure when named exits,
 113           but is otherwise harmless.  A fix exists, but was too late for
 114           this release; it will be included in BIND 9.7.1.
 115
 116         Compatibility notes:
 117
 118         - If you had built BIND 9.6 with any of ALLOW_NSEC3PARAM_UPDATE,
 119           ALLOW_SECURE_TO_INSECURE or ALLOW_INSECURE_TO_SECURE defined, then
 120           you should ensure that all changes that are in progress have
 121           completed prior to upgrading to BIND 9.7.  BIND 9.7 implements
 122           those features in a way which is not backwards compatible.
 123
 124         - Prior releases had a bug which caused HMAC-SHA* keys with long
 125           secrets to be used incorrectly.  Fixing this bug means that older
 126           versions of BIND 9 may fail to interoperate with this version
 127           when using TSIG keys.  If this occurs, the new "isc-hmac-fixup"
 128           tool will convert a key with a long secret into a form that works
 129           correctly with all versions of BIND 9.  See the "isc-hmac-fixup"
 130           man page for additional details.
 131
 132         - Revoking a DNSSEC key with "dnssec-revoke" changes its key ID.
 133           It is possible for the new key ID to collide with that of a
 134           different key.  Newly generated keys will not have this problem,
 135           as "dnssec-keygen" looks for potential collisions before
 136           generating keys, but exercise caution if using key revokation
 137           with keys that were generated by older versions of BIND 9.  See
 138           the Administrator's Reference Manual, section 4.10 ("Dynamic
 139           Trust Anchor Management") for more details.
 140
 141         - A bug was fixed in which a key's scheduled inactivity date was
 142           stored incorectly.  Users who participated in the 9.7.0 BETA test
 143           and had DNSSEC keys with scheduled inactivity dates will need to
 144           reset those keys' dates using "dnssec-settime -I".
 145
 146 Building
 147
 148         BIND 9 currently requires a UNIX system with an ANSI C compiler,
 149         basic POSIX support, and a 64 bit integer type.
 150
 151         We've had successful builds and tests on the following systems:
 152
 153                 COMPAQ Tru64 UNIX 5.1B
 154                 Fedora Core 6
 155                 FreeBSD 4.10, 5.2.1, 6.2
 156                 HP-UX 11.11
 157                 Mac OS X 10.5
 158                 NetBSD 3.x, 4.0-beta, 5.0-beta
 159                 OpenBSD 3.3 and up
 160                 Solaris 8, 9, 9 (x86), 10
 161                 Ubuntu 7.04, 7.10
 162                 Windows XP/2003/2008
 163
 164         NOTE:  As of BIND 9.5.1, 9.4.3, and 9.3.6, older versions of
 165         Windows, including Windows NT and Windows 2000, are no longer
 166         supported.
 167
 168         We have recent reports from the user community that a supported
 169         version of BIND will build and run on the following systems:
 170
 171                 AIX 4.3, 5L
 172                 CentOS 4, 4.5, 5
 173                 Darwin 9.0.0d1/ARM
 174                 Debian 4
 175                 Fedora Core 5, 7
 176                 FreeBSD 6.1
 177                 HP-UX 11.23 PA
 178                 MacOS X 10.4, 10.5
 179                 Red Hat Enterprise Linux 4, 5
 180                 SCO OpenServer 5.0.6
 181                 Slackware 9, 10
 182                 SuSE 9, 10
 183
 184         To build, just
 185
 186                 ./configure
 187                 make
 188
 189         Do not use a parallel "make".
 190
 191         Several environment variables that can be set before running
 192         configure will affect compilation:
 193
 194             CC
 195                 The C compiler to use.  configure tries to figure
 196                 out the right one for supported systems.
 197
 198             CFLAGS
 199                 C compiler flags.  Defaults to include -g and/or -O2
 200                 as supported by the compiler.
 201
 202             STD_CINCLUDES
 203                 System header file directories.  Can be used to specify
 204                 where add-on thread or IPv6 support is, for example.
 205                 Defaults to empty string.
 206
 207             STD_CDEFINES
 208                 Any additional preprocessor symbols you want defined.
 209                 Defaults to empty string.
 210
 211                 Possible settings:
 212                 Change the default syslog facility of named/lwresd.
 213                   -DISC_FACILITY=LOG_LOCAL0
 214                 Enable DNSSEC signature chasing support in dig.
 215                   -DDIG_SIGCHASE=1 (sets -DDIG_SIGCHASE_TD=1 and
 216                                     -DDIG_SIGCHASE_BU=1)
 217                 Disable dropping queries from particular well known ports.
 218                   -DNS_CLIENT_DROPPORT=0
 219                 Sibling glue checking in named-checkzone is enabled by default.
 220                 To disable the default check set.  -DCHECK_SIBLING=0
 221                 named-checkzone checks out-of-zone addresses by default.
 222                 To disable this default set.  -DCHECK_LOCAL=0
 223                 To create the default pid files in ${localstatedir}/run rather
 224                 than ${localstatedir}/run/{named,lwresd}/ set.
 225                   -DNS_RUN_PID_DIR=0
 226                 Enable workaround for Solaris kernel bug about /dev/poll
 227                   -DISC_SOCKET_USE_POLLWATCH=1
 228                   The watch timeout is also configurable, e.g.,
 229                   -DISC_SOCKET_POLLWATCH_TIMEOUT=20
 230
 231             LDFLAGS
 232                 Linker flags. Defaults to empty string.
 233
 234         The following need to be set when cross compiling.
 235
 236             BUILD_CC
 237                 The native C compiler.
 238             BUILD_CFLAGS (optional)
 239             BUILD_CPPFLAGS (optional)
 240                 Possible Settings:
 241                 -DNEED_OPTARG=1         (optarg is not declared in <unistd.h>)
 242             BUILD_LDFLAGS (optional)
 243             BUILD_LIBS (optional)
 244
 245         To build shared libraries, specify "--with-libtool" on the
 246         configure command line.
 247
 248         For the server to support DNSSEC, you need to build it
 249         with crypto support.  You must have OpenSSL 0.9.5a
 250         or newer installed and specify "--with-openssl" on the
 251         configure command line.  If OpenSSL is installed under
 252         a nonstandard prefix, you can tell configure where to
 253         look for it using "--with-openssl=/prefix".
 254
 255         On some platforms it is necessary to explictly request large
 256         file support to handle files bigger than 2GB.  This can be
 257         done by "--enable-largefile" on the configure command line.
 258
 259         On some platforms, BIND 9 can be built with multithreading
 260         support, allowing it to take advantage of multiple CPUs.
 261         You can specify whether to build a multithreaded BIND 9
 262         by specifying "--enable-threads" or "--disable-threads"
 263         on the configure command line.  The default is operating
 264         system dependent.
 265
 266         Support for the "fixed" rrset-order option can be enabled
 267         or disabled by specifying "--enable-fixed-rrset" or
 268         "--disable-fixed-rrset" on the configure command line.
 269         The default is "disabled", to reduce memory footprint.
 270
 271         If your operating system has integrated support for IPv6, it
 272         will be used automatically.  If you have installed KAME IPv6
 273         separately, use "--with-kame[=PATH]" to specify its location.
 274
 275         "make install" will install "named" and the various BIND 9 libraries.
 276         By default, installation is into /usr/local, but this can be changed
 277         with the "--prefix" option when running "configure".
 278
 279         You may specify the option "--sysconfdir" to set the directory
 280         where configuration files like "named.conf" go by default,
 281         and "--localstatedir" to set the default parent directory
 282         of "run/named.pid".   For backwards compatibility with BIND 8,
 283         --sysconfdir defaults to "/etc" and --localstatedir defaults to
 284         "/var" if no --prefix option is given.  If there is a --prefix
 285         option, sysconfdir defaults to "$prefix/etc" and localstatedir
 286         defaults to "$prefix/var".
 287
 288         To see additional configure options, run "configure --help".
 289         Note that the help message does not reflect the BIND 8
 290         compatibility defaults for sysconfdir and localstatedir.
 291
 292         If you're planning on making changes to the BIND 9 source, you
 293         should also "make depend".  If you're using Emacs, you might find
 294         "make tags" helpful.
 295
 296         If you need to re-run configure please run "make distclean" first.
 297         This will ensure that all the option changes take.
 298
 299         Building with gcc is not supported, unless gcc is the vendor's usual
 300         compiler (e.g. the various BSD systems, Linux).
 301
 302         Known compiler issues:
 303         * gcc-3.2.1 and gcc-3.1.1 is known to cause problems with solaris-x86.
 304         * gcc prior to gcc-3.2.3 ultrasparc generates incorrect code at -02.
 305         * gcc-3.3.5 powerpc generates incorrect code at -02.
 306         * Irix, MipsPRO 7.4.1m is known to cause problems.
 307
 308         A limited test suite can be run with "make test".  Many of
 309         the tests require you to configure a set of virtual IP addresses
 310         on your system, and some require Perl; see bin/tests/system/README
 311         for details.
 312
 313         SunOS 4 requires "printf" to be installed to make the shared
 314         libraries.  sh-utils-1.16 provides a "printf" which compiles
 315         on SunOS 4.
 316
 317 Documentation
 318
 319         The BIND 9 Administrator Reference Manual is included with the
 320         source distribution in DocBook XML and HTML format, in the
 321         doc/arm directory.
 322
 323         Some of the programs in the BIND 9 distribution have man pages
 324         in their directories.  In particular, the command line
 325         options of "named" are documented in /bin/named/named.8.
 326         There is now also a set of man pages for the lwres library.
 327
 328         If you are upgrading from BIND 8, please read the migration
 329         notes in doc/misc/migration.  If you are upgrading from
 330         BIND 4, read doc/misc/migration-4to9.
 331
 332         Frequently asked questions and their answers can be found in
 333         FAQ.
 334
 335         Additional information on various subjects can be found
 336         in the other README files.
 337
 338
 339 Bug Reports and Mailing Lists
 340
 341         Bugs reports should be sent to
 342
 343                 bind9-bugs@isc.org
 344
 345         To join the BIND Users mailing list, send mail to
 346
 347                 bind-users-request@isc.org
 348
 349         archives of which can be found via
 350
 351                 http://www.isc.org/ops/lists/
 352
 353         If you're planning on making changes to the BIND 9 source
 354         code, you might want to join the BIND Workers mailing list.
 355         Send mail to
 356
 357                 bind-workers-request@isc.org
 358
 359