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.man.txt
+++ new/usr/src/man/man1m/diskinfo.1m.man.txt
1 1 DISKINFO(1M) Maintenance Commands DISKINFO(1M)
2 2
3 3 NAME
4 4 diskinfo - provide disk device inventory and status
5 5
6 6 SYNOPSIS
7 - diskinfo [-Hp] [-c|-P]
7 + diskinfo [-aHp] [-c|-P]
8 8
9 9 DESCRIPTION
10 10 The diskinfo tool provides information about the disk devices in the
11 11 system. Because it interacts with the kernel's device management
12 12 subsystem, this tool can be used only from the global zone. If run in
13 13 any other zone, its output will be incomplete and unreliable.
14 14
15 15 There are three main modes. The default mode, when neither the -c nor -P
16 16 option is specified, provides a basic inventory of the disk devices in
17 17 the system. Each line describes a single device and contains the
18 18 device's attachment bus or fabric type, the base name of the device in
19 19 the /dev/dsk directory, the disk's vendor and product identification
20 20 strings, the size (storage capacity) of the device, whether the device is
21 21 removable, and whether it is solid-state.
22 22
23 23 The -P option selects physical mode. In this mode, each line of output
24 24 likewise describes one disk device; however, the fields provided indicate
25 25 the base name of the device in the /dev/dsk directory, the disk's vendor
26 26 and product identification strings, the serial number of the device,
27 27 whether the device is faulty as diagnosed by fmd(1M), whether the locate
↓ open down ↓ |
10 lines elided |
↑ open up ↑ |
28 28 or identification indicator is on for the device (if one is present), and
29 29 the chassis and bay number containing the disk if known.
30 30
31 31 The -c option selects compact mode. This mode provides all of the
32 32 information provided by both the default mode and physical mode in a
33 33 compact format.
34 34
35 35 See OUTPUT FIELDS below for a detailed description of each column.
36 36
37 37 OPTIONS
38 + -a Show all disk bays, including those don't have disks installed.
39 +
38 40 -c Select compact mode output. At most one of -c and -P may be
39 41 present on the command line.
40 42
41 43 -H Do not print a header. This provides output suitable for passing
42 44 into text processing tools.
43 45
44 46 -P Select physical mode output. At most one of -P and -c may be
45 47 present on the command line.
46 48
47 49 -p Parsable output. When -p is selected, the size (storage
48 50 capacity) is output in bytes instead of in human-readable units,
49 51 and the device's location (if known) is provided as a comma-
50 52 separated chassis and bay number instead of a human-readable
51 53 location. This option may be used in any output mode and is
52 54 intended for use by scripts or other robotic tooling.
53 55
54 56 OUTPUT FIELDS
55 57 DISK The base name of the device node within the /dev/dsk directory.
56 58 The names of partitions and/or slices, if any, are derived from
57 59 this name as described by prtvtoc(1M).
58 60
59 61 This field is available in all output modes.
60 62
61 63 FLRS A condensed field incorporating the same information as the
62 64 FLT, LOC, RMV, and SSD fields. Each field is condensed to a
63 65 single character. If the field is true, the first letter of
64 66 the field name will appear in its position in the string;
65 67 otherwise, the "-" character will appear instead.
66 68
67 69 This field is available only in compact output mode.
68 70
69 71 FLT A boolean field indicating whether the device is faulty;
70 72 specifically, whether the fault indicator (if one is present)
71 73 is active.
72 74
73 75 This field is available only in physical output mode.
74 76
75 77 LOC A boolean field indicating whether the locate or identify
76 78 indicator, if any, associated with the device's bay, is active.
77 79
78 80 This field is available only in physical output mode.
79 81
80 82 LOCATION The physical chassis and bay name (or chassis and bay numbers,
81 83 if -p is given) in which the device is located. The chassis
82 84 number is identified in human-readable output within [square
83 85 brackets]; chassis 0 is the host chassis itself. The bay name,
84 86 if any, is provided by the enclosure, typically via a SCSI
85 87 Enclosure Services processor.
86 88
87 89 This field is available in compact and physical output modes.
88 90
89 91 PID The product identification string reported by the device.
90 92
91 93 This field is available in all output modes.
92 94
93 95 RMV A boolean field indicating whether the device is removable.
94 96 USB storage devices, most optical drives and changers, and
95 97 certain other devices that report themselves as removable will
96 98 be identified as such.
97 99
98 100 This field is available only in default output mode.
99 101
100 102 SERIAL The serial number of the device. The entire serial number is
101 103 reported if the device and its drivers provide it.
102 104
103 105 This field is available in compact and physical output modes.
104 106
105 107 SIZE The device's storage capacity. If the -p option is given, this
106 108 is reported in bytes; otherwise, it is reported in a human-
107 109 readable format with units specified. All units are based on
108 110 powers of 2 and are expressed in SI standard notation.
109 111
110 112 This field is available in compact and default output modes.
111 113
112 114 SSD A boolean field indicating whether the device is solid-state.
113 115
114 116 This field is available only in default output mode.
115 117
116 118 TYPE The transport (fabric or bus) type by which the storage device
117 119 is attached to the host, if known. Typical transports include
118 120 SCSI and USB.
↓ open down ↓ |
71 lines elided |
↑ open up ↑ |
119 121
120 122 This field is available in compact and default output modes.
121 123
122 124 VID The vendor identification string reported by the device.
123 125
124 126 This field is available in all output modes.
125 127
126 128 SEE ALSO
127 129 fmd(1M), prtvtoc(1M), sd(7D)
128 130
129 -illumos July 20, 2016 illumos
131 +illumos October 6, 2017 illumos
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX