.dir-locals.el

+;; emacs local configuration settings for knot source
+;; surmised by dkg on 2017-03-25 12:15:55-0500
+
+((c-mode
+  (indent-tabs-mode . t)
+  (tab-width . 8)
+  (c-basic-offset . 8)
+  (c-file-style . "linux"))
+ )

.dockerignore

+.git

.gitignore

+*.swp
 *~
 *.la
+*.a
 *.o
 *.orig
 *.lo
+*.rej
+*.pyc
+*.pc
 .libs/
 .deps/
-Knot.creator.user*
+.dirstamp
+/tmp
+/Knot.creator.user*
+/Knot.cflags
+/Knot.cxxflags
+/Doxyfile
+/aclocal.m4
+/ar-lib
+/autoscan.log
+/config.guess
+/config.sub
+/config.log
+/config.status
+/libtool
+/ltmain.sh
+/configure
+/configure.scan
+/compile
+/depcomp
+/install-sh
+/missing
+/ylwrap
+/autom4te.cache/
+/src/config.h
+/src/config.h.in
+/src/stamp-*
+/INSTALL
+/m4/libtool.m4
+/m4/ltoptions.m4
+/m4/ltsugar.m4
+/m4/ltversion.m4
+/m4/lt~obsolete.m4
+/test-driver
 Makefile
 Makefile.in
-aclocal.m4
-ar-lib
-autoscan.log
-config.guess
-config.sub
-config.log
-config.status
-libtool
-ltmain.sh
-configure
-configure.scan
-depcomp
-install-sh
-missing
-src/Makefile.in
-src/Makefile
-ylwrap
-autom4te.cache/
-config.h
-config.h.in
-samples/knot.sample.conf
-src/stamp-*
-# Generated sources
-src/*.c
-src/*.h
-*.rc
+/src/lib*/version.h
+
+/samples/knot.sample.conf
+/src/knot/modules/static_modules.h
+
+# dnstap
+/src/contrib/dnstap/Makefile
+/src/contrib/dnstap/Makefile.in
+/src/contrib/dnstap/dnstap.pb-c.c
+/src/contrib/dnstap/dnstap.pb-c.h
+
+# zscanner
+/src/libzscanner/scanner.c
+
+# xdp
+/src/libknot/xdp/bpf-kernel.ll
+
 # Binaries
-src/unittests
-src/unittests-libknot
-src/unittests-libknot-realdata
-src/unittests-zcompile
-src/knotc
-src/knotd
-src/knot-zcompile
-m4/libtool.m4
-m4/ltoptions.m4
-m4/ltsugar.m4
-m4/ltversion.m4
-m4/lt~obsolete.m4
-src/unittests-xfr
-INSTALL
+/src/kcatalogprint
+/src/kdig
+/src/keymgr
+/src/khost
+/src/kjournalprint
+/src/knotc
+/src/knotd
+/src/knsec3hash
+/src/knsupdate
+/src/kxdpgun
+/src/kzonecheck
+/src/kzonesign
+
+# Generated tarballs
+/knot-*.tar.xz
+
+# Packaging output
+/pkg
+
+# Code coverage
+*.gcda
+*.gcno
+/coverage.info
+/coverage.html
+
+# Vagrant
+.vagrant
+
+# eclipse
+/.project
+/.cproject
+/.settings/
+
+# cygwin
+*.exe
+*.exe.manifest
+
+# clang
+.qtc_clangd

.gitlab-ci.yml

