|
|
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.