GETVOL(8) Maintenance Commands and Procedures GETVOL(8)
getvol - verifies device accessibility
/usr/bin/getvol -n [-l label] device
/usr/bin/getvol [-f | -F] [-ow] [-l label | -x label] device
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.
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.
The following operands are supported:
device
Specifies the device to be verified for accessibility.
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.
/etc/device.tab
attributes(7)
This command uses the device table to determine the characteristics
of the device when performing the volume label checking.
July 5, 1990 GETVOL(8)
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(7)
NOTES
This command uses the device table to determine the characteristics
of the device when performing the volume label checking.
July 5, 1990 GETVOL(8)