getvol(1M) getvol(1M)
NAME
getvol - verifies device accessibility
SYNOPSIS
getvol -n [-l label] device
getvol [-f|-F] [-wo] [-l label | -x label] device
DESCRIPTION
getvol verifies that the specified device is accessible and
that a volume of the appropriate medium has been inserted.
The command is interactive and displays instructional prompts,
describes errors, and shows required label information.
getvol uses the device table, /etc/device.tab, to determine
the characteristics of the device when performing the volume
label checking.
Options
getvol has the following options:
-n Run the command in non-interactive mode. The volume is
assumed to be inserted upon command invocation.
-l label
Specify that the label label must exist on the inserted
volume (can be overridden by the -o option).
-f Format the volume after insertion, using the format
command defined for this device in the device table.
-F Format the volume after insertion and places a file
system on the device. Also uses the format command
defined for this device in the device table.
-w Allow the administrator to write a new label on the
device. User is prompted to supply the label text.
This option is ineffective if the -n option is enabled.
-o Allow the administrator to override a label check.
-x label
Specifie that the label label must exist on the device.
This option should be used instead of the -l option when
the label can only be verified by visual means. Use of
the option causes a message to be displayed asking the
administrator to visually verify that the label is
indeed label.
Copyright 1994 Novell, Inc. Page 1
getvol(1M) getvol(1M)
device
Name the device which should be verified for
accessibility.
Files
/etc/device.tab
Return Values
On success, getvol returns 0. On failure, it returns 1 if the
command syntax was incorrect, invalid option was used, or an
internal error occurred, or returns 3 if the device table
could not be opened for reading.
Copyright 1994 Novell, Inc. Page 2