用法概要

sasinfo

- Serial Attached SCSI HBA 端口命令行接口

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 [-?]

描述

sasinfo 实用程序是一个命令行接口，用于收集有关支持存储管理 HBA API (Storage Management HBA API, SM-HBA) 的 Serial Attached SCSI–2 (SAS–2) 主机总线适配器 (host bus adapter, HBA) 的管理信息。此实用程序报告 HBA 端口和扩展器设备的属性，以及可以连接到那些 HBA 端口的 SCSI 目标设备。

sasinfo 是作为一组子命令实现的，如下所述。

子命令

sasinfo 支持下列子命令。

hba: 列出指定的 HBA_name 所指的 HBA 的信息。如果未指定 HBA_name，则会列出主机上的所有 HBA。
hba-port: 列出指定的 HBA_port_Name 所指的 HBA 端口的信息。如果未指定 HBA_port_Name，则会列出主机上的所有 HBA 端口。请注意，HBA 端口可以动态配置/取消配置，因此，HBA 上的 HBA 端口数量可能会随着与目标设备的连接的建立而改变。如果未建立与存储设备的连接，则不会配置 HBA 端口。
expander: 列出指定的 Expander_SAS_Addr 所指的扩展器的分层视图。如果未指定任何参数，则会列出在主机的所有 HBA 端口上可见的所有扩展器。
target-port: 列出指定的 Target_port_SAS_Addr 地址所指的那些目标端口的信息。如果未指定任何参数，则会列出在主机上可见的所有目标端口。
logical-unit | lu: 列出指定的 device_path 所指的逻辑单元。如果未指定 device_path，则会列出所有 SAS 逻辑单元，包括 SAS 管理协议 (SAS Management Protocol, SMP) 目标端口。

选项

支持以下选项。

-?, --help: 显示用法信息
-a、--hba HBA_Name: 通过主机上的 HBA 的 HBA_Name 检索 HBA 端口信息。-a 选项仅可与 hba-port 子命令一起使用。
-l、--phy-linkstat: 为指定的 HBA_port_Name 所指的 HBA 端口或所有 HBA 端口（如果未指定 HBA 端口）上的 phy 列出链路错误统计信息。此选项仅可与 hba-port 子命令一起使用。
-p HBA_port_SAS_Addr、--port HBA_port_SAS_Addr: 通过主机上的本地 HBA 端口的 HBA_port_SAS_Addr 检索远程端口信息。-p 选项仅可与 expander 子命令一起使用。
-s、--scsi: 列出请求显示的目标端口的 SCSI 属性。此选项仅可用于 target-port 子命令。
-v、--verbose: 根据所调用的子命令显示硬件的详细信息，例如 SAS 地址、拓扑设备，等等。
-V、--version: 显示版本信息。
-y、--phy: 列出 HBA_port_Name 指定的 HBA 端口或所有 HBA 端口（如果未指定 HBA 端口）上的 phy 信息。此选项仅可与 hba-port 子命令一起使用。

示例

示例 1 列出所有 HBA

以下命令列出主机上的所有 HBA。

# sasinfo hba
HBA Name: SUNW-pmcs-0
HBA Name: SUNW-pmcs-1

示例 2 详细列出所有 HBA

以下命令列出主机上的所有 HBA，并包括相关详细信息。请注意，每个 HBA 配置有两个 HBA 端口，每个 HBA 端口连接到一个存储设备。

# sasinfo hba -v
HBA Name: SUNW-pmcs-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-pmcs-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

示例 3 列出所有 HBA 端口

以下命令列出主机上的所有 HBA 端口。

# sasinfo hba-port
HBA Name: SUNW-pmcs-0
    HBA Port Name: /dev/cfg/c1
    HBA Port Name: /dev/cfg/c2
HBA Name: SUNW-pmcs-1
    HBA Port Name: /dev/cfg/c3
    HBA Port Name: /dev/cfg/c4

示例 4 详细列出所有 HBA 端口

以下命令列出主机上的所有 HBA 端口，并包括相关详细信息。

# sasinfo hba-port -v
HBA Name: SUNW-pmcs-0
    HBA Port Name: /dev/cfg/c1
        Type: sas-device
        State: online
        Local SAS Address: 5000c50000d756aa
        Attached Port SAS Address: 50800201a5a502bf
        Number of Phys: 4
    HBA Port Name: /dev/cfg/c25000c50000d756cc
        Type: sas-device
        State: online
        Local SAS Address: 5000c50000d756aa
        Attached Port SAS Address: 50800201a5a503bf
        Number of Phys: 4
HBA Name: SUNW-pmcs-1
    HBA Port Name: /dev/cfg/c3
        Type: sas-device
        State: online
        Local SAS Address: 5000c50000d756cc
        Attached Port SAS Address: 50800201a5a504bf
        Number of Phys: 4
    HBA Port Name: /dev/cfg/c4
        Type: sas-device
        State: online
        Local SAS Address: 5000c50000d756cc
        Attached Port SAS Address: 50800201a5a505bf
        Number of Phys: 4

示例 5 列出所有 HBA 端口的 phy 信息

以下命令列出所有 HBA 端口的 phy 信息。

# sasinfo hba-port -y
HBA Name: SUNW-pmcs-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
         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
           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: 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
         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
           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

示例 6 列出特定 HBA 端口的 phy 链路错误统计信息

以下命令列出一个特定端口的 phy 链路错误统计信息。

# sasinfo hba-port -ly /dev/cfg/c1
HBA Name: SUNW-pmcs-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
         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
       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

示例 7 列出连接到 HBA 端口的扩展器

以下命令列出在指定 HBA 端口上可见的所有扩展器。

# 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

示例 8 列出扩展器的详细信息

以下命令列出在指定 HBA 端口上可见的所有扩展器的详细信息。

# 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

示例 9 列出连接到扩展器的目标端口

以下命令列出连接到指定 HBA 端口的扩展器上连接的所有目标端口。

# 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); 5000c5000d2da823
            Target Port SAS Address: 50800201a5a503be
            Target Port SAS Address: 5000c5000d2da7be

示例 10 列出目标端口信息

以下命令列出在主机上搜索到所有目标端口。

# 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

示例 11 列出包括拓扑详细信息在内的目标端口信息

以下命令列出所有目标端口以及它们所连接到的 HBA 端口和扩展器。

# 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

示例 12 列出目标端口及其 SCSI 信息

以下命令列出所有目标端口详细信息，包括每个目标端口的 SCSI 信息。

# 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

示例 13 列出逻辑单元

以下命令列出主机上的逻辑单元。

# sasinfo logical-unit
OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2

示例 14 列出逻辑单元的其他信息

以下命令使用 -v 选项列出设备 /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(5)：

属性类型	属性值
可用性	system/storage/sas-utilities
接口稳定性	Committed（已确定）

另请参见

attributes(5)

跳过导航链接
退出打印视图
	手册页第 1M 部分：系统管理命令 Oracle Solaris 11 Information Library (简体中文)