GETVOL(1M) Maintenance Commands GETVOL(1M)


NAME


getvol - verifies device accessibility

SYNOPSIS


/usr/bin/getvol -n [-l label] device


/usr/bin/getvol [-f | -F] [-ow] [-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.

OPTIONS


The following options are supported:

-n
Runs the command in non-interactive mode. The volume is
assumed to be inserted upon command invocation.


-l label
Specifies that the label label must exist on the inserted
volume (can be overridden by the -o option).


-f
Formats the volume after insertion, using the format command
defined for this device in the device table.


-F
Formats 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.


-o
Allows the administrator to override a label check.


-w
Allows 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.


-x label
Specifies that the label label must exist on the device.
This option should be used in place 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.


OPERANDS


The following operands are supported:

device
Specifies the device to be verified for accessibility.


EXIT STATUS


The following exit values are returned:

0
Successful completion.


1
Command syntax was incorrect, invalid option was used, or an
internal error occurred.


3
Device table could not be opened for reading.


FILES


/etc/device.tab


SEE ALSO


attributes(5)

NOTES


This command uses the device table to determine the characteristics of
the device when performing the volume label checking.


July 5, 1990 GETVOL(1M)