amlabel - label an Amanda tape

SYNOPSIS

       amlabel [-f] config label [ slot slot ]

DESCRIPTION

       Amlabel  writes  an Amanda label on the tape in the device
       specified     by     the     amanda.conf      file      in
       /usr/amanda/etc/amanda/config.   Label  may  be any string
       that does not contain  whitespace  and  that  matches  the
       amanda.conf  labelstr regular expression option.  It is up
       to the system administrator to define a naming convention.

       Amlabel  will  not write the label if the tape contains an
       active amanda tape or if the  label  specified  is  on  an
       active  tape.  The  -f (force) flag bypass these verifica-
       tion.

       An optional slot may be specified after  the  tape  label.
       If  a  tape changer is in use, amlabel will label the tape
       in the specified slot  instead  of  the  currently  loaded
       tape.

       See  the amanda(8) man page for more details about Amanda.

EXAMPLE

       Write an Amanda label with the string "VOL1" on  the  tape
       loaded  in  the  device  named  in  the  tapedev option in
       /usr/amanda/etc/amanda/DailySet1/amanda.conf:

              % amlabel DailySet1 VOL1

       Label the tape in slot 3 of the currently configured  tape
       changer with the string "VOL2":

              % amlabel DailySet1 VOL2 slot 3

AUTHOR

       James da Silva <jds@cs.umd.edu>
       University of Maryland, College Park

SEE ALSO

       amanda(8)