FSSNAP(8) Maintenance Commands and Procedures FSSNAP(8)
fssnap - create temporary snapshots of a file system
fssnap [-F FSType] [-V] -o special_options /mount/point
fssnap -d [-F FSType] [-V] /mount/point | dev
fssnap -i [-F FSType] [-V] [-o special_options]
[/mount/point | dev]
The fssnap command creates a stable, read-only snapshot of a file
system when given either an active mount point or a special device
containing a mounted file system, as in the first form of the
synopsis. A snapshot is a temporary image of a file system intended
for backup operations.
While the snapshot file system is stable and consistent, an
application updating files when the snapshot is created might leave
these files in an internally inconsistent, truncated, or otherwise
unusable state. In such a case, the snapshot will contain these
partially written or corrupted files. It is a good idea to ensure
active applications are suspended or checkpointed and their
associated files are also consistent during snapshot creation.
File access times are not updated while the snapshot is being
created.
A path to the virtual device that contains this snapshot is printed
to standard output when a snapshot is created.
The following options are supported:
-d
Deletes the snapshot associated with the given
file system.
-F FSType
Specifies the file system type to be used. The
FSType should either be specified here or be
determined by matching the block special device
with an entry in the /etc/vfstab table, or by
consulting /etc/default/fs.
-i
Displays the state of any given FSType
snapshot. If a mount-point or device is not
given, a list of all snapshots on the system is
displayed. When a mount-point or device is
specified, detailed information is provided for
the specified file system snapshot by default.
The format and meaning of this information is
file-system dependent. See the FSType-specific
fssnap man page for details.
-o special_options
See the FSType-specific man page for fssnap.
-V
Echoes the complete command line, but does not
execute the command.
The following operands are supported:
/mount/point
The directory where the file system resides.
See FSType-specific man pages for examples.
The following exit values are returned:
0
Successful completion.
>0
An error occurred.
/etc/vfstab
Specifies file system type.
/etc/default/fs
Specifies the default local file system type.
attributes(7), fssnap_ufs(8)
This command might not be supported for all FSTypes.
August 11, 2004 FSSNAP(8)
NAME
fssnap - create temporary snapshots of a file system
SYNOPSIS
fssnap [-F FSType] [-V] -o special_options /mount/point
fssnap -d [-F FSType] [-V] /mount/point | dev
fssnap -i [-F FSType] [-V] [-o special_options]
[/mount/point | dev]
DESCRIPTION
The fssnap command creates a stable, read-only snapshot of a file
system when given either an active mount point or a special device
containing a mounted file system, as in the first form of the
synopsis. A snapshot is a temporary image of a file system intended
for backup operations.
While the snapshot file system is stable and consistent, an
application updating files when the snapshot is created might leave
these files in an internally inconsistent, truncated, or otherwise
unusable state. In such a case, the snapshot will contain these
partially written or corrupted files. It is a good idea to ensure
active applications are suspended or checkpointed and their
associated files are also consistent during snapshot creation.
File access times are not updated while the snapshot is being
created.
A path to the virtual device that contains this snapshot is printed
to standard output when a snapshot is created.
OPTIONS
The following options are supported:
-d
Deletes the snapshot associated with the given
file system.
-F FSType
Specifies the file system type to be used. The
FSType should either be specified here or be
determined by matching the block special device
with an entry in the /etc/vfstab table, or by
consulting /etc/default/fs.
-i
Displays the state of any given FSType
snapshot. If a mount-point or device is not
given, a list of all snapshots on the system is
displayed. When a mount-point or device is
specified, detailed information is provided for
the specified file system snapshot by default.
The format and meaning of this information is
file-system dependent. See the FSType-specific
fssnap man page for details.
-o special_options
See the FSType-specific man page for fssnap.
-V
Echoes the complete command line, but does not
execute the command.
OPERANDS
The following operands are supported:
/mount/point
The directory where the file system resides.
EXAMPLES
See FSType-specific man pages for examples.
EXIT STATUS
The following exit values are returned:
0
Successful completion.
>0
An error occurred.
FILES
/etc/vfstab
Specifies file system type.
/etc/default/fs
Specifies the default local file system type.
SEE ALSO
attributes(7), fssnap_ufs(8)
NOTES
This command might not be supported for all FSTypes.
August 11, 2004 FSSNAP(8)