1 /*
2  * iSER transport for the Open iSCSI Initiator & iSER transport internals
3  *
4  * Copyright (C) 2004 Dmitry Yusupov
5  * Copyright (C) 2004 Alex Aizman
6  * Copyright (C) 2005 Mike Christie
7  * based on code maintained by open-iscsi@googlegroups.com
8  *
9  * Copyright (c) 2004, 2005, 2006 Voltaire, Inc. All rights reserved.
10  * Copyright (c) 2005, 2006 Cisco Systems.  All rights reserved.
11  * Copyright (c) 2013-2014 Mellanox Technologies. All rights reserved.
12  *
13  * This software is available to you under a choice of one of two
14  * licenses.  You may choose to be licensed under the terms of the GNU
15  * General Public License (GPL) Version 2, available from the file
16  * COPYING in the main directory of this source tree, or the
17  * OpenIB.org BSD license below:
18  *
19  *     Redistribution and use in source and binary forms, with or
20  *     without modification, are permitted provided that the following
21  *     conditions are met:
22  *
23  *	- Redistributions of source code must retain the above
24  *	  copyright notice, this list of conditions and the following
25  *	  disclaimer.
26  *
27  *	- Redistributions in binary form must reproduce the above
28  *	  copyright notice, this list of conditions and the following
29  *	  disclaimer in the documentation and/or other materials
30  *	  provided with the distribution.
31  *
32  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
33  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
34  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
35  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
36  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
37  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
38  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
39  * SOFTWARE.
40  */
41 #ifndef __ISCSI_ISER_H__
42 #define __ISCSI_ISER_H__
43 
44 #include <linux/types.h>
45 #include <linux/net.h>
46 #include <linux/printk.h>
47 #include <scsi/libiscsi.h>
48 #include <scsi/scsi_transport_iscsi.h>
49 #include <scsi/scsi_cmnd.h>
50 #include <scsi/scsi_device.h>
51 
52 #include <linux/interrupt.h>
53 #include <linux/wait.h>
54 #include <linux/sched.h>
55 #include <linux/list.h>
56 #include <linux/slab.h>
57 #include <linux/dma-mapping.h>
58 #include <linux/mutex.h>
59 #include <linux/mempool.h>
60 #include <linux/uio.h>
61 
62 #include <linux/socket.h>
63 #include <linux/in.h>
64 #include <linux/in6.h>
65 
66 #include <rdma/ib_verbs.h>
67 #include <rdma/ib_fmr_pool.h>
68 #include <rdma/rdma_cm.h>
69 
70 #define DRV_NAME	"iser"
71 #define PFX		DRV_NAME ": "
72 #define DRV_VER		"1.6"
73 
74 #define iser_dbg(fmt, arg...)				 \
75 	do {						 \
76 		if (unlikely(iser_debug_level > 2))	 \
77 			printk(KERN_DEBUG PFX "%s: " fmt,\
78 				__func__ , ## arg);	 \
79 	} while (0)
80 
81 #define iser_warn(fmt, arg...)				\
82 	do {						\
83 		if (unlikely(iser_debug_level > 0))	\
84 			pr_warn(PFX "%s: " fmt,		\
85 				__func__ , ## arg);	\
86 	} while (0)
87 
88 #define iser_info(fmt, arg...)				\
89 	do {						\
90 		if (unlikely(iser_debug_level > 1))	\
91 			pr_info(PFX "%s: " fmt,		\
92 				__func__ , ## arg);	\
93 	} while (0)
94 
95 #define iser_err(fmt, arg...) \
96 	pr_err(PFX "%s: " fmt, __func__ , ## arg)
97 
98 #define SHIFT_4K	12
99 #define SIZE_4K	(1ULL << SHIFT_4K)
100 #define MASK_4K	(~(SIZE_4K-1))
101 
102 /* Default support is 512KB I/O size */
103 #define ISER_DEF_MAX_SECTORS		1024
104 #define ISCSI_ISER_DEF_SG_TABLESIZE	((ISER_DEF_MAX_SECTORS * 512) >> SHIFT_4K)
105 /* Maximum support is 8MB I/O size */
106 #define ISCSI_ISER_MAX_SG_TABLESIZE	((16384 * 512) >> SHIFT_4K)
107 
108 #define ISER_DEF_XMIT_CMDS_DEFAULT		512
109 #if ISCSI_DEF_XMIT_CMDS_MAX > ISER_DEF_XMIT_CMDS_DEFAULT
110 	#define ISER_DEF_XMIT_CMDS_MAX		ISCSI_DEF_XMIT_CMDS_MAX
111 #else
112 	#define ISER_DEF_XMIT_CMDS_MAX		ISER_DEF_XMIT_CMDS_DEFAULT
113 #endif
114 #define ISER_DEF_CMD_PER_LUN		ISER_DEF_XMIT_CMDS_MAX
115 
116 /* QP settings */
117 /* Maximal bounds on received asynchronous PDUs */
118 #define ISER_MAX_RX_MISC_PDUS		4 /* NOOP_IN(2) , ASYNC_EVENT(2)   */
119 
120 #define ISER_MAX_TX_MISC_PDUS		6 /* NOOP_OUT(2), TEXT(1),         *
121 					   * SCSI_TMFUNC(2), LOGOUT(1) */
122 
123 #define ISER_QP_MAX_RECV_DTOS		(ISER_DEF_XMIT_CMDS_MAX)
124 
125 #define ISER_MIN_POSTED_RX		(ISER_DEF_XMIT_CMDS_MAX >> 2)
126 
127 /* the max TX (send) WR supported by the iSER QP is defined by                 *
128  * max_send_wr = T * (1 + D) + C ; D is how many inflight dataouts we expect   *
129  * to have at max for SCSI command. The tx posting & completion handling code  *
130  * supports -EAGAIN scheme where tx is suspended till the QP has room for more *
131  * send WR. D=8 comes from 64K/8K                                              */
132 
133 #define ISER_INFLIGHT_DATAOUTS		8
134 
135 #define ISER_QP_MAX_REQ_DTOS		(ISER_DEF_XMIT_CMDS_MAX *    \
136 					(1 + ISER_INFLIGHT_DATAOUTS) + \
137 					ISER_MAX_TX_MISC_PDUS        + \
138 					ISER_MAX_RX_MISC_PDUS)
139 
140 /* Max registration work requests per command */
141 #define ISER_MAX_REG_WR_PER_CMD		5
142 
143 /* For Signature we don't support DATAOUTs so no need to make room for them */
144 #define ISER_QP_SIG_MAX_REQ_DTOS	(ISER_DEF_XMIT_CMDS_MAX	*       \
145 					(1 + ISER_MAX_REG_WR_PER_CMD) + \
146 					ISER_MAX_TX_MISC_PDUS         + \
147 					ISER_MAX_RX_MISC_PDUS)
148 
149 #define ISER_GET_MAX_XMIT_CMDS(send_wr) ((send_wr			\
150 					 - ISER_MAX_TX_MISC_PDUS	\
151 					 - ISER_MAX_RX_MISC_PDUS) /	\
152 					 (1 + ISER_INFLIGHT_DATAOUTS))
153 
154 #define ISER_WC_BATCH_COUNT   16
155 #define ISER_SIGNAL_CMD_COUNT 32
156 
157 #define ISER_VER			0x10
158 #define ISER_WSV			0x08
159 #define ISER_RSV			0x04
160 
161 #define ISER_FASTREG_LI_WRID		0xffffffffffffffffULL
162 #define ISER_BEACON_WRID		0xfffffffffffffffeULL
163 
164 /**
165  * struct iser_hdr - iSER header
166  *
167  * @flags:        flags support (zbva, remote_inv)
168  * @rsvd:         reserved
169  * @write_stag:   write rkey
170  * @write_va:     write virtual address
171  * @reaf_stag:    read rkey
172  * @read_va:      read virtual address
173  */
174 struct iser_hdr {
175 	u8      flags;
176 	u8      rsvd[3];
177 	__be32  write_stag;
178 	__be64  write_va;
179 	__be32  read_stag;
180 	__be64  read_va;
181 } __attribute__((packed));
182 
183 
184 #define ISER_ZBVA_NOT_SUPPORTED		0x80
185 #define ISER_SEND_W_INV_NOT_SUPPORTED	0x40
186 
187 struct iser_cm_hdr {
188 	u8      flags;
189 	u8      rsvd[3];
190 } __packed;
191 
192 /* Constant PDU lengths calculations */
193 #define ISER_HEADERS_LEN  (sizeof(struct iser_hdr) + sizeof(struct iscsi_hdr))
194 
195 #define ISER_RECV_DATA_SEG_LEN	128
196 #define ISER_RX_PAYLOAD_SIZE	(ISER_HEADERS_LEN + ISER_RECV_DATA_SEG_LEN)
197 #define ISER_RX_LOGIN_SIZE	(ISER_HEADERS_LEN + ISCSI_DEF_MAX_RECV_SEG_LEN)
198 
199 /* Length of an object name string */
200 #define ISER_OBJECT_NAME_SIZE		    64
201 
202 enum iser_conn_state {
203 	ISER_CONN_INIT,		   /* descriptor allocd, no conn          */
204 	ISER_CONN_PENDING,	   /* in the process of being established */
205 	ISER_CONN_UP,		   /* up and running                      */
206 	ISER_CONN_TERMINATING,	   /* in the process of being terminated  */
207 	ISER_CONN_DOWN,		   /* shut down                           */
208 	ISER_CONN_STATES_NUM
209 };
210 
211 enum iser_task_status {
212 	ISER_TASK_STATUS_INIT = 0,
213 	ISER_TASK_STATUS_STARTED,
214 	ISER_TASK_STATUS_COMPLETED
215 };
216 
217 enum iser_data_dir {
218 	ISER_DIR_IN = 0,	   /* to initiator */
219 	ISER_DIR_OUT,		   /* from initiator */
220 	ISER_DIRS_NUM
221 };
222 
223 /**
224  * struct iser_data_buf - iSER data buffer
225  *
226  * @sg:           pointer to the sg list
227  * @size:         num entries of this sg
228  * @data_len:     total beffer byte len
229  * @dma_nents:    returned by dma_map_sg
230  * @orig_sg:      pointer to the original sg list (in case
231  *                we used a copy)
232  * @orig_size:    num entris of orig sg list
233  */
234 struct iser_data_buf {
235 	struct scatterlist *sg;
236 	unsigned int       size;
237 	unsigned long      data_len;
238 	unsigned int       dma_nents;
239 	struct scatterlist *orig_sg;
240 	unsigned int       orig_size;
241   };
242 
243 /* fwd declarations */
244 struct iser_device;
245 struct iscsi_iser_task;
246 struct iscsi_endpoint;
247 struct iser_reg_resources;
248 
249 /**
250  * struct iser_mem_reg - iSER memory registration info
251  *
252  * @sge:          memory region sg element
253  * @rkey:         memory region remote key
254  * @mem_h:        pointer to registration context (FMR/Fastreg)
255  */
256 struct iser_mem_reg {
257 	struct ib_sge	 sge;
258 	u32		 rkey;
259 	void		*mem_h;
260 };
261 
262 enum iser_desc_type {
263 	ISCSI_TX_CONTROL ,
264 	ISCSI_TX_SCSI_COMMAND,
265 	ISCSI_TX_DATAOUT
266 };
267 
268 /* Maximum number of work requests per task:
269  * Data memory region local invalidate + fast registration
270  * Protection memory region local invalidate + fast registration
271  * Signature memory region local invalidate + fast registration
272  * PDU send
273  */
274 #define ISER_MAX_WRS 7
275 
276 /**
277  * struct iser_tx_desc - iSER TX descriptor (for send wr_id)
278  *
279  * @iser_header:   iser header
280  * @iscsi_header:  iscsi header
281  * @type:          command/control/dataout
282  * @dam_addr:      header buffer dma_address
283  * @tx_sg:         sg[0] points to iser/iscsi headers
284  *                 sg[1] optionally points to either of immediate data
285  *                 unsolicited data-out or control
286  * @num_sge:       number sges used on this TX task
287  * @mapped:        Is the task header mapped
288  * @wr_idx:        Current WR index
289  * @wrs:           Array of WRs per task
290  * @data_reg:      Data buffer registration details
291  * @prot_reg:      Protection buffer registration details
292  * @sig_attrs:     Signature attributes
293  */
294 struct iser_tx_desc {
295 	struct iser_hdr              iser_header;
296 	struct iscsi_hdr             iscsi_header;
297 	enum   iser_desc_type        type;
298 	u64		             dma_addr;
299 	struct ib_sge		     tx_sg[2];
300 	int                          num_sge;
301 	bool			     mapped;
302 	u8                           wr_idx;
303 	union iser_wr {
304 		struct ib_send_wr		send;
305 		struct ib_fast_reg_wr		fast_reg;
306 		struct ib_sig_handover_wr	sig;
307 	} wrs[ISER_MAX_WRS];
308 	struct iser_mem_reg          data_reg;
309 	struct iser_mem_reg          prot_reg;
310 	struct ib_sig_attrs          sig_attrs;
311 };
312 
313 #define ISER_RX_PAD_SIZE	(256 - (ISER_RX_PAYLOAD_SIZE + \
314 					sizeof(u64) + sizeof(struct ib_sge)))
315 /**
316  * struct iser_rx_desc - iSER RX descriptor (for recv wr_id)
317  *
318  * @iser_header:   iser header
319  * @iscsi_header:  iscsi header
320  * @data:          received data segment
321  * @dma_addr:      receive buffer dma address
322  * @rx_sg:         ib_sge of receive buffer
323  * @pad:           for sense data TODO: Modify to maximum sense length supported
324  */
325 struct iser_rx_desc {
326 	struct iser_hdr              iser_header;
327 	struct iscsi_hdr             iscsi_header;
328 	char		             data[ISER_RECV_DATA_SEG_LEN];
329 	u64		             dma_addr;
330 	struct ib_sge		     rx_sg;
331 	char		             pad[ISER_RX_PAD_SIZE];
332 } __attribute__((packed));
333 
334 struct iser_conn;
335 struct ib_conn;
336 struct iscsi_iser_task;
337 
338 /**
339  * struct iser_comp - iSER completion context
340  *
341  * @device:     pointer to device handle
342  * @cq:         completion queue
343  * @wcs:        work completion array
344  * @tasklet:    Tasklet handle
345  * @active_qps: Number of active QPs attached
346  *              to completion context
347  */
348 struct iser_comp {
349 	struct iser_device      *device;
350 	struct ib_cq		*cq;
351 	struct ib_wc		 wcs[ISER_WC_BATCH_COUNT];
352 	struct tasklet_struct	 tasklet;
353 	int                      active_qps;
354 };
355 
356 /**
357  * struct iser_device - Memory registration operations
358  *     per-device registration schemes
359  *
360  * @alloc_reg_res:     Allocate registration resources
361  * @free_reg_res:      Free registration resources
362  * @fast_reg_mem:      Register memory buffers
363  * @unreg_mem:         Un-register memory buffers
364  * @reg_desc_get:      Get a registration descriptor for pool
365  * @reg_desc_put:      Get a registration descriptor to pool
366  */
367 struct iser_reg_ops {
368 	int            (*alloc_reg_res)(struct ib_conn *ib_conn,
369 					unsigned cmds_max,
370 					unsigned int size);
371 	void           (*free_reg_res)(struct ib_conn *ib_conn);
372 	int            (*reg_mem)(struct iscsi_iser_task *iser_task,
373 				  struct iser_data_buf *mem,
374 				  struct iser_reg_resources *rsc,
375 				  struct iser_mem_reg *reg);
376 	void           (*unreg_mem)(struct iscsi_iser_task *iser_task,
377 				    enum iser_data_dir cmd_dir);
378 	struct iser_fr_desc * (*reg_desc_get)(struct ib_conn *ib_conn);
379 	void           (*reg_desc_put)(struct ib_conn *ib_conn,
380 				       struct iser_fr_desc *desc);
381 };
382 
383 /**
384  * struct iser_device - iSER device handle
385  *
386  * @ib_device:     RDMA device
387  * @pd:            Protection Domain for this device
388  * @dev_attr:      Device attributes container
389  * @mr:            Global DMA memory region
390  * @event_handler: IB events handle routine
391  * @ig_list:	   entry in devices list
392  * @refcount:      Reference counter, dominated by open iser connections
393  * @comps_used:    Number of completion contexts used, Min between online
394  *                 cpus and device max completion vectors
395  * @comps:         Dinamically allocated array of completion handlers
396  * @reg_ops:       Registration ops
397  */
398 struct iser_device {
399 	struct ib_device             *ib_device;
400 	struct ib_pd	             *pd;
401 	struct ib_device_attr	     dev_attr;
402 	struct ib_mr	             *mr;
403 	struct ib_event_handler      event_handler;
404 	struct list_head             ig_list;
405 	int                          refcount;
406 	int			     comps_used;
407 	struct iser_comp	     *comps;
408 	struct iser_reg_ops          *reg_ops;
409 };
410 
411 #define ISER_CHECK_GUARD	0xc0
412 #define ISER_CHECK_REFTAG	0x0f
413 #define ISER_CHECK_APPTAG	0x30
414 
415 /**
416  * struct iser_reg_resources - Fast registration recources
417  *
418  * @mr:         memory region
419  * @fmr_pool:   pool of fmrs
420  * @frpl:       fast reg page list used by frwrs
421  * @page_vec:   fast reg page list used by fmr pool
422  * @mr_valid:   is mr valid indicator
423  */
424 struct iser_reg_resources {
425 	union {
426 		struct ib_mr             *mr;
427 		struct ib_fmr_pool       *fmr_pool;
428 	};
429 	union {
430 		struct ib_fast_reg_page_list     *frpl;
431 		struct iser_page_vec             *page_vec;
432 	};
433 	u8				  mr_valid:1;
434 };
435 
436 /**
437  * struct iser_pi_context - Protection information context
438  *
439  * @rsc:             protection buffer registration resources
440  * @sig_mr:          signature enable memory region
441  * @sig_mr_valid:    is sig_mr valid indicator
442  * @sig_protected:   is region protected indicator
443  */
444 struct iser_pi_context {
445 	struct iser_reg_resources	rsc;
446 	struct ib_mr                   *sig_mr;
447 	u8                              sig_mr_valid:1;
448 	u8                              sig_protected:1;
449 };
450 
451 /**
452  * struct iser_fr_desc - Fast registration descriptor
453  *
454  * @list:           entry in connection fastreg pool
455  * @rsc:            data buffer registration resources
456  * @pi_ctx:         protection information context
457  */
458 struct iser_fr_desc {
459 	struct list_head		  list;
460 	struct iser_reg_resources	  rsc;
461 	struct iser_pi_context		 *pi_ctx;
462 };
463 
464 /**
465  * struct iser_fr_pool: connection fast registration pool
466  *
467  * @list:                list of fastreg descriptors
468  * @lock:                protects fmr/fastreg pool
469  * @size:                size of the pool
470  */
471 struct iser_fr_pool {
472 	struct list_head        list;
473 	spinlock_t              lock;
474 	int                     size;
475 };
476 
477 /**
478  * struct ib_conn - Infiniband related objects
479  *
480  * @cma_id:              rdma_cm connection maneger handle
481  * @qp:                  Connection Queue-pair
482  * @post_recv_buf_count: post receive counter
483  * @sig_count:           send work request signal count
484  * @rx_wr:               receive work request for batch posts
485  * @device:              reference to iser device
486  * @comp:                iser completion context
487  * @pi_support:          Indicate device T10-PI support
488  * @beacon:              beacon send wr to signal all flush errors were drained
489  * @flush_comp:          completes when all connection completions consumed
490  * @fr_pool:             connection fast registration poool
491  */
492 struct ib_conn {
493 	struct rdma_cm_id           *cma_id;
494 	struct ib_qp	            *qp;
495 	int                          post_recv_buf_count;
496 	u8                           sig_count;
497 	struct ib_recv_wr	     rx_wr[ISER_MIN_POSTED_RX];
498 	struct iser_device          *device;
499 	struct iser_comp	    *comp;
500 	bool			     pi_support;
501 	struct ib_send_wr	     beacon;
502 	struct completion	     flush_comp;
503 	struct iser_fr_pool          fr_pool;
504 };
505 
506 /**
507  * struct iser_conn - iSER connection context
508  *
509  * @ib_conn:          connection RDMA resources
510  * @iscsi_conn:       link to matching iscsi connection
511  * @ep:               transport handle
512  * @state:            connection logical state
513  * @qp_max_recv_dtos: maximum number of data outs, corresponds
514  *                    to max number of post recvs
515  * @qp_max_recv_dtos_mask: (qp_max_recv_dtos - 1)
516  * @min_posted_rx:    (qp_max_recv_dtos >> 2)
517  * @max_cmds:         maximum cmds allowed for this connection
518  * @name:             connection peer portal
519  * @release_work:     deffered work for release job
520  * @state_mutex:      protects iser onnection state
521  * @stop_completion:  conn_stop completion
522  * @ib_completion:    RDMA cleanup completion
523  * @up_completion:    connection establishment completed
524  *                    (state is ISER_CONN_UP)
525  * @conn_list:        entry in ig conn list
526  * @login_buf:        login data buffer (stores login parameters)
527  * @login_req_buf:    login request buffer
528  * @login_req_dma:    login request buffer dma address
529  * @login_resp_buf:   login response buffer
530  * @login_resp_dma:   login response buffer dma address
531  * @rx_desc_head:     head of rx_descs cyclic buffer
532  * @rx_descs:         rx buffers array (cyclic buffer)
533  * @num_rx_descs:     number of rx descriptors
534  * @scsi_sg_tablesize: scsi host sg_tablesize
535  * @scsi_max_sectors: scsi host max sectors
536  */
537 struct iser_conn {
538 	struct ib_conn		     ib_conn;
539 	struct iscsi_conn	     *iscsi_conn;
540 	struct iscsi_endpoint	     *ep;
541 	enum iser_conn_state	     state;
542 	unsigned		     qp_max_recv_dtos;
543 	unsigned		     qp_max_recv_dtos_mask;
544 	unsigned		     min_posted_rx;
545 	u16                          max_cmds;
546 	char 			     name[ISER_OBJECT_NAME_SIZE];
547 	struct work_struct	     release_work;
548 	struct mutex		     state_mutex;
549 	struct completion	     stop_completion;
550 	struct completion	     ib_completion;
551 	struct completion	     up_completion;
552 	struct list_head	     conn_list;
553 
554 	char  			     *login_buf;
555 	char			     *login_req_buf, *login_resp_buf;
556 	u64			     login_req_dma, login_resp_dma;
557 	unsigned int 		     rx_desc_head;
558 	struct iser_rx_desc	     *rx_descs;
559 	u32                          num_rx_descs;
560 	unsigned short               scsi_sg_tablesize;
561 	unsigned int                 scsi_max_sectors;
562 };
563 
564 /**
565  * struct iscsi_iser_task - iser task context
566  *
567  * @desc:     TX descriptor
568  * @iser_conn:        link to iser connection
569  * @status:           current task status
570  * @sc:               link to scsi command
571  * @command_sent:     indicate if command was sent
572  * @dir:              iser data direction
573  * @rdma_reg:         task rdma registration desc
574  * @data:             iser data buffer desc
575  * @prot:             iser protection buffer desc
576  */
577 struct iscsi_iser_task {
578 	struct iser_tx_desc          desc;
579 	struct iser_conn	     *iser_conn;
580 	enum iser_task_status 	     status;
581 	struct scsi_cmnd	     *sc;
582 	int                          command_sent;
583 	int                          dir[ISER_DIRS_NUM];
584 	struct iser_mem_reg          rdma_reg[ISER_DIRS_NUM];
585 	struct iser_data_buf         data[ISER_DIRS_NUM];
586 	struct iser_data_buf         prot[ISER_DIRS_NUM];
587 };
588 
589 struct iser_page_vec {
590 	u64 *pages;
591 	int length;
592 	int offset;
593 	int data_size;
594 };
595 
596 /**
597  * struct iser_global: iSER global context
598  *
599  * @device_list_mutex:    protects device_list
600  * @device_list:          iser devices global list
601  * @connlist_mutex:       protects connlist
602  * @connlist:             iser connections global list
603  * @desc_cache:           kmem cache for tx dataout
604  */
605 struct iser_global {
606 	struct mutex      device_list_mutex;
607 	struct list_head  device_list;
608 	struct mutex      connlist_mutex;
609 	struct list_head  connlist;
610 	struct kmem_cache *desc_cache;
611 };
612 
613 extern struct iser_global ig;
614 extern int iser_debug_level;
615 extern bool iser_pi_enable;
616 extern int iser_pi_guard;
617 extern unsigned int iser_max_sectors;
618 extern bool iser_always_reg;
619 
620 int iser_assign_reg_ops(struct iser_device *device);
621 
622 int iser_send_control(struct iscsi_conn *conn,
623 		      struct iscsi_task *task);
624 
625 int iser_send_command(struct iscsi_conn *conn,
626 		      struct iscsi_task *task);
627 
628 int iser_send_data_out(struct iscsi_conn *conn,
629 		       struct iscsi_task *task,
630 		       struct iscsi_data *hdr);
631 
632 void iscsi_iser_recv(struct iscsi_conn *conn,
633 		     struct iscsi_hdr *hdr,
634 		     char *rx_data,
635 		     int rx_data_len);
636 
637 void iser_conn_init(struct iser_conn *iser_conn);
638 
639 void iser_conn_release(struct iser_conn *iser_conn);
640 
641 int iser_conn_terminate(struct iser_conn *iser_conn);
642 
643 void iser_release_work(struct work_struct *work);
644 
645 void iser_rcv_completion(struct iser_rx_desc *desc,
646 			 unsigned long dto_xfer_len,
647 			 struct ib_conn *ib_conn);
648 
649 void iser_snd_completion(struct iser_tx_desc *desc,
650 			 struct ib_conn *ib_conn);
651 
652 void iser_task_rdma_init(struct iscsi_iser_task *task);
653 
654 void iser_task_rdma_finalize(struct iscsi_iser_task *task);
655 
656 void iser_free_rx_descriptors(struct iser_conn *iser_conn);
657 
658 void iser_finalize_rdma_unaligned_sg(struct iscsi_iser_task *iser_task,
659 				     struct iser_data_buf *mem,
660 				     enum iser_data_dir cmd_dir);
661 
662 int iser_reg_rdma_mem(struct iscsi_iser_task *task,
663 		      enum iser_data_dir dir);
664 void iser_unreg_rdma_mem(struct iscsi_iser_task *task,
665 			 enum iser_data_dir dir);
666 
667 int  iser_connect(struct iser_conn *iser_conn,
668 		  struct sockaddr *src_addr,
669 		  struct sockaddr *dst_addr,
670 		  int non_blocking);
671 
672 void iser_unreg_mem_fmr(struct iscsi_iser_task *iser_task,
673 			enum iser_data_dir cmd_dir);
674 void iser_unreg_mem_fastreg(struct iscsi_iser_task *iser_task,
675 			    enum iser_data_dir cmd_dir);
676 
677 int  iser_post_recvl(struct iser_conn *iser_conn);
678 int  iser_post_recvm(struct iser_conn *iser_conn, int count);
679 int  iser_post_send(struct ib_conn *ib_conn, struct iser_tx_desc *tx_desc,
680 		    bool signal);
681 
682 int iser_dma_map_task_data(struct iscsi_iser_task *iser_task,
683 			   struct iser_data_buf *data,
684 			   enum iser_data_dir iser_dir,
685 			   enum dma_data_direction dma_dir);
686 
687 void iser_dma_unmap_task_data(struct iscsi_iser_task *iser_task,
688 			      struct iser_data_buf *data,
689 			      enum dma_data_direction dir);
690 
691 int  iser_initialize_task_headers(struct iscsi_task *task,
692 			struct iser_tx_desc *tx_desc);
693 int iser_alloc_rx_descriptors(struct iser_conn *iser_conn,
694 			      struct iscsi_session *session);
695 int iser_alloc_fmr_pool(struct ib_conn *ib_conn,
696 			unsigned cmds_max,
697 			unsigned int size);
698 void iser_free_fmr_pool(struct ib_conn *ib_conn);
699 int iser_alloc_fastreg_pool(struct ib_conn *ib_conn,
700 			    unsigned cmds_max,
701 			    unsigned int size);
702 void iser_free_fastreg_pool(struct ib_conn *ib_conn);
703 u8 iser_check_task_pi_status(struct iscsi_iser_task *iser_task,
704 			     enum iser_data_dir cmd_dir, sector_t *sector);
705 struct iser_fr_desc *
706 iser_reg_desc_get_fr(struct ib_conn *ib_conn);
707 void
708 iser_reg_desc_put_fr(struct ib_conn *ib_conn,
709 		     struct iser_fr_desc *desc);
710 struct iser_fr_desc *
711 iser_reg_desc_get_fmr(struct ib_conn *ib_conn);
712 void
713 iser_reg_desc_put_fmr(struct ib_conn *ib_conn,
714 		      struct iser_fr_desc *desc);
715 
716 static inline struct ib_send_wr *
717 iser_tx_next_wr(struct iser_tx_desc *tx_desc)
718 {
719 	struct ib_send_wr *cur_wr = &tx_desc->wrs[tx_desc->wr_idx].send;
720 	struct ib_send_wr *last_wr;
721 
722 	if (tx_desc->wr_idx) {
723 		last_wr = &tx_desc->wrs[tx_desc->wr_idx - 1].send;
724 		last_wr->next = cur_wr;
725 	}
726 	tx_desc->wr_idx++;
727 
728 	return cur_wr;
729 }
730 
731 #endif
732