+variables:
+  DEBIAN_FRONTEND: noninteractive
+  LC_ALL: C
+  GIT_STRATEGY: fetch
+  DOCKER_DRIVER: overlay2
+  GIT_SUBMODULE_STRATEGY: recursive
+  DISTROTEST_PRIORITY: 6
+  PKGTEST: 0
+
+stages:
+  - image
+  - build
+  - test
+  - pkg
+  - documentation
+
+.image: &image
+  stage: image
+  before_script:
+    - docker info
+  script:
+    - docker login -u gitlab-ci-token -p $CI_JOB_TOKEN $CI_REGISTRY
+    - docker build --no-cache -t "$IMAGE_TAG" "scripts/docker/$IMAGE_NAME-$IMAGE_VER"
+    - docker push "$IMAGE_TAG"
+  tags:
+    - dind
+  only:
+    variables:
+      - $SCHEDULE_TYPE == "weekly"
+
+docker:knot-dns:debian:
+  <<: *image
+  variables:
+    IMAGE_NAME: debian
+    IMAGE_VER: latest
+    IMAGE_TAG: $CI_REGISTRY_IMAGE/$IMAGE_NAME:$IMAGE_VER
+  tags:
+    - dind
+    - amd64
+
+docker:knot-dns:debian-arm64:
+  <<: *image
+  variables:
+    IMAGE_NAME: debian
+    IMAGE_VER: latest
+    IMAGE_TAG: $CI_REGISTRY_IMAGE/$IMAGE_NAME-arm64:$IMAGE_VER
+  tags:
+    - dind
+    - arm64
+
+docker:knot-dns:debian:unstable:
+  <<: *image
+  variables:
+    IMAGE_NAME: debian
+    IMAGE_VER: unstable
+    IMAGE_TAG: $CI_REGISTRY_IMAGE/$IMAGE_NAME:$IMAGE_VER
+  tags:
+    - dind
+    - amd64
+
+docker:knot-dns:ubuntu:
+  <<: *image
+  variables:
+    IMAGE_NAME: ubuntu
+    IMAGE_VER: latest
+    IMAGE_TAG: $CI_REGISTRY_IMAGE/$IMAGE_NAME:$IMAGE_VER
+  tags:
+    - dind
+    - amd64
+
+docker:knot-dns:rocky:
+  <<: *image
+  variables:
+    IMAGE_NAME: rocky
+    IMAGE_VER: latest
+    IMAGE_TAG: $CI_REGISTRY_IMAGE/$IMAGE_NAME:$IMAGE_VER
+  tags:
+    - dind
+    - amd64
+
+docker:knot-dns:fedora:
+  <<: *image
+  variables:
+    IMAGE_NAME: fedora
+    IMAGE_VER: latest
+    IMAGE_TAG: $CI_REGISTRY_IMAGE/$IMAGE_NAME:$IMAGE_VER
+  tags:
+    - dind
+    - amd64
+
+.fedora_latest: &fedora_latest
+  image: "$CI_REGISTRY/knot/knot-dns/fedora:latest"
+  tags:
+    - docker
+    - linux
+    - amd64
+  except:
+    - schedules
+
+.rocky_latest: &rocky_latest
+  image: "$CI_REGISTRY/knot/knot-dns/rocky:latest"
+  tags:
+    - docker
+    - linux
+    - amd64
+  except:
+    - schedules
+
+.debian_stable: &debian_stable
+  image: "$CI_REGISTRY/knot/knot-dns/debian:latest"
+  tags:
+    - docker
+    - linux
+    - amd64
+  except:
+    - schedules
+
+.debian_stable_arm64: &debian_stable_arm64
+  image: "$CI_REGISTRY/knot/knot-dns/debian-arm64:latest"
+  tags:
+    - docker
+    - linux
+    - arm64
+  except:
+    - schedules
+
+.debian_unstable: &debian_unstable
+  image: "$CI_REGISTRY/knot/knot-dns/debian:unstable"
+  tags:
+    - docker
+    - linux
+    - amd64
+  except:
+    - schedules
+
+.ubuntu_latest: &ubuntu_latest
+  image: "$CI_REGISTRY/knot/knot-dns/ubuntu:latest"
+  tags:
+    - docker
+    - linux
+    - amd64
+  except:
+    - schedules
+
+.build: &build_job
+  stage: build
+  script:
+    - autoreconf -fi
+    - ./configure --disable-fastparser --enable-quic $EXTRA_CONFIGURE || ( cat config.log && exit 1 )
+    - make all V=1
+  artifacts:
+    untracked: true
+    expire_in: '1 hour'
+  except:
+    - schedules
+
+.test: &test_job
+  stage: test
+  before_script:
+    - find -exec touch -t $(date +%m%d%H%M) {} \;
+  script:
+    - make check V=1
+  except:
+    - schedules
+
+build:fedora:amd64:
+  <<: *fedora_latest
+  <<: *build_job
+
+test:fedora:amd64:
+  <<: *fedora_latest
+  <<: *test_job
+  dependencies:
+    - build:fedora:amd64
+
+build:rocky:amd64:
+  <<: *rocky_latest
+  <<: *build_job
+
+test:rocky:amd64:
+  <<: *rocky_latest
+  <<: *test_job
+  dependencies:
+    - build:rocky:amd64
+
+build:ubuntu:amd64:
+  <<: *ubuntu_latest
+  <<: *build_job
+
+test:ubuntu:amd64:
+  <<: *ubuntu_latest
+  <<: *test_job
+  dependencies:
+    - build:ubuntu:amd64
+
+build:debian:amd64:
+  variables:
+    EXTRA_CONFIGURE: --enable-xdp=yes
+  <<: *debian_stable
+  <<: *build_job
+  except:  # run on schedules as well, for debian:symbols tests
+
+test:debian:amd64:
+  <<: *debian_stable
+  <<: *test_job
+  dependencies:
+    - build:debian:amd64
+
+build:debian:arm64:
+  <<: *debian_stable_arm64
+  <<: *build_job
+
+test:debian:arm64:
+  <<: *debian_stable_arm64
+  <<: *test_job
+  dependencies:
+    - build:debian:arm64
+
+build:debian:unstable:amd64:
+  <<: *debian_unstable
+  <<: *build_job
+
+test:debian:unstable:amd64:
+  <<: *debian_unstable
+  <<: *test_job
+  dependencies:
+    - build:debian:unstable:amd64
+
+build:debian:unstable:amd64:asan:
+  variables:
+    CC: clang
+    CFLAGS: "-fsanitize=address -g -O2 -fno-omit-frame-pointer"
+    LDFLAGS: "-fsanitize=address"
+    LSAN_OPTIONS: verbosity=1:log_threads=1
+  allow_failure: true
+  <<: *debian_unstable
+  <<: *build_job
+
+test:debian:unstable:amd64:asan:
+  variables:
+    CC: clang
+    CFLAGS: "-fsanitize=address -g -O2"
+    LDFLAGS: "-fsanitize=address"
+    LSAN_OPTIONS: verbosity=1:log_threads=1
+  allow_failure: true
+  <<: *debian_unstable
+  <<: *test_job
+  dependencies:
+    - build:debian:unstable:amd64:asan
+
+build:debian:unstable:amd64:ubsan:
+  variables:
+    CC: clang
+    CFLAGS: "-fsanitize=undefined -fno-sanitize=nonnull-attribute -g -O2"
+    LDFLAGS: "-fsanitize=undefined"
+    UBSAN_OPTIONS: print_stacktrace=1
+  allow_failure: true
+  <<: *debian_unstable
+  <<: *build_job
+
+test:debian:unstable:amd64:ubsan:
+  variables:
+    CC: clang
+    CFLAGS: "-fsanitize=undefined -fno-sanitize=nonnull-attribute -g -O2"
+    LDFLAGS: "-fsanitize=undefined"
+    UBSAN_OPTIONS: print_stacktrace=1
+  allow_failure: true
+  <<: *debian_unstable
+  <<: *test_job
+  dependencies:
+    - build:debian:unstable:amd64:ubsan
+
+build:archive:
+  <<: *debian_stable
+  stage: build
+  script:
+    - autoreconf -fi
+    - mkdir _build
+    - cd _build
+    - ../configure
+    - make distcheck V=1 DISTCHECK_CONFIGURE_FLAGS="--disable-static" -j2
+    - make html singlehtml
+  only:
+    - master
+    - tags
+    - triggers
+    - schedules
+  except: []
+  artifacts:
+    paths:
+      - _build/*.tar.xz
+      - _build/doc/_build/html
+      - _build/doc/_build/singlehtml
+
+pages:
+  stage: documentation
+  needs:
+    - build:archive
+  script:
+    - mkdir -p public/master
+    - mv _build/doc/_build/html public/master/html
+    - mv _build/doc/_build/singlehtml public/master/singlehtml
+  only:
+    - master
+  artifacts:
+    paths:
+      - public
+
+build:documentation:
+  <<: *debian_stable
+  stage: documentation
+  only:
+    - tags
+    - triggers
+  dependencies:
+    - build:debian:amd64
+  script:
+    - make -C doc html singlehtml pdf epub V=1
+  artifacts:
+    paths:
+      - doc/_build/html/
+      - doc/_build/singlehtml/
+      - doc/_build/latex/KnotDNS.pdf
+      - doc/_build/epub/KnotDNS.epub
+    expire_in: '1 hour'
+
+# packaging tests using apkg
+
+.apkg_image: &apkg_image
+  # apkg images use LC_ALL=C.UTF-8
+  variables:
+    LC_ALL: C.UTF-8
+
+.pkg_test: &pkg_test
+  <<: *apkg_image
+  stage: pkg
+  needs:
+    - pkg:make-archive
+  only:
+    variables:
+      - $PKGTEST == "1"
+  artifacts:
+    paths:
+      - pkg/
+    expire_in: '1 week'
+  script:
+    - python3 -m pip install git+https://gitlab.nic.cz/packaging/apkg.git
+    # make sure the archive from pkg:make-archive is available
+    - apkg info cache | grep archive/dev
+    - apkg install --build-dep
+    - apkg test --test-dep
+
+.pkg_test_deb: &pkg_test_deb
+  <<: *pkg_test
+  before_script:
+    - apt update
+
+pkg:make-archive:
+  # archive is created once and reused in other pkg jobs
+  <<: *apkg_image
+  stage: pkg
+  needs:
+    - build:debian:amd64
+  only:
+    variables:
+      - $PKGTEST == "1"
+  image: $CI_REGISTRY/packaging/apkg/test/debian-12
+  artifacts:
+    paths:
+      - pkg/
+  before_script:
+    - apt update
+  script:
+    - python3 -m pip install apkg
+    - apkg build-dep
+    - apkg make-archive
+
+pkg:debian-13:
+  <<: *pkg_test_deb
+  image: $CI_REGISTRY/packaging/apkg/test/debian-13
+
+pkg:debian-12:
+  <<: *pkg_test_deb
+  image: $CI_REGISTRY/packaging/apkg/test/debian-12
+
+pkg:debian-11:
+  <<: *pkg_test_deb
+  image: $CI_REGISTRY/packaging/apkg/test/debian-11
+
+pkg:ubuntu-24.04:
+  <<: *pkg_test_deb
+  image: $CI_REGISTRY/packaging/apkg/test/ubuntu-24.04
+
+pkg:ubuntu-22.04:
+  <<: *pkg_test_deb
+  image: $CI_REGISTRY/packaging/apkg/test/ubuntu-22.04
+
+pkg:ubuntu-20.04:
+  <<: *pkg_test_deb
+  image: $CI_REGISTRY/packaging/apkg/test/ubuntu-20.04
+
+pkg:fedora-41:
+  <<: *pkg_test
+  image: $CI_REGISTRY/packaging/apkg/test/fedora-41
+
+pkg:fedora-40:
+  <<: *pkg_test
+  image: $CI_REGISTRY/packaging/apkg/test/fedora-40
+
+pkg:alma-9:
+  <<: *pkg_test
+  image: $CI_REGISTRY/packaging/apkg/test/alma-9
+
+pkg:rocky-8:
+  <<: *pkg_test
+  image: $CI_REGISTRY/packaging/apkg/test/rocky-8
+
+pkg:opensuse-15.6:
+  <<: *pkg_test
+  image: $CI_REGISTRY/packaging/apkg/test/opensuse-15.6

.gitmodules

+[submodule "tests-fuzz/fuzz_zscanner.in"]
+	path = tests-fuzz/fuzz_zscanner.in
+	url = https://gitlab.nic.cz/knot/fuzzing/fuzz_zscanner.in.git
+[submodule "tests-fuzz/fuzz_packet.in"]
+	path = tests-fuzz/fuzz_packet.in
+	url = https://gitlab.nic.cz/knot/fuzzing/fuzz_packet.in.git

AUTHORS

-Ľuboš Slovák <lubos.slovak@nic.cz>
-Marek Vavruša <marek.vavrusa@nic.cz>
-Jan Kadlec <jan.kadlec@nic.cz>
-Ondřej Surý <ondrej.sury@nic.cz>
-Ondřej Filip <ondrej.filip@nic.cz>

COPYING

                     GNU GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
 
- Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
@@ -645,7 +645,7 @@ the "copyright" line and a pointer to where the full notice is found.
     GNU General Public License for more details.
 
     You should have received a copy of the GNU General Public License
-    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 Also add information on how to contact you by electronic and paper mail.
 
@@ -664,24 +664,11 @@ might be different; for a GUI interface, you would use an "about box".
   You should also get your employer (if you work as a programmer) or school,
 if any, to sign a "copyright disclaimer" for the program, if necessary.
 For more information on this, and how to apply and follow the GNU GPL, see
-<http://www.gnu.org/licenses/>.
+<https://www.gnu.org/licenses/>.
 
   The GNU General Public License does not permit incorporating your program
 into proprietary programs.  If your program is a subroutine library, you
 may consider it more useful to permit linking proprietary applications with
 the library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.  But first, please read
-<http://www.gnu.org/philosophy/why-not-lgpl.html>.
-
-  In addition, as a special exception, the copyright holders give
-permission to link the code of portions of this program with the
-OpenSSL library under certain conditions as described in each
-individual source file, and distribute linked combinations including
-the two.
-  You must obey the GNU General Public License in all respects for all
-of the code used other than OpenSSL.  If you modify file(s) with this
-exception, you may extend this exception to your version of the
-file(s), but you are not obligated to do so.  If you do not wish to do
-so, delete this exception statement from your version.  If you delete
-this exception statement from all source files in the program, then
-also delete it here.
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

CodingStyle

-Coding style
-============
-* Indentation: TAB (8 spaces width)
-* Braces: K&R, 1TBS
-* Max line width: 80 chars
-* Pointer asterisk attached to the name of the variable
-* Own structures/types: _t suffix (f.e. nameserver_t)
-* Header guard format: _KNOTD__HEADER_H_
-* Spaces around binary operators
-* Space between keyword and bracket (f.e. "if (predicate)")
-* No space between variable and typecast (f.e. "return (int)val;")
-
-To sum it up, Linux KNF is used, see [1].
-
-[1] Linux Coding Style:
-    http://kerneltrap.org/files/Jeremy/CodingStyle.txt
-
-AStyle command format
-=====================
-astyle --style=1tbs -t8 -w -p -H -U -j --align-pointer=name
-
-Doxygen
-=======
-* Format: Qt-style
-  * "\brief", not "@brief"
-  * "/*!", not "/**"
-* Order of sections
-  * brief description
-  * long description
-  * notes
-  * warnings
-  * parameters
-  * return values
-  * todos
-* Always use \brief (no autobrief)
-* Indent text (using spaces only) in multiple-line sections
-* In multi-line comments, opening line (/*!) should be empty
-* One empty line between two consecutive sections
-* Struct and union members documented on the same line if the comment fits
-* Use \retval (or more of them) instead of \return
-  if the function returns some distinct values
-  (such as 0 for no error, -1 for something else, etc.)
-
-Example
-=======
-/*! 
- * \brief Some structure.
- * 
- * Longer description.
- */
- struct some_struct {
-    /*!
-     * \brief This comment does not fit on the same line as the member
-     *        as it is rather large. 
-     */
-    int fd;
-    int flags; /*!< Flags. */
- };
-
-/*!
- * \brief Brief description of some function.
- *
- * Longer description.
- * 
- * \note This function is deprecated.
- *
- * \warning Do not use this function!
- *
- * \param param1 Some parameter.
- * \param param2 Other parameter. This one has rather large comment,
- *               so its next line is indented for better readability.
- * 
- * \retval 0 on success.
- * \retval -1 if some error occured.
- *
- * \todo Remove (deprecated).
- */

