Annotation of coherent/d/usr/bin/pax/ustar.man, revision 1.1.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: 

unix.superglobalmegacorp.com

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