Scroll to navigation

TAPELIST(5) File formats and conventions TAPELIST(5)


tapelist - The list of Amanda volumes in use


The tapelist file contains the list of tapes in active use. This file is not ordinarily edited or examined manually. Its format may change, or it may be removed altogether, in future versions of Amanda. It contains lines of the form:

YYYYMMDDHHMMSS label flags [BARCODE:barcode] [META:meta] [BLOCKSIZE:blocksize] [POOL:pool] [STORAGE:storage] [CONFIG:config] [#comment]

Where YYYYMMDDHHMMSS is the time the tape was written, label is a label for the tape as written by amlabel and flags is one of "reuse" or "no-reuse" and tells Amanda whether the tape may be reused. A non-reusable tape will not be overwritten, even if it is older than dumpcycle dumps. See the reuse options of amadmin(8).

The optional barcode is prefixed with 'BARCODE' if the volume have a barcode.

The optional meta label is prefixed with 'META' if the volume is on a meta volume.

The optional blocksize is prefixed with 'BLOCKSIZE'.

The optional pool is prefixed with 'POOL', it is the name of the tape-pool.

The optional storage is prefixed with 'STORAGE', it is the name of the storage.

The optional config is prefixed with 'CONFIG', it is name of the config that

is using that volume. This is useful to share the tapelist across multiple config.

The optional comment is prefixed with a '#' and continues to the end of the line.

Amanda will maintain this comment until the tape is overwritten. Note that comments are not allowed on blank lines.

An entry without POOL is in the tape-pool with the name of config running name.

A new labelled volume have a timestamp of "0" and have no STORAGE and CONFIG.

A used volume with timestamp != "0" without STORAGE is in the storage with the name of the running config

A used volume with timestamp != "0" without CONFIG is in the running config.

It is possible to share the same tapelist across multiple config If the POOL, STORAGE and CONFIG are correctly set.

The file is sorted such that the most-recently used tape appears on the first line, and the oldest tape appears on the last line.

Amdump and amflush will by default refuse to write to an unlabeled tape, or to a labeled tape that is considered active or marked "no-reuse". There must be more tapes in active rotation (see the tapecycle option) than there are runs in the backup cycle (see the dumpcycle option) to prevent overwriting a backup image that would be needed to do a full recovery.


amanda(8), amanda.conf(5)

The Amanda Wiki: :


James da Silva <>

Stefan G. Weichinger <>

Dustin J. Mitchell <>

Zmanda, Inc. (
12/01/2017 Amanda 3.5.1