unarchive(1M)

NAME
     unarchive - Deletes archive entries

SYNOPSIS
     unarchive -c copy_no [-f] [-m media_type [-v vsn]] [-M] [-o]
     filename . . .

     unarchive [-c copy_no] [-f] -m media_type [-v vsn] [-M] [-o]
     filename . . .

     unarchive -c copy_no [-f] [-m media_type [-v vsn]] [-M] [-o]
     -r dirname [filename] . . .

     unarchive [-c copy_no] [-f] -m media_type [-v vsn] [-M] [-o]
     -r dirname [filename] . . .

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The unarchive command deletes archive entries for one or
     more files or directories.  The specifications for the
     archive copy (-c copy_no) and/or the media type and VSN
     (-m media_type [-v vsn]) determine which archive copy is
     deleted.

     There are several ways to specify one or more archive
     entries to be unarchived.  These ways are as follows:

     o  By copy number

     o  By copy number, media type, and VSN

     o  By copy number and media type

     o  By media type

     o  By media type and VSN

OPTIONS
     This command accepts the following options:

     -c copy_no
               Deletes the specified archive copy number.  If one
               or more -c options are are specified, only those
               archive copies (copies 1, 2, 3, or 4) are deleted.
               Specify 1, 2, 3, or 4 for copy_no.  Either a -c or
               a -m option must be specified.

     -f        Suppresses errors.

     -m media_type
               Deletes all archive copies from the specified
               media_type.  For the list of possible media_type
               specifications, see the mcf(4) man page.  Either a
               -c or a -m option must be specified.  If you
               specify a -m option, you can also specify a -v
               option.

     -M        Unarchives metadata only.  This includes
               directories, the segment index, and removable
               media files.  Regular files and symbolic links are
               not unarchived.  If you are unarchiving a
               directory, you must specify the -M option.

     -o        Specifies that the file must be online before its
               archive entry is deleted.  If the file is offline,
               the unarchive command stages the file to disk
               before deleting any entries.

     -r dirname
               Recursively deletes the archive entries of dirname
               and its subdirectories.  The archive entries of
               files in the directories and subdirectories are
               deleted.

     -v vsn    Deletes the archive copies on vsn.  For vsn,
               specify a volume serial name (VSN).  If you
               specify a -v option, you must also specify a -m
               option.

     filename  Deletes the archive entries for the specified
               filename.

NOTES
     If the last (undamaged) copy of a file would be unarchived,
     the unarchive command reports Last undamaged offline copy
     and does not unarchive that copy.

SEE ALSO
     mcf(4).