fssnap(1m) - osol9

1fssnap(1M)              System Administration Commands              fssnap(1M)
2
3
4

NAME

6       fssnap - create temporary snapshots of a file system
7

SYNOPSIS

9       fssnap [-F FSType] [-V] -o special_options /mount/point
10
11
12       fssnap  -d [-F  FSType] [-V] /mount/point | dev
13
14
15       fssnap -i [-F FSType] [-V] [-o special_options]
16            [/mount/point | dev]
17
18

DESCRIPTION

20       The  fssnap command creates a stable, read-only snapshot of a file sys‐
21       tem when given either an active mount point or a  special  device  con‐
22       taining  a mounted file system, as in the first form of the synopsis. A
23       snapshot is a temporary image of a  file  system  intended  for  backup
24       operations.
25
26
27       While the snapshot file system is stable and consistent, an application
28       updating files when the snapshot is created might leave these files  in
29       an  internally inconsistent, truncated, or otherwise unusable state. In
30       such a case, the snapshot will contain these partially written or  cor‐
31       rupted  files. It is a good idea to ensure active applications are sus‐
32       pended or checkpointed and their associated files are  also  consistent
33       during snapshot creation.
34
35
36       File access times are not updated while the snapshot is being created.
37
38
39       A  path to the virtual device that contains this snapshot is printed to
40       standard output when a snapshot is created.
41

OPTIONS

43       The following options are supported:
44
45       -d                    Deletes the snapshot associated  with  the  given
46                             file system.
47
48
49       -F FSType             Specifies  the  file  system type to be used. The
50                             FSType should either  be  specified  here  or  be
51                             determined  by  matching the block special device
52                             with an entry in the  /etc/vfstab  table,  or  by
53                             consulting /etc/default/fs.
54
55
56       -i                    Displays  the state of any given FSType snapshot.
57                             If a mount-point or device is not given,  a  list
58                             of all snapshots on the system is displayed. When
59                             a mount-point or device  is  specified,  detailed
60                             information  is  provided  for the specified file
61                             system snapshot by default. The format and  mean‐
62                             ing of this information is file-system dependent.
63                             See  the  FSType-specific  fssnap  man  page  for
64                             details.
65
66
67       -o special_options    See the FSType-specific man page for fssnap.
68
69
70       -V                    Echoes  the  complete  command line, but does not
71                             execute the command.
72
73

OPERANDS

75       The following operands are supported:
76
77       /mount/point    The directory where the file system resides.
78
79

EXAMPLES

81       See FSType-specific man pages for examples.
82

EXIT STATUS

84       The following exit values are returned:
85
86       0     Successful completion.
87
88
89       >0    An error occurred.
90
91

FILES

93       /etc/vfstab        Specifies file system type.
94
95
96       /etc/default/fs    Specifies the default local file system type.
97
98

ATTRIBUTES

100       See attributes(5) for descriptions of the following attributes:
101
102
103
104
105       ┌─────────────────────────────┬─────────────────────────────┐
106       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
107       ├─────────────────────────────┼─────────────────────────────┤
108       │Availability                 │SUNWcsu                      │
109       └─────────────────────────────┴─────────────────────────────┘
110

NOTES

115       This command might not be supported for all FSTypes.
116
117
118
119SunOS 5.11                        11 Aug 2004                       fssnap(1M)