From fe8e05d6240b6f1e0ccf35d530b0d65824d55610 Mon Sep 17 00:00:00 2001 From: Charles-Henri Bruyand Date: Tue, 21 Mar 2023 18:07:55 +0100 Subject: [PATCH] auth: explicit documentation about sets for ifportup() --- docs/lua-records/index.rst | 8 ++++++++ 1 file changed, 8 insertions(+) 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. -- 2.47.2