hc
2023-12-09 b22da3d8526a935aa31e086e63f60ff3246cb61c
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
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
/*
 * Copyright (c) 2005 Cisco Systems.  All rights reserved.
 *
 * This software is available to you under a choice of one of two
 * licenses.  You may choose to be licensed under the terms of the GNU
 * General Public License (GPL) Version 2, available from the file
 * COPYING in the main directory of this source tree, or the
 * OpenIB.org BSD license below:
 *
 *     Redistribution and use in source and binary forms, with or
 *     without modification, are permitted provided that the following
 *     conditions are met:
 *
 *      - Redistributions of source code must retain the above
 *        copyright notice, this list of conditions and the following
 *        disclaimer.
 *
 *      - Redistributions in binary form must reproduce the above
 *        copyright notice, this list of conditions and the following
 *        disclaimer in the documentation and/or other materials
 *        provided with the distribution.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
 
#ifndef IB_SRP_H
#define IB_SRP_H
 
#include <linux/types.h>
#include <linux/list.h>
#include <linux/mutex.h>
#include <linux/scatterlist.h>
 
#include <scsi/scsi_host.h>
#include <scsi/scsi_cmnd.h>
 
#include <rdma/ib_verbs.h>
#include <rdma/ib_sa.h>
#include <rdma/ib_cm.h>
#include <rdma/rdma_cm.h>
 
enum {
   SRP_PATH_REC_TIMEOUT_MS    = 1000,
   SRP_ABORT_TIMEOUT_MS    = 5000,
 
   SRP_PORT_REDIRECT    = 1,
   SRP_DLID_REDIRECT    = 2,
   SRP_STALE_CONN        = 3,
 
   SRP_DEF_SG_TABLESIZE    = 12,
 
   SRP_DEFAULT_QUEUE_SIZE    = 1 << 6,
   SRP_RSP_SQ_SIZE        = 1,
   SRP_TSK_MGMT_SQ_SIZE    = 1,
   SRP_DEFAULT_CMD_SQ_SIZE = SRP_DEFAULT_QUEUE_SIZE - SRP_RSP_SQ_SIZE -
                 SRP_TSK_MGMT_SQ_SIZE,
 
   SRP_TAG_NO_REQ        = ~0U,
   SRP_TAG_TSK_MGMT    = 1U << 31,
 
   SRP_MAX_PAGES_PER_MR    = 512,
 
   SRP_MAX_ADD_CDB_LEN    = 16,
 
   SRP_MAX_IMM_SGE        = 2,
   SRP_MAX_SGE        = SRP_MAX_IMM_SGE + 1,
   /*
    * Choose the immediate data offset such that a 32 byte CDB still fits.
    */
   SRP_IMM_DATA_OFFSET    = sizeof(struct srp_cmd) +
                 SRP_MAX_ADD_CDB_LEN +
                 sizeof(struct srp_imm_buf),
};
 
enum srp_target_state {
   SRP_TARGET_SCANNING,
   SRP_TARGET_LIVE,
   SRP_TARGET_REMOVED,
};
 
enum srp_iu_type {
   SRP_IU_CMD,
   SRP_IU_TSK_MGMT,
   SRP_IU_RSP,
};
 
/*
 * @mr_page_mask: HCA memory registration page mask.
 * @mr_page_size: HCA memory registration page size.
 * @mr_max_size: Maximum size in bytes of a single FR registration request.
 */
struct srp_device {
   struct list_head    dev_list;
   struct ib_device       *dev;
   struct ib_pd           *pd;
   u32            global_rkey;
   u64            mr_page_mask;
   int            mr_page_size;
   int            mr_max_size;
   int            max_pages_per_mr;
   bool            has_fr;
   bool            use_fast_reg;
};
 
struct srp_host {
   struct srp_device      *srp_dev;
   u8            port;
   struct device        dev;
   struct list_head    target_list;
   spinlock_t        target_lock;
   struct completion    released;
   struct list_head    list;
   struct mutex        add_target_mutex;
};
 
struct srp_request {
   struct scsi_cmnd       *scmnd;
   struct srp_iu           *cmd;
   struct srp_fr_desc     **fr_list;
   struct srp_direct_buf  *indirect_desc;
   dma_addr_t        indirect_dma_addr;
   short            nmdesc;
   struct ib_cqe        reg_cqe;
};
 
/**
 * struct srp_rdma_ch
 * @comp_vector: Completion vector used by this RDMA channel.
 * @max_it_iu_len: Maximum initiator-to-target information unit length.
 * @max_ti_iu_len: Maximum target-to-initiator information unit length.
 */
struct srp_rdma_ch {
   /* These are RW in the hot path, and commonly used together */
   struct list_head    free_tx;
   spinlock_t        lock;
   s32            req_lim;
 
   /* These are read-only in the hot path */
   struct srp_target_port *target ____cacheline_aligned_in_smp;
   struct ib_cq           *send_cq;
   struct ib_cq           *recv_cq;
   struct ib_qp           *qp;
   struct srp_fr_pool     *fr_pool;
   uint32_t        max_it_iu_len;
   uint32_t        max_ti_iu_len;
   u8            max_imm_sge;
   bool            use_imm_data;
 
