![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to tp.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / manb|
Return to tp.8 CVS log | Up to [Research Unix] / researchv10dc / man / manb |
1.1 root 1: .TH TP 8
2: .SH NAME
3: tp \- manipulate tape archive
4: .SH SYNOPSIS
5: .B tp
6: [ key ] [ name ... ]
7: .SH DESCRIPTION
8: .PP
9: .I Tp
10: saves and restores files
11: on DECtape or magtape.
12: Its actions are controlled by the
13: .I key
14: argument.
15: The key is a string of characters containing
16: at most one function letter and possibly
17: one or more function modifiers.
18: Other arguments to the command are file or directory
19: names specifying which files are to be dumped, restored,
20: or listed.
21: In all cases, appearance of a directory name refers to
22: the files and (recursively) subdirectories of that directory.
23: .PP
24: The function portion of
25: the key is specified by one of the following letters:
26: .TP 8
27: .B r
28: The named files
29: are written
30: on the tape.
31: If files with the same names
32: already exist, they are replaced.
33: `Same' is determined by string comparison, so
34: `./abc' can never be the same as `/usr/dmr/abc' even
35: if `/usr/dmr' is the current directory.
36: If no file argument is given, `\fB.\fR' is the default.
37: .TP 8
38: .B u
39: updates the tape.
40: .B u
41: is like
42: .B r,
43: but a file is replaced only if its
44: modification date is later than the date stored on the tape;
45: that is to say, if it has changed since it was dumped.
46: .B u
47: is the default command if none is given.
48: .TP 8
49: .B d
50: deletes the named files from
51: the tape.
52: At least one name argument must be given.
53: This function is not permitted on magtapes.
54: .TP 8
55: .B x
56: extracts the named files from the tape to the file system.
57: The owner and mode are restored.
58: If no file argument is given, the entire contents of the
59: tape are extracted.
60: .TP 8
61: .B t
62: lists the names of the specified files.
63: If no file argument is given,
64: the entire contents of the tape is listed.
65: .PP
66: The following characters may be used in addition to the letter
67: which selects the function desired.
68: .TP 10
69: .B m
70: Specifies magtape as opposed to DECtape.
71: .TP 10
72: .B 0,...,7
73: This
74: modifier selects the drive on which the tape is mounted.
75: For DECtape,
76: .B x
77: is default; for magtape
78: `0' is the default.
79: .TP 10
80: .B v
81: Normally
82: .I tp
83: does its work silently.
84: The
85: .B v
86: (verbose)
87: option causes it to type the name of each file it treats
88: preceded by the function letter.
89: With the
90: .B t
91: function,
92: .B v
93: gives more information about the
94: tape entries than just the name.
95: .TP 10
96: .B c
97: means a fresh dump is being created; the tape directory
98: is cleared before beginning.
99: Usable only with
100: .B r
101: and
102: .B u.
103: This option is assumed with magtape since
104: it is impossible to selectively overwrite
105: magtape.
106: .TP 10
107: .B i
108: Errors reading and writing the
109: tape are noted, but no action is taken.
110: Normally, errors cause a return to the command level.
111: .TP 10
112: .B f
113: Use the first named file, rather than a tape,
114: as the archive.
115: This option currently acts like
116: .BR m ;
117: .I i.e.
118: .BR r
119: implies
120: .BR c ,
121: and neither
122: .BR d
123: nor
124: .BR u
125: are permitted.
126: .TP 10
127: .B w
128: causes
129: .I tp
130: to pause before treating each file, type
131: the indicative letter and the file name (as with
132: .BR v )
133: and await the user's response.
134: Response
135: .B y
136: means `yes', so the file is treated.
137: Null response
138: means `no', and the file does not take part
139: in whatever is being done.
140: Response
141: .B x
142: means `exit';
143: the
144: .I tp
145: command terminates immediately.
146: In the
147: .B x
148: function,
149: files previously asked about
150: have been extracted already.
151: With
152: .B "r, u,"
153: and
154: .B d
155: no change has been made to the tape.
156: .PP
157: .SH FILES
158: /dev/tap?
159: .br
160: /dev/rmt?
161: .SH SEE ALSO
162: ar(1), tar(1)
163: .SH DIAGNOSTICS
164: Several; the non-obvious one is
165: `Phase error', which means the file changed after it was selected for
166: dumping but before it was dumped.
167: .SH BUGS
168: A single file with several links to it is treated like several files.
169: .PP
170: Binary-coded control information makes
171: magnetic tapes written by
172: .I tp
173: difficult to carry to other machines;
174: .IR tar (1)
175: avoids the problem.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.