Go to main content

手册页部分 8:系统管理命令

退出打印视图

更新时间: 2022年7月27日 星期三
 
 

hotplug(8)

名称

hotplug - 配置热插拔连接器和端口

用法概要

hotplug list [-c] [-d] [-l] [-v] [path [connection]]
hotplug online path port
hotplug offline [-f] [-q] [-r] path port
hotplug enable [-f] [path] connector
hotplug disable [-f] [-q] [-r] [path] connector
hotplug poweron [path] connector
hotplug poweroff [-f] [-q] [-r] [path] connector
hotplug set -o options [path] connector
hotplug get -o options [path] connector
hotplug install path port
hotplug uninstall [-f] [-q] [-r] path port
hotplug -?

描述

hotplug 命令用于管理热插拔连接。连接可以是连接器或端口。热插拔连接器表示系统中的一个物理点,在此处可以插入或移除组件。热插拔端口表示系统设备树中的一个的逻辑点,在此处可以管理设备与系统之间的连接。

hotplug 命令仅支持在特定热插拔连接器上执行热插拔操作,即实施标准 PCI 热插拔功能的 PCI Express 总线和 PCI 总线上的热插拔连接器。还支持系统中采用 PCI Express 光纤结构的 PCI Express 总线和 PCI 总线上的热插拔端口。今后可能会支持其他总线。

可以对以下对象类型运行 hotplug 命令:

path

热插拔连接器和端口已集成到 Solaris 设备树中。连接器和端口名称仅在其总线控制器范围内是唯一的。要唯一地引用连接器,需要指定设备路径;要唯一地引用端口,需要指定设备的父路径。

hotplug 命令可以接受以下使用方式:用户在状态更改操作子命令中仅指定了物理热插拔连接器。如果不存在此类连接器,该命令将失败。如果系统中存在同名的多个连接器,状态更改操作将与用户交互,以确定需要在哪一个连接器上执行操作。请参见下文的“示例”部分。

connector

如果某硬件组件支持物理插入或移除,那么热插拔连接器代表了可以执行此操作的位置。如果连接器存在,它即具有依赖于它的端口和设备节点分层结构。

port

可以对所有设备节点执行虚拟热插拔操作,即使其硬件不支持物理热插拔也是如此。在系统设备树中,热插拔端口存在于设备节点与其父节点之间。它代表可以管理设备节点及其依赖项的位置。

connection

热插拔连接是一个用于指代热插拔连接器或热插拔端口的通用术语。

热插拔连接器和端口根据状态模型进行管理。hotplug 命令可以列出关于系统中热插拔连接的信息,也可以在特定热插拔连接上启动状态更改操作。

热插拔连接器可具有以下状态:

empty(空)

从物理上而言,组件未插入连接器。

present(存在)

从物理上而言,组件已插入连接器,但组件处于断电状态。组件未在使用。

powered(通电)

从物理上而言,组件已插入连接器,并且组件处于通电状态。但组件处于禁用状态并且未在使用。

enabled(已启用)

从物理上而言,组件已插入连接器。组件处于通电状态并且已经过探测和测试。而且组件处于启用状态,代表其功能的设备可以使用。

热插拔端口可具有以下状态:

port-empty(端口空)

热插拔端口不存在任何设备。

port-present(端口存在)

热插拔端口存在设备,但是设备尚未经过探测并且没有关联的设备驱动程序。设备未在使用。

offline(脱机)

热插拔端口存在设备,并且设备已经过探测。但未关联设备驱动程序,并且设备未在使用。

online(联机)

热插拔端口存在设备,并且已完整关联其设备驱动程序。而且设备在使用中。

maintenance(维护)

热插拔端口存在设备,并且已完整关联其设备驱动程序。设备在使用中,但是无法完全正常运行。维护或故障管理操作影响了设备。导致设备进入维护状态的原因不尽相同。维护状态下的子状态说明了原因。目前仅定义了一种子状态:

