SysIII/usr/src/man/man1/volcopy.1m
.TH VOLCOPY 1M
.SH NAME
volcopy, labelit \- copy file systems with label checking
.SH SYNOPSIS
.PP
.B /etc/volcopy
.RB [ \-bpi "bits-per-inch ] [" \-feet "size ]"
fsname special1 volname1 special2 volname2
.br
.sp
.B /etc/labelit
special [ fsname volume [ \f3\-n\fP ] ]
.PP
.SH DESCRIPTION
.I Volcopy\^
makes a literal copy of the file system
using
a blocksize matched to the device (10 blocks for 800/1600 bpi tape;
88 blocks for everything else).
Using
.IR volcopy ,
a 2400 foot/1600 bpi tape will hold a 65K file system.
The optional flag arguments are used only with tapes
(\fB\-bpi\fR -- bits-per-inch;
.BR \-feet ""
-- size of reel in feet).
The program requests the information if it is not given on the
command line.
If the file system is too large to fit on one reel,
.I volcopy\^
will prompt for additional reels.
Labels of all reels are checked.
Tapes may be mounted alternately on two drives.
.PP
The
.I fsname\^
argument represents the mounted name (e.g.:
.BR root ,
.BR u1 ,
etc.)
of the filsystem being copied.
.PP
The
.I special\^
should be the physical disk section or tape (e.g.:
.BR /dev/rrp15 ,
.BR /dev/rmt0 ,
etc.).
.PP
The
.I volname\^
is the physical volume name (e.g.:
.BR pk3 ,
.BR t0122 ,
etc.)
and should match the external label sticker.
Such label names are limited to five or fewer characters.
.PP
.I Special1\^
and
.I volname1\^
are the device and volume from which the copy of the file system is
being extracted.
.I Special2\^
and
.I volname2\^
are the target device and volume.
.PP
.I Fsname\^
and
.I volname\^
are recorded in the last 12 characters
of the superblock (char fsname[6], volname[6];).
.PP
.I Labelit\^
can be used to provide initial labels for unmounted disk
or tape file systems.
With the optional arguments omitted,
.I labelit\^
prints current label values.
The
.B \-n
option provides for initial labeling of new tapes only
(this destroys previous contents).
.SH FILES
/etc/log/filesave a record of file systems/volumes copied
.SH "SEE ALSO"
fs(5).
.SH BUGS
Only device names beginning
.B /dev/rmt
are treated as tapes.