3 .\" Author: Dustin J. Mitchell <dustin@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.3
10 .TH "AMTAPE" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amtape \- Control Amanda changers
33 .HP \w'\fBamtape\fR\ 'u
34 \fBamtape\fR [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR \fIsubcommand\fR [\fIsubcommand_options\fR...]
38 is the command\-line interface to Amanda\*(Aqs tape changers (\fBamanda-changers\fR(7)) and to the taperscan algorithm (\fBamanda-taperscan\fR(7))\&.
40 Tape changers maintain a notion of the
42 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\&.
44 Amtape uses the default changer\&. To use a different changer, use the config override option, e\&.g\&.,
45 \fB\-otpchanger=otherchanger\fR\&.
48 \fBlabel\fR \fIlabel\fR
50 Search for and load the Amanda tape with label
51 [label], also setting the current slot\&.
56 Load the volume in the given slot, also setting the current slot\&. The slot names
61 have special meaning\&.
73 Show the contents of all slots, based on the changer\*(Aqs cached metadata\&. This is a quick operation as it does not load or unload any volumes, but is not supported by all changers\&.
78 Show the contents of all slots (or listed slots) by loading each slot and reading its label\&. This can be very slow\&. The slots arguments is of the form 1,3\-5,7\&.
83 Reset the changer to a known state\&. This subcommand is intended to clear any unknown and potentially incorrect state the changer may have stored\&.
86 \fBeject\fR [\fIdrive\fR]
88 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\&.
91 \fBclean\fR [\fIdrive\fR]
93 If a cleaning tape is defined for the changer, used it to clean the specified drive\&. The
95 is optional if the changer only has one drive\&.
100 Run the taperscan algorithm (see
101 \fBamanda-taperscan\fR(7)), displaying information about the progress of the scan\&.
106 Update changer state\&. Consult
107 \fBamanda-changers\fR(7)
108 for changer\-specific details on the format of
112 \fB\-o \fR\fB\fIconfigoption\fR\fR
114 See the "CONFIGURATION OVERRIDE" section in
120 \fBamanda-changers\fR(7),
121 \fBamanda-taperscan\fR(7),
122 \fBamanda-devices\fR(7)
125 : http://wiki.zmanda.com/
128 \fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
130 Zmanda, Inc\&. (http://www\&.zmanda\&.com)
133 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
135 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>