From 0d5f112bdbeb6252b91d574f30f729ff75c8193d Mon Sep 17 00:00:00 2001 From: Otto Moerbeek Date: Wed, 20 Nov 2019 15:07:56 +0100 Subject: [PATCH] Explain the condition that must be true for the adding of auth zones and forwarding zones. Fixes #5376, though the code could use some proper use checking as well. --- pdns/recursordist/docs/http-api/zone.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/pdns/recursordist/docs/http-api/zone.rst b/pdns/recursordist/docs/http-api/zone.rst index 71611cf3c5..3de3f069c8 100644 --- a/pdns/recursordist/docs/http-api/zone.rst +++ b/pdns/recursordist/docs/http-api/zone.rst @@ -23,4 +23,16 @@ Comments are per-RRset. :property [str] servers: For zones of type "Forwarded", addresses to send the queries to :property bool recursion_desired: For zones of type "Forwarded", Whether or not the RD bit should be set in the query +To properly process new zones, the following conditions must +be true: + +* ``forward-zones``, ``forward-zones-recurse`` and/or ``auth-zones`` + settings must be set (possibly to the empty string) in a + configuration file. These settings must not be overriden on the + command line. Setting these options on the command line will + override what has been set in the dynamically generated + configuration files. +* ``include-dir`` must refer to the same directory as + ``api-config-dir`` for the dynamic reloading to work. + .. include:: ../common/api/zone.rst -- 2.47.2