volcopy(1M)                  DG/UX 5.4 Rel. 2.01                 volcopy(1M)


NAME
       volcopy, labelit - copy file systems with label checking

SYNOPSIS
       /usr/sbin/volcopy [options] fsname special1 volname1 special2
       volname2

       /usr/sbin/labelit special [ fsname volume [ -n ] ]

DESCRIPTION
       Volcopy makes a literal copy of the file system using a blocksize
       matched to the device.

       Options are:

       -a     Invoke a verification sequence requiring a positive operator
              response instead of the standard 10-second delay before the
              copy is made.

       -s     (Default) invoke the DEL if wrong verification sequence.

       Options used with tapes only are:

       -bpi         Bits per inch ( 800 or 1600 )

       -feet        Size of reel in feet ( 1200 or 2400 )

       -reel        Beginning reel number for a restarted copy

       -buf         Use double buffered I/O.

       Volcopy requests length and density information if it is not given on
       the command line or is not recorded on an input tape label.  If the
       file system is too large for one reel, volcopy prompts for additional
       reels.  Labels of all reels are checked.  You can mount tapes on two
       or more drives.  If volcopy is interrupted, it asks whether you want
       to quit or to use a shell.  In the latter case, you can perform other
       operations (e.g.,: labelit ) and return to volcopy by exiting from
       the new shell.

       The fsname argument represents the mounted name (e.g.,: root, u1) of
       the file system being copied.

       The special argument is the physical disk section or tape (e.g.,:
       /dev/dsk/usr or /dev/rmt/0m).

       The volname is the physical volume name (e.g.,: pk3, t0122) and
       should match the external label sticker.  Such label names are
       limited to six or fewer characters.  If you want to use the existing
       volume name, specify - for volname.

       Special1 and volname1 are the device and volume from which the copy
       of the file system is being extracted.  If special1 is mounted, fsck
       must be run on the destination disk file system before that file



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

volcopy(1M)                  DG/UX 5.4 Rel. 2.01                 volcopy(1M)


       system can be mounted.

       Special2 and volname2 are the target device and volume.  If special2
       is a disk filesystem, it should be unmounted before volcopy is
       performed.

       Labelit can provide initial labels for unmounted disk or tape file
       systems.  With the optional arguments omitted, labelit prints current
       label values.  Otherwise, the tape is relabeled, destroying the
       previous contents.  The -n labels new tapes only, skipping the check
       of the current label.

EXAMPLES
       To copy the root directory into /test , where /test is the file
       system name associated with the /test file system, no volume label
       exists, and fsname = /, you would do the following:

       1)     Use labelit to label backup tapes for /test.
              labelit /dev/rmt/0 /test vol 1

       2)     Create backups with volcopy as follows:
              volcopy /test /dev/rdsk/test - /dev/rmt/0 vol 1

       3)     Use umount(1M) to unmount the /test directory as follows:
              umount /test

       4)     Copy / (root directory) to /test as follows:
              volcopy / /dev/rdsk/root - /dev/rdsk/test -

       5)     Check the /test file system for inconsistencies as follows:
              fsck /dev/rdsk/test

       6)     Use labelit(1M) to verify that the /test file system
              superblock now contains fsname = /.

FILES
       /etc/log/filesave.log    Record of file systems/volumes copied.  Must
                                be present in order for volcopy to run; an
                                initial file (zero length) is provided with
                                the system.

SEE ALSO
       sh(1), fs(4).

NOTES
       Only device names beginning with /dev/rmt/ are treated as tapes.

       Volcopy overwrites all of special2 including the superblock.  Any
       data previously found on that file system will be lost once volcopy
       is performed.  If you use volcopy for disk-to-disk transfers, both
       file systems should be the same size.






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