^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/add_target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: January 2, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) KernelVersion: 2.6.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Description: Interface for making ib_srp connect to a new target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) One can request ib_srp to connect to a new target by writing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) a comma-separated list of login parameters to this sysfs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) attribute. The supported parameters are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) * id_ext, a 16-digit hexadecimal number specifying the eight
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) byte identifier extension in the 16-byte SRP target port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) identifier. The target port identifier is sent by ib_srp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) to the target in the SRP_LOGIN_REQ request.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) * ioc_guid, a 16-digit hexadecimal number specifying the eight
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) byte I/O controller GUID portion of the 16-byte target port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) identifier.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * dgid, a 32-digit hexadecimal number specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) destination GID.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) * pkey, a four-digit hexadecimal number specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) InfiniBand partition key.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * service_id, a 16-digit hexadecimal number specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) InfiniBand service ID used to establish communication with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) the SRP target. How to find out the value of the service ID
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) is specified in the documentation of the SRP target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) * max_sect, a decimal number specifying the maximum number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) 512-byte sectors to be transferred via a single SCSI command.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) * max_cmd_per_lun, a decimal number specifying the maximum
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) number of outstanding commands for a single LUN.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) * io_class, a hexadecimal number specifying the SRP I/O class.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Must be either 0xff00 (rev 10) or 0x0100 (rev 16a). The I/O
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) class defines the format of the SRP initiator and target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) port identifiers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) * initiator_ext, a 16-digit hexadecimal number specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) identifier extension portion of the SRP initiator port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) identifier. This data is sent by the initiator to the target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) in the SRP_LOGIN_REQ request.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) * cmd_sg_entries, a number in the range 1..255 that specifies
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) the maximum number of data buffer descriptors stored in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) SRP_CMD information unit itself. With allow_ext_sg=0 the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) parameter cmd_sg_entries defines the maximum S/G list length
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) for a single SRP_CMD, and commands whose S/G list length
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) exceeds this limit after S/G list collapsing will fail.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) * allow_ext_sg, whether ib_srp is allowed to include a partial
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) memory descriptor list in an SRP_CMD instead of the entire
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) list. If a partial memory descriptor list has been included
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) in an SRP_CMD the remaining memory descriptors are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) communicated from initiator to target via an additional RDMA
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) transfer. Setting allow_ext_sg to 1 increases the maximum
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) amount of data that can be transferred between initiator and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) target via a single SCSI command. Since not all SRP target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) implementations support partial memory descriptor lists the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) default value for this option is 0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) * sg_tablesize, a number in the range 1..2048 specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) maximum S/G list length the SCSI layer is allowed to pass to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) ib_srp. Specifying a value that exceeds cmd_sg_entries is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) only safe with partial memory descriptor list support enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) (allow_ext_sg=1).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) * comp_vector, a number in the range 0..n-1 specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) MSI-X completion vector of the first RDMA channel. Some
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) HCA's allocate multiple (n) MSI-X vectors per HCA port. If
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) the IRQ affinity masks of these interrupts have been
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) configured such that each MSI-X interrupt is handled by a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) different CPU then the comp_vector parameter can be used to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) spread the SRP completion workload over multiple CPU's.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) * tl_retry_count, a number in the range 2..7 specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) IB RC retry count.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) * queue_size, the maximum number of commands that the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) initiator is allowed to queue per SCSI host. The default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) value for this parameter is 62. The lowest supported value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) is 2.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) * max_it_iu_size, a decimal number specifying the maximum
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) initiator to target information unit length.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/ibdev
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) Date: January 2, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) KernelVersion: 2.6.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Description: HCA name (<hca>).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) Date: January 2, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) KernelVersion: 2.6.15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) Description: HCA port number (<port_number>).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) What: /sys/class/scsi_host/host<n>/allow_ext_sg
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) Date: May 19, 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) KernelVersion: 2.6.39
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Description: Whether ib_srp is allowed to include a partial memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) descriptor list in an SRP_CMD when communicating with an SRP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) What: /sys/class/scsi_host/host<n>/ch_count
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) Date: April 1, 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) KernelVersion: 3.19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) Description: Number of RDMA channels used for communication with the SRP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) What: /sys/class/scsi_host/host<n>/cmd_sg_entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) Date: May 19, 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) KernelVersion: 2.6.39
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) Description: Maximum number of data buffer descriptors that may be sent to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) the target in a single SRP_CMD request.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) What: /sys/class/scsi_host/host<n>/comp_vector
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) Date: September 2, 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) KernelVersion: 3.11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) Description: Completion vector used for the first RDMA channel.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) What: /sys/class/scsi_host/host<n>/dgid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) Date: June 17, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) KernelVersion: 2.6.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) Description: InfiniBand destination GID used for communication with the SRP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) target. Differs from orig_dgid if port redirection has happened.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) What: /sys/class/scsi_host/host<n>/id_ext
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) Date: June 17, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) KernelVersion: 2.6.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) Description: Eight-byte identifier extension portion of the 16-byte target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) port identifier.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) What: /sys/class/scsi_host/host<n>/ioc_guid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) Date: June 17, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) KernelVersion: 2.6.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) Description: Eight-byte I/O controller GUID portion of the 16-byte target
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) port identifier.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) What: /sys/class/scsi_host/host<n>/local_ib_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) Date: November 29, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) KernelVersion: 2.6.19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) Description: Name of the InfiniBand HCA used for communicating with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) SRP target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) What: /sys/class/scsi_host/host<n>/local_ib_port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) Date: November 29, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) KernelVersion: 2.6.19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) Description: Number of the HCA port used for communicating with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) SRP target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) What: /sys/class/scsi_host/host<n>/orig_dgid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) Date: June 17, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) KernelVersion: 2.6.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) Description: InfiniBand destination GID specified in the parameters
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) written to the add_target sysfs attribute.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) What: /sys/class/scsi_host/host<n>/pkey
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) Date: June 17, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) KernelVersion: 2.6.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) Description: A 16-bit number representing the InfiniBand partition key used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) for communication with the SRP target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) What: /sys/class/scsi_host/host<n>/req_lim
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) Date: October 20, 2010
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) KernelVersion: 2.6.36
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) Description: Number of requests ib_srp can send to the target before it has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) to wait for more credits. For more information see also the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) SRP credit algorithm in the SRP specification.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) What: /sys/class/scsi_host/host<n>/service_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) Date: June 17, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) KernelVersion: 2.6.17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) Description: InfiniBand service ID used for establishing communication with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) the SRP target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) What: /sys/class/scsi_host/host<n>/sgid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) Date: February 1, 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) KernelVersion: 3.13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) Description: InfiniBand GID of the source port used for communication with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) the SRP target.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) What: /sys/class/scsi_host/host<n>/zero_req_lim
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) Date: September 20, 2006
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) KernelVersion: 2.6.18
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) Contact: linux-rdma@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) Description: Number of times the initiator had to wait before sending a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) request to the target because it ran out of credits. For more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) information see also the SRP credit algorithm in the SRP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) specification.