Improve checkFunction example for downstreams guide

The check function was defined, but not used, making the example
slightly confusing as to how to use it correctly.

Add paragraph break in load balancer guide

I think this improves readability.

Add missing colons in front of :func: reference

Fixes rendering errors on the load balancer guide page.

Merge pull request #8684 from costypetrisor/fix-dont-throttle-settings

parsing `dont-throttle-names` and `dont-throttle-netmasks` as comma separated lists

parsing `dont-throttle-names` and `dont-throttle-netmasks` as comma separated lists

Merge pull request #8647 from omoerbeek/rec-more-max-qperq

rec: Bump max-qperq default to 60

correct cast

Co-Authored-By: Remi Gacogne <rgacogne@users.noreply.github.com>

Merge pull request #8639 from captainark/rec-postinst

rec: debian postinst / do not fail on user creation if it already exists

Slightly different approach as suggested by rgacogne: if
qname-minimization is active, force maxqperq to be >= 100.

Merge pull request #8640 from tjikkun/gcc10

Fix build with gcc-10

Merge pull request #8672 from omoerbeek/sdig-stdin-is-define

sdig: Fix compilation on OpenBSD where stdin is a define

Merge pull request #8671 from omoerbeek/backport-8632-to-rec-4.3.x

rec: backport to 4.3.x: dnsdist: Require Python libnacl < 1.7

Fix compilation on OpenBSD where stdin is a define

dnsdist: Require Python libnacl < 1.7

Otherwise we need libsodium >= 1.0.12 (required by this change:
https://github.com/saltstack/libnacl/commit/8c8b2f8bc05a5b67f39acf9a6bc0bef6fa839166
) and we don't have it in Trusty, which we still use in Travis.

(cherry picked from commit 1f474f69cc45af37646513618badd7bfa06741fd)

Set default maxqperq to 60, and allow for extra if qname-minimization is on.

Merge pull request #8567 from rgacogne/ddist-bounded-chash

dnsdist: Add bounded loads to the consistent hashing policy

Merge pull request #8667 from omoerbeek/rec-unittest-for-pr-8648

rec: Introduce test for PR 8648.

Introduce test for PR 8648.

While there, explicitly init qname-minimization in test-syncres to
false.  The current code gave the impression it was turned on by
default for unit tests.  We have a lot of test that count queries,
and that is highly depedent on qname minimization being on or off.

Merge pull request #8654 from phonedph1/logresp

dnsdist: LogResponseAction

Merge pull request #8650 from spheron1/master

Fix trusted-notification-proxy port

Merge pull request #8658 from rgacogne/ddist-doc-typos

dnsdist: Fix a few typos in the documentation

Merge pull request #8662 from rgacogne/ddist-default-tls-provider

dnsdist: Display the correct DoT provider

dnsdist: Display the correct DoT provider

Merge pull request #8649 from rgacogne/auth-tsig-keys-8645

auth: Clear the TSIG algo between iterations in the API

dnsdist: Fix a few typos in the documentation

Merge pull request #8656 from phonedph1/patch-20

dnsdist: Update rules-actions.rst

Update rules-actions.rst

Document LogResponseAction

LogResponseAction

Merge pull request #8648 from omoerbeek/rec-zonecuts-go-out-if-needed

rec: fix wrong zoneCuts caused by cache only lookup

auth: Clear the TSIG algo between iterations in the API

Otherwise `GSQLBackend::getTSIGKey()` will try to match the
algorithm in `keyAlgo` if it's set, which will prevent retrieving
a key with a different algorithm that the previous one.

QName Minimization consults the cache first to see work needs to
be done. Via doCacheCheck() this can lead to a call to computeZoneCuts()
which might/does not work properly on only cached records, so always
make sure it can go out if needed. Should fix #8642.

Bump max-qperq default to 100; this is enough for rev v6 queries with cold
cache with validations and qname minimization enabled.  Fixes #8646.

Fix trusted-notification-proxy port

Explicitly set the port for outgoing queries to the SuperMaster when using trusted-notification-proxy and EDNS Client Subnet

Closes #8584

Fix build with gcc-10

From an e-mail from Jeff Law <law@redhat.com>:

Subject: Minor problem in pdns, dnsdist and pdns-recursor packages in Fedora

[ All three packages have embedded copies of the same problematic code
and the same patch fixes all three. ]

Red Hat's compiler team continues to try and be proactive in identifying
issues that will arise as a result of the introduction of a new GCC
release into Fedora each spring.

You're being contacted because a package you maintain in Fedora is going
to fail to build with gcc-10 in the spring.  Yes, I know that's a few
months away, but it's far easier to fix this stuff proactively now than
wait.

Fixing it now also means that your package will continue to be built
with testing versions of gcc-10 as we proceed through the development
process thus allowing additional issues to be caught early.

Your particular package will fail due to an uninstantiated template for
AsyncLoader<Request>.  These kinds of problems are relatively common due to
changes in the tuning of the inliner for gcc-10:

> BUILDSTDERR: /usr/bin/ld: webserver.o: in function `WebServer::serveConnection(std::shared_ptr<Socket>) const':
> BUILDSTDERR: /builddir/build/BUILD/pdns-4.2.1/pdns/webserver.cc:373: undefined reference to `YaHTTP::AsyncLoader<YaHTTP::Request>::feed(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&)'
> BUILDSTDERR: collect2: error: ld returned 1 exit status
> BUILDSTDERR: make[3]: *** [Makefile:2751: ixfrdist] Error 1
>

