.. Copyright (C) Internet Systems Consortium, Inc. ("ISC")
..
.. SPDX-License-Identifier: MPL-2.0
..
.. 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 https://mozilla.org/MPL/2.0/.
..
.. See the COPYRIGHT file distributed with this work for additional
.. information regarding copyright ownership.

Notes for BIND 9.17.11
----------------------

New Features
~~~~~~~~~~~~

- :iscman:`dig` has been extended to support DNS-over-HTTPS (DoH) queries,
  using ``dig +https`` and related options. :gl:`#1641`

- A new ``purge-keys`` option has been added to ``dnssec-policy``. It
  sets the period of time that key files are retained after becoming
  obsolete due to a key rollover; the default is 90 days. This feature
  can be disabled by setting ``purge-keys`` to 0. :gl:`#2408`

Feature Changes
~~~~~~~~~~~~~~~

- To prevent users from inadvertently configuring unencrypted
  DNS-over-HTTPS (DoH) in BIND 9, ``listen-on`` and ``listen-on-v6``
  statements using the ``http`` parameter must now also specify the
  ``tls`` parameter. ``tls none`` can be used to explicitly allow
  unencrypted HTTP connections. :gl:`#2472`

- ``http default`` can now be specified in ``listen-on`` and
  ``listen-on-v6`` statements to use the default HTTP endpoint of
  ``/dns-query``. It is no longer necessary to include an ``http``
  statement in :iscman:`named.conf` unless overriding this value. :gl:`#2472`

Bug Fixes
~~~~~~~~~

- Zone journal (``.jnl``) files created by versions of :iscman:`named` prior
  to 9.16.12 were no longer compatible; this could cause problems when
  upgrading if journal files were not synchronized first. This has been
  corrected: older journal files can now be read when starting up. When
  an old-style journal file is detected, it is updated to the new format
  immediately after loading.

  Note that journals created by the current version of :iscman:`named` are not
  usable by versions prior to 9.16.12. Before downgrading to a prior
  release, users are advised to ensure that all dynamic zones have been
  synchronized using :option:`rndc sync -clean <rndc sync>`.

  A journal file's format can be changed manually by running
  ``named-journalprint -d`` (downgrade) or ``named-journalprint -u``
  (upgrade). Note that this *must not* be done while :iscman:`named` is
  running. :gl:`#2505`

- :iscman:`named` crashed when it was allowed to serve stale answers and
  ``stale-answer-client-timeout`` was triggered without any (stale) data
  available in the cache to answer the query. :gl:`#2503`

- If an outgoing packet exceeded ``max-udp-size``, :iscman:`named` dropped it
  instead of sending back a proper response. To prevent this problem,
  the ``IP_DONTFRAG`` option is no longer set on UDP sockets, which has
  been happening since BIND 9.17.6. :gl:`#2466`

- NSEC3 records were not immediately created when signing a dynamic zone
  using ``dnssec-policy`` with ``nsec3param``. This has been fixed.
  :gl:`#2498`

- A memory leak occurred when :iscman:`named` was reconfigured after adding an
  inline-signed zone with ``auto-dnssec maintain`` enabled. This has
  been fixed. :gl:`#2041`

- An invalid direction field (not one of ``N``, ``S``, ``E``, ``W``) in
  a LOC record resulted in an INSIST failure when a zone file containing
  such a record was loaded. :gl:`#2499`

- If an invalid key name (e.g. ``a..b``) was specified in a
  ``primaries`` list in :iscman:`named.conf`, the wrong size was passed to
  ``isc_mem_put()``, which resulted in the returned memory being put on
  the wrong free list and prevented :iscman:`named` from starting up. This has
  been fixed. :gl:`#2460`

- ``libtool`` was inadvertently introduced as a build-time requirement
  when the build system was revamped in BIND 9.17.2. This unnecessarily
  prevented hosts without that tool from building BIND 9 from source
  tarballs. A standalone ``libtool`` script no longer needs to be
  present in ``PATH`` to build BIND 9 from a source tarball. :gl:`#2504`
