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

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

attributes(5)

Notes

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