mirror of
https://github.com/samba-team/samba.git
synced 2024-12-24 21:34:56 +03:00
fcaeffde4e
BUG: https://bugzilla.samba.org/show_bug.cgi?id=9531 Signed-off-by: Karolin Seeger <kseeger@samba.org> Reviewed-by: Stefan Metzmacher <metze@samba.org> Reviewed-by: Andreas Schneider <asn@samba.org> Autobuild-User(master): Andreas Schneider <asn@cryptomilk.org> Autobuild-Date(master): Wed Dec 13 17:22:01 CET 2017 on sn-devel-144
99 lines
3.0 KiB
XML
99 lines
3.0 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
|
|
<refentry id="vfs_streams_xattr.8">
|
|
|
|
<refmeta>
|
|
<refentrytitle>vfs_streams_xattr</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
<refmiscinfo class="source">Samba</refmiscinfo>
|
|
<refmiscinfo class="manual">System Administration tools</refmiscinfo>
|
|
<refmiscinfo class="version">&doc.version;</refmiscinfo>
|
|
</refmeta>
|
|
|
|
|
|
<refnamediv>
|
|
<refname>vfs_streams_xattr</refname>
|
|
<refpurpose>Store alternate data streams in posix xattrs</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>vfs objects = streams_xattr</command>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
|
|
<para>This VFS module is part of the
|
|
<citerefentry><refentrytitle>samba</refentrytitle>
|
|
<manvolnum>7</manvolnum></citerefentry> suite.</para>
|
|
|
|
<para>The <command>vfs_streams_xattr</command> 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 <command>streams_xattr:prefix</command>, but be
|
|
aware that this will also expose those ADS over the SMB extended
|
|
attributes interface.</para>
|
|
|
|
<para>The file system that is shared with this module enabled must
|
|
support xattrs.</para>
|
|
|
|
<para>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.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>streams_xattr:prefix = STRING</term>
|
|
<listitem>
|
|
<para>Name prefix used when storing an ADS in an xattr, defaults to
|
|
<command>user.DosStream.</command>. Changing this will also
|
|
expose ADS over the SMB extended attributes interface.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>streams_xattr:store_stream_type = [yes|no]</term>
|
|
<listitem>
|
|
<para>Whether the xattr names for Alternate Data Streams of type
|
|
"$DATA" are suffixed by the stream type string ":$DATA".
|
|
The default is <command>yes</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>EXAMPLES</title>
|
|
|
|
<programlisting>
|
|
<smbconfsection name="[share]"/>
|
|
<smbconfoption name="vfs objects">streams_xattr</smbconfoption>
|
|
</programlisting>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>AUTHOR</title>
|
|
|
|
<para>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.</para>
|
|
|
|
</refsect1>
|
|
|
|
</refentry>
|