6.0;mtvol (mount_volume), revision 6.0, 83/04/21
MTVOL (MOUNT_VOLUME) -- Mount a logical volume.
usage: MTVOL {W | S | F}[unit] [log_vol_number] [pathname] [-F | -NQ | -PR]
FORMAT
MTVOL disk_type[unit] [log_vol_number] [pathname] [options]
A logical volume is a named storage area on a disk. MTVOL mounts a logical
volume, making the files and directories it contains accessible. Up to eight
volumes (both physical and logical) may be mounted on a node at any time. Of
the eight, no more than five of those volumes may be logical.
Before a new physical volume can be mounted for the first time, you must
initialize it. Type HELP INVOL for details.
ARGUMENTS
disk_type
(required) Specify the type of disk on which the volume being mounted
resides. Valid disk types are: W (Winchester), S (Storage
Module), or F (Floppy).
unit
(optional) Specify disk unit number (0 or 1). If you use this
argument, the unit number must follow the disk_type ID
immediately: no blanks in between. For example, "S1"
denotes storage module unit 1.
Default if omitted: 0
log_vol_number
(optional) Specify the disk volume number. This is the same number
that you assigned when you formatted the disk using INVOL.
The first logical volume is numbered 1, the second 2, and
so forth.
Default if omitted: 1
pathname
(optional) Specify the name of the volume entry directory. This is
the logical volume's top-level directory. Specify this
pathname only if the entry directory is not already
cataloged in the naming tree. If the pathname you choose
already exists, an error will result.
Logical volume entry directories may appear anywhere in the
naming tree, with one exception: if a logical volume entry
directory is also the node's entry (top-level) directory,
it must appear just below the network root directory (//).
If you omit the pathname argument, MTVOL assumes that the
entry directory already exists, and searches the naming
tree for it. If it finds the entry directory, MTVOL mounts
the volume and prints the full entry directory pathname.
If MTVOL does not find the entry directory, it prints an
error message, and does not mount the volume. The search
may fail for any of the following reasons:
o The entry directory has never been cataloged.
o The entry directory was uncataloged when the
volume was last dismounted.
o The entry directory pathname exists on another
node, for which directory information is
currently unavailable.
An unsuccessful search does not mean that you cannot mount
the volume. It simply means that the volume entry
directory pathname does not exist on your node. To mount
the volume, issue the MTVOL command and supply an entry
directory pathname.
Even if the MTVOL finds the entry directory pathname, the
mount may fail if the volume is corrupt for some reason and
needs salvaging. In this case, MTVOL asks for permission
to mount the volume. You should usually respond "no" to
this request, then run the volume salvaging routine SALVOL.
Once the volume has been salvaged, you may try to mount it
again. If you mount a corrupt volume without salvaging it
first, damage to files in that volume may result.
Default if omitted: see above
OPTIONS
-F Force -- Mount the volume whether or not it needs
salvaging, and do not ask for permission.
-NQ No query -- Suppress query if a volume needs salvaging.
Instead, mount the volume ONLY if it does not need
salvaging.
-PR Protect -- Mount the volume with write protection. Any
attempts to write on the volume will fail.
CAUTION: Before removing a floppy disk volume mounted with MTVOL, you MUST use
DMTVOL to dismount it. Failure to dismount the volume could result
in lost or corrupt information.
EXAMPLES
$ mtvol f /masterfloppy Mount floppy and make a new entry directory.
$ dmtvol f Dismount it.
$ mtvol f Remount it using the new entry directory.
Volume mounted, entry directory is "/masterfloppy"
$