diskinfo(1M) System Administration Commands diskinfo(1M)NAMEdiskinfo - disk and slot identification utility
SYNOPSIS
/usr/sbin/diskinfo {-a|-e enclosure|-d disk|-C CSN}
[-HLpv] [-c i] [-B label] [-b j]
DESCRIPTION
The diskinfo command enables a system administrator or suitably privi‐
leged user to view the relationship between disk paths and bays (also
known as "slots") for devices that are enumerated by libtopo. These are
typically JBODs and direct-attached devices in blade systems.
There are three modes of operation: disk, enclosure, and chassis. Both
the disk and enclosure modes require that the user specify a Solaris
device name to identify which part of a machine's configuration to
report information about. The chassis method requires that the user
specify a Chassis Serial Number (CSN). Both the enclosure and chassis
modes then allow limiting the output to devices in specific bays of the
enclosure.
Various other options can also be specified, to report different levels
of detail about the selected devices. This detail might include:
o the list of physical paths to the device
o SCSI Inquiry information
o the silkscreen label
o devid information
OPTIONS
One of the following four mutually-exclusive options must be specified:
-a
Probe and report on all attached enclosures.
-d disk
Report which enclosure, subchassis, and bay a specific disk is
housed in. The disk name is specified using the cXtYdZ notation or
the silkscreen label as reported by libtopo.
-e enclosure
Limit output to bays and disks in a specific enclosure. The enclo‐
sure name is specified as /dev/es/sesN when using the ses(7D)
driver, or /dev/scsi/ses/cXtY when using the sgen(7D) driver.
-C CSN
Limit output to bays and disks in an enclosure with the specified
Chassis Serial Number (CSN). For direct-attached HBAs, this can be
a synthetic CSN, composed of the system serial number, then a phys‐
ical or logical designation, then an instance number. For example:
YB09F7-physical-hba-0 or YB09F7-logical-hba-2.
In conjunction with the preceding options, the following options can
also be specified:
-B label
Limits information to the bay that matches label. This option also
requires specifying a CSN (-C) or enclosure path (-e).
-b j
Limit the reported information to this specific bay number in the
specified enclosure. This option is valid only with the -e or -C
options.
Caution -
This option might significantly slow down the response from the
utility if the enclosure contains a large number of elements,
especially subchassis. If the specified enclosure or CSN has sub‐
chassis elements, then the -c argument must also be specified
with this option.
-c i
For enclosures that utilize subchassis elements, limit the reported
information to the specified subchassis. This option is valid only
with the -e or -C options.
Caution -
This option might significantly slow down the response from the
utility.
-h
Displays a brief usage message.
-L
Toggle the Identification LED for the specified disk, or for the
specified bay in the enclosure. See NOTES below.
-p
Display physical path mapping for the specified disk. This option
is not valid with the -e or -a operating modes.
-v
Display all available information for the device. All identified
paths to the device and target port identifiers will be listed,
along with the device devid and SCSI INQUIRY-reported serial num‐
ber. This option is valid with all the operating modes of -a, -C,
-d and -e.
EXAMPLES
In some of the following examples, example output wraps in an 80-char‐
acter-wide display.
Example 1 Determining Which Bay
The following command determines which bay a specific disk resides in.
# /usr/sbin/diskinfo -d c0t5000C5000B2330F7d0
Enclosure path: /dev/scsi/ses/c11t50016360000AA5FDd0
Chassis Serial Number: 0848QAJ001
Chassis Model: SUN-Storage-J4200
Label Disk name Vendor Product Vers
---------------- ---------------------- -------- ---------------- ----
SCSI_Device__4 c0t5000C5000B2330F7d0 SEAGATE ST330055SSUN300G 0B92
Example 2 Reporting Disks in an Enclosure
The following command reports all the disks within an enclosure.
# /usr/sbin/diskinfo -e YB09F7-physical-hba-1
Enclosure path: YB09F7-physical-hba-1
Chassis Serial Number: YB09F7-physical-hba-1
Chassis Model: SUNW,Sun-Blade-T6360
Label Disk name Vendor Product Vers
---------- ---------------------- -------- ---------------- ----
/SYS/HDD0 c4t5000CCA00A0D4DE4d0 HITACHI H103014SCSUN146G A160
/SYS/HDD1 c4t5000C50012EE871Bd0 SEAGATE ST914603SSUN146G 0768
/SYS/HDD3 c4t5000C5001D0D1B9Fd0 SEAGATE ST930003SSUN300G 0868
Example 3 Reporting Physical Path Information
The following command reports physical path information for a specific
disk.
# /usr/sbin/diskinfo -d c4t5000C50012EE871Bd0 -p
Enclosure path: YB09F7-physical-hba-1
Chassis Serial Number: YB09F7-physical-hba-1
Chassis Model: SUNW,Sun-Blade-T6360
Label Disk name Vendor Product Vers
---------- ---------------------- -------- ---------------- ----
/SYS/HDD1 c4t5000C50012EE871Bd0 SEAGATE ST914603SSUN146G 0768
Physical path
--------------------------------
0: /pci@400/pci@1/pci@0/pci@2/LSI,sas@0/iport@2/disk@w5000c\
50012ee8719,0
Example 4 Reporting All Information
The following command reports all information for a specific disk.
# /usr/sbin/diskinfo -d c0t5000C50002FB6823d0 -v
Enclosure path: /dev/es/ses6
Chassis Serial Number: 0818QAJ002
Chassis Model: SUN-Storage-J4200
Label Disk name Vendor Product Vers
---------------- ---------------------- -------- ---------------- ----
SCSI_Device__0 c0t5000C50002FB6823d0 SEAGATE ST314655SSUN146G 0B92
Physical path
--------------------------------
0: /pci@0,0/pci10de,5d@d/pci11f8,8001@0/iport@f/disk@w5000c\
50002fb6821,0
1: /pci@7b,0/pci10de,5d@d/pci11f8,8001@0/iport@f/disk@w5000c\
50002fb6822,0
2: /pci@0,0/pci10de,5d@d/pci11f8,8001@0/iport@f0/disk@w5000c\
50002fb6822,0
3: /pci@7b,0/pci10de,5d@d/pci11f8,8001@0/iport@f0/disk@w5000c\
50002fb6821,0
Target port ident
--------------------
0: w5000c50002fb6821
1: w5000c50002fb6821
2: w5000c50002fb6822
3: w5000c50002fb6822
devid
--------------------------------
id1,sd@n5000c50002fb6823
Inquiry Serial Number
--------------------------------
0807S47FQP 3LN47FQP
Example 5 Reporting Information for a Subchassis/Disk
The following command reports all information for a disk in a specific
subchassis.
# /usr/sbin/diskinfo -e /dev/es/ses61 -c 10 -b 23 -v
Enclosure path: /dev/es/ses61
Chassis Serial Number: 50800207e4828000
Chassis Model: SUN-GENESIS
Label Disk name Vendor Product Vers
----------------------------------------- -------- --------------- ----
DRIVE_SET_10_HDD_23 c0t5000C50003586473d0 SEAGATE ST34008SSUN0.4T 0543
Physical path
--------------------------------
0: /pci@77,0/pci8086,3410@9/pci11f8,8001@0/iport@f/disk@w5000c\
50003586471,0
1: /pci@77,0/pci8086,340e@7/pci11f8,8001@0/iport@f/disk@w5000c\
50003586472,0
Target port ident
--------------------
0: w5000c50003586471
1: w5000c50003586472
devid
--------------------------------
id1,sd@n5000c50003586473
Inquiry Serial Number
--------------------------------
0818X0JX2Q 3RJ0JX2Q
Example 6 Reporting on Disks Attached to a Controller
The following command reports on all disks attached to a physical con‐
troller.
# /usr/sbin/diskinfo -C YB09F7-physical-hba-1
Enclosure path: YB09F7-physical-hba-1
Chassis Serial Number: YB09F7-physical-hba-1
Chassis Model: SUNW,Sun-Blade-T6360
Label Disk name Vendor Product Vers
---------- ---------------------- -------- ---------------- ----
/SYS/HDD0 c4t5000CCA00A0D4DE4d0 HITACHI H103014SCSUN146G A160
/SYS/HDD1 c4t5000C50012EE871Bd0 SEAGATE ST914603SSUN146G 0768
/SYS/HDD3 c4t5000C5001D0D1B9Fd0 SEAGATE ST930003SSUN300G 0868
EXIT STATUS
0
Success. If a disk or enclosure and bay were specified, then the
device was located.
1
Failure. A specified device was not located, or some other error
condition occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │service/fault-management │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcfgadm(1M), fmd(1M), attributes(5), mpt(7D), mpt_sas(7D), ses(7D),
sgen(7D)
The SCSI Storage Interfaces committee website, http://www.t10.org
SCSI Primary Commands-4, SPC4; SCSI Enclosure Services-2; SES2, Serial
Attached SCSI-2, SAS2
NOTES
The enumeration libraries that /usr/sbin/diskinfo depends on require
that enclosures behave in a standards-compliant (SPC4 and SES2) fash‐
ion. Enclosures that do not respond appropriately might not report
slots or disk nodes to FMA correctly. Specifically, diskinfo requires
that enclosures support SES diagnostic page 0xa (Additional Element
Status) and set the Element Index Present (EIP) bit to 1. Enclosures
that do not meet this criteria are not enumerable and will not be prop‐
erly visible with FMA or /usr/sbin/diskinfo.
LED support is not included in the initial integration of this utility.
SunOS 5.10 19 Jan 2010 diskinfo(1M)
