![[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 / v3 / man1|
Return to tap.1 CVS log | Up to [Research Unix] / researchv10dc / dist / man / v3 / man1 |
1.1 root 1: .pa 1
2: .he 'TAP (I)'3/15/72'TAP (I)'
3: .ti 0
4: NAME tap -- manipulate DECtape
5: .sp
6: .ti 0
7: SYNOPSIS tap___ [ key ] [ name ... ]
8: .sp
9: .ti 0
10: DESCRIPTION tap___
11: saves and restores selected portions of the file system
12: hierarchy on DECtape.
13: Its actions are controlled by the key___ 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:
21: The function portion of
22: the key is specified by one of the following letters:
23:
24: .in +6
25: .ti -3
26: r The indicated files and directories, together with
27: all subdirectories, are dumped
28: onto the tape.
29: If files with the same names
30: already exist, they are replaced (hence the "r").
31: "Same" is determined by string comparison, so
32: "./abc" can never be the same as "/usr/dmr/abc" even
33: if "/usr/dmr" is the current directory.
34: If no file argument is given, "." is the default.
35:
36: .ti -3
37: u updates the tape.
38: u_ is the same as r_, but a file is replaced only if its
39: modification date is later than the date stored on the tape;
40: that is to say, if it has changed since it was dumped.
41: u_ is the default command if none is given.
42:
43: .ti -3
44: d deletes the named files and directories from
45: the tape. At least one file argument must be given.
46:
47: .ti -3
48: x extracts the named files from the tape to the file system.
49: The owner, mode, and date-modified are restored to what they
50: were when the file was dumped.
51: If no file argument is given, the entire contents of the
52: tape are extracted.
53:
54: .ti -3
55: t lists the names of all files stored on the tape which
56: are the same as or are hierarchically below
57: the file arguments. If no file argument is given,
58: the entire contents of the tape are tabled.
59:
60: .ti -3
61: l is the same as t_ except that an expanded listing
62: is produced giving all the available information about the
63: listed files.
64:
65: .in -6
66: The following characters may be used in addition to the letter
67: which selects the function desired.
68:
69: .in +6
70: .ti -3
71: 0, ..., 7 This modifier selects the drive on which the tape is mounted.
72: "0" is the default.
73:
74: .ti -3
75: v Normally tap___ does its work silently. The v_ (verbose)
76: option causes it to type the name of each file it treats
77: preceded by a letter to indicate what is happening.
78:
79: .in +2
80: r file is being replaced
81: .nf
82: a file is being added (not there before)
83: .fi
84: x file is being extracted
85: d file is being deleted
86:
87: .in -2
88: The v_ option can be used with r_, u_, d_, and x_ only.
89:
90: .ti -3
91: c means a fresh dump is being created; the tape directory
92: will be zeroed before beginning. Usable only with r_ and u_.
93:
94: .ti -3
95: f causes
96: new entries copied on tape to be 'fake' in that
97: no data is present for these entries.
98: Such fake entries cannot be extracted.
99: Usable only with r_ and u_.
100:
101: .ti -3
102: w causes tap___ to pause before treating each file, type
103: the indicative letter and the file name (as with v_)
104: and await the user's response. Response
105: "y" means "yes", so the file is treated. Null response
106: means "no", and the file does not take part
107: in whatever is being done. Response "x" means "exit";
108: the tap___ command terminates immediately. In the x_ function,
109: files previously asked about
110: have been extracted already.
111: With r_, u_, and d_ no change has been made to the tape.
112:
113: .ti -3
114: m make (create) directories during an x_ if necessary.
115: .in -6
116: .sp
117: .ti 0
118: FILES /dev/tap?
119: .sp
120: .ti 0
121: SEE ALSO mt(I)
122: .sp
123: .ti 0
124: DIAGNOSTICS Tape open error
125: .br
126: Tape read error
127: .br
128: Tape write error
129: .br
130: Directory checksum
131: .br
132: Directory overflow
133: .br
134: Tape overflow
135: .br
136: Phase error (a file has changed after it was selected for
137: dumping but before it was dumped)
138: .br
139: .sp
140: .ti 0
141: BUGS Asks
142: about "fake" entries on "xw", when it should ignore
143: them.
144: If a fake entry is extracted, and the file already
145: exists on disk, the extraction does not take
146: place (as is correct), but the mode and user ID of the file
147: are set to 0.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.