srptadm - 手册页部分 8：系统管理命令

语言：

srptadm(8)

名称

srptadm - 管理 SRP 目标

用法概要

srptadm modify-target [-e, --enable] [-d, --disable]
     [-r, --reset] hca_guid

srptadm list-target [hca_guid]

srptadm modify-defaults [-e, --enable] [-d, --disable]

srptadm list-defaults

描述

srptadm 命令管理 stmfadm(8) 和 libstmf(3LIB) 中描述的 SCSI 目标模式框架内的 SCSI RDMA 协议 (SCSI RDMA Protocol, SRP) 目标端口。这允许 SRP 启动器使用 SCSI 协议访问 SCSI 目标模式框架 (SCSI Target Mode Framework, STMF) 逻辑单元。

srptadm 是作为一组子命令以及用于各个子命令的选项和操作数实现的。下文中的相应部分分别描述了这些子命令。

子命令

list-defaults

列出关于缺省属性的信息。此子命令没有选项。

list-target [hca_guid]

如果指定了 hca_guid，则列出目标 HCA 的属性。否则，将列出所有 HCA 的属性。

modify-defaults [–e, –-enable] [–d, –-disable]

修改缺省参数。

–e、–-enable: 为没有使用 modify-target 显式禁用的所有 HCA 启用 SRP 目标创建。
–d、–-disable: 为没有使用 modify-target 显式启用的所有 HCA 禁用 SRP 目标创建。

modify-target [–e, –-enable] [–d, –-disable] [–r, –-reset hca_guid

为指定的 HCA 设置 SRP 目标属性。

–e、–-enable: 在此 HCA 上启用 SRP 目标创建。
–d、–-disable: 在此 HCA 上禁用 SRP 目标创建。
–r、–-reset: 清除特定于 HCA 的信息并重置为缺省值。如果指定了此选项，则与此 HCA 关联的 SRP 目标（如果有）将不进行任何修改，直至重新启动 SRP 目标 SMF 服务。

操作数

list-target 和 modify-target 子命令具有以下操作数。

hca_guid

此系统上可以为其提供 SRP 目标服务的 InfiniBand 主机通道适配器 (Host Channel Adapter, HCA) 的 GUID。GUID 必须为以下格式之一：

3BA000100CD18: 基础十六进制格式。
0003BA000100CD18: 带有前导零的基础十六进制格式。
hca:3BA000100CD18: cfgadm(8) 中的格式。
eui.0003BA000100CD18: EUI 格式。

用法

如果在 SRP 服务处于 online 状态时更改缺省状态，则现有目标的状态不会更改，直至服务重新启动。

如果 SRP 目标服务处于 online 状态，则更改目标状态会立即生效。设置为 disabled 的目标将脱机并被删除；设置为 enabled 的目标将立即创建。

示例

示例 1 列出缺省属性

以下命令列出缺省的 SRP 目标服务属性。

# srptadm list-defaults

示例 2 更改缺省行为

以下命令将 SRP 目标服务的缺省行为更改为服务处于启用状态时不创建 SRP 目标。

# srptadm modify-defaults -d

示例 3 列出特定 HCA 的属性

以下命令列出特定 HCA 的 SRP 目标属性。

# cfgadm | grep hca
hca:3BA000100CD18              IB-HCA       connected    configured   ok
hca:3BA000100D030              IB-HCA       connected    configured   ok

# srptadm list-target hca:3BA000100CD18
Target HCA 3BA000100CD18:
    Enabled             : true
    SRP Target Name     : eui.0003BA000100CD18
    Operational Status  : online

示例 4 为特定 HCA 禁用服务

以下命令为特定 HCA 禁用 SRP 目标服务。

# srptadm modify-target -d 3BA000100CD18

可使用 list-target 命令查看更改：

# srptadm list-target hca:3BA000100CD18
Target HCA 3BA000100CD18:
    Enabled             : false
    SRP Target Name     : eui.0003BA000100CD18
    Operational Status  : -

示例 5 重新启用目标服务

以下命令序列重新启用 SRP 目标服务并显示 SRP 和 STMF 目标属性。

# srptadm modify-target -e 3BA000100CD18
# srptadm list-target hca:3BA000100CD18
Target HCA 3BA000100CD18:
    Enabled             : true
    SRP Target Name     : eui.0003BA000100CD18
    Operational Status  : online

# stmfadm list-target -v eui.0003BA000100CD18
Target: eui.0003BA000100CD18
    Operational Status: Online
    Provider Name     : srpt
    Alias             : -
    Protocol          : SRP
    Sessions          : 0

属性

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

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

另请参见

libsrpt(3LIB)、libstmf(3LIB)、srpt(4D)、attributes(7)、cfgadm(8)、stmfadm(8)