Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsgetvol(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 information.

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

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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu

SEE ALSO

 

attributes(5)

NOTES

 

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


SunOS 5.9Go To TopLast Changed 5 Jul 1990

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.