blob: 588311351a0de36336f78a5e5eae86d21eaa103c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
<?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_syncops.8">
<refmeta>
<refentrytitle>vfs_syncops</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="source">Samba</refmiscinfo>
<refmiscinfo class="manual">System Administration tools</refmiscinfo>
<refmiscinfo class="version">4.4</refmiscinfo>
</refmeta>
<refnamediv>
<refname>vfs_syncops</refname>
<refpurpose>Ensure meta data operations are performed synchronously.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>vfs objects = syncops</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>
Some filesystems (even some journaled filesystems) require that a
fsync() be performed on many meta data operations to ensure that the
operation is guaranteed to remain in the filesystem after a power
failure. This is particularly important for some cluster filesystems
which are participating in a node failover system with clustered
Samba. On those filesystems the <command>vfs_syncops</command> VFS module
provides a way to perform those operations safely.
</para>
<para>This module is stackable.</para>
</refsect1>
<refsect1>
<title>CONFIGURATION</title>
<para>
Most of the performance loss with the <command>vfs_syncops</command>
VFS module is in fsync on close(). You can disable that with
<command>syncops:onclose = no</command> that can be set either globally
or per share.
</para>
<para>
On certain filesystems that only require the last data written to be
fsync()'ed, you can disable the metadata synchronization of this module with
<command>syncops:onmeta = no</command>. This option can be set either
globally or per share.
</para>
<para>
The <command>vfs_syncops</command> VFS module can also be disabled
completely for a share with <command>syncops:disable = true</command>.
</para>
</refsect1>
<refsect1>
<title>EXAMPLES</title>
<para>Add syncops functionality for [share]:</para>
<programlisting>
<smbconfsection name="[share]"/>
<smbconfoption name="path">/data/share</smbconfoption>
<smbconfoption name="vfs objects">syncops</smbconfoption>
<smbconfoption name="syncops:onclose">no</smbconfoption>
</programlisting>
</refsect1>
<refsect1>
<title>VERSION</title>
<para>This man page is correct for version 4.1.0 of the Samba suite.
</para>
</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>
|
