NAME

vfs_streams_xattr - Store alternate data streams in posix xattrs

SYNOPSIS

vfs objects = streams_xattr

DESCRIPTION

This VFS module is part of the samba(7) suite.

The vfs_streams_xattr enables storing of NTFS alternate data streams in the file system. As a normal posix file system does not support the concept of multiple data streams per file, the streams_xattr module stores the data in posix extended attributes (xattrs). The name of these attributes by default is user.DosStream."ADS-NAME". The prefix "user.DosStream." can be changed with the module option streams_xattr:prefix, but be aware that this will also expose those ADS over the SMB extended attributes interface.

The file system that is shared with this module enabled must support xattrs.

Please note that most file systems have severe limitations on the size of xattrs. So this module might work for applications like IE that stores small zone information in streams but will fail for applications that store serious amounts of data in ADSs.

OPTIONS

streams_xattr:prefix = STRING

Name prefix used when storing an ADS in an xattr, defaults to user.DosStream.. Changing this will also expose ADS over the SMB extended attributes interface.

streams_xattr:store_stream_type = [yes|no]

Whether the xattr names for Alternate Data Streams of type "$DATA" are suffixed by the stream type string ":$DATA". The default is yes.

streams_xattr:xattr_compat = [yes|no]

When enabled, the module does not append a trailing 0 byte to the end of the extended attribute data. This parameter must not be changed once data has been written to the share since it may result in dropping the last byte from xattr data. This is primarily a consideration when the administrator wishes to expose extended attributes that have been written by another application as alternate data streams via Samba. An example where this parameter may be required is when migrating a netatalk share to Samba. See manpage for vfs_fruit for additional considerations regarding Netatalk and Samba compatibility. WARNING: this parameter must not be changed on existing Samba shares or new shares that export paths currently or previously have been shared by Samba. The default is yes.

EXAMPLES



        [share]
	vfs objects = streams_xattr

AUTHOR

The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.