FreeBSD manual

download PDF document: vfs_syncops.8.pdf

VFS_SYNCOPS(8) System Administration tools VFS_SYNCOPS(8)
NAME vfs_syncops - Ensure meta data operations are performed synchronously.
SYNOPSIS vfs objects = syncops
DESCRIPTION This VFS module is part of the samba(7) suite.
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 vfs_syncops VFS module provides a way to perform those operations safely.
This module is stackable.
CONFIGURATION Most of the performance loss with the vfs_syncops VFS module is in fsync on close(). You can disable that with syncops:onclose = no that can be set either globally or per share.
On certain filesystems that only require the last data written to be fsync()'ed, you can disable the metadata synchronization of this module with syncops:onmeta = no. This option can be set either globally or per share.
The vfs_syncops VFS module can also be disabled completely for a share with syncops:disable = true.
EXAMPLES Add syncops functionality for [share]:
[share] path = /data/share vfs objects = syncops syncops:onclose = no
VERSION This man page is part of version 4.13.17 of the Samba suite.
AUTHOR 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.
Samba 4.13.17 01/31/2022 VFS_SYNCOPS(8)