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]  dev-
     ice

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.

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.