getvol(1M)                                                       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 information.

         Options and arguments for this command are:

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

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

   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 internal error
             occurred.



   8/91                                                                 Page 1

   getvol(1M)                                                       getvol(1M)


         3 = device table could not be opened for reading.

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

   FILES
         /etc/device.tab

   SEE ALSO
         getvol(3X).










































   Page 2                                                                 8/91