mirror of
https://github.com/samba-team/samba.git
synced 2025-01-07 17:18:11 +03:00
69273c3a83
Update documentation to match current behavior. Signed-off-by: Daniel Kobras <kobras@puzzle-itc.de> Reviewed-by: Jeremy Allison <jra@samba.org> Reviewed-by: Volker Lendecke <vl@samba.org> Autobuild-User(master): Volker Lendecke <vl@samba.org> Autobuild-Date(master): Fri Oct 28 07:24:18 UTC 2022 on sn-devel-184
41 lines
2.0 KiB
XML
41 lines
2.0 KiB
XML
<samba:parameter name="ea support"
|
|
context="S"
|
|
type="boolean"
|
|
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 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>
|
|
<listitem><para>Access to extended user attributes must be allowed by the underlying
|
|
filesystem (e.g. when mounted with a system-dependent option like user_xattr on Linux).
|
|
</para></listitem>
|
|
</itemizedlist>
|
|
<para>
|
|
This option exposes the "user" attribute namespace from the underlying filesystem to
|
|
clients. In order to match Windows conventions, the namespace prefix ("user.") is
|
|
stripped from the attribute name on the client side. The handling of further attribute
|
|
namespaces (like "security", "system", or "trusted") is not affected by this option.
|
|
</para>
|
|
<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 some filesystem the limits may be lower. Filesystems with too limited EA
|
|
space may experience unexpected weird effects.
|
|
|
|
|
|
The default has changed to yes in Samba release 4.9.0 and above to allow better Windows
|
|
fileserver compatibility in a default install.
|
|
</para>
|
|
</description>
|
|
|
|
<value type="default">yes</value>
|
|
</samba:parameter>
|