improve timer resolution

poll events are bitmasks, not values

when we sendmsg, the socket may not be done connecting yet

docs: update pdnsutil 'set-nsec3' and NSEC3 narrow mode

* The 4-parameter quoted string argument in "pdnsutil set-nsec3" appears to
  have a default value of "1 0 1 ab" according to the sources:
  https://github.com/PowerDNS/pdns/blob/e62422ce0e86cfe959073ef061f07873ceff6be8/pdns/pdnsutil.cc#L2459
  introduced with b8adb30dff5fc18b55e27580c07799d8fae1bafb (in 3.3+)
* The example command included smart quotes, which don't really work when
  copy-pasted to a shell - changed to monospaced formatting.
* Include note about online signing requirement for "White Lies" / narrow
  mode support and that zone transfers are denied in this mode.
* Mention RFC about "White Lies".
* Mention defaults on 'DNSSEC Modes of Operation'.
* Mention possible limits of ITERATIONS via 'max-nsec3-iterations'.

docs: notes on 'bind-check-interval' <-> 'slave-cycle-interval'

docs: Add 'bind-check-interval' setting default

docs: Note that supermaster support is off by default since 4.2

With commit b80139777ebd2e0dc14cfd88d30eed80cfc04054 / PR #6021, it appears
that the behaviour of PowerDNS has changed to not act as a supermaster any
longer by default. Having to add a new setting that did not exist before,
to retain the old behaviour should be mentioned, I believe.

docs: fix link to setting loglevel in settings

Introduced with 64c08e25825ae5ef2a702277884003902ced9607

docs: fix Sphinx-build warning in ixfsdist.yml.5.rst

Warnings observed since merge of f614922949036d22ab4a7a55e1629d2b60e7a094:
* docs/manpages/ixfrdist.yml.5.rst:121: WARNING: Unexpected indentation.
* docs/manpages/ixfrdist.yml.5.rst:122: WARNING: Literal block ends without a blank line; unexpected unindent.

docs: Alphabetically order settings

docs: add use case for 'no-config' setting

docs: fix formatting of 'rng' setting options

Was rendered as a field definition, because both:
* A blank line was omitted before starting the list items.
* Leading whitespace for each item (much like the commit that removes the
  superfluous blockquotes).

docs: fix some links (invalid ref-role usage)

docs: Align position of version annotation in settings

On two out of many other occurrences the versionadded/deprecated directive
was rendered above the parameters, but the vast majority had it below. This
change aligns the two outliers.

docs: Remove superfluous comma in 'any-to-tcp' setting

docs: Add missing entry in table for the 'Lua' backend

docs: specify type of 8bit-dns setting

It had a superfluous description where other settings have the type there.

docs: Add warning on empty bind-dnssec-db for slave operation

I fell right into the pitfall of configuring a slave with the BIND
backend, serving presigned records, assuming it will serve the RRSIGs
just fine, but no, my domain went bogus. This was documented, but
not as clearly as I hoped for, this commit improves the documentation
regarding that.

docs: Consistent naming/casing of the BIND (backend)

Skipped some occurrences where it refers to PR titles or commit messages.

docs: Cross-reference DNSSEC-ALIAS limitation

docs: Add a missing 'Default:' (consistency on page)

docs: Add paragraph on benefits of the BIND backend

docs: BIND backend - improve formatting of output status

Before this change it was hard to distinguish the three possible statuses
due to the styling of the inline-monospaced text without contrast in the
background for the current Sphinx theme.

docs: Add '(or zone transfer)' in sentence on BIND backend

If zones would never be reloaded without a regular non-AXFR DNS request,
the BIND backend would not be usable in a hidden master setup for example.

Als remove superfluous period after link to setting.

docs: fix several typos

docs: Change occurrences of "note" to admonition

docs: Hide the toctree on 'Backends' index page

Effectively, all the backends are listed in the nicely formatted table
already.

docs: fix links in 'Adding new DNS record types'

nested markup for monospaced text on link is not possible, see
https://stackoverflow.com/q/4743845/1254292

docs: Emphasize no data should return in example

The line with just a '$' confused be until I've read the sentence above it
again.

docs: Use 'sudo' to install packages

This also fixes the rendering of the shell command - was highlighted as
comment.

docs: formatting fixes for 'Dynamic DNS Update' page

* Fix a broken link to the domain metadata.
* Prettify method listing paragraph.

docs: HTTP API tsigkeys example shows wrong body

Two errors fixed:
* The JSON body parameter key 'key' was provided twice. I think it should
  have been the 'name' key.
* One value wasn't terminated with a double quote.

The HTTP code block parser warned about this in the sphinx-build output.

docs: Other minor fixes

* Make sentence actually part of the 'versionchanged' directive on the
  settings page. Fixes sphinx-build warning.
* LDAP backend formatting changes so that ldap:// URIs don't get
  linkified.
* Fix sphinx-build warning about under and over underlined sections.

docs: Fix link in Lua2 backend

docs: Fix formatting of Lua2 backend API

Without a blank line between the paragraphs in the descriptions of
RST description lists [1], the list items will not render as list items,
but as a long single paragraph.

[1]: http://docutils.sourceforge.net/docs/user/rst/quickref.html#definition-lists

docs: fix link in Lua backend

Two problems with the existing link:
* target was non-existent (anchor is different in Sphinx)
* nested markup for monospaced text on link is not possible, see
  https://stackoverflow.com/q/4743845/1254292

docs: reword sentence in DNSSEC intro

"confirmation can be gotten" sounds weird to me.

