1getvol(1M)              System Administration Commands              getvol(1M)
2
3
4

NAME

6       getvol - verifies device accessibility
7

SYNOPSIS

9       /usr/bin/getvol -n [-l label] device
10
11
12       /usr/bin/getvol [-f | -F] [-ow] [-l label | -x label] device
13
14

DESCRIPTION

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

OPTIONS

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

OPERANDS

57       The following operands are supported:
58
59       device    Specifies the device to be verified for accessibility.
60
61

EXIT STATUS

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

FILES

76       /etc/device.tab
77
78

ATTRIBUTES

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

SEE ALSO

92       attributes(5)
93

NOTES

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)
Impressum