docs-xml/smbdotconf/protocol/easupport.xml

   1 <samba:parameter name="ea support"
   2                  context="S"
   3                  type="boolean"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6     <para>This boolean parameter controls whether <citerefentry><refentrytitle>smbd</refentrytitle>
   7     <manvolnum>8</manvolnum></citerefentry> will allow clients to attempt to access extended
   8     attributes on a share. In order to enable this parameter on a setup with default VFS modules:
   9     </para>
  10     <itemizedlist>
  11         <listitem><para>Samba must have been built with extended attributes support.
  12         </para></listitem>
  13         <listitem><para>The underlying filesystem exposed by the share must support extended
  14         attributes (e.g. the getfattr<manvolnum>1</manvolnum> / setfattr<manvolnum>1</manvolnum>
  15         utilities must work).
  16         </para></listitem>
  17     </itemizedlist>
  18     <para>
  19     Note that the SMB protocol allows setting attributes whose value is 64K bytes long,
  20     and that on NTFS, the maximum storage space for extended attributes per file is 64K.
  21     On most UNIX systems (Solaris and ZFS file system being the exception), the limits
  22     are much lower - typically 4K. Worse, the same 4K space is often used to store
  23     system metadata such as POSIX ACLs, or Samba's NT ACLs. Giving clients
  24     access to this tight space via extended attribute support could consume all
  25     of it by unsuspecting client applications, which would prevent changing
  26     system metadata due to lack of space.
  27     </para>
  28 </description>
  29
  30 <value type="default">no</value>
  31 </samba:parameter>