![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to tap.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 / manx|
Return to tap.1 CVS log | Up to [Research Unix] / researchv10dc / dist / man / v4 / manx |
1.1 root 1: .th TAP I 3/15/72
2: .sh NAME
3: tap \*- manipulate DECtape
4: .sh SYNOPSIS
5: .bd tap
6: [ key ] [ name ... ]
7: .sh DESCRIPTION
8: .it tap
9: saves and restores selected portions of the file system
10: hierarchy on DECtape.
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 tabled.
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: \fBc\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 \fRdeletes the named files and directories from
48: the tape. At least one file argument must be given.
49: .s3
50: .lp +8 4
51: \fBx\fR extracts the named files from the tape to the file system.
52: The owner, mode, and date-modified are restored to what they
53: were when the file was dumped.
54: If no file argument is given, the entire contents of the
55: tape are extracted.
56: .s3
57: .lp +8 4
58: \fBt\fR lists the names of all files stored on the tape which
59: are the same as or are hierarchically below
60: the file arguments. If no file argument is given,
61: the entire contents of the tape are tabled.
62: .s3
63: .lp +8 4
64: \fBl\fR is the same as
65: .bd t
66: except that an expanded listing
67: is produced giving all the available information about the
68: listed files.
69: .s3
70: .i0
71: The following characters may be used in addition to the letter
72: which selects the function desired.
73: .s3
74: .lp +10 6
75: \fB0,...,7\fR This
76: modifier selects the drive on which the tape is mounted.
77: `0' is the default.
78: .s3
79: .lp +10 6
80: \fBv\fR Normally
81: .it tap
82: does its work silently. The
83: .bd v
84: (verbose)
85: option causes it to type the name of each file it treats
86: preceded by a letter to indicate what is happening.
87: .s3
88: .lp +13 3
89: \fBr\fR file is being replaced
90: .lp +13 3
91: \fBa\fR file is being added (not there before)
92: .lp +13 3
93: \fBx\fR file is being extracted
94: .lp +13 3
95: \fBd\fR file is being deleted
96: .s3
97: .lp +10 6
98: The
99: .bd v
100: option can be used with
101: .bd "r, u, d,"
102: and
103: .bd x
104: only.
105: .s3
106: .lp +10 6
107: \fBc\fR means a fresh dump is being created; the tape directory
108: will be zeroed before beginning. Usable only with
109: .bd r
110: and
111: .bd u.
112: .s3
113: .lp +10 6
114: \fBf\fR causes new entries on tape to be `fake' in that
115: no data is present for these entries.
116: Such fake entries cannot be extracted.
117: Usable only with
118: .bd r
119: and
120: .bd u.
121: .s3
122: .lp +10 6
123: \fBw\fR causes
124: .it tap
125: to pause before treating each file, type
126: the indicative letter and the file name (as with v)
127: and await the user's response. Response
128: .bd y
129: means `yes', so the file is treated. Null response
130: means `no', and the file does not take part
131: in whatever is being done. Response
132: .bd x
133: means `exit';
134: the
135: .it tap
136: command terminates immediately. In the
137: .bd x
138: function,
139: files previously asked about
140: have been extracted already.
141: With
142: .bd "r, u,"
143: and
144: .bd d
145: no change has been made to the tape.
146: .s3
147: .i0
148: .sh FILES
149: /dev/tap?
150: .sh "SEE ALSO"
151: mt(I)
152: .sh DIAGNOSTICS
153: Several; the non-obvious one is
154: `Phase error', which means the file changed after it was selected for
155: dumping but before it was dumped.
156: .sh BUGS
157: Asks
158: about fake entries on \fBxw\fR, when it should ignore
159: them.
160: If a fake entry is extracted, and the file already
161: exists on disk, the extraction does not take
162: place (as is correct), but the mode and user ID of the file
163: are set to 0.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.