[SCM] Samba Shared Repository - branch master updated

[Ralph Böhme]

The branch, master has been updated
       via  65aafb1 doc: update "ea support" section of the smb.conf manpage
      from  9eb46d5 winbindd: avoid multiple wbint_LookupSids/lsa_LookupSids calls to the same domain

https://git.samba.org/?p=samba.git;a=shortlog;h=master


- Log -----------------------------------------------------------------
commit 65aafb14b7bb0f928d6e076602c2c1d11e11b3dd
Author: Uri Simchoni <uri at samba.org>
Date:   Fri Mar 3 22:00:00 2017 +0200

    doc: update "ea support" section of the smb.conf manpage
    
    This section was badly outdated.
    
    Signed-off-by: Uri Simchoni <uri at samba.org>
    Reviewed-by: Ralph Boehme <slow at samba.org>
    
    Autobuild-User(master): Ralph Böhme <slow at samba.org>
    Autobuild-Date(master): Sun Mar 12 21:04:11 CET 2017 on sn-devel-144

-----------------------------------------------------------------------

Summary of changes:
 docs-xml/smbdotconf/protocol/easupport.xml | 27 +++++++++++++++++++++------
 1 file changed, 21 insertions(+), 6 deletions(-)


Changeset truncated at 500 lines:

diff --git a/docs-xml/smbdotconf/protocol/easupport.xml b/docs-xml/smbdotconf/protocol/easupport.xml
index 4c98267..b453b86 100644
--- a/docs-xml/smbdotconf/protocol/easupport.xml
+++ b/docs-xml/smbdotconf/protocol/easupport.xml
@@ -4,12 +4,27 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
     <para>This boolean parameter controls whether <citerefentry><refentrytitle>smbd</refentrytitle>                                       
-    <manvolnum>8</manvolnum></citerefentry> will allow clients to attempt to store OS/2 style Extended
-    attributes on a share. In order to enable this parameter the underlying filesystem exported by
-    the share must support extended attributes (such as provided on XFS and EXT3 on Linux, with the
-    correct kernel patches). On Linux the filesystem must have been mounted with the mount
-        option user_xattr in order for extended attributes to work, also
-		extended attributes must be compiled into the Linux kernel.</para>
+    <manvolnum>8</manvolnum></citerefentry> will allow clients to attempt to access extended
+    attributes on a share. In order to enable this parameter on a setup with default VFS modules:
+    </para>
+    <itemizedlist>
+	<listitem><para>Samba must have been built with extended attributes support.
+	</para></listitem>
+	<listitem><para>The underlying filesystem exposed by the share must support extended
+	attributes (e.g. the getfattr<manvolnum>1</manvolnum> / setfattr<manvolnum>1</manvolnum>
+	utilities must work).
+	</para></listitem>
+    </itemizedlist>
+    <para>
+    Note that the SMB protocol allows setting attributes whose value is 64K bytes long,
+    and that on NTFS, the maximum storage space for extended attributes per file is 64K.
+    On most UNIX systems (Solaris and ZFS file system being the exception), the limits
+    are much lower - typically 4K. Worse, the same 4K space is often used to store
+    system metadata such as POSIX ACLs, or Samba's NT ACLs. Giving clients
+    access to this tight space via extended attribute support could consume all
+    of it by unsuspecting client applications, which would prevent changing
+    system metadata due to lack of space.
+    </para>
 </description>
 
 <value type="default">no</value>


-- 
Samba Shared Repository