docs: Explain why this option should not be used

[mat/samba.git] / docs-xml / smbdotconf / winbind / winbinddsocketdirectory.xml

diff --git a/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml b/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml
index 1f8c5797bdc5e5dca169257f242e0b0521399f31..5fd32ffb3ea9e87d7af93fd44e013245b8cf42ba 100644 (file)
--- a/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml
+++ b/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml
@@ -5,6 +5,11 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
        <para>This setting controls the location of the winbind daemon's socket.</para>
+       <para>Except within automated test scripts, this should not be
+       altered, as the client tools (nss_winbind etc) do not honour
+       this parameter.  Client tools must then be advised of the
+       altered path with the WINBINDD_SOCKET_DIR environment
+       varaible.</para>
 </description>
 
 <related>winbindd privileged socket directory</related>