unrearch(1M)

NAME
     unrearch - Removes a specification to rearchive a file

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

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

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

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

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The unrearch command lets you remove a request to rearchive
     a file or a directory.  For example, if you have used the
     rearch(1M) command to request that a file be rearchived, you
     can use the unrearch command to clear the bit that the
     rearch(1M) command had set.  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
     affected.

     There are several ways to remove the request to rearchive
     from one or more archive entries.  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
               Removes the rearchive request for copy_no.
               Specify 1, 2, 3, or 4 for copy_no.  If one or more
               -c options are are specified, the command removes
               the rearchive request from only those archive
               copies (copies 1, 2, 3, or 4).  Either a -c or a
               -m option must be specified.

     -f        Suppresses errors.

     -m media_type
               Removes rearchive requests from all archive copies
               on 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        Removes rearchive requests for metadata only.
               This includes directories, the segment index, and
               removable media files.  Regular files and symbolic
               links are not unrearchived.  If you are
               unarchiving a directory, you must specify the -M
               option.

     -r dirname
               Recursively removes the rearchive requests for the
               entries of dirname and its subdirectories.
               Removes the archive requests of files in the
               directories and subdirectories.

     -v vsn    Removes the rearchive requests for 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  Removes the rearchive requests for the specified
               filename.

SEE ALSO
     mcf(4), rearch(1M).