sbase

suckless unix tools
git clone git://git.2f30.org/sbase
Log | Files | Refs | README | LICENSE

tar.1 (1482B)


      1 .Dd 2015-10-08
      2 .Dt TAR 1
      3 .Os sbase
      4 .Sh NAME
      5 .Nm tar
      6 .Nd create, list or extract a tape archive
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Fl C Ar dir
     10 .Op Fl J | Fl Z | Fl a | Fl j | Fl z
     11 .Fl x Op Fl m | Fl t
     12 .Op Fl f Ar file
     13 .Op Ar file ...
     14 .Nm
     15 .Op Fl C Ar dir
     16 .Op Fl J | Fl Z | Fl a | Fl j | Fl z
     17 .Op Fl h
     18 .Fl c Ar path ...
     19 .Op Fl f Ar file
     20 .Sh DESCRIPTION
     21 .Nm
     22 is the standard file archiver.
     23 .Sh OPTIONS
     24 .Bl -tag -width Ds
     25 .It Fl c Ar path ...
     26 Create archive from
     27 .Ar path .
     28 .It Fl C Ar dir
     29 Change directory to
     30 .Ar dir
     31 before beginning.
     32 .It Fl f Ar file
     33 Set
     34 .Ar file
     35 as input | output archive instead of stdin | stdout. If '-',
     36 stdin | stdout is used.
     37 .It Fl m
     38 Do not preserve modification time.
     39 .It Fl t
     40 List all files in the archive.
     41 .It Fl x
     42 Extract archive.
     43 .It Fl h
     44 Always dereference symbolic links while recursively traversing directories.
     45 .It Fl J | Fl Z | Fl a | Fl j | Fl z
     46 Use xz | compress | lzma | bzip2 | gzip compression or decompression. These
     47 utilities must be installed separately.
     48 Using these flags is discouraged in favour of the flexibility
     49 and clarity of pipes:
     50 .Bd -literal -offset indent
     51 $ bzip2 -cd archive.tar.bz2 | tar -x
     52 $ gzip -cd archive.tar.gz | tar -x
     53 .Ed
     54 .Bd -literal -offset indent
     55 $ tar -c file ... | bzip2 > archive.tar.bz2
     56 $ tar -c file ... | gzip2 > archive.tar.gz
     57 .Ed
     58 .El
     59 .Sh SEE ALSO
     60 .Xr ar 1 ,
     61 .Xr bzip2 1 ,
     62 .Xr gzip 1
     63 .Sh STANDARDS
     64 The
     65 .Nm
     66 utility is compliant with the UStar (Uniform Standard Tape ARchive)
     67 format defined in the
     68 .St -p1003.1-88
     69 specification.