sbase/tar.1
FRIGN 5699d5fb64 Refactor tar(1) manpage
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.
2015-02-08 23:16:27 +01:00

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.