Imported Upstream version 2.4.5
[debian/amanda] / man / ammt.8
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "AMMT" 8 "" "" ""
21 .SH NAME
22 ammt \- AMANDA version of mt
23 .SH "SYNOPSIS"
24 .ad l
25 .hy 0
26 .HP 5
27 \fBammt\fR [\-d] [\fB\-f\fR | \fB\-t\fR | \fB\fIdevice\fR\fR] \fIcommand\fR [\fIcount\fR]
28 .ad
29 .hy
30
31 .SH "DESCRIPTION"
32
33 .PP
34 \fBAmmt\fR provides just enough of the standard UNIX \fBmt\fR command for the needs of \fBAMANDA\fR\&. This is handy when doing a full restore and the standard \fBmt\fR program has not yet been found\&.
35
36 .PP
37 \fBAmmt\fR also provides access to the \fBAMANDA\fR output drivers that support various tape simulations\&.
38
39 .PP
40 See the \fBamanda\fR(8) man page for more details about \fBAMANDA\fR\&. See the \fBOUTPUT DRIVERS\fR section of \fBamanda(8)\fR for more information on the \fBAMANDA\fR output drivers\&.
41
42 .SH "OPTIONS"
43
44 .TP
45 \fB\-d\fR
46 Turn on debugging output\&.
47
48 .TP
49 \fB\-f\fR\fI device\fR
50 Access tape device \fBdevice\fR\&. If not specified, the \fBTAPE\fR environment variable is used\&.
51
52 .TP
53 \fB\-t\fR\fI device\fR
54 Same as \fB\-f\fR\&.
55
56 .TP
57 \fBcommand\fR\fB count\fR
58 Which command to issue, and an optional count of operations\&.
59
60 .SH "COMMANDS"
61
62 .PP
63 Each command may be abbreviated to whatever length makes it unique\&.
64
65 .TP
66 \fBeof|weof\fR\fB count\fR
67 Write \fBcount\fR (default: 1) end of file marks (tapemarks)\&.
68
69 .TP
70 \fBfsf\fR\fB count\fR
71 Skip forward \fBcount\fR (default: 1) files\&.
72
73 .TP
74 \fBbsf\fR\fB count\fR
75 Skip backward \fBcount\fR (default: 1) files\&.
76
77 .TP
78 \fBasf\fR\fB count\fR
79 Position to file number \fBcount\fR (default: 0) where zero is beginning of tape\&. This is the same as a \fBrewind\fR followed by a \fBfsf\fR  \fBcount\fR\&.
80
81 .TP
82 \fBrewind\fR
83 Rewind to beginning of tape\&.
84
85 .TP
86 \fBoffline|rewoffl\fR
87 Rewind to beginning of tape and unload the tape from the drive\&.
88
89 .TP
90 \fBstatus\fR
91 Report status information about the drive\&. Which data reported, and what it means, depends on the underlying operating system, and may include:
92
93 .RS
94
95 .TP
96 ONLINE
97 Indicates the drive is online and ready\&.
98
99 .TP
100 OFFLINE
101 Indicates the drive is offline or not ready\&.
102
103 .TP
104 BOT
105 Indicates the drive is at beginning of tape\&.
106
107 .TP
108 EOT
109 Indicates the drive is at end of tape\&.
110
111 .TP
112 PROTECTED
113 Indicates the tape is write protected\&.
114
115 .TP
116 ds
117 Device status\&.
118
119 .TP
120 er
121 Error register\&.
122
123 .TP
124 fileno
125 Current tape file number\&.
126
127 .TP
128 blkno
129 Current tape block number file\&.
130
131 .RE
132 .IP
133
134 .RS
135 .Sh "Note"
136 Many systems only report good data when a tape is in the drive and ready\&.
137
138 .RE
139
140 .PP
141
142
143 .SH "AUTHOR"
144
145 .PP
146 Marc Mengel <mengel@fnal\&.gov>, John R\&. Jackson <jrj@purdue\&.edu>: Original text
147
148 .PP
149 Stefan G\&. Weichinger, <sgw@amanda\&.org>, maintainer of the \fBAMANDA\fR\-documentation: XML\-conversion
150
151 .SH "SEE ALSO"
152
153 .PP
154 \fBamanda\fR(8)
155