docs-xml/smbdotconf: deprecated "profile acls"

This doesn't work anymore with modern clients,
and there're better ways to support profiles on a share.

Typically something like this seems to work:

[winprofiles]
  comment = Users profiles New
  path = /data/winprofiles/
  browseable = No
  read only = No
  csc policy = disable
  store dos attributes = yes
  vfs objects = acl_xattr

With chmod 1777 on /data/winprofiles/

In order to work around some locking problems, see
https://bugzilla.samba.org/show_bug.cgi?id=12833

It's also useful to something like this in the global
section in order to detect disconnects reliable:

  socket options = TCP_KEEPCNT=5 TCP_KEEPIDLE=30 TCP_KEEPINTVL=1

Signed-off-by: Stefan Metzmacher <metze@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>

diff --git a/docs-xml/smbdotconf/protocol/profileacls.xml b/docs-xml/smbdotconf/protocol/profileacls.xml
index ade906c0285d96f558a57b657d9807b0636facf8..a660c528a69e1dd37204329ccc237eaf0c8bd359 100644 (file)
--- a/docs-xml/smbdotconf/protocol/profileacls.xml
+++ b/docs-xml/smbdotconf/protocol/profileacls.xml
@@ -1,8 +1,21 @@
 <samba:parameter name="profile acls"
                  context="S"
                  type="boolean"
+                 deprecated="1"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
+       <para>
+       As most system support support posix acls and extended attributes
+       today. The "acl_xattr" vfs module should be used instead of
+       using <smbconfoption name="profile acls">yes</smbconfoption>.
+       Using an vfs module that provides nfs4 acls may also work.
+       </para>
+
+       <para>
+       With modern clients (as of 2017) it's not possible to
+       use <smbconfoption name="profile acls">yes</smbconfoption> anymore.
+       </para>
+
        <para>
        This boolean parameter was added to fix the problems that people have been
        having with storing user profiles on Samba shares from Windows 2000 or
@@ -40,6 +53,9 @@
        On other shares, it might cause incorrect file ownerships.
        </para>
 
+       <para>
+       This parameter is deprecated with Samba 4.7 and will be removed in future versions.
+       </para>
 </description>
 
 <value type="default">no</value>