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 @@ amtape config - 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. - - - - label label - -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. - - - - slot slot - -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. - - - - - -o configoption - -See the "CONFIGURATION OVERRIDE" - section in amanda8. - - - + +label label + -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, - + + + +slot slot + + +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 slot current. + + + + +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. + + + + +eject drive + + +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. + + + + +clean drive + + +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. + + + + +update what + + +Update changer state. Consult +for changer-specific details on the format of what. + + + + + &configoverride.varlistentry; + + + + + + + + +