maintenance-suspended(维护暂停)

设备暂停。

hotplug 命令还可以访问每个热插拔连接器的总线专用属性。可以显示总线专用属性的当前值。可以直接为每个总线专用属性设置新值。

子命令

支持以下子命令:

list

显示关于热插拔连接器、端口及其关联设备的信息。由于热插拔连接器和热插拔端口已集成到 Solaris 设备树分层结构中。因此,list 子命令还显示设备节点的分层结构以及热插拔连接器和热插拔端口位置等其他信息。热插拔连接器的名称括在方括号中,热插拔端口的名称括在尖括号中。每个热插拔连接的当前状态在其名称旁边显示。

online

将热插拔端口的状态更改为 online 状态。

offline

将热插拔端口的状态更改为 offline 状态。

enable

将热插拔连接器的状态更改为 enabled 状态。将自动对所有热插拔连接器的依赖端口进行探测并将其初始化为 online 状态。

如果在探测连接的设备时出现硬件错误,则系统会将错误详细信息报告至 Solaris Fault Manager 以供诊断。可以通过强制操作忽略错误(使用 –f 选项),能否这样操作取决于具体错误类型。

disable

将热插拔连接器的状态从 enabled 状态更改为 powered 状态。处于 online 状态的所有依赖端口将首先转换到 port-present 状态。

poweron

将热插拔连接器的状态从 present 状态更改为 powered 状态。

poweroff

将热插拔连接器的状态从 poweredenabled 状态更改为 present 状态。处于 online 状态的所有依赖端口将首先转换到 port-present 状态,然后将被删除。

set

为热插拔连接器设置特定于总线的属性。指定的选项字符串是一个特定于总线的字符串,由名称和值对组成,可以通过 getsubopt(3C) 进行解析。名称和值将直接传递给管理指定热插拔连接器的总线控制器,以执行特定于总线的功能。

get

显示热插拔连接器的特定于总线的属性的当前值。指定的选项字符串是一个特定于总线的字符串,由指定属性组成,可以通过 getsubopt(3C) 进行解析。名称将直接传递给总线控制器,以指定应返回哪些属性。然后,将显示每个指定属性的当前值。

installuninstall 子命令可安装和卸载端口的驱动程序所支持的服务。

install

install 子命令可安装热插拔端口设备的驱动程序所支持的服务。

例如,该子命令可以应用到 PCIe IO 虚拟化设备的物理功能端口。它将端口升级到 ONLINE 状态(如果端口尚未处于该状态),然后安装物理功能(驱动程序)所支持的虚拟功能。将创建新的热插拔端口,以代表作为指定物理功能的依赖项的每个虚拟功能。新创建的端口将启动为 OFFLINE 状态。

uninstall

uninstall 子命令可卸载热插拔端口设备的驱动程序所支持的服务。

该子命令可以应用到 PCIe IO 虚拟化设备的物理功能端口。如果指定的热插拔端口具有任何包含虚拟功能的依赖端口,则将删除这些依赖端口和相应的虚拟功能节点。

选项

支持以下选项:

–l–-list-path

显示连接和设备节点的完整路径。缺省情况下,list 子命令以树形式显示热插拔连接器、端口和设备。该选项支持显示每个连接和设备节点的完整路径。

–c–-connectors

显示一个表格,其中汇总了所有物理热插拔连接器的当前状态。但不包括设备拓扑和分层结构信息。一般而言,物理热插拔连接器的名称应该是唯一的。如果系统中存在同名的多个连接器,hotplug 将显示一条消息,指出同名的热插拔连接器,并提示您输入信息对这些连接器进行区分。请参见下文的“示例”部分。

–d–-drivers

显示绑定驱动程序的名称和设备节点的实例数量。缺省情况下,list 子命令仅显示热插拔连接器、端口和设备。该选项支持显示绑定驱动程序的名称和设备节点的实例数量。

–v–-verbose

