Imported Upstream version 2.5.1p3
[debian/amanda] / man / ammt.8
1 .\"     Title: ammt
2 .\"    Author: 
3 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
4 .\"      Date: 02/07/2007
5 .\"    Manual: 
6 .\"    Source: 
7 .\"
8 .TH "AMMT" "8" "02/07/2007" "" ""
9 .\" disable hyphenation
10 .nh
11 .\" disable justification (adjust text to left margin only)
12 .ad l
13 .SH "NAME"
14 ammt \- Amanda version of mt
15 .SH "SYNOPSIS"
16 .HP 5
17 \fBammt\fR [\-d] [\-f | \-t | \fIdevice\fR] \fIcommand\fR [\fIcount\fR]
18 .SH "DESCRIPTION"
19 .PP
20 \fBAmmt\fR
21 provides just enough of the standard UNIX
22 \fBmt\fR
23 command for the needs of
24 \fIAmanda\fR. This is handy when doing a full restore and the standard
25 \fBmt\fR
26 program has not yet been found.
27 .PP
28 \fBAmmt\fR
29 also provides access to the
30 \fIAmanda\fR
31 output drivers that support various tape simulations.
32 .PP
33 See the
34 \fBamanda\fR(8)
35 man page for more details about
36 \fIAmanda\fR. See the
37 \fBOUTPUT DRIVERS\fR
38 section of
39 \fIamanda(8)\fR
40 for more information on the
41 \fIAmanda\fR
42 output drivers.
43 .SH "OPTIONS"
44 .PP
45 \fB\-d\fR
46 .RS 4
47 Turn on debugging output.
48 .RE
49 .PP
50 \fB\-f\fR\fI device\fR
51 .RS 4
52 Access tape device
53 \fIdevice\fR. If not specified, the
54 \fBTAPE\fR
55 environment variable is used.
56 .RE
57 .PP
58 \fB\-t\fR\fI device\fR
59 .RS 4
60 Same as
61 \fB\-f\fR.
62 .RE
63 .PP
64 \fBcommand\fR\fI count\fR
65 .RS 4
66 Which command to issue, and an optional count of operations.
67 .RE
68 .SH "COMMANDS"
69 .PP
70 Each command may be abbreviated to whatever length makes it unique.
71 .PP
72 \fBeof|weof\fR\fI count\fR
73 .RS 4
74 Write
75 \fIcount\fR
76 (default: 1) end of file marks (tapemarks).
77 .RE
78 .PP
79 \fBfsf\fR\fI count\fR
80 .RS 4
81 Skip forward
82 \fIcount\fR
83 (default: 1) files.
84 .RE
85 .PP
86 \fBbsf\fR\fI count\fR
87 .RS 4
88 Skip backward
89 \fIcount\fR
90 (default: 1) files.
91 .RE
92 .PP
93 \fBasf\fR\fI count\fR
94 .RS 4
95 Position to file number
96 \fIcount\fR
97 (default: 0) where zero is beginning of tape. This is the same as a
98 \fBrewind\fR
99 followed by a
100 \fBfsf\fR
101 \fIcount\fR.
102 .RE
103 .PP
104 \fBrewind\fR
105 .RS 4
106 Rewind to beginning of tape.
107 .RE
108 .PP
109 \fBoffline|rewoffl\fR
110 .RS 4
111 Rewind to beginning of tape and unload the tape from the drive.
112 .RE
113 .PP
114 \fBstatus\fR
115 .RS 4
116 Report status information about the drive. Which data reported, and what it means, depends on the underlying operating system, and may include:
117 .RS 4
118 .PP
119 ONLINE
120 .RS 4
121 Indicates the drive is online and ready.
122 .RE
123 .PP
124 OFFLINE
125 .RS 4
126 Indicates the drive is offline or not ready.
127 .RE
128 .PP
129 BOT
130 .RS 4
131 Indicates the drive is at beginning of tape.
132 .RE
133 .PP
134 EOT
135 .RS 4
136 Indicates the drive is at end of tape.
137 .RE
138 .PP
139 PROTECTED
140 .RS 4
141 Indicates the tape is write protected.
142 .RE
143 .PP
144 ds
145 .RS 4
146 Device status.
147 .RE
148 .PP
149 er
150 .RS 4
151 Error register.
152 .RE
153 .PP
154 fileno
155 .RS 4
156 Current tape file number.
157 .RE
158 .PP
159 blkno
160 .RS 4
161 Current tape block number file.
162 .RE
163 .RE
164 .RE
165 .sp
166 .it 1 an-trap
167 .nr an-no-space-flag 1
168 .nr an-break-flag 1
169 .br
170 \fBNote\fR
171 .PP
172 Many systems only report good data when a tape is in the drive and ready.
173 .SH "AUTHOR"
174 .PP
175 Marc Mengel
176 <mengel@fnal.gov>, John R. Jackson
177 <jrj@purdue.edu>: Original text
178 .PP
179 Stefan G. Weichinger,
180 <sgw@amanda.org>, maintainer of the
181 \fIAmanda\fR\-documentation: XML\-conversion
182 .SH "SEE ALSO"
183 .PP
184 \fBamanda\fR(8)