[SCM] Samba Shared Repository - branch v3-3-test updated -
release-3-2-0pre2-3289-gff158a1
Volker Lendecke
vlendec at samba.org
Fri Jul 18 09:20:28 GMT 2008
The branch, v3-3-test has been updated
via ff158a11263fd9fd46131d3451293d8d92fa0cca (commit)
via 9393cdda97a886f4bdd187d76461724edeec9ed3 (commit)
from 6e9e85b897431d7378396aada2c32ae470af0edd (commit)
http://gitweb.samba.org/?p=samba.git;a=shortlog;h=v3-3-test
- Log -----------------------------------------------------------------
commit ff158a11263fd9fd46131d3451293d8d92fa0cca
Author: Volker Lendecke <vl at samba.org>
Date: Fri Jul 18 11:18:04 2008 +0200
Document the streams modules
commit 9393cdda97a886f4bdd187d76461724edeec9ed3
Author: Volker Lendecke <vl at samba.org>
Date: Fri Jul 18 11:17:33 2008 +0200
Change the directory parameter in streams_depot to become consistent
This is not built by default and not documented in 3.2.0, so I doubt this will
break any setups :-)
(cherry picked from commit ca2dfb372cfd9096407fca67a6b65bceda6f72b6)
-----------------------------------------------------------------------
Summary of changes:
...vfs_xattr_tdb.8.xml => vfs_streams_depot.8.xml} | 45 ++++++++-----
docs-xml/manpages-3/vfs_streams_xattr.8.xml | 68 ++++++++++++++++++++
source/modules/vfs_streams_depot.c | 2 +-
3 files changed, 96 insertions(+), 19 deletions(-)
copy docs-xml/manpages-3/{vfs_xattr_tdb.8.xml => vfs_streams_depot.8.xml} (51%)
create mode 100644 docs-xml/manpages-3/vfs_streams_xattr.8.xml
Changeset truncated at 500 lines:
diff --git a/docs-xml/manpages-3/vfs_xattr_tdb.8.xml b/docs-xml/manpages-3/vfs_streams_depot.8.xml
similarity index 51%
copy from docs-xml/manpages-3/vfs_xattr_tdb.8.xml
copy to docs-xml/manpages-3/vfs_streams_depot.8.xml
index 4f3b702..3a11319 100644
--- a/docs-xml/manpages-3/vfs_xattr_tdb.8.xml
+++ b/docs-xml/manpages-3/vfs_streams_depot.8.xml
@@ -1,9 +1,9 @@
<?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_xattr_tdb.8">
+<refentry id="vfs_streams_depot.8">
<refmeta>
- <refentrytitle>vfs_xattr_tdb</refentrytitle>
+ <refentrytitle>vfs_streams_depot</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="source">Samba</refmiscinfo>
<refmiscinfo class="manual">System Administration tools</refmiscinfo>
@@ -12,48 +12,57 @@
<refnamediv>
- <refname>vfs_xattr_tdb</refname>
- <refpurpose>Save Extended Attributes (EAs) in a tdb file</refpurpose>
+ <refname>vfs_streams_depot</refname>
+ <refpurpose>EXPERIMENTAL module to store alternate data streams in a
+ central directory.
+ </refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- <command>vfs objects = xattr_tdb</command>
+ <command>vfs objects = streams_depot</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
- <para>This VFS module is part of the
+ <para>This <emphasis>EXPERIMENTAL</emphasis> VFS module is part of the
<citerefentry><refentrytitle>samba</refentrytitle>
<manvolnum>7</manvolnum></citerefentry> suite.</para>
- <para>The <command>vfs_xattr_tdb</command> VFS module stores
- Extended Attributes (EAs) in a tdb file.
- This enables the usage of Extended Attributes on OS and
- filesystems which do not support Extended Attributes
- by themselves.
- </para>
+ <para>The <command>vfs_streams_depot</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_depot module stores the data in files in a separate
+ directory.</para>
- <para>This module is stackable.</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
+
<varlistentry>
- <term>xattr_tdb:file = PATH</term>
+ <term>streams_depot:directory = PATH</term>
<listitem>
- <para>Name of the tdb file the EAs are stored in.
- If this option is not set, the default filename
- <filename>xattr.tdb</filename> is used.</para>
+ <para>Path of the directory where the alternate data streams
+ should be stored. Defaults to the sharepath/.streams.</para>
</listitem>
</varlistentry>
+
</variablelist>
+</refsect1>
+
+<refsect1>
+ <title>EXAMPLES</title>
+
+<programlisting>
+ <smbconfsection name="[share]"/>
+ <smbconfoption name="vfs objects">streams_depot</smbconfoption>
+</programlisting>
-
</refsect1>
<refsect1>
diff --git a/docs-xml/manpages-3/vfs_streams_xattr.8.xml b/docs-xml/manpages-3/vfs_streams_xattr.8.xml
new file mode 100644
index 0000000..50649af
--- /dev/null
+++ b/docs-xml/manpages-3/vfs_streams_xattr.8.xml
@@ -0,0 +1,68 @@
+<?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">3.2</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 is
+ user.DosStream."ADS-NAME".</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>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>
diff --git a/source/modules/vfs_streams_depot.c b/source/modules/vfs_streams_depot.c
index fa85ea4..d8c476f 100644
--- a/source/modules/vfs_streams_depot.c
+++ b/source/modules/vfs_streams_depot.c
@@ -118,7 +118,7 @@ static char *stream_dir(vfs_handle_struct *handle, const char *base_path,
uint8 id_buf[16];
const char *rootdir = lp_parm_const_string(
- SNUM(handle->conn), "streams", "directory",
+ SNUM(handle->conn), "streams_depot", "directory",
handle->conn->connectpath);
if (base_sbuf == NULL) {
--
Samba Shared Repository
More information about the samba-cvs
mailing list