rearch(1M)

NAME
     rearch - Marks archive entries to be rearchived

SYNOPSIS
     rearch [-f] [-M] [-o] -m media -v vsn filename ...

     rearch [-f] [-M] [-o] -c n filename ...

     rearch [-f] [-M] [-o] -m media -v vsn -r dirname [filename
     ...]

     rearch [-f] [-M] [-o] -c n -r dirname [filename ...]

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The rearch command marks archive entries for one or more
     files or directories to be rearchived.  You must specify
     either a copy number or both a media type and a VSN number.
     In addition, you must specify either a file name or both a
     directory name and a file name.

OPTIONS
     This command accepts the following options:

     -c n      Specifies the archive copy number.  If one or more
               -c n options are specified, only those archive
               copies (1 to 4) are marked.  The default is all
               copies.

     -f        Suppresses errors.

     -M        Rearchives metadata only. This includes
               directories, the segment index, and removable
               media files. Regular files and symbolic links are
               not rearchived.

     -m media  Specifies the media type.  If specified, archive
               copies on the specified media are marked.  For
               more information on media types, see the mcf(4)
               man page.

     -o        Requires the file to be online before its archive
               entry is deleted.  If the file is offline, the
               command stages the file onto disk before deleting
               any entries.

     -v vsn    Marks archive copies on VSN vsn for rearchiving.
               This option must be specified in conjunction with
               the -m media option.

     -r dirname
               Recursively rearchives the archive entries of the
               specified dirname and its subdirectories.  The
               rearch flag for archive entries of files in the
               directories and subdirectories is set.  If no -r
               dirname option is specified, at least one filename
               must be specified.

     filename ...
               Specifies one or more files for rearchiving.  If
               you are using the first form of the command,
               either a filename or an asterisk (*) is required.
               If you are using the third or fourth forms of the
               command, and you do not specify a filename, you
               must use the -r option and specify a dirname.

SEE ALSO
     mcf(4).