volcopy(1m)
_________________________________________________________________
volcopy, labelit
copy file systems with label checking
_________________________________________________________________
SYNTAX
/etc/volcopy [options] fsname special1 volname1 special2 volname2
/etc/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 only with tapes are:
-bpidensity Bits per inch (800 or 1600)
-feetsize Size of reel in feet (1200 or 2400)
-reelnum 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
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
volcopy(1m)
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 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.
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.
_________________________________________________________________
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 mount 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 = /.
_________________________________________________________________
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
volcopy(1m)
SEE ALSO
sh(1), fs(4).
BUGS
Only device names beginning with /dev/rmt/ are treated as tapes.
WARNINGS
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.
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)