|Purpose:||Extract files from .TAR archives|
|Format:||UNTAR [/= /A:[[-][+]rhsdaecjot] /C /D /E /F /G /Net /O /P /Q /TEST /U /V] tararchive path file ...|
|ziparchive||The .tar file to work with|
|path||The path where files will be extracted|
|file||The file(s) to extract|
See also TAR.
UNTAR is compatible with tar archives created in Linux / UNIX. Unlike .zip archives, .tar archives are not compressed unless you use the gzip option. If you don't specify any arguments, UNTAR will display its command dialog.
You can specify a pathname for tararchive. If you don't provide an extension, and the filename as entered doesn't exist, UNTAR adds ".tar". If you don't specify an operation, UNTAR will default to Extract.
UNTAR supports wildcards for the tar archive name and for the filenames to extract.
path specifies the path where files will be extracted. If path is not specified, files are extracted to the current directory.
UNTAR supports gzip decompression, and can be used to extract .tar.gz archives.
UNTAR sets two internal variables:
|%_untar_files||The number of files extracted|
|%_untar_errors||The number of errors|
|/=||Display the UNTAR command dialog to help you set the filename and command line options. The /= option can be anywhere on the line; additional options will set the appropriate fields in the command dialog.|
|/A:...||Select only those files that have the specified attribute(s) set. See Attribute Switches for information on the attributes which can follow /A:. Do not use /A: with @file lists. See @file lists for details.|
You can specify /A:= to display a dialog to help you set individual attributes.
|/F||Extract only those files that currently exist in the target folder, and which are older than the file in the tar archive.|
|e||Don't display errors.|
|t||Don't update the CD / CDD extended directory search database (JPSTREE.IDX).|
|/O||Overwrite existing files. UNTAR normally prompts before overwriting an existing file; /O will suppress the prompt.|
|/TEST||Test the integrity of the TAR file (header and contents). Any errors will be displayed on STDERR.|
|/U||Extract files which either don't exist in the target folder, or which are older than the file in the tar archive.|