home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / PAX20.ZIP / TAR.MAN < prev    next >
Text File  |  1990-11-12  |  5KB  |  125 lines
  1. NAME
  2.      tar - process tape archives
  3.  
  4. SYNOPSIS
  5.      tar -c[bfvw] device block filename...
  6.      tar -r[bvw] device block [filename...]
  7.      tar -t[fv] device
  8.      tar -u[bvw] device block
  9.      tar -x[flmovw] device [filename...]
  10.  
  11. DESCRIPTION
  12.      Tar reads and writes archive files which conform to the
  13.      Archive/Interchange File Format specified in IEEE Std.
  14.      1003.1-1988.
  15.  
  16.      Options
  17.      The following options are available:
  18.  
  19.      -c        Creates a new archive; writing begins at the
  20.                beginning of the archive, instead of after the
  21.                last file.
  22.  
  23.      -r        Writes names files to the end of the archive.
  24.  
  25.      -t        Lists the names of all of the files in the
  26.                archive.
  27.  
  28.      -u        Causes named files to be added to the archive if
  29.                they are not already there, or have been modified
  30.                since last written into the archive.  This implies
  31.                the -r option.
  32.  
  33.      -x        Extracts named files from the archive.  If a named
  34.                file matches a directory whose contents had been
  35.                written onto the archive, that directory is recur-
  36.                sively extracted.  If a named file in the archive
  37.                does not exist on the system, the file is create
  38.                with the same mode as the one in the archive,
  39.                except that the set-user-id and get-group-id modes
  40.                are not set unless the user has appropriate
  41.                privileges.
  42.  
  43.      If the files exist, their modes are not changed except as
  44.      described above.  The owner, group and modification time are
  45.      restored if possible.  If no filename argument is given, the
  46.      entire contents of the archive is extracted.  Note that if
  47.      several files with the same name are in the archive, the
  48.      last one will overwrite all earlier ones.
  49.  
  50.      -b        Causes tar to use the next argument on the command
  51.                line as the blocking factor for tape records.  The
  52.                default is 1; the maximum is 20.  This option
  53.                should only be used with raw magnetic tape
  54.                archives.  Normally, the block size is determined
  55.                automatically when reading tapes.
  56.  
  57.      -f        Causes tar to use the next argument on the command
  58.                line as the name of the archive instead of the
  59.                default, which is usually a tape drive.  If - is
  60.                specified as a filename tar writes to the standard
  61.                output or reads from the standard input, whichever
  62.                is appropriate for the options given.  Thus, tar
  63.                can be used as the head or tail of a pipeline.
  64.  
  65.      -l        Tells tar to report if it cannot resolve all of
  66.                the links to the files being archived.  If -l is
  67.                not specified, no error messages are written to
  68.                the standard output.  This modifier is only valid
  69.                with the -c, -r and -u options.
  70.  
  71.      -m        Tells tar not to restore the modification times.
  72.                The modification time of the file will be the time
  73.                of extraction.  This modifier is invalid with th
  74.                -t option.
  75.  
  76.      -o        Causes extracted files to take on the user and
  77.                group identifier of the user running the program
  78.                rather than those on the archive.  This modifier
  79.                is only valid with the -x option.
  80.  
  81.      -v        Causes tar to operate verbosely.  Usually, tar
  82.                does its work silently, but the v modifier causes
  83.                it to print the name of each file it processes,
  84.                preceded by the option letter.  With the -t
  85.                option, v gives more information about the archive
  86.                entries than just the name.
  87.  
  88.      -w        Causes tar to print the action to be taken, fol-
  89.                lowed by the name of the file, and then wait for
  90.                the user's confirmation.  If a word beginning with
  91.                y is given, the action is performed.  Any other
  92.                input means "no".  This modifier is invalid with
  93.                the -t option.
  94.  
  95. FILES
  96.      /dev/tty  used to prompt the user for information when the
  97.                -i or -y options are specified.
  98.  
  99. SEE ALSO
  100.      cpio(1), dd(1), find(1), pax(1), cpio(5), tar(5)
  101.  
  102. COPYRIGHT
  103.      Copyright (c) 1989 Mark H. Colburn.
  104.      All rights reserved.
  105.  
  106.      Redistribution and use in source and binary forms are per-
  107.      mitted provided that the above copyright notice is dupli-
  108.      cated in all such forms and that any documentation,
  109.      advertising materials, and other materials related to such
  110.      distribution and use acknowledge that the software was
  111.      developed by Mark H. Colburn.
  112.  
  113.      THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS
  114.      OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
  115.      IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PAR-
  116.      TICULAR PURPOSE.
  117.  
  118. AUTHOR
  119.      Mark H. Colburn
  120.      Minnetech Consulting, Inc.
  121.      3232 Aquila Lane
  122.      St. Louis Park, MN 55426
  123.  
  124.      mark@Minnetech.MN.ORG
  125.