getvol(1M)            UNIX System V(Essential Utilities)             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.





10/89                                                                    Page 1

getvol(1M)            UNIX System V(Essential Utilities)             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                                                                    10/89