GNU Linux-libre 5.19-rc6-gnu
[releases.git] / drivers / scsi / bfa / bfad_im.h
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (c) 2005-2014 Brocade Communications Systems, Inc.
4  * Copyright (c) 2014- QLogic Corporation.
5  * All rights reserved
6  * www.qlogic.com
7  *
8  * Linux driver for QLogic BR-series Fibre Channel Host Bus Adapter.
9  */
10
11 #ifndef __BFAD_IM_H__
12 #define __BFAD_IM_H__
13
14 #include "bfa_fcs.h"
15
16 #define FCPI_NAME " fcpim"
17
18 #ifndef KOBJ_NAME_LEN
19 #define KOBJ_NAME_LEN           20
20 #endif
21
22 bfa_status_t bfad_im_module_init(void);
23 void bfad_im_module_exit(void);
24 bfa_status_t bfad_im_probe(struct bfad_s *bfad);
25 void bfad_im_probe_undo(struct bfad_s *bfad);
26 bfa_status_t bfad_im_port_new(struct bfad_s *bfad, struct bfad_port_s *port);
27 void bfad_im_port_delete(struct bfad_s *bfad, struct bfad_port_s *port);
28 void bfad_im_port_clean(struct bfad_im_port_s *im_port);
29 int  bfad_im_scsi_host_alloc(struct bfad_s *bfad,
30                 struct bfad_im_port_s *im_port, struct device *dev);
31 void bfad_im_scsi_host_free(struct bfad_s *bfad,
32                                 struct bfad_im_port_s *im_port);
33 u32 bfad_im_supported_speeds(struct bfa_s *bfa);
34
35 #define MAX_FCP_TARGET 1024
36 #define MAX_FCP_LUN 16384
37 #define BFAD_TARGET_RESET_TMO 60
38 #define BFAD_LUN_RESET_TMO 60
39 #define BFA_QUEUE_FULL_RAMP_UP_TIME 120
40
41 /*
42  * itnim flags
43  */
44 #define IO_DONE_BIT                     0
45
46 /**
47  * struct bfad_cmd_priv - private data per SCSI command.
48  * @status: Lowest bit represents IO_DONE. The next seven bits hold a value of
49  * type enum bfi_tskim_status.
50  * @wq: Wait queue used to wait for completion of an operation.
51  */
52 struct bfad_cmd_priv {
53         unsigned long status;
54         wait_queue_head_t *wq;
55 };
56
57 static inline struct bfad_cmd_priv *bfad_priv(struct scsi_cmnd *cmd)
58 {
59         return scsi_cmd_priv(cmd);
60 }
61
62 struct bfad_itnim_data_s {
63         struct bfad_itnim_s *itnim;
64 };
65
66 struct bfad_im_port_s {
67         struct bfad_s         *bfad;
68         struct bfad_port_s    *port;
69         struct work_struct port_delete_work;
70         int             idr_id;
71         u16        cur_scsi_id;
72         u16     flags;
73         struct list_head binding_list;
74         struct Scsi_Host *shost;
75         struct list_head itnim_mapped_list;
76         struct fc_vport *fc_vport;
77 };
78
79 struct bfad_im_port_pointer {
80         struct bfad_im_port_s *p;
81 };
82
83 static inline struct bfad_im_port_s *bfad_get_im_port(struct Scsi_Host *host)
84 {
85         struct bfad_im_port_pointer *im_portp = shost_priv(host);
86         return im_portp->p;
87 }
88
89 enum bfad_itnim_state {
90         ITNIM_STATE_NONE,
91         ITNIM_STATE_ONLINE,
92         ITNIM_STATE_OFFLINE_PENDING,
93         ITNIM_STATE_OFFLINE,
94         ITNIM_STATE_TIMEOUT,
95         ITNIM_STATE_FREE,
96 };
97
98 /*
99  * Per itnim data structure
100  */
101 struct bfad_itnim_s {
102         struct list_head list_entry;
103         struct bfa_fcs_itnim_s fcs_itnim;
104         struct work_struct itnim_work;
105         u32        flags;
106         enum bfad_itnim_state state;
107         struct bfad_im_s *im;
108         struct bfad_im_port_s *im_port;
109         struct bfad_rport_s *drv_rport;
110         struct fc_rport *fc_rport;
111         struct bfa_itnim_s *bfa_itnim;
112         u16        scsi_tgt_id;
113         u16        channel;
114         u16        queue_work;
115         unsigned long   last_ramp_up_time;
116         unsigned long   last_queue_full_time;
117 };
118
119 enum bfad_binding_type {
120         FCP_PWWN_BINDING = 0x1,
121         FCP_NWWN_BINDING = 0x2,
122         FCP_FCID_BINDING = 0x3,
123 };
124
125 struct bfad_fcp_binding {
126         struct list_head list_entry;
127         enum bfad_binding_type binding_type;
128         u16        scsi_target_id;
129         u32        fc_id;
130         wwn_t           nwwn;
131         wwn_t           pwwn;
132 };
133
134 struct bfad_im_s {
135         struct bfad_s         *bfad;
136         struct workqueue_struct *drv_workq;
137         char            drv_workq_name[KOBJ_NAME_LEN];
138         struct work_struct      aen_im_notify_work;
139 };
140
141 #define bfad_get_aen_entry(_drv, _entry) do {                           \
142         unsigned long   _flags;                                         \
143         spin_lock_irqsave(&(_drv)->bfad_aen_spinlock, _flags);          \
144         bfa_q_deq(&(_drv)->free_aen_q, &(_entry));                      \
145         if (_entry)                                                     \
146                 list_add_tail(&(_entry)->qe, &(_drv)->active_aen_q);    \
147         spin_unlock_irqrestore(&(_drv)->bfad_aen_spinlock, _flags);     \
148 } while (0)
149
150 /* post fc_host vendor event */
151 static inline void bfad_im_post_vendor_event(struct bfa_aen_entry_s *entry,
152                                              struct bfad_s *drv, int cnt,
153                                              enum bfa_aen_category cat,
154                                              int evt)
155 {
156         struct timespec64 ts;
157
158         ktime_get_real_ts64(&ts);
159         /*
160          * 'unsigned long aen_tv_sec' overflows in y2106 on 32-bit
161          * architectures, or in 2038 if user space interprets it
162          * as 'signed'.
163          */
164         entry->aen_tv_sec = ts.tv_sec;
165         entry->aen_tv_usec = ts.tv_nsec / NSEC_PER_USEC;
166         entry->bfad_num = drv->inst_no;
167         entry->seq_num = cnt;
168         entry->aen_category = cat;
169         entry->aen_type = evt;
170         if (drv->bfad_flags & BFAD_FC4_PROBE_DONE)
171                 queue_work(drv->im->drv_workq, &drv->im->aen_im_notify_work);
172 }
173
174 struct Scsi_Host *bfad_scsi_host_alloc(struct bfad_im_port_s *im_port,
175                                 struct bfad_s *);
176 bfa_status_t bfad_thread_workq(struct bfad_s *bfad);
177 void bfad_destroy_workq(struct bfad_im_s *im);
178 void bfad_fc_host_init(struct bfad_im_port_s *im_port);
179 void bfad_scsi_host_free(struct bfad_s *bfad,
180                                  struct bfad_im_port_s *im_port);
181 void bfad_ramp_up_qdepth(struct bfad_itnim_s *itnim,
182                                  struct scsi_device *sdev);
183 void bfad_handle_qfull(struct bfad_itnim_s *itnim, struct scsi_device *sdev);
184 struct bfad_itnim_s *bfad_get_itnim(struct bfad_im_port_s *im_port, int id);
185
186 extern struct scsi_host_template bfad_im_scsi_host_template;
187 extern struct scsi_host_template bfad_im_vport_template;
188 extern struct fc_function_template bfad_im_fc_function_template;
189 extern struct fc_function_template bfad_im_vport_fc_function_template;
190 extern struct scsi_transport_template *bfad_im_scsi_transport_template;
191 extern struct scsi_transport_template *bfad_im_scsi_vport_transport_template;
192
193 extern const struct attribute_group *bfad_im_host_groups[];
194 extern const struct attribute_group *bfad_im_vport_groups[];
195
196 irqreturn_t bfad_intx(int irq, void *dev_id);
197
198 int bfad_im_bsg_request(struct bsg_job *job);
199 int bfad_im_bsg_timeout(struct bsg_job *job);
200
201 /*
202  * Macro to set the SCSI device sdev_bflags - sdev_bflags are used by the
203  * SCSI mid-layer to choose LUN Scanning mode REPORT_LUNS vs. Sequential Scan
204  *
205  * Internally iterate's over all the ITNIM's part of the im_port & set's the
206  * sdev_bflags for the scsi_device associated with LUN #0.
207  */
208 #define bfad_reset_sdev_bflags(__im_port, __lunmask_cfg) do {           \
209         struct scsi_device *__sdev = NULL;                              \
210         struct bfad_itnim_s *__itnim = NULL;                            \
211         u32 scan_flags = BLIST_NOREPORTLUN | BLIST_SPARSELUN;           \
212         list_for_each_entry(__itnim, &((__im_port)->itnim_mapped_list), \
213                             list_entry) {                               \
214                 __sdev = scsi_device_lookup((__im_port)->shost,         \
215                                             __itnim->channel,           \
216                                             __itnim->scsi_tgt_id, 0);   \
217                 if (__sdev) {                                           \
218                         if ((__lunmask_cfg) == BFA_TRUE)                \
219                                 __sdev->sdev_bflags |= scan_flags;      \
220                         else                                            \
221                                 __sdev->sdev_bflags &= ~scan_flags;     \
222                         scsi_device_put(__sdev);                        \
223                 }                                                       \
224         }                                                               \
225 } while (0)
226
227 #endif