Dockerfile

+## Intermediate stage ##
+FROM debian:bookworm-slim AS builder
+
+# Environment
+ENV BUILD_PKGS \
+    autoconf \
+    automake \
+    gcc \
+    libbpf-dev \
+    libedit-dev \
+    libfstrm-dev \
+    libgnutls28-dev \
+    libidn2-dev \
+    liblmdb-dev \
+    libmaxminddb-dev \
+    libmnl-dev \
+    libnghttp2-dev \
+    libngtcp2-crypto-gnutls-dev \
+    libngtcp2-dev \
+    libprotobuf-c-dev \
+    libsystemd-dev \
+    libtool \
+    liburcu-dev \
+    libxdp-dev \
+    make \
+    pkg-config \
+    protobuf-c-compiler
+
+# Install dependencies
+RUN apt-get update && \
+    apt-get install -yqq ${BUILD_PKGS}
+
+# Build the project
+COPY . /knot-src
+WORKDIR /knot-src
+ARG FASTPARSER=disable
+RUN autoreconf -if && \
+    CFLAGS="-g -O2 -DNDEBUG -D_FORTIFY_SOURCE=3 -fstack-protector-strong" \
+    ./configure --prefix=/ \
+                --with-rundir=/rundir \
+                --with-storage=/storage \
+                --with-configdir=/config \
+                --with-module-dnstap=yes \
+                --${FASTPARSER}-fastparser \
+                --enable-quic \
+                --enable-dnstap \
+                --disable-static \
+                --disable-documentation && \
+    make -j$(grep -c ^processor /proc/cpuinfo)
+
+# Run unittests if requested and install the project
+ARG CHECK=disable
+RUN if [ "$CHECK" = "enable" ]; then make -j$(grep -c ^processor /proc/cpuinfo) check; fi && \
+    make install DESTDIR=/tmp/knot-install
+
+## Final stage ##
+FROM debian:bookworm-slim
+LABEL maintainer="Knot DNS <knot-dns@labs.nic.cz>"
+
+# Environment
+ENV RUNTIME_PKGS \
+    dbus \
+    libbpf1 \
+    libedit2 \
+    libfstrm0 \
+    libgnutls30 \
+    libidn2-0 \
+    liblmdb0 \
+    libmaxminddb0 \
+    libmnl0 \
+    libnghttp2-14 \
+    libngtcp2-crypto-gnutls2 \
+    libngtcp2-9 \
+    libprotobuf-c1 \
+    liburcu8 \
+    libxdp1
+
+# Install dependencies and create knot user and group
+ARG UID=53
+RUN apt-get update && \
+    apt-get install -yqq ${RUNTIME_PKGS} adduser && \
+    rm -rf /var/lib/apt/lists/* && \
+    ldconfig && \
+    adduser --quiet --system --group --no-create-home --home /storage --uid=${UID} knot && \
+    install -o knot -g knot -d /config /rundir /storage
+
+# Copy artifacts
+# `COPY --from=builder /tmp/knot-install/ /` doesn't work with DOCKER_BUILDKIT=1 under buildx
+COPY --from=builder /tmp/knot-install/bin/     /bin/
+COPY --from=builder /tmp/knot-install/config/  /config/
+COPY --from=builder /tmp/knot-install/include/ /include/
+COPY --from=builder /tmp/knot-install/lib/     /lib/
+COPY --from=builder /tmp/knot-install/sbin/    /sbin/
+
+# Prepare configurations for optional D-Bus signaling
+COPY --from=builder /knot-src/distro/common/system-local.conf /etc/dbus-1/
+COPY --from=builder /knot-src/distro/common/cz.nic.knotd.conf /usr/share/dbus-1/system.d/
+RUN mkdir -p /run/dbus
+
+# Expose port
+EXPOSE 53/UDP
+EXPOSE 53/TCP
+EXPOSE 853/UDP
+EXPOSE 853/TCP
+
+# Prepare shared directories
+VOLUME /config
+VOLUME /rundir
+VOLUME /storage

Doxy.page.h

-/*!
-
-\defgroup server            Server control module.
-\defgroup threading         Threading API.
-\defgroup network           Socket API.
-\defgroup config            Server configuration.
-\defgroup query_processing  DNS query processing.
-\defgroup utils             Utilities, constants and macros.
-\defgroup debugging         Server debugging API.
-\defgroup logging           Server logging API.
-\defgroup statistics        Statistics module (optional).
-\defgroup libknot           libknot - library of DNS-related functions
-\defgroup hashing           Hash table and functions.
-\defgroup common_lib        Common library.
-\defgroup alloc             Memory allocation.
-\defgroup tests             Unit tests.
-\defgroup zoneparser        Zone compiler utility
-\defgroup ctl               Control utility
-\defgroup zone-load-dump    Zone loading and dumping
-\defgroup xfr               Zone transfers
-
-\mainpage Knot API documentation.
-
-Knot is an open-source, high-performace, purely authoritative DNS server.
-
-<h2>Features</h2>
-
-Knot DNS supports the following DNS features:
-- TCP/UDP protocols
-- AXFR - master, slave
-- IXFR - master (primary master experimental), slave
-- TSIG
-- ENDS0
-- DNSSEC, including NSEC3
-- NSID
-- Unknown RR types
-
-Server features:
-- Adding/removing zones on-the-fly
-- Reconfiguring server instance on-the-fly
-- IPv4 / IPv6 support
-- Semantic checks of zones
-
-<h2>Compiling and running the server</h2>
-
-See the User manual - links to current version are provided in the
-<a href="https://git.nic.cz/redmine/projects/knot-dns/wiki">Knot DNS Wiki</a>.
-
-Alternatively you can generate the manual from the sources in Info format:
-\code
-$ make doc
-\endcode
-
-or in PDF:
-
-\code
-$ make pdf
-\endcode
-
-<h2>Server modules</h2>
-- \ref server
-- \ref threading
-- \ref network
-- \ref config
-- \ref query_processing
-- \ref utils
-- \ref debugging
-- \ref logging
-- \ref statistics
-
-<h2>DNS library</h2>
-- \ref libknot
-- \ref hashing
-- \ref xfr
-
-<h2>Zone processing</h2>
-- \ref zoneparser
-- \ref zone-load-dump
-
-<h2>Common library</h2>
-- \ref common_lib
-- \ref alloc
-
-<h2>Other modules</h2>
-- \ref tests
-- \ref ctl
- */

