Imported Upstream version 2.5.2
[debian/dds2tar] / dds2tar.ps
1 %!PS-Adobe-3.0
2 %%Creator: groff version 1.10
3 %%CreationDate: Mon Feb  2 16:42:11 1998
4 %%DocumentNeededResources: font Times-Roman
5 %%+ font Times-Bold
6 %%+ font Times-Italic
7 %%DocumentSuppliedResources: procset grops 1.10 0
8 %%Pages: 4
9 %%PageOrder: Ascend
10 %%Orientation: Portrait
11 %%EndComments
12 %%BeginProlog
13 %%BeginResource: procset grops 1.10 0
14 /setpacking where{
15 pop
16 currentpacking
17 true setpacking
18 }if
19 /grops 120 dict dup begin
20 /SC 32 def
21 /A/show load def
22 /B{0 SC 3 -1 roll widthshow}bind def
23 /C{0 exch ashow}bind def
24 /D{0 exch 0 SC 5 2 roll awidthshow}bind def
25 /E{0 rmoveto show}bind def
26 /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
27 /G{0 rmoveto 0 exch ashow}bind def
28 /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
29 /I{0 exch rmoveto show}bind def
30 /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
31 /K{0 exch rmoveto 0 exch ashow}bind def
32 /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
33 /M{rmoveto show}bind def
34 /N{rmoveto 0 SC 3 -1 roll widthshow}bind def
35 /O{rmoveto 0 exch ashow}bind def
36 /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
37 /Q{moveto show}bind def
38 /R{moveto 0 SC 3 -1 roll widthshow}bind def
39 /S{moveto 0 exch ashow}bind def
40 /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
41 /SF{
42 findfont exch
43 [exch dup 0 exch 0 exch neg 0 0]makefont
44 dup setfont
45 [exch/setfont cvx]cvx bind def
46 }bind def
47 /MF{
48 findfont
49 [5 2 roll
50 0 3 1 roll
51 neg 0 0]makefont
52 dup setfont
53 [exch/setfont cvx]cvx bind def
54 }bind def
55 /level0 0 def
56 /RES 0 def
57 /PL 0 def
58 /LS 0 def
59 /MANUAL{
60 statusdict begin/manualfeed true store end
61 }bind def
62 /PLG{
63 gsave newpath clippath pathbbox grestore
64 exch pop add exch pop
65 }bind def
66 /BP{
67 /level0 save def
68 1 setlinecap
69 1 setlinejoin
70 72 RES div dup scale
71 LS{
72 90 rotate
73 }{
74 0 PL translate
75 }ifelse
76 1 -1 scale
77 }bind def
78 /EP{
79 level0 restore
80 showpage
81 }bind def
82 /DA{
83 newpath arcn stroke
84 }bind def
85 /SN{
86 transform
87 .25 sub exch .25 sub exch
88 round .25 add exch round .25 add exch
89 itransform
90 }bind def
91 /DL{
92 SN
93 moveto
94 SN
95 lineto stroke
96 }bind def
97 /DC{
98 newpath 0 360 arc closepath
99 }bind def
100 /TM matrix def
101 /DE{
102 TM currentmatrix pop
103 translate scale newpath 0 0 .5 0 360 arc closepath
104 TM setmatrix
105 }bind def
106 /RC/rcurveto load def
107 /RL/rlineto load def
108 /ST/stroke load def
109 /MT/moveto load def
110 /CL/closepath load def
111 /FL{
112 currentgray exch setgray fill setgray
113 }bind def
114 /BL/fill load def
115 /LW/setlinewidth load def
116 /RE{
117 findfont
118 dup maxlength 1 index/FontName known not{1 add}if dict begin
119 {
120 1 index/FID ne{def}{pop pop}ifelse
121 }forall
122 /Encoding exch def
123 dup/FontName exch def
124 currentdict end definefont pop
125 }bind def
126 /DEFS 0 def
127 /EBEGIN{
128 moveto
129 DEFS begin
130 }bind def
131 /EEND/end load def
132 /CNT 0 def
133 /level1 0 def
134 /PBEGIN{
135 /level1 save def
136 translate
137 div 3 1 roll div exch scale
138 neg exch neg exch translate
139 0 setgray
140 0 setlinecap
141 1 setlinewidth
142 0 setlinejoin
143 10 setmiterlimit
144 []0 setdash
145 /setstrokeadjust where{
146 pop
147 false setstrokeadjust
148 }if
149 /setoverprint where{
150 pop
151 false setoverprint
152 }if
153 newpath
154 /CNT countdictstack def
155 userdict begin
156 /showpage{}def
157 }bind def
158 /PEND{
159 clear
160 countdictstack CNT sub{end}repeat
161 level1 restore
162 }bind def
163 end def
164 /setpacking where{
165 pop
166 setpacking
167 }if
168 %%EndResource
169 %%IncludeResource: font Times-Roman
170 %%IncludeResource: font Times-Bold
171 %%IncludeResource: font Times-Italic
172 grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
173 def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
174 /Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/.notdef/.notdef
175 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
176 /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
177 /.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
178 /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
179 /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
180 /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
181 /P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
182 /underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
183 /z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
184 /guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
185 /endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
186 /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
187 /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
188 /brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
189 /logicalnot/minus/registered/macron/degree/plusminus/twosuperior
190 /threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
191 /ordmasculine/guilsinglright/onequarter/onehalf/threequarters
192 /questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
193 /Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
194 /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
195 /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
196 /germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
197 /egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
198 /eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
199 /ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
200 /Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE
201 /Times-Roman@0 ENC0/Times-Roman RE
202 %%EndProlog
203 %%Page: 1 1
204 %%BeginPageSetup
205 BP
206 %%EndPageSetup
207 /F0 10/Times-Roman@0 SF 371.08(dds2tar\(1L\) dds2tar\(1L\))72 48 R/F1 9
208 /Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0(dds2tar \255 tool for f)108
209 96 Q(ast tape access)-.1 E F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF
210 (dds2tar)108 124.8 Q F0([)2.5 E F2(-f)2.5 E/F3 10/Times-Italic@0 SF(de)
211 2.5 E(vice)-.15 E F0 2.5(][)2.5 G F2(-t)A F3(inde)2.5 E(x\214le)-.2 E F0
212 2.5(][)2.5 G(options])-2.5 E F3(string ...)2.5 E F1(DESCRIPTION)72 146.4
213 Q F2(dds2tar)108 158.4 Q F0 .902(uses an inde)3.402 F 3.402(xt)-.15 G
214 3.402<6f8c>-3.402 G .902(nd the \214les with record seek \(a f)-3.402 F
215 .901(ast operation of D)-.1 F 3.121 -1.11(AT d)-.4 H -.25(ev)1.11 G
216 3.401(ices\). Since).25 F .901(the \214le)3.401 F .789
217 (structure of the tape archi)108 170.4 R -.15(ve)-.25 G 3.289(si).15 G
218 3.289(su)-3.289 G .789(sed to e)-3.289 F .789
219 (xtract the \214les, the archi)-.15 F 1.09 -.15(ve h)-.25 H .79
220 (as to be created by).15 F F2(tar)3.29 E F0 3.29(,c)C(ompressed)-3.29 E
221 .546(only by \(the transparent signal processor of\) the de)108 182.4 R
222 3.045(vice. So)-.25 F .545(you can step through the archi)3.045 F .845
223 -.15(ve ve)-.25 H .545(ry quickly).15 F .372(and e)108 194.4 R .372
224 (xtract \214les.)-.15 F .372(The inde)5.372 F 2.872(xm)-.15 G .372
225 (ay be created using)-2.872 F F2(dds2index)2.872 E F0(or)2.872 E F2(tar)
226 2.872 E F0 .372(-vRt and is normally stored as a \214le on)B
227 (your hard disk.)108 206.4 Q 2.549(At)108 223.2 S .049(ar archi)-2.549 F
228 .349 -.15(ve i)-.25 H 2.549(sas).15 G .049
229 (equence of blocks \(e.g. 10240 bytes by def)-2.549 F .049
230 (ault\), each containing the same number \(20 by)-.1 F(def)108 235.2 Q
231 .755(ault\) of records, 512 byte each.)-.1 F F2(dds2tar)5.755 E F0 .755
232 (reads the tape and writes the tar records of the speci\214ed \214les)
233 3.255 F 1.721(\(that means the header record and the data records of ea\
234 ch selected \214le\) to stdout.)108 247.2 R -1.1(Yo)6.721 G 4.221(um)1.1
235 G 1.721(ay pipe the)-4.221 F F2(dds2tar)108 259.2 Q F0 1.782
236 (output to the stdin of)4.282 F F3 1.783(tar -xvvf -)4.283 F F0 1.783
237 (to restore the \214les to your disk.)4.283 F(\(See)6.783 E F2(EXAMPLES)
238 4.283 E F0(belo)4.283 E -.65(w.)-.25 G(\)).65 E(Before a \214le is e)108
239 271.2 Q(xtracted, the records of parent directories of the \214le are a\
240 lso written to stdout.)-.15 E .129(The inde)108 288 R 2.629(xo)-.15 G
241 2.628(ft)-2.629 G .128(he archi)-2.628 F .428 -.15(ve s)-.25 H .128(hou\
242 ld contain enough information to compute the number of the block contai\
243 ning).15 F .334(the header of each selected \214le.)108 300 R F2
244 (dds2index)5.335 E F0 .335(will gi)2.835 F .635 -.15(ve s)-.25 H .335
245 (uch a table,).15 F F2 .335(tar -Rvt)2.835 F F0 .335
246 (e.g. will not \(only record num-)2.835 F .104(bers are listed\).)108
247 312 R 2.604(Ap)5.104 G .104(atch for)-2.604 F F2 .103(GNU tar)2.603 F
248 (-1.12)-.37 E F0 .103(is a)2.603 F -.25(va)-.2 G .103
249 (ilable, adding the option).25 F F2(--r)2.603 E(ecord-\214le.)-.18 E F0
250 (Alternati)5.103 E -.15(ve)-.25 G .103(ly there).15 F
251 (are some tricks to get the missing information.)108 324 Q .455
252 (The strings are re)108 340.8 R .455(gular e)-.15 F .455
253 (xpressions to select the \214les.)-.15 F .456
254 (The matching algorithm is the one from GNU tar)5.456 F 2.956(.I)-.55 G
255 (f)-2.956 E .274(the option)108 352.8 R F2(-l)2.774 E F0 .274(is gi)
256 2.774 F -.15(ve)-.25 G .274
257 (n, the matched \214le names are printed to stdout \(Y).15 F .273
258 (ou may not pipe this list of pathnames)-1.1 F(to tar!\).)108 364.8 Q
259 .726(The def)108 381.6 R .726(ault de)-.1 F .726(vice is)-.25 F F3(/de)
260 3.226 E(v/rmt0)-.15 E F0 3.226(,w).47 G .726(hich may be o)-3.226 F -.15
261 (ve)-.15 G .726(rridden with the en).15 F .726(vironment v)-.4 F
262 (ariable)-.25 E F2 -.9(TA)3.226 G(PE).9 E F0 3.226(,w)C .726(hich in)
263 -3.226 F(turn may be o)108 393.6 Q -.15(ve)-.15 G(rridden with the).15 E
264 F2(-f)2.5 E F3(de)2.85 E(vice)-.15 E F0(option. The de)2.5 E
265 (vice must be a SCSI tape de)-.25 E(vice.)-.25 E F1(OPTIONS)72 410.4 Q
266 F2(-f)108 422.4 Q F3(de)2.85 E(vice\214le)-.15 E F0(De)2.5 E
267 (vice of the tape archi)-.25 E -.15(ve)-.25 G 2.5(.M).15 G
268 (ust be a SCSI tape de)-2.5 E(vice.)-.25 E F2(-t)108 439.2 Q F3(inde)
269 2.51 E(x\214le)-.2 E F0(Speci\214es the inde)144 451.2 Q 2.5<788c>-.15 G
270 (le \(def)-2.5 E(ault is stdin\).)-.1 E F2(-s #)108 468 Q F0 .01
271 (Set the number of the \214rst tape block of the archi)21.28 F -.15(ve)
272 -.25 G 2.51(.T).15 G .01(his option is useful only if the inde)-2.51 F
273 2.51<788c>-.15 G .01(le con-)-2.51 F .995(tains the v)144 480 R .995
274 (erbose output of)-.15 F F2 .995(tar -Rvt.)3.495 F F0(An)5.996 E 3.496
275 (yi)-.15 G .996(nformation about the \214rst block inside the inde)
276 -3.496 F 3.496<788c>-.15 G(le)-3.496 E .384(will be o)144 492 R -.15(ve)
277 -.15 G .384(rridden by this option.).15 F .384(If no information is a)
278 5.384 F -.25(va)-.2 G .384(ilable, the archi).25 F .684 -.15(ve h)-.25 H
279 .384(as to be the \214rst \214le).15 F(of the tape. If you ha)144 504 Q
280 .3 -.15(ve p)-.2 H
281 (ositioned your tape at the \214rst block of the archi).15 E -.15(ve)
282 -.25 G 2.5(,y).15 G(ou can use)-2.5 E F2
283 (dds2tar `mt-dds` -t index ... | tar -f - ...)144 520.8 Q F0
284 (to complete the information of the output of)144 537.6 Q F2(tar -Rvt)
285 2.5 E F0(stored in the inde)2.5 E 2.5<788c>-.15 G(le.)-2.5 E F2(-b #)108
286 554.4 Q F0 .639(Set the blocksize of the archi)19.61 F .939 -.15(ve \()
287 -.25 H .64(tar -b #\). This option is useful only if the inde).15 F 3.14
288 <788c>-.15 G .64(le contains the)-3.14 F -.15(ve)144 566.4 S .183
289 (rbose output of tar \(or if you ha).15 F .483 -.15(ve p)-.2 H .183
290 (roblems with the size of the internal b).15 F(uf)-.2 E .182
291 (fer of dds2tar\).)-.25 F(An)5.182 E(y)-.15 E .209
292 (information about the blocksize inside the inde)144 578.4 R 2.709<788c>
293 -.15 G .209(le will be o)-2.709 F -.15(ve)-.15 G .21
294 (rridden by this option.).15 F .21(If no infor)5.21 F(-)-.2 E
295 (mation is a)144 590.4 Q -.25(va)-.2 G(ilable, the def).25 E
296 (ault blocksize of tar is used.)-.1 E F2(-z)108 607.2 Q F0(The inde)
297 28.23 E 2.5<788c>-.15 G
298 (le should be read and stored in compressed mode.)-2.5 E F1(OPTIONS y)72
299 624 Q(ou didn't r)-.225 E(eally need)-.162 E F2(--z, --no-compr)108 636
300 Q(ess)-.18 E F0(Don')144 648 Q 2.5<748c>-.18 G(lter the archi)-2.5 E .3
301 -.15(ve \214)-.25 H(le through gzip.).15 E F2(-q, --quick)108 664.8 Q F0
302 (Don')144 676.8 Q 3.205(te)-.18 G .705
303 (xtract the parent directories of the selected objects from tape.)-3.355
304 F F2(--body)5.704 E F0 .704(Write only the \214rst)3.204 F .161
305 (selected \214le to stdout. This is useful if you w)144 688.8 R .161
306 (ant to read a \214le or e)-.1 F .161(xtract an archi)-.15 F .461 -.15
307 (ve w)-.25 H .161(hich is part of).15 F(the current archi)144 700.8 Q
308 -.15(ve)-.25 G(.).15 E 220.25(2.3 1)299.75 768 R EP
309 %%Page: 2 2
310 %%BeginPageSetup
311 BP
312 %%EndPageSetup
313 /F0 10/Times-Roman@0 SF 371.08(dds2tar\(1L\) dds2tar\(1L\))72 48 R/F1 10
314 /Times-Bold@0 SF(-v)108 84 Q F0(,)A F1(--v)A(erbose)-.1 E F0 -.15(ve)144
315 96 S(rbose mode.).15 E F1(--hash-mode)108 112.8 Q F0
316 (Print a hash sign for each MB.)144 124.8 Q F1(-V)108 141.6 Q F0(,)A F1
317 (--v)A(ersion)-.1 E F0(Print only the V)144 153.6 Q
318 (ersion Number to stderr)-1.11 E(.)-.55 E F1(-l)108 170.4 Q F0(Don')
319 29.89 E 3.226(ta)-.18 G .726(ccess the tape b)-3.226 F .726
320 (ut print the \214le names to stdout.)-.2 F -1.1(Yo)5.725 G 3.225(um)1.1
321 G .725(ay not pipe this list of pathnames)-3.225 F(into tar)144 182.4 Q
322 (.)-.55 E F1(--extract)108 199.2 Q F0 .22
323 (The stdout is closed and opened by a pipe to the command)144 211.2 R F1
324 .221(tar -fxb - 1 .)2.721 F F0 -1.1(Yo)5.221 G 2.721(um)1.1 G .221
325 (ay \214nd this option)-2.721 F(con)144 223.2 Q -.15(ve)-.4 G
326 (nient, I lik).15 E 2.5(et)-.1 G 2.5(op)-2.5 G
327 (ipe the output to tar by hand.)-2.5 E/F2 9/Times-Bold@0 SF(EXAMPLES)72
328 240 Q F0(Example of)108 252 Q F1(getting the index)2.5 E F0
329 (from the def)2.5 E(ault tape /de)-.1 E
330 (v/rmt0 and storing it in \214le archi)-.25 E -.15(ve)-.25 G(.idx:).15 E
331 (dds2inde)144 268.8 Q 2.5(x-)-.15 G 2.5(ta)-2.5 G(rchi)-2.5 E -.15(ve)
332 -.25 G(.idx).15 E(Alternati)108 285.6 Q -.15(ve)-.25 G .271
333 (ly you can use a patched v).15 F .271(ersion of tar to create an inde)
334 -.15 F 2.771<788c>-.15 G 2.771(le. W)-2.771 F .271
335 (ith the patch you can direct the)-.4 F .801(errors and w)108 297.6 R
336 .801(arning to stdout and the inde)-.1 F 3.301(xi)-.15 G .802
337 (nformation including information about the blocksize and the)-3.301 F
338 (number of the \214rst block to a \214le:)108 309.6 Q
339 (tar -t --record-\214le archi)144 326.4 Q -.15(ve)-.25 G(.idx).15 E .385
340 (If the archi)108 343.2 R .685 -.15(ve i)-.25 H 2.885(st).15 G .384
341 (he \214rst \214le of the tape and the blocksize is the def)-2.885 F
342 .384(ault of 20, you can use the v)-.1 F .384(erbose out-)-.15 F
343 (put of tar \(-Rv\) as an inde)108 355.2 Q 2.5<788c>-.15 G(le.)-2.5 E
344 (tar -t -v -R | tee archi)144 372 Q -.15(ve)-.25 G(.idx).15 E .203
345 (If the archi)108 388.8 R .503 -.15(ve i)-.25 H 2.703(sn).15 G .204(ot \
346 the \214rst \214le of the tape, you can store all the necessary informa\
347 tion inside the inde)-2.703 F 2.704<788c>-.15 G(le)-2.704 E
348 (with the use of)108 400.8 Q F1(mt-dds)2.5 E F0(and)2.5 E F1(tar)2.5 E
349 F0(:)2.5 E(mt asf ...)144 417.6 Q(mt-dds tell > archi)144 429.6 Q -.15
350 (ve)-.25 G(.idx).15 E(tar -tvR >>archi)144 441.6 Q -.15(ve)-.25 G(.idx)
351 .15 E .057(Example of)108 458.4 R F1 .057(using dds2tar)2.557 F F0 .057
352 (to e)2.557 F .056(xtract the gnu library \(all \214les containing the \
353 string "glibc" in \214lename\) from)-.15 F(the def)108 470.4 Q
354 (ault tape /de)-.1 E(v/rmt0, using the pre)-.25 E(viously stored inde)
355 -.25 E 2.5<788c>-.15 G(le archi)-2.5 E -.15(ve)-.25 G(.idx:).15 E
356 (dds2tar -t archi)144 487.2 Q -.15(ve)-.25 G
357 (.idx '*glibc*' | tar xvvf -).15 E 2.206 -.8(To s)108 504 T .606
358 (ee in adv).8 F .607(ance what w)-.25 F .607(ould happen in the pre)-.1
359 F .607(vious command without actually writing an)-.25 F .607
360 (ything to your)-.15 F(disk, you may use:)108 516 Q(dds2tar -t archi)144
361 532.8 Q -.15(ve)-.25 G(.idx '*glibc*' | tar tvvf -).15 E
362 (Example of checking the matches. Y)108 549.6 Q(ou may try:)-1.1 E
363 (dds2tar -t archi)144 566.4 Q -.15(ve)-.25 G(.idx -l '*glibc*').15 E F2
364 -.27(BA)72 612 S(CKGR)-.225 E(OUND INFORMA)-.27 E(TION)-.855 E F1(tapes)
365 87 624 Q F0 2.517(At)108 636 S .017(ape de)-2.517 F .017
366 (vice handles all I/O \(read, write, seek\) in units of)-.25 F/F3 10
367 /Times-Italic@0 SF .016(tape r)2.516 F(ecor)-.37 E(ds)-.37 E F0 5.016
368 (.T).27 G .016(he bigger a tape record, the more)-5.016 F(ef)108 648 Q
369 (fecti)-.25 E .362 -.15(ve u)-.25 H .063
370 (sually is the access \(and the less g).15 F .063
371 (aps are on QIC-tapes\).)-.05 F(Ho)5.063 E(we)-.25 E -.15(ve)-.25 G .863
372 -.4(r, n).15 H .063(ormally a program will only).4 F
373 (read or write complete tape records.)108 660 Q .433(Normal tape dri)108
374 684 R -.15(ve)-.25 G 2.933(sa).15 G(llo)-2.933 E 2.933(wt)-.25 G 2.933
375 (os)-2.933 G .433(eek only relati)-2.933 F .733 -.15(ve t)-.25 H 2.932
376 (ot).15 G .432(he current position. Ho)-2.932 F(we)-.25 E -.15(ve)-.25 G
377 1.232 -.4(r, s).15 H .432(ome ne).4 F .432(wer SCSI-2 tapes,)-.25 F .553
378 (i.e. D)108 696 R -1.02 -1.11(AT ,)-.4 H .553
379 (conforming to the DDS standard, k)4.163 F .554
380 (eep track of the absolute position on the tape by inserting the)-.1 F
381 (tape record number inside each track.)108 708 Q
382 (This number can be read while the f)5 E(ast seek is performed.)-.1 E
383 220.25(2.3 2)299.75 768 R EP
384 %%Page: 3 3
385 %%BeginPageSetup
386 BP
387 %%EndPageSetup
388 /F0 10/Times-Roman@0 SF 371.08(dds2tar\(1L\) dds2tar\(1L\))72 48 R(The)
389 108 84 Q/F1 10/Times-Bold@0 SF(tar\(1\))3.045 E F0 .545
390 (program uses a slightly dif)3.045 F .545(ferent terminology)-.25 F
391 5.545(.I)-.65 G 3.045(tc)-5.545 G(alls)-3.045 E/F2 10/Times-Italic@0 SF
392 .545(tape bloc)3.045 F(ks)-.2 E F0 .545(what normally is called)3.045 F
393 F2(tape)3.045 E -.37(re)108 96 S(cor).37 E(ds)-.37 E F0 5(.I).27 G 2.5
394 (nt)-5 G(he follo)-2.5 E(wing sections we use the tar terminology to a)
395 -.25 E -.2(vo)-.2 G(id confusion.).2 E F1(tar)87 112.8 Q F0 .814
396 (The unit inside a)108 124.8 R F1(tar)3.314 E F0(archi)3.314 E 1.115
397 -.15(ve i)-.25 H 3.315(sa).15 G F2 .815(tar r)B(ecor)-.37 E(d)-.37 E F0
398 .815(with a \214x)3.315 F .815(ed length of 512 bytes. Ev)-.15 F .815
399 (ery \214le, directory or soft)-.15 F .777(link will occup)108 136.8 R
400 3.277(ya)-.1 G 3.277(tl)-3.277 G .777(east one tar record of informatio\
401 n about pathname, permission information and so on)-3.277 F .118
402 (called header record.)108 148.8 R .119(The data of each \214le is stor\
403 ed in additional tar records directly after the header record)5.119 F
404 (of that \214le.)108 160.8 Q .937(tar reports the)108 177.6 R F2 .937
405 (tar r)3.437 F(ecor)-.37 E 3.437(dn)-.37 G(umber)-3.437 E F0 .936(of e)
406 3.437 F -.15(ve)-.25 G .936(ry header record in the archi).15 F 1.236
407 -.15(ve w)-.25 H .936(ith its -R option.).15 F .936(tar counts the)5.936
408 F(records continuously)108 189.6 Q 2.5(,s)-.65 G(tarting with)-2.5 E F1
409 (0)2.5 E F0(\(if in)2.5 E -.2(vo)-.4 G -.1(ke).2 G 2.5(da).1 G 2.5(st)
410 -2.5 G(ar -tR\) or with)-2.5 E F1(1)2.5 E F0(\(if in)2.5 E -.2(vo)-.4 G
411 -.1(ke).2 G 2.5(da).1 G 2.5(st)-2.5 G(ar -cR\).)-2.5 E .074
412 (tar handles multiple records as a)108 206.4 R F2 .074(tar bloc)2.574 F
413 (k)-.2 E F0 2.574(,m).67 G .074(ainly to mak)-2.574 F 2.574(et)-.1 G
414 .074(he access of tapes \(or disks\) more ef)-2.574 F .075
415 (\214cient \(and)-.25 F(sa)108 218.4 Q .443 -.15(ve t)-.2 H .143
416 (ape space of QIC-tapes\).).15 F .142
417 (tar only writes and reads full blocks to or from an archi)5.143 F -.15
418 (ve)-.25 G 5.142(.T).15 G .142(he -b option of)-5.142 F .238
419 (tar controls, ho)108 230.4 R 2.738(wm)-.25 G(an)-2.738 E 2.738(yr)-.15
420 G .238(ecords are in one block. The def)-2.738 F .239
421 (ault number of records per block is)-.1 F F1(20)2.739 E F0 5.239(.T)C
422 .239(his num-)-5.239 F .628(ber is usually called the)108 242.4 R F2
423 .628(tar bloc)3.128 F 3.128(ks)-.2 G(ize)-3.128 E F0 5.628(.H).18 G -.25
424 (ow)-5.628 G -2.15 -.25(ev e).25 H 1.428 -.4(r, t).25 H .627
425 (his term is a little bit confusing, since it does not mean).4 F
426 (the number of bytes in a block.)108 254.4 Q
427 (Thus a perhaps better name w)5 E(ould be the)-.1 E F2(tar bloc)2.5 E
428 (king factor)-.2 E F0(.).73 E F1(tar on tapes)87 283.2 Q F0 .529
429 (tar writes or reads its archi)108 295.2 R .829 -.15(ve t)-.25 H 3.029
430 (oo).15 G 3.029(rf)-3.029 G .529(rom tape in units of tar blocks.)-3.029
431 F .529(As stated abo)5.529 F -.15(ve)-.15 G 3.029(,o).15 G .529
432 (nly a complete tape)-3.029 F .629
433 (block may be transferred to/from tape.)108 307.2 R 2.229 -.8(To e)5.629
434 H .629
435 (xtract a speci\214c tar block from tape, one has to read an entire).65
436 F .517(tape block into a b)108 319.2 R(uf)-.2 E .517(fer and e)-.25 F
437 .517(xtract the speci\214ed tar record from the b)-.15 F(uf)-.2 E .518
438 (fer manually)-.25 F 5.518(.I)-.65 G 3.018(fy)-5.518 G .518(ou w)-3.018
439 F .518(ould lik)-.1 F 3.018(et)-.1 G(o)-3.018 E .688
440 (read a tar record with a gi)108 331.2 R -.15(ve)-.25 G 3.188(nn).15 G
441 (umber)-3.188 E 3.188(,y)-.4 G .688(ou ha)-3.188 F .988 -.15(ve t)-.2 H
442 3.188(ok).15 G(no)-3.188 E 3.188(wt)-.25 G .688
443 (he number of the \214rst tape block of the archi)-3.188 F -.15(ve)-.25
444 G .351(and the tar block size to compute the number of the tape block w\
445 itch contains the tar record to read.)108 343.2 R .351(If the)5.351 F
446 (tar archi)108 355.2 Q .3 -.15(ve i)-.25 H 2.5(st).15 G
447 (he \214rst \214le on the tape, the)-2.5 E F2(tape bloc)2.5 E 2.5(kn)-.2
448 G(umber)-2.5 E F0(is the equal to the)2.5 E F2(tar bloc)2.5 E 2.5(kn)-.2
449 G(umber)-2.5 E F0(.).73 E F1(Example:)108 372 Q F0 2.861<418c>2.861 G
450 .36(le with the tar record number 1234 \(records start with 0\) may be \
451 found in a tape tar archi)-2.861 F -.15(ve)-.25 G(,).15 E
452 (written with a blocking f)108 384 Q(actor of 20.)-.1 E
453 (It may be found in the tar block with the number)5 E
454 (blk = \(int\) 1234/20 = \(int\) 61.7 = 61)165.5 396 Q
455 (which is also the tape block number)108 408 Q 5(.T)-.55 G
456 (he requested \214le is within this tar block at the record of)-5 E
457 (fset)-.25 E(rec = 1234-\(61*20\) = 14)165.5 420 Q(in 512 byte units.)
458 108 432 Q 1.625(If a current archi)108 448.8 R 1.925 -.15(ve i)-.25 H
459 4.125(sn).15 G 1.625(ot the \214rst archi)-4.125 F 1.925 -.15(ve o)-.25
460 H 4.125(nt).15 G 1.625(he tape, then the number of)-4.125 F F2 1.625
461 (tape bloc)4.125 F(ks)-.2 E F0 1.625(of all pre)4.125 F(vious)-.25 E
462 (archi)108 460.8 Q -.15(ve)-.25 G 3.032(sh).15 G .531
463 (as to be added to the block number computed abo)-3.032 F -.15(ve)-.15 G
464 3.031(,t).15 G 3.031(og)-3.031 G .531(et the)-3.031 F F2(curr)3.031 E
465 .531(ent tape bloc)-.37 F 3.031(kn)-.2 G(umber)-3.031 E F0 5.531(.T).73
466 G(he)-5.531 E .722(number of pre)108 472.8 R .723
467 (vious tape records should be obtained from DDS de)-.25 F .723
468 (vices when the tape is positioned at the)-.25 F(be)108 484.8 Q
469 (ginning of the current archi)-.15 E .3 -.15(ve \()-.25 H(use).15 E F1
470 (mt-dds)2.5 E F0(without ar)2.5 E(guments for e)-.18 E(xample\).)-.15 E
471 F1(Example:)108 501.6 Q F0 .205(Assuming the archi)2.705 F .505 -.15
472 (ve i)-.25 H 2.704(nt).15 G .204(he abo)-2.704 F .504 -.15(ve ex)-.15 H
473 .204(ample to be the second \214le on a tape, and the archi).15 F .504
474 -.15(ve s)-.25 H(tarts).15 E(at tape block 20222.)108 513.6 Q(Then we w\
475 ill \214nd our \214le with tar record number 1234 in the tape block)5 E
476 (tblk = 20222 + \(int\) 1234/20 = 20283)165.5 525.6 Q(on the tape.)108
477 537.6 Q(The record of)5 E
478 (fset inside the tape block will be the same as abo)-.25 E -.15(ve)-.15
479 G(.).15 E/F3 9/Times-Bold@0 SF -1.08(WA)72 578.4 S(RNING)1.08 E F0 .503
480 (This program can only read records \(tar is calling them tape blocks\)\
481  up to 32 kbytes due to the limitations)108 590.4 R(of the Linux de)108
482 602.4 Q(vice dri)-.25 E -.15(ve)-.25 G 3.6 -.55(r. T).15 H(he e).55 E
483 (xtracted archi)-.15 E .3 -.15(ve i)-.25 H 2.5(sw).15 G
484 (ritten to stdout with a block size of 512 bytes.)-2.5 E F3(ENVIR)72
485 631.2 Q(ONMENT)-.27 E F0 .587(The en)108 643.2 R .587(vironment v)-.4 F
486 (ariable)-.25 E F1 -.9(TA)3.087 G(PE).9 E F0 -.15(ove)3.087 G .587
487 (rrides the def).15 F .587(ault tape de)-.1 F .587(vice /de)-.25 F 3.087
488 (v/rmt0. The)-.25 F -.25(va)3.087 G(riable).25 E F1(DDS2T)3.087 E .586
489 (AR cat)-.9 F(be used to gi)108 655.2 Q .2 -.1(ve s)-.1 H
490 (ome options, e.g).1 E 5(.-)-.15 G(-compr)-5 E(ess, -z, -s # , -b #.)
491 -.18 E F3(SEE ALSO)72 684 Q F0(dds2inde)108 696 Q
492 (x\(1\), mt\(1\), mt-dds\(1\), tar\(1\))-.15 E 220.25(2.3 3)299.75 768 R
493 EP
494 %%Page: 4 4
495 %%BeginPageSetup
496 BP
497 %%EndPageSetup
498 /F0 10/Times-Roman@0 SF 371.08(dds2tar\(1L\) dds2tar\(1L\))72 48 R/F1 9
499 /Times-Bold@0 SF(HIST)72 84 Q(OR)-.162 E(Y)-.315 E F0 .025
500 (This program w)108 96 R .025(as created to use the f)-.1 F .025
501 (ast seek operation of my D)-.1 F 2.245 -1.11(AT s)-.4 H(treamer)1.11 E
502 2.525(.T)-.55 G .026(he tapes are called dds \(digi-)-2.525 F .745
503 (tal data storage\).)108 108 R .744
504 (Since the program will write a tar archi)5.745 F 1.044 -.15(ve t)-.25 H
505 3.244(os).15 G .744(tdout, I called this program)-3.244 F/F2 10
506 /Times-Bold@0 SF(dds2tar)3.244 E F0 5.744(.I)C 3.244(fI)-5.744 G .99
507 (created the inde)108 120 R 3.49<788c>-.15 G .99(le, I'm no)-3.49 F 3.49
508 (wa)-.25 G .991(ble to restore a \214le of 1MB within one minute e)-3.49
509 F -.15(ve)-.25 G 3.491(ni).15 G 3.491(ft)-3.491 G .991(he tape contains)
510 -3.491 F(more than 2GB of data.)108 132 Q .374(Thanks to Andreas \(Andr\
511 eas_Bagge@h2.maus.de\), who has written a nice manual page for the o)108
512 156 R -.15(ve)-.15 G(rloaded).15 E -.15(ve)108 168 S .05(rsion 1.1.3 of\
513  the program dds2tar \(I added too much features ... \) His manual page\
514  for dds2tar).15 F .05(-1.1.3 g)-.2 F -2.25 -.2(av e)-.05 H .542
515 (me the idea ho)108 180 R 3.042(wt)-.25 G 3.042(os)-3.042 G .542
516 (plit the program dds2tar into the peaces dds2tar)-3.042 F 3.042(,d)-.4
517 G(ds2inde)-3.042 E 3.042(xa)-.15 G .541(nd mt-dds.)-3.042 F
518 (Additionally)5.541 E(his manual page w)108 192 Q
519 (as the starting point for this page.)-.1 E .107(Since the v)108 216 R
520 .107(ersion 2.2 has a v)-.15 F .107(ery rob)-.15 F .107
521 (ust algorithm to read the inde)-.2 F 2.608<788c>-.15 G .108
522 (le and the ability of pattern matching, a)-2.608 F
523 (lot of options where obsolete and has been deleted. I tried to mak)108
524 228 Q 2.5(ed)-.1 G(ds2tar as simple I can.)-2.5 E F1 -.45(AU)72 256.8 S
525 (THOR).45 E F0(J"or)108 268.8 Q 3.029(gW)-.18 G .529
526 (eule \(weule@cs.uni-duesseldorf.de\), Phone +49 211 751409.)-3.829 F
527 .528(This softw)5.528 F .528(are is a)-.1 F -.25(va)-.2 G .528
528 (ilable at ftp.uni-).25 F(duesseldorf.de:/pub/unix/apollo and sunsite.u\
529 nc.edu:/pub/Linux/system/Backup)108 280.8 Q 220.25(2.3 4)299.75 768 R EP
530 %%Trailer
531 end
532 %%EOF