X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famtape.8.xml;h=c46679071819b48e79b86ddcdfeb4309d885ecd4;hb=fd48f3e498442f0cbff5f3606c7c403d0566150e;hp=db4d20cf0347cdbe6777c28568f9da7bf35524fd;hpb=96f35b20267e8b1a1c846d476f27fcd330e0b018;p=debian%2Famanda
diff --git a/man/xml-source/amtape.8.xml b/man/xml-source/amtape.8.xml
index db4d20c..c466790 100644
--- a/man/xml-source/amtape.8.xml
+++ b/man/xml-source/amtape.8.xml
@@ -3,7 +3,7 @@
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
-
+
%global_entities;
]>
@@ -19,9 +19,10 @@
amtape
-user interface to &A; tape changer controls
+Control Amanda changers
+&author.dustin;
&author.jds;
&author.sgw.xml;
@@ -30,185 +31,139 @@
amtapeconfig
- command
- command_options
- configoption
+ subcommand
+ subcommand_options
+ &configoverride.synopsis;
-
DESCRIPTION
-Amtape
-performs tape changer control operations.
-It uses the underlying tape changer script defined by the
-tpchanger
-option for a particular &A;
-configuration as specified by the
-config
-argument.
-
-Tape changers maintain a notion of the
-current
-and
-next
-slot for each configuration.
-These may or may not correspond to an actual physical state of the device,
-but do tend to minimize searching through the tape storage slots.
-If the desired tape is in the current slot,
-it is likely the next tape needed is in the next slot
-rather than at some random position in the storage slots.
-
-See the
-amanda8
-man page for more details about &A;.
+
+Amtape is the command-line interface
+to Amanda's tape changers () and to
+the taperscan algorithm ().
+
+
+Tape changers maintain a notion of the current 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.
+
+Amtape uses the default changer. To use a different changer, use the
+config override option, e.g.,
+-otpchanger=otherchanger.
+
-COMMANDS
+SUBCOMMANDS
-
- reset
-
-Reset the tape changer to a known state.
-The
-current
-slot is set to the
-first
-slot.
-Other device-specific side effects may occur.
-Some gravity stackers need to be reset to the top position by hand.
-This command notifies &A; the stacker is back in that position.
-
-
-
- eject
-
-If a tape is loaded in the drive, it is ejected and returned to the
-slot from which it was loaded.
-
-
-
- clean
-
-If a cleaning tape is defined for the changer,
-it is used to clean the drive.
-
-
-
- show
-
-Show the contents of all slots.
-This can be slow.
-
-
-
- labellabel
-
-Search for and load the &A; tape with label
-label.
-
-
-
- taper
-
-Perform the
-taper
-scan algorithm.
-Load the next tape in the configuration's tape sequence,
-or a fresh tape with a suitable label.
-
-
-
- device
-
-Display the name of the current tape device on
-stdout.
-
-
-
- current
-
-Display the current slot.
-
-
-
- update
-
-Update the changer label database, if it has one,
-to match the tapes now available.
-
-
-
- slotslot
-
-Eject any tape in the drive and put it away,
-then load the tape from slot
-slot
-and reset
-current.
-
-
-
- slot current
-
-Eject any tape in the drive and put it away,
-then load the tape from the current slot.
-
-
-
- slot next
-
-Eject any tape in the drive and put it away,
-then load the tape from the next slot and reset
-current.
-
-
-
- slot first
-
-Eject any tape in the drive and put it away,
-then load the tape from the first slot and reset
-current.
-
-
-
- slot advance
-
-Synonym for slot next.
-
-
-
-
- -oconfigoption
-
-See the "CONFIGURATION OVERRIDE"
- section in amanda8.
-
-
-
+
+labellabel
+
-This is useful with non-gravity stackers to unload the last tape used
-and set up &A; for the next run.
-If you just use
-eject,
-the current tape will be mounted again in the next run,
-where it will be rejected as being still in use,
-ejected and the next tape requested.
-Using
-slot next
-followed by
-eject
-does an unnecessary mount.
-
-Note: most changers optimize the
-slot
-commands to not eject the loaded tape if it is the one being requested.
-
+Search for and load the Amanda tape with label label, also
+setting the current slot.
-SEE ALSO
-amanda8,
-
+
+
+
+slotslot
+
+
+Load the volume in the given slot, also setting the current slot. The
+slot names current, next,
+first, and last have special meaning.
+
+
+
+
+current
+
+
+Shorthand for slotcurrent.
+
+
+
+
+inventory
+
+
+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.
+
+
+
+
+show
+
+
+Show the contents of all slots by loading each slot and reading its
+label. This can be very slow.
+
+
+
+
+reset
+
+
+Reset the changer to a known state. This subcommand is intended to clear
+any unknown and potentially incorrect state the changer may have stored.
+
+
+
+
+ejectdrive
+
+
+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.
+
+
+
+
+cleandrive
+
+
+If a cleaning tape is defined for the changer, used it to clean the
+specified drive. The drive is optional if the changer only has one
+drive.
+
+
+
+
+taper
+
+
+Run the taperscan algorithm (see ), displaying information about the progress of the scan.
+
+
+
+
+updatewhat
+
+
+Update changer state. Consult
+for changer-specific details on the format of what.
+
+
+
+
+ &configoverride.varlistentry;
+
+
+
+
+
+
+
+
+