Debian Codegraph @

upstream/opensuse-tumbleweed/man8/vfs_syncops.8

raw
1 '\" t
2 .\" Title: vfs_syncops
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_SYNCOPS" "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_syncops \- Ensure meta data operations are performed synchronously\&.
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 vfs objects = syncops
35 .SH "DESCRIPTION"
36 .PP
37 This VFS module is part of the
38 \fBsamba\fR(7)
39 suite\&.
40 .PP
41 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
42 vfs_syncops
43 VFS module provides a way to perform those operations safely\&.
44 .PP
45 This module is stackable\&.
46 .SH "CONFIGURATION"
47 .PP
48 Most of the performance loss with the
49 vfs_syncops
50 VFS module is in fsync on close()\&. You can disable that with
51 syncops:onclose = no
52 that can be set either globally or per share\&.
53 .PP
54 On certain filesystems that only require the last data written to be fsync()\*(Aqed, you can disable the metadata synchronization of this module with
55 syncops:onmeta = no\&. This option can be set either globally or per share\&.
56 .PP
57 The
58 vfs_syncops
59 VFS module can also be disabled completely for a share with
60 syncops:disable = true\&.
61 .SH "EXAMPLES"
62 .PP
63 Add syncops functionality for [share]:
64 .sp
65 .if n \{\
66 .RS 4
67 .\}
68 .nf
69 \fI[share]\fR
70 \m[blue]\fBpath = /data/share\fR\m[]
71 \m[blue]\fBvfs objects = syncops\fR\m[]
72 \m[blue]\fBsyncops:onclose = no\fR\m[]
73 .fi
74 .if n \{\
75 .RE
76 .\}
77 .SH "VERSION"
78 .PP
79 This man page is part of version 4\&.23\&.8\-git\&.477\&.f78166bceedSUSE\-oS16\&.9\-x86_64 of the Samba suite\&.
80 .SH "AUTHOR"
81 .PP
82 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\&.