upstream/unbound
1
0
Fork 0
mirror of https://github.com/NLnetLabs/unbound.git synced 2025-12-20 23:00:56 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

- More clear text for prefetch and minimal-responses in the

Browse source 
unbound.conf man page.
This commit is contained in:
Yorgos Thessalonikefs 2024-09-24 15:10:21 +02:00
parent 7f4a61e6fc
commit 24ebca7df6
2 changed files with 13 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
doc/Changelog
View file

@ -1,5 +1,7 @@
24 September 2024: Yorgos 24 September 2024: Yorgos
- Attempt to further fix doh_downstream_buffer_size.tdir flakiness. - Attempt to further fix doh_downstream_buffer_size.tdir flakiness.
- More clear text for prefetch and minimal-responses in the
unbound.conf man page.
23 September 2024: Wouter 23 September 2024: Wouter
- Fix dns64 with prefetch that the prefetch is stored in cache. - Fix dns64 with prefetch that the prefetch is stored in cache.

20
doc/unbound.conf.5.in
View file

@ -1176,10 +1176,11 @@ IP6 ::1 and IP4 127.0.0.1/8. If no, then localhost can be used to send
queries to. Default is yes. queries to. Default is yes.
.TP .TP
.B prefetch: \fI<yes or no> .B prefetch: \fI<yes or no>
If yes, message cache elements are prefetched before they expire to If yes, cache hits on message cache elements that are on their last 10 percent
keep the cache up to date. Default is no. Turning it on gives about of their TTL value trigger a prefetch to keep the cache up to date.
10 percent more traffic and load on the machine, but popular items do Default is no.
not expire from the cache. Turning it on gives about 10 percent more traffic and load on the machine, but
popular items do not expire from the cache.
.TP .TP
.B prefetch\-key: \fI<yes or no> .B prefetch\-key: \fI<yes or no>
If yes, fetch the DNSKEYs earlier in the validation process, when a DS If yes, fetch the DNSKEYs earlier in the validation process, when a DS
@ -1199,12 +1200,13 @@ from the query ID, for speed and thread safety). Default is yes.
.B minimal-responses: \fI<yes or no> .B minimal-responses: \fI<yes or no>
If yes, Unbound does not insert authority/additional sections into response If yes, Unbound does not insert authority/additional sections into response
messages when those sections are not required. This reduces response messages when those sections are not required. This reduces response
size significantly, and may avoid TCP fallback for some responses. size significantly, and may avoid TCP fallback for some responses which may
This may cause a slight speedup. The default is yes, even though the DNS cause a slight speedup. The default is yes, even though the DNS
protocol RFCs mandate these sections, and the additional content could protocol RFCs mandate these sections, and the additional content could
be of use and save roundtrips for clients. Because they are not used, save roundtrips for clients that use the additional content.
and the saved roundtrips are easier saved with prefetch, whilst this is However these sections are hardly used by clients.
faster. Enabling prefetch can benefit clients that need the additional content
by trying to keep that content fresh in the cache.
.TP .TP
.B disable-dnssec-lame-check: \fI<yes or no> .B disable-dnssec-lame-check: \fI<yes or no>
If true, disables the DNSSEC lameness check in the iterator. This check If true, disables the DNSSEC lameness check in the iterator. This check