sysfs-driver-ib_srp 7.7 KB

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