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         <listitem><para>Access to extended user attributes must be allowed by the underlying
  18         filesystem (e.g. when mounted with a system-dependent option like user_xattr on Linux).
  19         </para></listitem>
  20     </itemizedlist>
  21     <para>
  22     This option exposes the "user" attribute namespace from the underlying filesystem to
  23     clients. In order to match Windows conventions, the namespace prefix ("user.") is
  24     stripped from the attribute name on the client side. The handling of further attribute
  25     namespaces (like "security", "system", or "trusted") is not affected by this option.
  26     </para>
  27     <para>
  28     Note that the SMB protocol allows setting attributes whose value is 64K bytes long,
  29     and that on NTFS, the maximum storage space for extended attributes per file is 64K.
  30     On some filesystem the limits may be lower. Filesystems with too limited EA
  31     space may experience unexpected weird effects.
  32
  33
  34     The default has changed to yes in Samba release 4.9.0 and above to allow better Windows
  35     fileserver compatibility in a default install.
  36     </para>
  37 </description>
  38
  39 <value type="default">yes</value>
  40 </samba:parameter>