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(1M) 和 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(1M) 中的格式。

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(5)：

另请参见

cfgadm(1M)、stmfadm(1M)、libsrpt(3LIB)、libstmf(3LIB)、attributes(5)、srpt(7D)