Blame SOURCES/014-pcmk_delay_base.patch

f312c6
From 9d812b0401d4cedef53a3cc3653ec782a5c49e37 Mon Sep 17 00:00:00 2001
f312c6
From: Ken Gaillot <kgaillot@redhat.com>
f312c6
Date: Thu, 13 Jan 2022 10:42:02 -0600
f312c6
Subject: [PATCH] Doc: fencer: improve pcmk_delay_base meta-data
f312c6
f312c6
Update its type, since its value can now be a node map as well as a string,
f312c6
and add more detail to its description.
f312c6
---
f312c6
 daemons/fenced/pacemaker-fenced.c | 18 +++++++++++-------
f312c6
 1 file changed, 11 insertions(+), 7 deletions(-)
f312c6
f312c6
diff --git a/daemons/fenced/pacemaker-fenced.c b/daemons/fenced/pacemaker-fenced.c
f312c6
index 1b954be5a4..12f331496c 100644
f312c6
--- a/daemons/fenced/pacemaker-fenced.c
f312c6
+++ b/daemons/fenced/pacemaker-fenced.c
f312c6
@@ -1548,13 +1548,17 @@ main(int argc, char **argv)
f312c6
                PCMK_STONITH_DELAY_BASE);
f312c6
         printf("    <shortdesc lang=\"en\">Enable a base delay for "
f312c6
                "fencing actions and specify base delay value.</shortdesc>\n");
f312c6
-        printf("    <longdesc lang=\"en\">This prevents double fencing when "
f312c6
-               "different delays are configured on the nodes.\nUse this to "
f312c6
-               "enable a static delay for fencing actions.\nThe overall delay "
f312c6
-               "is derived from a random delay value adding this static delay "
f312c6
-               "so that the sum is kept below the maximum delay.\nSet to eg. "
f312c6
-               "node1:1s;node2:5 to set different value per node.</longdesc>\n");
f312c6
-        printf("    <content type=\"time\" default=\"0s\"/>\n");
f312c6
+        printf("    <longdesc lang=\"en\">This enables a static delay for "
f312c6
+               "fencing actions, which can help avoid \"death matches\" where "
f312c6
+               "two nodes try to fence each other at the same time. If "
f312c6
+               PCMK_STONITH_DELAY_MAX " is also used, a random delay will be "
f312c6
+               "added such that the total delay is kept below that value.\n"
f312c6
+               "This can be set to a single time value to apply to any node "
f312c6
+               "targeted by this device (useful if a separate device is "
f312c6
+               "configured for each target), or to a node map (for example, "
f312c6
+               "\"node1:1s;node2:5\") to set a different value per target.\n"
f312c6
+               "    </longdesc>\n");
f312c6
+        printf("    <content type=\"string\" default=\"0s\"/>\n");
f312c6
         printf("  </parameter>\n");
f312c6
 
f312c6
         printf("  <parameter name=\"%s\" unique=\"0\">\n",
f312c6
-- 
f312c6
2.27.0
f312c6