tplabel(1M)

NAME
     tplabel - Label tape

SYNOPSIS
     tplabel -vsn vvvvvv -[new | old vv...]  [-b   blksize]  [-w]
     [-V] [-erase] eq

     tplabel -vsn vvvvvv -[new | old vv...]  [-b   blksize]  [-w]
     [-V] [-erase] eq:slot

DESCRIPTION
     tplabel labels the tape volume specified by eq:slot.  eq  is
     the  equipment number.  If eq is a library, slot is the slot
     in the library containing the tape cartridge.

     The following sequence of labels is written:

          VOL1
          HDR1
          HDR2
          tapemark
          EOF1
          tapemark
          tapemark

     The labels conform to ANSI  X3.27-1987  File  Structure  and
     Labeling of Magnetic Tapes for Information Interchange.

     -vsn vvvvvv specifies the volume serial name  (VSN)  of  the
     tape  being  labeled.  The VSN must be one to six characters
     in length.  All characters in the VSN must be selected  from
     the  26 upper-case letters, the 10 digits, and the following
     special characters: !"%&'()*+,-./:;<=>?_.

     If the media being labeled was previously labeled,  the  VSN
     must  be specified by -old vv....  The "old" VSN is compared
     with the VSN on the media to assure that the  correct  media
     is being relabeled.

     If the media is not labeled  (i.e.,  blank),  -new  must  be
     specified  to  prevent  the  previous  label comparison from
     being made.

OPTIONS
     -V        Verbose, lists label information written.

     -b blksize
               specifies the blocksize for this tape.  The  value
               must  be one of 16, 32, 64, 128, 256, 512, 1024 or
               2048 and represents the size of the tape block  in
               units  of 1024.  This option overrides the default
               blocksize.

     -erase    Erases the media  completely  before  a  label  is
               written.   This is a security feature that is nor-
               mally not necessary.  Complete media erasure  will
               take  a long time to perform since all data in the
               media is erased.

     -w        Wait for the labeling operation to  complete.   If
               an  error occurs, it will be reported along with a
               completion code of 1.   All  labeling  errors  are
               also  logged.   Note:  Canceling a command that is
               waiting for completion will not cause  the  opera-
               tion itself to be canceled.