Purpose:Add, update, or delete files in a .tar archive


Format:TAR [/= /A:[[-][+]rhsdaecjot] /A /C /D /F /G /M /O:[-]acdeginorstuz /Q /R /TEST /U /V] tararchive [@file] file...


tararchiveThe tar file to work with
fileThe files(s) to be added to the tar archive


/A:... (attribute switch)/O:... (sort order)



See also UNTAR.


File Selection


Supports command dialog, attribute switches, extended wildcards, ranges, multiple file names, and include lists.


File Completion Syntax:


The default filename completion syntax is:: [1] dirs tar [2*] *




TAR is compatible with archives created by the Linux / UNIX tar utility. Unless you use the /G option, the tar file will be uncompressed. If you don't specify any arguments, TAR 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, TAR adds ".tar". If you don't specify an operation, TAR will default to Add.


TAR supports connected web folders. If an HTML file (i.e.,  with an .htm or .html extension) is compressed, TAR will look for a  folder in the same directory with the same name and an extension of ".files". If it is found, the .files directory will be be added the TAR archive.


TAR sets two internal variables:


%_tar_filesThe number of files archived
%_tar_errorsThe number of errors




/=Display the TAR 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.


/AAdd the specified file(s) to the tar file. (This is the default.)


/CDisplay (on standard output) the contents of a file in the tar archive.


/DDelete the specified file(s) from the tar file.


/FUpdate only those files that currently exist in the tar file, and which are older than the files on disk.


/GWhen all the files have been added to the archive, compress the entire archive using gzip compression and create a .tar.gz archive.


/MDelete the files from the disk after adding them to the tar file.


/O:...Sort the files before processing.


You may use any combination of the sorting options below. If multiple options are used, the files will be sorted with the first sort option as the primary key, the next as the secondary key, and so on:


nSort by filename and extension, unless e is explicitly included. This is the default.
-Reverse the sort order for the next sort key
aSort names and extensions in standard ASCII order, instead of numerically when numeric substrings are included in the name or extension.
cSort by compression ratio
dSort by date and time (oldest first); also see /T:acw
eSort by extension
gGroup subdirectories first, then files
iSort by description
oSort by owner
rReverse the sort order for all options
sSort by size
tSame as d
zSame as s


/PDisplay the progress (0 - 100%) for each file as it is archived.


/QDon't display the files being archived.


/RIf the argument is a subdirectory, copy all of the files in that subdirectory and all of its subdirectories to the tar archive.


/TESTTest the integrity of the TAR file (header and contents). Any errors will be displayed on STDERR.


/UUpdate files which either don't exist in the tar, or which are older than the files on disk.


/VView the list of files in the tar file (date, time, size, and filename).