Blame SOURCES/014-pcmk_delay_base.patch

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