Create/list/extract multi‐volume archive.
--rmt-command=COMMAND
Use COMMAND instead of rmt when accessing remote archives. See the description of the -f option, above.
--rsh-command=COMMAND
Use COMMAND instead of rsh when accessing remote archives. See the description of the -f option, above.
--volno-file=FILE
When this option is used in conjunction with --multi-volume, tar will keep track of which volume of a multi‐volume archive it is working in FILE.
Device blocking
-b, --blocking-factor=BLOCKS
Set record size to BLOCKSx512 bytes.
-B, --read-full-records
When listing or extracting, accept incomplete input records after end‐of‐file marker.
-i, --ignore-zeros
Ignore zeroed blocks in archive. Normally two consecutive 512‐blocks filled with zeroes mean EOF and tar stops reading after encountering them. This option instructs it to read further and is useful when
reading archives created with the -A option.
--record-size=NUMBER
Set record size. NUMBER is the number of bytes per record. It must be multiple of 512. It can can be suffixed with a size suffix, e.g. --record‐size=10K, for 10 Kilobytes. See the subsection Size suffixes,
for a list of valid suffixes.
Archive format selection
-H, --format=FORMAT
Create archive of the given format. Valid formats are:
gnu GNU tar 1.13.x format
oldgnu GNU format as per tar <= 1.12.
pax, posix
POSIX 1003.1‐2001 (pax) format.
ustar POSIX 1003.1‐1988 (ustar) format.
v7 Old V7 tar format.
--old-archive, --portability
Same as --format=v7.
--pax-option=keyword[[:]=value][,keyword[[:]=value]]...
Control pax keywords when creating PAX archives (-H pax). This option is equivalent to the -o option of the pax(1) utility.
--posix
Same as --format=posix.
-V, --label=TEXT
Create archive with volume name TEXT. If listing or extracting, use TEXT as a globbing pattern for volume name.
Compression options
-a, --auto-compress
Use archive suffix to determine the compression program.
-I, --use-compress-program=COMMAND
Filter data through COMMAND. It must accept the -d option, for decompression. The argument can contain command line options.
-j, --bzip2
Filter the archive through bzip2(1).
-J, --xz
Filter the archive through xz(1).
--lzip Filter the archive through lzip(1).
--lzma Filter the archive through lzma(1).
--lzop Filter the archive through lzop(1).
--no-auto-compress
Do not use archive suffix to determine the compression program.
-z, --gzip, --gunzip, --ungzip
Filter the archive through gzip(1).
-Z, --compress, --uncompress
Filter the archive through compress(1).
--zstd Filter the archive through zstd(1).
Local file selection
--add-file=FILE
Add FILE to the archive (useful if its name starts with a dash).
--backup[=CONTROL]
Backup before removal. The CONTROL argument, if supplied, controls the backup policy. Its valid values are:
none, off
Never make backups.
t, numbered
Make numbered backups.
nil, existing
Make numbered backups if numbered backups exist, simple backups otherwise.
never, simple
Always make simple backups
If CONTROL is not given, the value is taken from the VERSION_CONTROL environment variable. If it is not set, existing is assumed.
-C, --directory=DIR
Change to