From ArchWiki
Revision as of 17:14, 11 December 2011 by Strcat (talk | contribs) (codeline -> ic)
Jump to: navigation, search

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

From GNU's Tar Page:

"The Tar program provides the ability to create tar archives, as well as various other kinds of manipulation. For example, you can use Tar on previously created archives to extract files, to store additional files, or to update or list files which were already stored."

As an early Unix compression format, Template:Filename files (known as tarballs) are widely used for packaging in Unix-like operating systems. Both pacman and AUR packages are tarballs, and Arch uses GNU's Tar program by default.


For Template:Filename archives, Tar by default will extract the file according to its extension:

$ tar xvf file.EXTENSION

Forcing a given format:

File Type Extraction Command
Template:Filename tar xvf file.tar
Template:Filename tar xvzf file.tgz
Template:Filename tar xvzf file.tar.gz
Template:Filename bzip -cd file.bz | tar xvf -
Template:Filename tar xvjf file.tar.bz2
bzip2 -cd file.bz2 | tar xvf -
Template:Filename tar xvJf file.tar.xz
xz -cd file.xz | tar xvf -

The construction of some of these Tar arguments may be considered legacy, but they are still useful when performing specific operations. The Compatibility section of Tar's man page shows how they work in detail.

As a cp alternative

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: please use the first argument of the template to provide a brief explanation. (Discuss in Talk:Tar#)

Copying a directory tree and its contents to another filesystem using

$ cp -pR directory /target

is not always sufficient.

Using Tar instead will preserve ownership, permissions, and timestamps.

This neat trick allows using Tar to perform a recursive copy without creating an intermediate Template:Filename file and overcoming all cp shortcomings.

To copy all of the files and subdirectories in the current working directory to the directory Template:Filename, use:

$ tar cf - * | ( cd /target; tar xfp -)

The first part of the command before the pipe instructs Tar to create an archive of everything in the current directory and write it to standard output (the - in place of a filename frequently indicates stdout). The commands within parentheses cause the shell to change directory to the target directory and untar data from standard input. Since the cd and Tar commands are contained within parentheses, their actions are performed together.

The -p option in the tar extraction command directs Tar to preserve permission and ownership information, if possible given the user executing the command. If you are running the command as root, this option is turned on by default and can be omitted.

Note that the Template:Filename will not copy any of the files prefixed with a Template:Filename in the root directory. It is tricky to wildcard these files because one does not want to include the Template:Filename and Template:Filename directories, so usually one adds Template:Filename to pick up everything else except for one- and two-character filenames prefixed with the Template:Filename (e.g. Template:Filename, Template:Filename). To copy these as well, you will want to list them by doing:

$ ls -a

in the root directory first and typing those explicitly.

In summary, I would recommend this instead:

$ tar cf - * .??* | ( cd /target; tar xfp -)

but first do:

$ ls -a

and if you see anything starting with a Template:Filename (besides Template:Filename) that is not followed by more then two characters, add those as well; e.g.:

$ tar cf - * .??* .a .z .bc | ( cd /target; tar xfp -)

See Also