Return to ustar.man CVS log

Up to [MW Coherent from dump] / coherent / d / usr / bin / pax

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

1.1     ! root        1: 
        !             2: 
        !             3: 
        !             4:      UUUUSSSSTTTTAAAARRRR((((1111))))                    CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                     UUUUSSSSTTTTAAAARRRR((((1111))))
        !             5: 
        !             6: 
        !             7: 
        !             8:      NNNNAAAAMMMMEEEE
        !             9:           ustar - process tape archives
        !            10: 
        !            11:      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
        !            12:           uuuussssttttaaaarrrr ----cccc[bbbbffffvvvvwwww] _d_e_v_i_c_e _b_l_o_c_k _f_i_l_e_n_a_m_e...
        !            13:           uuuussssttttaaaarrrr ----rrrr[bbbbvvvvwwww] _d_e_v_i_c_e _b_l_o_c_k [_f_i_l_e_n_a_m_e...]
        !            14:           uuuussssttttaaaarrrr ----tttt[ffffvvvv] _d_e_v_i_c_e
        !            15:           uuuussssttttaaaarrrr ----uuuu[bbbbvvvvwwww] _d_e_v_i_c_e _b_l_o_c_k
        !            16:           uuuussssttttaaaarrrr ----xxxx[ffffllllmmmmoooovvvvwwww] _d_e_v_i_c_e [_f_i_l_e_n_a_m_e...]
        !            17: 
        !            18:      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
        !            19:           _U_s_t_a_r reads and writes archive files which conform to the
        !            20:           AAAArrrrcccchhhhiiiivvvveeee////IIIInnnntttteeeerrrrcccchhhhaaaannnnggggeeee FFFFiiiilllleeee FFFFoooorrrrmmmmaaaatttt specified in _I_E_E_E _S_t_d.
        !            21:           _1_0_0_3._1-_1_9_8_8.
        !            22: 
        !            23:         OOOOppppttttiiiioooonnnnssss
        !            24:           The following options are available:
        !            25: 
        !            26:           ----cccc        Creates a new archive; writing begins at the
        !            27:                     beginning of the archive, instead of after the
        !            28:                     last file.
        !            29: 
        !            30:           ----rrrr        Writes names files to the end of the archive.
        !            31: 
        !            32:           ----tttt        Lists the names of all of the files in the
        !            33:                     archive.
        !            34: 
        !            35:           ----uuuu        Causes named files to be added to the archive if
        !            36:                     they are not already there, or have been modified
        !            37:                     since last written into the archive.  This implies
        !            38:                     the ----rrrr option.
        !            39: 
        !            40:           ----xxxx        Extracts named files from the archive.  If a named
        !            41:                     file matches a directory whose contents had been
        !            42:                     written onto the archive, that directory is
        !            43:                     recursively extracted.  If a named file in the
        !            44:                     archive does not exist on the system, the file is
        !            45:                     create with the same mode as the one in the
        !            46:                     archive, except that the set-user-id and get-
        !            47:                     group-id modes are not set unless the user has
        !            48:                     appropriate privileges.
        !            49: 
        !            50:           If the files exist, their modes are not changed except as
        !            51:           described above.  The owner, group and modification time are
        !            52:           restored if possible.  If no _f_i_l_e_n_a_m_e argument is given, the
        !            53:           entire contents of the archive is extracted.  Note that if
        !            54:           several files with the same name are in the archive, the
        !            55:           last one will overwrite all earlier ones.
        !            56: 
        !            57:           ----bbbb        Causes _u_s_t_a_r to use the next argument on the
        !            58:                     command line as the blocking factor for tape
        !            59:                     records.  The default is 1; the maximum is 20.
        !            60: 
        !            61: 
        !            62: 
        !            63:      Page 1                                         (printed 10/10/90)
        !            64: 
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: 
        !            70:      UUUUSSSSTTTTAAAARRRR((((1111))))                    CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                     UUUUSSSSTTTTAAAARRRR((((1111))))
        !            71: 
        !            72: 
        !            73: 
        !            74:                     This option should only be used with raw magnetic
        !            75:                     tape archives.  Normally, the block size is
        !            76:                     determined automatically when reading tapes.
        !            77: 
        !            78:           ----ffff        Causes _u_s_t_a_r to use the next argument on the
        !            79:                     command line as the name of the archive instead of
        !            80:                     the default, which is usually a tape drive.  If ----
        !            81:                     is specified as a filename _u_s_t_a_r writes to the
        !            82:                     standard output or reads from the standard input,
        !            83:                     whichever is appropriate for the options given.
        !            84:                     Thus, _u_s_t_a_r can be used as the head or tail of a
        !            85:                     pipeline.
        !            86: 
        !            87:           ----llll        Tells _u_s_t_a_r to report if it cannot resolve all of
        !            88:                     the links to the files being archived.  If ----llll is
        !            89:                     not specified, no error messages are written to
        !            90:                     the standard output.  This modifier is only valid
        !            91:                     with the ----cccc, ----rrrr and ----uuuu options.
        !            92: 
        !            93:           ----mmmm        Tells _u_s_t_a_r not to restore the modification times.
        !            94:                     The modification time of the file will be the time
        !            95:                     of extraction.  This modifier is invalid with th
        !            96:                     ----tttt option.
        !            97: 
        !            98:           ----oooo        Causes extracted files to take on the user and
        !            99:                     group identifier of the user running the program
        !           100:                     rather than those on the archive.  This modifier
        !           101:                     is only valid with the ----xxxx option.
        !           102: 
        !           103:           ----vvvv        Causes _u_s_t_a_r to operate verbosely.  Usually, _u_s_t_a_r
        !           104:                     does its work silently, but the vvvv modifier causes
        !           105:                     it to print the name of each file it processes,
        !           106:                     preceded by the option letter.  With the ----tttt
        !           107:                     option, vvvv gives more information about the archive
        !           108:                     entries than just the name.
        !           109: 
        !           110:           ----wwww        Causes _u_s_t_a_r to print the action to be taken,
        !           111:                     followed by the name of the file, and then wait
        !           112:                     for the user's confirmation.  If a word beginning
        !           113:                     with yyyy is given, the action is performed.  Any
        !           114:                     other input means "no".  This modifier is invalid
        !           115:                     with the ----tttt option.
        !           116: 
        !           117:      FFFFIIIILLLLEEEESSSS
        !           118:           /dev/tty  used to prompt the user for information when the
        !           119:                     ----iiii or ----yyyy options are specified.
        !           120: 
        !           121:      SSSSEEEEEEEE AAAALLLLSSSSOOOO
        !           122:           cpio, dd, find, pax, cpio, ustar
        !           123: 
        !           124:      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
        !           125:           Copyright (c) 1989 Mark H. Colburn.
        !           126: 
        !           127: 
        !           128: 
        !           129:      Page 2                                         (printed 10/10/90)
        !           130: 
        !           131: 
        !           132: 
        !           133: 
        !           134: 
        !           135: 
        !           136:      UUUUSSSSTTTTAAAARRRR((((1111))))                    CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                     UUUUSSSSTTTTAAAARRRR((((1111))))
        !           137: 
        !           138: 
        !           139: 
        !           140:           All rights reserved.
        !           141: 
        !           142:           Redistribution and use in source and binary forms are
        !           143:           permitted provided that the above copyright notice is
        !           144:           duplicated in all such forms and that any documentation,
        !           145:           advertising materials, and other materials related to such
        !           146:           distribution and use acknowledge that the software was
        !           147:           developed by Mark H. Colburn and sponsored by The USENIX
        !           148:           Association.
        !           149: 
        !           150:           THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS
        !           151:           OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
        !           152:           IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
        !           153:           PARTICULAR PURPOSE.
        !           154: 
        !           155:      AAAAUUUUTTTTHHHHOOOORRRR
        !           156:           Mark H. Colburn
        !           157:           NAPS International
        !           158:           117 Mackubin Street, Suite 1
        !           159:           St. Paul, MN 55102
        !           160:           [email protected]
        !           161: 
        !           162: 
        !           163:           Sponsored by TTTThhhheeee UUUUSSSSEEEENNNNIIIIXXXX AAAAssssssssoooocccciiiiaaaattttiiiioooonnnn for public distribution.
        !           164: 
        !           165: 
        !           166: 
        !           167: 
        !           168: 
        !           169: 
        !           170: 
        !           171: 
        !           172: 
        !           173: 
        !           174: 
        !           175: 
        !           176: 
        !           177: 
        !           178: 
        !           179: 
        !           180: 
        !           181: 
        !           182: 
        !           183: 
        !           184: 
        !           185: 
        !           186: 
        !           187: 
        !           188: 
        !           189: 
        !           190: 
        !           191: 
        !           192: 
        !           193: 
        !           194: 
        !           195:      Page 3                                         (printed 10/10/90)
        !           196: 
        !           197: 
        !           198: 

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