diff options
Diffstat (limited to 'upstream/archlinux/man8/vfs_commit.8')
| -rw-r--r-- | upstream/archlinux/man8/vfs_commit.8 | 122 |
1 files changed, 122 insertions, 0 deletions
diff --git a/upstream/archlinux/man8/vfs_commit.8 b/upstream/archlinux/man8/vfs_commit.8 new file mode 100644 index 00000000..c5ab7ace --- /dev/null +++ b/upstream/archlinux/man8/vfs_commit.8 @@ -0,0 +1,122 @@ +'\" t +.\" Title: vfs_commit +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 02/19/2024 +.\" Manual: System Administration tools +.\" Source: Samba 4.19.5 +.\" Language: English +.\" +.TH "VFS_COMMIT" "8" "02/19/2024" "Samba 4\&.19\&.5" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +vfs_commit \- flush dirty data at specified intervals +.SH "SYNOPSIS" +.HP \w'\ 'u +vfs objects = commit +.SH "DESCRIPTION" +.PP +This VFS module is part of the +\fBsamba\fR(7) +suite\&. +.PP +The +vfs_commit +VFS module keeps track of the amount of data written to a file and synchronizes it to disk when a specified amount accumulates\&. +.PP +vfs_commit +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\&. +.PP +This module is stackable\&. +.SH "OPTIONS" +.PP +commit:dthresh = BYTES +.RS 4 +Synchronize file data each time the specified number of bytes has been written\&. +.sp +The following suffixes may be applied to BYTES: +.RS +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +K +\- BYTES is a number of kilobytes +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +M +\- BYTES is a number of megabytes +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +G +\- BYTES is a number of gigabytes +.RE +.sp +.RE +.RE +.SH "EXAMPLES" +.PP +Synchronize the file data on the [precious] share after every 512 kilobytes (524288 bytes) of data is written: +.sp +.if n \{\ +.RS 4 +.\} +.nf + \fI[precious]\fR + \m[blue]\fBpath = /data/precious\fR\m[] + \m[blue]\fBvfs objects = commit\fR\m[] + \m[blue]\fBcommit:dthresh = 512K\fR\m[] +.fi +.if n \{\ +.RE +.\} +.SH "CAVEATS" +.PP +On some systems, the data synchronization performed by +commit +may reduce performance\&. +.SH "VERSION" +.PP +This man page is part of version 4\&.19\&.5 of the Samba suite\&. +.SH "AUTHOR" +.PP +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\&. |