opensolaris man page for getvol

getvol(1M)						  System Administration 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

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       attributes(5)

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

SunOS 5.11							    5 Jul 1990								getvol(1M)