5699d5fb64
and mark it as finished in the README. Specifically, add a small section on the compression flags, which are basically an infected GNU limb which should be removed from the face of the earth as soon as possible.
72 lines
1.3 KiB
Groff
72 lines
1.3 KiB
Groff
.Dd February 8, 2015
|
|
.Dt TAR 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm tar
|
|
.Nd create, list or extract a tape archive
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl C Ar dir
|
|
.Op Fl j | Fl z
|
|
.Fl x Op Fl m | Fl t
|
|
.Op Fl f Ar file
|
|
.Nm
|
|
.Op Fl C Ar dir
|
|
.Op Fl j | Fl z
|
|
.Fl c Ar dir
|
|
.Op Fl f Ar file
|
|
.Nm
|
|
.Op Fl C Ar dir
|
|
.Op Fl j | Fl z
|
|
.Fl cf
|
|
.Ar file Ar dir
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is the standard file archiver.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Ds
|
|
.It Fl c Ar path
|
|
Create archive from
|
|
.Ar path .
|
|
.It Fl C Ar dir
|
|
Change directory to
|
|
.Ar dir
|
|
before beginning.
|
|
.It Fl f Ar file
|
|
Set
|
|
.Ar file
|
|
as input | output archive instead of stdin | stdout.
|
|
.It Fl m
|
|
Do not preserve modification time.
|
|
.It Fl t
|
|
List all files in the archive.
|
|
.It Fl x
|
|
Extract archive.
|
|
.It Fl j | Fl z
|
|
Use bzip2 | gzip compression. The
|
|
.Xr bzip2 1 |
|
|
.Xr gzip 1
|
|
utilities must be installed separately.
|
|
Using these flags is discouraged in favour of the flexibility
|
|
and clarity of pipes:
|
|
.Bd -literal -offset indent
|
|
$ bzcat archive.tar.bz2 | tar -x
|
|
$ zcat archive.tar.gz | tar -x
|
|
.Ed
|
|
.Bd -literal -offset indent
|
|
$ tar -c file ... | bzip2 > archive.tar.bz2
|
|
$ tar -c file ... | gzip2 > archive.tar.gz
|
|
.Ed
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr ar 1 ,
|
|
.Xr bzip2 1 ,
|
|
.Xr gzip 1
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is compliant with the UStar (Uniform Standard Tape ARchive)
|
|
format defined in the
|
|
.St -p1003.1-88
|
|
specification.
|