From 384b413dc527e0a4118142ba6ddba4e80cc797d0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20K=C4=99pie=C5=84?= <michal@isc.org>
Date: Wed, 11 Mar 2020 09:06:40 +0100
Subject: [PATCH] Add release note about controlling source ports

---
 doc/arm/notes-9.17.0.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/arm/notes-9.17.0.xml b/doc/arm/notes-9.17.0.xml
index fe22b09470..c3348fc73f 100644
--- a/doc/arm/notes-9.17.0.xml
+++ b/doc/arm/notes-9.17.0.xml
@@ -11,6 +11,25 @@
 
 <section xml:id="relnotes-9.17.0"><info><title>Notes for BIND 9.17.0</title></info>
 
+  <section xml:id="relnotes-9.17.0-known"><info><title>Known Issues</title></info>
+    <itemizedlist>
+      <listitem>
+        <para>
+          UDP network ports used for listening can no longer simultaneously be
+          used for sending traffic.  An example configuration which triggers
+          this issue would be one which uses the same
+          <replaceable>address:port</replaceable> pair for
+          <command>listen-on(-v6)</command> statements as for
+          <command>notify-source(-v6)</command> or
+          <command>transfer-source(-v6)</command>.  While this issue affects all
+          operating systems, it only triggers log messages (e.g. "unable to
+          create dispatch for reserved port") on some of them.  There are
+          currently no plans to make such a combination of settings work again.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </section>
+
   <section xml:id="relnotes-9.17.0-changes"><info><title>Feature Changes</title></info>
     <itemizedlist>
       <listitem>