fssnap(1M)

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, trun-
     cated,  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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     fssnap_ufs(1M), attributes(5)

NOTES

     This command might not be supported for all FSTypes.