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 unarchive - Deletes archive entries SYNOPSIS unarchive -c copy_no [-f] [-m media_type [-v vsn]] [-M] [-o] filename . . . unarchive [-c copy_no] [-f] -m media_type [-v vsn] [-M] [-o] filename . . . unarchive -c copy_no [-f] [-m media_type [-v vsn]] [-M] [-o] -r dirname [filename] . . . unarchive [-c copy_no] [-f] -m media_type [-v vsn] [-M] [-o] -r dirname [filename] . . . AVAILABILITY SUNWsamfs DESCRIPTION The unarchive command deletes archive entries for one or more files or directories. 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 deleted. There are several ways to specify one or more archive entries to be unarchived. 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 Deletes the specified archive copy number. If one or more -c options are are specified, only those archive copies (copies 1, 2, 3, or 4) are deleted. Specify 1, 2, 3, or 4 for copy_no. Either a -c or a -m option must be specified. -f Suppresses errors. -m media_type Deletes all archive copies from 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 Unarchives metadata only. This includes directories, the segment index, and removable media files. Regular files and symbolic links are not unarchived. If you are unarchiving a directory, you must specify the -M option. -o Specifies that the file must be online before its archive entry is deleted. If the file is offline, the unarchive command stages the file to disk before deleting any entries. -r dirname Recursively deletes the archive entries of dirname and its subdirectories. The archive entries of files in the directories and subdirectories are deleted. -v vsn Deletes 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 Deletes the archive entries for the specified filename. NOTES If the last (undamaged) copy of a file would be unarchived, the unarchive command reports Last undamaged offline copy and does not unarchive that copy. SEE ALSO mcf(4).