1VFS_SHADOW_COPY(8)                                          VFS_SHADOW_COPY(8)
2
3
4

NAME

6       vfs_shadow_copy  -  Make  a  Samba share read only for a specified time
7       period
8

SYNOPSIS

10       vfs objects = shadow_copy
11

DESCRIPTION

13       This VFS module is part of the samba(7) suite.
14
15       The vfs_shadow_copy VFS module functionality that is similar to  Micro‐
16       soft  Shadow Copy services. When setup properly, this module allows Mi‐
17       crosoft Shadow Copy clients to browse "shadow copies" on Samba shares.
18
19       This module is stackable.
20

CONFIGURATION

22       vfs_shadow_copy relies on a filesystem  snapshot  implementation.  Many
23       common filesystems have native support for this.
24
25       Filesystem  snapshots must be mounted on specially named directories in
26       order to be recognized by vfs_shadow_copy. The  snapshot  mount  points
27       must be immediate children of a the directory being shared.
28
29       The snapshot naming convention is @GMT-YYYY.MM.DD-hh.mm.ss, where:
30
31       ·  YYYY is the 4 digit year
32
33       ·  MM is the 2 digit month
34
35       ·  DD is the 2 digit day
36
37       ·  hh is the 2 digit hour
38
39       ·  mm is the 2 digit minute
40
41       ·  ss is the 2 digit second.
42
43
44
45The  vfs_shadow_copy  snapshot naming convention can be produced with the fol‐
46lowing date(1) command:
47
48
49
50
51     TZ=GMT date +@GMT-%Y.%m.%d-%H.%M.%S
52
53
54

EXAMPLES

56       Add shadow copy support to user home directories:
57
58
59               [homes]
60            vfs objects = shadow_copy
61
62

CAVEATS

64       This is not a backup, archival, or version control solution.
65
66       With Samba or Windows servers, vfs_shadow_copy is  designed  to  be  an
67       end-user  tool  only.  It  does  not replace or enhance your backup and
68       archival solutions and should in no way be considered  as  such.  Addi‐
69       tionally, if you need version control, implement a version control sys‐
70       tem.
71

VERSION

73       This man page is correct for version 3.0.25 of the Samba suite.
74

AUTHOR

76       The original Samba software  and  related  utilities  were  created  by
77       Andrew  Tridgell.  Samba  is now developed by the Samba Team as an Open
78       Source project similar to the way the Linux kernel is developed.
79
80
81
82
83                                                            VFS_SHADOW_COPY(8)
Impressum