![[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 [Research Unix] / researchv10dc / dist / man / v4 / man1|
Return to tp.1 CVS log | Up to [Research Unix] / researchv10dc / dist / man / v4 / man1 |
1.1 root 1: .th TP I 10/15/73
2: .sh NAME
3: tp \*- manipulate DECtape and magtape
4: .sh SYNOPSIS
5: .bd tp
6: [ key ] [ name ... ]
7: .sh DESCRIPTION
8: .it Tp
9: saves and restores selected portions of the file system
10: hierarchy on DECtape or mag tape.
11: Its actions are controlled by the
12: .it key
13: argument.
14: The key is a string of characters containing
15: at most one function letter and possibly
16: one or more function modifiers.
17: Other arguments to the command are file or directory
18: names specifying which files are to be dumped, restored,
19: or listed.
20: .s3
21: The function portion of
22: the key is specified by one of the following letters:
23: .s3
24: .lp +8 4
25: \fBr\fR The indicated files and directories, together with
26: all subdirectories, are dumped
27: onto the tape.
28: If files with the same names
29: already exist, they are replaced.
30: `Same' is determined by string comparison, so
31: `./abc' can never be the same as `/usr/dmr/abc' even
32: if `/usr/dmr' is the current directory.
33: If no file argument is given, `\fB.\fR' is the default.
34: .s3
35: .lp +8 4
36: \fBu\fR updates the tape.
37: .bd u
38: is the same as
39: .bd r,
40: but a file is replaced only if its
41: modification date is later than the date stored on the tape;
42: that is to say, if it has changed since it was dumped.
43: .bd u
44: is the default command if none is given.
45: .s3
46: .lp +8 4
47: \fBd\fR deletes the named files and directories from
48: the tape. At least one file argument must be given.
49: This function is not permitted on magtapes.
50: .s3
51: .lp +8 4
52: \fBx\fR extracts the named files from the tape to the file system.
53: The owner, mode, and date-modified are restored to what they
54: were when the file was dumped.
55: If no file argument is given, the entire contents of the
56: tape are extracted.
57: .s3
58: .lp +8 4
59: \fBt\fR lists the names of all files stored on the tape which
60: are the same as or are hierarchically below
61: the file arguments. If no file argument is given,
62: the entire contents of the tape is listed.
63: .s3
64: .i0
65: The following characters may be used in addition to the letter
66: which selects the function desired.
67: .s3
68: .lp +10 6
69: \fBm\fR Specifies magtape as opposed to DECtape.
70: .s3
71: .lp +10 6
72: \fB0,...,7\fR This
73: modifier selects the drive on which the tape is mounted.
74: For DECtape, `x' is default; for magtape
75: `0' is the default.
76: .s3
77: .lp +10 6
78: \fBv\fR Normally
79: .it tp
80: does its work silently. The
81: .bd v
82: (verbose)
83: option causes it to type the name of each file it treats
84: preceded by the function letter.
85: With the
86: .bd t
87: function,
88: .bd v
89: gives more information about the
90: tape entries than just the name.
91: .s3
92: .lp +10 6
93: \fBc\fR means a fresh dump is being created; the tape directory
94: will be zeroed before beginning. Usable only with
95: .bd r
96: and
97: .bd u.
98: This option is assumed with magtape since
99: it is impossible to selectively overwrite
100: magtape.
101: .s3
102: .lp +10 6
103: \fBf\fR causes new entries on tape to be `fake' in that
104: no data is present for these entries.
105: Such fake entries cannot be extracted.
106: Usable only with
107: .bd r
108: and
109: .bd u.
110: .s3
111: .lp +10 6
112: \fBi\fR Errors reading and writing the
113: tape are noted, but no action is taken.
114: Normally, errors cause a return to the command level.
115: .s3
116: .lp +10 6
117: \fBw\fR causes
118: .it tp
119: to pause before treating each file, type
120: the indicative letter and the file name (as with v)
121: and await the user's response. Response
122: .bd y
123: means `yes', so the file is treated. Null response
124: means `no', and the file does not take part
125: in whatever is being done. Response
126: .bd x
127: means `exit';
128: the
129: .it tp
130: command terminates immediately. In the
131: .bd x
132: function,
133: files previously asked about
134: have been extracted already.
135: With
136: .bd "r, u,"
137: and
138: .bd d
139: no change has been made to the tape.
140: .s3
141: .i0
142: .sh FILES
143: /dev/tap?
144: .br
145: /dev/mt?
146: .sh DIAGNOSTICS
147: Several; the non-obvious one is
148: `Phase error', which means the file changed after it was selected for
149: dumping but before it was dumped.
150: .sh BUGS
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.