diff --git a/bin/named/named.conf.5 b/bin/named/named.conf.5 index 92ecc610d3..1d1931e482 100644 --- a/bin/named/named.conf.5 +++ b/bin/named/named.conf.5 @@ -254,6 +254,7 @@ options { tkey\-gssapi\-credential \fIquoted_string\fR; tkey\-gssapi\-keytab \fIquoted_string\fR; tkey\-domain \fIquoted_string\fR; + transfer\-message\-size \fIinteger\fR; transfers\-per\-ns \fIinteger\fR; transfers\-in \fIinteger\fR; transfers\-out \fIinteger\fR; diff --git a/bin/named/named.conf.html b/bin/named/named.conf.html index 06ddc413d2..adf3435247 100644 --- a/bin/named/named.conf.html +++ b/bin/named/named.conf.html @@ -197,6 +197,7 @@ options tkey-gssapi-credential quoted_string;
tkey-gssapi-keytab quoted_string;
tkey-domain quoted_string;
+ transfer-message-size integer;
transfers-per-ns integer;
transfers-in integer;
transfers-out integer;
diff --git a/doc/arm/Bv9ARM.ch06.html b/doc/arm/Bv9ARM.ch06.html index 37b140758f..04c41ebd98 100644 --- a/doc/arm/Bv9ARM.ch06.html +++ b/doc/arm/Bv9ARM.ch06.html @@ -2419,6 +2419,7 @@ badresp:1,adberr:0,findfail:0,valfail:0] [ serial-queries number; ] [ tcp-listen-queue number; ] [ transfer-format ( one-answer | many-answers ); ] + [ transfer-message-size number; ] [ transfers-in number; ] [ transfers-out number; ] [ transfers-per-ns number; ] @@ -5165,6 +5166,34 @@ avoid-v6-udp-ports {}; per-server basis by using the server statement.

+
transfer-message-size
+
+

+ This is an upper bound on the uncompressed size of DNS + messages used in zone transfers over TCP. If a message + grows larger than this size, additional messages will be + used to complete the zone transfer. (Note, however, + that this is a hint, not a hard limit; if a message + contains a single resource record whose RDATA does not + fit within the size limit, a larger message will be + permitted so the record can be transferred.) +

+

+ Valid values are between 512 and 65535 octets, and any + values outside that range will be adjusted to the nearest + value within it. The default is 20480, + which was selected to improve message compression: + most DNS messages of this size will compress to less + than 16536 bytes. Larger messages cannot be compressed + as effectively, because 16536 is the largest permissible + compression offset pointer in a DNS message. +

+

+ This option is mainly intended for server testing; + there is rarely any benefit in setting a value other + than the default. +

+
transfers-in

The maximum number of inbound zone transfers diff --git a/doc/arm/Bv9ARM.ch09.html b/doc/arm/Bv9ARM.ch09.html index ac686818fa..f0f14af7de 100644 --- a/doc/arm/Bv9ARM.ch09.html +++ b/doc/arm/Bv9ARM.ch09.html @@ -639,6 +639,10 @@ for the number of UDP listeners has been changed to the number of detected processors minus one.

+

  • + Zone transfers now use smaller message sizes to improve + message compression. This results in reduced network usage. +

    • diff --git a/doc/arm/man.named.conf.html b/doc/arm/man.named.conf.html index 2433118222..2fdff1de51 100644 --- a/doc/arm/man.named.conf.html +++ b/doc/arm/man.named.conf.html @@ -216,6 +216,7 @@ options tkey-gssapi-credential quoted_string;
    tkey-gssapi-keytab quoted_string;
    tkey-domain quoted_string;
    + transfer-message-size integer;
    transfers-per-ns integer;
    transfers-in integer;
    transfers-out integer;
    diff --git a/doc/arm/notes.html b/doc/arm/notes.html index 090fca019e..1ba4e42b4d 100644 --- a/doc/arm/notes.html +++ b/doc/arm/notes.html @@ -600,6 +600,10 @@ for the number of UDP listeners has been changed to the number of detected processors minus one.

    +

  • + Zone transfers now use smaller message sizes to improve + message compression. This results in reduced network usage. +

    • diff --git a/doc/misc/options b/doc/misc/options index 52e3f37b72..318dcc3694 100644 --- a/doc/misc/options +++ b/doc/misc/options @@ -307,11 +307,11 @@ options { tkey-gssapi-keytab ; topology { ; ... }; // not implemented transfer-format ( many-answers | one-answer ); + transfer-message-size ; transfer-source ( | * ) [ port ( | * ) ] [ dscp ]; transfer-source-v6 ( | * ) [ port ( | * ) ] [ dscp ]; - transfer-message-size ; transfers-in ; transfers-out ; transfers-per-ns ;