Debian Codegraph @

upstream/opensuse-tumbleweed/man8/vfs_commit.8

raw
1 '\" t
2 .\" Title: vfs_commit
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: System Administration tools
7 .\" Source: Samba 4.23.8-git.477.f78166bceedSUSE-oS16.9-x86_64
8 .\" Language: English
9 .\"
10 .TH "VFS_COMMIT" "8" "05/26/2026" "Samba 4\&.23\&.8\-git\&.477\&.f78166bcee" "System Administration tools"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 vfs_commit \- flush dirty data at specified intervals
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 vfs objects = commit
35 .SH "DESCRIPTION"
36 .PP
37 This VFS module is part of the
38 \fBsamba\fR(7)
39 suite\&.
40 .PP
41 The
42 vfs_commit
43 VFS module keeps track of the amount of data written to a file and synchronizes it to disk when a specified amount accumulates\&.
44 .PP
45 vfs_commit
46 is useful in two circumstances\&. First, if you have very precious data, the impact of unexpected power loss can be minimized by a small commit:dthresh value\&. Secondly, write performance can be improved on some systems by flushing file data early and at regular intervals\&.
47 .PP
48 This module is stackable\&.
49 .SH "OPTIONS"
50 .PP
51 commit:dthresh = BYTES
52 .RS 4
53 Synchronize file data each time the specified number of bytes has been written\&.
54 .sp
55 The following suffixes may be applied to BYTES:
56 .RS
57 .sp
58 .RS 4
59 .ie n \{\
60 \h'-04'\(bu\h'+03'\c
61 .\}
62 .el \{\
63 .sp -1
64 .IP \(bu 2.3
65 .\}
66 K
67 \- BYTES is a number of kilobytes
68 .RE
69 .sp
70 .RS 4
71 .ie n \{\
72 \h'-04'\(bu\h'+03'\c
73 .\}
74 .el \{\
75 .sp -1
76 .IP \(bu 2.3
77 .\}
78 M
79 \- BYTES is a number of megabytes
80 .RE
81 .sp
82 .RS 4
83 .ie n \{\
84 \h'-04'\(bu\h'+03'\c
85 .\}
86 .el \{\
87 .sp -1
88 .IP \(bu 2.3
89 .\}
90 G
91 \- BYTES is a number of gigabytes
92 .RE
93 .sp
94 .RE
95 .RE
96 .SH "EXAMPLES"
97 .PP
98 Synchronize the file data on the [precious] share after every 512 kilobytes (524288 bytes) of data is written:
99 .sp
100 .if n \{\
101 .RS 4
102 .\}
103 .nf
104 \fI[precious]\fR
105 \m[blue]\fBpath = /data/precious\fR\m[]
106 \m[blue]\fBvfs objects = commit\fR\m[]
107 \m[blue]\fBcommit:dthresh = 512K\fR\m[]
108 .fi
109 .if n \{\
110 .RE
111 .\}
112 .SH "CAVEATS"
113 .PP
114 On some systems, the data synchronization performed by
115 commit
116 may reduce performance\&.
117 .SH "VERSION"
118 .PP
119 This man page is part of version 4\&.23\&.8\-git\&.477\&.f78166bceedSUSE\-oS16\&.9\-x86_64 of the Samba suite\&.
120 .SH "AUTHOR"
121 .PP
122 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\&.