System Administration Commands sasinfo(1M) NAME sasinfo - Serial Attached SCSI HBA Port Command Line Interface SYNOPSIS sasinfo hba-port [-lvy] [HBA_port_SAS_Addr]... sasinfo remote-port [-sv] [-p HBA_port_SAS_Addr] [REMOTE_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-port Lists information for the HBA port referenced by the specified HBA_port_SAS_Addr. If HBA_port_SAS_Addr is not specified, all HBA ports on the host will be listed. remote-port Lists the remote-port information for those remote ports that are specified. If no REMOTE_port_SAS_Addr is specified, all remote ports that are visible through the given HBA_port_SAS_Addr are listed. If no argument is specified, all remote ports that are visible across all HBA port 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 Mangement Protocol(SMP) target port. OPTIONS The following options are supported: -l, --phy-linkstat Lists the link error statistics information for the phys on the HBA port referenced by the specified HBA_port_SAS_Addr 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_SAS_Addr or all HBA ports if no HBA port is specified. This option is used only with hba-port. -p HBA_port_SAS_Addr, --port HBA_port_SAS_Addr Retrieve remote port information from the HBA_port_SAS_Addr of the local HBA port on the host. The -p option can only be used with the remote-port subcommand. -s, --os-device Lists the OS device information including SCSI attributes for SCSI targets for all remote ports the user has asked for. This option is only used for the remore-port subcommand. The remote ports are selected based on the specified HBA port through the -p option and/or given remote port arguments. -v, --verbose When used with the hba-port subcommand, the -v displays details of the HBA port including hardware information and associated driver information. When used with the remote-port subcommand, the -v option displays details on remote port including vendor, product information and device type. -V, --version Displays the version information. -?, --help Displays the usage information. EXAMPLES Example 1 Listing All HBA Ports The following command lists all initiator mode fibre channel HBA ports on the host: # sasinfo hba-port HBA Port SAS Address: 5000c50000d756aa HBA Port SAS Address: 5000c50000d756cc HBA Port SAS Address: 5000c50000d756ee HBA Port SAS Address: 5000c50000d75600 Example 2 Listing all HBA Ports with details. # sasinfo hba-port -v HBA Port SAS Address: 5000c50000d756aa OS Device Name: smvsl 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 Type: sas-device State: online HBA Port SAS Address: 5000c50000d756cc OS Device Name: smvsl Manufacturer: sun Model: SAS Gen-2 Model: pseudo Firmware Version: 1.1 FCode/BIOS Version: 1.1 Serial Number: 111-11111 Driver Name: smvsl Driver Version: 1.1 Type: sas-device State: online HBA Port SAS Address: 5000c50000d756ee OS Device Name: smvsl 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 Type: sas-device State: online HBA Port SAS Address: 5000c50000d75600 OS Device Name: smvsl 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 Type: sas-device State: online Example 3 Listing phy information for all HBA ports. # sasinfo hba-port -y HBA Port SAS Address: 5000c50000d756aa 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 SAS Address: 5000c50000d756cc 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 SAS Address: 5000c50000d756ee 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 SAS Address: 5000c50000d75600 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 4 Listing phy link error statistics for a specific HBA port. # sasinfo hba-port -ly 5000c50000d756aa HBA Port SAS Address: 5000c50000d756aa 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 4 Listing Remote Ports connected to a HBA port The following command lists all remote ports that are visi- ble through the given HBA port: # sasinfo remote-port -p 5000c50000d756aa HBA Port SAS Address: 5000c50000d756aa Remote Port SAS Address: 50020f230000b4af Remote Port SAS Address: 50020f2300b4904e Remote Port SAS Address: 50020f230063100b Remote Port SAS Address: 50020f230032014a Example 5 Listing detail information of Remote Ports connected to a HBA port: # sasinfo remote-port -v -p 5000c50000d756aa HBA Port SAS Address: 5000c50000d756aa Remote Port SAS Address: 50020f230000b4af Type: SMP device Attached SAS Address: 5000c50000d756aa Remote Port SAS Address: 50020f2300b4904e Type: SAS device Attached SAS Address: 50020f230000b4af Remote Port SAS Address: 50020f230063100b Type: SAS device Attached SAS Address: 50020f230000b4af Remote Port SAS Address: 50020f230032014a Type: SAS device Attached SAS Address: 50020f230000b4af Example 6 Listing All OS Device Information The following command lists all remote ports as well as OS device inforamtion along with scsi-target information if applicable: # sasinfo remote-port -sv -p 5000c50000d756aa HBA Port SAS Address: 5000c50000d756aa Remote Port SAS Address: 50020f230000b4af Type: SMP device Attached SAS Address: 5000c50000d756aa OS Device Name: /dev/smp/expd0 Remote Port SAS Address: 50020f2300b4904e Type: SAS device Attached SAS Address: 50020f230000b4af OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2 Vendor: Sun Product: J4400 Device Type: Disk LUN: 0 Remote Port SAS Address: 50020f230063100b Type: SAS device Attached SAS Address: 50020f230000b4af OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2 Vendor: Sun Product: J4400 Device Type: Disk LUN: 0 Remote Port SAS Address: 50020f230032014a Type: SAS device Attached SAS Address: 50020f230000b4af OS Device Name: /dev/rdsk/c4t50020F230032014Ad0s2 Vendor: Sun Product: J4400 Device Type: Disk LUN: 0 Example 7 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 OS Device Name: /dev/rdsk/c4t50020F230032014Ad0s2 Example 8 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 SAS Address: 5000c50000d756aa Remore Port SAS Address: 50020f2300b4904e LUN: 0 Vendor: Sun Product: J4400 Device Type: Disk OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2 HBA Port SAS Address: 5000c50000d756aa Remore Port SAS Address: 50020f230063100b LUN: 0 Vendor: Sun Product: J4400 Device Type: Disk OS Device Name: /dev/rdsk/c4t50020F230032014Ad0s2 HBA Port SAS Address: 5000c50000d756aa Remore Port SAS Address: 50020f230032014a 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)