mark "port" as deprecated for source address options

Deprecate the use of "port" when configuring query-source(-v6),
transfer-source(-v6), notify-source(-v6), parental-source(-v6),
etc. Also deprecate use-{v4,v6}-udp-ports and avoid-{v4,v6}udp-ports.

bin/tests/system/checkconf/tests.sh

@@ -430,6 +430,7 @@ n=`expr $n + 1`
 echo_i "check that named-checkconf -l prints out the zone list ($n)"
 ret=0
 $CHECKCONF -l good.conf |
+grep -v "is deprecated" |
 grep -v "is not implemented" |
 grep -v "is not recommended" |
 grep -v "no longer exists" |

doc/arm/reference.rst

@@ -3261,11 +3261,11 @@ Query Address
 
 .. namedconf:statement:: query-source
    :tags: query
-   :short: Controls the IPv4 address and port from which queries are issued.
+   :short: Controls the IPv4 address from which queries are issued.
 
 .. namedconf:statement:: query-source-v6
    :tags: query
-   :short: Controls the IPv6 address and port from which queries are issued.
+   :short: Controls the IPv6 address from which queries are issued.
 
    If the server does not know the answer to a question, it queries other
    name servers. :any:`query-source` specifies the address and port used for
@@ -3281,20 +3281,24 @@ Query Address
       query-source address * port *;
       query-source-v6 address * port *;
 
-   .. note:: The address specified in the :any:`query-source` option is used for both
-      UDP and TCP queries, but the port applies only to UDP queries. TCP
-      queries always use a random unprivileged port.
+   .. note:: ``port`` configuration is deprecated. A warning will be logged
+      when this parameter is used.
+
+   .. note:: The address specified in the :any:`query-source` option is
+      used for both UDP and TCP queries, but the port applies only to UDP
+      queries. TCP queries always use a random unprivileged port.
 
 .. namedconf:statement:: use-v4-udp-ports
-   :tags: query
+   :tags: deprecated
    :short: Specifies a list of ports that are valid sources for UDP/IPv4 messages.
 
 .. namedconf:statement:: use-v6-udp-ports
-   :tags: query
+   :tags: deprecated
    :short: Specifies a list of ports that are valid sources for UDP/IPv6 messages.
 
-   These statements specify a list of IPv4 and IPv6 UDP ports that
-   are used as source ports for UDP messages.
+   These statements, which are deprecated and will be removed in a future
+   release, specify a list of IPv4 and IPv6 UDP ports that are used as
+   source ports for UDP messages.
 
    If :term:`port` is ``*`` or is omitted, a random port number from a
    pre-configured range is selected and used for each query. The
@@ -3313,15 +3317,16 @@ Query Address
       use-v6-udp-ports { range 1024 65535; };
 
 .. namedconf:statement:: avoid-v4-udp-ports
-   :tags: query
+   :tags: deprecated
    :short: Specifies the range(s) of ports to be excluded from use as sources for UDP/IPv4 messages.
 
 .. namedconf:statement:: avoid-v6-udp-ports
-   :tags: query
+   :tags: deprecated
    :short: Specifies the range(s) of ports to be excluded from use as sources for UDP/IPv6 messages.
 
-   These ranges are excluded from those
-   specified in the :any:`avoid-v4-udp-ports` and :any:`avoid-v6-udp-ports`
+   These statements, which are deprecated and will be removed in a future
+   release, specific ranges of port numbers to exclude from those specified
+   in the :any:`avoid-v4-udp-ports` and :any:`avoid-v6-udp-ports`
    options, respectively.
 
    The defaults of the :any:`avoid-v4-udp-ports` and :any:`avoid-v6-udp-ports`
@@ -3553,6 +3558,9 @@ options apply to zone transfers.
    :any:`transfer-source` statement within the :any:`view` or :any:`zone` block
    in the configuration file.
 
+   .. note:: ``port`` configuration is deprecated. A warning will be logged
+      when this parameter is used.
+
    .. warning:: Specifying a single port is discouraged, as it removes a layer of
       protection against spoofing errors.
 
@@ -3562,8 +3570,8 @@ options apply to zone transfers.
    :tags: transfer
    :short: Defines which local IPv6 address(es) are bound to TCP connections used to fetch zones transferred inbound by the server.
 
-   This option is the same as :any:`transfer-source`, except zone transfers are performed
-   using IPv6.
+   This option is the same as :any:`transfer-source`, except zone transfers
+   are performed using IPv6.
 
 .. namedconf:statement:: notify-source
    :tags: transfer
@@ -3577,6 +3585,9 @@ options apply to zone transfers.
    or per-view basis by including a :any:`notify-source` statement within
    the :any:`zone` or :any:`view` block in the configuration file.
 
+   .. note:: ``port`` configuration is deprecated. A warning will be logged
+      when this parameter is used.
+
    .. warning:: Specifying a single port is discouraged, as it removes a layer of
       protection against spoofing errors.
 
@@ -6468,6 +6479,9 @@ The following options apply to DS queries sent to :any:`parental-agents`:
    per-view basis by including a :any:`parental-source` statement within the
    :any:`zone` or :any:`view` block in the configuration file.
 
+   .. note:: ``port`` configuration is deprecated. A warning will be logged
+      when this parameter is used.
+
    .. warning:: Specifying a single port is discouraged, as it removes a layer of
       protection against spoofing errors.
 

