vfs_syncops (8)

Leading comments

    Title: vfs_syncops
   Author: [see the "AUTHOR" section]
Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
     Date: 09/21/2017
   Manual: System Administration tools
   Source: Samba 4.6
 Language: English

NAME

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]
        m[blue]path = /data/sharem[]
        m[blue]vfs objects = syncopsm[]
        m[blue]syncops:onclose = nom[]

VERSION

This man page is correct for version 4.1.0 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.