~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs/htmldocs/manpages/vfs_commit.8.html

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>vfs_commit</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="vfs_commit.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vfs_commit &#8212; flush dirty data at specified intervals</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">vfs objects = commit</code></p></div></div><div class="refsect1" lang="en"><a name="id2522915"></a><h2>DESCRIPTION</h2><p>This VFS module is part of the
 
2
        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>The <code class="literal">vfs_commit</code> VFS module keeps track of
 
3
        the amount of data written to a file and synchronizes it to
 
4
        disk when a specified amount accumulates.
 
5
        </p><p><code class="literal">vfs_commit</code> is useful in two
 
6
        circumstances. First, if you have very precious data, the
 
7
        impact of unexpected power loss can be minimized by a small
 
8
        commit:dthresh value. Secondly, write performance can be
 
9
        improved on some systems by flushing file data early and at
 
10
        regular intervals.</p><p>This module is stackable.</p></div><div class="refsect1" lang="en"><a name="id2483330"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">commit:dthresh = BYTES</span></dt><dd><p>Synchronize file data each time the specified
 
11
                number of bytes has been written.
 
12
                </p><p>The following suffixes may be applied to BYTES:</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">K</code> - BYTES is a number of kilobytes</p></li><li><p><code class="literal">M</code> - BYTES is a number of megabytes</p></li><li><p><code class="literal">G</code> - BYTES is a number of gigabytes</p></li></ul></div></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483389"></a><h2>EXAMPLES</h2><p>Synchronize the file data on the [precious] share after
 
13
        every 512 kilobytes (524288 bytes) of data is written:</p><pre class="programlisting">
 
14
        <em class="parameter"><code>[precious]</code></em>
 
15
        <a class="link" href="smb.conf.5.html#PATH" target="_top">path = /data/precious</a>
 
16
        <a class="link" href="smb.conf.5.html#VFSOBJECTS" target="_top">vfs objects = commit</a>
 
17
        <a class="link" href="smb.conf.5.html#COMMIT:DTHRESH" target="_top">commit:dthresh = 512K</a>
 
18
</pre></div><div class="refsect1" lang="en"><a name="id2483668"></a><h2>CAVEATS</h2><p>On some systems, the data synchronization performed by
 
19
        <code class="literal">commit</code> may reduce performance.
 
20
        </p></div><div class="refsect1" lang="en"><a name="id2483684"></a><h2>VERSION</h2><p>This man page is correct for version 3.0.25 of the Samba suite.
 
21
        </p></div><div class="refsect1" lang="en"><a name="id2483695"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
 
22
        were created by Andrew Tridgell. Samba is now developed
 
23
        by the Samba Team as an Open Source project similar
 
24
        to the way the Linux kernel is developed.</p></div></div></body></html>