显示详细的使用情况信息。缺省情况下,list 子命令仅显示热插拔连接器、端口和设备。该选项支持显示关于当前设备使用情况的详细信息。例如,与各个设备相关联的已挂载的文件系统或已激活的网络接口。

请注意,–v 选项不显示关于 ZFS 控制下的磁盘的信息。

–f–-force

强制执行操作。一些会影响当前正在使用的资源的更改状态操作将失败,并显示警告。强制执行的操作会试图忽略这些警告并继续。

请慎用此选项。

–n, –-non-interactive

禁用交互功能。如果指定了该标志并且输入不明确,则该命令将立即退出,并返回一个唯一的退出状态来指出问题。

–q, –-query

Query the operation.执行一个测试来预测更改状态操作是成功还是失败,而不是实际执行操作。如果失败,则显示实际尝试该操作时会显示的错误消息。

不可能预测出每一种失败。对于在查询期间报告能成功执行的操作,在实际尝试时仍然可能会出于其他原因而失败。

该选项实际上并不会更改系统的状态。

–r, –-removed

Resources are removed.This uses extreme force to change the state of a hotplug connector or hotplug port.The assumption is that the connected devices are removed from the system and failure is not an option.

If impacted resources are currently in use, the usage will be forcibly terminated.This is different from the –f option which could still fail if an operation impacts critical resources.There can be negative consequences to the system and running applications with this option, so it must be used with extreme caution.

This option is not compatible with the –q option.

–o options, –-=options

针对 setget 命令指定特定于总线的属性。选项字符串遵循 getsubopt(3C) 语法约定。

对于 get 子命令,有两个特殊选项可以使用。help 特殊选项值将显示所有支持的属性及其可能值。all 特殊选项值将显示所有支持的属性的当前值。

对于 set 子命令,有一个特殊选项可以使用。help 特殊选项值将显示可以设置的所有支持的属性及其可能值。

有关总线控制器支持的属性,请参见“附注”部分。

–?, –-help

显示关于正确使用命令的简短帮助信息。

示例

示例 1 显示所有热插拔连接

以下命令可显示所有热插拔连接:

# hotplug list -v
pci@0,0
pci108e,534a@2,1 <pci.2,1> ONLINE
        [pci30] EMPTY
pci10de,5d@e <pci.e,0> ONLINE
        display@b <pci.b,0> ONLINE
        [NEM0] ENABLED
        pci108e,534a@a,0 <pci.a,0> ONLINE
                { Network interface nge0 }
                { nge0: hosts IP addresses: 10.0.0.1 }
        pci108e,534a@a,1 <pci.a,1> (MAINTENANCE)
                            [NEM1] (EMPTY)
pci108e,534a@c <pci.c,0> OFFLINE
pci108e,534a@d <pci.d,0> ONLINE
                          pci1028,40d@0 <pci.0,0> (MAINTENANCE-SUSPENDED,
"activities=dma+pio+intr,reason=resource-rebalance")
                                 { Network interface bge0 }
                                 { bge0: hosts IP addresses: 10.0.1.1 }

要显示热插拔连接和设备的完整路径,请输入以下命令:

# hotplug list -l
/pci@0,0
/pci@0,0  <pci.0,0>  OFFLINE
/pci@0,0/pci108e,4341
/pci@0,0  <pci.1,0>  OFFLINE
/pci@0,0/pci8086,3408
/pci@0,0  <pci.3,0>  ONLINE
/pci@0,0/pci8086,340a@3
/pci@0,0/pci8086,340a@3 [Slot2]  EMPTY
/pci@0,0  <pci.5,0>  ONLINE
/pci@0,0/pci8086,340c@5
/pci@0,0/pci8086,340c@5 [Slot1]  ENABLED
/pci@0,0/pci8086,340c@5  <pci.0,0>  ONLINE
/pci@0,0/pci8086,340c@5/pci111d,8018@0
/pci@0,0  <pci.7,0>  ONLINE
/pci@0,0/pci8086,340e@7
/pci@0,0/pci8086,340e@7 [pcie4]  ENABLED
/pci@0,0  <pci.9,0>  ONLINE
/pci@0,0/pci8086,3410@9
/pci@0,0/pci8086,3410@9 [pcie3]  ENABLED
/pci@0,0  <pci.13,0>  OFFLINE
/pci@0,0/pci8086,342d
/pci@0,0  <pci.14,0>  OFFLINE
/pci@0,0/pci8086,342e

