sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-01-08 21:18:16 +03:00
Code

docs-xml/manpages: Add warning about write-behind translator for vfs_glusterfs

Browse Source 
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>
This commit is contained in:
Sachin Prabhu 2020-10-15 12:14:33 +01:00 committed by Jeremy Allison
parent 4bf010309c
commit 08f8f665d4
1 changed files with 22 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs-xml/manpages/vfs_glusterfs.8.xml
View File

@ -161,6 +161,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>