From: Charles-Henri Bruyand Date: Tue, 21 Mar 2023 17:07:55 +0000 (+0100) Subject: auth: explicit documentation about sets for ifportup() X-Git-Tag: auth-4.8.0-beta1~9^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fe8e05d6240b6f1e0ccf35d530b0d65824d55610;p=thirdparty%2Fpdns.git auth: explicit documentation about sets for ifportup() --- diff --git a/docs/lua-records/index.rst b/docs/lua-records/index.rst index c3e08efbcd..66d0b82876 100644 --- a/docs/lua-records/index.rst +++ b/docs/lua-records/index.rst @@ -49,6 +49,14 @@ addresses listen on port 443. If either IP address stops listening, only the other address will be returned. If all IP addresses are down, all candidates are returned. +You can also provide multiple sets of IP addresses to prioritize a set over the +rest. If an IP address from the first set is available, it will be returned. If +no addresses work in the first set, the second set is tried. + +For example:: + + www IN LUA A "ifportup(443, {{'192.0.2.1', '192.0.2.2'}, {'192.0.3.1'}})" + Because DNS queries require rapid answers, server availability is not checked synchronously. In the background, a process periodically determines if IP addresses mentioned in availability rules are, in fact, available.