hc
2023-10-25 6c2073b7aa40e29d0eca7d571dd7bc590c7ecaa7
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
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.
 
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.