zfcp_def.h 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711
  1. /*
  2. * zfcp device driver
  3. *
  4. * Global definitions for the zfcp device driver.
  5. *
  6. * Copyright IBM Corporation 2002, 2009
  7. */
  8. #ifndef ZFCP_DEF_H
  9. #define ZFCP_DEF_H
  10. /*************************** INCLUDES *****************************************/
  11. #include <linux/init.h>
  12. #include <linux/moduleparam.h>
  13. #include <linux/major.h>
  14. #include <linux/blkdev.h>
  15. #include <linux/delay.h>
  16. #include <linux/timer.h>
  17. #include <linux/slab.h>
  18. #include <linux/mempool.h>
  19. #include <linux/syscalls.h>
  20. #include <linux/scatterlist.h>
  21. #include <linux/ioctl.h>
  22. #include <scsi/fc/fc_fs.h>
  23. #include <scsi/fc/fc_gs.h>
  24. #include <scsi/scsi.h>
  25. #include <scsi/scsi_tcq.h>
  26. #include <scsi/scsi_cmnd.h>
  27. #include <scsi/scsi_device.h>
  28. #include <scsi/scsi_host.h>
  29. #include <scsi/scsi_transport.h>
  30. #include <scsi/scsi_transport_fc.h>
  31. #include <scsi/scsi_bsg_fc.h>
  32. #include <asm/ccwdev.h>
  33. #include <asm/qdio.h>
  34. #include <asm/debug.h>
  35. #include <asm/ebcdic.h>
  36. #include <asm/sysinfo.h>
  37. #include "zfcp_fsf.h"
  38. /********************* GENERAL DEFINES *********************************/
  39. #define REQUEST_LIST_SIZE 128
  40. /********************* SCSI SPECIFIC DEFINES *********************************/
  41. #define ZFCP_SCSI_ER_TIMEOUT (10*HZ)
  42. /********************* CIO/QDIO SPECIFIC DEFINES *****************************/
  43. /* DMQ bug workaround: don't use last SBALE */
  44. #define ZFCP_MAX_SBALES_PER_SBAL (QDIO_MAX_ELEMENTS_PER_BUFFER - 1)
  45. /* index of last SBALE (with respect to DMQ bug workaround) */
  46. #define ZFCP_LAST_SBALE_PER_SBAL (ZFCP_MAX_SBALES_PER_SBAL - 1)
  47. /* max. number of (data buffer) SBALEs in largest SBAL chain */
  48. #define ZFCP_MAX_SBALES_PER_REQ \
  49. (FSF_MAX_SBALS_PER_REQ * ZFCP_MAX_SBALES_PER_SBAL - 2)
  50. /* request ID + QTCB in SBALE 0 + 1 of first SBAL in chain */
  51. #define ZFCP_MAX_SECTORS (ZFCP_MAX_SBALES_PER_REQ * 8)
  52. /* max. number of (data buffer) SBALEs in largest SBAL chain
  53. multiplied with number of sectors per 4k block */
  54. /********************* FSF SPECIFIC DEFINES *********************************/
  55. /* ATTENTION: value must not be used by hardware */
  56. #define FSF_QTCB_UNSOLICITED_STATUS 0x6305
  57. /* timeout value for "default timer" for fsf requests */
  58. #define ZFCP_FSF_REQUEST_TIMEOUT (60*HZ)
  59. /*************** FIBRE CHANNEL PROTOCOL SPECIFIC DEFINES ********************/
  60. /* timeout for name-server lookup (in seconds) */
  61. #define ZFCP_NS_GID_PN_TIMEOUT 10
  62. /* task attribute values in FCP-2 FCP_CMND IU */
  63. #define SIMPLE_Q 0
  64. #define HEAD_OF_Q 1
  65. #define ORDERED_Q 2
  66. #define ACA_Q 4
  67. #define UNTAGGED 5
  68. /* task management flags in FCP-2 FCP_CMND IU */
  69. #define FCP_CLEAR_ACA 0x40
  70. #define FCP_TARGET_RESET 0x20
  71. #define FCP_LOGICAL_UNIT_RESET 0x10
  72. #define FCP_CLEAR_TASK_SET 0x04
  73. #define FCP_ABORT_TASK_SET 0x02
  74. #define FCP_CDB_LENGTH 16
  75. #define ZFCP_DID_MASK 0x00FFFFFF
  76. /* FCP(-2) FCP_CMND IU */
  77. struct fcp_cmnd_iu {
  78. u64 fcp_lun; /* FCP logical unit number */
  79. u8 crn; /* command reference number */
  80. u8 reserved0:5; /* reserved */
  81. u8 task_attribute:3; /* task attribute */
  82. u8 task_management_flags; /* task management flags */
  83. u8 add_fcp_cdb_length:6; /* additional FCP_CDB length */
  84. u8 rddata:1; /* read data */
  85. u8 wddata:1; /* write data */
  86. u8 fcp_cdb[FCP_CDB_LENGTH];
  87. } __attribute__((packed));
  88. /* FCP(-2) FCP_RSP IU */
  89. struct fcp_rsp_iu {
  90. u8 reserved0[10];
  91. union {
  92. struct {
  93. u8 reserved1:3;
  94. u8 fcp_conf_req:1;
  95. u8 fcp_resid_under:1;
  96. u8 fcp_resid_over:1;
  97. u8 fcp_sns_len_valid:1;
  98. u8 fcp_rsp_len_valid:1;
  99. } bits;
  100. u8 value;
  101. } validity;
  102. u8 scsi_status;
  103. u32 fcp_resid;
  104. u32 fcp_sns_len;
  105. u32 fcp_rsp_len;
  106. } __attribute__((packed));
  107. #define RSP_CODE_GOOD 0
  108. #define RSP_CODE_LENGTH_MISMATCH 1
  109. #define RSP_CODE_FIELD_INVALID 2
  110. #define RSP_CODE_RO_MISMATCH 3
  111. #define RSP_CODE_TASKMAN_UNSUPP 4
  112. #define RSP_CODE_TASKMAN_FAILED 5
  113. /* see fc-fs */
  114. #define LS_RSCN 0x61
  115. #define LS_LOGO 0x05
  116. #define LS_PLOGI 0x03
  117. struct fcp_rscn_head {
  118. u8 command;
  119. u8 page_length; /* always 0x04 */
  120. u16 payload_len;
  121. } __attribute__((packed));
  122. struct fcp_rscn_element {
  123. u8 reserved:2;
  124. u8 event_qual:4;
  125. u8 addr_format:2;
  126. u32 nport_did:24;
  127. } __attribute__((packed));
  128. /* see fc-ph */
  129. struct fcp_logo {
  130. u32 command;
  131. u32 nport_did;
  132. u64 nport_wwpn;
  133. } __attribute__((packed));
  134. /*
  135. * FC-FS stuff
  136. */
  137. #define R_A_TOV 10 /* seconds */
  138. #define ZFCP_LS_RLS 0x0f
  139. #define ZFCP_LS_ADISC 0x52
  140. #define ZFCP_LS_RPS 0x56
  141. #define ZFCP_LS_RSCN 0x61
  142. #define ZFCP_LS_RNID 0x78
  143. struct zfcp_ls_adisc {
  144. u8 code;
  145. u8 field[3];
  146. u32 hard_nport_id;
  147. u64 wwpn;
  148. u64 wwnn;
  149. u32 nport_id;
  150. } __attribute__ ((packed));
  151. /*
  152. * FC-GS-2 stuff
  153. */
  154. #define ZFCP_CT_REVISION 0x01
  155. #define ZFCP_CT_DIRECTORY_SERVICE 0xFC
  156. #define ZFCP_CT_NAME_SERVER 0x02
  157. #define ZFCP_CT_SYNCHRONOUS 0x00
  158. #define ZFCP_CT_SCSI_FCP 0x08
  159. #define ZFCP_CT_UNABLE_TO_PERFORM_CMD 0x09
  160. #define ZFCP_CT_GID_PN 0x0121
  161. #define ZFCP_CT_GPN_FT 0x0172
  162. #define ZFCP_CT_ACCEPT 0x8002
  163. #define ZFCP_CT_REJECT 0x8001
  164. /*
  165. * FC-GS-4 stuff
  166. */
  167. #define ZFCP_CT_TIMEOUT (3 * R_A_TOV)
  168. /*************** ADAPTER/PORT/UNIT AND FSF_REQ STATUS FLAGS ******************/
  169. /*
  170. * Note, the leftmost status byte is common among adapter, port
  171. * and unit
  172. */
  173. #define ZFCP_COMMON_FLAGS 0xfff00000
  174. /* common status bits */
  175. #define ZFCP_STATUS_COMMON_REMOVE 0x80000000
  176. #define ZFCP_STATUS_COMMON_RUNNING 0x40000000
  177. #define ZFCP_STATUS_COMMON_ERP_FAILED 0x20000000
  178. #define ZFCP_STATUS_COMMON_UNBLOCKED 0x10000000
  179. #define ZFCP_STATUS_COMMON_OPEN 0x04000000
  180. #define ZFCP_STATUS_COMMON_ERP_INUSE 0x01000000
  181. #define ZFCP_STATUS_COMMON_ACCESS_DENIED 0x00800000
  182. #define ZFCP_STATUS_COMMON_ACCESS_BOXED 0x00400000
  183. #define ZFCP_STATUS_COMMON_NOESC 0x00200000
  184. /* adapter status */
  185. #define ZFCP_STATUS_ADAPTER_QDIOUP 0x00000002
  186. #define ZFCP_STATUS_ADAPTER_XCONFIG_OK 0x00000008
  187. #define ZFCP_STATUS_ADAPTER_HOST_CON_INIT 0x00000010
  188. #define ZFCP_STATUS_ADAPTER_ERP_THREAD_UP 0x00000020
  189. #define ZFCP_STATUS_ADAPTER_ERP_THREAD_KILL 0x00000080
  190. #define ZFCP_STATUS_ADAPTER_ERP_PENDING 0x00000100
  191. #define ZFCP_STATUS_ADAPTER_LINK_UNPLUGGED 0x00000200
  192. /* FC-PH/FC-GS well-known address identifiers for generic services */
  193. #define ZFCP_DID_WKA 0xFFFFF0
  194. /* remote port status */
  195. #define ZFCP_STATUS_PORT_PHYS_OPEN 0x00000001
  196. #define ZFCP_STATUS_PORT_LINK_TEST 0x00000002
  197. /* well known address (WKA) port status*/
  198. enum zfcp_wka_status {
  199. ZFCP_WKA_PORT_OFFLINE,
  200. ZFCP_WKA_PORT_CLOSING,
  201. ZFCP_WKA_PORT_OPENING,
  202. ZFCP_WKA_PORT_ONLINE,
  203. };
  204. /* logical unit status */
  205. #define ZFCP_STATUS_UNIT_SHARED 0x00000004
  206. #define ZFCP_STATUS_UNIT_READONLY 0x00000008
  207. /* FSF request status (this does not have a common part) */
  208. #define ZFCP_STATUS_FSFREQ_TASK_MANAGEMENT 0x00000002
  209. #define ZFCP_STATUS_FSFREQ_ERROR 0x00000008
  210. #define ZFCP_STATUS_FSFREQ_CLEANUP 0x00000010
  211. #define ZFCP_STATUS_FSFREQ_ABORTSUCCEEDED 0x00000040
  212. #define ZFCP_STATUS_FSFREQ_ABORTNOTNEEDED 0x00000080
  213. #define ZFCP_STATUS_FSFREQ_ABORTED 0x00000100
  214. #define ZFCP_STATUS_FSFREQ_TMFUNCFAILED 0x00000200
  215. #define ZFCP_STATUS_FSFREQ_TMFUNCNOTSUPP 0x00000400
  216. #define ZFCP_STATUS_FSFREQ_RETRY 0x00000800
  217. #define ZFCP_STATUS_FSFREQ_DISMISSED 0x00001000
  218. /************************* STRUCTURE DEFINITIONS *****************************/
  219. struct zfcp_fsf_req;
  220. /* holds various memory pools of an adapter */
  221. struct zfcp_adapter_mempool {
  222. mempool_t *erp_req;
  223. mempool_t *gid_pn_req;
  224. mempool_t *scsi_req;
  225. mempool_t *scsi_abort;
  226. mempool_t *status_read_req;
  227. mempool_t *status_read_data;
  228. mempool_t *gid_pn_data;
  229. mempool_t *qtcb_pool;
  230. };
  231. /*
  232. * header for CT_IU
  233. */
  234. struct ct_hdr {
  235. u8 revision; // 0x01
  236. u8 in_id[3]; // 0x00
  237. u8 gs_type; // 0xFC Directory Service
  238. u8 gs_subtype; // 0x02 Name Server
  239. u8 options; // 0x00 single bidirectional exchange
  240. u8 reserved0;
  241. u16 cmd_rsp_code; // 0x0121 GID_PN, or 0x0100 GA_NXT
  242. u16 max_res_size; // <= (4096 - 16) / 4
  243. u8 reserved1;
  244. u8 reason_code;
  245. u8 reason_code_expl;
  246. u8 vendor_unique;
  247. } __attribute__ ((packed));
  248. /* nameserver request CT_IU -- for requests where
  249. * a port name is required */
  250. struct ct_iu_gid_pn_req {
  251. struct ct_hdr header;
  252. u64 wwpn;
  253. } __attribute__ ((packed));
  254. /* FS_ACC IU and data unit for GID_PN nameserver request */
  255. struct ct_iu_gid_pn_resp {
  256. struct ct_hdr header;
  257. u32 d_id;
  258. } __attribute__ ((packed));
  259. struct ct_iu_gpn_ft_req {
  260. struct ct_hdr header;
  261. u8 flags;
  262. u8 domain_id_scope;
  263. u8 area_id_scope;
  264. u8 fc4_type;
  265. } __attribute__ ((packed));
  266. /**
  267. * struct zfcp_send_ct - used to pass parameters to function zfcp_fsf_send_ct
  268. * @wka_port: port where the request is sent to
  269. * @req: scatter-gather list for request
  270. * @resp: scatter-gather list for response
  271. * @handler: handler function (called for response to the request)
  272. * @handler_data: data passed to handler function
  273. * @timeout: FSF timeout for this request
  274. * @completion: completion for synchronization purposes
  275. * @status: used to pass error status to calling function
  276. */
  277. struct zfcp_send_ct {
  278. struct zfcp_wka_port *wka_port;
  279. struct scatterlist *req;
  280. struct scatterlist *resp;
  281. void (*handler)(unsigned long);
  282. unsigned long handler_data;
  283. int timeout;
  284. struct completion *completion;
  285. int status;
  286. };
  287. /* used for name server requests in error recovery */
  288. struct zfcp_gid_pn_data {
  289. struct zfcp_send_ct ct;
  290. struct scatterlist req;
  291. struct scatterlist resp;
  292. struct ct_iu_gid_pn_req ct_iu_req;
  293. struct ct_iu_gid_pn_resp ct_iu_resp;
  294. struct zfcp_port *port;
  295. };
  296. /**
  297. * struct zfcp_send_els - used to pass parameters to function zfcp_fsf_send_els
  298. * @adapter: adapter where request is sent from
  299. * @port: port where ELS is destinated (port reference count has to be increased)
  300. * @d_id: destiniation id of port where request is sent to
  301. * @req: scatter-gather list for request
  302. * @resp: scatter-gather list for response
  303. * @handler: handler function (called for response to the request)
  304. * @handler_data: data passed to handler function
  305. * @completion: completion for synchronization purposes
  306. * @ls_code: hex code of ELS command
  307. * @status: used to pass error status to calling function
  308. */
  309. struct zfcp_send_els {
  310. struct zfcp_adapter *adapter;
  311. struct zfcp_port *port;
  312. u32 d_id;
  313. struct scatterlist *req;
  314. struct scatterlist *resp;
  315. void (*handler)(unsigned long);
  316. unsigned long handler_data;
  317. struct completion *completion;
  318. int ls_code;
  319. int status;
  320. };
  321. struct zfcp_wka_port {
  322. struct zfcp_adapter *adapter;
  323. wait_queue_head_t completion_wq;
  324. enum zfcp_wka_status status;
  325. atomic_t refcount;
  326. u32 d_id;
  327. u32 handle;
  328. struct mutex mutex;
  329. struct delayed_work work;
  330. };
  331. struct zfcp_wka_ports {
  332. struct zfcp_wka_port ms; /* management service */
  333. struct zfcp_wka_port ts; /* time service */
  334. struct zfcp_wka_port ds; /* directory service */
  335. struct zfcp_wka_port as; /* alias service */
  336. struct zfcp_wka_port ks; /* key distribution service */
  337. };
  338. struct zfcp_qdio_queue {
  339. struct qdio_buffer *sbal[QDIO_MAX_BUFFERS_PER_Q];
  340. u8 first; /* index of next free bfr in queue */
  341. atomic_t count; /* number of free buffers in queue */
  342. };
  343. struct zfcp_erp_action {
  344. struct list_head list;
  345. int action; /* requested action code */
  346. struct zfcp_adapter *adapter; /* device which should be recovered */
  347. struct zfcp_port *port;
  348. struct zfcp_unit *unit;
  349. u32 status; /* recovery status */
  350. u32 step; /* active step of this erp action */
  351. struct zfcp_fsf_req *fsf_req; /* fsf request currently pending
  352. for this action */
  353. struct timer_list timer;
  354. };
  355. struct fsf_latency_record {
  356. u32 min;
  357. u32 max;
  358. u64 sum;
  359. };
  360. struct latency_cont {
  361. struct fsf_latency_record channel;
  362. struct fsf_latency_record fabric;
  363. u64 counter;
  364. };
  365. struct zfcp_latencies {
  366. struct latency_cont read;
  367. struct latency_cont write;
  368. struct latency_cont cmd;
  369. spinlock_t lock;
  370. };
  371. /** struct zfcp_qdio - basic QDIO data structure
  372. * @resp_q: response queue
  373. * @req_q: request queue
  374. * @stat_lock: lock to protect req_q_util and req_q_time
  375. * @req_q_lock; lock to serialize access to request queue
  376. * @req_q_time: time of last fill level change
  377. * @req_q_util: used for accounting
  378. * @req_q_full: queue full incidents
  379. * @req_q_wq: used to wait for SBAL availability
  380. * @adapter: adapter used in conjunction with this QDIO structure
  381. */
  382. struct zfcp_qdio {
  383. struct zfcp_qdio_queue resp_q;
  384. struct zfcp_qdio_queue req_q;
  385. spinlock_t stat_lock;
  386. spinlock_t req_q_lock;
  387. ktime_t req_q_time;
  388. u64 req_q_util;
  389. atomic_t req_q_full;
  390. wait_queue_head_t req_q_wq;
  391. struct zfcp_adapter *adapter;
  392. };
  393. struct zfcp_adapter {
  394. atomic_t refcount; /* reference count */
  395. wait_queue_head_t remove_wq; /* can be used to wait for
  396. refcount drop to zero */
  397. u64 peer_wwnn; /* P2P peer WWNN */
  398. u64 peer_wwpn; /* P2P peer WWPN */
  399. u32 peer_d_id; /* P2P peer D_ID */
  400. struct ccw_device *ccw_device; /* S/390 ccw device */
  401. struct zfcp_qdio *qdio;
  402. u32 hydra_version; /* Hydra version */
  403. u32 fsf_lic_version;
  404. u32 adapter_features; /* FCP channel features */
  405. u32 connection_features; /* host connection features */
  406. u32 hardware_version; /* of FCP channel */
  407. u16 timer_ticks; /* time int for a tick */
  408. struct Scsi_Host *scsi_host; /* Pointer to mid-layer */
  409. struct list_head port_list_head; /* remote port list */
  410. unsigned long req_no; /* unique FSF req number */
  411. struct list_head *req_list; /* list of pending reqs */
  412. spinlock_t req_list_lock; /* request list lock */
  413. u32 fsf_req_seq_no; /* FSF cmnd seq number */
  414. rwlock_t abort_lock; /* Protects against SCSI
  415. stack abort/command
  416. completion races */
  417. atomic_t stat_miss; /* # missing status reads*/
  418. struct work_struct stat_work;
  419. atomic_t status; /* status of this adapter */
  420. struct list_head erp_ready_head; /* error recovery for this
  421. adapter/devices */
  422. struct list_head erp_running_head;
  423. rwlock_t erp_lock;
  424. struct semaphore erp_ready_sem;
  425. wait_queue_head_t erp_thread_wqh;
  426. wait_queue_head_t erp_done_wqh;
  427. struct zfcp_erp_action erp_action; /* pending error recovery */
  428. atomic_t erp_counter;
  429. u32 erp_total_count; /* total nr of enqueued erp
  430. actions */
  431. u32 erp_low_mem_count; /* nr of erp actions waiting
  432. for memory */
  433. struct zfcp_wka_ports *gs; /* generic services */
  434. struct zfcp_dbf *dbf; /* debug traces */
  435. struct zfcp_adapter_mempool pool; /* Adapter memory pools */
  436. struct fc_host_statistics *fc_stats;
  437. struct fsf_qtcb_bottom_port *stats_reset_data;
  438. unsigned long stats_reset;
  439. struct work_struct scan_work;
  440. struct service_level service_level;
  441. struct workqueue_struct *work_queue;
  442. };
  443. struct zfcp_port {
  444. struct device sysfs_device; /* sysfs device */
  445. struct fc_rport *rport; /* rport of fc transport class */
  446. struct list_head list; /* list of remote ports */
  447. atomic_t refcount; /* reference count */
  448. wait_queue_head_t remove_wq; /* can be used to wait for
  449. refcount drop to zero */
  450. struct zfcp_adapter *adapter; /* adapter used to access port */
  451. struct list_head unit_list_head; /* head of logical unit list */
  452. atomic_t status; /* status of this remote port */
  453. u64 wwnn; /* WWNN if known */
  454. u64 wwpn; /* WWPN */
  455. u32 d_id; /* D_ID */
  456. u32 handle; /* handle assigned by FSF */
  457. struct zfcp_erp_action erp_action; /* pending error recovery */
  458. atomic_t erp_counter;
  459. u32 maxframe_size;
  460. u32 supported_classes;
  461. struct work_struct gid_pn_work;
  462. struct work_struct test_link_work;
  463. struct work_struct rport_work;
  464. enum { RPORT_NONE, RPORT_ADD, RPORT_DEL } rport_task;
  465. };
  466. struct zfcp_unit {
  467. struct device sysfs_device; /* sysfs device */
  468. struct list_head list; /* list of logical units */
  469. atomic_t refcount; /* reference count */
  470. wait_queue_head_t remove_wq; /* can be used to wait for
  471. refcount drop to zero */
  472. struct zfcp_port *port; /* remote port of unit */
  473. atomic_t status; /* status of this logical unit */
  474. u64 fcp_lun; /* own FCP_LUN */
  475. u32 handle; /* handle assigned by FSF */
  476. struct scsi_device *device; /* scsi device struct pointer */
  477. struct zfcp_erp_action erp_action; /* pending error recovery */
  478. atomic_t erp_counter;
  479. struct zfcp_latencies latencies;
  480. struct work_struct scsi_work;
  481. };
  482. /**
  483. * struct zfcp_queue_req - queue related values for a request
  484. * @sbal_number: number of free SBALs
  485. * @sbal_first: first SBAL for this request
  486. * @sbal_last: last SBAL for this request
  487. * @sbal_limit: last possible SBAL for this request
  488. * @sbale_curr: current SBALE at creation of this request
  489. * @sbal_response: SBAL used in interrupt
  490. * @qdio_outb_usage: usage of outbound queue
  491. * @qdio_inb_usage: usage of inbound queue
  492. */
  493. struct zfcp_queue_req {
  494. u8 sbal_number;
  495. u8 sbal_first;
  496. u8 sbal_last;
  497. u8 sbal_limit;
  498. u8 sbale_curr;
  499. u8 sbal_response;
  500. u16 qdio_outb_usage;
  501. u16 qdio_inb_usage;
  502. };
  503. /**
  504. * struct zfcp_fsf_req - basic FSF request structure
  505. * @list: list of FSF requests
  506. * @req_id: unique request ID
  507. * @adapter: adapter this request belongs to
  508. * @queue_req: queue related values
  509. * @completion: used to signal the completion of the request
  510. * @status: status of the request
  511. * @fsf_command: FSF command issued
  512. * @qtcb: associated QTCB
  513. * @seq_no: sequence number of this request
  514. * @data: private data
  515. * @timer: timer data of this request
  516. * @erp_action: reference to erp action if request issued on behalf of ERP
  517. * @pool: reference to memory pool if used for this request
  518. * @issued: time when request was send (STCK)
  519. * @unit: reference to unit if this request is a SCSI request
  520. * @handler: handler which should be called to process response
  521. */
  522. struct zfcp_fsf_req {
  523. struct list_head list;
  524. unsigned long req_id;
  525. struct zfcp_adapter *adapter;
  526. struct zfcp_queue_req queue_req;
  527. struct completion completion;
  528. u32 status;
  529. u32 fsf_command;
  530. struct fsf_qtcb *qtcb;
  531. u32 seq_no;
  532. void *data;
  533. struct timer_list timer;
  534. struct zfcp_erp_action *erp_action;
  535. mempool_t *pool;
  536. unsigned long long issued;
  537. struct zfcp_unit *unit;
  538. void (*handler)(struct zfcp_fsf_req *);
  539. };
  540. /* driver data */
  541. struct zfcp_data {
  542. struct scsi_host_template scsi_host_template;
  543. struct scsi_transport_template *scsi_transport_template;
  544. rwlock_t config_lock; /* serialises changes
  545. to adapter/port/unit
  546. lists */
  547. struct semaphore config_sema; /* serialises configuration
  548. changes */
  549. struct kmem_cache *gpn_ft_cache;
  550. struct kmem_cache *qtcb_cache;
  551. struct kmem_cache *sr_buffer_cache;
  552. struct kmem_cache *gid_pn_cache;
  553. };
  554. /********************** ZFCP SPECIFIC DEFINES ********************************/
  555. #define ZFCP_SET 0x00000100
  556. #define ZFCP_CLEAR 0x00000200
  557. /*
  558. * Helper functions for request ID management.
  559. */
  560. static inline int zfcp_reqlist_hash(unsigned long req_id)
  561. {
  562. return req_id % REQUEST_LIST_SIZE;
  563. }
  564. static inline void zfcp_reqlist_remove(struct zfcp_adapter *adapter,
  565. struct zfcp_fsf_req *fsf_req)
  566. {
  567. list_del(&fsf_req->list);
  568. }
  569. static inline struct zfcp_fsf_req *
  570. zfcp_reqlist_find(struct zfcp_adapter *adapter, unsigned long req_id)
  571. {
  572. struct zfcp_fsf_req *request;
  573. unsigned int idx;
  574. idx = zfcp_reqlist_hash(req_id);
  575. list_for_each_entry(request, &adapter->req_list[idx], list)
  576. if (request->req_id == req_id)
  577. return request;
  578. return NULL;
  579. }
  580. static inline struct zfcp_fsf_req *
  581. zfcp_reqlist_find_safe(struct zfcp_adapter *adapter, struct zfcp_fsf_req *req)
  582. {
  583. struct zfcp_fsf_req *request;
  584. unsigned int idx;
  585. for (idx = 0; idx < REQUEST_LIST_SIZE; idx++) {
  586. list_for_each_entry(request, &adapter->req_list[idx], list)
  587. if (request == req)
  588. return request;
  589. }
  590. return NULL;
  591. }
  592. /*
  593. * functions needed for reference/usage counting
  594. */
  595. static inline void
  596. zfcp_unit_get(struct zfcp_unit *unit)
  597. {
  598. atomic_inc(&unit->refcount);
  599. }
  600. static inline void
  601. zfcp_unit_put(struct zfcp_unit *unit)
  602. {
  603. if (atomic_dec_return(&unit->refcount) == 0)
  604. wake_up(&unit->remove_wq);
  605. }
  606. static inline void
  607. zfcp_port_get(struct zfcp_port *port)
  608. {
  609. atomic_inc(&port->refcount);
  610. }
  611. static inline void
  612. zfcp_port_put(struct zfcp_port *port)
  613. {
  614. if (atomic_dec_return(&port->refcount) == 0)
  615. wake_up(&port->remove_wq);
  616. }
  617. static inline void
  618. zfcp_adapter_get(struct zfcp_adapter *adapter)
  619. {
  620. atomic_inc(&adapter->refcount);
  621. }
  622. static inline void
  623. zfcp_adapter_put(struct zfcp_adapter *adapter)
  624. {
  625. if (atomic_dec_return(&adapter->refcount) == 0)
  626. wake_up(&adapter->remove_wq);
  627. }
  628. #endif /* ZFCP_DEF_H */