3 .\" Author: Dustin J. Mitchell <dustin@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.1.0
10 .TH "AMTAPE" "8" "06/01/2010" "Amanda 3\&.1\&.0" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 amtape \- Control Amanda changers
24 .HP \w'\fBamtape\fR\ 'u
25 \fBamtape\fR \fIconfig\fR \fIsubcommand\fR [\fIsubcommand_options\fR...] [{\fB\-o\fR\ \fIconfigoption\fR}...]
29 is the command\-line interface to Amanda\'s tape changers (\fBamanda-changers\fR(7)) and to the taperscan algorithm (\fBamanda-taperscan\fR(7))\&.
31 Tape changers maintain a notion of the
33 slot for each configuration\&. This may or may not correspond to an actual physical state of the device, but is used by some taperscan algorithms to minimize searching through the slots\&.
35 Amtape uses the default changer\&. To use a different changer, use the config override option, e\&.g\&.,
36 \fB\-otpchanger=otherchanger\fR\&.
39 \fBlabel\fR \fIlabel\fR
41 Search for and load the Amanda tape with label
42 [label], also setting the current slot\&.
47 Load the volume in the given slot, also setting the current slot\&. The slot names
52 have special meaning\&.
64 Show the contents of all slots, based on the changer\'s cached metadata\&. This is a quick operation as it does not load or unload any volumes, but is not supported by all changers\&.
69 Show the contents of all slots by loading each slot and reading its label\&. This can be very slow\&.
74 Reset the changer to a known state\&. This subcommand is intended to clear any unknown and potentially incorrect state the changer may have stored\&.
77 \fBeject\fR [\fIdrive\fR]
79 Eject the tape currently in the drive\&. This only applies to some changers\&. Specify a drive (by drive number) if more than one drive is available\&.
82 \fBclean\fR [\fIdrive\fR]
84 If a cleaning tape is defined for the changer, used it to clean the specified drive\&. The
86 is optional if the changer only has one drive\&.
91 Run the taperscan algorithm (see
92 \fBamanda-taperscan\fR(7)), displaying information about the progress of the scan\&.
97 Update changer state\&. Consult
98 \fBamanda-changers\fR(7)
99 for changer\-specific details on the format of
103 \fB\-o \fR\fB\fIconfigoption\fR\fR
105 See the "CONFIGURATION OVERRIDE" section in
111 \fBamanda-changers\fR(7),
112 \fBamanda-taperscan\fR(7),
113 \fBamanda-devices\fR(7)
116 : http://wiki.zmanda.com/
119 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
121 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
124 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
126 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>