Ammt

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.

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 <[email protected]>, John R. Jackson <[email protected]>: Original text

Stefan G. Weichinger, <[email protected]>, maintainer of the AMANDA-documentation: XML-conversion

SEE ALSO

amanda(8)