1VFS_BTRFS(8)              System Administration tools             VFS_BTRFS(8)
2
3
4

NAME

6       vfs_btrfs - Utilize features provided by the Btrfs filesystem
7

SYNOPSIS

9       vfs objects = btrfs
10

DESCRIPTION

12       This VFS module is part of the samba(8) suite.
13
14       The vfs_btrfs VFS module exposes Btrfs specific features for use by
15       Samba.
16
17       Btrfs allows for multiple files to share the same on-disk data through
18       the use cloned ranges. When an SMB client issues a request to copy
19       duplicate data (via FSCTL_SRV_COPYCHUNK), this module maps the request
20       to a Btrfs clone range IOCTL, instead of performing reads and writes
21       required by a traditional copy. Doing so saves storage capacity and
22       greatly reduces disk IO.
23
24       This module also exposes Btrfs per-file compression support to SMB
25       clients via the get/set compression fsctls.
26
27       This module is stackable.
28

CONFIGURATION

30       vfs_btrfs requires that the underlying share path is a Btrfs
31       filesystem.
32
33                     [share]
34                     vfs objects = btrfs
35
36

VERSION

38       This man page is correct for version 4.1.0 of the Samba suite.
39

AUTHOR

41       The original Samba software and related utilities were created by
42       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
43       Source project similar to the way the Linux kernel is developed.
44
45
46
47Samba 4.2                         06/19/2018                      VFS_BTRFS(8)