between archive and file system. The arguments are optional and specify archive members to compare. If not given, the current working directory is assumed.
--delete
Delete from the archive. The arguments supply names of the archive members to be removed. At least one argument must be given.
This option does not operate on compressed archives. There is no short option equivalent.
-r, --append
Append files to the end of an archive. Arguments have the same meaning as for -c (--create).
-t, --list
List the contents of an archive. Arguments are optional. When given, they specify the names of the members to list.
--test-label
Test the archive volume label and exit. When used without arguments, it prints the volume label (if any) and exits with status 0. When one or more command line arguments are given. tar compares the volume
label with each argument. It exits with code 0 if a match is found, and with code 1 otherwise. No output is displayed, unless used together with the -v (--verbose) option.
There is no short option equivalent for this option.
-u, --update
Append files which are newer than the corresponding copy in the archive. Arguments have the same meaning as with -c and -r options. Notice, that newer files don’t replace their old archive copies, but instead
are appended to the end of archive. The resulting archive can thus contain several members of the same name, corresponding to various versions of the same file.
-x, --extract, --get
Extract files from an archive. Arguments are optional. When given, they specify names of the archive members to be extracted.
--show-defaults
Show built‐in defaults for various tar options and exit. No arguments are allowed.
-?, --help
Display a short option summary and exit. No arguments allowed.
--usage
Display a list of available options and exit. No arguments allowed.
--version
Print program version and copyright information and exit.
OPTIONS
Operation modifiers
--check-device
Check device numbers when creating incremental archives (default).
-g, --listed-incremental=FILE
Handle new GNU‐format incremental backups. FILE is the name of a snapshot file, where tar stores additional information which is used to decide which files changed since the previous incremental dump and, con‐
sequently, must be dumped again. If FILE does not exist when creating an archive, it will be created and all files will be added to the resulting archive (the level 0 dump). To create incremental archives of
non‐zero level N, create a copy of the snapshot file created during the level N‐1, and use it as FILE.
When listing or extracting, the actual contents of FILE is not inspected, it is needed only due to syntactical requirements. It is therefore common practice to use /dev/null in its place.
--hole-detection=METHOD
Use METHOD to detect holes in sparse files. This option implies --sparse. Valid values for METHOD are seek and raw. Default is seek with fallback to raw when not applicable.
-G, --incremental
Handle old GNU‐format incremental backups.
--ignore-failed-read
Do not exit with nonzero on unreadable files.
--level=NUMBER
Set dump level for created listed‐incremental archive. Currently only --level=0 is meaningful: it instructs tar to truncate the snapshot file before dumping, thereby forcing a level 0 dump.
-n, --seek
Assume the archive is seekable. Normally tar determines automatically whether the archive can be seeked or not. This option is intended for use in cases when such recognition fails. It takes