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:

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: 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.