Imported Upstream version 2.4.4p3
[debian/amanda] / man / ammt.8
1 .\"
2 .de CO
3 \fB\\$1\fP \fI\\$2\fP
4 ..
5 .TH AMMT 8
6 .SH NAME
7 ammt \- Amanda version of mt
8 .SH SYNOPSIS
9 .B ammt
10 [
11 .B -d
12 ]
13 [
14 .B -f|-t
15 .I device
16 ]
17 .B command
18 [
19 .I count
20 ]
21 .SH DESCRIPTION
22 .B Ammt
23 provides just enough of the standard
24 .UX
25 .B mt
26 command for the needs of Amanda.
27 This is handy when doing a full restore and the standard
28 .B mt
29 program has not yet been found.
30 .LP
31 .B Ammt
32 also provides access to the Amanda output drivers that support
33 various tape simulations.
34 .LP
35 See the
36 .IR amanda (8)
37 man page for more details about Amanda.
38 See the
39 .B OUTPUT DRIVERS
40 section of
41 .I amanda(8)
42 for more information on the Amanda output drivers.
43 .SH OPTIONS
44 .TP
45 .B \-d
46 Turn on debugging output.
47 .TP
48 .BI \-f \ device
49 Access tape device
50 .IR device .
51 If not specified, the
52 .B TAPE
53 environment variable is used.
54 .TP
55 .BI \-t \ device
56 Same as
57 .BR -f .
58 .TP
59 .BI command \ count
60 Which command to issue, and an optional count of operations.
61 .SH COMMANDS
62 Each command may be abbreviated to whatever length makes it unique.
63 .TP
64 .BI eof|weof \ count
65 Write
66 .I count
67 (default: 1)
68 end of file marks (tapemarks).
69 .TP
70 .BI fsf \ count
71 Skip forward
72 .I count
73 (default: 1)
74 files.
75 .TP
76 .BI bsf \ count
77 Skip backward
78 .I count
79 (default: 1)
80 files.
81 .TP
82 .BI asf \ count
83 Position to file number
84 .I count
85 (default: 0)
86 where zero is beginning of tape.
87 This is the same as a
88 .B rewind
89 followed by a
90 .B fsf
91 .IR count .
92 .TP
93 .B rewind
94 Rewind to beginning of tape.
95 .TP
96 .B offline|rewoffl
97 Rewind to beginning of tape and unload the tape from the drive.
98 .TP
99 .BI status
100 Report status information about the drive.
101 Which data reported,
102 and what it means,
103 depends on the underlying operating system,
104 and may include:
105 .RS
106 .TP
107 ONLINE
108 Indicates the drive is online and ready.
109 .TP
110 OFFLINE
111 Indicates the drive is offline or not ready.
112 .TP
113 BOT
114 Indicates the drive is at beginning of tape.
115 .TP
116 EOT
117 Indicates the drive is at end of tape.
118 .TP
119 PROTECTED
120 Indicates the tape is write protected.
121 .TP
122 ds
123 Device status.
124 .TP
125 er
126 Error register.
127 .TP
128 fileno
129 Current tape file number.
130 .TP
131 blkno
132 Current tape block number file.
133 .RE
134 .IP
135 NOTE: many systems only report good data when a tape is in the drive and ready.
136 .SH AUTHOR
137 Marc Mengel <mengel@fnal.gov>
138 .br
139 John R. Jackson <jrj@purdue.edu>
140 .SH "SEE ALSO"
141 amanda(8)