mirror of
https://github.com/torvalds/linux.git
synced 2024-11-25 05:32:00 +00:00
547ed331bb
According to SRP specifications 'srp-r16a' and 'srp2r06', IOControllerProfile attributes for SRP target port include the maximum initiator to target IU size. SRP connection daemons, such as srp_daemon, can get the value from the subnet manager. The SRP connection daemon can pass this value to kernel. This patch adds a parse function for it. Upstream commit [1] enables the kernel parameter, 'use_imm_data', by default. [1] also use (8 * 1024) as the default value for kernel parameter 'max_imm_data'. With those default values, the maximum initiator to target IU size will be 8260. In case the SRPT modules, which include the in-tree 'ib_srpt.ko' module, do not support SRP-2 'immediate data' feature, the default maximum initiator to target IU size is significantly smaller than 8260. For 'ib_srpt.ko' module, which built from source before [2], the default maximum initiator to target IU is 2116. [1] introduces a regression issue for old srp targets with default kernel parameters, as the connection will be rejected because of a too large maximum initiator to target IU size. [1] commit882981f4a4("RDMA/srp: Add support for immediate data") [2] commit5dabcd0456("RDMA/srpt: Add support for immediate data") Link: https://lore.kernel.org/r/20190927174352.7800-1-honli@redhat.com Reviewed-by: Bart Van Assche <bvanassche@acm.org> Signed-off-by: Honggang Li <honli@redhat.com> Signed-off-by: Jason Gunthorpe <jgg@mellanox.com>
192 lines
7.7 KiB
Plaintext
192 lines
7.7 KiB
Plaintext
What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/add_target
|
|
Date: January 2, 2006
|
|
KernelVersion: 2.6.15
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Interface for making ib_srp connect to a new target.
|
|
One can request ib_srp to connect to a new target by writing
|
|
a comma-separated list of login parameters to this sysfs
|
|
attribute. The supported parameters are:
|
|
* id_ext, a 16-digit hexadecimal number specifying the eight
|
|
byte identifier extension in the 16-byte SRP target port
|
|
identifier. The target port identifier is sent by ib_srp
|
|
to the target in the SRP_LOGIN_REQ request.
|
|
* ioc_guid, a 16-digit hexadecimal number specifying the eight
|
|
byte I/O controller GUID portion of the 16-byte target port
|
|
identifier.
|
|
* dgid, a 32-digit hexadecimal number specifying the
|
|
destination GID.
|
|
* pkey, a four-digit hexadecimal number specifying the
|
|
InfiniBand partition key.
|
|
* service_id, a 16-digit hexadecimal number specifying the
|
|
InfiniBand service ID used to establish communication with
|
|
the SRP target. How to find out the value of the service ID
|
|
is specified in the documentation of the SRP target.
|
|
* max_sect, a decimal number specifying the maximum number of
|
|
512-byte sectors to be transferred via a single SCSI command.
|
|
* max_cmd_per_lun, a decimal number specifying the maximum
|
|
number of outstanding commands for a single LUN.
|
|
* io_class, a hexadecimal number specifying the SRP I/O class.
|
|
Must be either 0xff00 (rev 10) or 0x0100 (rev 16a). The I/O
|
|
class defines the format of the SRP initiator and target
|
|
port identifiers.
|
|
* initiator_ext, a 16-digit hexadecimal number specifying the
|
|
identifier extension portion of the SRP initiator port
|
|
identifier. This data is sent by the initiator to the target
|
|
in the SRP_LOGIN_REQ request.
|
|
* cmd_sg_entries, a number in the range 1..255 that specifies
|
|
the maximum number of data buffer descriptors stored in the
|
|
SRP_CMD information unit itself. With allow_ext_sg=0 the
|
|
parameter cmd_sg_entries defines the maximum S/G list length
|
|
for a single SRP_CMD, and commands whose S/G list length
|
|
exceeds this limit after S/G list collapsing will fail.
|
|
* allow_ext_sg, whether ib_srp is allowed to include a partial
|
|
memory descriptor list in an SRP_CMD instead of the entire
|
|
list. If a partial memory descriptor list has been included
|
|
in an SRP_CMD the remaining memory descriptors are
|
|
communicated from initiator to target via an additional RDMA
|
|
transfer. Setting allow_ext_sg to 1 increases the maximum
|
|
amount of data that can be transferred between initiator and
|
|
target via a single SCSI command. Since not all SRP target
|
|
implementations support partial memory descriptor lists the
|
|
default value for this option is 0.
|
|
* sg_tablesize, a number in the range 1..2048 specifying the
|
|
maximum S/G list length the SCSI layer is allowed to pass to
|
|
ib_srp. Specifying a value that exceeds cmd_sg_entries is
|
|
only safe with partial memory descriptor list support enabled
|
|
(allow_ext_sg=1).
|
|
* comp_vector, a number in the range 0..n-1 specifying the
|
|
MSI-X completion vector of the first RDMA channel. Some
|
|
HCA's allocate multiple (n) MSI-X vectors per HCA port. If
|
|
the IRQ affinity masks of these interrupts have been
|
|
configured such that each MSI-X interrupt is handled by a
|
|
different CPU then the comp_vector parameter can be used to
|
|
spread the SRP completion workload over multiple CPU's.
|
|
* tl_retry_count, a number in the range 2..7 specifying the
|
|
IB RC retry count.
|
|
* queue_size, the maximum number of commands that the
|
|
initiator is allowed to queue per SCSI host. The default
|
|
value for this parameter is 62. The lowest supported value
|
|
is 2.
|
|
* max_it_iu_size, a decimal number specifying the maximum
|
|
initiator to target information unit length.
|
|
|
|
What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/ibdev
|
|
Date: January 2, 2006
|
|
KernelVersion: 2.6.15
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: HCA name (<hca>).
|
|
|
|
What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/port
|
|
Date: January 2, 2006
|
|
KernelVersion: 2.6.15
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: HCA port number (<port_number>).
|
|
|
|
What: /sys/class/scsi_host/host<n>/allow_ext_sg
|
|
Date: May 19, 2011
|
|
KernelVersion: 2.6.39
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Whether ib_srp is allowed to include a partial memory
|
|
descriptor list in an SRP_CMD when communicating with an SRP
|
|
target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/ch_count
|
|
Date: April 1, 2015
|
|
KernelVersion: 3.19
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Number of RDMA channels used for communication with the SRP
|
|
target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/cmd_sg_entries
|
|
Date: May 19, 2011
|
|
KernelVersion: 2.6.39
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Maximum number of data buffer descriptors that may be sent to
|
|
the target in a single SRP_CMD request.
|
|
|
|
What: /sys/class/scsi_host/host<n>/comp_vector
|
|
Date: September 2, 2013
|
|
KernelVersion: 3.11
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Completion vector used for the first RDMA channel.
|
|
|
|
What: /sys/class/scsi_host/host<n>/dgid
|
|
Date: June 17, 2006
|
|
KernelVersion: 2.6.17
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: InfiniBand destination GID used for communication with the SRP
|
|
target. Differs from orig_dgid if port redirection has happened.
|
|
|
|
What: /sys/class/scsi_host/host<n>/id_ext
|
|
Date: June 17, 2006
|
|
KernelVersion: 2.6.17
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Eight-byte identifier extension portion of the 16-byte target
|
|
port identifier.
|
|
|
|
What: /sys/class/scsi_host/host<n>/ioc_guid
|
|
Date: June 17, 2006
|
|
KernelVersion: 2.6.17
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Eight-byte I/O controller GUID portion of the 16-byte target
|
|
port identifier.
|
|
|
|
What: /sys/class/scsi_host/host<n>/local_ib_device
|
|
Date: November 29, 2006
|
|
KernelVersion: 2.6.19
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Name of the InfiniBand HCA used for communicating with the
|
|
SRP target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/local_ib_port
|
|
Date: November 29, 2006
|
|
KernelVersion: 2.6.19
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Number of the HCA port used for communicating with the
|
|
SRP target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/orig_dgid
|
|
Date: June 17, 2006
|
|
KernelVersion: 2.6.17
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: InfiniBand destination GID specified in the parameters
|
|
written to the add_target sysfs attribute.
|
|
|
|
What: /sys/class/scsi_host/host<n>/pkey
|
|
Date: June 17, 2006
|
|
KernelVersion: 2.6.17
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: A 16-bit number representing the InfiniBand partition key used
|
|
for communication with the SRP target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/req_lim
|
|
Date: October 20, 2010
|
|
KernelVersion: 2.6.36
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Number of requests ib_srp can send to the target before it has
|
|
to wait for more credits. For more information see also the
|
|
SRP credit algorithm in the SRP specification.
|
|
|
|
What: /sys/class/scsi_host/host<n>/service_id
|
|
Date: June 17, 2006
|
|
KernelVersion: 2.6.17
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: InfiniBand service ID used for establishing communication with
|
|
the SRP target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/sgid
|
|
Date: February 1, 2014
|
|
KernelVersion: 3.13
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: InfiniBand GID of the source port used for communication with
|
|
the SRP target.
|
|
|
|
What: /sys/class/scsi_host/host<n>/zero_req_lim
|
|
Date: September 20, 2006
|
|
KernelVersion: 2.6.18
|
|
Contact: linux-rdma@vger.kernel.org
|
|
Description: Number of times the initiator had to wait before sending a
|
|
request to the target because it ran out of credits. For more
|
|
information see also the SRP credit algorithm in the SRP
|
|
specification.
|