要显示绑定驱动程序名称和设备的实例数,请输入以下命令:

# hotplug list -d
pci@0,0  npe#0
    pci108e,4341  <pci.0,0>  OFFLINE  #0
    pci8086,3408  <pci.1,0>  OFFLINE  pcieb#0
    pci8086,340a@3  <pci.3,0>  ONLINE  pcieb#1
        [Slot2]  EMPTY
    pci8086,340c@5  <pci.5,0>  ONLINE  pcieb#2
        [Slot1]  ENABLED
        pci111d,8018@0  <pci.0,0>  ONLINE  pcieb#0
            pci111d,8018@2  <pci.2,0>  ONLINE  pcieb#6
                pci108e,f1bc@0  <pci.0,0>  ONLINE  e1000g#0
                pci108e,f1bc@0,1  <pci.0,1>  OFFLINE  e1000g#1
    pci8086,340e@7  <pci.7,0>  ONLINE  pcieb#3
        [pcie4]  ENABLED
    pci8086,3410@9  <pci.9,0>  ONLINE  pcieb#4
        [pcie3]  ENABLED
    pci8086,342d  <pci.13,0>  OFFLINE  #0
    pci8086,342e  <pci.14,0>  OFFLINE  #0

要显示所有物理热插拔连接器的状态,请输入以下命令:

# hotplug list -c
Connection             State         Description
---------------------------------------------------------
NEM0                   ENABLED       PCIe-Native
PCI-EM0                ENABLED       PCIe-Native
NEM1                   ENABLED       PCIe-Native
PCI-EM1                ENABLED       PCIe-Native

系统中存在同名的多个连接器的情况下显示的表格:

# hotplug list -c
Connection   Note      State         Description
----------------------------------------------------------
NEM0                   ENABLED       PCIe-Native
PCI-EM0      *1        ENABLED       PCIe-Native
PCI-EM0      *2        ENABLED       PCIe-Native
NEM1                   ENABLED       PCIe-Native

Note:
Multiple connectors with the same name exist:

  [1] PCI-EM0   /pci@0,0/pci108e,4341@1a,2
  [2] PCI-EM0   /pci@1,0/pci108e,4341@1a,2

示例 2 在执行状态更改操作期间报告失败

如果状态更改操作失败,系统将显示一条解释,对失败进行说明。尝试使带有系统当前正在使用的依赖设备的热插拔端口脱机可能会失败,如下所示:

# hotplug offline /pci@0,0/pci10de,5d@e pci.a,0
ERROR: devices or resources are busy.
pci108e,534a@a,0:
    { Network interface nge0 }
    { nge0: hosts IP addresses: 10.0.0.1 }
    { Plumbed IP Address }
示例 3 在执行状态更改操作期间启用用户交互

如果系统中存在同名的多个连接器,状态更改操作将与用户交互,以便用户指定需要在哪一个连接器上执行操作。

# hotplug enable PCI-EM0
Multiple connectors with the same name exist:

   [1] PCI-EM0  /pci@0,0/pci108e,4341@1a,2
   [2] PCI-EM0  /pci@1,0/pci108e,4341@1a,2

Please select a connector, then press ENTER:
示例 4 显示特定于总线的属性和值

以下命令可显示所有支持的特定于总线的属性及其可能值:

# hotplug get -o help /pci@0,0 pci.2,1
power_led=<on|off|blink>
fault_led=<on|off|blink>
active_led=<on|off|blink>
attn_led=<on|off|blink>
card_type=<type description>
board_type=<type description>
示例 5 显示特定于总线的选项

