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:

By copy number
By copy number, media type, and VSN
By copy number and media type
By media type
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.