Annotation of coherent/d/usr/bin/pax/shipping/ustar.man, revision 1.1

1.1     ! root        1:      USTAR         COHERENT (USENIX Association)         USTAR
        !             2:      NAME
        !             3:           ustar - process tape archives
        !             4:      SYNOPSIS
        !             5:           ustar -c[bfvw] device block filename...
        !             6:           ustar -r[bvw] device block [filename...]
        !             7:           ustar -t[fv] device
        !             8:           ustar -x[flmovw] device [filename...]
        !             9:      DESCRIPTION
        !            10:           Ustar reads and writes archive files which conform to the
        !            11:           Archive/Interchange File Format specified in IEEE Std.
        !            12:           1003.1-1988.
        !            13:         Options
        !            14:           The following options are available:
        !            15:           -c        Creates a new archive; writing begins at the
        !            16:                     beginning of the archive, instead of after the
        !            17:                     last file.
        !            18:           -r        Writes names files to the end of the archive.
        !            19:           -t        Lists the names of all of the files in the
        !            20:                     archive.
        !            21:           -x        Extracts named files from the archive.  If a named
        !            22:                     file matches a directory whose contents had been
        !            23:                     written onto the archive, that directory is
        !            24:                     recursively extracted.  If a named file in the
        !            25:                     archive does not exist on the system, the file is
        !            26:                     create with the same mode as the one in the
        !            27:                     archive, except that the set-user-id and get-
        !            28:                     group-id modes are not set unless the user has
        !            29:                     appropriate privileges.
        !            30:           If the files exist, their modes are not changed except as
        !            31:           described above.  The owner, group and modification time are
        !            32:           restored if possible.  If no filename argument is given, the
        !            33:           entire contents of the archive is extracted.  Note that if
        !            34:           several files with the same name are in the archive, the
        !            35:           last one will overwrite all earlier ones.
        !            36:           -b        Causes ustar to use the next argument on the command
        !            37:                     line as the blocking factor for tape records.  The
        !            38:                     default is 1; the maximum is 20.  This option
        !            39:      Page 1                                          (printed 5/24/90)
        !            40:      USTAR         COHERENT (USENIX Association)         USTAR
        !            41:                     should only be used with raw magnetic tape
        !            42:                     archives.  Normally, the block size is determined
        !            43:                     automatically when reading tapes.
        !            44:           -f        Causes ustar to use the next argument on the command
        !            45:                     line as the name of the archive instead of the
        !            46:                     default, which is usually a tape drive.  If - is
        !            47:                     specified as a filename ustar writes to the standard
        !            48:                     output or reads from the standard input, whichever
        !            49:                     is appropriate for the options given.  Thus, ustar
        !            50:                     can be used as the head or tail of a pipeline.
        !            51:           -l        Tells ustar to report if it cannot resolve all of
        !            52:                     the links to the files being archived.  If -l is
        !            53:                     not specified, no error messages are written to
        !            54:                     the standard output.  This modifier is only valid
        !            55:                     with the -c, -r and -u options.
        !            56:           -m        Tells ustar not to restore the modification times.
        !            57:                     The modification time of the file will be the time
        !            58:                     of extraction.  This modifier is invalid with th
        !            59:                     -t option.
        !            60:           -o        Causes extracted files to take on the user and
        !            61:                     group identifier of the user running the program
        !            62:                     rather than those on the archive.  This modifier
        !            63:                     is only valid with the -x option.
        !            64:           -v        Causes ustar to operate verbosely.  Usually, ustar
        !            65:                     does its work silently, but the v modifier causes
        !            66:                     it to print the name of each file it processes,
        !            67:                     preceded by the option letter.  With the -t
        !            68:                     option, v gives more information about the archive
        !            69:                     entries than just the name.
        !            70:           -w        Causes ustar to print the action to be taken,
        !            71:                     followed by the name of the file, and then wait
        !            72:                     for the user's confirmation.  If a word beginning
        !            73:                     with y is given, the action is performed.  Any
        !            74:                     other input means "no".  This modifier is invalid
        !            75:                     with the -t option.
        !            76: 
        !            77:          To create archive on high density floppy, enter (disk has been
        !            78:          formated before):
        !            79:                ustar cvf /dev/fha0 files_names
        !            80:          To display a listing of the archive:
        !            81:                ustar tvf /dev/fha0
        !            82:          For extract the files from this archive you can print:
        !            83:                ustar xvf /dev/fha0
        !            84:      SEE ALSO
        !            85:           cpio, dd, find, pax
        !            86: 
        !            87:      NOTES
        !            88:          Name ustar was selected because new tar uses ustar format and
        !            89:          by distinguish between original COHERENT tar and new one.
        !            90: 
        !            91:          Because COHERENT has memory restriction ustar cannot create
        !            92:          archive on big directories tree (about 2 Mb and more). 
        !            93: 
        !            94:          ustar cannot append on magnetic tape.
        !            95:        
        !            96:          ustar doesn't support option -u .
        !            97:          
        !            98:      COPYRIGHT
        !            99:           Copyright (c) 1989 Mark H. Colburn.
        !           100:          COHERENT pax/ustar/cpio are based on original code for pax
        !           101:          which is sponsored by The USENIX Association.
        !           102: 
        !           103:      Page 3                                          (printed 5/24/90)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.