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