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

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