Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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).