KNOWN_ISSUES

-Features not supported
-======================
-
-Here is a list of the most notable features that are not supported in the
-current version of Knot.
-
-* Other DNS classes than IN (CH, CS, HS)
-* Dynamic updates
-
-Known bugs
-==========
-
-* ACL may not always find the best match so it may behave counter-intuitively.
-* Generating journal from reloaded zone adds redundant records to the changes 
-  when the RDATA are in binary format.

Knot.config

-// ADD PREDEFINED MACROS HERE!

Knot.config

+./src/config.h
\ No newline at end of file

Knot.includes

-obj
-src/alloc
-src/ctl
-src/dnslib
-src/hash
-src/lib
-src/other
-src/server
-src/stat
-src/tests/libtap
-src/tests
-src/zoneparser
-src
\ No newline at end of file
+src
+src/contrib
+src/contrib/dnstap
+src/contrib/libngtcp2
+src/contrib/libngtcp2/ngtcp2
+src/contrib/libngtcp2/ngtcp2/crypto
+src/contrib/libngtcp2/ngtcp2/lib
+src/contrib/licenses
+src/contrib/openbsd
+src/contrib/proxyv2
+src/contrib/qp-trie
+src/contrib/ucw
+src/contrib/url-parser
+src/contrib/vpool
+src/knot
+src/knot/catalog
+src/knot/common
+src/knot/conf
+src/knot/ctl
+src/knot/dnssec
+src/knot/dnssec/kasp
+src/knot/events
+src/knot/events/handlers
+src/knot/include
+src/knot/journal
+src/knot/modules
+src/knot/modules/cookies
+src/knot/modules/dnsproxy
+src/knot/modules/dnstap
+src/knot/modules/geoip
+src/knot/modules/noudp
+src/knot/modules/onlinesign
+src/knot/modules/probe
+src/knot/modules/queryacl
+src/knot/modules/rrl
+src/knot/modules/stats
+src/knot/modules/synthrecord
+src/knot/modules/whoami
+src/knot/nameserver
+src/knot/query
+src/knot/server
+src/knot/updates
+src/knot/worker
+src/knot/zone
+src/libdnssec
+src/libdnssec/key
+src/libdnssec/keystore
+src/libdnssec/nsec
+src/libdnssec/p11
+src/libdnssec/shared
+src/libdnssec/sign
+src/libknot
+src/libknot/control
+src/libknot/db
+src/libknot/packet
+src/libknot/probe
+src/libknot/rrtype
+src/libknot/xdp
+src/libknot/yparser
+src/libzscanner
+src/utils
+src/utils/common
+src/utils/kcatalogprint
+src/utils/kdig
+src/utils/keymgr
+src/utils/khost
+src/utils/kjournalprint
+src/utils/knotc
+src/utils/knotd
+src/utils/knsec3hash
+src/utils/knsupdate
+src/utils/knsupdate/tests
+src/utils/kxdpgun
+src/utils/kzonecheck
+src/utils/kzonesign
+tests
+tests/contrib
+tests-fuzz
+tests-fuzz/check
+tests-fuzz/knotd_wrap
+tests/knot
+tests/knot/semantic_check_data
+tests/libdnssec
+tests/libknot
+tests/libzscanner
+tests/libzscanner/data
+tests/libzscanner/data/includes
+tests/modules
+tests/tap
+tests/utils

