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