Next Previous

4.2 HTAR Action Flags

HTAR must be invoked with exactly one action flag. Omitting the action flag or using more than one will result in an error. The valid action flags are listed below.

-c

Creates a new HPSS-resident archive, and writes the local files specified by one or more Fileparameters into the archive. Warning: any pre-existing archive file will be overwritten without prompting. This behavior mimics that of the AIX tar utility.

-t

Lists the files in the order in which they appear in the HPSS-resident archive. Listable output is written to standard output; all other output is written to standard error.

-x

Extracts the files specified by one or more File parameters from the HPSS-resident archive. If the File parameter refers to a directory, the htar command recursively extracts that directory and all of its subdirectories from the archive.

If the File parameter is not specified, htar extracts all of the files from the archive. If an archive contains multiple copies of the same file, the last copy extracted overwrites all previously extracted copies. If the file being extracted does not already exist on the system, it is created. If you have the proper permissions, then htar command restores all files and directories with the same owner and group IDs as they have on the HPSS tar file. If you do not have the proper permissions, then files and directories are restored with your owner and group IDs.

-X

Builds a new index file by reading the entire tar file. This operation is used either to reconstruct an index for tar files whose Index File is unavailable (e.g., accidentally deleted), or for tar files that were not originally created by htar.


Next Previous