docs-xml: Improve documentation for 'winbind reconnect delay'

Signed-off-by: Andreas Schneider <asn@samba.org>
Reviewed-by: Martin Schwenke <martin@meltin.net>
Autobuild-User(master): Andreas Schneider <asn@cryptomilk.org>
Autobuild-Date(master): Wed Apr 29 09:32:21 UTC 2026 on atb-devel-224

diff --git a/docs-xml/smbdotconf/winbind/winbindreconnectdelay.xml b/docs-xml/smbdotconf/winbind/winbindreconnectdelay.xml
index f26fd5efd46b119f57fae0617819c6a522d4e089..22cfc09d7ff4d49dcc4612ec227e1b45a3f8411a 100644 (file)
--- a/docs-xml/smbdotconf/winbind/winbindreconnectdelay.xml
+++ b/docs-xml/smbdotconf/winbind/winbindreconnectdelay.xml
@@ -3,11 +3,18 @@
                  type="integer"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-       <para>This parameter specifies the number of
-       seconds the <citerefentry><refentrytitle>winbindd</refentrytitle>
+       <para>This parameter specifies the number of seconds the
+       <citerefentry><refentrytitle>winbindd</refentrytitle>
        <manvolnum>8</manvolnum></citerefentry> daemon will wait between
-       attempts to contact a Domain controller for a domain that is
-       determined to be down or not contactable.</para>
+       attempts to ping Domain Controllers for domains that have been
+       marked offline. When a domain is offline, winbindd will periodically
+       attempt to contact Domain Controllers to check if they have become
+       available again.</para>
+
+       <para>Before attempting to reconnect, winbindd flushes the negative
+       connection cache for the domain. The negative connection cache stores
+       Domain Controllers that have previously been unresponsive, to avoid
+       repeatedly trying to contact them.</para>
 </description>
 
 <value type="default">30</value>