From: Peter Gervai Date: Mon, 8 Sep 2025 16:10:20 +0000 (+0200) Subject: Update lua2.rst: dns_get_all_domains() args and notes update X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=647f42f70d9368af8ff26d5751d0bc27525009c5;p=thirdparty%2Fpdns.git Update lua2.rst: dns_get_all_domains() args and notes update 1. It requires `DNSName, domaininfo` pair instead of `string, domaininfo` 2. The function is definitely not optimal if one uses lua2 backend to serve a zone, since without it pdns will ignore the zone and requets will never reach this backend. Figuring this out __was__ painful. Signed-off-by: Peter Gervai --- diff --git a/docs/backends/lua2.rst b/docs/backends/lua2.rst index 76f8174fd..d6d835ed5 100644 --- a/docs/backends/lua2.rst +++ b/docs/backends/lua2.rst @@ -119,13 +119,16 @@ NOTES: Get domain information for all domains. OUTPUT: - Return false if not supported or found; otherwise, return a table of string, - domaininfo. See :ref:`dns_get_domaininfo() `. + Return false if not supported or found; otherwise, return a table of +`{ [DNSName] = domaininfo, … }`. See :ref:`dns_get_domaininfo() `. NOTES: This function is **optional**, except if you need primary functionality. It is required if you want to be able to enable the zone cache or to search records. + It is also required if you want to serve a zone **without a SOA in _another_ backend**: if you + don't list your zone here pdns server will reject it (as unknown zone) and the requests will + never reach lua2 backend. ``dns_get_domain_metadata(domain, kind)`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~