Blame SOURCES/014-pcmk_delay_base.patch

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