System Administration Commands sasinfo(1M) NAME sasinfo - Serial Attached SCSI HBA Port Command Line Interface SYNOPSIS sasinfo hba [-v] [HBA_Name]... sasinfo hba-port [-lvy] [-a HBA_Name] [HBA_port_Name]... sasinfo expander [-vt] [-p HBA_port_Name] [Expander_SAS_Addr]... sasinfo target-port [-sv] [Target_port_SAS_Addr]... sasinfo logical-unit | lu [-v] [OS device_path]... sasinfo [-V] sasinfo [-?] DESCRIPTION sasinfo is a command line interface that collect administra- tive information on Serial Attached SCSI(SAS) host bus adapter (HBA) ports on a host. They also collect data on SCSI target devices that might be connected to those ports. SUBCOMMANDS The following subcommands are supported by sasinfo: hba Lists information for the HBA referenced by the specified HBA_Name. If no HBA_Name is specified, all HBA on the host will be listed. hba-port Lists information for the HBA port referenced by the specified HBA_Port_Name. If no argument is specified, all HBA ports on the host will be listed. expander Lists hierarchical view of the expander referenced by the specified Expander SAS address. If no argument is specified, all expanders that are visible across all HBA port on the host will be listed. target-port Lists information for those target ports referenced by Target SAS address. If no argument is specified, all target ports that are visible on the host will be listed. logical-unit | lu Lists the logical unit referenced by the specified device_path. If device_path is not specified, all SAS logical units will be listed including SAS Management Protocol(SMP) target port. OPTIONS The following options are supported: -a HBA_Name, --hba HBA_Name Retrieve hba port port information from the HBA_Name of an HBA on the host. The -p 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 specified HBA_Port_Name or all HBA ports if no HBA port is specified. This option is used only with hba-port. -y, --phy Lists the phy information on HBA port reference by the specified HBA_Port_Name or all HBA ports if no HBA port is specified. This option is used only with hba-port. -p HBA_Port_Name, --hba-port HBA_Port_Name Retrieve expander information from the HBA_Port_Name of the local HBA port on the host. The -p option can only be used with the expander subcommand. -t, --target-port Retrieve target ports. The -t option can only be used with the expander subcommand and displays all targets attached to an expander device. -s, --scsi Lists SCSI attributes for target ports that are requested to display. This option is only used for the target-port subcommand. -v, --verbose Display details on hardware information, attached SAS address, topology device etc. based on a subcommand. -V, --version Displays the version information. -?, --help Displays the usage information. EXAMPLES Example 1 Listing All HBA The following command lists all HBAs on the host: # sasinfo hba HBA Name: SUNW-pmc-0 HBA Name: SUWN-pmc-1 Example 2 Listing all HBA with details. # sasinfo hba-port -v HBA Name: SUNW-pmc-0 Manufacturer: sun Model: SAS Gen-2 Firmware Version: 1.1 FCode/BIOS Version: 1.1 Serial Number: 111-11111 Driver Name: smvsl Driver Version: 1.1 Number of HBA Ports: 2 HBA Name: SUNW-pmc-1 Manufacturer: sun Model: SAS Gen-2 Firmware Version: 1.1 FCode/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-pmc-0 HBA Port SAS Address: /dev/cfg/c1 HBA Port SAS Address: /dev/cfg/c2 HBA Name: SUWN-pmc-1 HBA Port SAS Address: /dev/cfg/c3 HBA Port SAS Address: /dev/cfg/c4 Example 4 Listing all HBA Ports with details. # sasinfo hba-port -v HBA Name: SUNW-pmc-0 HBA Port Name: /dev/cfg/c1 Type: sas-device State: online Local SAS Address: 5000c50000d756aa Attached Port SAS Address: 50800201a5a502bf HBA Port Name: /dev/cfg/c25000c50000d756cc Type: sas-device State: online Local SAS Address: 5000c50000d756aa Attached Port SAS Address: 50800201a5a503bf HBA Name: SUNW-pmc-1 HBA Port Name: /dev/cfg/c3 Type: sas-device State: online Local SAS Address: 5000c50000d756cc Attached Port SAS Address: 50800201a5a504bf HBA Port Name: /dev/cfg/c4 Type: sas-device State: online Local SAS Address: 5000c50000d756cc Attached Port SAS Address: 50800201a5a505bf Example 5 Listing phy information for all HBA ports. # sasinfo hba-port -y HBA Name: SUNW-pmc-0 HBA Port Name: /dev/cfg/c1 Phy Information: Identifier: 0 State: enabled HardwareLinkRate(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 HBA Port Name: /dev/cfg/c2 Phy Information: Identifier: 0 State: enabled HardwareLinkRate(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 HBA Name: SUNW-pmc-1 HBA Port Name: /dev/cfg/c3 Phy Information: Identifier: 0 State: enabled HardwareLinkRate(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 HBA Port Name: /dev/cfg/c4 Phy Information: Identifier: 0 State: enabled HardwareLinkRate(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 Example 6 Listing phy link error statistics for a specific HBA port. # sasinfo hba-port -ly /dev/cfg/c1 HBA Name: SUNW-pmc-0 HBA Port SAS Address: /dev/cfg/c1 Phy Information: Identifier: 0 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: 1 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 a HBA port The following command lists all expanders that are visi- ble through the given HBA port: # sasinfo expander -p /dev/cfg/c1 HBA Name: SUNW-pmc-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 detail information of expanders connected to a HBA port: # sasinfo expander -v -p /dev/cfg/c1 HBA Name: SUNW-pmc-0 HBA Port SAS Address: /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 that are attached to expanders connected to a HBA port: # sasinfo expander -t -p /dev/cfg/c1 HBA Name: SUNW-pmc-0 HBA Port SAS Address: /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); 5000c5000d2da823 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 target centric topology details. The following command lists all target ports with an hba-port and an 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: 500e004aaaaaaa3f 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 information along with target centric topology. . The following command lists all target port details including SCSI informations on each target port. # sasinfo target-port -s Target Port SAS Address: 5000c5000bae4009 LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2 Vendor: Sun Product: J4400 Device Type: Disk Target Port SAS Address: 5000c5000baef4b1 LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAEF4B3d0s2 Vendor: Sun Product: J4400 Device Type: Disk Target Port SAS Address: 5000c5000bae3fe1 LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAE3FE3d0s2 Vendor: Sun Product: J4400 Device Type: Disk Target Port SAS Address: 5000c5000bae49d9 LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAE49DBd0s2 Vendor: Sun Product: J4400 Device Type: Disk Target Port SAS Address: 5000c5000bae36c5 LUN : 0 OS Device Name : /dev/rdsk/c6t5000C5000BAE36C7d0s2 Vendor: Sun Product: J4400 Device Type: Disk Example 13 Listing the Logical Unit The following command lists the logical unit: # sasinfo logical-unit OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2 OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2 Example 14 Displaying Additional Information for the Logical Unit The following command displays additional information about the logical unit 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: Disk ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWsmhba | |_____________________________|_____________________________| | Interface Stability | Committed | |_____________________________|_____________________________| SEE ALSO attributes(5)