This is an old revision of the document!
Table of Contents
Working with the Tape Archive Utility (TAR)
To make a tar file from the directory homework1
$ tar czf homework1.tgz homework1
To check the contents of a tar file called homework1.tgz
$ tar tzf homework.tgz
To extract the contents of a tar file called homework1.tgz
$ tar xzf homework1.tgz
Overview
tar or the Tape ARchive utility is a program that is used for combining multiple files into a single file. This is the format that is used to transfer multiple files in the majority of open source project.
Tar files are frequently used to transfer the contents of a directory. The examples on this page assume that you want to transfer all of the files in a directory called homework1 . Further assume the contents of this directory are two files, hello.cpp and Makefile .
$ ls Makefile hello.cpp
Files created with tar frequently have the extension .tar. The file homework1.tar is the conventional name used for a tar file containing the directory homework1.
Tar is frequently used in conjunction with compression utilities. GNU zip (gzip) is a common choice for this. A tar file which has been compressed with gzip will frequently have the extension .tgz or even .tar.gz. In this case homework1.tgz or homework1.tar.gz are the conventional names for a tar file containing the directory homework1 which has been compressed with gzip.
This page is a summary, there are other ways that tar can be employed.
Creating a TAR File
The best practice is to work on each project in a folder or directory. For this example the code for a project is located in the directory homework1.
- Move one directory above the homework1 directory
- If you can see the directory you wish to create a tar archive of when you type ls you are in the correct directory.
$ls homework1
- type the command tar cvzf homework1.tgz homework1
- c tells tar to create a tar archive.
- v tells tar to show you what it is adding to the archive
- z tells tar to use gnuzip to compress the resulting file
- f tells tar to write the output to a file, not to the tape deck
- homework1 is the name of the directory you wish to place in the tar file
- homework1.tgz is the name of the output file.
$ tar cvzf homework1.tgz homework1 homework1/ homework1/Makefile homework1/hello.cpp