System Administration Commands sasinfo(1M)
NAME
sasinfo - Serial Attached SCSI HBA port command line inter-
faceSYNOPSIS
sasinfo hba [-v] [HBA_Name]...
sasinfo hba-port [-lvy] [-a HBA_Name] [HBA_port_nam]...
sasinfo expander [-vt] [-p HBA_port_Name] [Expander_SAS_Addr]...
sasinfo target-port [-s | -v] [Target_port_SAS_Addr]...
sasinfo logical-unit | lu [-v] [device_path]...
sasinfo [-V]
sasinfo [-?]
DESCRIPTION
The sasinfo utility is a command line interface that col-
lects administrative information on Serial Attached SCSI-2
(SAS-2) host bus adapter (HBA) that supports the Storage
Management HBA API (SM-HBA). The utility reports attributes
of HBA ports and of expander devices and SCSI target devices that might be connected to those HBA ports.sasinfo is implemented as a set of subcommands, described
below.SUB-COMMANDS
The following subcommands are supported by sasinfo.
hbaLists information for the HBA referenced by the speci-
fied HBA_name. If HBA_name is not specified, all HBAs
on the host will be listed.hba-port
Lists information for the HBA port referenced by thespecified HBA_port_Name. If HBA_port_Name is not
SunOS 5.11 Last change: 10 Jul 2009 1
System Administration Commands sasinfo(1M)
specified, all HBA ports on the host will be listed. Note that HBA ports can be dynamically configured/unconfigured so that the number of HBA ports on an HBA can change as connections to target devicesare established. With no connections to a storage dev-
ice, no HBA port is configured. expander Lists hierarchical view of the expander referenced bythe specified Expander_SAS_Addr. If no argument is
specified, all expanders that are visible across all HBA ports on the host will be listed.target-port
Lists information for those target ports referenced byTarget_port_SAS_Addr address. If no argument is speci-
fied, all target ports that are visible on the host will be listed.logical-unit | lu
Lists the logical unit referenced by the specifieddevice_path. If device_path is not specified, all SAS
logical units will be listed, including the SAS Manage-
ment Protocol (SMP) target port. OPTIONS The following options are supported.-?, --help
Displays usage information-a, --hba HBA_Name
Retrieve HBA port information from the HBA_Name of an
HBA on the host. The -a option can only be used with the
hba-port subcommand.
-l, --phy-linkstat
Lists the link error statistics information for the phys on the HBA port referenced by the specifiedHBA_port_Name or all HBA ports if no HBA port is
SunOS 5.11 Last change: 10 Jul 2009 2
System Administration Commands sasinfo(1M)
specified. This option is used only with the hba-port
subcommand.-p HBA_port_SAS_Addr, --port HBA_port_SAS_Addr
Retrieve remote port information from theHBA_port_SAS_Addr of the local HBA port on the host. The
-p option can be used only with the expander subcommand.
-s, --scsi
Lists SCSI attributes for target ports that are requested for display. This option is only used for thetarget-port subcommand.
-v, --verbose
Display details on hardware information, such as SAS address, topology device, and so forth, based on which subcommand is invoked.-V, --version
Displays the version information.-y, --phy
Lists the phy information on the HBA port specified byHBA_port_Name or all HBA ports if no HBA port is speci-
fied. This option is used only with the hba-port subcom-
mand.EXAMPLES
Example 1 Listing All HBAs The following command lists all HBAs on the host.# sasinfo hba
HBA Name: SUNW-pmcs-0
HBA Name: SUNW-pmcs-1
SunOS 5.11 Last change: 10 Jul 2009 3
System Administration Commands sasinfo(1M)
Example 2 Listing All HBAs with Details The following command lists all HBAs on the host, along withrelated details. Note that each HBA has two HBA ports con-
figured, with each HBA port connected to a storage device.# sasinfo hba -v
HBA Name: SUNW-pmcs-0
Manufacturer: sunModel: SAS Gen-2
Firmware Version: 1.1FCode/BIOS Version: 1.1
Serial Number: 111-11111
Driver Name: smvsl Driver Version: 1.1 Number of HBA Ports: 2HBA Name: SUNW-pmcs-1
Manufacturer: sunModel: SAS Gen-2
Firmware Version: 1.1FCode/BIOS Version: 1.1
Serial Number: 111-11111
Driver Name: smvsl Driver Version: 1.1 Number of HBA Ports: 2 Example 3 Listing All HBA Ports The following command lists all HBA ports on the host.# sasinfo hba-port
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1 HBA Port Name: /dev/cfg/c2HBA Name: SUNW-pmcs-1
HBA Port Name: /dev/cfg/c3 HBA Port Name: /dev/cfg/c4 Example 4 Listing all HBA Ports with Details The following command lists all HBA ports, with accompanying details.SunOS 5.11 Last change: 10 Jul 2009 4
System Administration Commands sasinfo(1M)
# sasinfo hba-port -v
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1Type: sas-device
State: online Local SAS Address: 5000c50000d756aa Attached Port SAS Address: 50800201a5a502bf Number of Phys: 4 HBA Port Name: /dev/cfg/c25000c50000d756ccType: sas-device
State: online Local SAS Address: 5000c50000d756aa Attached Port SAS Address: 50800201a5a503bf Number of Phys: 4HBA Name: SUNW-pmcs-1
HBA Port Name: /dev/cfg/c3Type: sas-device
State: online Local SAS Address: 5000c50000d756cc Attached Port SAS Address: 50800201a5a504bf Number of Phys: 4 HBA Port Name: /dev/cfg/c4Type: sas-device
State: online Local SAS Address: 5000c50000d756cc Attached Port SAS Address: 50800201a5a505bf Number of Phys: 4 Example 5 Listing phy Information for All HBA Ports The following command lists phy information for all HBA ports.# sasinfo hba-port -y
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1 Phy Information: Identifier: 0 State: enabledHardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 1 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 2
SunOS 5.11 Last change: 10 Jul 2009 5
System Administration Commands sasinfo(1M)
State: enabledHardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 3 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit HBA Port Name: /dev/cfg/c2 Phy Information: Identifier: 4 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 5 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 6 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 7 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit
HBA Name: SUNW-pmcs-1
HBA Port Name: /dev/cfg/c3 Phy Information: Identifier: 0 State: enabledHardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 1 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 2 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 3 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
SunOS 5.11 Last change: 10 Jul 2009 6
System Administration Commands sasinfo(1M)
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit HBA Port Name: /dev/cfg/c4 Phy Information: Identifier: 4 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 5 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 6 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Identifier: 7 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Example 6 Listing phy Link Error Statistics for a Specific HBA Port The following command lists phy link error statistics for a particular port.
# sasinfo hba-port -ly /dev/cfg/c1
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1 Phy Information: Identifier: 0 State: enabledHardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Link Error Statistics: Invalid Dword: 0 Running Disparity Error: 0 Loss of Dword Sync: 0 Reset Problem: 0 Identifier: 1 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
SunOS 5.11 Last change: 10 Jul 2009 7
System Administration Commands sasinfo(1M)
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Link Error Statistics: Invalid Dword: 0 Running Disparity Error: 0 Loss of Dword Sync: 0 Reset Problem: 0 Identifier: 2 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Link Error Statistics: Invalid Dword: 0 Running Disparity Error: 0 Loss of Dword Sync: 0 Reset Problem: 0 Identifier: 3 State: enabled
HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit NegotiatedLinkRate: 3Gbit Link Error Statistics: Invalid Dword: 0 Running Disparity Error: 0 Loss of Dword Sync: 0 Reset Problem: 0 Example 7 Listing Expanders Connected to an HBA Port The following command lists all expanders that are visible through the specified HBA port.
# sasinfo expander -p /dev/cfg/c1
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1 Expander SAS Address(Tier 1): 50800201a5a502bf Expander SAS Address(Tier 2): 50800201a5a50233 Expander SAS Address(Tier 2); 5000c5000d2da812 Expander SAS Address(Tier 1): 50800201a5a503bf Expander SAS Address(Tier 2): 50800201a5a502d2 Expander SAS Address(Tier 2); 5000c5000d2da823 Example 8 Listing Detailed Information on ExpandersSunOS 5.11 Last change: 10 Jul 2009 8
System Administration Commands sasinfo(1M)
The following command lists detailed information on all expanders that are visible through the specified HBA port.# sasinfo expander -v -p /dev/cfg/c1
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1 Expander SAS Address(Tier 1): 50800201a5a502bf OS Device Name: /dev/smp/expd0 State: online Expander SAS Address(Tier 2): 50800201a5a50233 OS Device Name: /dev/smp/expd2 State: online Expander SAS Address(Tier 2); 5000c5000d2da812 OS Device Name: /dev/smp/expd3 State: online Expander SAS Address(Tier 1): 50800201a5a503bf OS Device Name: /dev/smp/expd1 State: online Expander SAS Address(Tier 2): 50800201a5a502d2 OS Device Name: /dev/smp/expd3 State: online Expander SAS Address(Tier 2); 5000c5000d2da823 OS Device Name: /dev/smp/expd4 State: online Example 9 Listing Target Ports Attached to Expanders The following command lists all target ports that are attached to expanders connected to a specified HBA port.# sasinfo expander -t -p /dev/cfg/c1
HBA Name: SUNW-pmcs-0
HBA Port Name: /dev/cfg/c1 Expander SAS Address(Tier 1): 50800201a5a502bf Target Port SAS Address: 50800201a5a504f1 Expander SAS Address(Tier 2): 50800201a5a50233 Target Port SAS Address: 50800201a5a502be Target Port SAS Address: 5000c5000d2da8b2 Expander SAS Address(Tier 2); 5000c5000d2da812 Target Port SAS Address: 50800201a5a502be Target Port SAS Address: 50800201a5a508b2 Expander SAS Address(Tier 1): 50800201a5a503bf Target Port SAS Address: 50800201a5a50421 Expander SAS Address(Tier 2): 50800201a5a502d2 Target Port SAS Address: 50800201a5a503be Target Port SAS Address: 5000c5000d2da7be Expander SAS Address(Tier 2); 5000c5000d2da823SunOS 5.11 Last change: 10 Jul 2009 9
System Administration Commands sasinfo(1M)
Target Port SAS Address: 50800201a5a503be Target Port SAS Address: 5000c5000d2da7be Example 10 Listing Target Port Information The following command lists all target ports discovered on the host.# sasinfo target-port
Target Port SAS Address: 5000c5000bae4009 Target Port SAS Address: 5000c5000baef4b1 Target Port SAS Address: 5000c5000bae3fe1 Target Port SAS Address: 5000c5000bae49d9 Target Port SAS Address: 5000c5000bae36c5 Example 11 Listing Target Port Information with Topology Details The following command lists all target ports with the HBA port and expander that they are connected to.# sasinfo target-port -v
Target Port SAS Address: 5000c5000bae4009 Type: SAS Device HBA Port Name: /dev/cfg/c7 Expander Device SAS Address: 500e004aaaaaaa3f HBA Port Name: /dev/cfg/c5 Expander Device SAS Address: 500e004aaaaaaa3f Target Port SAS Address: 5000c5000baef4b1 Type: SAS Device HBA Port Name: /dev/cfg/c7 Expander Device SAS Address: 500e004aaaaaaa3f HBA Port Name: /dev/cfg/c5 Expander Device SAS Address: 500e004aaaaaaa3f Target Port SAS Address: 5000c5000bae3fe1 Type: SAS Device HBA Port Name: /dev/cfg/c7 Expander Device SAS Address: 500e004aaaaaaa3f HBA Port Name: /dev/cfg/c5 Expander Device SAS Address: 500e004aaaaaaa3f Target Port SAS Address: 5000c5000bae49d9 Type: SAS Device HBA Port Name: /dev/cfg/c7 Expander Device SAS Address: 500e004aaaaaaa3fSunOS 5.11 Last change: 10 Jul 2009 10
System Administration Commands sasinfo(1M)
HBA Port Name: /dev/cfg/c5 Expander Device SAS Address: 500e004aaaaaaa3f Target Port SAS Address: 5000c5000bae36c5 Type: SAS Device HBA Port Name: /dev/cfg/c7 Expander Device SAS Address: 500e004aaaaaaa3f HBA Port Name: /dev/cfg/c5 Expander Device SAS Address: 500e004aaaaaaa3f Example 12 Listing Target Ports with SCSI InformationThe following command lists all target port details, includ-
ing SCSI information for each target port.# sasinfo target-port -s 5000c5000bae4009
Target Port SAS Address: 5000c5000bae4009 Type: SAS Device HBA Port Name: /dev/cfg/c7 Expander Device SAS Address: 500e004aaaaaaa3f LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2 Vendor: Sun Product: J4400 Device Type: Disk HBA Port Name: /dev/cfg/c5 Expander Device SAS Address: 500e004aaaaaaa3f LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2 Vendor: Sun Product: J4400 Device Type: Disk Example 13 Listing the Logical Units The following command lists the logical units on a host.# sasinfo logical-unit
OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2 OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2 Example 14 Listing Additional Information on Logical UnitsSunOS 5.11 Last change: 10 Jul 2009 11
System Administration Commands sasinfo(1M)
The following command displays additional logical unitinformation using the -v option for device /dev/rmt/On.
# sasinfo lu -v
OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2 HBA Port Name: /dev/cfg/c1 Target Port SAS Address: 50020f2300b4904e LUN: 0 Vendor: Sun Product: J4400 Device Type: Disk OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2 HBA Port Name: /dev/cfg/c1 Target Port SAS Address: 50020f230063100b LUN: 0 Vendor: Sun Product: J4400 Device Type: DiskATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | system/storage/sasinfo |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
SEE ALSO
attributes(5)SunOS 5.11 Last change: 10 Jul 2009 12