System Administration 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
                 device.  User  is  prompted  to supply the label
                 text. This option  is  ineffective  if  the   -n
                 option is enabled.






SunOS 5.11           Last change: 5 Jul 1990                    1






System Administration Commands                         getvol(1M)



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


OPERANDS
     The following operands are supported:

     device    Specifies the device to be verified  for  accessi-
               bility.


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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE 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



SunOS 5.11           Last change: 5 Jul 1990                    2






System Administration Commands                         getvol(1M)



     checking.






















































SunOS 5.11           Last change: 5 Jul 1990                    3