diff --git a/doc/Changelog b/doc/Changelog index 0f585329e..b97d88b93 100644 --- a/doc/Changelog +++ b/doc/Changelog @@ -4,6 +4,7 @@ - Fix #1513: [FR] Size of harden-large-queries in the man page. - Move NORMAL_UDP_SIZE around. - Clarify man page text for harden-short-bufsize. + - Update generated man pages. 21 September 2026: Yorgos - Merge #1510 from Andy Warner: Move unlink of temp file to before diff --git a/doc/unbound.conf.5.in b/doc/unbound.conf.5.in index 54116af23..1642f0a93 100644 --- a/doc/unbound.conf.5.in +++ b/doc/unbound.conf.5.in @@ -2070,7 +2070,8 @@ Default: \(dq3 2 1 0 0\(dq .INDENT 0.0 .TP .B harden\-short\-bufsize: \fI\fP -Very small EDNS buffer sizes from queries are ignored. +Very small EDNS buffer sizes from queries are ignored and are instead +set to the normal UDP packet size (512 bytes). .sp Default: yes (per \fI\%RFC 6891\fP) .UNINDENT @@ -2078,6 +2079,7 @@ Default: yes (per \fI\%RFC 6891\fP) .TP .B harden\-large\-queries: \fI\fP Very large queries are ignored. +The cutoff value is chosen to be the normal UDP packet size (512 bytes). Default is no, since it is legal protocol wise to send these, and could be necessary for operation if TSIG or EDNS payload is very large. .sp @@ -2201,6 +2203,18 @@ Default: no .UNINDENT .INDENT 0.0 .TP +.B harden\-cname\-follow: \fI\fP +Harden CNAME redirections by following them. +If no, then upstream CNAME and DNAME redirections are allowed in a +response without checking with further messages if those are valid. +It can only really be disabled safely on localhost net or encrypted +connectivity. +Default is on to protect the cache integrity. +.sp +Default: yes +.UNINDENT +.INDENT 0.0 +.TP .B use\-caps\-for\-id: \fI\fP Use 0x20\-encoded random bits in the query to foil spoof attempts. This perturbs the lowercase and uppercase of query names sent to authority @@ -2336,7 +2350,10 @@ Default: (none) .B do\-not\-query\-localhost: \fI\fP If yes, localhost is added to the \fI\%do\-not\-query\-address\fP entries, -both IPv6 \fB::1\fP and IPv4 \fB127.0.0.1/8\fP\&. +both IPv4 \fB127.0.0.1/8\fP (also \fB::ffff:127.0.0.0/104\fP) and IPv6 \fB::1\fP\&. +Additionally, the zero subnets \fB0.0.0.0/8\fP (also \fB::ffff:0:0/96\fP) and +\fB::\fP are added to the list since on some systems they route to +localhost as well. If no, then localhost can be used to send queries to. .sp Default: yes @@ -2504,6 +2521,9 @@ Format is BIND\-9 style format, the \fBtrusted\-keys { name flag proto algo It is possible to use wildcards with this statement, the wildcard is expanded on start and on reload. .sp +A wildcard that matches no files is not an error: the entry loads no +trust anchors, and the condition is logged at operational verbosity. +.sp Default: \(dq\(dq (no trusted keys file) .UNINDENT .INDENT 0.0 @@ -2613,7 +2633,7 @@ affected. Use this setting to protect the users that rely on this validator for authentication from potentially bad data in the additional section. .sp -Default: yes +Default: no .UNINDENT .INDENT 0.0 .TP @@ -3879,6 +3899,28 @@ Default: yes .UNINDENT .INDENT 0.0 .TP +.B val\-validation\-attempts: \fI\fP +Limit on the number of DNSSEC validation attempts for a query. +This protects against too large numbers of cryptographic operations, +like for a deep delegation chain. +This counts attempts to validate RRSIGs. +When it is exceeded, the query fails. +.sp +Default: 32 +.UNINDENT +.INDENT 0.0 +.TP +.B val\-hash\-attempts: \fI\fP +Limit on the number of DNSSEC hash attempts for a query. +This protects against too large numbers of cryptographic operations, +like for a deep delegation chain. +This counts DS hash attempts to match DNSKEYs. +When it is exceeded, the query fails. +.sp +Default: 32 +.UNINDENT +.INDENT 0.0 +.TP .B fast\-server\-permil: \fI\fP Specify how many times out of 1000 to pick from the set of fastest servers. 0 turns the feature off.