.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "VFS_SHADOW_COPY" 8 "" "" ""
.SH NAME
vfs_shadow_copy \- Make a Samba share read only for a specified time period
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 26
\fBvfs objects = shadow_copy\fR
.ad
.hy

.SH "DESCRIPTION"

.PP
This VFS module is part of the\fBsamba\fR(7) suite\&.

.PP
The \fBvfs_shadow_copy\fR VFS module functionality that is similar to Microsoft Shadow Copy services\&. When setup properly, this module allows Microsoft Shadow Copy clients to browse "shadow copies" on Samba shares\&.

.PP
This module is stackable\&.

.SH "CONFIGURATION"

.PP
\fBvfs_shadow_copy\fR relies on a filesystem snapshot implementation\&. Many common filesystems have native support for this\&.

.PP
Filesystem snapshots must be mounted on specially named directories in order to be recognized by\fBvfs_shadow_copy\fR\&. The snapshot mount points must be immediate children of a the directory being shared\&.

.PP
The snapshot naming convention is @GMT\-YYYY\&.MM\&.DD\-hh\&.mm\&.ss, where:

.TP 3
\(bu
\fBYYYY\fR is the 4 digit year
.TP
\(bu
\fBMM\fR is the 2 digit month
.TP
\(bu
\fBDD\fR is the 2 digit day
.TP
\(bu
\fBhh\fR is the 2 digit hour
.TP
\(bu
\fBmm\fR is the 2 digit minute
.TP
\(bu
\fBss\fR is the 2 digit second\&.
.LP
 

.PP
The \fBvfs_shadow_copy\fR snapshot naming convention can be produced with the following\fBdate\fR(1) command:

.nf

	TZ=GMT date +@GMT\-%Y\&.%m\&.%d\-%H\&.%M\&.%S
	
.fi


.SH "EXAMPLES"

.PP
Add shadow copy support to user home directories:

.nf

        \fI[homes]\fR
	vfs objects = shadow_copy

.fi

.SH "CAVEATS"

.PP
This is not a backup, archival, or version control solution\&.

.PP
With Samba or Windows servers,\fBvfs_shadow_copy\fR is designed to be an end\-user tool only\&. It does not replace or enhance your backup and archival solutions and should in no way be considered as such\&. Additionally, if you need version control, implement a version control system\&.

.SH "VERSION"

.PP
This man page is correct for version 3\&.0\&.25 of the Samba suite\&.

.SH "AUTHOR"

.PP
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\&.