Tar (file Format) Article Index for
Tar
 

Information About

Tar (file Format)




  Name Tar
  Caption GNU tar 116 showing three common types of tarballs (shown in red)
  Extension <tt>tar</tt>
  Mime application/x-tar
  Uniform Type publictar-archive
  Magic <code>ustar</code> at byte 257
  Genre File Archive
  Container For anything
  Contained By Compress , Gzip , Bzip2


In Computing , tar (derived from ''tape archive'') is both a File Format (in the form of a type of Archive Bitstream ) and the name of the program used to handle such files. The format was standardized by '' POSIX .1-1988'' and later ''POSIX.1-2001''. Initially developed as a raw format, used for Tape Backup and other Sequential Access devices for Backup purposes, it is now commonly used to collate collections of files into one larger file, for Distribution or Archiving , while preserving File System information such as user and group permissions, dates, and Directory structures.

tar's linear roots can still be seen in its ability to work on any data stream and its slow partial extraction performance, as it has to read through the whole archive to extract only the final file. A tar file (somefile.tar), when subsequently compressed using a Compression utility such as Gzip , Bzip , or (formerly) Compress , produces a compressed tar file with a filename extension indicating the type of compression (''e.g.'': somefile.tar.gz). A .tar file is commonly referred to as a tarball, which is usually compressed to save disk space but increases the risk of corrupted data.

As is common with Unix utilities, tar is a single specialist program. It follows the Unix Philosophy in that it can ''"do only one thing"'' (archive), ''"but do it well"''. tar is most commonly used in tandem with an external compression utility, since it has no built-in Data Compression facilities. These compression utilities generally only compress a single file, hence the pairing with tar, which can produce a single file from many files. To ease this common usage, the BSD and GNU versions of tar support the Command Line Option s -z (gzip), and -j (bzip2) which will compress or decompress the archive file it is currently working with, although even in this case the (de)compression is still actually performed by an external program. Compression is sometimes avoided because of the greatly amplified potential for damage to data in long term storage.


FORMAT DETAILS


A tar file is the concatenation of one or more files. Each file is preceded by a Header block. The file data is written unaltered except that its length is rounded up to a multiple of 512 bytes and the extra space is zero filled. The end of an archive is marked by at least two consecutive zero-filled blocks.

A limitation of early tape drives was that data could only be written to them in 512 byte blocks. As a result data in tar files is arranged in 512 byte blocks.

The tar command can write data to tape in chunks of several 512 byte blocks, to minimize the wasted gaps in the tape between write operations. Each chunk is called a record. The user can specify a blocking factor, which is the number of blocks per record. The end of an archive gets padded with additional blocks of zeros to make its total size equal a multiple of records, regardless of whether tape is used as the storage medium.


File header


The file header block contains Metadata about a file. To ensure portability across different architectures with different Byte Orderings , the information in the header block is encoded in ASCII . Thus if all the files in an archive are text files, then the archive is essentially an ASCII file.

The fields defined by the original Unix tar format are listed in the table below. When a field is unused it is zero filled. The header is padded with zero bytes to make it up to a 512 byte block.

The Link indicator field can have the following values:

A directory is also indicated by having a trailing slash(/) in the name.

For historical reasons numerical values are encoded in as ASCII text octal numbers, with leading zeroes. The final character is either a Null or a Space . Thus although there are 12 bytes reserved for storing the file size, only 11 octal digits can be stored. This gives a maximum file size of 8 Gigabyte s on archived files. To overcome this limitation some versions of tar, including the GNU implementation, support an extension in which the file size is encoded in binary. Additionally, versions of GNU tar from 1999 and before pad the values with
Space characters instead of zero characters.

The checksum is calculated by taking the sum of the byte values of the header block ''with the eight checksum bytes taken to be ascii spaces'' (value 32). It is stored as a six digit octal number with leading zeroes followed by a nul and then a space.


USTAR format

Most modern tar programs read and write archives in the new USTAR (Uniform '''S'''tandard '''T'''ape '''Ar'''chive) format, which has an extended header definition as defined by the POSIX (IEEE P1003.1) standards group. Older tar programs will ignore the extra information, while newer programs will test for the presence of the "ustar" string to determine if the new format is in use. The USTAR format allows for longer file names and stores extra information about each file.


Example


The example below shows the ASCII dump of a header block from a tar file created using the GNU tar program. It was dumped with the Od program. The "ustar" magic string followed by two spaces can be seen, meaning that the tar file is in GNU format, partially incompatible with the true USTAR standard (in POSIX.1-1988), which has the signature "ustar" followed by a NUL character.

0000000 e t c / p a s s w d nul nul nul nul nul nul
0000020 nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul

  • 0000140 nul nul nul nul 0 1 0 0 6 4 4 nul 0 0 0 0

0000160 0 0 0 nul 0 0 0 0 0 0 0 nul 0 0 0 0
0000200 0 0 4 1 3 5 5 nul 1 0 1 5 5 0 6 1
0000220 1 0 5 nul 0 1 1 5 5 6 nul sp 0 nul nul nul
0000240 nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul

  • 0000400 nul u s t a r sp sp nul r o o t nul nul nul

0000420 nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul
0000440 nul nul nul nul nul nul nul nul nul r o o t nul nul nul
0000460 nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul nul

  • 0001000


Note, the OpenBSD 3.7 tar does not have the 2 space characters after ''ustar''. They are ''nul'' characters.

Note, GNU tar by default creates incompatible archives in case that the archives contain path names that are longer than 100 characters and GNU tar writes an incorrect size field in case a sparse file has more than 4 holes.


NAMING OF TAR ARCHIVE FILES


Like most Unix utilities, tar doesn't require any particular filename suffix in order to recognize a file as an archive. Conventionally, tar archive files have names ending in ".tar". If an archive is compressed, the compression program adds its own suffix as usual, resulting in filename endings like ".tar.Z", ".tar.gz", and ".tar.bz2".

Names like those can't exist on didn't rise to prominence until after MS-DOS had been mostly abandoned in favor of newer systems with less strict filename requirements.


TARBOMBS


''Tarbomb'' is derogatory Hacker Slang used to refer to a tarball containing files that untar to the current directory instead of untarring into a directory of their own. This can be a potential problem if it overwrites files using the same name in the current directory. It can also be a pain for the user who then needs to delete all the files that are scattered over the directory amongst other files. Often this ends up happening in the user's home directory. Such behaviour is often considered bad etiquette on the part of the archive's creator.


TARPIT


Tarpit is a term to describe a method of revision control where a tar is used to capture the state of development of a software module at a particular point in time. The use of a '''tarpit''' typically loosely mirrors the use of a Revision Control software tag and branching through the use of descriptive names.


NOTES



SEE ALSO




EXTERNAL LINKS