1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00
samba-mirror/docs-xml/smbdotconf/misc/smbdmaxxattrsize.xml
Andrew Walker 21934c09bd s3:smbd - support streams larger than 64 KiB
Add support for streams that are larger than 64 KiB in size. Upper
and lower bound are controlled by the parameters smbd max_xattr_size.
Testing against ReFS on Windows (where ADS size is limited in size
shows the server responding with STATUS_FILESYSTEM_LIMITATION.
Do the same in samba for this case.

Currently, large xattrs are supported in FreeBSD.

Signed-off-by: Andrew Walker <awalker@ixsystems.com>
Reviewed-by: Jeremy Allison <jra@samba.org>

Autobuild-User(master): Jeremy Allison <jra@samba.org>
Autobuild-Date(master): Mon May 10 20:16:21 UTC 2021 on sn-devel-184
2021-05-10 20:16:21 +00:00

29 lines
1.4 KiB
XML

<samba:parameter name="smbd max xattr size"
context="S"
type="integer"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>
This parameter controls the maximum size of extended attributes
that may be written to the server as EAs or as alternate data
streams if vfs_streams_xattr is enabled. The maximum size of
extended attributes depends on the Samba server's operating system
and the underlying filesystem. The Linux VFS currently sets an
upper boundary of 64 KiB per extended attribute. FreeBSD does not
set a practical upper limit, but since pread() and pwrite() are not
possible via the extattr on FreeBSD, it is not recommended to
increase this value above a few MiB.
If a client attempts to write an overly-large alternate datastream,
the Samba server will return STATUS_FILESYSTEM_LIMITATION.
If this error is encountered, users may try increasing the maximum
size supported for xattr writes. If this is not possible, and
writes are from a MacOS client and to an AFP_Resource extended
attribute, the user may enable the vfs_fruit module and configure
to allow stream writes for AFP_Resource to an alternative storage
location. See vfs_fruit documentation for further details.
</para>
</description>
<value type="default">65536</value>
</samba:parameter>