Penguin
Recent Changes
Annotated edit history of mt-gnu(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 MT
2 !!!MT
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 ----
7 !!NAME
8
9
10 mt - control magnetic tape drive operation
11 !!SYNOPSIS
12
13
14 __mt__ [[-V] [[-f device] [[--file=device]
15 [[--rsh-command=command] [[--version] operation
16 [[count]
17 !!DESCRIPTION
18
19
20 This manual page documents the GNU version of __mt__.
21 __mt__ performs the given ''operation'', which must be
22 one of the tape operations listed below, on a tape
23 drive.
24
25
26 The default tape device to operate on is taken from the file
27 ''/usr/include/sys/mtio.h'' when __mt__ is compiled.
28 It can be overridden by giving a device file name in the
29 environment variable __TAPE__ or by a command line option
30 (see below), which also overrides the environment
31 variable.
32
33
34 The device must be either a character special file or a
35 remote tape drive. To use a tape drive on another machine as
36 the archive, use a filename that starts with `HOSTNAME:'.
37 The hostname can be preceded by a username and an `@' to
38 access the remote tape drive as that user, if you have
39 permission to do so (typically an entry in that user's
40 `~/.rhosts' file).
41
42
43 The available operations are listed below. Unique
44 abbreviations are accepted. Not all operations are available
45 on all systems, or work on all types of tape drives. Some
46 operations optionally take a repeat count, which can be
47 given after the operation name and defaults to
48 1.
49
50
51 eof, weof
52
53
54 Write ''count'' EOF marks at current
55 position.
56
57
58 fsf
59
60
61 Forward space ''count'' files. The tape is positioned on
62 the first block of the next file.
63
64
65 bsf
66
67
68 Backward space ''count'' files. The tape is positioned on
69 the first block of the next file.
70
71
72 fsr
73
74
75 Forward space ''count'' records.
76
77
78 bsr
79
80
81 Backward space ''count'' records.
82
83
84 bsfm
85
86
87 Backward space ''count'' file marks. The tape is
88 positioned on the beginning-of-the-tape side of the file
89 mark.
90
91
92 fsfm
93
94
95 Forward space ''count'' file marks. The tape is
96 positioned on the beginning-of-the-tape side of the file
97 mark.
98
99
100 asf
101
102
103 Absolute space to file number ''count''. Equivalent to
104 rewind followed by fsf ''count''.
105
106
107 eom
108
109
110 Space to the end of the recorded media on the tape (for
111 appending files onto tapes).
112
113
114 rewind
115
116
117 Rewind the tape.
118
119
120 offline, rewoffl
121
122
123 Rewind the tape and, if applicable, unload the
124 tape.
125
126
127 status
128
129
130 Print status information about the tape unit.
131
132
133 retension
134
135
136 Rewind the tape, then wind it to the end of the reel, then
137 rewind it again.
138
139
140 erase
141
142
143 Erase the tape.
144
145
146 fss
147
148
149 (SCSI tapes) Forward space ''count''
150 setmarks.
151
152
153 bss
154
155
156 (SCSI tapes) Backward space ''count''
157 setmarks.
158
159
160 wset
161
162
163 (SCSI tapes) Write ''count'' setmarks at current position
164 (only SCSI tape).
165
166
167 eod, seod
168
169
170 Space to end of valid data. Used on streamer tape drives to
171 append data to the logical and of tape.
172
173
174 setblk
175
176
177 (SCSI tapes) Set the block size of the drive to ''count''
178 bytes per record.
179
180
181 setdensity
182
183
184 (SCSI tapes) Set the tape density code to ''count.'' The
185 proper codes to use with each drive should be looked up from
186 the drive documentation.
187
188
189 drvbuffer
190
191
192 (SCSI tapes) Set the tape drive buffer code to
193 ''number.'' The proper value for unbuffered operation is
194 zero and
195 ''
196
197
198 stoptions
199
200
201 (SCSI tapes) Set the driver options bits to ''count'' for
202 the device. The bits can be set by oring the following
203 values: 1 to enable write buffering, 2 to enable
204 asynchronous writes, 4 to enable read ahead, 8 to enable
205 debugging output (if it has been compiled to the
206 driver).
207
208
209 stwrthreshold
210
211
212 (SCSI tapes) The write threshold for the tape device is set
213 to ''count'' kilobytes. The value must be smaller than or
214 equal to the driver buffer size.
215
216
217 seek
218
219
220 (SCSI tapes) Seek to the ''count'' block on the tape.
221 This operation is available on some Tandberg and Wangtek
222 streamers and some SCSI-2 tape drives.
223
224
225 tell
226
227
228 (SCSI tapes) Tell the current block on tape. This operation
229 is available on some Tandberg and Wangtek streamers and some
230 SCSI-2 tape drives.
231
232
233 densities
234
235
236 (SCSI tapes) Write explanation of some common density codes
237 to standard output.
238
239
240 datcompression
241
242
243 (some SCSI-2 DAT tapes) Inquire or set the compression
244 status (on/off). If the ''count'' is one the compression
245 status is printed. If the ''count'' is zero, compression
246 is disabled. Otherwise, compression is enabled. The command
247 uses the SCSI ioctl to read and write the Data Compression
248 Characteristics mode page (15). ONLY ROOT CAN USE THIS
249 COMMAND.
250
251
252 __mt__ exits with a status of 0 if the operation
253 succeeded, 1 if the operation or device name given was
254 invalid, or 2 if the operation failed.
255
256
257 __OPTIONS__
258
259
260 ''-f, --file=device''
261
262
263 Use ''device'' as the file name of the tape drive to
264 operate on. To use a tape drive on another machine, use a
265 filename that starts with `HOSTNAME:'. The hostname can be
266 preceded by a username and an `@' to access the remote tape
267 drive as that user, if you have permission to do so
268 (typically an entry in that user's `~/.rhosts'
269 file).
270
271
272 ''--rsh-command=command''
273
274
275 Notifies __mt__ that it should use ''command'' to
276 communicate with remote devices instead of
277 ''/usr/bin/ssh'', ''/usr/bin/rsh'', or the command
278 specified by the environment variable
279 __MT_RSH__.
280
281
282 ''-V, --version''
283
284
285 Print the version number of __mt__.
286 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.