GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  VFS_BTRFS (8)

.ds Aq ’

NAME

vfs_btrfs - Utilize features provided by the Btrfs filesystem

CONTENTS

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.

Btrfs snapshots can be manipulated by Sambas FSRVP server. Snapshot manipulation using this module is currently considered experimental, and is therefore disabled by default. The vfs_snapper module is instead recommended for this purpose.

This module is stackable.

OPTIONS

btrfs: manipulate snapshots = [yes|no]

When set to yes, experimental support for the creation and deletion of snapshots via corresponding Btrfs IOCTLs will be enabled. The default is no, which means that such requests are passed through to any underlying VFS module.

CONFIGURATION

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

                [share]
                \m[blue]vfs objects = btrfs\m[]
                \m[blue]btrfs: manipulate snapshots = no\m[]
        

To use the experimental snapshot manipulation functionality provided by this module, it must be explicity enabled, and Sambas FSRVP server must be running.

The vfs_shadow_copy module can be used to expose snapshots created by vfs_btrfs to Windows Explorer as file / directory "previous versions".

                [global]
                \m[blue]rpc_daemon:fssd = fork\m[]
                \m[blue]registry shares = yes\m[]
                \m[blue]include = registry\m[]

                [share]                 \m[blue]vfs objects = btrfs shadow_copy\m[]                 \m[blue]btrfs: manipulate snapshots = yes\m[]         

VERSION

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

Search for    or go to Top of page |  Section 8 |  Main Index


Samba 4&.3 VFS_BTRFS (8) 04/11/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.