getvol(1M)        MISC. REFERENCE MANUAL PAGES         getvol(1M)



NAME
     getvol - verifies device accessibility

SYNOPSIS
     getvol -n [-l label] device
     getvol [-f|-F] [-wo] [-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 and arguments for this command are:

     -n      Runs  the  command  in  non-interactive  mode.   The
             volume  is assumed to be inserted upon command invo-
             cation.

     -l      Specifies that the label label  must  exist  on  the
             inserted volume (can be overriden 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.

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

     -o      Allows the administrator to override a label check.

     -x      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.

     device  Names the device which should be verified for acces-
             sibility.

ERRORS
     The command will exit with one of the following values:

     0 = successful completion of the task.

     1 = command syntax incorrect, invalid option used, or inter-
         nal error occurred.



                Last change: Essential Utilities                1

getvol(1M)        MISC. REFERENCE MANUAL PAGES         getvol(1M)



     3 = device table could not be opened for reading.

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

FILES
     /etc/device.tab

SEE ALSO
     getvol(3X).











































                Last change: Essential Utilities                2