mirror of
https://github.com/isc-projects/bind9.git
synced 2026-02-20 00:10:43 -05:00
f29359299a
4749. [func] The ISC DLV service has been shut down, and all DLV records have been removed from dlv.isc.org. - Removed references to ISC DLV in documentation - Removed DLV key from bind.keys - No longer use ISC DLV by default in delv [RT #46155]
583 lines
21 KiB
XML
583 lines
21 KiB
XML
<!DOCTYPE book [
|
|
<!ENTITY Scaron "Š">
|
|
<!ENTITY scaron "š">
|
|
<!ENTITY ccaron "č">
|
|
<!ENTITY aacute "á">
|
|
<!ENTITY iacute "í">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY ouml "ö">]>
|
|
<!--
|
|
- Copyright (C) 2014-2017 Internet Systems Consortium, Inc. ("ISC")
|
|
-
|
|
- This Source Code Form is subject to the terms of the Mozilla Public
|
|
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
- file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
-->
|
|
|
|
<section xmlns:db="http://docbook.org/ns/docbook" version="5.0"><info/>
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="noteversion.xml"/>
|
|
<section xml:id="relnotes_intro"><info><title>Introduction</title></info>
|
|
<para>
|
|
BIND 9.12.0 is a new feature release of BIND, still under development.
|
|
This document summarizes new features and functional changes that
|
|
have been introduced on this branch. With each development
|
|
release leading up to the final BIND 9.12.0 release, this document
|
|
will be updated with additional features added and bugs fixed.
|
|
</para>
|
|
</section>
|
|
|
|
<section xml:id="relnotes_download"><info><title>Download</title></info>
|
|
<para>
|
|
The latest versions of BIND 9 software can always be found at
|
|
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.isc.org/downloads/">http://www.isc.org/downloads/</link>.
|
|
There you will find additional information about each release,
|
|
source code, and pre-compiled versions for Microsoft Windows
|
|
operating systems.
|
|
</para>
|
|
</section>
|
|
|
|
<section xml:id="relnotes_license"><info><title>License Change</title></info>
|
|
<para>
|
|
With the release of BIND 9.11.0, ISC changed to the open
|
|
source license for BIND from the ISC license to the Mozilla
|
|
Public License (MPL 2.0).
|
|
</para>
|
|
<para>
|
|
The MPL-2.0 license requires that if you make changes to
|
|
licensed software (e.g. BIND) and distribute them outside
|
|
your organization, that you publish those changes under that
|
|
same license. It does not require that you publish or disclose
|
|
anything other than the changes you made to our software.
|
|
</para>
|
|
<para>
|
|
This requirement will not affect anyone who is using BIND
|
|
without redistributing it, nor anyone redistributing it without
|
|
changes, therefore this change will be without consequence
|
|
for most individuals and organizations who are using BIND.
|
|
</para>
|
|
<para>
|
|
Those unsure whether or not the license change affects their
|
|
use of BIND, or who wish to discuss how to comply with the
|
|
license may contact ISC at <link
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xlink:href="https://www.isc.org/mission/contact/">
|
|
https://www.isc.org/mission/contact/</link>.
|
|
</para>
|
|
</section>
|
|
|
|
<section xml:id="win_support"><info><title>Windows XP No Longer Supported</title></info>
|
|
<para>
|
|
As of BIND 9.11.2, Windows XP is no longer a supported platform for
|
|
BIND, and Windows XP binaries are no longer available for download
|
|
from ISC.
|
|
</para>
|
|
</section>
|
|
|
|
<section xml:id="relnotes_security"><info><title>Security Fixes</title></info>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
None.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
|
|
<section xml:id="relnotes_features"><info><title>New Features</title></info>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Many aspects of <command>named</command> have been modified
|
|
to improve query performance, and in particular, performance
|
|
for delegation-heavy zones:
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
The additional cache ("acache") was found not to
|
|
significantly improve performance and has been removed;
|
|
the <command>acache-enable</command> and
|
|
<command>acache-cleaning-interval</command> options are now
|
|
deprecated.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
In place of the acache, <command>named</command> can now use
|
|
a glue cache to speed up retrieval of glue records when sending
|
|
delegation responses. Unlike acache, this feature is on by
|
|
default; use <command>glue-cache no;</command> to disable it.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The <command>additional-from-cache</command>
|
|
and <command>additional-from-auth</command> options have been
|
|
deprecated.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>minimal-responses</command> is now set
|
|
to <literal>yes</literal> by default.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Several functions have been refactored to improve
|
|
performance, including name compression, owner name
|
|
case restoration, hashing, and buffers.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Several areas of code have been refactored for improved
|
|
readability, maintainability, and testability:
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
The <command>named</command> query logic implemented in
|
|
<command>query_find()</command> has been split into
|
|
smaller functions with a context structure to maintain state
|
|
between them, and extensive comments have been added.
|
|
[RT #43929]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Similarly the iterative query logic implemented in
|
|
<command>resquery_response()</command> function has been
|
|
split into smaller functions and comments added. [RT #45362]
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Code implementing name server query processing has been moved
|
|
from <command>named</command> to an external library,
|
|
<command>libns</command>. This will make it easier to
|
|
write unit tests for the code, or to link it into new tools.
|
|
[RT #45186]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>named</command> can now synthesize negative responses
|
|
(NXDOMAIN, NODATA, or wildcard answers) from cached DNSSEC-verified
|
|
records that were returned in negative or wildcard responses from
|
|
authoritative servers.
|
|
</para>
|
|
<para>
|
|
This will reduce query loads on authoritative servers for signed
|
|
domains: when existing cached records can be used by the resolver
|
|
to determine that a name does not exist in the authorittive domain,
|
|
no query needs to be sent. Reducing the number of iterative queries
|
|
should also improve resolver performance.
|
|
</para>
|
|
<para>
|
|
This behavior is controlled by the new
|
|
<filename>named.conf</filename> option
|
|
<command>synth-from-dnssec</command>. It is enabled by
|
|
default.
|
|
</para>
|
|
<para>
|
|
Note: this currently only works for zones signed using NSEC.
|
|
Support for zones signed using NSEC3 (without opt-out) is
|
|
planned for the future.
|
|
</para>
|
|
<para>
|
|
Thanks to APNIC for sponsoring this work.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
When acting as a recursive resolver, <command>named</command>
|
|
can now continue returning answers whose TTLs have expired
|
|
when the authoritative server is under attack and unable to
|
|
respond. This is controlled by the
|
|
<command>stale-answer-enable</command>,
|
|
<command>stale-answer-ttl</command> and
|
|
<command>max-stale-ttl</command> options. [RT #44790]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The DNS Response Policy Service (DNSRPS) API, a mechanism to
|
|
allow <command>named</command> to use an external response policy
|
|
provider, is now supported. (One example of such a provider is
|
|
"FastRPZ" from Farsight Security, Inc.) This allows the same
|
|
types of policy filtering as standard RPZ, but can reduce the
|
|
workload for <command>named</command>, particularly when using
|
|
large and frequently-updated policy zones. It also enables
|
|
<command>named</command> to share response policy providers
|
|
with other DNS implementations such as Unbound.
|
|
</para>
|
|
<para>
|
|
This feature is avaiable if BIND is built with
|
|
<command>configure --enable-dnsrps</command>, if a DNSRPS
|
|
provider is installed, and if <command>dnsrps-enable</command>
|
|
is set to "yes" in <filename>named.conf</filename>. Standard
|
|
built-in RPZ is used otherwise.
|
|
</para>
|
|
<para>
|
|
Thanks to Vernon Schryver and Farsight Security for the
|
|
contribution. [RT #43376]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Setting <command>max-journal-size</command> to
|
|
<literal>default</literal> limits journal sizes to twice the
|
|
size of the zone contents. This can be overridden by setting
|
|
<command>max-journal-size</command> to <literal>unlimited</literal>
|
|
or to an explicit value up to 2G. Thanks to Tony Finch for
|
|
the contribution. [RT #38324]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>dnstap</command> logfiles can now be configured to
|
|
automatically roll when they reach a specified size. If
|
|
<command>dnstap-output</command> is configured with mode
|
|
<literal>file</literal>, then it can take optional
|
|
<command>size</command> and <command>versions</command>
|
|
key-value arguments to set the logfile rolling parameters.
|
|
(These have the same semantics as the corresponding
|
|
options in a <command>logging</command> channel statement.)
|
|
[RT #44502]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Logging channels and <command>dnstap-output</command> files can
|
|
now be configured with a <command>suffix</command> option,
|
|
set to either <literal>increment</literal> or
|
|
<literal>timestamp</literal>, indicating whether log files
|
|
should be given incrementing suffixes when they roll
|
|
over (e.g., <filename>logfile.0</filename>,
|
|
<filename>.1</filename>, <filename>.2</filename>, etc)
|
|
or suffixes indicating the time of the roll. The default
|
|
is <literal>increment</literal>. [RT #42838]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The <command>print-time</command> option in the
|
|
<command>logging</command> configuration can now take arguments
|
|
<userinput>local</userinput>, <userinput>iso8601</userinput> or
|
|
<userinput>iso8601-utc</userinput> to indicate the format in
|
|
which the date and time should be logged. For backward
|
|
compatibility, <userinput>yes</userinput> is a synonym for
|
|
<userinput>local</userinput>. [RT #42585]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>nsupdate</command> and <command>rndc</command> now accepts
|
|
command line options <command>-4</command> and <command>-6</command>
|
|
which force using only IPv4 or only IPv6, respectively. [RT #45632]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>nsec3hash -r</command> ("rdata order") takes arguments
|
|
in the same order as they appear in NSEC3 or NSEC3PARAM records.
|
|
This makes it easier to generate an NSEC3 hash using values cut
|
|
and pasted from an existing record. Thanks to Tony Finch for
|
|
the contribution. [RT #45183]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The <command>new-zones-directory</command> option allows
|
|
<command>named</command> to store configuration parameters
|
|
for zones added via <command>rndc addzone</command> in a
|
|
location other than the working directory. Thanks to Petr
|
|
Menšík of Red Hat for the contribution.
|
|
[RT #44853]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The <command>dnstap-read -x</command> option prints a hex
|
|
dump of the wire format DNS message encapsulated in each
|
|
<command>dnstap</command> log entry. [RT #44816]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The <command>host -A</command> option returns most
|
|
records for a name, but omits types RRSIG, NSEC and NSEC3.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>dig +ednsopt</command> now accepts the names
|
|
for EDNS options in addition to numeric values. For example,
|
|
an EDNS Client-Subnet option could be sent using
|
|
<command>dig +ednsopt=ecs:...</command>. Thanks to
|
|
John Worley of Secure64 for the contribution. [RT #44461]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Added support for the EDNS TCP Keepalive option (RFC 7828);
|
|
this allows negotiation of longer-lived TCP sessions
|
|
to reduce the overhead of setting up TCP for individual
|
|
queries. [RT #42126]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Added support for the EDNS Padding option (RFC 7830),
|
|
which obfuscates packet size analysis when DNS queries
|
|
are sent over an encrypted channel. [RT #42094]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>rndc</command> commands which refer to zone names
|
|
can now reference a zone of type <command>redirect</command>
|
|
by using the special zone name "-redirect". (Previously this
|
|
was not possible because <command>redirect</command> zones
|
|
always have the name ".", which can be ambiguous.)
|
|
</para>
|
|
<para>
|
|
In the event you need to manipulate a zone actually
|
|
called "-redirect", use a trailing dot: "-redirect."
|
|
</para>
|
|
<para>
|
|
Note: This change does not appply to the
|
|
<command>rndc addzone</command> or
|
|
<command>rndc modzone</command> commands.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>named-checkconf -l</command> lists the zones found
|
|
in <filename>named.conf</filename>. [RT #43154]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Query logging now includes the ECS option, if one was
|
|
present in the query, in the format
|
|
"[ECS <replaceable>address/source/scope</replaceable>]".
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
By default, BIND now uses the random number generation functions
|
|
in the cryptographic library (i.e., OpenSSL or a PKCS#11
|
|
provider) as a source of high-quality randomness rather than
|
|
<filename>/dev/random</filename>. This is suitable for virtual
|
|
machine environments, which may have limited entropy pools and
|
|
lack hardware random number generators.
|
|
</para>
|
|
<para>
|
|
This can be overridden by specifying another entropy source via
|
|
the <command>random-device</command> option in
|
|
<filename>named.conf</filename>, or via the <command>-r</command>
|
|
command line option. However, for functions requiring full
|
|
cryptographic strength, such as DNSSEC key generation, this
|
|
<emphasis>cannot</emphasis> be overridden. In particular, the
|
|
<command>-r</command> command line option no longer has any
|
|
effect on <command>dnssec-keygen</command>.
|
|
</para>
|
|
<para>
|
|
This can be disabled by building with
|
|
<command>configure --disable-crypto-rand</command>, in which
|
|
case <filename>/dev/random</filename> will be the default
|
|
entropy source. [RT #31459] [RT #46047]
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
|
|
<section xml:id="proto_changes"><info><title>Protocol Changes</title></info>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
BIND can now use the Ed25519 and Ed448 Edwards Curve DNSSEC
|
|
signing algorithms described in RFC 8080. Note, however, that
|
|
these algorithms must be supported in OpenSSL;
|
|
currently they are only available in the development branch
|
|
of OpenSSL at
|
|
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/openssl/openssl">https://github.com/openssl/openssl</link>.
|
|
[RT #44696]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
EDNS KEY TAG options are verified and printed.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
|
|
<section xml:id="relnotes_changes"><info><title>Feature Changes</title></info>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
The ISC DNSSEC Lookaside Validation (DLV) service has been shut
|
|
down; all DLV records in the dlv.isc.org zone have been removed.
|
|
References to the service have been removed from BIND documentation.
|
|
Lookaside validation is no longer used by default by
|
|
<command>delv</command>. The DLV key has been removed from
|
|
<filename>bind.keys</command>. Setting
|
|
<command>dnssec-lookaside</command> set to
|
|
<command>auto</command> or to use dlv.isc.org as a trust
|
|
anchor is now a fatal configuration error. [RT #46155]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The lightweight resolver daemon and library (<command>lwresd</command>
|
|
and <command>liblwres</command>) have been removed. [RT #45186]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>dnssec-keygen</command> no longer has default
|
|
algorithm settings. It is necessary to explicitly specify the
|
|
algorithm on the command line with the <command>-a</command> option
|
|
when generating keys. This may cause errors with existing signing
|
|
scripts if they rely on current defaults. The intent is to
|
|
reduce the long-term cost of transitioning to newer algorithms in
|
|
the event of RSASHA1 being deprecated. [RT #44755]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>dig +sigchase</command> and related options
|
|
<command>+trusted-keys</command> and <command>+topdown</command>
|
|
have been removed. <command>delv</command> is now the recommended
|
|
command for looking up records with DNSSEC validation.
|
|
[RT #42793]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The Response Policy Zone (RPZ) implementation has been
|
|
substantially refactored: updates to the RPZ summary
|
|
database are no longer directly performed by the zone
|
|
database but by a separate function that is called when
|
|
a policy zone is updated. This improves both performance
|
|
and reliability when policy zones receive frequent updates.
|
|
Summary database updates can be rate-limited by using the
|
|
<command>min-update-interval</command> option in a
|
|
<command>response-policy</command> statement. [RT #43449]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>dnstap</command> now stores both the local and remote
|
|
addresses for all messages, instead of only the remote address.
|
|
The default output format for <command>dnstap-read</command> has
|
|
been updated to include these addresses, with the initiating
|
|
address first and the responding address second, separated by
|
|
"->" or "<-" to indicate in which direction the message
|
|
was sent. [RT #43595]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Expanded and improved the YAML output from
|
|
<command>dnstap-read -y</command>: it now includes packet
|
|
size and a detailed breakdown of message contents.
|
|
[RT #43622] [RT #43642]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Threads in <command>named</command> are now set to human-readable
|
|
names to assist debugging on operating systems that support that.
|
|
Threads will have names such as "isc-timer", "isc-sockmgr",
|
|
"isc-worker0001", and so on. This will affect the reporting of
|
|
subsidiary thread names in <command>ps</command> and
|
|
<command>top</command>, but not the main thread. [RT #43234]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
If an ACL is specified with an address prefix in which the
|
|
prefix length is longer than the address portion (for example,
|
|
192.0.2.1/8), it will now be treated as a fatal error during
|
|
configuration. [RT #43367]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<command>dig</command> now warns about .local queries which are
|
|
reserved for Multicast DNS. [RT #44783]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The view associated with the query is now logged unless it
|
|
it is "_default/IN" or "_dnsclient/IN" when logging DNSSEC
|
|
validator messages.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Multiple <command>cookie-secret</command> clauses are now
|
|
supported. The first <command>cookie-secret</command> in
|
|
<filename>named.conf</filename> is used to generate new
|
|
server cookies. Any others are used to accept old server
|
|
cookies or those generated by other servers using the
|
|
matching <command>cookie-secret</command>.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
A new statistics counter has been added to track prefetch
|
|
queries. [RT #45847]
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The <command>dnssec-signzone -x</command> flag and the
|
|
<command>dnssec-dnskey-kskonly</command> option in
|
|
<command>named.conf</command>, which suppress the use of
|
|
the ZSK when signing DNSKEY records, now also apply to
|
|
CDNSKEY and CDS records. Thanks to Tony Finch for the
|
|
contribution. [RT #45689]
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
|
|
<section xml:id="relnotes_bugs"><info><title>Bug Fixes</title></info>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
The introduction of <command>libns</command> caused a bug
|
|
in which TCP client objects were not recycled after use,
|
|
leading to unconstrained memory growth. [RT #46029]
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
|
|
<section xml:id="end_of_life"><info><title>End of Life</title></info>
|
|
<para>
|
|
The end of life for BIND 9.12 is yet to be determined but
|
|
will not be before BIND 9.14.0 has been released for 6 months.
|
|
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.isc.org/downloads/software-support-policy/">https://www.isc.org/downloads/software-support-policy/</link>
|
|
</para>
|
|
</section>
|
|
<section xml:id="relnotes_thanks"><info><title>Thank You</title></info>
|
|
|
|
<para>
|
|
Thank you to everyone who assisted us in making this release possible.
|
|
If you would like to contribute to ISC to assist us in continuing to
|
|
make quality open source software, please visit our donations page at
|
|
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.isc.org/donate/">http://www.isc.org/donate/</link>.
|
|
</para>
|
|
</section>
|
|
</section>
|