getvol

 

---

 
 
 
 Maintenance 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 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.
 
 
 
 SunOS 5.8            Last change: 5 Jul 1990                    1
 
 
 
 
 
 
 Maintenance Commands                                   getvol(1M)
 
 
 
 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.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8            Last change: 5 Jul 1990                    2
 
 
 

---