doc/man/named.conf.5in

@@ -126,17 +126,17 @@ options {
 	allow\-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow\-update { <address_match_element>; ... };
 	allow\-update\-forwarding { <address_match_element>; ... };
-	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	answer\-cookie <boolean>;
 	attach\-cache <string>;
 	auth\-nxdomain <boolean>;
 	auto\-dnssec ( allow | maintain | off ); // deprecated
 	automatic\-interface\-scan <boolean>;
-	avoid\-v4\-udp\-ports { <portrange>; ... };
-	avoid\-v6\-udp\-ports { <portrange>; ... };
+	avoid\-v4\-udp\-ports { <portrange>; ... }; // deprecated
+	avoid\-v6\-udp\-ports { <portrange>; ... }; // deprecated
 	bindkeys\-file <quoted_string>;
 	blackhole { <address_match_element>; ... };
-	catalog\-zones { zone <string> [ default\-primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone\-directory <quoted_string> ] [ in\-memory <boolean> ] [ min\-update\-interval <duration> ]; ... };
+	catalog\-zones { zone <string> [ default\-primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone\-directory <quoted_string> ] [ in\-memory <boolean> ] [ min\-update\-interval <duration> ]; ... };
 	check\-dup\-records ( fail | warn | ignore );
 	check\-integrity <boolean>;
 	check\-mx ( fail | warn | ignore );
@@ -259,23 +259,23 @@ options {
 	notify ( explicit | master\-only | primary\-only | <boolean> );
 	notify\-delay <integer>;
 	notify\-rate <integer>;
-	notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify\-source ( <ipv4_address> | * ) ;
+	notify\-source\-v6 ( <ipv6_address> | * ) ;
 	notify\-to\-soa <boolean>;
 	nsec3\-test\-zone <boolean>; // test only
 	nta\-lifetime <duration>;
 	nta\-recheck <duration>;
 	nxdomain\-redirect <string>;
-	parental\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	parental\-source ( <ipv4_address> | * ) ;
+	parental\-source\-v6 ( <ipv6_address> | * ) ;
 	pid\-file ( <quoted_string> | none );
 	port <integer>;
 	preferred\-glue <string>;
 	prefetch <integer> [ <integer> ];
 	provide\-ixfr <boolean>;
 	qname\-minimization ( strict | relaxed | disabled | off );
-	query\-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-	query\-source\-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+	query\-source [ address ] ( <ipv4_address> | * );
+	query\-source\-v6 [ address ] ( <ipv6_address> | * );
 	querylog <boolean>;
 	rate\-limit {
 		all\-per\-second <integer>;
@@ -349,8 +349,8 @@ options {
 	tls\-port <integer>;
 	transfer\-format ( many\-answers | one\-answer );
 	transfer\-message\-size <integer>;
-	transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer\-source ( <ipv4_address> | * ) ;
+	transfer\-source\-v6 ( <ipv6_address> | * ) ;
 	transfers\-in <integer>;
 	transfers\-out <integer>;
 	transfers\-per\-ns <integer>;
@@ -359,8 +359,8 @@ options {
 	udp\-receive\-buffer <integer>;
 	udp\-send\-buffer <integer>;
 	update\-check\-ksk <boolean>;
-	use\-v4\-udp\-ports { <portrange>; ... };
-	use\-v6\-udp\-ports { <portrange>; ... };
+	use\-v4\-udp\-ports { <portrange>; ... }; // deprecated
+	use\-v6\-udp\-ports { <portrange>; ... }; // deprecated
 	v6\-bias <integer>;
 	validate\-except { <string>; ... };
 	version ( <quoted_string> | none );
@@ -369,11 +369,11 @@ options {
 	zone\-statistics ( full | terse | none | <boolean> );
 };
 
-parental\-agents <string> [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
+parental\-agents <string> [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
 
 plugin ( query ) <string> [ { <unspecified\-text> } ]; // may occur multiple times
 
-primaries <string> [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
+primaries <string> [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
 
 server <netprefix> {
 	bogus <boolean>;
@@ -382,12 +382,12 @@ server <netprefix> {
 	edns\-version <integer>;
 	keys <server_key>;
 	max\-udp\-size <integer>;
-	notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify\-source ( <ipv4_address> | * ) ;
+	notify\-source\-v6 ( <ipv6_address> | * ) ;
 	padding <integer>;
 	provide\-ixfr <boolean>;
-	query\-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-	query\-source\-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+	query\-source [ address ] ( <ipv4_address> | * );
+	query\-source\-v6 [ address ] ( <ipv6_address> | * );
 	request\-expire <boolean>;
 	request\-ixfr <boolean>;
 	request\-nsid <boolean>;
@@ -396,8 +396,8 @@ server <netprefix> {
 	tcp\-keepalive <boolean>;
 	tcp\-only <boolean>;
 	transfer\-format ( many\-answers | one\-answer );
-	transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer\-source ( <ipv4_address> | * ) ;
+	transfer\-source\-v6 ( <ipv6_address> | * ) ;
 	transfers <integer>;
 }; // may occur multiple times
 
@@ -433,11 +433,11 @@ view <string> [ <class> ] {
 	allow\-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow\-update { <address_match_element>; ... };
 	allow\-update\-forwarding { <address_match_element>; ... };
-	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	attach\-cache <string>;
 	auth\-nxdomain <boolean>;
 	auto\-dnssec ( allow | maintain | off ); // deprecated
-	catalog\-zones { zone <string> [ default\-primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone\-directory <quoted_string> ] [ in\-memory <boolean> ] [ min\-update\-interval <duration> ]; ... };
+	catalog\-zones { zone <string> [ default\-primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone\-directory <quoted_string> ] [ in\-memory <boolean> ] [ min\-update\-interval <duration> ]; ... };
 	check\-dup\-records ( fail | warn | ignore );
 	check\-integrity <boolean>;
 	check\-mx ( fail | warn | ignore );
@@ -540,22 +540,22 @@ view <string> [ <class> ] {
 	nocookie\-udp\-size <integer>;
 	notify ( explicit | master\-only | primary\-only | <boolean> );
 	notify\-delay <integer>;
-	notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify\-source ( <ipv4_address> | * ) ;
+	notify\-source\-v6 ( <ipv6_address> | * ) ;
 	notify\-to\-soa <boolean>;
 	nsec3\-test\-zone <boolean>; // test only
 	nta\-lifetime <duration>;
 	nta\-recheck <duration>;
 	nxdomain\-redirect <string>;
-	parental\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	parental\-source ( <ipv4_address> | * ) ;
+	parental\-source\-v6 ( <ipv6_address> | * ) ;
 	plugin ( query ) <string> [ { <unspecified\-text> } ]; // may occur multiple times
 	preferred\-glue <string>;
 	prefetch <integer> [ <integer> ];
 	provide\-ixfr <boolean>;
 	qname\-minimization ( strict | relaxed | disabled | off );
-	query\-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-	query\-source\-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+	query\-source [ address ] ( <ipv4_address> | * );
+	query\-source\-v6 [ address ] ( <ipv6_address> | * );
 	rate\-limit {
 		all\-per\-second <integer>;
 		errors\-per\-second <integer>;
@@ -595,12 +595,12 @@ view <string> [ <class> ] {
 		edns\-version <integer>;
 		keys <server_key>;
 		max\-udp\-size <integer>;
-		notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-		notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+		notify\-source ( <ipv4_address> | * ) ;
+		notify\-source\-v6 ( <ipv6_address> | * ) ;
 		padding <integer>;
 		provide\-ixfr <boolean>;
-		query\-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-		query\-source\-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+		query\-source [ address ] ( <ipv4_address> | * );
+		query\-source\-v6 [ address ] ( <ipv6_address> | * );
 		request\-expire <boolean>;
 		request\-ixfr <boolean>;
 		request\-nsid <boolean>;
@@ -609,8 +609,8 @@ view <string> [ <class> ] {
 		tcp\-keepalive <boolean>;
 		tcp\-only <boolean>;
 		transfer\-format ( many\-answers | one\-answer );
-		transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-		transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+		transfer\-source ( <ipv4_address> | * ) ;
+		transfer\-source\-v6 ( <ipv6_address> | * ) ;
 		transfers <integer>;
 	}; // may occur multiple times
 	servfail\-ttl <duration>;
@@ -627,8 +627,8 @@ view <string> [ <class> ] {
 	suppress\-initial\-notify <boolean>; // obsolete
 	synth\-from\-dnssec <boolean>;
 	transfer\-format ( many\-answers | one\-answer );
-	transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer\-source ( <ipv4_address> | * ) ;
+	transfer\-source\-v6 ( <ipv6_address> | * ) ;
 	trust\-anchor\-telemetry <boolean>; // experimental
 	trust\-anchors { <string> ( static\-key | initial\-key | static\-ds | initial\-ds ) <integer> <integer> <integer> <quoted_string>; ... }; // may occur multiple times
 	trusted\-keys { <string> <integer> <integer> <integer> <quoted_string>; ... }; // may occur multiple times, deprecated
@@ -659,7 +659,7 @@ zone <string> [ <class> ] {
 	allow\-query\-on { <address_match_element>; ... };
 	allow\-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow\-update { <address_match_element>; ... };
-	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	auto\-dnssec ( allow | maintain | off ); // deprecated
 	check\-dup\-records ( fail | warn | ignore );
 	check\-integrity <boolean>;
@@ -697,13 +697,13 @@ zone <string> [ <class> ] {
 	max\-zone\-ttl ( unlimited | <duration> ); // deprecated
 	notify ( explicit | master\-only | primary\-only | <boolean> );
 	notify\-delay <integer>;
-	notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify\-source ( <ipv4_address> | * ) ;
+	notify\-source\-v6 ( <ipv6_address> | * ) ;
 	notify\-to\-soa <boolean>;
 	nsec3\-test\-zone <boolean>; // test only
-	parental\-agents [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
-	parental\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	parental\-agents [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	parental\-source ( <ipv4_address> | * ) ;
+	parental\-source\-v6 ( <ipv6_address> | * ) ;
 	serial\-update\-method ( date | increment | unixtime );
 	sig\-signing\-nodes <integer>;
 	sig\-signing\-signatures <integer>;
@@ -731,7 +731,7 @@ zone <string> [ <class> ] {
 	allow\-query\-on { <address_match_element>; ... };
 	allow\-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow\-update\-forwarding { <address_match_element>; ... };
-	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	auto\-dnssec ( allow | maintain | off ); // deprecated
 	check\-names ( fail | warn | ignore );
 	database <string>;
@@ -765,22 +765,22 @@ zone <string> [ <class> ] {
 	multi\-master <boolean>;
 	notify ( explicit | master\-only | primary\-only | <boolean> );
 	notify\-delay <integer>;
-	notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify\-source ( <ipv4_address> | * ) ;
+	notify\-source\-v6 ( <ipv6_address> | * ) ;
 	notify\-to\-soa <boolean>;
 	nsec3\-test\-zone <boolean>; // test only
-	parental\-agents [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
-	parental\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	parental\-agents [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	parental\-source ( <ipv4_address> | * ) ;
+	parental\-source\-v6 ( <ipv6_address> | * ) ;
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	request\-expire <boolean>;
 	request\-ixfr <boolean>;
 	sig\-signing\-nodes <integer>;
 	sig\-signing\-signatures <integer>;
 	sig\-signing\-type <integer>;
 	sig\-validity\-interval <integer> [ <integer> ];
-	transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer\-source ( <ipv4_address> | * ) ;
+	transfer\-source\-v6 ( <ipv6_address> | * ) ;
 	try\-tcp\-refresh <boolean>;
 	update\-check\-ksk <boolean>;
 	zero\-no\-soa\-ttl <boolean>;
@@ -803,7 +803,7 @@ zone <string> [ <class> ] {
 	allow\-query\-on { <address_match_element>; ... };
 	allow\-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow\-update\-forwarding { <address_match_element>; ... };
-	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also\-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	check\-names ( fail | warn | ignore );
 	database <string>;
 	file <quoted_string>;
@@ -825,13 +825,13 @@ zone <string> [ <class> ] {
 	multi\-master <boolean>;
 	notify ( explicit | master\-only | primary\-only | <boolean> );
 	notify\-delay <integer>;
-	notify\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	notify\-source ( <ipv4_address> | * ) ;
+	notify\-source\-v6 ( <ipv6_address> | * ) ;
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	request\-expire <boolean>;
 	request\-ixfr <boolean>;
-	transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer\-source ( <ipv4_address> | * ) ;
+	transfer\-source\-v6 ( <ipv6_address> | * ) ;
 	try\-tcp\-refresh <boolean>;
 	zero\-no\-soa\-ttl <boolean>;
 	zone\-statistics ( full | terse | none | <boolean> );
@@ -888,7 +888,7 @@ zone <string> [ <class> ] {
 	masterfile\-style ( full | relative );
 	max\-records <integer>;
 	max\-zone\-ttl ( unlimited | <duration> ); // deprecated
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	zone\-statistics ( full | terse | none | <boolean> );
 };
 
@@ -943,9 +943,9 @@ zone <string> [ <class> ] {
 	min\-refresh\-time <integer>;
 	min\-retry\-time <integer>;
 	multi\-master <boolean>;
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
-	transfer\-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer\-source\-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source\-v6 ( <ipv6_address> | * )  ] { ( <remote\-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	transfer\-source ( <ipv4_address> | * ) ;
+	transfer\-source\-v6 ( <ipv6_address> | * ) ;
 	zone\-statistics ( full | terse | none | <boolean> );
 };
 

doc/misc/mirror.zoneopt

@@ -5,7 +5,7 @@ zone <string> [ <class> ] {
 	allow-query-on { <address_match_element>; ... };
 	allow-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow-update-forwarding { <address_match_element>; ... };
-	also-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	check-names ( fail | warn | ignore );
 	database <string>;
 	file <quoted_string>;
@@ -27,13 +27,13 @@ zone <string> [ <class> ] {
 	multi-master <boolean>;
 	notify ( explicit | master-only | primary-only | <boolean> );
 	notify-delay <integer>;
-	notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	notify-source ( <ipv4_address> | * ) ;
+	notify-source-v6 ( <ipv6_address> | * ) ;
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	request-expire <boolean>;
 	request-ixfr <boolean>;
-	transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer-source ( <ipv4_address> | * ) ;
+	transfer-source-v6 ( <ipv6_address> | * ) ;
 	try-tcp-refresh <boolean>;
 	zero-no-soa-ttl <boolean>;
 	zone-statistics ( full | terse | none | <boolean> );

doc/misc/options

@@ -69,17 +69,17 @@ options {
 	allow-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow-update { <address_match_element>; ... };
 	allow-update-forwarding { <address_match_element>; ... };
-	also-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	answer-cookie <boolean>;
 	attach-cache <string>;
 	auth-nxdomain <boolean>;
 	auto-dnssec ( allow | maintain | off ); // deprecated
 	automatic-interface-scan <boolean>;
-	avoid-v4-udp-ports { <portrange>; ... };
-	avoid-v6-udp-ports { <portrange>; ... };
+	avoid-v4-udp-ports { <portrange>; ... }; // deprecated
+	avoid-v6-udp-ports { <portrange>; ... }; // deprecated
 	bindkeys-file <quoted_string>;
 	blackhole { <address_match_element>; ... };
-	catalog-zones { zone <string> [ default-primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone-directory <quoted_string> ] [ in-memory <boolean> ] [ min-update-interval <duration> ]; ... };
+	catalog-zones { zone <string> [ default-primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone-directory <quoted_string> ] [ in-memory <boolean> ] [ min-update-interval <duration> ]; ... };
 	check-dup-records ( fail | warn | ignore );
 	check-integrity <boolean>;
 	check-mx ( fail | warn | ignore );
@@ -202,23 +202,23 @@ options {
 	notify ( explicit | master-only | primary-only | <boolean> );
 	notify-delay <integer>;
 	notify-rate <integer>;
-	notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify-source ( <ipv4_address> | * ) ;
+	notify-source-v6 ( <ipv6_address> | * ) ;
 	notify-to-soa <boolean>;
 	nsec3-test-zone <boolean>; // test only
 	nta-lifetime <duration>;
 	nta-recheck <duration>;
 	nxdomain-redirect <string>;
-	parental-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	parental-source ( <ipv4_address> | * ) ;
+	parental-source-v6 ( <ipv6_address> | * ) ;
 	pid-file ( <quoted_string> | none );
 	port <integer>;
 	preferred-glue <string>;
 	prefetch <integer> [ <integer> ];
 	provide-ixfr <boolean>;
 	qname-minimization ( strict | relaxed | disabled | off );
-	query-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-	query-source-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+	query-source [ address ] ( <ipv4_address> | * );
+	query-source-v6 [ address ] ( <ipv6_address> | * );
 	querylog <boolean>;
 	rate-limit {
 		all-per-second <integer>;
@@ -292,8 +292,8 @@ options {
 	tls-port <integer>;
 	transfer-format ( many-answers | one-answer );
 	transfer-message-size <integer>;
-	transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer-source ( <ipv4_address> | * ) ;
+	transfer-source-v6 ( <ipv6_address> | * ) ;
 	transfers-in <integer>;
 	transfers-out <integer>;
 	transfers-per-ns <integer>;
@@ -302,8 +302,8 @@ options {
 	udp-receive-buffer <integer>;
 	udp-send-buffer <integer>;
 	update-check-ksk <boolean>;
-	use-v4-udp-ports { <portrange>; ... };
-	use-v6-udp-ports { <portrange>; ... };
+	use-v4-udp-ports { <portrange>; ... }; // deprecated
+	use-v6-udp-ports { <portrange>; ... }; // deprecated
 	v6-bias <integer>;
 	validate-except { <string>; ... };
 	version ( <quoted_string> | none );
@@ -312,11 +312,11 @@ options {
 	zone-statistics ( full | terse | none | <boolean> );
 };
 
-parental-agents <string> [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
+parental-agents <string> [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
 
 plugin ( query ) <string> [ { <unspecified-text> } ]; // may occur multiple times
 
-primaries <string> [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
+primaries <string> [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... }; // may occur multiple times
 
 server <netprefix> {
 	bogus <boolean>;
@@ -325,12 +325,12 @@ server <netprefix> {
 	edns-version <integer>;
 	keys <server_key>;
 	max-udp-size <integer>;
-	notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify-source ( <ipv4_address> | * ) ;
+	notify-source-v6 ( <ipv6_address> | * ) ;
 	padding <integer>;
 	provide-ixfr <boolean>;
-	query-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-	query-source-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+	query-source [ address ] ( <ipv4_address> | * );
+	query-source-v6 [ address ] ( <ipv6_address> | * );
 	request-expire <boolean>;
 	request-ixfr <boolean>;
 	request-nsid <boolean>;
@@ -339,8 +339,8 @@ server <netprefix> {
 	tcp-keepalive <boolean>;
 	tcp-only <boolean>;
 	transfer-format ( many-answers | one-answer );
-	transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer-source ( <ipv4_address> | * ) ;
+	transfer-source-v6 ( <ipv6_address> | * ) ;
 	transfers <integer>;
 }; // may occur multiple times
 
@@ -376,11 +376,11 @@ view <string> [ <class> ] {
 	allow-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow-update { <address_match_element>; ... };
 	allow-update-forwarding { <address_match_element>; ... };
-	also-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	attach-cache <string>;
 	auth-nxdomain <boolean>;
 	auto-dnssec ( allow | maintain | off ); // deprecated
-	catalog-zones { zone <string> [ default-primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone-directory <quoted_string> ] [ in-memory <boolean> ] [ min-update-interval <duration> ]; ... };
+	catalog-zones { zone <string> [ default-primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... } ] [ zone-directory <quoted_string> ] [ in-memory <boolean> ] [ min-update-interval <duration> ]; ... };
 	check-dup-records ( fail | warn | ignore );
 	check-integrity <boolean>;
 	check-mx ( fail | warn | ignore );
@@ -483,22 +483,22 @@ view <string> [ <class> ] {
 	nocookie-udp-size <integer>;
 	notify ( explicit | master-only | primary-only | <boolean> );
 	notify-delay <integer>;
-	notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify-source ( <ipv4_address> | * ) ;
+	notify-source-v6 ( <ipv6_address> | * ) ;
 	notify-to-soa <boolean>;
 	nsec3-test-zone <boolean>; // test only
 	nta-lifetime <duration>;
 	nta-recheck <duration>;
 	nxdomain-redirect <string>;
-	parental-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	parental-source ( <ipv4_address> | * ) ;
+	parental-source-v6 ( <ipv6_address> | * ) ;
 	plugin ( query ) <string> [ { <unspecified-text> } ]; // may occur multiple times
 	preferred-glue <string>;
 	prefetch <integer> [ <integer> ];
 	provide-ixfr <boolean>;
 	qname-minimization ( strict | relaxed | disabled | off );
-	query-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-	query-source-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+	query-source [ address ] ( <ipv4_address> | * );
+	query-source-v6 [ address ] ( <ipv6_address> | * );
 	rate-limit {
 		all-per-second <integer>;
 		errors-per-second <integer>;
@@ -538,12 +538,12 @@ view <string> [ <class> ] {
 		edns-version <integer>;
 		keys <server_key>;
 		max-udp-size <integer>;
-		notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-		notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+		notify-source ( <ipv4_address> | * ) ;
+		notify-source-v6 ( <ipv6_address> | * ) ;
 		padding <integer>;
 		provide-ixfr <boolean>;
-		query-source ( ( [ address ] ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv4_address> | * ) ] port ( <integer> | * ) ) );
-		query-source-v6 ( ( [ address ] ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ) | ( [ [ address ] ( <ipv6_address> | * ) ] port ( <integer> | * ) ) );
+		query-source [ address ] ( <ipv4_address> | * );
+		query-source-v6 [ address ] ( <ipv6_address> | * );
 		request-expire <boolean>;
 		request-ixfr <boolean>;
 		request-nsid <boolean>;
@@ -552,8 +552,8 @@ view <string> [ <class> ] {
 		tcp-keepalive <boolean>;
 		tcp-only <boolean>;
 		transfer-format ( many-answers | one-answer );
-		transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-		transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+		transfer-source ( <ipv4_address> | * ) ;
+		transfer-source-v6 ( <ipv6_address> | * ) ;
 		transfers <integer>;
 	}; // may occur multiple times
 	servfail-ttl <duration>;
@@ -570,8 +570,8 @@ view <string> [ <class> ] {
 	suppress-initial-notify <boolean>; // obsolete
 	synth-from-dnssec <boolean>;
 	transfer-format ( many-answers | one-answer );
-	transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer-source ( <ipv4_address> | * ) ;
+	transfer-source-v6 ( <ipv6_address> | * ) ;
 	trust-anchor-telemetry <boolean>; // experimental
 	trust-anchors { <string> ( static-key | initial-key | static-ds | initial-ds ) <integer> <integer> <integer> <quoted_string>; ... }; // may occur multiple times
 	trusted-keys { <string> <integer> <integer> <integer> <quoted_string>; ... }; // may occur multiple times, deprecated

doc/misc/primary.zoneopt

@@ -4,7 +4,7 @@ zone <string> [ <class> ] {
 	allow-query-on { <address_match_element>; ... };
 	allow-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow-update { <address_match_element>; ... };
-	also-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	auto-dnssec ( allow | maintain | off ); // deprecated
 	check-dup-records ( fail | warn | ignore );
 	check-integrity <boolean>;
@@ -42,13 +42,13 @@ zone <string> [ <class> ] {
 	max-zone-ttl ( unlimited | <duration> ); // deprecated
 	notify ( explicit | master-only | primary-only | <boolean> );
 	notify-delay <integer>;
-	notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify-source ( <ipv4_address> | * ) ;
+	notify-source-v6 ( <ipv6_address> | * ) ;
 	notify-to-soa <boolean>;
 	nsec3-test-zone <boolean>; // test only
-	parental-agents [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
-	parental-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	parental-agents [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	parental-source ( <ipv4_address> | * ) ;
+	parental-source-v6 ( <ipv6_address> | * ) ;
 	serial-update-method ( date | increment | unixtime );
 	sig-signing-nodes <integer>;
 	sig-signing-signatures <integer>;

doc/misc/redirect.zoneopt

@@ -8,6 +8,6 @@ zone <string> [ <class> ] {
 	masterfile-style ( full | relative );
 	max-records <integer>;
 	max-zone-ttl ( unlimited | <duration> ); // deprecated
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	zone-statistics ( full | terse | none | <boolean> );
 };

doc/misc/secondary.zoneopt

@@ -5,7 +5,7 @@ zone <string> [ <class> ] {
 	allow-query-on { <address_match_element>; ... };
 	allow-transfer [ port <integer> ] [ transport <string> ] { <address_match_element>; ... };
 	allow-update-forwarding { <address_match_element>; ... };
-	also-notify [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	also-notify [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	auto-dnssec ( allow | maintain | off ); // deprecated
 	check-names ( fail | warn | ignore );
 	database <string>;
@@ -39,22 +39,22 @@ zone <string> [ <class> ] {
 	multi-master <boolean>;
 	notify ( explicit | master-only | primary-only | <boolean> );
 	notify-delay <integer>;
-	notify-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	notify-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	notify-source ( <ipv4_address> | * ) ;
+	notify-source-v6 ( <ipv6_address> | * ) ;
 	notify-to-soa <boolean>;
 	nsec3-test-zone <boolean>; // test only
-	parental-agents [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
-	parental-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	parental-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	parental-agents [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	parental-source ( <ipv4_address> | * ) ;
+	parental-source-v6 ( <ipv6_address> | * ) ;
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
 	request-expire <boolean>;
 	request-ixfr <boolean>;
 	sig-signing-nodes <integer>;
 	sig-signing-signatures <integer>;
 	sig-signing-type <integer>;
 	sig-validity-interval <integer> [ <integer> ];
-	transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	transfer-source ( <ipv4_address> | * ) ;
+	transfer-source-v6 ( <ipv6_address> | * ) ;
 	try-tcp-refresh <boolean>;
 	update-check-ksk <boolean>;
 	zero-no-soa-ttl <boolean>;

doc/misc/stub.zoneopt

@@ -19,8 +19,8 @@ zone <string> [ <class> ] {
 	min-refresh-time <integer>;
 	min-retry-time <integer>;
 	multi-master <boolean>;
-	primaries [ port <integer> ] [ source ( <ipv4_address> | * ) [ port ( <integer> | * ) ] ] [ source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ] ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
-	transfer-source ( <ipv4_address> | * ) [ port ( <integer> | * ) ];
-	transfer-source-v6 ( <ipv6_address> | * ) [ port ( <integer> | * ) ];
+	primaries [ port <integer> ] [ source ( <ipv4_address> | * )  ] [ source-v6 ( <ipv6_address> | * )  ] { ( <remote-servers> | <ipv4_address> [ port <integer> ] | <ipv6_address> [ port <integer> ] ) [ key <string> ] [ tls <string> ]; ... };
+	transfer-source ( <ipv4_address> | * ) ;
+	transfer-source-v6 ( <ipv6_address> | * ) ;
 	zone-statistics ( full | terse | none | <boolean> );
 };

lib/isccfg/include/isccfg/grammar.h

@@ -265,6 +265,7 @@ struct cfg_parser {
 #define CFG_ADDR_V4PREFIXOK 0x00000002
 #define CFG_ADDR_V6OK	    0x00000004
 #define CFG_ADDR_WILDOK	    0x00000008
+#define CFG_ADDR_PORTOK	    0x00000010
 #define CFG_ADDR_MASK	    (CFG_ADDR_V6OK | CFG_ADDR_V4OK)
 /*@}*/
 

lib/isccfg/namedconf.c

@@ -1205,8 +1205,10 @@ static cfg_type_t cfg_type_fstrm_model = {
 static cfg_clausedef_t options_clauses[] = {
 	{ "answer-cookie", &cfg_type_boolean, 0 },
 	{ "automatic-interface-scan", &cfg_type_boolean, 0 },
-	{ "avoid-v4-udp-ports", &cfg_type_bracketed_portlist, 0 },
-	{ "avoid-v6-udp-ports", &cfg_type_bracketed_portlist, 0 },
+	{ "avoid-v4-udp-ports", &cfg_type_bracketed_portlist,
+	  CFG_CLAUSEFLAG_DEPRECATED },
+	{ "avoid-v6-udp-ports", &cfg_type_bracketed_portlist,
+	  CFG_CLAUSEFLAG_DEPRECATED },
 	{ "bindkeys-file", &cfg_type_qstring, 0 },
 	{ "blackhole", &cfg_type_bracketed_aml, 0 },
 	{ "cookie-algorithm", &cfg_type_cookiealg, 0 },
@@ -1336,8 +1338,10 @@ static cfg_clausedef_t options_clauses[] = {
 	{ "udp-send-buffer", &cfg_type_uint32, 0 },
 	{ "use-id-pool", NULL, CFG_CLAUSEFLAG_ANCIENT },
 	{ "use-ixfr", NULL, CFG_CLAUSEFLAG_ANCIENT },
-	{ "use-v4-udp-ports", &cfg_type_bracketed_portlist, 0 },
-	{ "use-v6-udp-ports", &cfg_type_bracketed_portlist, 0 },
+	{ "use-v4-udp-ports", &cfg_type_bracketed_portlist,
+	  CFG_CLAUSEFLAG_DEPRECATED },
+	{ "use-v6-udp-ports", &cfg_type_bracketed_portlist,
+	  CFG_CLAUSEFLAG_DEPRECATED },
 	{ "version", &cfg_type_qstringornone, 0 },
 	{ NULL, NULL, 0 }
 };
@@ -3187,6 +3191,12 @@ parse_querysource(cfg_parser_t *pctx, const cfg_type_t *type, cfg_obj_t **ret) {
 			} else if (strcasecmp(TOKEN_STRING(pctx), "port") == 0)
 			{
 				/* read "port" */
+				if ((pctx->flags & CFG_PCTX_NODEPRECATED) == 0)
+				{
+					cfg_parser_warning(
+						pctx, 0,
+						"token 'port' is deprecated");
+				}
 				CHECK(cfg_gettoken(pctx, 0));
 				CHECK(cfg_parse_rawport(pctx, CFG_ADDR_WILDOK,
 							&port));
@@ -3234,7 +3244,7 @@ static void
 doc_querysource(cfg_printer_t *pctx, const cfg_type_t *type) {
 	const unsigned int *flagp = type->of;
 
-	cfg_print_cstr(pctx, "( ( [ address ] ( ");
+	cfg_print_cstr(pctx, "[ address ] ( ");
 	if ((*flagp & CFG_ADDR_V4OK) != 0) {
 		cfg_print_cstr(pctx, "<ipv4_address>");
 	} else if ((*flagp & CFG_ADDR_V6OK) != 0) {
@@ -3242,16 +3252,7 @@ doc_querysource(cfg_printer_t *pctx, const cfg_type_t *type) {
 	} else {
 		UNREACHABLE();
 	}
-	cfg_print_cstr(pctx, " | * ) [ port ( <integer> | * ) ] ) | "
-			     "( [ [ address ] ( ");
-	if ((*flagp & CFG_ADDR_V4OK) != 0) {
-		cfg_print_cstr(pctx, "<ipv4_address>");
-	} else if ((*flagp & CFG_ADDR_V6OK) != 0) {
-		cfg_print_cstr(pctx, "<ipv6_address>");
-	} else {
-		UNREACHABLE();
-	}
-	cfg_print_cstr(pctx, " | * ) ] port ( <integer> | * ) ) )");
+	cfg_print_cstr(pctx, " | * )");
 }
 
 static unsigned int sockaddr4wild_flags = CFG_ADDR_WILDOK | CFG_ADDR_V4OK;
@@ -3277,7 +3278,7 @@ static cfg_type_t cfg_type_querysource = { "querysource",     NULL,
  * which is gratuitously interpreted as the IPv4 wildcard address.
  */
 static unsigned int controls_sockaddr_flags = CFG_ADDR_V4OK | CFG_ADDR_V6OK |
-					      CFG_ADDR_WILDOK;
+					      CFG_ADDR_WILDOK | CFG_ADDR_PORTOK;
 static cfg_type_t cfg_type_controls_sockaddr = {
 	"controls_sockaddr", cfg_parse_sockaddr, cfg_print_sockaddr,
 	cfg_doc_sockaddr,    &cfg_rep_sockaddr,	 &controls_sockaddr_flags
@@ -3530,13 +3531,13 @@ static cfg_type_t cfg_type_logfile = { "log_file",     parse_logfile,
 				       print_logfile,  doc_logfile,
 				       &cfg_rep_tuple, logfile_fields };
 
-/*% An IPv4 address with optional port, "*" accepted as wildcard. */
+/*% An IPv4 address, "*" accepted as wildcard. */
 static cfg_type_t cfg_type_sockaddr4wild = {
 	"sockaddr4wild",  cfg_parse_sockaddr, cfg_print_sockaddr,
 	cfg_doc_sockaddr, &cfg_rep_sockaddr,  &sockaddr4wild_flags
 };
 
-/*% An IPv6 address with optional port, "*" accepted as wildcard. */
+/*% An IPv6 address, "*" accepted as wildcard. */
 static cfg_type_t cfg_type_sockaddr6wild = {
 	"v6addrportwild", cfg_parse_sockaddr, cfg_print_sockaddr,
 	cfg_doc_sockaddr, &cfg_rep_sockaddr,  &sockaddr6wild_flags

lib/isccfg/parser.c

@@ -3218,6 +3218,14 @@ parse_sockaddrsub(cfg_parser_t *pctx, const cfg_type_t *type, int flags,
 		CHECK(cfg_peektoken(pctx, 0));
 		if (pctx->token.type == isc_tokentype_string) {
 			if (strcasecmp(TOKEN_STRING(pctx), "port") == 0) {
+				if ((pctx->flags & CFG_PCTX_NODEPRECATED) ==
+					    0 &&
+				    (flags & CFG_ADDR_PORTOK) == 0)
+				{
+					cfg_parser_warning(
+						pctx, 0,
+						"token 'port' is deprecated");
+				}
 				CHECK(cfg_gettoken(pctx, 0)); /* read "port" */
 				CHECK(cfg_parse_rawport(pctx, flags, &port));
 				++have_port;
@@ -3243,7 +3251,8 @@ cleanup:
 	return (result);
 }
 
-static unsigned int sockaddr_flags = CFG_ADDR_V4OK | CFG_ADDR_V6OK;
+static unsigned int sockaddr_flags = CFG_ADDR_V4OK | CFG_ADDR_V6OK |
+				     CFG_ADDR_PORTOK;
 cfg_type_t cfg_type_sockaddr = { "sockaddr",	     cfg_parse_sockaddr,
 				 cfg_print_sockaddr, cfg_doc_sockaddr,
 				 &cfg_rep_sockaddr,  &sockaddr_flags };
@@ -3312,10 +3321,12 @@ cfg_doc_sockaddr(cfg_printer_t *pctx, const cfg_type_t *type) {
 		POST(n);
 	}
 	cfg_print_cstr(pctx, " ) ");
-	if ((*flagp & CFG_ADDR_WILDOK) != 0) {
-		cfg_print_cstr(pctx, "[ port ( <integer> | * ) ]");
-	} else {
-		cfg_print_cstr(pctx, "[ port <integer> ]");
+	if ((*flagp & CFG_ADDR_PORTOK) != 0) {
+		if ((*flagp & CFG_ADDR_WILDOK) != 0) {
+			cfg_print_cstr(pctx, "[ port ( <integer> | * ) ]");
+		} else {
+			cfg_print_cstr(pctx, "[ port <integer> ]");
+		}
 	}
 }