auth: Add /api/docs endpoint to obtain OpenAPI document

This patch adds an /api/docs endpoint to the API webserver,
allowing clients to obtain the OpenAPI (Swagger) document that
describes the server's API directly from the server.

It also modifies the response body mechanism in the webserver
to no longer assume JSON output, but allow handlers to specify
JSON, YAML, or plain text. It also adds detection of YAML
support in the request so that handlers can choose which type
to send in their response. Since there is not yet a standard
MIME type for YAML, 'application/x-yaml' is used since it
appears to be the most commonly used type.

Signed-off-by: Kevin P. Fleming <kevin@km6g.us>

Merge pull request #9647 from Habbie/lmdb-unfreshslave-backend

auth lmdb: fill di.backend in getUnfreshSlaveInfos and getAllDomains

lmdb: fill di.backend in getUnfreshSlaveInfos and getAllDomains

Merge pull request #9594 from omoerbeek/rec-rpzrefresh-cleanup

rec: Cleanup of RPZ refresh handling

Merge pull request #9470 from zeha/rm-uebersoa

Remove UeberBackend::getSOA

Merge pull request #9619 from mind04/pdns-doc

dnsdist: fix doc warning "Unknown target name" in rules-actions.rst

Merge pull request #9623 from zeha/auth-upgrade-typex

gsql,bind: allow seamless serving of newly-supported TYPExxx records

Merge pull request #9595 from moepman/fix-doc-lua-reverse6

docs: fix lua reverse example for IPv6 records

Merge pull request #9631 from mind04/pdns-cds-cdnskey

auth: add support for dnssec removal to CDS/CDNSKEY

Add zoneparsertng upgrade test

Allow seamless serving of newly-supported TYPExxx records

Typo

Add comment as suggested by ragacogne

Merge pull request #9642 from yantarou/udr_doc_typo

Fix typo in Recursor UDR documentation

Merge pull request #9641 from yantarou/statnode_doc_typo

Fix typo in dnsdist StatNode documentation

Merge pull request #9640 from yantarou/nod_doc_typo

Fix typo in Recursor NOD documentation

Fix typo in Recursor UDR documentation

Fix typo in dnsdist StatNode documentation

Fix typo in Recursor NOD documentation

auth: add support for dnssec removal to CDS/CDNSKEY

Merge pull request #9629 from omoerbeek/rec-stats-perc-rounding

rec: Refactor the percentage computation and use rounding

Merge pull request #9571 from rgacogne/rec-better-handling-tcp-invalid-responses

rec: Throttle servers sending invalid data and rcodes

Merge pull request #9627 from Habbie/soa-mname

auth: change "misconfigured" SOA MNAME to not mention powerdns and be RFC6761 compliant

Reformat

Merge pull request #9635 from mind04/pdns-valgrind

auth: fix memory problems and an uninitalized variable

Merge pull request #9624 from zeha/dupincl

Including namespaces.hh once is enough

auth: docs: fix 'underline too short' warning in settings.rst

auth: fix reallocation issue in DNSSECKeeper::getPreRRSIGs()

auth: remove some redundant std::move casts

auth: cleanup LMDBBackend::get()

Refactor the percentage computation and use rounding (double -> uint64_t conversion truncates)

auth: change "misconfigured" SOA MNAME to not mention powerdns and be RFC6761 compliant

Merge pull request #9568 from mind04/pdns-presigned

auth: Speedup presigned signature lookups.

Merge pull request #9625 from Habbie/revert-9552

auth: delay local-ipv6 and query-local-address6 removal to 4.5.0 together

Merge pull request #9593 from mind04/pdns-deprecate

Auth: remove deprecated features/settings

Merge pull request #9622 from Habbie/codeql-dnsdist-deps

explicitly generate the protobuf parsers/generators

docs: delay local-ipv6 removal until after 4.4.0

improve query-local-address6 deprecation notice

Including namespaces.hh once is enough

Revert "auth: remove local-ipv6, query-local-address6"

This reverts commit c71c6ea62eb67aa7580dfadee981607559d1247c.

explicitly generate the protobuf parsers/generators

auth: api, remove set-ptr

auth: remove SOA filling

Merge pull request #9617 from omoerbeek/prep-rec-4.4.0

Prep rec-4.4.0

Merge pull request #9552 from zeha/auth-local-ipv6

auth: remove local-ipv6, query-local-address6

Merge pull request #9533 from mind04/pdns-fixme400-2

Fix some FIXME400s

Merge pull request #9613 from pieterlexis/lua-records-fixes

Lua records fixes

Merge pull request #9570 from pieterlexis/sort-SOURCES

Sort *_SOURCES and add a checker

Merge pull request #9093 from Habbie/dockerise

auth/rec/dnsdist: dockerise

dnsdist: fix doc warning "Unknown target name" in rules-actions.rst

auth/rec/dnsdist: dockerise

dnsdist docs: fix typo

Prep rec-4.4.0

rec: Throttle servers sending invalid data and rcodes

rec: Add a LWResult::Result type to stop dealing with numerical values

Merge pull request #9572 from rgacogne/rec-close-tcp-conn-drop

rec: Terminate TCP connections instead of 'ignoring' errors

Merge pull request #9612 from rgacogne/ddist-dnsheader-doc

dnsdist: Add the missing documentation for some dnsheader methods

Update pdns/lua-record.cc

Co-authored-by: Remi Gacogne <rgacogne+github@valombre.net>

LUA record: document all variables available

LUA rec: fix uncaught DNSName init exception

Merge pull request #9599 from ihsinme/patch-1

fix the initialization order in the class.

dnsdist: Add the missing documentation for some dnsheader methods

Merge pull request #9606 from omoerbeek/rec-prep-2020-07

rec: Prep for rec Oct 13th 2020 security releases

Prep for rec Oct 13th 2020 security releases

Merge pull request #9602 from omoerbeek/rec-sec-2020-07

Rec: Security 2020-07

fix the initialization order in the class.

rec: Remove duplicate semicolon spotted by Otto

Co-authored-by: Otto Moerbeek <otto.moerbeek@open-xchange.com>

Remove `auth-40` and `rec-40` arguments.

The removed releases are EOL and do not work with this script anymore.

rec: Add a unit test for the ANY "just-in-time" cached records case

rec: Fix validation when more than one cached record is returned

We need to validate them RRSet by RRSet.

rec: Fix returning more than one cached records

The existing implementation did not properly update the DNSSEC
and authoritative status, and did not include all the needed
RRSIG and additional records.

rec: Prevent updating the status of all cached records for a name

Before that fix, it was possible to make the recursor update the
DNSSEC status of all cached records for a given name using an ANY
query.
This real issue is that we should retrieve the needed RRSIGs and
authority records for all cached records when processing an ANY
query, but this fix prevents the cache pollution which is the worst
part of the issue.

Remove CentOS 6 for Recursor 4.4.x.

docs: fix lua reverse example for IPv6 records

The example called the createReverse function on a PTR record for an
IPv6 address instead of the createReverse6 - which when mindlessly
copy and pasted resulted in a lengthy servfail error

Cleanup of refresh determination

Merge pull request #9590 from omoerbeek/rewrite-rsa-fromiscmap

auth: Rewrite OpenSSLRSADNSCryptoKeyEngine::fromISCMap to be less tricky

Merge pull request #9585 from omoerbeek/rec-prep-4.4.0-rc2

rec: Prep for rec-4.4.0-rc2

Merge pull request #9578 from zeha/fix-gai-call

Fix error checking on one getaddrinfo call

Merge pull request #9566 from omoerbeek/rec-make-ns-loop-test-deterministic

rec: Switch off IPv4 for test_glueless_referral_loop test to make sure there's only one IP per nameserver

Apply suggestions from code review

Co-authored-by: Remi Gacogne <rgacogne+github@valombre.net>

Rewrite OpenSSLRSADNSCryptoKeyEngine::fromISCMap to be less tricky

Merge pull request #9589 from Habbie/github-codeql-split-jobs

codeql: separate build steps for auth/rec/dnsdist

reduce dnsdist build concurrency

codeql: separate build steps for auth/rec/dnsdist

Merge pull request #9587 from omoerbeek/auth-include-guard

Missing include guards as noted by CodeQL

Merge pull request #9586 from omoerbeek/codeql-errors

rec: NULL check for return value of mutable_response() as noted by CodeQL

Missing include guards as noted by CodeQL

NULL check for return value of mutable_response() as noted by CodeQL

Merge pull request #9432 from omoerbeek/rec-parse-ip-port

Rec: make parse ip:port a bit smarter

Make comments less confusing

Better way to distinguish IPV6 vs IPV4L count colons, plus explicitly
verify port in unit tests.

Move parseIPAndPort() to iputils and add unit test

Try to be abit more smart in recognizing IP:port combos for both
IPV4 and IPv6.

Should fix #7743

Merge pull request #9584 from mind04/pdns-always-true

auth: remove always true conditions in zone2sql

Merge pull request #9534 from PowerDNS/enable-github-code-scanning

enable code scanning

Merge pull request #9413 from omoerbeek/rec-upgrade-guide-44

rec: News/changed settings for 4.4.x upgrade guide.

More strict parsing of unknown record format

Merge pull request #9580 from zeha/cav6macos

Support serving APL records pointing to fe80:: on macOS

Prep for rec-4.4.0-rc2

enable GitHub CodeQL code scanning