srptadm - administer SRP targets
srptadm modify-target [-e, --enable] [-d, --disable] [-r, --reset] hca_guid
srptadm list-target [hca_guid]
srptadm modify-defaults [-e, --enable] [-d, --disable]
The srptadm command manages SCSI RDMA Protocol (SRP) target ports within the SCSI Target Mode Framework described in stmfadm(8) and libstmf(3LIB). This allows SRP initiators to access SCSI Target Mode Framework (STMF) logical units using the SRP protocol.
srptadm is implemented as a set of subcommands with options and operands for each subcommand. These subcommands are described in their own section, below.
Lists information about the default properties. This subcommand has no options.
If hca_guid is specified, lists the properties of the target HCA. Otherwise, properties are listed for all HCAs.
Modify default parameters.
Enable SRP target creation for all HCAs that have not been explicitly disabled with modify-target.
Disable SRP target creation for all HCAs that have not been explicitly enabled with modify-target.
Sets SRP Target properties for the specified HCA.
Enables SRP target creation on this HCA.
Disables SRP target creation on this HCA.
Clears HCA-specific information and resets to defaults. The SRP Target, if any, associated with this HCA will not be modified as a result of this option until the SRP Target SMF service is restarted.
The list-target and modify-target subcommands have the following operand.
GUID of the InfiniBand Host Channel Adapter (HCA) on this system for which SRP Target Services can be provided. The GUID must be in one of the following forms:
Base hex form.
Base hex form with leading zeroes.
Form from cfgadm(8).
If the default state is changed when the SRP service is online, the state of existing targets is not changed until the service is restarted.
Changing the target state takes effect immediately if the SRP target service is online. Targets set to disabled will be offlined and removed; targets set to enabled will be immediately created.
The following command lists the default SRP Target Service properties.
# srptadm list-defaultsExample 2 Changing Default Behavior
The following command changes the default behavior of the SRP Target service to not create SRP Targets when the service is enabled.
# srptadm modify-defaults -dExample 3 Listing Properties for Specific HCA
The following command lists SRP Target properties for a specific HCA.
# 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 : onlineExample 4 Disabling Services for Specific HCA
The following command disables SRP Target services for a specific HCA.
# srptadm modify-target -d 3BA000100CD18
Use the list-target command to see the changes:
# srptadm list-target hca:3BA000100CD18 Target HCA 3BA000100CD18: Enabled : false SRP Target Name : eui.0003BA000100CD18 Operational Status : -Example 5 Re-enabling Target Services
The following command sequence re-enables SRP Target services and displays the SRP and STMF target properties.
# 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
See attributes(7) for descriptions of the following attributes: