1getvol(1M) System Administration Commands getvol(1M)
2
3
4
6 getvol - verifies device accessibility
7
9 /usr/bin/getvol -n [-l label] device
10
11
12 /usr/bin/getvol [-f | -F] [-ow] [-l label | -x label] device
13
14
16 getvol verifies that the specified device is accessible and that a vol‐
17 ume of the appropriate medium has been inserted. The command is inter‐
18 active and displays instructional prompts, describes errors, and shows
19 required label information.
20
22 The following options are supported:
23
24 -n Runs the command in non-interactive mode. The volume is
25 assumed to be inserted upon command invocation.
26
27
28 -l label Specifies that the label label must exist on the inserted
29 volume (can be overridden by the -o option).
30
31
32 -f Formats the volume after insertion, using the format com‐
33 mand defined for this device in the device table.
34
35
36 -F Formats the volume after insertion and places a file system
37 on the device. Also uses the format command defined for
38 this device in the device table.
39
40
41 -o Allows the administrator to override a label check.
42
43
44 -w Allows administrator to write a new label on the device.
45 User is prompted to supply the label text. This option is
46 ineffective if the -n option is enabled.
47
48
49 -x label Specifies that the label label must exist on the device.
50 This option should be used in place of the -l option when
51 the label can only be verified by visual means. Use of the
52 option causes a message to be displayed asking the adminis‐
53 trator to visually verify that the label is indeed label.
54
55
57 The following operands are supported:
58
59 device Specifies the device to be verified for accessibility.
60
61
63 The following exit values are returned:
64
65 0 Successful completion.
66
67
68 1 Command syntax was incorrect, invalid option was used, or an
69 internal error occurred.
70
71
72 3 Device table could not be opened for reading.
73
74
76 /etc/device.tab
77
78
80 See attributes(5) for descriptions of the following attributes:
81
82
83
84
85 ┌─────────────────────────────┬─────────────────────────────┐
86 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
87 ├─────────────────────────────┼─────────────────────────────┤
88 │Availability │SUNWcsu │
89 └─────────────────────────────┴─────────────────────────────┘
90
92 attributes(5)
93
95 This command uses the device table to determine the characteristics of
96 the device when performing the volume label checking.
97
98
99
100SunOS 5.11 5 Jul 1990 getvol(1M)