VFSSHADOWCOPY(8) VFSSHADOWCOPY(8)

NAME
       vfsshadowcopy  -  Make  a  Samba share read only for a specified time
       period

SYNOPSIS
       vfs objects = shadowcopy

DESCRIPTION
       This VFS module is part of the ssaammbbaa(7) suite.

       The  vfsshadowcopy  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.

       This module is stackable.

CCOONNFFIIGGUURRAATTIIOONN
       vfsshadowcopy  relies  on  a filesystem snapshot implementation. Many
       common filesystems have native support for this.

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

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

       +o  YYYY is the 4 digit year

       +o  MM is the 2 digit month

       +o  DD is the 2 digit day

       +o  hh is the 2 digit hour

       +o  mm is the 2 digit minute

       +o  ss is the 2 digit second.



The vfsshadowcopy snapshot naming convention can be produced with  the  fol-
lowing ddaattee(1) command:




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



EEXXAAMMPPLLEESS
       Add shadow copy support to user home directories:


               [homes]
            vfs objects = shadowcopy


CCAAVVEEAATTSS
       This is not a backup, archival, or version control solution.

       With  Samba  or  Windows  servers, vfsshadowcopy 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. Addi-
       tionally, if you need version control, implement a version control sys-
       tem.

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




                                                            VFSSHADOWCOPY(8)