Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
VFS_STREAMS_XATTR(8)	  System Administration	tools	  VFS_STREAMS_XATTR(8)

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.

Samba 4.20.7			  04/14/2025		  VFS_STREAMS_XATTR(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vfs_streams_xattr&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help