After talking to Michal, here is another edit.

diff --git a/src/man/sssd.conf.5.xml b/src/man/sssd.conf.5.xml
index 2eb0b62..b26237b 100644
--- a/src/man/sssd.conf.5.xml
+++ b/src/man/sssd.conf.5.xml
@@ -406,10 +406,27 @@
                     <term>offline_timeout (integer)</term>
                     <listitem>
                         <para>
-                            If SSSD is in offline mode, and last attempt to go
-                            online was less than number of seconds specified
-                            in this option ago, new requests for data will not
-                            result in attempt to go online.
+                            When SSSD switches to offline mode the amount of
+                            time before it tries to go back online will increase
+                            based upon the time spent disconnected. This value is
+                            in seconds and calculated by the following:
+                        </para>
+                        <para>
+                            offline_timeout + random_offset
+                        </para>
+                        <para>
+                            The random offset can increment up to 30 seconds.
+                            After each unsuccessful attempt to go online,
+                            the new interval is recalculated by the following:
+                        </para>
+                        <para>
+                            new_interval = old_interval*2 + random_offset
+                        </para>
+                        <para>
+                            Note that the maximum length of each interval
+                            is currently limited to one hour. If the
+                            calculated length of new_interval is greater
+                            than an hour, it will be forced to one hour.
                         </para>
                         <para>
                             Default: 60



From: "Michal Židek" <mzidek@redhat.com>
To: "Development of the System Security Services Daemon" <sssd-devel@lists.fedorahosted.org>
Sent: Monday, August 11, 2014 1:00:23 PM
Subject: Re: [SSSD] [PATCH] MAN: offline_timeout

On 08/11/2014 06:03 PM, Dan Lavu wrote:
> Michal,
>
> Proof read and made some changes.

Hi Dan,

I think there is a misunderstanding :) .
The new text I wanted to be checked starts with the
words "When SSSD switches to offline mode". The text
before it is the old one that we are now replacing
(the old text starts in the patch with "-", the new
text with "+").

I think it is safer to keep the expression "offline mode",
not just "offline" because we refer to it on other
places in documentation as well.

>
>                       <term>offline_timeout (integer)</term>
>                       <listitem>
>                          <para>
>                              If SSSD is in offline, and the last attempt to
>                              to go online was less than number of seconds
>                              specified. Any new requests for data will be
>                              retrieved from the cache. When SSSD switches
>                              offline the amount of time in seconds
                                ^^^^^^^
So, I think here we should keep "switches to offline mode".
> before it
>                              tries to go back online is calculated by the
>                              following:
>                          </para>
>                          <para>
>                              offline_timeout + random_offset
>                          </para>
>                          <para>
>                              The random offset can increment up to 30
>                              seconds. After each unsuccessful attempt
>                              to go online, the random_offset is
                                                  ^^^^^^^^^^^^^
Not the random_offset, but the entire interval.
>                              recalculated by the following:
>                          </para>
>                          <para>
>                              new_interval = old_interval*2 + random_offset
>                          </para>
>                          <para>
>                              Note that the maximum length of each interval
>                              is currently limited to one hour. If the
>                              calculated length of new_interval is greater
>                              than an hour, it will be forced to one hour.
>                           </para>
>                           <para>
>                               Default: 60
>
> Dan
>

Thank you Dan, I changed the text based on your suggestions,
but since there were few misunderstandings I would like the
patch to be checked again.

Thanks,
Michal

_______________________________________________
sssd-devel mailing list
sssd-devel@lists.fedorahosted.org
https://lists.fedorahosted.org/mailman/listinfo/sssd-devel