1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Copyright 2008 Cisco Systems, Inc. All rights reserved.
4 * Copyright 2007 Nuova Systems, Inc. All rights reserved.
5 */
6 #ifndef _FNIC_H_
7 #define _FNIC_H_
8
9 #include <linux/interrupt.h>
10 #include <linux/netdevice.h>
11 #include <linux/workqueue.h>
12 #include <linux/bitops.h>
13 #include <scsi/libfc.h>
14 #include <scsi/libfcoe.h>
15 #include "fnic_io.h"
16 #include "fnic_res.h"
17 #include "fnic_trace.h"
18 #include "fnic_stats.h"
19 #include "vnic_dev.h"
20 #include "vnic_wq.h"
21 #include "vnic_rq.h"
22 #include "vnic_cq.h"
23 #include "vnic_wq_copy.h"
24 #include "vnic_intr.h"
25 #include "vnic_stats.h"
26 #include "vnic_scsi.h"
27
28 #define DRV_NAME "fnic"
29 #define DRV_DESCRIPTION "Cisco FCoE HBA Driver"
30 #define DRV_VERSION "1.7.0.0"
31 #define PFX DRV_NAME ": "
32 #define DFX DRV_NAME "%d: "
33
34 #define DESC_CLEAN_LOW_WATERMARK 8
35 #define FNIC_UCSM_DFLT_THROTTLE_CNT_BLD 16 /* UCSM default throttle count */
36 #define FNIC_MIN_IO_REQ 256 /* Min IO throttle count */
37 #define FNIC_MAX_IO_REQ 1024 /* scsi_cmnd tag map entries */
38 #define FNIC_DFLT_IO_REQ 256 /* Default scsi_cmnd tag map entries */
39 #define FNIC_DFLT_QUEUE_DEPTH 256
40 #define FNIC_STATS_RATE_LIMIT 4 /* limit rate at which stats are pulled up */
41
42 /*
43 * Tag bits used for special requests.
44 */
45 #define FNIC_TAG_ABORT BIT(30) /* tag bit indicating abort */
46 #define FNIC_TAG_DEV_RST BIT(29) /* indicates device reset */
47 #define FNIC_TAG_MASK (BIT(24) - 1) /* mask for lookup */
48 #define FNIC_NO_TAG -1
49
50 /*
51 * Command flags to identify the type of command and for other future
52 * use.
53 */
54 #define FNIC_NO_FLAGS 0
55 #define FNIC_IO_INITIALIZED BIT(0)
56 #define FNIC_IO_ISSUED BIT(1)
57 #define FNIC_IO_DONE BIT(2)
58 #define FNIC_IO_REQ_NULL BIT(3)
59 #define FNIC_IO_ABTS_PENDING BIT(4)
60 #define FNIC_IO_ABORTED BIT(5)
61 #define FNIC_IO_ABTS_ISSUED BIT(6)
62 #define FNIC_IO_TERM_ISSUED BIT(7)
63 #define FNIC_IO_INTERNAL_TERM_ISSUED BIT(8)
64 #define FNIC_IO_ABT_TERM_DONE BIT(9)
65 #define FNIC_IO_ABT_TERM_REQ_NULL BIT(10)
66 #define FNIC_IO_ABT_TERM_TIMED_OUT BIT(11)
67 #define FNIC_DEVICE_RESET BIT(12) /* Device reset request */
68 #define FNIC_DEV_RST_ISSUED BIT(13)
69 #define FNIC_DEV_RST_TIMED_OUT BIT(14)
70 #define FNIC_DEV_RST_ABTS_ISSUED BIT(15)
71 #define FNIC_DEV_RST_TERM_ISSUED BIT(16)
72 #define FNIC_DEV_RST_DONE BIT(17)
73 #define FNIC_DEV_RST_REQ_NULL BIT(18)
74 #define FNIC_DEV_RST_ABTS_DONE BIT(19)
75 #define FNIC_DEV_RST_TERM_DONE BIT(20)
76 #define FNIC_DEV_RST_ABTS_PENDING BIT(21)
77
78 /*
79 * fnic private data per SCSI command.
80 * These fields are locked by the hashed io_req_lock.
81 */
82 struct fnic_cmd_priv {
83 struct fnic_io_req *io_req;
84 enum fnic_ioreq_state state;
85 u32 flags;
86 u16 abts_status;
87 u16 lr_status;
88 };
89
fnic_priv(struct scsi_cmnd * cmd)90 static inline struct fnic_cmd_priv *fnic_priv(struct scsi_cmnd *cmd)
91 {
92 return scsi_cmd_priv(cmd);
93 }
94
fnic_flags_and_state(struct scsi_cmnd * cmd)95 static inline u64 fnic_flags_and_state(struct scsi_cmnd *cmd)
96 {
97 struct fnic_cmd_priv *fcmd = fnic_priv(cmd);
98
99 return ((u64)fcmd->flags << 32) | fcmd->state;
100 }
101
102 #define FCPIO_INVALID_CODE 0x100 /* hdr_status value unused by firmware */
103
104 #define FNIC_LUN_RESET_TIMEOUT 10000 /* mSec */
105 #define FNIC_HOST_RESET_TIMEOUT 10000 /* mSec */
106 #define FNIC_RMDEVICE_TIMEOUT 1000 /* mSec */
107 #define FNIC_HOST_RESET_SETTLE_TIME 30 /* Sec */
108 #define FNIC_ABT_TERM_DELAY_TIMEOUT 500 /* mSec */
109
110 #define FNIC_MAX_FCP_TARGET 256
111 #define FNIC_PCI_OFFSET 2
112 /**
113 * state_flags to identify host state along along with fnic's state
114 **/
115 #define __FNIC_FLAGS_FWRESET BIT(0) /* fwreset in progress */
116 #define __FNIC_FLAGS_BLOCK_IO BIT(1) /* IOs are blocked */
117
118 #define FNIC_FLAGS_NONE (0)
119 #define FNIC_FLAGS_FWRESET (__FNIC_FLAGS_FWRESET | \
120 __FNIC_FLAGS_BLOCK_IO)
121
122 #define FNIC_FLAGS_IO_BLOCKED (__FNIC_FLAGS_BLOCK_IO)
123
124 #define fnic_set_state_flags(fnicp, st_flags) \
125 __fnic_set_state_flags(fnicp, st_flags, 0)
126
127 #define fnic_clear_state_flags(fnicp, st_flags) \
128 __fnic_set_state_flags(fnicp, st_flags, 1)
129
130 extern unsigned int fnic_log_level;
131 extern unsigned int io_completions;
132
133 #define FNIC_MAIN_LOGGING 0x01
134 #define FNIC_FCS_LOGGING 0x02
135 #define FNIC_SCSI_LOGGING 0x04
136 #define FNIC_ISR_LOGGING 0x08
137
138 #define FNIC_CHECK_LOGGING(LEVEL, CMD) \
139 do { \
140 if (unlikely(fnic_log_level & LEVEL)) \
141 do { \
142 CMD; \
143 } while (0); \
144 } while (0)
145
146 #define FNIC_MAIN_DBG(kern_level, host, fnic_num, fmt, args...) \
147 FNIC_CHECK_LOGGING(FNIC_MAIN_LOGGING, \
148 shost_printk(kern_level, host, \
149 "fnic<%d>: %s: %d: " fmt, fnic_num,\
150 __func__, __LINE__, ##args);)
151
152 #define FNIC_FCS_DBG(kern_level, host, fnic_num, fmt, args...) \
153 FNIC_CHECK_LOGGING(FNIC_FCS_LOGGING, \
154 shost_printk(kern_level, host, \
155 "fnic<%d>: %s: %d: " fmt, fnic_num,\
156 __func__, __LINE__, ##args);)
157
158 #define FNIC_SCSI_DBG(kern_level, host, fnic_num, fmt, args...) \
159 FNIC_CHECK_LOGGING(FNIC_SCSI_LOGGING, \
160 shost_printk(kern_level, host, \
161 "fnic<%d>: %s: %d: " fmt, fnic_num,\
162 __func__, __LINE__, ##args);)
163
164 #define FNIC_ISR_DBG(kern_level, host, fnic_num, fmt, args...) \
165 FNIC_CHECK_LOGGING(FNIC_ISR_LOGGING, \
166 shost_printk(kern_level, host, \
167 "fnic<%d>: %s: %d: " fmt, fnic_num,\
168 __func__, __LINE__, ##args);)
169
170 #define FNIC_MAIN_NOTE(kern_level, host, fmt, args...) \
171 shost_printk(kern_level, host, fmt, ##args)
172
173 #define FNIC_WQ_COPY_MAX 64
174 #define FNIC_WQ_MAX 1
175 #define FNIC_RQ_MAX 1
176 #define FNIC_CQ_MAX (FNIC_WQ_COPY_MAX + FNIC_WQ_MAX + FNIC_RQ_MAX)
177 #define FNIC_DFLT_IO_COMPLETIONS 256
178
179 #define FNIC_MQ_CQ_INDEX 2
180
181 extern const char *fnic_state_str[];
182
183 enum fnic_intx_intr_index {
184 FNIC_INTX_WQ_RQ_COPYWQ,
185 FNIC_INTX_DUMMY,
186 FNIC_INTX_NOTIFY,
187 FNIC_INTX_ERR,
188 FNIC_INTX_INTR_MAX,
189 };
190
191 enum fnic_msix_intr_index {
192 FNIC_MSIX_RQ,
193 FNIC_MSIX_WQ,
194 FNIC_MSIX_WQ_COPY,
195 FNIC_MSIX_ERR_NOTIFY = FNIC_MSIX_WQ_COPY + FNIC_WQ_COPY_MAX,
196 FNIC_MSIX_INTR_MAX,
197 };
198
199 struct fnic_msix_entry {
200 int requested;
201 char devname[IFNAMSIZ + 11];
202 irqreturn_t (*isr)(int, void *);
203 void *devid;
204 int irq_num;
205 };
206
207 enum fnic_state {
208 FNIC_IN_FC_MODE = 0,
209 FNIC_IN_FC_TRANS_ETH_MODE,
210 FNIC_IN_ETH_MODE,
211 FNIC_IN_ETH_TRANS_FC_MODE,
212 };
213
214 struct mempool;
215
216 enum fnic_evt {
217 FNIC_EVT_START_VLAN_DISC = 1,
218 FNIC_EVT_START_FCF_DISC = 2,
219 FNIC_EVT_MAX,
220 };
221
222 struct fnic_event {
223 struct list_head list;
224 struct fnic *fnic;
225 enum fnic_evt event;
226 };
227
228 struct fnic_cpy_wq {
229 unsigned long hw_lock_flags;
230 u16 active_ioreq_count;
231 u16 ioreq_table_size;
232 ____cacheline_aligned struct fnic_io_req **io_req_table;
233 };
234
235 /* Per-instance private data structure */
236 struct fnic {
237 int fnic_num;
238 struct fc_lport *lport;
239 struct fcoe_ctlr ctlr; /* FIP FCoE controller structure */
240 struct vnic_dev_bar bar0;
241
242 struct fnic_msix_entry msix[FNIC_MSIX_INTR_MAX];
243
244 struct vnic_stats *stats;
245 unsigned long stats_time; /* time of stats update */
246 unsigned long stats_reset_time; /* time of stats reset */
247 struct vnic_nic_cfg *nic_cfg;
248 char name[IFNAMSIZ];
249 struct timer_list notify_timer; /* used for MSI interrupts */
250
251 unsigned int fnic_max_tag_id;
252 unsigned int err_intr_offset;
253 unsigned int link_intr_offset;
254
255 unsigned int wq_count;
256 unsigned int cq_count;
257
258 struct mutex sgreset_mutex;
259 spinlock_t sgreset_lock; /* lock for sgreset */
260 struct scsi_cmnd *sgreset_sc;
261 struct dentry *fnic_stats_debugfs_host;
262 struct dentry *fnic_stats_debugfs_file;
263 struct dentry *fnic_reset_debugfs_file;
264 unsigned int reset_stats;
265 atomic64_t io_cmpl_skip;
266 struct fnic_stats fnic_stats;
267
268 u32 vlan_hw_insert:1; /* let hw insert the tag */
269 u32 in_remove:1; /* fnic device in removal */
270 u32 stop_rx_link_events:1; /* stop proc. rx frames, link events */
271 u32 link_events:1; /* set when we get any link event*/
272
273 struct completion *remove_wait; /* device remove thread blocks */
274
275 atomic_t in_flight; /* io counter */
276 bool internal_reset_inprogress;
277 u32 _reserved; /* fill hole */
278 unsigned long state_flags; /* protected by host lock */
279 enum fnic_state state;
280 spinlock_t fnic_lock;
281
282 u16 vlan_id; /* VLAN tag including priority */
283 u8 data_src_addr[ETH_ALEN];
284 u64 fcp_input_bytes; /* internal statistic */
285 u64 fcp_output_bytes; /* internal statistic */
286 u32 link_down_cnt;
287 int link_status;
288
289 struct list_head list;
290 struct pci_dev *pdev;
291 struct vnic_fc_config config;
292 struct vnic_dev *vdev;
293 unsigned int raw_wq_count;
294 unsigned int wq_copy_count;
295 unsigned int rq_count;
296 int fw_ack_index[FNIC_WQ_COPY_MAX];
297 unsigned short fw_ack_recd[FNIC_WQ_COPY_MAX];
298 unsigned short wq_copy_desc_low[FNIC_WQ_COPY_MAX];
299 unsigned int intr_count;
300 u32 __iomem *legacy_pba;
301 struct fnic_host_tag *tags;
302 mempool_t *io_req_pool;
303 mempool_t *io_sgl_pool[FNIC_SGL_NUM_CACHES];
304
305 unsigned int copy_wq_base;
306 struct work_struct link_work;
307 struct work_struct frame_work;
308 struct work_struct flush_work;
309 struct sk_buff_head frame_queue;
310 struct sk_buff_head tx_queue;
311
312 /*** FIP related data members -- start ***/
313 void (*set_vlan)(struct fnic *, u16 vlan);
314 struct work_struct fip_frame_work;
315 struct sk_buff_head fip_frame_queue;
316 struct timer_list fip_timer;
317 struct list_head vlans;
318 spinlock_t vlans_lock;
319
320 struct work_struct event_work;
321 struct list_head evlist;
322 /*** FIP related data members -- end ***/
323
324 /* copy work queue cache line section */
325 ____cacheline_aligned struct vnic_wq_copy hw_copy_wq[FNIC_WQ_COPY_MAX];
326 ____cacheline_aligned struct fnic_cpy_wq sw_copy_wq[FNIC_WQ_COPY_MAX];
327
328 /* completion queue cache line section */
329 ____cacheline_aligned struct vnic_cq cq[FNIC_CQ_MAX];
330
331 spinlock_t wq_copy_lock[FNIC_WQ_COPY_MAX];
332
333 /* work queue cache line section */
334 ____cacheline_aligned struct vnic_wq wq[FNIC_WQ_MAX];
335 spinlock_t wq_lock[FNIC_WQ_MAX];
336
337 /* receive queue cache line section */
338 ____cacheline_aligned struct vnic_rq rq[FNIC_RQ_MAX];
339
340 /* interrupt resource cache line section */
341 ____cacheline_aligned struct vnic_intr intr[FNIC_MSIX_INTR_MAX];
342 };
343
fnic_from_ctlr(struct fcoe_ctlr * fip)344 static inline struct fnic *fnic_from_ctlr(struct fcoe_ctlr *fip)
345 {
346 return container_of(fip, struct fnic, ctlr);
347 }
348
349 extern struct workqueue_struct *fnic_event_queue;
350 extern struct workqueue_struct *fnic_fip_queue;
351 extern const struct attribute_group *fnic_host_groups[];
352
353 void fnic_clear_intr_mode(struct fnic *fnic);
354 int fnic_set_intr_mode(struct fnic *fnic);
355 int fnic_set_intr_mode_msix(struct fnic *fnic);
356 void fnic_free_intr(struct fnic *fnic);
357 int fnic_request_intr(struct fnic *fnic);
358
359 int fnic_send(struct fc_lport *, struct fc_frame *);
360 void fnic_free_wq_buf(struct vnic_wq *wq, struct vnic_wq_buf *buf);
361 void fnic_handle_frame(struct work_struct *work);
362 void fnic_handle_link(struct work_struct *work);
363 void fnic_handle_event(struct work_struct *work);
364 int fnic_rq_cmpl_handler(struct fnic *fnic, int);
365 int fnic_alloc_rq_frame(struct vnic_rq *rq);
366 void fnic_free_rq_buf(struct vnic_rq *rq, struct vnic_rq_buf *buf);
367 void fnic_flush_tx(struct work_struct *work);
368 void fnic_eth_send(struct fcoe_ctlr *, struct sk_buff *skb);
369 void fnic_set_port_id(struct fc_lport *, u32, struct fc_frame *);
370 void fnic_update_mac(struct fc_lport *, u8 *new);
371 void fnic_update_mac_locked(struct fnic *, u8 *new);
372
373 int fnic_queuecommand(struct Scsi_Host *, struct scsi_cmnd *);
374 int fnic_abort_cmd(struct scsi_cmnd *);
375 int fnic_device_reset(struct scsi_cmnd *);
376 int fnic_host_reset(struct scsi_cmnd *);
377 int fnic_reset(struct Scsi_Host *);
378 void fnic_scsi_cleanup(struct fc_lport *);
379 void fnic_scsi_abort_io(struct fc_lport *);
380 void fnic_empty_scsi_cleanup(struct fc_lport *);
381 void fnic_exch_mgr_reset(struct fc_lport *, u32, u32);
382 int fnic_wq_copy_cmpl_handler(struct fnic *fnic, int copy_work_to_do, unsigned int cq_index);
383 int fnic_wq_cmpl_handler(struct fnic *fnic, int);
384 int fnic_flogi_reg_handler(struct fnic *fnic, u32);
385 void fnic_wq_copy_cleanup_handler(struct vnic_wq_copy *wq,
386 struct fcpio_host_req *desc);
387 int fnic_fw_reset_handler(struct fnic *fnic);
388 void fnic_terminate_rport_io(struct fc_rport *);
389 const char *fnic_state_to_str(unsigned int state);
390 void fnic_mq_map_queues_cpus(struct Scsi_Host *host);
391 void fnic_log_q_error(struct fnic *fnic);
392 void fnic_handle_link_event(struct fnic *fnic);
393
394 int fnic_is_abts_pending(struct fnic *, struct scsi_cmnd *);
395
396 void fnic_handle_fip_frame(struct work_struct *work);
397 void fnic_handle_fip_event(struct fnic *fnic);
398 void fnic_fcoe_reset_vlans(struct fnic *fnic);
399 void fnic_fcoe_evlist_free(struct fnic *fnic);
400 extern void fnic_handle_fip_timer(struct fnic *fnic);
401
402 static inline int
fnic_chk_state_flags_locked(struct fnic * fnic,unsigned long st_flags)403 fnic_chk_state_flags_locked(struct fnic *fnic, unsigned long st_flags)
404 {
405 return ((fnic->state_flags & st_flags) == st_flags);
406 }
407 void __fnic_set_state_flags(struct fnic *, unsigned long, unsigned long);
408 void fnic_dump_fchost_stats(struct Scsi_Host *, struct fc_host_statistics *);
409 #endif /* _FNIC_H_ */
410