1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * zfcp device driver 4 * 5 * Global definitions for the zfcp device driver. 6 * 7 * Copyright IBM Corp. 2002, 2010 8 */ 9 10 #ifndef ZFCP_DEF_H 11 #define ZFCP_DEF_H 12 13 /*************************** INCLUDES *****************************************/ 14 15 #include <linux/init.h> 16 #include <linux/moduleparam.h> 17 #include <linux/major.h> 18 #include <linux/blkdev.h> 19 #include <linux/delay.h> 20 #include <linux/timer.h> 21 #include <linux/slab.h> 22 #include <linux/mempool.h> 23 #include <linux/syscalls.h> 24 #include <linux/scatterlist.h> 25 #include <linux/ioctl.h> 26 #include <scsi/fc/fc_fs.h> 27 #include <scsi/fc/fc_gs.h> 28 #include <scsi/scsi.h> 29 #include <scsi/scsi_tcq.h> 30 #include <scsi/scsi_cmnd.h> 31 #include <scsi/scsi_device.h> 32 #include <scsi/scsi_host.h> 33 #include <scsi/scsi_transport.h> 34 #include <scsi/scsi_transport_fc.h> 35 #include <scsi/scsi_bsg_fc.h> 36 #include <asm/ccwdev.h> 37 #include <asm/debug.h> 38 #include <asm/ebcdic.h> 39 #include <asm/sysinfo.h> 40 #include "zfcp_fsf.h" 41 #include "zfcp_fc.h" 42 #include "zfcp_qdio.h" 43 44 struct zfcp_reqlist; 45 46 /********************* SCSI SPECIFIC DEFINES *********************************/ 47 #define ZFCP_SCSI_ER_TIMEOUT (10*HZ) 48 49 /********************* FSF SPECIFIC DEFINES *********************************/ 50 51 /* ATTENTION: value must not be used by hardware */ 52 #define FSF_QTCB_UNSOLICITED_STATUS 0x6305 53 54 /* timeout value for "default timer" for fsf requests */ 55 #define ZFCP_FSF_REQUEST_TIMEOUT (60*HZ) 56 57 /*************** ADAPTER/PORT/UNIT AND FSF_REQ STATUS FLAGS ******************/ 58 59 /* 60 * Note, the leftmost status byte is common among adapter, port 61 * and unit 62 */ 63 #define ZFCP_COMMON_FLAGS 0xfff00000 64 65 /* common status bits */ 66 #define ZFCP_STATUS_COMMON_RUNNING 0x40000000 67 #define ZFCP_STATUS_COMMON_ERP_FAILED 0x20000000 68 #define ZFCP_STATUS_COMMON_UNBLOCKED 0x10000000 69 #define ZFCP_STATUS_COMMON_OPEN 0x04000000 70 #define ZFCP_STATUS_COMMON_ERP_INUSE 0x01000000 71 #define ZFCP_STATUS_COMMON_ACCESS_DENIED 0x00800000 72 #define ZFCP_STATUS_COMMON_ACCESS_BOXED 0x00400000 73 #define ZFCP_STATUS_COMMON_NOESC 0x00200000 74 75 /* adapter status */ 76 #define ZFCP_STATUS_ADAPTER_MB_ACT 0x00000001 77 #define ZFCP_STATUS_ADAPTER_QDIOUP 0x00000002 78 #define ZFCP_STATUS_ADAPTER_SIOSL_ISSUED 0x00000004 79 #define ZFCP_STATUS_ADAPTER_XCONFIG_OK 0x00000008 80 #define ZFCP_STATUS_ADAPTER_HOST_CON_INIT 0x00000010 81 #define ZFCP_STATUS_ADAPTER_SUSPENDED 0x00000040 82 #define ZFCP_STATUS_ADAPTER_ERP_PENDING 0x00000100 83 #define ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED 0x00000200 84 #define ZFCP_STATUS_ADAPTER_DATA_DIV_ENABLED 0x00000400 85 86 /* remote port status */ 87 #define ZFCP_STATUS_PORT_PHYS_OPEN 0x00000001 88 #define ZFCP_STATUS_PORT_LINK_TEST 0x00000002 89 90 /* FSF request status (this does not have a common part) */ 91 #define ZFCP_STATUS_FSFREQ_ERROR 0x00000008 92 #define ZFCP_STATUS_FSFREQ_CLEANUP 0x00000010 93 #define ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED 0x00000040 94 #define ZFCP_STATUS_FSFREQ_ABORTNOTNEEDED 0x00000080 95 #define ZFCP_STATUS_FSFREQ_TMFUNCFAILED 0x00000200 96 #define ZFCP_STATUS_FSFREQ_DISMISSED 0x00001000 97 98 /************************* STRUCTURE DEFINITIONS *****************************/ 99 100 struct zfcp_fsf_req; 101 102 /* holds various memory pools of an adapter */ 103 struct zfcp_adapter_mempool { 104 mempool_t *erp_req; 105 mempool_t *gid_pn_req; 106 mempool_t *scsi_req; 107 mempool_t *scsi_abort; 108 mempool_t *status_read_req; 109 mempool_t *sr_data; 110 mempool_t *gid_pn; 111 mempool_t *qtcb_pool; 112 }; 113 114 struct zfcp_erp_action { 115 struct list_head list; 116 int action; /* requested action code */ 117 struct zfcp_adapter *adapter; /* device which should be recovered */ 118 struct zfcp_port *port; 119 struct scsi_device *sdev; 120 u32 status; /* recovery status */ 121 u32 step; /* active step of this erp action */ 122 unsigned long fsf_req_id; 123 struct timer_list timer; 124 }; 125 126 struct fsf_latency_record { 127 u32 min; 128 u32 max; 129 u64 sum; 130 }; 131 132 struct latency_cont { 133 struct fsf_latency_record channel; 134 struct fsf_latency_record fabric; 135 u64 counter; 136 }; 137 138 struct zfcp_latencies { 139 struct latency_cont read; 140 struct latency_cont write; 141 struct latency_cont cmd; 142 spinlock_t lock; 143 }; 144 145 struct zfcp_adapter { 146 struct kref ref; 147 u64 peer_wwnn; /* P2P peer WWNN */ 148 u64 peer_wwpn; /* P2P peer WWPN */ 149 u32 peer_d_id; /* P2P peer D_ID */ 150 struct ccw_device *ccw_device; /* S/390 ccw device */ 151 struct zfcp_qdio *qdio; 152 u32 hydra_version; /* Hydra version */ 153 u32 fsf_lic_version; 154 u32 adapter_features; /* FCP channel features */ 155 u32 connection_features; /* host connection features */ 156 u32 hardware_version; /* of FCP channel */ 157 u16 timer_ticks; /* time int for a tick */ 158 struct Scsi_Host *scsi_host; /* Pointer to mid-layer */ 159 struct list_head port_list; /* remote port list */ 160 rwlock_t port_list_lock; /* port list lock */ 161 unsigned long req_no; /* unique FSF req number */ 162 struct zfcp_reqlist *req_list; 163 u32 fsf_req_seq_no; /* FSF cmnd seq number */ 164 rwlock_t abort_lock; /* Protects against SCSI 165 stack abort/command 166 completion races */ 167 atomic_t stat_miss; /* # missing status reads*/ 168 unsigned int stat_read_buf_num; 169 struct work_struct stat_work; 170 atomic_t status; /* status of this adapter */ 171 struct list_head erp_ready_head; /* error recovery for this 172 adapter/devices */ 173 wait_queue_head_t erp_ready_wq; 174 struct list_head erp_running_head; 175 rwlock_t erp_lock; 176 wait_queue_head_t erp_done_wqh; 177 struct zfcp_erp_action erp_action; /* pending error recovery */ 178 atomic_t erp_counter; 179 u32 erp_total_count; /* total nr of enqueued erp 180 actions */ 181 u32 erp_low_mem_count; /* nr of erp actions waiting 182 for memory */ 183 struct task_struct *erp_thread; 184 struct zfcp_fc_wka_ports *gs; /* generic services */ 185 struct zfcp_dbf *dbf; /* debug traces */ 186 struct zfcp_adapter_mempool pool; /* Adapter memory pools */ 187 struct fc_host_statistics *fc_stats; 188 struct fsf_qtcb_bottom_port *stats_reset_data; 189 unsigned long stats_reset; 190 struct delayed_work scan_work; 191 struct work_struct ns_up_work; 192 struct service_level service_level; 193 struct workqueue_struct *work_queue; 194 struct device_dma_parameters dma_parms; 195 struct zfcp_fc_events events; 196 unsigned long next_port_scan; 197 }; 198 199 struct zfcp_port { 200 struct device dev; 201 struct fc_rport *rport; /* rport of fc transport class */ 202 struct list_head list; /* list of remote ports */ 203 struct zfcp_adapter *adapter; /* adapter used to access port */ 204 struct list_head unit_list; /* head of logical unit list */ 205 rwlock_t unit_list_lock; /* unit list lock */ 206 atomic_t units; /* zfcp_unit count */ 207 atomic_t status; /* status of this remote port */ 208 u64 wwnn; /* WWNN if known */ 209 u64 wwpn; /* WWPN */ 210 u32 d_id; /* D_ID */ 211 u32 handle; /* handle assigned by FSF */ 212 struct zfcp_erp_action erp_action; /* pending error recovery */ 213 atomic_t erp_counter; 214 u32 maxframe_size; 215 u32 supported_classes; 216 struct work_struct gid_pn_work; 217 struct work_struct test_link_work; 218 struct work_struct rport_work; 219 enum { RPORT_NONE, RPORT_ADD, RPORT_DEL } rport_task; 220 unsigned int starget_id; 221 }; 222 223 /** 224 * struct zfcp_unit - LUN configured via zfcp sysfs 225 * @dev: struct device for sysfs representation and reference counting 226 * @list: entry in LUN/unit list per zfcp_port 227 * @port: reference to zfcp_port where this LUN is configured 228 * @fcp_lun: 64 bit LUN value 229 * @scsi_work: for running scsi_scan_target 230 * 231 * This is the representation of a LUN that has been configured for 232 * usage. The main data here is the 64 bit LUN value, data for 233 * running I/O and recovery is in struct zfcp_scsi_dev. 234 */ 235 struct zfcp_unit { 236 struct device dev; 237 struct list_head list; 238 struct zfcp_port *port; 239 u64 fcp_lun; 240 struct work_struct scsi_work; 241 }; 242 243 /** 244 * struct zfcp_scsi_dev - zfcp data per SCSI device 245 * @status: zfcp internal status flags 246 * @lun_handle: handle from "open lun" for issuing FSF requests 247 * @erp_action: zfcp erp data for opening and recovering this LUN 248 * @erp_counter: zfcp erp counter for this LUN 249 * @latencies: FSF channel and fabric latencies 250 * @port: zfcp_port where this LUN belongs to 251 */ 252 struct zfcp_scsi_dev { 253 atomic_t status; 254 u32 lun_handle; 255 struct zfcp_erp_action erp_action; 256 atomic_t erp_counter; 257 struct zfcp_latencies latencies; 258 struct zfcp_port *port; 259 }; 260 261 /** 262 * sdev_to_zfcp - Access zfcp LUN data for SCSI device 263 * @sdev: scsi_device where to get the zfcp_scsi_dev pointer 264 */ 265 static inline struct zfcp_scsi_dev *sdev_to_zfcp(struct scsi_device *sdev) 266 { 267 return scsi_transport_device_data(sdev); 268 } 269 270 /** 271 * zfcp_scsi_dev_lun - Return SCSI device LUN as 64 bit FCP LUN 272 * @sdev: SCSI device where to get the LUN from 273 */ 274 static inline u64 zfcp_scsi_dev_lun(struct scsi_device *sdev) 275 { 276 u64 fcp_lun; 277 278 int_to_scsilun(sdev->lun, (struct scsi_lun *)&fcp_lun); 279 return fcp_lun; 280 } 281 282 /** 283 * struct zfcp_fsf_req - basic FSF request structure 284 * @list: list of FSF requests 285 * @req_id: unique request ID 286 * @adapter: adapter this request belongs to 287 * @qdio_req: qdio queue related values 288 * @completion: used to signal the completion of the request 289 * @status: status of the request 290 * @fsf_command: FSF command issued 291 * @qtcb: associated QTCB 292 * @seq_no: sequence number of this request 293 * @data: private data 294 * @timer: timer data of this request 295 * @erp_action: reference to erp action if request issued on behalf of ERP 296 * @pool: reference to memory pool if used for this request 297 * @issued: time when request was send (STCK) 298 * @handler: handler which should be called to process response 299 */ 300 struct zfcp_fsf_req { 301 struct list_head list; 302 unsigned long req_id; 303 struct zfcp_adapter *adapter; 304 struct zfcp_qdio_req qdio_req; 305 struct completion completion; 306 u32 status; 307 u32 fsf_command; 308 struct fsf_qtcb *qtcb; 309 u32 seq_no; 310 void *data; 311 struct timer_list timer; 312 struct zfcp_erp_action *erp_action; 313 mempool_t *pool; 314 unsigned long long issued; 315 void (*handler)(struct zfcp_fsf_req *); 316 }; 317 318 static inline 319 int zfcp_adapter_multi_buffer_active(struct zfcp_adapter *adapter) 320 { 321 return atomic_read(&adapter->status) & ZFCP_STATUS_ADAPTER_MB_ACT; 322 } 323 324 #endif /* ZFCP_DEF_H */ 325