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.