以下命令可显示 PCI 热插拔连接器的卡类型以及电源 LED 指示灯的当前状态:

# hotplug get -o card_type,power_led /pci@0,0 pci.2,1
card_type=fibre
power_led=on
示例 6 设置特定于总线的属性

以下命令可打开 PCI 热插拔连接器的警示 LED 指示灯:

# hotplug set -o attn_led=on /pci@0,0 pci.2,1
示例 7 安装端口依赖项

以下命令可安装 IOV 物理功能的依赖端口,然后显示探测到的 IOV 虚拟功能。

# hotplug install /pci@400/pci@1/pci@0/pci@4 pci.0,1

# hotplug list -v /pci@400/pci@1/pci@0/pci@4 pci.0,1
<pci.0,1>  (ONLINE)
     { IOV physical function }
     { IOV virtual function 'pci.0,81' }
     { IOV virtual function 'pci.0,83' }
     { IOV virtual function 'pci.0,85' }
     { IOV virtual function 'pci.0,87' }
<pci.0,81>  (OFFLINE)
ethernet@0,81
<pci.0,83>  (OFFLINE)
ethernet@0,83
<pci.0,85>  (OFFLINE)
ethernet@0,85
<pci.0,87>  (OFFLINE)
ethernet@0,87
示例 8 卸载端口依赖项

以下命令尝试卸载 IOV 物理功能的依赖端口,但是失败,因为依赖 IOV 虚拟功能正忙。

# hotplug uninstall /pci@400/pci@1/pci@0/pci@4 pci.0,0
ERROR: devices or resources are busy.
ethernet@0,81:
    { Network interface igvbf1 }
    { igvbf1: hosts IP addresses: 10.0.0.1 }
    { Plumbed IP Address }

退出状态

0

成功完成。

1

指定的命令行选项无效。

2

指定的路径或连接不存在。

3

发生了致命错误。会在标准错误输出中显示一条或多条错误消息。

4

热插拔服务不可用。

5

指定的连接器名称指代多个端口。

属性

有关下列属性的说明,请参见 attributes(7)

属性类型
属性值
可用性
system/dynamic-reconfiguration
接口稳定性
Committed(已确定)

另请参见

getsubopt(3C)attributes(7)cfgadm(8)hotplugd(8)

诊断

在不具有任何支持的 IO 总线的系统上将显示以下错误消息:

ERROR: there are no connections to display.
(See hotplug(8) for more information.)

如果显示此错误消息,请注意,系统可能仍然具有其他支持热插拔的 IO 设备(通过 cfgadm(8) 命令,而不是 hotplug 进行管理的设备)。

如果在处理启用操作期间出现硬件错误,将显示以下错误消息:

ERROR: hardware or driver specific failure.

如果显示此错误消息,请注意,关于硬件错误的其他详细信息可能已经报告至 Solaris Fault Manager 以供诊断。

附注

必须先启用 hotplug 服务 (FMRI svc:/system/hotplug),才能使用 hotplug 命令。缺省情况下将启用该服务。See hotplugd(8).

必须授予 solaris.hotplug.modify 授权,才能执行状态更改操作或安装和卸载依赖端口。也可以授予权限配置文件 "Hotplug Management"(热插拔管理),其中包括该授权。

详细使用情况信息是从 RCM 框架收集的。其格式和内容可能随时会有变化。

在 PCI 总线控制器中支持以下特定于总线的属性:

power_led | fault_led | attn_led | active_led

插槽的某特定 LED 指示灯的状态。值可以为 onoffblink

这些属性全都可以与 get 子命令一起使用,但是只有属性 attn_led 可以与 set 子命令一起使用。

card_type | board_type

卡类型或插槽板。

这些属性全都可以与 get 子命令一起使用,但都不能与 set 子命令一起使用。