Footnotes

(1)

This is only accidentally true, but not in general. Whereas modification times are always restored, in most cases, one has to be root for restoring the owner, and use a special option for restoring permissions. Here, it just happens that the restoring user is also the owner of the archived members, and that the current umask is compatible with original permissions.

(2)

For example, ‘--file’ (‘-f’) takes the name of an archive file as an argument. If you do not supply an archive file name, tar will use a default, but this can be confusing; thus, we recommend that you always supply a specific archive file name.

(3)

Clustering many options, the last of which has an argument, is a rather opaque way to write options. Some wonder if GNU getopt should not even be made helpful enough for considering such usages as invalid.

(4)

Beware that if you precede options with a dash, you are announcing the short option style instead of the old option style; short options are decoded differently.

(5)

Before GNU tar version 1.11.6, a bug prevented intermixing old style options with long options in some cases.

(6)

Earlier versions of GNU tar understood ‘-l’ as a synonym for ‘--one-file-system’. The current semantics, which complies to UNIX98, was introduced with version 1.15.91. See section Changes, for more information.

(7)

There are plans to merge the cpio and tar packages into a single one which would be called paxutils. So, who knows if, one of this days, the ‘--version’ would not output ‘tar (GNU paxutils) 3.2’.

(8)

This is actually a shortcut for ‘--checkpoint=n --checkpoint-action=dot’. See section dot.

(9)

This is well described in Unix-haters Handbook, by Simson Garfinkel, Daniel Weise & Steven Strassmann, IDG Books, ISBN 1-56884-203-1.

(10)

Unless you give it ‘--keep-old-files’ option, or the disk copy is newer than the one in the archive and you invoke tar with ‘--keep-newer-files’ option.

(11)

This can cause multiple members to have the same name. For information on how this affects reading the archive, see Multiple Members with the Same Name.

(12)

Notice, that since both archives were created without ‘-P’ option (see section Absolute File Names), these commands should be run from the root file system.

(13)

Two ‘--verbose’ options were selected to avoid breaking usual verbose listing output (‘--list --verbose’) when using in scripts.

Versions of GNU tar up to 1.15.1 used to dump verbatim binary contents of the DUMPDIR header (with terminating nulls) when ‘--incremental’ or ‘--listed-incremental’ option was given, no matter what the verbosity level. This behavior, and, especially, the binary output it produced were considered inconvenient and were changed in version 1.16.

(14)

For backward compatibility, the backup will also try to deduce the requested dump level from the name of the script itself. If the name consists of a string ‘level-’ followed by a single decimal digit, that digit is taken as the dump level number. Thus, you may create a link from backup to level-1 and then run level-1 whenever you need to create a level one dump.

(15)

Versions of GNU tar up to 1.15.1 recognized only ‘-C’ option in file lists, and only if the option and its argument occupied two consecutive lines.

(16)

Notice that earlier GNU tar versions used globbing for inclusion members, which contradicted to UNIX98 specification and was not documented. See section Changes, for more information on this and other changes.

(17)

A side effect of this is that when ‘--create’ is used with ‘--verbose’ the resulting output is not, generally speaking, the same as the one you'd get running tar --list command. This may be important if you use some scripts for comparing both outputs. See listing member and file names, for the information on how to handle this case.

(18)

It also had patent problems in the past.

(19)

To verbosely trace the decompressor selection, use the ‘--warning=decompress-program’ option (see section decompress-program).

(20)

There are plans to fix this in future releases.

(21)

See section PAX Format, Version 1.0.

(22)

Technically speaking, n is a process ID of the tar process which created the archive (see section Controlling Extended Header Keywords).

(23)

If you run GNU tar under a different locale, the translation to the locale's language will be used.

(24)

See –restrict, for more information about this option.

(25)

Until version 1.10, that option was called ‘--volume’, but is not available under that name anymore.

(26)

Note that GNU tar versions up to 1.23 indicated mismatch with an exit code 2 and printed a spurious diagnostics on stderr.

(27)

Previous versions of tar used full regular expression matching, or before that, only exact string matching, instead of wildcard matchers. We decided for the sake of simplicity to use a uniform matching device through tar.

This document was generated by Sergey Poznyakoff on March, 12 2011 using texi2html 1.78.