System Administration Commands                         fssnap(1M)



NAME
     fssnap - create temporary snapshots of a file system

SYNOPSIS
     fssnap [-F FSType] [-V] -o specialoptions /mount/point


     fssnap  -d [-F  FSType] [-V] /mount/point  dev


     fssnap -i [-F FSType] [-V] [-o specialoptions]
          [/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.



SunOS 5.11          Last change: 11 Aug 2004                    1






System Administration Commands                         fssnap(1M)



     -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 depen-
                           dent.  See  the FSType-specific fssnap
                           man page for details.


     -o specialoptions    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.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:





SunOS 5.11          Last change: 11 Aug 2004                    2






System Administration Commands                         fssnap(1M)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


SEE ALSO
     fssnapufs(1M), attributes(5)

NOTES
     This command might not be supported for all FSTypes.











































SunOS 5.11          Last change: 11 Aug 2004                    3