summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.8
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
commitfc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch)
treece1e3bce06471410239a6f41282e328770aa404a /upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.8
parentInitial commit. (diff)
downloadmanpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz
manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.8')
-rw-r--r--upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.876
1 files changed, 76 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.8 b/upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.8
new file mode 100644
index 00000000..cf963dc1
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man8/vfs_streams_xattr.8
@@ -0,0 +1,76 @@
+'\" t
+.\" Title: vfs_streams_xattr
+.\" Author: [see the "AUTHOR" section]
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\" Date: 10/23/2023
+.\" Manual: System Administration tools
+.\" Source: Samba 4.19.2-git.328.e4c431e307f150600.1.23SUSE-oS15.0-x86_64
+.\" Language: English
+.\"
+.TH "VFS_STREAMS_XATTR" "8" "10/23/2023" "Samba 4\&.19\&.2\-git\&.328\&." "System Administration tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+vfs_streams_xattr \- Store alternate data streams in posix xattrs
+.SH "SYNOPSIS"
+.HP \w'\ 'u
+vfs objects = streams_xattr
+.SH "DESCRIPTION"
+.PP
+This VFS module is part of the
+\fBsamba\fR(7)
+suite\&.
+.PP
+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\&.
+.PP
+The file system that is shared with this module enabled must support xattrs\&.
+.PP
+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\&.
+.SH "OPTIONS"
+.PP
+streams_xattr:prefix = STRING
+.RS 4
+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\&.
+.RE
+.PP
+streams_xattr:store_stream_type = [yes|no]
+.RS 4
+Whether the xattr names for Alternate Data Streams of type "$DATA" are suffixed by the stream type string ":$DATA"\&. The default is
+yes\&.
+.RE
+.SH "EXAMPLES"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ \fI[share]\fR
+ \m[blue]\fBvfs objects = streams_xattr\fR\m[]
+.fi
+.if n \{\
+.RE
+.\}
+.SH "AUTHOR"
+.PP
+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\&.