10.0;mtvol (mount_volume), revision 1.0, 88/01/21
mtvol (mount_volume) -- Mount a logical volume.
usage: mtvol {w | s | f}[controller:][unit] [log_vol_number]
[pathname]
[-f | -nq | -pr]
DESCRIPTION
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. No more than five of the eight volumes may be logical.
Before a new physical volume can be mounted for the first time, you must
initialize it. See the invol (initialize_volume) command description 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).
controller (optional)
Specify controller number (0 or 1). To specify both controller
and unit, type the controller number, a colon (:), then the
unit number, e.g., ``w1:0." See EXAMPLES below.
Default if omitted: 0
unit (optional)
Specify disk unit number (0 or 1). If you use this argument,
the unit number must follow the disk_type ID immediately: with
no blanks in between. For example, "S1" denotes storage module
unit 1. To specify both controller and unit, type the
controller number, a colon (:), then the unit number, e.g.,
``w1:0." See EXAMPLES below.
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. 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
results.
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:
⊕ The entry directory has never been cataloged.
⊕ The entry directory was uncataloged when the volume was
last dismounted.
⊕ 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 mtvol finds the entry directory pathname, the mount may fail if
the volume is corrupt 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
Volume mounted, entry directory is /masterfloppy
$ dmtvol f
$ mtvol f
This command sequence mounts the floppy and makes a new entry directory,
then dismount the floppy, and finally remounts it using the new entry
directory.
At SR10, this command interprets controller number and unit number in the
following way. (The example below assumes a Winchester disk (-w)).
You type Interpreted as
(Controller:Unit)
w w0:0
w0 w0:0
w1 w0:1
w1:0 w1:0
w1:1 w1:1
SEE ALSO
More information is available. Type
help invol