Makefile.am

 ACLOCAL_AMFLAGS = -I m4
-SUBDIRS = src samples doc
+SUBDIRS = src tests tests-fuzz python samples distro doc
+
+EXTRA_DIST = README.md
+
+.PHONY: singlehtml epub install-singlehtml install-epub
+singlehtml install-singlehtml epub install-epub:
+	$(MAKE) -C doc $@
+
+.PHONY: check-compile
+check-compile:
+	$(MAKE) $(AM_MAKEFLAGS) -C tests $@
+	$(MAKE) $(AM_MAKEFLAGS) -C tests-fuzz $@
+
+AM_DISTCHECK_CONFIGURE_FLAGS =
+
+CODE_COVERAGE_INFO = coverage.info
+CODE_COVERAGE_HTML = coverage.html
+CODE_COVERAGE_DIRS =		\
+	src/contrib		\
+	src/knot		\
+	src/libdnssec		\
+	src/libknot		\
+	src/libzscanner
+
+code_coverage_quiet = --quiet
+
+check-code-coverage:
+if CODE_COVERAGE_ENABLED
+	$(MAKE) $(AM_MAKEFLAGS) code-coverage-initial
+	-$(MAKE) $(AM_MAKEFLAGS) -k check
+	$(MAKE) $(AM_MAKEFLAGS) code-coverage-capture
+	$(MAKE) $(AM_MAKEFLAGS) code-coverage-html
+	$(MAKE) $(AM_MAKEFLAGS) code-coverage-summary
+else
+	@echo "You need to run configure with --enable-code-coverage to enable code coverage"
+endif
+
+code-coverage-initial:
+if CODE_COVERAGE_ENABLED
+	$(LCOV) $(code_coverage_quiet) \
+		--no-external \
+		$(foreach dir, $(CODE_COVERAGE_DIRS), --directory $(top_builddir)/$(dir)) \
+		--capture --initial \
+		--ignore-errors source \
+		--no-checksum \
+		--compat-libtool \
+		--output-file $(CODE_COVERAGE_INFO)
+else
+	@echo "You need to run configure with --enable-code-coverage to enable code coverage"
+endif
+
+code-coverage-capture:
+if CODE_COVERAGE_ENABLED
+	$(LCOV) $(code_coverage_quiet) \
+		--no-external \
+		$(foreach dir, $(CODE_COVERAGE_DIRS), --directory $(builddir)/$(dir)) \
+		--capture \
+		--ignore-errors source \
+		--no-checksum \
+		--compat-libtool \
+		--output-file $(CODE_COVERAGE_INFO)
+else
+	@echo "You need to run configure with --enable-code-coverage to enable code coverage"
+endif
+
+code-coverage-html:
+if CODE_COVERAGE_ENABLED
+	@echo "Generating code coverage HTML report (this might take a while)"
+	LANG=C $(GENHTML) $(code_coverage_quiet) \
+		--output-directory $(CODE_COVERAGE_HTML) \
+		--title "Knot DNS $(PACKAGE_VERSION) Code Coverage" \
+		--legend --show-details \
+		--ignore-errors source \
+		$(CODE_COVERAGE_INFO)
+else
+	@echo "You need to run configure with --enable-code-coverage to enable code coverage"
+endif
+
+code-coverage-summary:
+if CODE_COVERAGE_ENABLED
+	$(LCOV) \
+		--summary $(CODE_COVERAGE_INFO)
+else
+	@echo "You need to run configure with --enable-code-coverage to enable code coverage"
+endif
+
+if CODE_COVERAGE_ENABLED
+clean-local: code-coverage-clean
+	-find . -name "*.gcno" -delete
+code-coverage-clean:
+	-$(LCOV) --directory $(top_builddir) -z
+	-rm -rf $(CODE_COVERAGE_INFO) $(CODE_COVERAGE_HTML)
+	-find . -name "*.gcda" -o -name "*.gcov" -delete
+endif
+
+
+.PHONY: check-code-coverage code-coverage-initial code-coverage-capture code-coverage-html code-coverage-summary code-coverage-clean
+.NOTPARALLEL: clean