dump2label(1M)             C2 Trusted DG/UX 5.4.2T            dump2label(1M)


NAME
       dump2label - read and write labels for dump tapes

SYNOPSIS
       /usr/sbin/dump2label [-f tape-device] [-l] [-n] [-p file-number]

DESCRIPTION
       dump2label creates and extracts information from dump tape headers.
       This tool is designed to be used by sysadm(1M) and admbackup(1M) to
       track multiple file system dumps on a single tape.

       A dump tape header consists of a list of text strings identifying the
       dumps that are to be placed on a particular tape.

   Options
       -f tape-device
                 Read or write from tape-device.  The default is
                 /dev/rmt/0n.

       -l        List the dump tape header for this tape to the standard
                 output.

       -n        Create a new tape header with labels read from standard
                 input.  Each line of input should be a text string which
                 could later be used to identify the files on the tape.

       -p file-number
                 Position to file file-number on the tape.  The first file
                 after the tape label is considered file 1.

       One of -n, -l, and -p must be specified on the command line.

   Multiple-tape Dumps
       dump2label prints the message "Next tape" and exits with status n
       (where n is the number of files remaining to be skipped) if the
       requested file is not on this tape.  The user should mount the next
       tape, and invoke dump2label again to continue the search.

       For example, suppose we want to position to the third of a series of
       dumps.  The dump2label command line is

          dump2label -f/dev/rmt/0n -p3

       If only the first and second dumps are found on the first tape,
       dump2label will print "Next tape" and exit with status 1 (because one
       more file needs to be skipped).  The user must then mount the next
       tape and invoke dump2label as

          dump2label -f/dev/rmt/0n -p1

       to position to the desired file.

EXIT STATUS
       dump2label will exit with status 0 if it was successful.  If an error



Licensed material--property of copyright holder(s)                         1

dump2label(1M)             C2 Trusted DG/UX 5.4.2T            dump2label(1M)


       occurs, the exit status will be -1.  A positive exit status means
       that dump2label was unable to position to the requested file.  In
       this case, the exit status is the number of files yet to be skipped.

NOTES
       dump2label assumes that if the end-of-tape condition is true, the
       current file must continue on the next tape.  This assumption is
       false if a file ends exactly at end-of-tape.  Though this case is
       unlikely, if it does occur, dump2label returns a value that is one
       greater than it should be.

SEE ALSO
       admbackup(1M), dump(1M), dump2(1M), sysadm(1M).












































Licensed material--property of copyright holder(s)                         2