dump2label(1M)             DG/UX 4.30              dump2label(1M)



     NAME
          dump2label - read and write labels for dump tapes

     SYNOPSIS
          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) 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




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

     dump2label(1M)             DG/UX 4.30              dump2label(1M)



             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 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
          dump2(1M), sysadm(1M).



































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