Print this page
8708 Want diskinfo(1m) to list all disk bays, including those don't have disk installed
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/diskinfo.1m
+++ new/usr/src/man/man1m/diskinfo.1m
1 1 .\"
2 2 .\" This file and its contents are supplied under the terms of the
3 3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
|
↓ open down ↓ |
3 lines elided |
↑ open up ↑ |
4 4 .\" You may only use this file in accordance with the terms of version
5 5 .\" 1.0 of the CDDL.
6 6 .\"
7 7 .\" A full copy of the text of the CDDL should have accompanied this
8 8 .\" source. A copy of the CDDL is also available via the Internet at
9 9 .\" http://www.illumos.org/license/CDDL.
10 10 .\"
11 11 .\" Copyright 2014 Joyent, Inc.
12 12 .\" Copyright 2016 Nexenta Systems, Inc.
13 13 .\"
14 -.Dd July 20, 2016
14 +.Dd October 06, 2017
15 15 .Dt DISKINFO 1M
16 16 .Os
17 17 .Sh NAME
18 18 .Nm diskinfo
19 19 .Nd provide disk device inventory and status
20 20 .Sh SYNOPSIS
21 21 .Nm
22 -.Op Fl Hp
22 +.Op Fl aHp
23 23 .Op Fl c Ns | Ns Fl P
24 24 .Sh DESCRIPTION
25 25 The diskinfo tool provides information about the disk devices in the system.
26 26 Because it interacts with the kernel's device management subsystem, this tool
27 27 can be used only from the global zone.
28 28 If run in any other zone, its output will be incomplete and unreliable.
29 29 .Pp
30 30 There are three main modes.
31 31 The default mode, when neither the
32 32 .Fl c
33 33 nor
34 34 .Fl P
35 35 option is specified, provides a basic inventory of the disk devices in the
36 36 system.
37 37 Each line describes a single device and contains the device's attachment bus or
38 38 fabric type, the base name of the device in the
39 39 .Pa /dev/dsk
40 40 directory, the disk's vendor and product identification strings, the size
41 41 .Pq storage capacity
42 42 of the device, whether the device is removable, and whether it is solid-state.
43 43 .Pp
44 44 The
45 45 .Fl P
46 46 option selects physical mode.
47 47 In this mode, each line of output likewise describes one disk device; however,
48 48 the fields provided indicate the base name of the device in the
49 49 .Pa /dev/dsk
50 50 directory, the disk's vendor and product identification strings, the serial
51 51 number of the device, whether the device is faulty as diagnosed by
52 52 .Xr fmd 1M ,
53 53 whether the locate or identification indicator is on for the device
54 54 .Pq if one is present ,
55 55 and the chassis and bay number containing the disk if known.
56 56 .Pp
57 57 The
|
↓ open down ↓ |
25 lines elided |
↑ open up ↑ |
58 58 .Fl c
59 59 option selects compact mode.
60 60 This mode provides all of the information provided by both the default mode and
61 61 physical mode in a compact format.
62 62 .Pp
63 63 See
64 64 .Sx OUTPUT FIELDS
65 65 below for a detailed description of each column.
66 66 .Sh OPTIONS
67 67 .Bl -tag -width Ds
68 +.It Fl a
69 +Show all disk bays, including those don't have disks installed.
68 70 .It Fl c
69 71 Select compact mode output.
70 72 At most one of
71 73 .Fl c
72 74 and
73 75 .Fl P
74 76 may be present on the command line.
75 77 .It Fl H
76 78 Do not print a header.
77 79 This provides output suitable for passing into text processing tools.
78 80 .It Fl P
79 81 Select physical mode output.
80 82 At most one of
81 83 .Fl P
82 84 and
83 85 .Fl c
84 86 may be present on the command line.
85 87 .It Fl p
86 88 Parsable output.
87 89 When
88 90 .Fl p
89 91 is selected, the size
90 92 .Pq storage capacity
91 93 is output in bytes instead of in human-readable units, and the device's location
92 94 .Pq if known
93 95 is provided as a comma-separated chassis and bay number instead of a
94 96 human-readable location.
95 97 This option may be used in any output mode and is intended for use by scripts or
96 98 other robotic tooling.
97 99 .El
98 100 .Sh OUTPUT FIELDS
99 101 .Bl -tag -width "LOCATION"
100 102 .It Sy DISK
101 103 The base name of the device node within the
102 104 .Pa /dev/dsk
103 105 directory.
104 106 The names of partitions and/or slices, if any, are derived from this name as
105 107 described by
106 108 .Xr prtvtoc 1M .
107 109 .Pp
108 110 This field is available in all output modes.
109 111 .It Sy FLRS
110 112 A condensed field incorporating the same information as the
111 113 .Sy FLT , LOC , RMV ,
112 114 and
113 115 .Sy SSD
114 116 fields.
115 117 Each field is condensed to a single character.
116 118 If the field is true, the first letter of the field name will appear in its
117 119 position in the string; otherwise, the
118 120 .Qq Sy -
119 121 character will appear instead.
120 122 .Pp
121 123 This field is available only in compact output mode.
122 124 .It Sy FLT
123 125 A boolean field indicating whether the device is faulty; specifically, whether
124 126 the fault indicator
125 127 .Pq if one is present
126 128 is active.
127 129 .Pp
128 130 This field is available only in physical output mode.
129 131 .It Sy LOC
130 132 A boolean field indicating whether the locate or identify indicator, if any,
131 133 associated with the device's bay, is active.
132 134 .Pp
133 135 This field is available only in physical output mode.
134 136 .It Sy LOCATION
135 137 The physical chassis and bay name
136 138 .Po or chassis and bay numbers, if
137 139 .Fl p
138 140 is given
139 141 .Pc
140 142 in which the device is located.
141 143 The chassis number is identified in human-readable output within
142 144 .Bq square brackets ;
143 145 chassis 0 is the host chassis itself.
144 146 The bay name, if any, is provided by the enclosure, typically via a SCSI
145 147 Enclosure Services processor.
146 148 .Pp
147 149 This field is available in compact and physical output modes.
148 150 .It Sy PID
149 151 The product identification string reported by the device.
150 152 .Pp
151 153 This field is available in all output modes.
152 154 .It Sy RMV
153 155 A boolean field indicating whether the device is removable.
154 156 USB storage devices, most optical drives and changers, and certain other devices
155 157 that report themselves as removable will be identified as such.
156 158 .Pp
157 159 This field is available only in default output mode.
158 160 .It Sy SERIAL
159 161 The serial number of the device.
160 162 The entire serial number is reported if the device and its drivers provide it.
161 163 .Pp
162 164 This field is available in compact and physical output modes.
163 165 .It Sy SIZE
164 166 The device's storage capacity.
165 167 If the
166 168 .Fl p
167 169 option is given, this is reported in bytes; otherwise, it is reported in a
168 170 human-readable format with units specified.
169 171 All units are based on powers of 2 and are expressed in SI standard notation.
170 172 .Pp
171 173 This field is available in compact and default output modes.
172 174 .It Sy SSD
173 175 A boolean field indicating whether the device is solid-state.
174 176 .Pp
175 177 This field is available only in default output mode.
176 178 .It Sy TYPE
177 179 The transport
178 180 .Pq fabric or bus
179 181 type by which the storage device is attached to the host, if known.
180 182 Typical transports include SCSI and USB.
181 183 .Pp
182 184 This field is available in compact and default output modes.
183 185 .It Sy VID
184 186 The vendor identification string reported by the device.
185 187 .Pp
186 188 This field is available in all output modes.
187 189 .El
188 190 .Sh SEE ALSO
189 191 .Xr fmd 1M ,
190 192 .Xr prtvtoc 1M ,
191 193 .Xr sd 7D
|
↓ open down ↓ |
114 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX