From: Otto Moerbeek Date: Wed, 20 Nov 2019 14:07:56 +0000 (+0100) Subject: Explain the condition that must be true for the adding of auth zones and X-Git-Tag: auth-4.3.0-alpha1~30^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F8563%2Fhead;p=thirdparty%2Fpdns.git 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. --- 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