Ammt: Difference between revisions

From wiki.zmanda.com
Jump to navigation Jump to search
(Note as deprecated.)
(point to autogenerated)
 
Line 1: Line 1:
'''ammt''' is a tool that simulates out-of-band tape operations such as rewind and fast-forward across various Amanda storage drivers. It is ''deprecated''; new device types will not support the ammt interface, because it makes device assumptions that are not necessarily valid. In particular, the ammt model is intrinsically incompatible with parallelism and some read-only devices. For manual restore of devices, including new device types, use [[amrestore]].
See {{man|8|ammt}}.
 
==Name==
 
'''ammt''' — Amanda version of mt
 
==Synopsis==
 
'''ammt''' [-d ] [ -f device ] command [count]
 
==DESCRIPTION==
 
Ammt provides just enough of the standard Unix mt command for the needs of Amanda. This is handy when doing a full restore and the standard mt program has not yet been found.
 
Ammt also provides access to the Amanda output drivers that support various tape simulations.
 
See the [[amanda]](8) man page for more details about Amanda. See the OUTPUT DRIVERS section of [[amanda]](8) for more information on the Amanda output drivers.
 
==OPTIONS==
 
; -d :    Turn on debugging output.
; -f ''device'' :  Access tape device device. If not specified, the TAPE environment variable is used.
; -t ''device'' :    Same as -f.
; ''command'' count :    Which command to issue, and an optional count of operations.
 
==COMMANDS==
 
Each command may be abbreviated to whatever length makes it unique.
 
; eof|weof ''count'' :    Write count (default: 1) end of file marks (tapemarks).
; fsf ''count'' :    Skip forward count (default: 1) files.
; bsf ''count'' :    Skip backward count (default: 1) files.
; asf ''count'' :    Position to file number count (default: 0) where zero is beginning of tape. This is the same as a rewind followed by a fsf count.
; rewind :    Rewind to beginning of tape.
; offline|rewoffl:    Rewind to beginning of tape and unload the tape from the drive.
; status :    Report status information about the drive. Which data reported, and what it means, depends on the underlying operating system, and may include:
 
    ONLINE    Indicates the drive is online and ready.
    OFFLINE    Indicates the drive is offline or not ready.
    BOT        Indicates the drive is at beginning of tape.
    EOT        Indicates the drive is at end of tape.
    PROTECTED  Indicates the tape is write protected.
    ds        Device status.
    er        Error register.
    fileno    Current tape file number.
    blkno      Current tape block number file.
 
'''Note:'''
Many systems only report good data when a tape is in the drive and ready.
 
==EXAMPLES==
 
Create and rewind a virtual tape (a virtual tape stores the data on disk, and is implemented as a directory with a subdir "data" in it):
 
$ mkdir -p /space/vtape/data
$ ammt -f file:/space/vtape  rewind
 
==AUTHOR==
 
Marc Mengel <mengel@fnal.gov>, John R. Jackson <[email protected]>: Original text
 
Stefan G. Weichinger, <[email protected]>, maintainer of the AMANDA-documentation: XML-conversion
 
==SEE ALSO==
 
[[amanda]](8)

Latest revision as of 20:33, 30 June 2008

See ammt(8).