Debian Codegraph @

upstream/debian-unstable/man1/mt-gnu.1

raw
1 .\" This file is part of GNU cpio. -*- nroff -*-
2 .\" Copyright 2014-2024 Free Software Foundation, Inc.
3 .\"
4 .\" GNU cpio is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 3 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" GNU cpio is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 .\" GNU General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with GNU cpio. If not, see <http://www.gnu.org/licenses/>.
16 .TH MT 1 "January 28, 2014" "MT" "GNU CPIO"
17 .SH NAME
18 mt \- control magnetic tape drive operation
19 .SH SYNOPSIS
20 .B mt
21 [\fB\-V\fR] [\fB\-f\fR \fIdevice\fR] [\fB\-\-file=\fIdevice\fR] [\fB\-\-rsh-command=\fIcommand\fR] [\fB\-\-version\fR]
22 \fIoperation\fR [\fIcount\fR]
23 .SH DESCRIPTION
24 This manual page
25 documents the GNU version of
26 .BR mt .
27 .B mt
28 performs the given
29 .IR operation ,
30 which must be one of the tape operations listed below, on a tape
31 drive.
32 .PP
33 The default tape device to operate on is taken from the file
34 .B /usr/include/sys/mtio.h
35 when
36 .B mt
37 is compiled. It can be overridden by giving a device file name in
38 the environment variable
39 .BR TAPE
40 or by a command line option (see below), which also overrides the
41 environment variable.
42 .PP
43 The device must be either a character special file or a
44 remote tape drive. To use a tape drive on another machine as the
45 archive, use a filename that starts with `HOSTNAME:'. The
46 hostname can be preceded by a username and an `@' to access the remote
47 tape drive as that user, if you have permission to do so (typically an
48 entry in that user's `~/.rhosts' file).
49 .PP
50 The available operations are listed below. Unique abbreviations are
51 accepted. Not all operations are available on all systems, or work on
52 all types of tape drives.
53 Some operations optionally take a repeat count, which can be given
54 after the operation name and defaults to 1.
55 .TP
56 .BR eof ", " weof
57 Write
58 .I count
59 EOF marks at current position.
60 .TP
61 .B fsf
62 Forward space
63 .I count
64 files.
65 The tape is positioned on the first block of the next file.
66 .TP
67 .B bsf
68 Backward space
69 .I count
70 files.
71 The tape is positioned on the first block of the next file.
72 .TP
73 .B fsr
74 Forward space
75 .I count
76 records.
77 .TP
78 .B bsr
79 Backward space
80 .I count
81 records.
82 .TP
83 .B bsfm
84 Backward space
85 .I count
86 file marks.
87 The tape is positioned on the beginning-of-the-tape side of
88 the file mark.
89 .TP
90 .B fsfm
91 Forward space
92 .I count
93 file marks.
94 The tape is positioned on the beginning-of-the-tape side of
95 the file mark.
96 .TP
97 .B asf
98 Absolute space to file number
99 .IR count .
100 Equivalent to rewind followed by fsf
101 .IR count .
102 .TP
103 .B seek
104 Seek to block number
105 .IR count .
106 .TP
107 .B eom
108 Space to the end of the recorded media on the tape
109 (for appending files onto tapes).
110 .TP
111 .B rewind
112 Rewind the tape.
113 .TP
114 .BR offline ", " rewoffl
115 Rewind the tape and, if applicable, unload the tape.
116 .TP
117 .B status
118 Print status information about the tape unit.
119 .TP
120 .B retension
121 Rewind the tape, then wind it to the end of the reel,
122 then rewind it again.
123 .TP
124 .B erase
125 Perform long erase of tape. If
126 .I count
127 is 0, perform short erase of tape (some devices do not support this).
128 .PP
129 .B mt
130 exits with a status of 0 if the operation succeeded, 1 if the
131 operation or device name given was invalid, or 2 if the operation
132 failed.
133 .SS OPTIONS
134 .TP
135 \fB\-f\fR, \fB\-\-file=\fIdevice\fR
136 Use
137 .I device
138 as the file name of the tape drive to operate on.
139 To use a
140 tape drive on another machine, use a filename that
141 starts with `HOSTNAME:'. The hostname can be preceded by a
142 username and an `@' to access the remote tape drive as that user, if
143 you have permission to do so (typically an entry in that user's
144 `~/.rhosts' file).
145 .TP
146 \fB\-\-rsh-command=\fIcommand\fR
147 Notifies
148 .B mt
149 that it should use
150 .I command
151 to communicate with remote devices instead of
152 .B /usr/bin/ssh
153 or
154 .BR /usr/bin/rsh .
155 .TP
156 \fB\-V\fR, \fB\-\-version\fR
157 Print the version number of
158 .BR mt .
159 .SH "BUG REPORTS"
160 Report bugs to <bug\[email protected]>.
161 .SH COPYRIGHT
162 Copyright \(co 2014 Free Software Foundation, Inc.
163 .br
164 .na
165 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
166 .br
167 .ad
168 This is free software: you are free to change and redistribute it.
169 There is NO WARRANTY, to the extent permitted by law.
170 .\" Local variables:
171 .\" eval: (add-hook 'write-file-hooks 'time-stamp)
172 .\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
173 .\" time-stamp-format: "%:B %:d, %:y"
174 .\" time-stamp-end: "\""
175 .\" time-stamp-line-limit: 20
176 .\" end:
177