NAME¶

vfs_btrfs - Utilize features provided by the Btrfs filesystem

SYNOPSIS¶

vfs objects = btrfs

DESCRIPTION¶

This VFS module is part of the samba(8) suite.

The vfs_btrfs VFS module exposes Btrfs specific features for use by Samba.

Btrfs allows for multiple files to share the same on-disk data through the use cloned ranges. When an SMB client issues a request to copy duplicate data (via FSCTL_SRV_COPYCHUNK), this module maps the request to a Btrfs clone range IOCTL, instead of performing reads and writes required by a traditional copy. Doing so saves storage capacity and greatly reduces disk IO.

This module also exposes Btrfs per-file compression support to SMB clients via the get/set compression fsctls.

This module is stackable.

CONFIGURATION¶

vfs_btrfs requires that the underlying share path is a Btrfs filesystem.

		[share]
		vfs objects = btrfs
	

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.