diff options
author | Sachin Prabhu <sprabhu@redhat.com> | 2020-10-15 12:14:33 +0100 |
---|---|---|
committer | Karolin Seeger <kseeger@samba.org> | 2020-11-03 08:48:45 +0000 |
commit | 8079e2a9116a70726cf99c7e7ad6b4ed0f925fbe (patch) | |
tree | ce7f557c24c926f0ca51d7a388f13957ee56cbfc /docs-xml | |
parent | dbba939ce50627c32df0b7ee0707be1ea1a7623c (diff) | |
download | samba-8079e2a9116a70726cf99c7e7ad6b4ed0f925fbe.tar.gz |
docs-xml/manpages: Add warning about write-behind translator for vfs_glusterfs
Add warning about data corruption with the write-behind translator.
The data corruption is highlighted by the smbtorture test smb2.rw.rw1.
More information about this data corruption issue is available in the
bz.
BUG: https://bugzilla.samba.org/show_bug.cgi?id=14486
Signed-off-by: Sachin Prabhu <sprabhu@redhat.com>
Reviewed-by: Jeremy Allison <jra@samba.org>
Reviewed-by: Guenther Deschner <gd@samba.org>
(cherry picked from commit 08f8f665d409ee7b93840c25a8142f2ce8bacfa1)
Diffstat (limited to 'docs-xml')
-rw-r--r-- | docs-xml/manpages/vfs_glusterfs.8.xml | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/docs-xml/manpages/vfs_glusterfs.8.xml b/docs-xml/manpages/vfs_glusterfs.8.xml index cf3b8e5e384..7a4da1af919 100644 --- a/docs-xml/manpages/vfs_glusterfs.8.xml +++ b/docs-xml/manpages/vfs_glusterfs.8.xml @@ -162,6 +162,28 @@ </refsect1> <refsect1> + <title>CAVEATS</title> + + <para> + The GlusterFS write-behind performance translator, when used + with Samba, could be a source of data corruption. The + translator, while processing a write call, immediately returns + success but continues writing the data to the server in the + background. This can cause data corruption when two clients + relying on Samba to provide data consistency are operating on + the same file. + </para> + <para> + The write-behind translator is enabled by default on GlusterFS. + The vfs_glusterfs plugin will check for the presence of the + translator and refuse to connect if detected. + Please disable the write-behind translator for the GlusterFS + volume to allow the plugin to connect to the volume. + </para> +</refsect1> + + +<refsect1> <title>VERSION</title> <para> |