Content-type: text/html Man page of fssnap

fssnap

Section: System Administration Commands (1M)
Updated: 11 Aug 2004
Index Return to Main Contents
 

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.

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu

 

SEE ALSO

fssnap_ufs(1M), attributes(5)  

NOTES

This command might not be supported for all FSTypes.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
EXIT STATUS
FILES
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:37:09 GMT, October 02, 2010