Copyright 1989 AT&T Copyright (c) 1997 Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
/usr/bin/getvol -n [-l label] device
/usr/bin/getvol [-f | -F] [-ow] [-l label | -x label] device
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.
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.
The following operands are supported:
device
Specifies the device to be verified for accessibility.
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.
attributes(5)
This command uses the device table to determine the characteristics of the device when performing the volume label checking.