doc: change control socket path and reformat

daemon/lua/config.lua: bind to control socket by default

daemon/worker: expose current working dir to lua

daemon/network: unix socket pre-bind handling

Unlink the unix address in case the file exists, e.g. from previous
unclean run.
Also attempt to create the directory for unix socket in case it doesn't
exist.

lua ffi: add the_args binding

daemon/main: don't automatically open control socket in C code

daemon: support kind=control in net.listen()

daemon/net: handle error binding to AF_UNIX

daemon/net: omit freebind from net.list() for AF_UNIX

daemon/network: make unengaged socket a hard error

Without support for socket activation, it no longer makes sense to
let an ununsed socket pass without error.

daemon/io: don't set socket options for AF_UNIX

reuseaddr/reuseport and freebind only make sense for AF_INET, AF_INET6

daemon: move tty functions to io.c

Merge branch 'fix-sphinx-build' into 'master'

fix sphinx build on older distros

See merge request knot/knot-resolver!923

doc: rename refs and add link to configuration to quickstart

Older versions of sphinx detected "operation" ref as duplicit.

doc/conf: remove some rtd_theme options

These options are not essential and they are only supported with newer
versions of the theme, which are unavailable in older distributions.

Merge branch 'operators-guide' into 'master'

more user-focused docs

See merge request knot/knot-resolver!900

doc: improve text in quickstart install

doc: fix typos

doc TLS server: tiny reformulation

doc cache: clarifications around cache backends

There's only one backend and no other is even in long-term plans.
There used to be some networked backend, but due to synchronous internal
usage of cache these suffered from bad latency and were removed.

doc forwarding: minor clarification

doc: update readthedocs http links

doc: add section about usage without systemd

- mention process management
- describe privileges and capabilities which have to be configured
- move garbage collector to this section, as is it enabled by default

doc: improve ToC navigation

doc: add required attribution for icons in doc/server_terminology.svg

doc: split networking into two parts, add picture with terminology

doc: net_client minor polish

doc: experimental polish

doc: config/performance polish

doc: edns_keepalive polish

doc: rfc7706 polish

doc: polish config/policy section

doc: reorder modules in logging&monitoring section

Reordered according to my intuition.

doc: reorder main config chapters

doc: move DNSSEC to the end, users should not touch it anyway

Also remove extra headers for trust anchors and mode(), this is an
implementation detail not important for users.

doc: move graphite and prometheus do sub-sections of stats

Neither graphire nor Prometheus are useful without stats, and any data
they export needs explanation from stats module so it does not make
sense to separate them.

doc: move custom HTTP services to Devel section

doc: quick start / installation / OpenSUSE: improve link

I believe on the old link it isn't easy to find what to do to "install"
the package.  The new one seems much more user-friendly.

- cherry picked from
  commit 008fbed93c5a04c51369bfccebe5dae0b7f2131e (upstream/operators-guide)
  Author: Vladimír Čunát <vladimir.cunat@nic.cz>
  Date:   2020-01-07 11:23:02 +0100

doc: restructure into smaller sections

doc: remove Operations/Monitoring - it was duplicate of Config/Monitoring

doc: split and redistribute HTTP module pieces into server & monitoring chapters

doc: remove daf module to Policy section

doc: move etcd module into Run-time reconfiguration section

doc: move Cache and Multiple instance chapters into Performance section

It logically belongs here and it will make high-level structure less
crowded.

doc: move reorder_RR() into policy/acl/data manipulation section

doc: move mode() function to DNSSEC & data verification section

doc: human-friendlier version of Zero-downtime restarts

doc: simplify note about Lua as config language

doc: move modules section into basic overview

doc: move verbose() to logging section

doc: simplify chapter names

doc: major docs restructuring

doc: nsid module polish for new docs structure

doc: dnstap module polish for new docs structure

doc: graphite module polish for new docs structure

doc: ta_sentinel polish for new docs structure

doc: restructuring

doc: remove map() command

map() does not work with systemd integration anyway.

doc: remove worker.id and worker.count