The attached patch arranges for an instance to be instantiated when
compiling reqresp.cpp and is sufficient to fix this problem.  The
choice of reqresp.cpp fairly arbitrary IIRC.

Ideally you'll with upstream to get this fixed, but a Fedora patch is
clearly OK as well.   I'll install the attached fix into Fedora in a
week or so if I haven't heard from you.

Jeff

rec: debian postinst / do not fail on user creation if it already exists

Merge pull request #8630 from omoerbeek/rec-4.3-upgrade-guide

Upgrade guide for rec-4.3

User differs on Debian vs CentOS

Give recursor relevant examples.

hyphen vs underscore

Co-Authored-By: Matt Nordhoff <mnordhoff@mattnordhoff.com>

Merge pull request #8637 from blackbit42/master

Fix test syntax in 'pdnsutil --help'

Fix test syntax in 'pdnsutil --help'

Merge pull request #8632 from rgacogne/dnsdist-libnacl-requirements

dnsdist: Require Python libnacl < 1.7

Merge pull request #8633 from rgacogne/ddist-doc-install-rh-missing-underline

dnsdist: Add missing underline in install documentation

dnsdist: Add missing underline in install documentation

Merge pull request #8613 from Habbie/auth-pc-init-order

auth packetcache: sync init order with member order

dnsdist: Require Python libnacl < 1.7

Otherwise we need libsodium >= 1.0.12 (required by this change:
https://github.com/saltstack/libnacl/commit/8c8b2f8bc05a5b67f39acf9a6bc0bef6fa839166
) and we don't have it in Trusty, which we still use in Travis.

Upgrade guide for rec-4.3

Merge pull request #8621 from aerique/feature/repo-script-for-auth-43

Add `auth-43` and `rec-43`.

Add `auth-43` and `rec-43`.

Merge pull request #8618 from omoerbeek/rec-prep-4.3.0-beta1

Rec: Prepare for rec-4.3.0-beta1

Update pdns/recursordist/docs/changelog/4.3.rst

Co-Authored-By: Peter van Dijk <peter.van.dijk@powerdns.com>

Suggestions by Habbie

Prepare for rec-4.3.0-beta1

Merge pull request #8539 from pieterlexis/4.3-docs

Auth 4.3.0 docs

auth 4.3.0-alpha1 secpoll

document local-ipv6 removal in 4.3

auth 4.3 changelog

git-to-changelog-merges: remove trailing spaces

EL pkgs: chown dirs to service user

Add auth 4.3.0 upgrade docs

Merge pull request #8571 from omoerbeek/rec-better-time-based

Rec: better time based data structures

Merge pull request #8599 from aerique/feature/update-docker-repo-script

Update docker repo script for auth-4.2.1.

Merge pull request #8249 from chbruyand/lua-monitoring-thread

auth: refactor health checks monitoring done from LUA records

Merge pull request #8497 from mind04/pdns-api2

Auth: api: cache and rectify fixes in patchZone()

Fix CentOS 8 issue and install `dig`.

Update docker repo script for rec-4.2.1.

Merge pull request #8611 from omoerbeek/rec-prep-4.2.1

Prepare for rec-4.2.1

auth packetcache: sync init order with member order

remove unused variable

add qname/qtype to LUA Lua errors

auth: lua monitoring, lock on status change, better report malformed options content

auth: lua refactor health checks monitoring

Merge pull request #8512 from rgacogne/dedup-rrs-signature

Remove duplicate RRs inside a RRSet when computing the signature

Rebased; test files were reformatted

rec: Check duplicated records inside a RRSet validate correctly

Remove duplicate RRs inside a RRSet when computing the signature

These duplicates should not exist but they do happen in the wild.
Since we need to sort the RRs anyway, let's be nice and remove
duplicates as well.

Prepare for rec-4.2.1

Merge pull request #8435 from mind04/pdns-remove-opendbx

auth: remove opendbx backend

Merge pull request #8603 from omoerbeek/rec-prep-4.1.15

rec: Prep for rec-4.1.15

Merge pull request #8601 from omoerbeek/no-copy-rwlocks

Avoid copying of pthread_rwlock_t

Merge pull request #8607 from rgacogne/ddist-doc-zeroscope-parseecs

dnsdist: Document that the 'zero-scope' feature requires 'parseECS'

Merge pull request #8027 from Habbie/sdig-stdin-exitvalue

sdig: decode DNS packets from stdin; exit non-zero on failure

Merge pull request #8604 from rgacogne/ddist-kvs-errors

dnsdist: Add missing exception message in KVS error

Merge pull request #8605 from rgacogne/ddist-tuning-doc-typo

dnsdist: Add missing newline in setMaxUDPOutstanding() documentation

dnsdist: Document that the 'zero-scope' feature requires 'parseECS'

dnsdist: Add missing newline in setMaxUDPOutstanding() documentation

dnsdist: Add missing exception message in KVS error

Merge pull request #8585 from pieterlexis/auth-api-lenient

Auth API: be a bit more lenient

Prep for rec-4.1.15

sdig: support reading packets from stdin

fix formatting

fix typo

Merge pull request #8430 from Habbie/builder-no-all

builder: demand user chooses a module except when building docs

builder: demand user chooses a module except when building docs

Merge pull request #8334 from Habbie/dnsscope-nits

dnsscope: two nits

auth: remove opendbx backend

Merge pull request #8486 from pieterlexis/auth-rm-local-ipv6

Auth: Remove local-ipv6 setting

Avoid copying of pthread_rwlock_t

Merge pull request #8591 from rgacogne/ddist-wait-longer-for-tls-tickets

dnsdist: Wait longer for the TLS ticket to arrive in our tests