   /* Everything above this point is used in the hot path of
    * command processing. Try to keep them packed into cachelines.
    */
 
   struct completion    done;
   int            status;
 
   union {
       struct ib_cm {
           struct sa_path_rec    path;
           struct ib_sa_query    *path_query;
           int            path_query_id;
           struct ib_cm_id        *cm_id;
       } ib_cm;
       struct rdma_cm {
           struct rdma_cm_id    *cm_id;
       } rdma_cm;
   };
 
   struct srp_iu          **tx_ring;
   struct srp_iu          **rx_ring;
   struct srp_request     *req_ring;
   int            comp_vector;
 
   u64            tsk_mgmt_tag;
   struct completion    tsk_mgmt_done;
   u8            tsk_mgmt_status;
   bool            connected;
};
 
/**
 * struct srp_target_port
 * @comp_vector: Completion vector used by the first RDMA channel created for
 *   this target port.
 */
struct srp_target_port {
   /* read and written in the hot path */
   spinlock_t        lock;
 
   /* read only in the hot path */
   u32            global_rkey;
   struct srp_rdma_ch    *ch;
   struct net        *net;
   u32            ch_count;
   u32            lkey;
   enum srp_target_state    state;
   uint32_t        max_it_iu_size;
   unsigned int        cmd_sg_cnt;
   unsigned int        indirect_size;
   bool            allow_ext_sg;
 
   /* other member variables */
   union ib_gid        sgid;
   __be64            id_ext;
   __be64            ioc_guid;
   __be64            initiator_ext;
   u16            io_class;
   struct srp_host           *srp_host;
   struct Scsi_Host       *scsi_host;
   struct srp_rport       *rport;
   char            target_name[32];
   unsigned int        scsi_id;
   unsigned int        sg_tablesize;
   unsigned int        target_can_queue;
   int            mr_pool_size;
   int            mr_per_cmd;
   int            queue_size;
   int            req_ring_size;
   int            comp_vector;
   int            tl_retry_count;
 
   bool            using_rdma_cm;
 
   union {
       struct {
           __be64            service_id;
           union ib_gid        orig_dgid;
           __be16            pkey;
       } ib_cm;
       struct {
           union {
               struct sockaddr_in    ip4;
               struct sockaddr_in6    ip6;
               struct sockaddr        sa;
               struct sockaddr_storage ss;
           } src;
           union {
               struct sockaddr_in    ip4;
               struct sockaddr_in6    ip6;
               struct sockaddr        sa;
               struct sockaddr_storage ss;
           } dst;
           bool src_specified;
       } rdma_cm;
   };
 
   u32            rq_tmo_jiffies;
 
   int            zero_req_lim;
 
   struct work_struct    tl_err_work;
   struct work_struct    remove_work;
 
   struct list_head    list;
   bool            qp_in_error;
};
 
struct srp_iu {
   struct list_head    list;
   u64            dma;
   void               *buf;
   size_t            size;
   enum dma_data_direction    direction;
   u32            num_sge;
   struct ib_sge        sge[SRP_MAX_SGE];
   struct ib_cqe        cqe;
};
 
/**
 * struct srp_fr_desc - fast registration work request arguments
 * @entry: Entry in srp_fr_pool.free_list.
 * @mr:    Memory region.
 * @frpl:  Fast registration page list.
 */
struct srp_fr_desc {
   struct list_head        entry;
   struct ib_mr            *mr;
};
 
/**
 * struct srp_fr_pool - pool of fast registration descriptors
 *
 * An entry is available for allocation if and only if it occurs in @free_list.
 *
 * @size:      Number of descriptors in this pool.
 * @max_page_list_len: Maximum fast registration work request page list length.
 * @lock:      Protects free_list.
 * @free_list: List of free descriptors.
 * @desc:      Fast registration descriptor pool.
 */
struct srp_fr_pool {
   int            size;
   int            max_page_list_len;
   spinlock_t        lock;
   struct list_head    free_list;
   struct srp_fr_desc    desc[];
};
 
/**
 * struct srp_map_state - per-request DMA memory mapping state
 * @desc:        Pointer to the element of the SRP buffer descriptor array
 *            that is being filled in.
 * @pages:        Array with DMA addresses of pages being considered for
 *            memory registration.
 * @base_dma_addr:  DMA address of the first page that has not yet been mapped.
 * @dma_len:        Number of bytes that will be registered with the next FR
 *                  memory registration call.
 * @total_len:        Total number of bytes in the sg-list being mapped.
 * @npages:        Number of page addresses in the pages[] array.
 * @nmdesc:        Number of FR memory descriptors used for mapping.
 * @ndesc:        Number of SRP buffer descriptors that have been filled in.
 */
struct srp_map_state {
   union {
       struct {
           struct srp_fr_desc **next;
           struct srp_fr_desc **end;
       } fr;
       struct {
           void           **next;
           void           **end;
       } gen;
   };
   struct srp_direct_buf  *desc;
   union {
       u64            *pages;
       struct scatterlist    *sg;
   };
   dma_addr_t        base_dma_addr;
   u32            dma_len;
   u32            total_len;
   unsigned int        npages;
   unsigned int        nmdesc;
   unsigned int        ndesc;
};
 
#endif /* IB_SRP_H */