0001 What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/add_target
0002 Date: January 2, 2006
0003 KernelVersion: 2.6.15
0004 Contact: linux-rdma@vger.kernel.org
0005 Description: Interface for making ib_srp connect to a new target.
0006 One can request ib_srp to connect to a new target by writing
0007 a comma-separated list of login parameters to this sysfs
0008 attribute. The supported parameters are:
0009
0010 * id_ext, a 16-digit hexadecimal number specifying the eight
0011 byte identifier extension in the 16-byte SRP target port
0012 identifier. The target port identifier is sent by ib_srp
0013 to the target in the SRP_LOGIN_REQ request.
0014 * ioc_guid, a 16-digit hexadecimal number specifying the eight
0015 byte I/O controller GUID portion of the 16-byte target port
0016 identifier.
0017 * dgid, a 32-digit hexadecimal number specifying the
0018 destination GID.
0019 * pkey, a four-digit hexadecimal number specifying the
0020 InfiniBand partition key.
0021 * service_id, a 16-digit hexadecimal number specifying the
0022 InfiniBand service ID used to establish communication with
0023 the SRP target. How to find out the value of the service ID
0024 is specified in the documentation of the SRP target.
0025 * max_sect, a decimal number specifying the maximum number of
0026 512-byte sectors to be transferred via a single SCSI command.
0027 * max_cmd_per_lun, a decimal number specifying the maximum
0028 number of outstanding commands for a single LUN.
0029 * io_class, a hexadecimal number specifying the SRP I/O class.
0030 Must be either 0xff00 (rev 10) or 0x0100 (rev 16a). The I/O
0031 class defines the format of the SRP initiator and target
0032 port identifiers.
0033 * initiator_ext, a 16-digit hexadecimal number specifying the
0034 identifier extension portion of the SRP initiator port
0035 identifier. This data is sent by the initiator to the target
0036 in the SRP_LOGIN_REQ request.
0037 * cmd_sg_entries, a number in the range 1..255 that specifies
0038 the maximum number of data buffer descriptors stored in the
0039 SRP_CMD information unit itself. With allow_ext_sg=0 the
0040 parameter cmd_sg_entries defines the maximum S/G list length
0041 for a single SRP_CMD, and commands whose S/G list length
0042 exceeds this limit after S/G list collapsing will fail.
0043 * allow_ext_sg, whether ib_srp is allowed to include a partial
0044 memory descriptor list in an SRP_CMD instead of the entire
0045 list. If a partial memory descriptor list has been included
0046 in an SRP_CMD the remaining memory descriptors are
0047 communicated from initiator to target via an additional RDMA
0048 transfer. Setting allow_ext_sg to 1 increases the maximum
0049 amount of data that can be transferred between initiator and
0050 target via a single SCSI command. Since not all SRP target
0051 implementations support partial memory descriptor lists the
0052 default value for this option is 0.
0053 * sg_tablesize, a number in the range 1..2048 specifying the
0054 maximum S/G list length the SCSI layer is allowed to pass to
0055 ib_srp. Specifying a value that exceeds cmd_sg_entries is
0056 only safe with partial memory descriptor list support enabled
0057 (allow_ext_sg=1).
0058 * comp_vector, a number in the range 0..n-1 specifying the
0059 MSI-X completion vector of the first RDMA channel. Some
0060 HCA's allocate multiple (n) MSI-X vectors per HCA port. If
0061 the IRQ affinity masks of these interrupts have been
0062 configured such that each MSI-X interrupt is handled by a
0063 different CPU then the comp_vector parameter can be used to
0064 spread the SRP completion workload over multiple CPU's.
0065 * tl_retry_count, a number in the range 2..7 specifying the
0066 IB RC retry count.
0067 * queue_size, the maximum number of commands that the
0068 initiator is allowed to queue per SCSI host. The default
0069 value for this parameter is 62. The lowest supported value
0070 is 2.
0071 * max_it_iu_size, a decimal number specifying the maximum
0072 initiator to target information unit length.
0073
0074 What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/ibdev
0075 Date: January 2, 2006
0076 KernelVersion: 2.6.15
0077 Contact: linux-rdma@vger.kernel.org
0078 Description: HCA name (<hca>).
0079
0080 What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/port
0081 Date: January 2, 2006
0082 KernelVersion: 2.6.15
0083 Contact: linux-rdma@vger.kernel.org
0084 Description: HCA port number (<port_number>).
0085
0086 What: /sys/class/scsi_host/host<n>/allow_ext_sg
0087 Date: May 19, 2011
0088 KernelVersion: 2.6.39
0089 Contact: linux-rdma@vger.kernel.org
0090 Description: Whether ib_srp is allowed to include a partial memory
0091 descriptor list in an SRP_CMD when communicating with an SRP
0092 target.
0093
0094 What: /sys/class/scsi_host/host<n>/ch_count
0095 Date: April 1, 2015
0096 KernelVersion: 3.19
0097 Contact: linux-rdma@vger.kernel.org
0098 Description: Number of RDMA channels used for communication with the SRP
0099 target.
0100
0101 What: /sys/class/scsi_host/host<n>/cmd_sg_entries
0102 Date: May 19, 2011
0103 KernelVersion: 2.6.39
0104 Contact: linux-rdma@vger.kernel.org
0105 Description: Maximum number of data buffer descriptors that may be sent to
0106 the target in a single SRP_CMD request.
0107
0108 What: /sys/class/scsi_host/host<n>/comp_vector
0109 Date: September 2, 2013
0110 KernelVersion: 3.11
0111 Contact: linux-rdma@vger.kernel.org
0112 Description: Completion vector used for the first RDMA channel.
0113
0114 What: /sys/class/scsi_host/host<n>/dgid
0115 Date: June 17, 2006
0116 KernelVersion: 2.6.17
0117 Contact: linux-rdma@vger.kernel.org
0118 Description: InfiniBand destination GID used for communication with the SRP
0119 target. Differs from orig_dgid if port redirection has happened.
0120
0121 What: /sys/class/scsi_host/host<n>/id_ext
0122 Date: June 17, 2006
0123 KernelVersion: 2.6.17
0124 Contact: linux-rdma@vger.kernel.org
0125 Description: Eight-byte identifier extension portion of the 16-byte target
0126 port identifier.
0127
0128 What: /sys/class/scsi_host/host<n>/ioc_guid
0129 Date: June 17, 2006
0130 KernelVersion: 2.6.17
0131 Contact: linux-rdma@vger.kernel.org
0132 Description: Eight-byte I/O controller GUID portion of the 16-byte target
0133 port identifier.
0134
0135 What: /sys/class/scsi_host/host<n>/local_ib_device
0136 Date: November 29, 2006
0137 KernelVersion: 2.6.19
0138 Contact: linux-rdma@vger.kernel.org
0139 Description: Name of the InfiniBand HCA used for communicating with the
0140 SRP target.
0141
0142 What: /sys/class/scsi_host/host<n>/local_ib_port
0143 Date: November 29, 2006
0144 KernelVersion: 2.6.19
0145 Contact: linux-rdma@vger.kernel.org
0146 Description: Number of the HCA port used for communicating with the
0147 SRP target.
0148
0149 What: /sys/class/scsi_host/host<n>/orig_dgid
0150 Date: June 17, 2006
0151 KernelVersion: 2.6.17
0152 Contact: linux-rdma@vger.kernel.org
0153 Description: InfiniBand destination GID specified in the parameters
0154 written to the add_target sysfs attribute.
0155
0156 What: /sys/class/scsi_host/host<n>/pkey
0157 Date: June 17, 2006
0158 KernelVersion: 2.6.17
0159 Contact: linux-rdma@vger.kernel.org
0160 Description: A 16-bit number representing the InfiniBand partition key used
0161 for communication with the SRP target.
0162
0163 What: /sys/class/scsi_host/host<n>/req_lim
0164 Date: October 20, 2010
0165 KernelVersion: 2.6.36
0166 Contact: linux-rdma@vger.kernel.org
0167 Description: Number of requests ib_srp can send to the target before it has
0168 to wait for more credits. For more information see also the
0169 SRP credit algorithm in the SRP specification.
0170
0171 What: /sys/class/scsi_host/host<n>/service_id
0172 Date: June 17, 2006
0173 KernelVersion: 2.6.17
0174 Contact: linux-rdma@vger.kernel.org
0175 Description: InfiniBand service ID used for establishing communication with
0176 the SRP target.
0177
0178 What: /sys/class/scsi_host/host<n>/sgid
0179 Date: February 1, 2014
0180 KernelVersion: 3.13
0181 Contact: linux-rdma@vger.kernel.org
0182 Description: InfiniBand GID of the source port used for communication with
0183 the SRP target.
0184
0185 What: /sys/class/scsi_host/host<n>/zero_req_lim
0186 Date: September 20, 2006
0187 KernelVersion: 2.6.18
0188 Contact: linux-rdma@vger.kernel.org
0189 Description: Number of times the initiator had to wait before sending a
0190 request to the target because it ran out of credits. For more
0191 information see also the SRP credit algorithm in the SRP
0192 specification.