These do not work with systemd integration anyway.

doc: restructure docs

Content from the proposed Operator's guide was split into sections and
main chapters were restructured. New structure follows "purposes":
- quick start - installation, startup
- configuration
- operation - performance, monitoring, etc.
- documentatino for developers

doc: fix NEWS structure to fix Sphinx rendering

docs: remove references to kresd-host.lua and kresd-query.lua

These are hacks and we do not support them in any way.

docs: split out all docs for developers last chapter

doc/operators-guide: add query watchdog

doc/operators-guide: add cache recommendations

doc/operators-guide: multiple instances

- rename tuning guide to operator's guide
- refactor multiple instances section
- add instance-specific configuration section with examples

doc/build: omit libuv note about reuseport

Scaling up with -f might be unsupported in the near future, rendering
this comment irrelevant.

doc: move utilizing multiple CPUs to performance tuning

doc: create tuning guide

Merge branch 'padding-misc' into 'master'

lib/resolve: correct EDNS padding logic for failures

See merge request knot/knot-resolver!921

lib/resolve: correct EDNS padding logic for failures

The main problem was that SERVFAILs were not padded;
the recovery of answer->opt_rr has to happen before answer_padding()

Merge branch '525-cache-preallocation' into 'master'

cache: pre-allocating cache file when cache size is being changed

Closes #525

See merge request knot/knot-resolver!917

cache opening: add strerror into the lua exception

Here I'm interested in "No space left on device"

tests/pytests: set a small cache size

With preallocation, the cache for the parallel pytests has to be
small enough so there's enough space to fit multiple of them in
the tmpfs of test machine.

cache: pre-allocating cache file when cache size is being changed

Merge branch 'ci-fixes' into 'master'

ci: fixes

See merge request knot/knot-resolver!918

tests/pytests: create and collect html report

The report has been previously removed, most likely by a mistake.

ci: re-run valgrind test on failure

Merge !911: daemon/main: decrease suggested nofile hard limit to 512k

Closes #476

daemon/main: decrease suggested nofile hard limit to 512k

512k (or more) seems to be hard limit valued used by multiple distros
(fedora, arch, ubuntu, debian).

Closes #476

Merge branch 'https_client_improvemens' into 'master'

HTTPS client improvemens

See merge request knot/knot-resolver!913

utils: add human-readable text to HTTP client library errors

prefill: retry download immendiatelly if cached data cannot be imported

Retry will typically happen if data on disk are corrupted, and in that
case it does not make sense to wait full retry interval.

prefill: remove zone file from disk on failure

Empty zone file was causing errors after restart and user had to wait to
retry interval before re-download. Let's not polute filesystem with
incomplete files.

prefill: allow to use system-wide CA store

It also improves error reporting from store:add() call.
Sometimes the error message from lua-ossl is incomplete. This is fixed
by https://github.com/wahern/luaossl/pull/176.

utils: log errors from HTTPS client library

Previous code inconsistently thrown some errors and returned as string
other ones, so we now return all errors as strings in classic Lua-style.

Merge branch 'ta-test-update-cert' into 'master'

daemon/trust_anchors.test: Turn off expiration date in certificates

See merge request knot/knot-resolver!916

daemon/trust_anchors.test: Turn off expiration date in certificates

Merge branch 'doc-quickstart' into 'master'

Quick start documentation

Closes #500, #499, and #498

See merge request knot/knot-resolver!867

docs: quick start guide: final polish

docs: quick start documentation third draft corrections

docs: quick start documentation third draft

docs: apply suggestion to doc/startguide.rst

docs: quick start documentation second draft

docs: quick start documentation first draft

Merge branch 'freebind' into 'master'

daemon/network: add freebind support

See merge request knot/knot-resolver!898

tests: sanity check for net.listen() and net.list()

modules/http: fix net.listen in config tests

tests/config: add freebind test

bindings/net: throw lua error ofr net.listen() failures

To avoid configuration errors, throw a lua error and crash
if it's not possible to bind as specified in net.listen().

For special use-cases, freebind=true should be used instead.