193 lines · plain
1What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/add_target2Date: January 2, 20063KernelVersion: 2.6.154Contact: linux-rdma@vger.kernel.org5Description: Interface for making ib_srp connect to a new target.6 One can request ib_srp to connect to a new target by writing7 a comma-separated list of login parameters to this sysfs8 attribute. The supported parameters are:9 10 * id_ext, a 16-digit hexadecimal number specifying the eight11 byte identifier extension in the 16-byte SRP target port12 identifier. The target port identifier is sent by ib_srp13 to the target in the SRP_LOGIN_REQ request.14 * ioc_guid, a 16-digit hexadecimal number specifying the eight15 byte I/O controller GUID portion of the 16-byte target port16 identifier.17 * dgid, a 32-digit hexadecimal number specifying the18 destination GID.19 * pkey, a four-digit hexadecimal number specifying the20 InfiniBand partition key.21 * service_id, a 16-digit hexadecimal number specifying the22 InfiniBand service ID used to establish communication with23 the SRP target. How to find out the value of the service ID24 is specified in the documentation of the SRP target.25 * max_sect, a decimal number specifying the maximum number of26 512-byte sectors to be transferred via a single SCSI command.27 * max_cmd_per_lun, a decimal number specifying the maximum28 number of outstanding commands for a single LUN.29 * io_class, a hexadecimal number specifying the SRP I/O class.30 Must be either 0xff00 (rev 10) or 0x0100 (rev 16a). The I/O31 class defines the format of the SRP initiator and target32 port identifiers.33 * initiator_ext, a 16-digit hexadecimal number specifying the34 identifier extension portion of the SRP initiator port35 identifier. This data is sent by the initiator to the target36 in the SRP_LOGIN_REQ request.37 * cmd_sg_entries, a number in the range 1..255 that specifies38 the maximum number of data buffer descriptors stored in the39 SRP_CMD information unit itself. With allow_ext_sg=0 the40 parameter cmd_sg_entries defines the maximum S/G list length41 for a single SRP_CMD, and commands whose S/G list length42 exceeds this limit after S/G list collapsing will fail.43 * allow_ext_sg, whether ib_srp is allowed to include a partial44 memory descriptor list in an SRP_CMD instead of the entire45 list. If a partial memory descriptor list has been included46 in an SRP_CMD the remaining memory descriptors are47 communicated from initiator to target via an additional RDMA48 transfer. Setting allow_ext_sg to 1 increases the maximum49 amount of data that can be transferred between initiator and50 target via a single SCSI command. Since not all SRP target51 implementations support partial memory descriptor lists the52 default value for this option is 0.53 * sg_tablesize, a number in the range 1..2048 specifying the54 maximum S/G list length the SCSI layer is allowed to pass to55 ib_srp. Specifying a value that exceeds cmd_sg_entries is56 only safe with partial memory descriptor list support enabled57 (allow_ext_sg=1).58 * comp_vector, a number in the range 0..n-1 specifying the59 MSI-X completion vector of the first RDMA channel. Some60 HCA's allocate multiple (n) MSI-X vectors per HCA port. If61 the IRQ affinity masks of these interrupts have been62 configured such that each MSI-X interrupt is handled by a63 different CPU then the comp_vector parameter can be used to64 spread the SRP completion workload over multiple CPU's.65 * tl_retry_count, a number in the range 2..7 specifying the66 IB RC retry count.67 * queue_size, the maximum number of commands that the68 initiator is allowed to queue per SCSI host. The default69 value for this parameter is 62. The lowest supported value70 is 2.71 * max_it_iu_size, a decimal number specifying the maximum72 initiator to target information unit length.73 74What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/ibdev75Date: January 2, 200676KernelVersion: 2.6.1577Contact: linux-rdma@vger.kernel.org78Description: HCA name (<hca>).79 80What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/port81Date: January 2, 200682KernelVersion: 2.6.1583Contact: linux-rdma@vger.kernel.org84Description: HCA port number (<port_number>).85 86What: /sys/class/scsi_host/host<n>/allow_ext_sg87Date: May 19, 201188KernelVersion: 2.6.3989Contact: linux-rdma@vger.kernel.org90Description: Whether ib_srp is allowed to include a partial memory91 descriptor list in an SRP_CMD when communicating with an SRP92 target.93 94What: /sys/class/scsi_host/host<n>/ch_count95Date: April 1, 201596KernelVersion: 3.1997Contact: linux-rdma@vger.kernel.org98Description: Number of RDMA channels used for communication with the SRP99 target.100 101What: /sys/class/scsi_host/host<n>/cmd_sg_entries102Date: May 19, 2011103KernelVersion: 2.6.39104Contact: linux-rdma@vger.kernel.org105Description: Maximum number of data buffer descriptors that may be sent to106 the target in a single SRP_CMD request.107 108What: /sys/class/scsi_host/host<n>/comp_vector109Date: September 2, 2013110KernelVersion: 3.11111Contact: linux-rdma@vger.kernel.org112Description: Completion vector used for the first RDMA channel.113 114What: /sys/class/scsi_host/host<n>/dgid115Date: June 17, 2006116KernelVersion: 2.6.17117Contact: linux-rdma@vger.kernel.org118Description: InfiniBand destination GID used for communication with the SRP119 target. Differs from orig_dgid if port redirection has happened.120 121What: /sys/class/scsi_host/host<n>/id_ext122Date: June 17, 2006123KernelVersion: 2.6.17124Contact: linux-rdma@vger.kernel.org125Description: Eight-byte identifier extension portion of the 16-byte target126 port identifier.127 128What: /sys/class/scsi_host/host<n>/ioc_guid129Date: June 17, 2006130KernelVersion: 2.6.17131Contact: linux-rdma@vger.kernel.org132Description: Eight-byte I/O controller GUID portion of the 16-byte target133 port identifier.134 135What: /sys/class/scsi_host/host<n>/local_ib_device136Date: November 29, 2006137KernelVersion: 2.6.19138Contact: linux-rdma@vger.kernel.org139Description: Name of the InfiniBand HCA used for communicating with the140 SRP target.141 142What: /sys/class/scsi_host/host<n>/local_ib_port143Date: November 29, 2006144KernelVersion: 2.6.19145Contact: linux-rdma@vger.kernel.org146Description: Number of the HCA port used for communicating with the147 SRP target.148 149What: /sys/class/scsi_host/host<n>/orig_dgid150Date: June 17, 2006151KernelVersion: 2.6.17152Contact: linux-rdma@vger.kernel.org153Description: InfiniBand destination GID specified in the parameters154 written to the add_target sysfs attribute.155 156What: /sys/class/scsi_host/host<n>/pkey157Date: June 17, 2006158KernelVersion: 2.6.17159Contact: linux-rdma@vger.kernel.org160Description: A 16-bit number representing the InfiniBand partition key used161 for communication with the SRP target.162 163What: /sys/class/scsi_host/host<n>/req_lim164Date: October 20, 2010165KernelVersion: 2.6.36166Contact: linux-rdma@vger.kernel.org167Description: Number of requests ib_srp can send to the target before it has168 to wait for more credits. For more information see also the169 SRP credit algorithm in the SRP specification.170 171What: /sys/class/scsi_host/host<n>/service_id172Date: June 17, 2006173KernelVersion: 2.6.17174Contact: linux-rdma@vger.kernel.org175Description: InfiniBand service ID used for establishing communication with176 the SRP target.177 178What: /sys/class/scsi_host/host<n>/sgid179Date: February 1, 2014180KernelVersion: 3.13181Contact: linux-rdma@vger.kernel.org182Description: InfiniBand GID of the source port used for communication with183 the SRP target.184 185What: /sys/class/scsi_host/host<n>/zero_req_lim186Date: September 20, 2006187KernelVersion: 2.6.18188Contact: linux-rdma@vger.kernel.org189Description: Number of times the initiator had to wait before sending a190 request to the target because it ran out of credits. For more191 information see also the SRP credit algorithm in the SRP192 specification.193