/usr/sbin/cfgadm [-f] [-n | -y] [-v] [-o hardware_options]
-c function ap_id [ap_id]
/usr/sbin/cfgadm [-v] [-a] [-s listing_options]
[-o hardware_options] [-l [ap_id]]
/usr/sbin/cfgadm [-v] [-o hardware_options] -h [ap_id]
fp 端口驱动程序插件 /usr/lib/cfgadm/fp.so.1 提供通过 cfgadm(1M) 管理光纤通道光纤网络设备节点的功能。cfgadm 在连接点上运行。连接点是可动态重新配置硬件资源的系统位置。有关连接点的其他详细信息，请参见 cfgadm(1M)。
对于光纤通道光纤设备节点管理，每个 fp 端口节点采用设备树中的一个连接点表示。此外，每个光纤通道设备还采用一个动态连接点表示。连接点通过 ap_id 命名。定义下列两种类型的 ap_id：逻辑和物理。物理 ap_id 基于物理路径名。逻辑 ap_id 是更短、更加用户友好的名称。对于 fp 端口节点，逻辑 ap_id 为对应的磁盘控制器号。例如，c0 是一个典型的逻辑 ap_id。
光纤通道设备使用端口全球名称 (World Wide Name, WWN) 命名。如果一个磁盘设备连接到控制器 c0，其 ap_id 可以是：
c0::50020f2300006077
其中 50020f2300006077 用于标识特定光纤通道设备的端口 WWN。
缺省情况下，对光纤通道专用环路端口、光纤网络端口或公共环路端口上的每个设备进行探测，并使其可供 Solaris 使用。通过启动应用程序或最终用户操作，可使连接到光纤通道光纤网络端口或公共环路端口的设备不可供 Solaris 使用。此操作类似于通过管理用户接口的方法热拔除设备。应用程序或用户可以使用 /usr/lib/cfgadm/fp.so.1 库来启用 libcfgadm 提供接口以完成此任务。
当前连接的光纤设备列表以连接点的形式生成。
此系统中的连接点简单列表包括 fp 端口节点（非光纤通道设备）中的连接点。以下示例使用列表选项 (–l) 的 –a 标志来列出光纤通道设备：
# cfgadm -l
Ap_Id Type Receptacle Occupant Condition
c0 fc-fabric connected configured unknown
c1 fc-private connected configured unknown
c2 fc-pt_to_pt connected configured unknown
c3 fc connected unconfigured unknown
sysctrl0:slot0 cpu/mem connected configured ok
sysctrl0:slot1 sbus-upa connected configured ok
以下示例列出了连接到 fp 端口的光纤通道设备。
# cfgadm -al
Ap_Id Type Receptacle Occupant Condition
c0 fc-fabric connected configured unknown
c0::50020f2300006077 disk connected configured unknown
c0::50020f23000063a9 disk connected configured unknown
c0::50020f2300005f24 disk connected configured unknown
c0::50020f2300006107 disk connected configured unknown
c1 fc-private connected configured unknown
c1::220000203708b69c disk connected configured unknown
c1::220000203708ba7d disk connected configured unknown
c1::220000203708b8d4 disk connected configured unknown
c1::220000203708b9b2 disk connected configured unknown
c2 fc-pt_to_pt connected configured unknown
c2::500104f000937528 tape connected configured unknown
c3 fc connected unconfigured unknown
sysctrl0:slot0 cpu/mem connected configured ok
sysctrl0:slot1 sbus-upa connected configured ok
在此示例中，fc-fabric 类型的 ap_id c0 指示 fp 端口与光纤网络相连。对于具有光纤网络相关类型（例如 fc-fabric 和 fc-public ）的 fp 端口，缺省情况下在引导时创建设备节点并可通过 cfgadm 配置与取消配置操作进行管理。fc-private 类型的 ap_id c1 指示 fp 端口连接到专用环路且缺省情况下也创建设备节点。fc-pt_to_pt 类型的 ap_id c2 指示 fp 端口直接连接到另一个 N_port 且缺省情况下也创建设备节点。fc 类型的 ap_id c3 指示 fp 端口 c2 未与任何对象相连。光纤通道设备 ap_id 的 "Type"（类型）字段显示了设备中 LUN 0 的 SCSI 设备类型。
在 Solaris 中配置了具有多个 FCP SCSI LUN 的光纤通道设备，其中每一个 FCP SCSI LUN 均可作为一个 Solaris 设备使用。假定 ap_id c0::50020f2300006077 和 c0::50020f23000063a9 表示具有多个 FCP SCSI LUN 的光纤通道设备。
以下示例显示了如何列出具有 FCP SCSI LUN 的 ap_id 的信息：
# cfgadm -al -o show_SCSI_LUN
Ap_Id Type Receptacle Occupant Condition
c0 fc-fabric connected configured unknown
c0::50020f2300006077,0 disk connected configured unknown
c0::50020f2300006077,1 disk connected configured unknown
c0::50020f2300006077,2 disk connected configured unknown
c0::50020f2300006077,3 disk connected configured unknown
c0::50020f23000063a9,0 disk connected configured unknown
c0::50020f23000063a9,1 disk connected configured unknown
c0::50020f23000063a9,2 disk connected configured unknown
c0::50020f23000063a9,3 disk connected configured unknown
c0::50020f2300005f24,0 disk connected unconfigured unknown
c0::50020f2300005f24,1 disk connected unconfigured unknown
c0::50020f2300006107,0 disk connected unconfigured unknown
c0::50020f2300006107,1 disk connected unconfigured unknown
c1 fc-private connected configured unknown
c1::220000203708b69c,0 disk connected configured unknown
c1::220000203708ba7d,0 disk connected configured unknown
c1::220000203708b8d4,0 disk connected configured unknown
c1::220000203708b9b2,0 disk connected configured unknown
c2 fc-pt_to_pt connected configured unknown
c2::500104f000937528,0 tape connected configured unknown
c3 fc connected unconfigured unknown
在此示例中，ap_id c0::50020f2300006077,0 标识光纤通道设备的 FCP SCSI LUN 0，采用端口 WWN 50020f2300006077 表示。根据报告，光纤通道设备具有 4 个 FCP SCSI LUN，并且这些 FCP SCSI LUN 均已配置。列出了与端口 WWN 50020f2300006077 相关联的 4 个 FCP SCSI LUN 级别 ap_id。此列表还显示了未配置的光纤通道设备的 FCP SCSI LUN。c0::50020f2300005f24 所代表的光纤通道设备被报告为具有两个 FCP SCSI LUN。配置操作 on c0::50020f2300005f24 将创建两个 Solaris 设备。FCP SCSI LUN 级别 ap_id 的 Type（类型）字段显示每个 LUN 的 SCSI 设备类型。如果光纤通道设备具有不同的设备类型 LUN，Type（类型）字段会反映出来。
fp 端口上的连接点插口和插卡状态具有下列含义：
在 fp 端口上配置了一个或多个设备
fp 端口处于活动状态
fp 端口停止（IO 活动暂停）
不适用
在 fp 端口上未配置任何设备
fp 端口上各光纤通道设备的状态：
设备已在 Solaris 中配置并可供使用
设备连接的 fp 端口处于活动状态
设备连接的 fp 端口处于停止状态
可配置设备
fp 端口上的连接点 condition（状态）字段具有下列含义：
一个错误状态已阻止 fp 端口检测光纤通道连接的存在情况或类型的功能。
fp 端口上各光纤通道设备的 condition（状态）字段具有下列含义：
在光纤网络上探测设备时发生错误。
在主机上配置了一个设备且其状态在 Solaris 上显示为正常（即，联机），但是该设备目前不存在或在光纤网络上不显示，或者因为用于配置该设备的本地端口上存在错误状态，该设备的存在情况无法验证。
已在主机上配置设备，但其目前处于脱机状态或存在故障。
condition（状态）为 unknown 指示在光纤网络上探测设备已完成且没有错误，并且如果之前配置了该设备，Solaris 主机中的设备状态为正常。无法保证设备的内部状态。
除列出 (–l) 外，cfgadm 还定义了一些类型的操作。这些操作包括调用配置状态更改以及获取配置管理帮助消息 (–h)。
支持以下选项：
为 fp 传输特定库定义了下列通用命令：
对于 fc-fabric 类型 fp 端口连接点上的光纤通道设备连接点，支持下列配置状态更改操作：
配置连接到主机的光纤通道光纤网络设备。如果在列表操作的输出中将光纤通道设备列为 unknown（未知）类型，可能无法配置该设备。未尝试配置类型为 unknown（未知）的设备。可使用强制选项 (–f) 来强制 fp 端口驱动程序插件尝试配置任意设备。报告进程中的任何错误。缺省情况下，在光纤通道光纤网络设备上发现的每个 FCP SCSI LUN 都进行了配置。但是，在 fp.conf 文件的 "pwwn-lun-blacklist" 属性中指定的 FCP SCSI LUN 仍将处于 unconfigured（未配置）状态。FCP SCSI LUN 级别列表反映了这些 FCP SCSI LUN 的状态。重新引导或在连接的控制器上 Solaris 动态重新配置之后，它们仍会处于 unconfigured（未配置）状态。有关 "pwwn-lun-blacklist" 属性的更多详细信息，请参见 fp(7d)。
在主机上取消配置光纤通道光纤网络设备。在下次重新引导或在连接该设备的控制器上 Solaris 动态重新配置之前，该设备保持处于 unconfigured（未配置）状态，而届时所有光纤网络设备都会自动枚举。通过使用 fp.conf 文件中的 "manual_configuration_only" 属性可以更改缺省的行为。如果设置了该属性，设备会在重新引导后仍处于 unconfigured（未配置）状态。有关 "manual_configuration_only" 属性的更多详细信息，请参见 fp(7d)。
对于光纤通道专用环路设备和 N_Port 点到点设备，configure 命令返回成功，但不会执行任何操作。unconfigure 命令在专用环路设备和 N_Port 点到点设备上不受支持。缺省情况下，专用环路设备和 N_Port 点到点设备由 Solaris 光纤通道驱动程序配置，且不通过最终用户或应用程序启动的操作进行管理。fp.conf 文件中的 pwwn-lun-blacklist 属性以与应用于光纤网络设备相同的方式应用于专用环路设备和 N_Port 点到点设备。
强制实施 configure 更改状态操作，无论 condition（状态）或 type（类型）为何。请参见上述有关 configure 更改状态操作的说明。
获取 fp 传输特定帮助。指定任意 fp 连接点。
支持下列硬件选项。
如果使用 list 选项 –al 指定，列出与发现的光纤通道设备的每个 FCP SCSI LUN 相关联的 ap_id。请参见上述 FCP SCSI LUN 级别列表的说明和示例。在 FCP SCSI LUN 级别上不支持设备节点创建。请参见“附注”部分。
缺省情况下，所有光纤通道设备对 Solaris 都可用。通过设置 /kernel/drv/fp.conf 文件中的属性 "manual_configuration_only"，可完成在缺省情况下仅启用对 Solaris 可用的光纤网络设备的子集。设置了 fp.conf 中的 "manual_configuration_only" 时，除非应用程序或最终用户之前已请求在 Solaris 中配置该设备，否则所有光纤网络设备对 Solaris 均不可用。configure 状态更改命令使该设备对 Solaris 可用。在光纤网络设备上成功执行 configure 操作之后，将相关链接添加到 /dev 名称空间。unconfigure 状态更改命令使设备对 Solaris 不可用。
使用 –c configure 操作在主机上成功配置了光纤通道光纤网络设备时，其物理 ap_id 存储在系统信息库中。使用 –c unconfigure 操作取消光纤通道光纤网络设备配置时，从该系统信息库中删除物理 ap_id。缺省情况下，自动枚举所有光纤网络设备，且仅当设置了 fp.conf 中的 "manual_configuration_only" 属性时才使用该系统信息库。有关 "manual_configuration_only" 属性的更多详细信息，请参见 fp(7d)。
可以使用 –c 选项指定下列命令以控制系统信息库的更新行为：
对于 configure，无条件地将连接点添加到系统信息库；对于 unconfigure，无条件地删除连接点。
无论实施任何操作，均不更新系统信息库。
对于正常的 configure 和 unconfigure 操作，不应使用这些选项。请参见“警告”部分。
如果为一个光纤通道设备配置了多个 FCP SCSI LUN 且与其 FCP SCSI LUN 相关联的任意 Solaris 处于不可用状态，将整个光纤通道设备报告为不可用。在使用 –c unconfigure 命令的情况下的以下选项仅移除光纤通道设备的处于不可用状态的 Solaris 设备。
对于 unconfigure 操作，移除目标设备的任何脱机的设备节点。
有关用法信息，请参见 cfgadm(1M)。
目前没有可用的测试命令。
目前没有可用的硬件专用函数。
所有其他选项的含义与 cfgadm(1M) 手册页中定义的含义相同。
以下命令可用于取消配置磁盘：
# cfgadm -c unconfigure c0::210000203708b606示例 2 取消配置单个连接点下的所有配置的磁盘
以下命令取消配置 c0 连接点下的所有配置的磁盘。
# cfgadm -c unconfigure c0示例 3 配置磁盘
以下命令配置磁盘：
# cfgadm -c configure c0::210000203708b606示例 4 配置单个连接点下的所有未配置的磁盘
以下命令配置连接点 c0 下的所有未配置的磁盘。
# cfgadm -c configure c0示例 5 从系统信息库中移除光纤通道光纤网络设备连接点
以下命令从光纤设备系统信息库中无条件地移除光纤通道光纤设备连接点。
# cfgadm -c unconfigure -o force_update c0::210000203708b606示例 6 从目标设备中移除脱机的 Solaris 设备节点
以下命令从目标设备中移除脱机的 Solaris 设备节点：
# cfgadm -c unconfigure -o unusable_SCSI_LUN c0::210000203708b606
光纤通道光纤网络设备节点管理的硬件专用库。
当前配置的光纤网络设备的物理 ap_id 的系统信息库。仅用于在引导时重新配置这些光纤网络设备。仅当设置了 /kernel/drv/fp.conf 文件中的 "manual_configuration_only" 时才使用该系统信息库。
重新配置引导时物理 ap_id 在 /etc/cfg/fp/fabric_WWN_map 中列出的光纤网络设备。
有关下列属性的说明，请参见 attributes(5)：
|
svcs(1)、cfgadm(1M)、svcadm(1M)、config_admin(3CFGADM)、libcfgadm(3LIB)、attributes(5)、smf(5)、fp(7d)
对于正常 configure/unconfigure 操作下的系统信息库更新，请勿使用硬件专用选项。如果当引导时光纤网络设备的节点创建失败且错误状态被认为是永久性的，希望使用硬件专用选项。带 force_update 硬件专用选项的 unconfigure 命令从系统信息库中无条件地移除存在故障的光纤设备连接点。
对于具有未知或无 SCSI 设备类型的设备（例如，光纤通道主机总线适配器），configure 操作可能不适用。
configure 和 unconfigure 命令在由端口 WWN ap_id 表示的光纤通道设备级别上运行。如果为一个光纤通道设备配置了多个 FCP SCSI LUN，关联端口 WWN ap_id 上的 configure 命令用于为每个 FCP SCSI LUN 创建一个 Solaris 设备，除非使用 fp.conf 文件中的 "pwwn-lun-blacklist" 属性进行了指定。unconfigure 命令移除所有与端口 WWN ap_id 相关联的 Solaris 设备。FCP SCSI LUN 级别 ap_id 对于 configure 和 unconfigure 命令无效。
过时的 show_FCP_dev 选项已被新的 show_SCSI_LUN 选项代替，且过时的 unusable_FCP_dev 选项已被新的 unusable_SCSI_LUN 选项代替。
cfgadm_fp 服务由服务管理工具 smf(5) 管理，其服务标识符为：
svc:/system/device/fc-fabric:default
可以使用 svcadm(1M) 来对此服务执行管理操作（如启用、禁用或请求重新启动）。可以使用 svcs(1) 命令来查询服务的状态。
引导时启动此服务后，对于光纤网络设备配置，无需实施此服务的管理操作。