Blame SOURCES/0018-data_provider_be-MAN-page-update.patch

8ad293
From 171b664ec4a7c94583b35597bd7e1e72bf89d217 Mon Sep 17 00:00:00 2001
8ad293
From: =?UTF-8?q?Pawe=C5=82=20Po=C5=82awski?= <ppolawsk@redhat.com>
8ad293
Date: Wed, 2 Dec 2020 03:10:50 +0100
8ad293
Subject: [PATCH 18/18] data_provider_be: MAN page update
8ad293
8ad293
Updated description of parameters:
8ad293
* offline_timeout
8ad293
* offline_timeout_max
8ad293
8ad293
MAN page now explains that in some circumstances
8ad293
corelation of offline_timeout and offline_timeout_max values
8ad293
may lead to offline checking interval not incrementing.
8ad293
This is a false positive error as in fact the value
8ad293
just saturates almost instantly.
8ad293
8ad293
Reviewed-by: Iker Pedrosa <ipedrosa@redhat.com>
8ad293
---
8ad293
 src/man/sssd.conf.5.xml | 14 ++++++++++++--
8ad293
 1 file changed, 12 insertions(+), 2 deletions(-)
8ad293
8ad293
diff --git a/src/man/sssd.conf.5.xml b/src/man/sssd.conf.5.xml
8ad293
index d637e2eaa..8b330de58 100644
8ad293
--- a/src/man/sssd.conf.5.xml
8ad293
+++ b/src/man/sssd.conf.5.xml
8ad293
@@ -739,12 +739,12 @@
8ad293
                              offline_timeout + random_offset
8ad293
                         </para>
8ad293
                         <para>
8ad293
-                            The random offset can increment up to 30 seconds.
8ad293
+                            The random offset value is from 0 to 30.
8ad293
                             After each unsuccessful attempt to go online,
8ad293
                             the new interval is recalculated by the following:
8ad293
                         </para>
8ad293
                         <para>
8ad293
-                            new_interval = old_interval*2 + random_offset
8ad293
+                            new_interval = (old_interval * 2) + random_offset
8ad293
                         </para>
8ad293
                         <para>
8ad293
                             Note that the maximum length of each interval
8ad293
@@ -769,6 +769,16 @@
8ad293
                         <para>
8ad293
                             A value of 0 disables the incrementing behaviour.
8ad293
                         </para>
8ad293
+                        <para>
8ad293
+                            The value of this parameter should be set in correlation
8ad293
+                            to offline_timeout parameter value.
8ad293
+                        </para>
8ad293
+                        <para>
8ad293
+                            With offline_timeout set to 60 (default value) there is no point
8ad293
+                            in setting offlinet_timeout_max to less than 120 as it will
8ad293
+                            saturate instantly. General rule here should be to set
8ad293
+                            offline_timeout_max to at least 4 times offline_timeout.
8ad293
+                        </para>
8ad293
                         <para>
8ad293
                             Although a value between 0 and offline_timeout may be
8ad293
                             specified, it has the effect of overriding the
8ad293
-- 
8ad293
2.21.3
8ad293