manpages.info - online man pages   

SunOS man pages : getvol (1)

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 informa- tion.

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 dev- ice. 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 dev- ice. 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. SunOS 5.8 Last change: 5 Jul 1990 1 Maintenance Commands getvol(1M)

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 attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________|

SEE ALSO

attributes(5)

NOTES

This command uses the device table to determine the charac- teristics of the device when performing the volume label checking. SunOS 5.8 Last change: 5 Jul 1990 2