docs: Fix formatting of some code blocks

docs: Add 'hidden master' approach in DNSSEC security

This approach is referred to in the public domain as well as once in the
PowerDNS changelog, but not described in any way before this change.

docs: fix formatting of 'PKCS#11 support' page

Also:
* slightly reword some things where necessary
* Ubuntu 12.nothing/14.nothing do not exist, added assumed '.04'.

docs: remove unintentional blockquotes in HTML

Having leading spaces in either:
* Lists
* RST directives, such as
  .. toctree::

will lead to the listing being wrapped in an HTML <blockquote> element with
also the styling as such. This is probably unintentional and at least
inconsistent with other occurrences.

docs: align meta-data -> metadata

This occurrence was the only one spelled like 'meta-data', all others are
spelled as 'metadata'.

docs: Improve "BIND-mode operation" for DNSSEC

Also:
* Mention that not just keys are part of this database, but also DNSSEC
  domain metadata.
* Link to the pdns.conf setting.

dnsdist: Fix an issue with self-answers and non-harvested source

mplexer: Fix typo in the kqueue multiplexer

Merge pull request #7677 from rgacogne/dnsdist-logging-facility

dnsdist: Add 'setSyslogFacility()'

Fix 7680: gmysql-thread-cleanup option documented incorrectly

Merge pull request #7649 from rgacogne/per-threads-cpu-stats

rec: This provides CPU usage statistics per thread (worker & distributor).

Merge pull request #7658 from Habbie/uuid-for-everyone

always link in uuid-utils because webserver logging needs it now

Merge pull request #7674 from Habbie/dnsdist-libcrypto-includes

dnsdist: honor libcrypto include path

Merge pull request #7679 from rgacogne/dnsdist-missing-overrides

dnsdist: Add missing overrides

Merge pull request #7629 from jsoref/dns-docs

dnssec clarifications

Merge pull request #7671 from Habbie/epel-python3

centos builds: ask for any python3

dnsdist: Add missing overrides

dnsdist: Add 'reloadAllCertificates()'

dnsdist: Add 'setSyslogFacility()'

Merge remote-tracking branch 'origin/master' into rec-dnstap

dnsdist: honor libcrypto include path

dumresp: Document the new 'tcp' option

dumresp: Add TCP support

Merge pull request #7668 from Habbie/boost-1.42

bump boost requirement to 1.42 unconditionally

Merge pull request #7559 from rgacogne/dnsdist-tcp-refactor-clean

dnsdist: Refactoring of the TCP stack

Merge pull request #7670 from Habbie/kill-addlua

dnsdist: remove addLuaAction and addLuaResponseAction

dnsdist: Add more TCP metrics

Keep, for each frontend and backend:
- the number of concurrent TCP connections
- the average number of queries per connection
- the average duration of a connection

centos builds: ask for any python3

all: DNSName avoid copying labels while converting to string

dnsdist: remove addLuaAction and addLuaResponseAction

bump boost requirement to 1.42 unconditionally

dnsdist: Apply suggestions from chbruyand's reviews (thanks!)

dnsdist: Try reading from the TCP backend right away

Instead of waiting for the socket to be readable, as it might
already be, so we save a multiplexer trip, and prevent an issue
if we ever add a TLS layer between dnsdist and the backends.

dnsdist: Actually try to read before checking if the socket is readable

We need to because the TLS layer might already have data waiting
for us, while there might not be anything left on the OS-level
buffer associated to the socket.
If we don't ask the TLS layer, we might wait indefinitely for
something to arrive while the client has already sent everything,
and it's just waiting for us because the TLS record has been read.

dnsdist: Better reporting of syscall errors via OpenSSL's libssl

mplexer: Add an accessor to get the number of watched FDs

dnsdist: Add a few more regression tests for DNS over TLS

dnsdist: Update the documentation for the new TCP stack

dnsdist: Fix invalid carbon formatting for TCP stats

dnsdist: Display (and export via API) the frontend type (DoT, ..)

dnsdist: Display backend and frontend TCP metrics in showTCPStats()

dnsdist: Add more TCP metrics

dnsdist: Add a "lots of TCP connections" regression test

dnsdist: Downstream failures only count for fresh TCP connections

dnsdist: Properly handle an I/O error while sending a TCP response

mplexer: Add some unit tests for our multiplexers

mplexer: Keep TTD ordered so we can scan for timeouts efficiently

dnsdist: Handle EAGAIN when reading from the non-blocking TCP pipe

dnsdist: Don't scan for TCP timeouts more than once every second

dnsdist: Make sure that the TCP distribution pipes are non-blocking

dnsdist: Fix outstanding count for TCP connections

dnsdist: Use a unique pointer for the global TCPClientCollection

dnsdist: Remove code duplication between UDP and TCP in the tests

dnsdist: Disable regression tests for invalid AXFR

The new implementation does not try to be too smart about that
anymore.

dnsdist: TCP refactoring using an event-based logic

Only allocate the SSocket buffer when we actually need it, cleanup

Return EINPROGRESS instead of -1 in SConnectWithTimeout wo/ timeout

mplexer: Add support for write timeouts

mplexer: Make it possible to set the read TTD right away

dnsdist: Define empty DNSCrypt-related objects when not enabled

This way the rest of the code can mostly ignore whether DNSCrypt
support is enabled.

dnsdist: Add a function to extract an EDNS0Record from a DNS packet

dnsdist: Refactoring of the response handling path

dnsdist: Python 3 compat fixes for the regression tests