ql4_os.c 46 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715
  1. /*
  2. * QLogic iSCSI HBA Driver
  3. * Copyright (c) 2003-2006 QLogic Corporation
  4. *
  5. * See LICENSE.qla4xxx for copyright and licensing details.
  6. */
  7. #include <linux/moduleparam.h>
  8. #include <scsi/scsi_tcq.h>
  9. #include <scsi/scsicam.h>
  10. #include "ql4_def.h"
  11. #include "ql4_version.h"
  12. #include "ql4_glbl.h"
  13. #include "ql4_dbg.h"
  14. #include "ql4_inline.h"
  15. /*
  16. * Driver version
  17. */
  18. static char qla4xxx_version_str[40];
  19. /*
  20. * SRB allocation cache
  21. */
  22. static struct kmem_cache *srb_cachep;
  23. /*
  24. * Module parameter information and variables
  25. */
  26. int ql4xdiscoverywait = 60;
  27. module_param(ql4xdiscoverywait, int, S_IRUGO | S_IRUSR);
  28. MODULE_PARM_DESC(ql4xdiscoverywait, "Discovery wait time");
  29. int ql4xdontresethba = 0;
  30. module_param(ql4xdontresethba, int, S_IRUGO | S_IRUSR);
  31. MODULE_PARM_DESC(ql4xdontresethba,
  32. "Dont reset the HBA when the driver gets 0x8002 AEN "
  33. " default it will reset hba :0"
  34. " set to 1 to avoid resetting HBA");
  35. int ql4xextended_error_logging = 0; /* 0 = off, 1 = log errors */
  36. module_param(ql4xextended_error_logging, int, S_IRUGO | S_IRUSR);
  37. MODULE_PARM_DESC(ql4xextended_error_logging,
  38. "Option to enable extended error logging, "
  39. "Default is 0 - no logging, 1 - debug logging");
  40. int ql4_mod_unload = 0;
  41. /*
  42. * SCSI host template entry points
  43. */
  44. static void qla4xxx_config_dma_addressing(struct scsi_qla_host *ha);
  45. /*
  46. * iSCSI template entry points
  47. */
  48. static int qla4xxx_tgt_dscvr(struct Scsi_Host *shost,
  49. enum iscsi_tgt_dscvr type, uint32_t enable,
  50. struct sockaddr *dst_addr);
  51. static int qla4xxx_conn_get_param(struct iscsi_cls_conn *conn,
  52. enum iscsi_param param, char *buf);
  53. static int qla4xxx_sess_get_param(struct iscsi_cls_session *sess,
  54. enum iscsi_param param, char *buf);
  55. static int qla4xxx_host_get_param(struct Scsi_Host *shost,
  56. enum iscsi_host_param param, char *buf);
  57. static void qla4xxx_conn_stop(struct iscsi_cls_conn *conn, int flag);
  58. static int qla4xxx_conn_start(struct iscsi_cls_conn *conn);
  59. static void qla4xxx_recovery_timedout(struct iscsi_cls_session *session);
  60. /*
  61. * SCSI host template entry points
  62. */
  63. static int qla4xxx_queuecommand(struct scsi_cmnd *cmd,
  64. void (*done) (struct scsi_cmnd *));
  65. static int qla4xxx_eh_device_reset(struct scsi_cmnd *cmd);
  66. static int qla4xxx_eh_host_reset(struct scsi_cmnd *cmd);
  67. static int qla4xxx_slave_alloc(struct scsi_device *device);
  68. static int qla4xxx_slave_configure(struct scsi_device *device);
  69. static void qla4xxx_slave_destroy(struct scsi_device *sdev);
  70. static struct scsi_host_template qla4xxx_driver_template = {
  71. .module = THIS_MODULE,
  72. .name = DRIVER_NAME,
  73. .proc_name = DRIVER_NAME,
  74. .queuecommand = qla4xxx_queuecommand,
  75. .eh_device_reset_handler = qla4xxx_eh_device_reset,
  76. .eh_host_reset_handler = qla4xxx_eh_host_reset,
  77. .slave_configure = qla4xxx_slave_configure,
  78. .slave_alloc = qla4xxx_slave_alloc,
  79. .slave_destroy = qla4xxx_slave_destroy,
  80. .this_id = -1,
  81. .cmd_per_lun = 3,
  82. .use_clustering = ENABLE_CLUSTERING,
  83. .sg_tablesize = SG_ALL,
  84. .max_sectors = 0xFFFF,
  85. };
  86. static struct iscsi_transport qla4xxx_iscsi_transport = {
  87. .owner = THIS_MODULE,
  88. .name = DRIVER_NAME,
  89. .caps = CAP_FW_DB | CAP_SENDTARGETS_OFFLOAD |
  90. CAP_DATA_PATH_OFFLOAD,
  91. .param_mask = ISCSI_CONN_PORT | ISCSI_CONN_ADDRESS |
  92. ISCSI_TARGET_NAME | ISCSI_TPGT,
  93. .host_param_mask = ISCSI_HOST_HWADDRESS |
  94. ISCSI_HOST_IPADDRESS |
  95. ISCSI_HOST_INITIATOR_NAME,
  96. .sessiondata_size = sizeof(struct ddb_entry),
  97. .host_template = &qla4xxx_driver_template,
  98. .tgt_dscvr = qla4xxx_tgt_dscvr,
  99. .get_conn_param = qla4xxx_conn_get_param,
  100. .get_session_param = qla4xxx_sess_get_param,
  101. .get_host_param = qla4xxx_host_get_param,
  102. .start_conn = qla4xxx_conn_start,
  103. .stop_conn = qla4xxx_conn_stop,
  104. .session_recovery_timedout = qla4xxx_recovery_timedout,
  105. };
  106. static struct scsi_transport_template *qla4xxx_scsi_transport;
  107. static void qla4xxx_recovery_timedout(struct iscsi_cls_session *session)
  108. {
  109. struct ddb_entry *ddb_entry = session->dd_data;
  110. struct scsi_qla_host *ha = ddb_entry->ha;
  111. DEBUG2(printk("scsi%ld: %s: index [%d] port down retry count of (%d) "
  112. "secs exhausted, marking device DEAD.\n", ha->host_no,
  113. __func__, ddb_entry->fw_ddb_index,
  114. ha->port_down_retry_count));
  115. atomic_set(&ddb_entry->state, DDB_STATE_DEAD);
  116. DEBUG2(printk("scsi%ld: %s: scheduling dpc routine - dpc flags = "
  117. "0x%lx\n", ha->host_no, __func__, ha->dpc_flags));
  118. queue_work(ha->dpc_thread, &ha->dpc_work);
  119. }
  120. static int qla4xxx_conn_start(struct iscsi_cls_conn *conn)
  121. {
  122. struct iscsi_cls_session *session;
  123. struct ddb_entry *ddb_entry;
  124. session = iscsi_dev_to_session(conn->dev.parent);
  125. ddb_entry = session->dd_data;
  126. DEBUG2(printk("scsi%ld: %s: index [%d] starting conn\n",
  127. ddb_entry->ha->host_no, __func__,
  128. ddb_entry->fw_ddb_index));
  129. iscsi_unblock_session(session);
  130. return 0;
  131. }
  132. static void qla4xxx_conn_stop(struct iscsi_cls_conn *conn, int flag)
  133. {
  134. struct iscsi_cls_session *session;
  135. struct ddb_entry *ddb_entry;
  136. session = iscsi_dev_to_session(conn->dev.parent);
  137. ddb_entry = session->dd_data;
  138. DEBUG2(printk("scsi%ld: %s: index [%d] stopping conn\n",
  139. ddb_entry->ha->host_no, __func__,
  140. ddb_entry->fw_ddb_index));
  141. if (flag == STOP_CONN_RECOVER)
  142. iscsi_block_session(session);
  143. else
  144. printk(KERN_ERR "iscsi: invalid stop flag %d\n", flag);
  145. }
  146. static int qla4xxx_host_get_param(struct Scsi_Host *shost,
  147. enum iscsi_host_param param, char *buf)
  148. {
  149. struct scsi_qla_host *ha = to_qla_host(shost);
  150. int len;
  151. switch (param) {
  152. case ISCSI_HOST_PARAM_HWADDRESS:
  153. len = sysfs_format_mac(buf, ha->my_mac, MAC_ADDR_LEN);
  154. break;
  155. case ISCSI_HOST_PARAM_IPADDRESS:
  156. len = sprintf(buf, "%d.%d.%d.%d\n", ha->ip_address[0],
  157. ha->ip_address[1], ha->ip_address[2],
  158. ha->ip_address[3]);
  159. break;
  160. case ISCSI_HOST_PARAM_INITIATOR_NAME:
  161. len = sprintf(buf, "%s\n", ha->name_string);
  162. break;
  163. default:
  164. return -ENOSYS;
  165. }
  166. return len;
  167. }
  168. static int qla4xxx_sess_get_param(struct iscsi_cls_session *sess,
  169. enum iscsi_param param, char *buf)
  170. {
  171. struct ddb_entry *ddb_entry = sess->dd_data;
  172. int len;
  173. switch (param) {
  174. case ISCSI_PARAM_TARGET_NAME:
  175. len = snprintf(buf, PAGE_SIZE - 1, "%s\n",
  176. ddb_entry->iscsi_name);
  177. break;
  178. case ISCSI_PARAM_TPGT:
  179. len = sprintf(buf, "%u\n", ddb_entry->tpgt);
  180. break;
  181. default:
  182. return -ENOSYS;
  183. }
  184. return len;
  185. }
  186. static int qla4xxx_conn_get_param(struct iscsi_cls_conn *conn,
  187. enum iscsi_param param, char *buf)
  188. {
  189. struct iscsi_cls_session *session;
  190. struct ddb_entry *ddb_entry;
  191. int len;
  192. session = iscsi_dev_to_session(conn->dev.parent);
  193. ddb_entry = session->dd_data;
  194. switch (param) {
  195. case ISCSI_PARAM_CONN_PORT:
  196. len = sprintf(buf, "%hu\n", ddb_entry->port);
  197. break;
  198. case ISCSI_PARAM_CONN_ADDRESS:
  199. /* TODO: what are the ipv6 bits */
  200. len = sprintf(buf, "%u.%u.%u.%u\n",
  201. NIPQUAD(ddb_entry->ip_addr));
  202. break;
  203. default:
  204. return -ENOSYS;
  205. }
  206. return len;
  207. }
  208. static int qla4xxx_tgt_dscvr(struct Scsi_Host *shost,
  209. enum iscsi_tgt_dscvr type, uint32_t enable,
  210. struct sockaddr *dst_addr)
  211. {
  212. struct scsi_qla_host *ha;
  213. struct sockaddr_in *addr;
  214. struct sockaddr_in6 *addr6;
  215. int ret = 0;
  216. ha = (struct scsi_qla_host *) shost->hostdata;
  217. switch (type) {
  218. case ISCSI_TGT_DSCVR_SEND_TARGETS:
  219. if (dst_addr->sa_family == AF_INET) {
  220. addr = (struct sockaddr_in *)dst_addr;
  221. if (qla4xxx_send_tgts(ha, (char *)&addr->sin_addr,
  222. addr->sin_port) != QLA_SUCCESS)
  223. ret = -EIO;
  224. } else if (dst_addr->sa_family == AF_INET6) {
  225. /*
  226. * TODO: fix qla4xxx_send_tgts
  227. */
  228. addr6 = (struct sockaddr_in6 *)dst_addr;
  229. if (qla4xxx_send_tgts(ha, (char *)&addr6->sin6_addr,
  230. addr6->sin6_port) != QLA_SUCCESS)
  231. ret = -EIO;
  232. } else
  233. ret = -ENOSYS;
  234. break;
  235. default:
  236. ret = -ENOSYS;
  237. }
  238. return ret;
  239. }
  240. void qla4xxx_destroy_sess(struct ddb_entry *ddb_entry)
  241. {
  242. if (!ddb_entry->sess)
  243. return;
  244. if (ddb_entry->conn) {
  245. atomic_set(&ddb_entry->state, DDB_STATE_DEAD);
  246. iscsi_remove_session(ddb_entry->sess);
  247. }
  248. iscsi_free_session(ddb_entry->sess);
  249. }
  250. int qla4xxx_add_sess(struct ddb_entry *ddb_entry)
  251. {
  252. int err;
  253. ddb_entry->sess->recovery_tmo = ddb_entry->ha->port_down_retry_count;
  254. err = iscsi_add_session(ddb_entry->sess, ddb_entry->fw_ddb_index);
  255. if (err) {
  256. DEBUG2(printk(KERN_ERR "Could not add session.\n"));
  257. return err;
  258. }
  259. ddb_entry->conn = iscsi_create_conn(ddb_entry->sess, 0);
  260. if (!ddb_entry->conn) {
  261. iscsi_remove_session(ddb_entry->sess);
  262. DEBUG2(printk(KERN_ERR "Could not add connection.\n"));
  263. return -ENOMEM;
  264. }
  265. return 0;
  266. }
  267. struct ddb_entry *qla4xxx_alloc_sess(struct scsi_qla_host *ha)
  268. {
  269. struct ddb_entry *ddb_entry;
  270. struct iscsi_cls_session *sess;
  271. sess = iscsi_alloc_session(ha->host, &qla4xxx_iscsi_transport);
  272. if (!sess)
  273. return NULL;
  274. ddb_entry = sess->dd_data;
  275. memset(ddb_entry, 0, sizeof(*ddb_entry));
  276. ddb_entry->ha = ha;
  277. ddb_entry->sess = sess;
  278. return ddb_entry;
  279. }
  280. /*
  281. * Timer routines
  282. */
  283. static void qla4xxx_start_timer(struct scsi_qla_host *ha, void *func,
  284. unsigned long interval)
  285. {
  286. DEBUG(printk("scsi: %s: Starting timer thread for adapter %d\n",
  287. __func__, ha->host->host_no));
  288. init_timer(&ha->timer);
  289. ha->timer.expires = jiffies + interval * HZ;
  290. ha->timer.data = (unsigned long)ha;
  291. ha->timer.function = (void (*)(unsigned long))func;
  292. add_timer(&ha->timer);
  293. ha->timer_active = 1;
  294. }
  295. static void qla4xxx_stop_timer(struct scsi_qla_host *ha)
  296. {
  297. del_timer_sync(&ha->timer);
  298. ha->timer_active = 0;
  299. }
  300. /***
  301. * qla4xxx_mark_device_missing - mark a device as missing.
  302. * @ha: Pointer to host adapter structure.
  303. * @ddb_entry: Pointer to device database entry
  304. *
  305. * This routine marks a device missing and resets the relogin retry count.
  306. **/
  307. void qla4xxx_mark_device_missing(struct scsi_qla_host *ha,
  308. struct ddb_entry *ddb_entry)
  309. {
  310. atomic_set(&ddb_entry->state, DDB_STATE_MISSING);
  311. DEBUG3(printk("scsi%d:%d:%d: index [%d] marked MISSING\n",
  312. ha->host_no, ddb_entry->bus, ddb_entry->target,
  313. ddb_entry->fw_ddb_index));
  314. iscsi_conn_error(ddb_entry->conn, ISCSI_ERR_CONN_FAILED);
  315. }
  316. static struct srb* qla4xxx_get_new_srb(struct scsi_qla_host *ha,
  317. struct ddb_entry *ddb_entry,
  318. struct scsi_cmnd *cmd,
  319. void (*done)(struct scsi_cmnd *))
  320. {
  321. struct srb *srb;
  322. srb = mempool_alloc(ha->srb_mempool, GFP_ATOMIC);
  323. if (!srb)
  324. return srb;
  325. atomic_set(&srb->ref_count, 1);
  326. srb->ha = ha;
  327. srb->ddb = ddb_entry;
  328. srb->cmd = cmd;
  329. srb->flags = 0;
  330. cmd->SCp.ptr = (void *)srb;
  331. cmd->scsi_done = done;
  332. return srb;
  333. }
  334. static void qla4xxx_srb_free_dma(struct scsi_qla_host *ha, struct srb *srb)
  335. {
  336. struct scsi_cmnd *cmd = srb->cmd;
  337. if (srb->flags & SRB_DMA_VALID) {
  338. scsi_dma_unmap(cmd);
  339. srb->flags &= ~SRB_DMA_VALID;
  340. }
  341. cmd->SCp.ptr = NULL;
  342. }
  343. void qla4xxx_srb_compl(struct scsi_qla_host *ha, struct srb *srb)
  344. {
  345. struct scsi_cmnd *cmd = srb->cmd;
  346. qla4xxx_srb_free_dma(ha, srb);
  347. mempool_free(srb, ha->srb_mempool);
  348. cmd->scsi_done(cmd);
  349. }
  350. /**
  351. * qla4xxx_queuecommand - scsi layer issues scsi command to driver.
  352. * @cmd: Pointer to Linux's SCSI command structure
  353. * @done_fn: Function that the driver calls to notify the SCSI mid-layer
  354. * that the command has been processed.
  355. *
  356. * Remarks:
  357. * This routine is invoked by Linux to send a SCSI command to the driver.
  358. * The mid-level driver tries to ensure that queuecommand never gets
  359. * invoked concurrently with itself or the interrupt handler (although
  360. * the interrupt handler may call this routine as part of request-
  361. * completion handling). Unfortunely, it sometimes calls the scheduler
  362. * in interrupt context which is a big NO! NO!.
  363. **/
  364. static int qla4xxx_queuecommand(struct scsi_cmnd *cmd,
  365. void (*done)(struct scsi_cmnd *))
  366. {
  367. struct scsi_qla_host *ha = to_qla_host(cmd->device->host);
  368. struct ddb_entry *ddb_entry = cmd->device->hostdata;
  369. struct srb *srb;
  370. int rval;
  371. if (atomic_read(&ddb_entry->state) != DDB_STATE_ONLINE) {
  372. if (atomic_read(&ddb_entry->state) == DDB_STATE_DEAD) {
  373. cmd->result = DID_NO_CONNECT << 16;
  374. goto qc_fail_command;
  375. }
  376. goto qc_host_busy;
  377. }
  378. if (test_bit(DPC_RESET_HA_INTR, &ha->dpc_flags))
  379. goto qc_host_busy;
  380. spin_unlock_irq(ha->host->host_lock);
  381. srb = qla4xxx_get_new_srb(ha, ddb_entry, cmd, done);
  382. if (!srb)
  383. goto qc_host_busy_lock;
  384. rval = qla4xxx_send_command_to_isp(ha, srb);
  385. if (rval != QLA_SUCCESS)
  386. goto qc_host_busy_free_sp;
  387. spin_lock_irq(ha->host->host_lock);
  388. return 0;
  389. qc_host_busy_free_sp:
  390. qla4xxx_srb_free_dma(ha, srb);
  391. mempool_free(srb, ha->srb_mempool);
  392. qc_host_busy_lock:
  393. spin_lock_irq(ha->host->host_lock);
  394. qc_host_busy:
  395. return SCSI_MLQUEUE_HOST_BUSY;
  396. qc_fail_command:
  397. done(cmd);
  398. return 0;
  399. }
  400. /**
  401. * qla4xxx_mem_free - frees memory allocated to adapter
  402. * @ha: Pointer to host adapter structure.
  403. *
  404. * Frees memory previously allocated by qla4xxx_mem_alloc
  405. **/
  406. static void qla4xxx_mem_free(struct scsi_qla_host *ha)
  407. {
  408. if (ha->queues)
  409. dma_free_coherent(&ha->pdev->dev, ha->queues_len, ha->queues,
  410. ha->queues_dma);
  411. ha->queues_len = 0;
  412. ha->queues = NULL;
  413. ha->queues_dma = 0;
  414. ha->request_ring = NULL;
  415. ha->request_dma = 0;
  416. ha->response_ring = NULL;
  417. ha->response_dma = 0;
  418. ha->shadow_regs = NULL;
  419. ha->shadow_regs_dma = 0;
  420. /* Free srb pool. */
  421. if (ha->srb_mempool)
  422. mempool_destroy(ha->srb_mempool);
  423. ha->srb_mempool = NULL;
  424. /* release io space registers */
  425. if (ha->reg)
  426. iounmap(ha->reg);
  427. pci_release_regions(ha->pdev);
  428. }
  429. /**
  430. * qla4xxx_mem_alloc - allocates memory for use by adapter.
  431. * @ha: Pointer to host adapter structure
  432. *
  433. * Allocates DMA memory for request and response queues. Also allocates memory
  434. * for srbs.
  435. **/
  436. static int qla4xxx_mem_alloc(struct scsi_qla_host *ha)
  437. {
  438. unsigned long align;
  439. /* Allocate contiguous block of DMA memory for queues. */
  440. ha->queues_len = ((REQUEST_QUEUE_DEPTH * QUEUE_SIZE) +
  441. (RESPONSE_QUEUE_DEPTH * QUEUE_SIZE) +
  442. sizeof(struct shadow_regs) +
  443. MEM_ALIGN_VALUE +
  444. (PAGE_SIZE - 1)) & ~(PAGE_SIZE - 1);
  445. ha->queues = dma_alloc_coherent(&ha->pdev->dev, ha->queues_len,
  446. &ha->queues_dma, GFP_KERNEL);
  447. if (ha->queues == NULL) {
  448. dev_warn(&ha->pdev->dev,
  449. "Memory Allocation failed - queues.\n");
  450. goto mem_alloc_error_exit;
  451. }
  452. memset(ha->queues, 0, ha->queues_len);
  453. /*
  454. * As per RISC alignment requirements -- the bus-address must be a
  455. * multiple of the request-ring size (in bytes).
  456. */
  457. align = 0;
  458. if ((unsigned long)ha->queues_dma & (MEM_ALIGN_VALUE - 1))
  459. align = MEM_ALIGN_VALUE - ((unsigned long)ha->queues_dma &
  460. (MEM_ALIGN_VALUE - 1));
  461. /* Update request and response queue pointers. */
  462. ha->request_dma = ha->queues_dma + align;
  463. ha->request_ring = (struct queue_entry *) (ha->queues + align);
  464. ha->response_dma = ha->queues_dma + align +
  465. (REQUEST_QUEUE_DEPTH * QUEUE_SIZE);
  466. ha->response_ring = (struct queue_entry *) (ha->queues + align +
  467. (REQUEST_QUEUE_DEPTH *
  468. QUEUE_SIZE));
  469. ha->shadow_regs_dma = ha->queues_dma + align +
  470. (REQUEST_QUEUE_DEPTH * QUEUE_SIZE) +
  471. (RESPONSE_QUEUE_DEPTH * QUEUE_SIZE);
  472. ha->shadow_regs = (struct shadow_regs *) (ha->queues + align +
  473. (REQUEST_QUEUE_DEPTH *
  474. QUEUE_SIZE) +
  475. (RESPONSE_QUEUE_DEPTH *
  476. QUEUE_SIZE));
  477. /* Allocate memory for srb pool. */
  478. ha->srb_mempool = mempool_create(SRB_MIN_REQ, mempool_alloc_slab,
  479. mempool_free_slab, srb_cachep);
  480. if (ha->srb_mempool == NULL) {
  481. dev_warn(&ha->pdev->dev,
  482. "Memory Allocation failed - SRB Pool.\n");
  483. goto mem_alloc_error_exit;
  484. }
  485. return QLA_SUCCESS;
  486. mem_alloc_error_exit:
  487. qla4xxx_mem_free(ha);
  488. return QLA_ERROR;
  489. }
  490. /**
  491. * qla4xxx_timer - checks every second for work to do.
  492. * @ha: Pointer to host adapter structure.
  493. **/
  494. static void qla4xxx_timer(struct scsi_qla_host *ha)
  495. {
  496. struct ddb_entry *ddb_entry, *dtemp;
  497. int start_dpc = 0;
  498. /* Search for relogin's to time-out and port down retry. */
  499. list_for_each_entry_safe(ddb_entry, dtemp, &ha->ddb_list, list) {
  500. /* Count down time between sending relogins */
  501. if (adapter_up(ha) &&
  502. !test_bit(DF_RELOGIN, &ddb_entry->flags) &&
  503. atomic_read(&ddb_entry->state) != DDB_STATE_ONLINE) {
  504. if (atomic_read(&ddb_entry->retry_relogin_timer) !=
  505. INVALID_ENTRY) {
  506. if (atomic_read(&ddb_entry->retry_relogin_timer)
  507. == 0) {
  508. atomic_set(&ddb_entry->
  509. retry_relogin_timer,
  510. INVALID_ENTRY);
  511. set_bit(DPC_RELOGIN_DEVICE,
  512. &ha->dpc_flags);
  513. set_bit(DF_RELOGIN, &ddb_entry->flags);
  514. DEBUG2(printk("scsi%ld: %s: index [%d]"
  515. " login device\n",
  516. ha->host_no, __func__,
  517. ddb_entry->fw_ddb_index));
  518. } else
  519. atomic_dec(&ddb_entry->
  520. retry_relogin_timer);
  521. }
  522. }
  523. /* Wait for relogin to timeout */
  524. if (atomic_read(&ddb_entry->relogin_timer) &&
  525. (atomic_dec_and_test(&ddb_entry->relogin_timer) != 0)) {
  526. /*
  527. * If the relogin times out and the device is
  528. * still NOT ONLINE then try and relogin again.
  529. */
  530. if (atomic_read(&ddb_entry->state) !=
  531. DDB_STATE_ONLINE &&
  532. ddb_entry->fw_ddb_device_state ==
  533. DDB_DS_SESSION_FAILED) {
  534. /* Reset retry relogin timer */
  535. atomic_inc(&ddb_entry->relogin_retry_count);
  536. DEBUG2(printk("scsi%ld: index[%d] relogin"
  537. " timed out-retrying"
  538. " relogin (%d)\n",
  539. ha->host_no,
  540. ddb_entry->fw_ddb_index,
  541. atomic_read(&ddb_entry->
  542. relogin_retry_count))
  543. );
  544. start_dpc++;
  545. DEBUG(printk("scsi%ld:%d:%d: index [%d] "
  546. "initate relogin after"
  547. " %d seconds\n",
  548. ha->host_no, ddb_entry->bus,
  549. ddb_entry->target,
  550. ddb_entry->fw_ddb_index,
  551. ddb_entry->default_time2wait + 4)
  552. );
  553. atomic_set(&ddb_entry->retry_relogin_timer,
  554. ddb_entry->default_time2wait + 4);
  555. }
  556. }
  557. }
  558. /* Check for heartbeat interval. */
  559. if (ha->firmware_options & FWOPT_HEARTBEAT_ENABLE &&
  560. ha->heartbeat_interval != 0) {
  561. ha->seconds_since_last_heartbeat++;
  562. if (ha->seconds_since_last_heartbeat >
  563. ha->heartbeat_interval + 2)
  564. set_bit(DPC_RESET_HA, &ha->dpc_flags);
  565. }
  566. /* Wakeup the dpc routine for this adapter, if needed. */
  567. if ((start_dpc ||
  568. test_bit(DPC_RESET_HA, &ha->dpc_flags) ||
  569. test_bit(DPC_RETRY_RESET_HA, &ha->dpc_flags) ||
  570. test_bit(DPC_RELOGIN_DEVICE, &ha->dpc_flags) ||
  571. test_bit(DPC_RESET_HA_DESTROY_DDB_LIST, &ha->dpc_flags) ||
  572. test_bit(DPC_RESET_HA_INTR, &ha->dpc_flags) ||
  573. test_bit(DPC_GET_DHCP_IP_ADDR, &ha->dpc_flags) ||
  574. test_bit(DPC_AEN, &ha->dpc_flags)) &&
  575. ha->dpc_thread) {
  576. DEBUG2(printk("scsi%ld: %s: scheduling dpc routine"
  577. " - dpc flags = 0x%lx\n",
  578. ha->host_no, __func__, ha->dpc_flags));
  579. queue_work(ha->dpc_thread, &ha->dpc_work);
  580. }
  581. /* Reschedule timer thread to call us back in one second */
  582. mod_timer(&ha->timer, jiffies + HZ);
  583. DEBUG2(ha->seconds_since_last_intr++);
  584. }
  585. /**
  586. * qla4xxx_cmd_wait - waits for all outstanding commands to complete
  587. * @ha: Pointer to host adapter structure.
  588. *
  589. * This routine stalls the driver until all outstanding commands are returned.
  590. * Caller must release the Hardware Lock prior to calling this routine.
  591. **/
  592. static int qla4xxx_cmd_wait(struct scsi_qla_host *ha)
  593. {
  594. uint32_t index = 0;
  595. int stat = QLA_SUCCESS;
  596. unsigned long flags;
  597. struct scsi_cmnd *cmd;
  598. int wait_cnt = WAIT_CMD_TOV; /*
  599. * Initialized for 30 seconds as we
  600. * expect all commands to retuned
  601. * ASAP.
  602. */
  603. while (wait_cnt) {
  604. spin_lock_irqsave(&ha->hardware_lock, flags);
  605. /* Find a command that hasn't completed. */
  606. for (index = 0; index < ha->host->can_queue; index++) {
  607. cmd = scsi_host_find_tag(ha->host, index);
  608. if (cmd != NULL)
  609. break;
  610. }
  611. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  612. /* If No Commands are pending, wait is complete */
  613. if (index == ha->host->can_queue) {
  614. break;
  615. }
  616. /* If we timed out on waiting for commands to come back
  617. * return ERROR.
  618. */
  619. wait_cnt--;
  620. if (wait_cnt == 0)
  621. stat = QLA_ERROR;
  622. else {
  623. msleep(1000);
  624. }
  625. } /* End of While (wait_cnt) */
  626. return stat;
  627. }
  628. void qla4xxx_hw_reset(struct scsi_qla_host *ha)
  629. {
  630. uint32_t ctrl_status;
  631. unsigned long flags = 0;
  632. DEBUG2(printk(KERN_ERR "scsi%ld: %s\n", ha->host_no, __func__));
  633. spin_lock_irqsave(&ha->hardware_lock, flags);
  634. /*
  635. * If the SCSI Reset Interrupt bit is set, clear it.
  636. * Otherwise, the Soft Reset won't work.
  637. */
  638. ctrl_status = readw(&ha->reg->ctrl_status);
  639. if ((ctrl_status & CSR_SCSI_RESET_INTR) != 0)
  640. writel(set_rmask(CSR_SCSI_RESET_INTR), &ha->reg->ctrl_status);
  641. /* Issue Soft Reset */
  642. writel(set_rmask(CSR_SOFT_RESET), &ha->reg->ctrl_status);
  643. readl(&ha->reg->ctrl_status);
  644. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  645. }
  646. /**
  647. * qla4xxx_soft_reset - performs soft reset.
  648. * @ha: Pointer to host adapter structure.
  649. **/
  650. int qla4xxx_soft_reset(struct scsi_qla_host *ha)
  651. {
  652. uint32_t max_wait_time;
  653. unsigned long flags = 0;
  654. int status = QLA_ERROR;
  655. uint32_t ctrl_status;
  656. qla4xxx_hw_reset(ha);
  657. /* Wait until the Network Reset Intr bit is cleared */
  658. max_wait_time = RESET_INTR_TOV;
  659. do {
  660. spin_lock_irqsave(&ha->hardware_lock, flags);
  661. ctrl_status = readw(&ha->reg->ctrl_status);
  662. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  663. if ((ctrl_status & CSR_NET_RESET_INTR) == 0)
  664. break;
  665. msleep(1000);
  666. } while ((--max_wait_time));
  667. if ((ctrl_status & CSR_NET_RESET_INTR) != 0) {
  668. DEBUG2(printk(KERN_WARNING
  669. "scsi%ld: Network Reset Intr not cleared by "
  670. "Network function, clearing it now!\n",
  671. ha->host_no));
  672. spin_lock_irqsave(&ha->hardware_lock, flags);
  673. writel(set_rmask(CSR_NET_RESET_INTR), &ha->reg->ctrl_status);
  674. readl(&ha->reg->ctrl_status);
  675. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  676. }
  677. /* Wait until the firmware tells us the Soft Reset is done */
  678. max_wait_time = SOFT_RESET_TOV;
  679. do {
  680. spin_lock_irqsave(&ha->hardware_lock, flags);
  681. ctrl_status = readw(&ha->reg->ctrl_status);
  682. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  683. if ((ctrl_status & CSR_SOFT_RESET) == 0) {
  684. status = QLA_SUCCESS;
  685. break;
  686. }
  687. msleep(1000);
  688. } while ((--max_wait_time));
  689. /*
  690. * Also, make sure that the SCSI Reset Interrupt bit has been cleared
  691. * after the soft reset has taken place.
  692. */
  693. spin_lock_irqsave(&ha->hardware_lock, flags);
  694. ctrl_status = readw(&ha->reg->ctrl_status);
  695. if ((ctrl_status & CSR_SCSI_RESET_INTR) != 0) {
  696. writel(set_rmask(CSR_SCSI_RESET_INTR), &ha->reg->ctrl_status);
  697. readl(&ha->reg->ctrl_status);
  698. }
  699. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  700. /* If soft reset fails then most probably the bios on other
  701. * function is also enabled.
  702. * Since the initialization is sequential the other fn
  703. * wont be able to acknowledge the soft reset.
  704. * Issue a force soft reset to workaround this scenario.
  705. */
  706. if (max_wait_time == 0) {
  707. /* Issue Force Soft Reset */
  708. spin_lock_irqsave(&ha->hardware_lock, flags);
  709. writel(set_rmask(CSR_FORCE_SOFT_RESET), &ha->reg->ctrl_status);
  710. readl(&ha->reg->ctrl_status);
  711. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  712. /* Wait until the firmware tells us the Soft Reset is done */
  713. max_wait_time = SOFT_RESET_TOV;
  714. do {
  715. spin_lock_irqsave(&ha->hardware_lock, flags);
  716. ctrl_status = readw(&ha->reg->ctrl_status);
  717. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  718. if ((ctrl_status & CSR_FORCE_SOFT_RESET) == 0) {
  719. status = QLA_SUCCESS;
  720. break;
  721. }
  722. msleep(1000);
  723. } while ((--max_wait_time));
  724. }
  725. return status;
  726. }
  727. /**
  728. * qla4xxx_flush_active_srbs - returns all outstanding i/o requests to O.S.
  729. * @ha: Pointer to host adapter structure.
  730. *
  731. * This routine is called just prior to a HARD RESET to return all
  732. * outstanding commands back to the Operating System.
  733. * Caller should make sure that the following locks are released
  734. * before this calling routine: Hardware lock, and io_request_lock.
  735. **/
  736. static void qla4xxx_flush_active_srbs(struct scsi_qla_host *ha)
  737. {
  738. struct srb *srb;
  739. int i;
  740. unsigned long flags;
  741. spin_lock_irqsave(&ha->hardware_lock, flags);
  742. for (i = 0; i < ha->host->can_queue; i++) {
  743. srb = qla4xxx_del_from_active_array(ha, i);
  744. if (srb != NULL) {
  745. srb->cmd->result = DID_RESET << 16;
  746. qla4xxx_srb_compl(ha, srb);
  747. }
  748. }
  749. spin_unlock_irqrestore(&ha->hardware_lock, flags);
  750. }
  751. /**
  752. * qla4xxx_recover_adapter - recovers adapter after a fatal error
  753. * @ha: Pointer to host adapter structure.
  754. * @renew_ddb_list: Indicates what to do with the adapter's ddb list
  755. * after adapter recovery has completed.
  756. * 0=preserve ddb list, 1=destroy and rebuild ddb list
  757. **/
  758. static int qla4xxx_recover_adapter(struct scsi_qla_host *ha,
  759. uint8_t renew_ddb_list)
  760. {
  761. int status;
  762. /* Stall incoming I/O until we are done */
  763. clear_bit(AF_ONLINE, &ha->flags);
  764. DEBUG2(printk("scsi%ld: %s calling qla4xxx_cmd_wait\n", ha->host_no,
  765. __func__));
  766. /* Wait for outstanding commands to complete.
  767. * Stalls the driver for max 30 secs
  768. */
  769. status = qla4xxx_cmd_wait(ha);
  770. qla4xxx_disable_intrs(ha);
  771. /* Flush any pending ddb changed AENs */
  772. qla4xxx_process_aen(ha, FLUSH_DDB_CHANGED_AENS);
  773. /* Reset the firmware. If successful, function
  774. * returns with ISP interrupts enabled.
  775. */
  776. if (status == QLA_SUCCESS) {
  777. DEBUG2(printk("scsi%ld: %s - Performing soft reset..\n",
  778. ha->host_no, __func__));
  779. qla4xxx_flush_active_srbs(ha);
  780. if (ql4xxx_lock_drvr_wait(ha) == QLA_SUCCESS)
  781. status = qla4xxx_soft_reset(ha);
  782. else
  783. status = QLA_ERROR;
  784. }
  785. /* Flush any pending ddb changed AENs */
  786. qla4xxx_process_aen(ha, FLUSH_DDB_CHANGED_AENS);
  787. /* Re-initialize firmware. If successful, function returns
  788. * with ISP interrupts enabled */
  789. if (status == QLA_SUCCESS) {
  790. DEBUG2(printk("scsi%ld: %s - Initializing adapter..\n",
  791. ha->host_no, __func__));
  792. /* If successful, AF_ONLINE flag set in
  793. * qla4xxx_initialize_adapter */
  794. status = qla4xxx_initialize_adapter(ha, renew_ddb_list);
  795. }
  796. /* Failed adapter initialization?
  797. * Retry reset_ha only if invoked via DPC (DPC_RESET_HA) */
  798. if ((test_bit(AF_ONLINE, &ha->flags) == 0) &&
  799. (test_bit(DPC_RESET_HA, &ha->dpc_flags))) {
  800. /* Adapter initialization failed, see if we can retry
  801. * resetting the ha */
  802. if (!test_bit(DPC_RETRY_RESET_HA, &ha->dpc_flags)) {
  803. ha->retry_reset_ha_cnt = MAX_RESET_HA_RETRIES;
  804. DEBUG2(printk("scsi%ld: recover adapter - retrying "
  805. "(%d) more times\n", ha->host_no,
  806. ha->retry_reset_ha_cnt));
  807. set_bit(DPC_RETRY_RESET_HA, &ha->dpc_flags);
  808. status = QLA_ERROR;
  809. } else {
  810. if (ha->retry_reset_ha_cnt > 0) {
  811. /* Schedule another Reset HA--DPC will retry */
  812. ha->retry_reset_ha_cnt--;
  813. DEBUG2(printk("scsi%ld: recover adapter - "
  814. "retry remaining %d\n",
  815. ha->host_no,
  816. ha->retry_reset_ha_cnt));
  817. status = QLA_ERROR;
  818. }
  819. if (ha->retry_reset_ha_cnt == 0) {
  820. /* Recover adapter retries have been exhausted.
  821. * Adapter DEAD */
  822. DEBUG2(printk("scsi%ld: recover adapter "
  823. "failed - board disabled\n",
  824. ha->host_no));
  825. qla4xxx_flush_active_srbs(ha);
  826. clear_bit(DPC_RETRY_RESET_HA, &ha->dpc_flags);
  827. clear_bit(DPC_RESET_HA, &ha->dpc_flags);
  828. clear_bit(DPC_RESET_HA_DESTROY_DDB_LIST,
  829. &ha->dpc_flags);
  830. status = QLA_ERROR;
  831. }
  832. }
  833. } else {
  834. clear_bit(DPC_RESET_HA, &ha->dpc_flags);
  835. clear_bit(DPC_RESET_HA_DESTROY_DDB_LIST, &ha->dpc_flags);
  836. clear_bit(DPC_RETRY_RESET_HA, &ha->dpc_flags);
  837. }
  838. ha->adapter_error_count++;
  839. if (status == QLA_SUCCESS)
  840. qla4xxx_enable_intrs(ha);
  841. DEBUG2(printk("scsi%ld: recover adapter .. DONE\n", ha->host_no));
  842. return status;
  843. }
  844. /**
  845. * qla4xxx_do_dpc - dpc routine
  846. * @data: in our case pointer to adapter structure
  847. *
  848. * This routine is a task that is schedule by the interrupt handler
  849. * to perform the background processing for interrupts. We put it
  850. * on a task queue that is consumed whenever the scheduler runs; that's
  851. * so you can do anything (i.e. put the process to sleep etc). In fact,
  852. * the mid-level tries to sleep when it reaches the driver threshold
  853. * "host->can_queue". This can cause a panic if we were in our interrupt code.
  854. **/
  855. static void qla4xxx_do_dpc(struct work_struct *work)
  856. {
  857. struct scsi_qla_host *ha =
  858. container_of(work, struct scsi_qla_host, dpc_work);
  859. struct ddb_entry *ddb_entry, *dtemp;
  860. int status = QLA_ERROR;
  861. DEBUG2(printk("scsi%ld: %s: DPC handler waking up."
  862. "flags = 0x%08lx, dpc_flags = 0x%08lx ctrl_stat = 0x%08x\n",
  863. ha->host_no, __func__, ha->flags, ha->dpc_flags,
  864. readw(&ha->reg->ctrl_status)));
  865. /* Initialization not yet finished. Don't do anything yet. */
  866. if (!test_bit(AF_INIT_DONE, &ha->flags))
  867. return;
  868. if (adapter_up(ha) ||
  869. test_bit(DPC_RESET_HA, &ha->dpc_flags) ||
  870. test_bit(DPC_RESET_HA_INTR, &ha->dpc_flags) ||
  871. test_bit(DPC_RESET_HA_DESTROY_DDB_LIST, &ha->dpc_flags)) {
  872. if (test_bit(DPC_RESET_HA_DESTROY_DDB_LIST, &ha->dpc_flags) ||
  873. test_bit(DPC_RESET_HA, &ha->dpc_flags))
  874. qla4xxx_recover_adapter(ha, PRESERVE_DDB_LIST);
  875. if (test_bit(DPC_RESET_HA_INTR, &ha->dpc_flags)) {
  876. uint8_t wait_time = RESET_INTR_TOV;
  877. while ((readw(&ha->reg->ctrl_status) &
  878. (CSR_SOFT_RESET | CSR_FORCE_SOFT_RESET)) != 0) {
  879. if (--wait_time == 0)
  880. break;
  881. msleep(1000);
  882. }
  883. if (wait_time == 0)
  884. DEBUG2(printk("scsi%ld: %s: SR|FSR "
  885. "bit not cleared-- resetting\n",
  886. ha->host_no, __func__));
  887. qla4xxx_flush_active_srbs(ha);
  888. if (ql4xxx_lock_drvr_wait(ha) == QLA_SUCCESS) {
  889. qla4xxx_process_aen(ha, FLUSH_DDB_CHANGED_AENS);
  890. status = qla4xxx_initialize_adapter(ha,
  891. PRESERVE_DDB_LIST);
  892. }
  893. clear_bit(DPC_RESET_HA_INTR, &ha->dpc_flags);
  894. if (status == QLA_SUCCESS)
  895. qla4xxx_enable_intrs(ha);
  896. }
  897. }
  898. /* ---- process AEN? --- */
  899. if (test_and_clear_bit(DPC_AEN, &ha->dpc_flags))
  900. qla4xxx_process_aen(ha, PROCESS_ALL_AENS);
  901. /* ---- Get DHCP IP Address? --- */
  902. if (test_and_clear_bit(DPC_GET_DHCP_IP_ADDR, &ha->dpc_flags))
  903. qla4xxx_get_dhcp_ip_address(ha);
  904. /* ---- relogin device? --- */
  905. if (adapter_up(ha) &&
  906. test_and_clear_bit(DPC_RELOGIN_DEVICE, &ha->dpc_flags)) {
  907. list_for_each_entry_safe(ddb_entry, dtemp,
  908. &ha->ddb_list, list) {
  909. if (test_and_clear_bit(DF_RELOGIN, &ddb_entry->flags) &&
  910. atomic_read(&ddb_entry->state) != DDB_STATE_ONLINE)
  911. qla4xxx_relogin_device(ha, ddb_entry);
  912. /*
  913. * If mbx cmd times out there is no point
  914. * in continuing further.
  915. * With large no of targets this can hang
  916. * the system.
  917. */
  918. if (test_bit(DPC_RESET_HA, &ha->dpc_flags)) {
  919. printk(KERN_WARNING "scsi%ld: %s: "
  920. "need to reset hba\n",
  921. ha->host_no, __func__);
  922. break;
  923. }
  924. }
  925. }
  926. }
  927. /**
  928. * qla4xxx_free_adapter - release the adapter
  929. * @ha: pointer to adapter structure
  930. **/
  931. static void qla4xxx_free_adapter(struct scsi_qla_host *ha)
  932. {
  933. if (test_bit(AF_INTERRUPTS_ON, &ha->flags)) {
  934. /* Turn-off interrupts on the card. */
  935. qla4xxx_disable_intrs(ha);
  936. }
  937. /* Kill the kernel thread for this host */
  938. if (ha->dpc_thread)
  939. destroy_workqueue(ha->dpc_thread);
  940. /* Issue Soft Reset to put firmware in unknown state */
  941. if (ql4xxx_lock_drvr_wait(ha) == QLA_SUCCESS)
  942. qla4xxx_hw_reset(ha);
  943. /* Remove timer thread, if present */
  944. if (ha->timer_active)
  945. qla4xxx_stop_timer(ha);
  946. /* Detach interrupts */
  947. if (test_and_clear_bit(AF_IRQ_ATTACHED, &ha->flags))
  948. free_irq(ha->pdev->irq, ha);
  949. /* free extra memory */
  950. qla4xxx_mem_free(ha);
  951. pci_disable_device(ha->pdev);
  952. }
  953. /***
  954. * qla4xxx_iospace_config - maps registers
  955. * @ha: pointer to adapter structure
  956. *
  957. * This routines maps HBA's registers from the pci address space
  958. * into the kernel virtual address space for memory mapped i/o.
  959. **/
  960. static int qla4xxx_iospace_config(struct scsi_qla_host *ha)
  961. {
  962. unsigned long pio, pio_len, pio_flags;
  963. unsigned long mmio, mmio_len, mmio_flags;
  964. pio = pci_resource_start(ha->pdev, 0);
  965. pio_len = pci_resource_len(ha->pdev, 0);
  966. pio_flags = pci_resource_flags(ha->pdev, 0);
  967. if (pio_flags & IORESOURCE_IO) {
  968. if (pio_len < MIN_IOBASE_LEN) {
  969. dev_warn(&ha->pdev->dev,
  970. "Invalid PCI I/O region size\n");
  971. pio = 0;
  972. }
  973. } else {
  974. dev_warn(&ha->pdev->dev, "region #0 not a PIO resource\n");
  975. pio = 0;
  976. }
  977. /* Use MMIO operations for all accesses. */
  978. mmio = pci_resource_start(ha->pdev, 1);
  979. mmio_len = pci_resource_len(ha->pdev, 1);
  980. mmio_flags = pci_resource_flags(ha->pdev, 1);
  981. if (!(mmio_flags & IORESOURCE_MEM)) {
  982. dev_err(&ha->pdev->dev,
  983. "region #0 not an MMIO resource, aborting\n");
  984. goto iospace_error_exit;
  985. }
  986. if (mmio_len < MIN_IOBASE_LEN) {
  987. dev_err(&ha->pdev->dev,
  988. "Invalid PCI mem region size, aborting\n");
  989. goto iospace_error_exit;
  990. }
  991. if (pci_request_regions(ha->pdev, DRIVER_NAME)) {
  992. dev_warn(&ha->pdev->dev,
  993. "Failed to reserve PIO/MMIO regions\n");
  994. goto iospace_error_exit;
  995. }
  996. ha->pio_address = pio;
  997. ha->pio_length = pio_len;
  998. ha->reg = ioremap(mmio, MIN_IOBASE_LEN);
  999. if (!ha->reg) {
  1000. dev_err(&ha->pdev->dev,
  1001. "cannot remap MMIO, aborting\n");
  1002. goto iospace_error_exit;
  1003. }
  1004. return 0;
  1005. iospace_error_exit:
  1006. return -ENOMEM;
  1007. }
  1008. /**
  1009. * qla4xxx_probe_adapter - callback function to probe HBA
  1010. * @pdev: pointer to pci_dev structure
  1011. * @pci_device_id: pointer to pci_device entry
  1012. *
  1013. * This routine will probe for Qlogic 4xxx iSCSI host adapters.
  1014. * It returns zero if successful. It also initializes all data necessary for
  1015. * the driver.
  1016. **/
  1017. static int __devinit qla4xxx_probe_adapter(struct pci_dev *pdev,
  1018. const struct pci_device_id *ent)
  1019. {
  1020. int ret = -ENODEV, status;
  1021. struct Scsi_Host *host;
  1022. struct scsi_qla_host *ha;
  1023. struct ddb_entry *ddb_entry, *ddbtemp;
  1024. uint8_t init_retry_count = 0;
  1025. char buf[34];
  1026. if (pci_enable_device(pdev))
  1027. return -1;
  1028. host = scsi_host_alloc(&qla4xxx_driver_template, sizeof(*ha));
  1029. if (host == NULL) {
  1030. printk(KERN_WARNING
  1031. "qla4xxx: Couldn't allocate host from scsi layer!\n");
  1032. goto probe_disable_device;
  1033. }
  1034. /* Clear our data area */
  1035. ha = (struct scsi_qla_host *) host->hostdata;
  1036. memset(ha, 0, sizeof(*ha));
  1037. /* Save the information from PCI BIOS. */
  1038. ha->pdev = pdev;
  1039. ha->host = host;
  1040. ha->host_no = host->host_no;
  1041. /* Configure PCI I/O space. */
  1042. ret = qla4xxx_iospace_config(ha);
  1043. if (ret)
  1044. goto probe_failed;
  1045. dev_info(&ha->pdev->dev, "Found an ISP%04x, irq %d, iobase 0x%p\n",
  1046. pdev->device, pdev->irq, ha->reg);
  1047. qla4xxx_config_dma_addressing(ha);
  1048. /* Initialize lists and spinlocks. */
  1049. INIT_LIST_HEAD(&ha->ddb_list);
  1050. INIT_LIST_HEAD(&ha->free_srb_q);
  1051. mutex_init(&ha->mbox_sem);
  1052. spin_lock_init(&ha->hardware_lock);
  1053. /* Allocate dma buffers */
  1054. if (qla4xxx_mem_alloc(ha)) {
  1055. dev_warn(&ha->pdev->dev,
  1056. "[ERROR] Failed to allocate memory for adapter\n");
  1057. ret = -ENOMEM;
  1058. goto probe_failed;
  1059. }
  1060. /*
  1061. * Initialize the Host adapter request/response queues and
  1062. * firmware
  1063. * NOTE: interrupts enabled upon successful completion
  1064. */
  1065. status = qla4xxx_initialize_adapter(ha, REBUILD_DDB_LIST);
  1066. while (status == QLA_ERROR && init_retry_count++ < MAX_INIT_RETRIES) {
  1067. DEBUG2(printk("scsi: %s: retrying adapter initialization "
  1068. "(%d)\n", __func__, init_retry_count));
  1069. qla4xxx_soft_reset(ha);
  1070. status = qla4xxx_initialize_adapter(ha, REBUILD_DDB_LIST);
  1071. }
  1072. if (status == QLA_ERROR) {
  1073. dev_warn(&ha->pdev->dev, "Failed to initialize adapter\n");
  1074. ret = -ENODEV;
  1075. goto probe_failed;
  1076. }
  1077. host->cmd_per_lun = 3;
  1078. host->max_channel = 0;
  1079. host->max_lun = MAX_LUNS - 1;
  1080. host->max_id = MAX_TARGETS;
  1081. host->max_cmd_len = IOCB_MAX_CDB_LEN;
  1082. host->can_queue = MAX_SRBS ;
  1083. host->transportt = qla4xxx_scsi_transport;
  1084. ret = scsi_init_shared_tag_map(host, MAX_SRBS);
  1085. if (ret) {
  1086. dev_warn(&ha->pdev->dev, "scsi_init_shared_tag_map failed\n");
  1087. goto probe_failed;
  1088. }
  1089. /* Startup the kernel thread for this host adapter. */
  1090. DEBUG2(printk("scsi: %s: Starting kernel thread for "
  1091. "qla4xxx_dpc\n", __func__));
  1092. sprintf(buf, "qla4xxx_%lu_dpc", ha->host_no);
  1093. ha->dpc_thread = create_singlethread_workqueue(buf);
  1094. if (!ha->dpc_thread) {
  1095. dev_warn(&ha->pdev->dev, "Unable to start DPC thread!\n");
  1096. ret = -ENODEV;
  1097. goto probe_failed;
  1098. }
  1099. INIT_WORK(&ha->dpc_work, qla4xxx_do_dpc);
  1100. ret = request_irq(pdev->irq, qla4xxx_intr_handler,
  1101. IRQF_DISABLED | IRQF_SHARED, "qla4xxx", ha);
  1102. if (ret) {
  1103. dev_warn(&ha->pdev->dev, "Failed to reserve interrupt %d"
  1104. " already in use.\n", pdev->irq);
  1105. goto probe_failed;
  1106. }
  1107. set_bit(AF_IRQ_ATTACHED, &ha->flags);
  1108. host->irq = pdev->irq;
  1109. DEBUG(printk("scsi%d: irq %d attached\n", ha->host_no, ha->pdev->irq));
  1110. qla4xxx_enable_intrs(ha);
  1111. /* Start timer thread. */
  1112. qla4xxx_start_timer(ha, qla4xxx_timer, 1);
  1113. set_bit(AF_INIT_DONE, &ha->flags);
  1114. pci_set_drvdata(pdev, ha);
  1115. ret = scsi_add_host(host, &pdev->dev);
  1116. if (ret)
  1117. goto probe_failed;
  1118. /* Update transport device information for all devices. */
  1119. list_for_each_entry_safe(ddb_entry, ddbtemp, &ha->ddb_list, list) {
  1120. if (ddb_entry->fw_ddb_device_state == DDB_DS_SESSION_ACTIVE)
  1121. if (qla4xxx_add_sess(ddb_entry))
  1122. goto remove_host;
  1123. }
  1124. printk(KERN_INFO
  1125. " QLogic iSCSI HBA Driver version: %s\n"
  1126. " QLogic ISP%04x @ %s, host#=%ld, fw=%02d.%02d.%02d.%02d\n",
  1127. qla4xxx_version_str, ha->pdev->device, pci_name(ha->pdev),
  1128. ha->host_no, ha->firmware_version[0], ha->firmware_version[1],
  1129. ha->patch_number, ha->build_number);
  1130. return 0;
  1131. remove_host:
  1132. qla4xxx_free_ddb_list(ha);
  1133. scsi_remove_host(host);
  1134. probe_failed:
  1135. qla4xxx_free_adapter(ha);
  1136. scsi_host_put(ha->host);
  1137. probe_disable_device:
  1138. pci_disable_device(pdev);
  1139. return ret;
  1140. }
  1141. /**
  1142. * qla4xxx_remove_adapter - calback function to remove adapter.
  1143. * @pci_dev: PCI device pointer
  1144. **/
  1145. static void __devexit qla4xxx_remove_adapter(struct pci_dev *pdev)
  1146. {
  1147. struct scsi_qla_host *ha;
  1148. ha = pci_get_drvdata(pdev);
  1149. qla4xxx_disable_intrs(ha);
  1150. while (test_bit(DPC_RESET_HA_INTR, &ha->dpc_flags))
  1151. ssleep(1);
  1152. /* remove devs from iscsi_sessions to scsi_devices */
  1153. qla4xxx_free_ddb_list(ha);
  1154. scsi_remove_host(ha->host);
  1155. qla4xxx_free_adapter(ha);
  1156. scsi_host_put(ha->host);
  1157. pci_set_drvdata(pdev, NULL);
  1158. }
  1159. /**
  1160. * qla4xxx_config_dma_addressing() - Configure OS DMA addressing method.
  1161. * @ha: HA context
  1162. *
  1163. * At exit, the @ha's flags.enable_64bit_addressing set to indicated
  1164. * supported addressing method.
  1165. */
  1166. static void qla4xxx_config_dma_addressing(struct scsi_qla_host *ha)
  1167. {
  1168. int retval;
  1169. /* Update our PCI device dma_mask for full 64 bit mask */
  1170. if (pci_set_dma_mask(ha->pdev, DMA_64BIT_MASK) == 0) {
  1171. if (pci_set_consistent_dma_mask(ha->pdev, DMA_64BIT_MASK)) {
  1172. dev_dbg(&ha->pdev->dev,
  1173. "Failed to set 64 bit PCI consistent mask; "
  1174. "using 32 bit.\n");
  1175. retval = pci_set_consistent_dma_mask(ha->pdev,
  1176. DMA_32BIT_MASK);
  1177. }
  1178. } else
  1179. retval = pci_set_dma_mask(ha->pdev, DMA_32BIT_MASK);
  1180. }
  1181. static int qla4xxx_slave_alloc(struct scsi_device *sdev)
  1182. {
  1183. struct iscsi_cls_session *sess = starget_to_session(sdev->sdev_target);
  1184. struct ddb_entry *ddb = sess->dd_data;
  1185. sdev->hostdata = ddb;
  1186. sdev->tagged_supported = 1;
  1187. scsi_activate_tcq(sdev, sdev->host->can_queue);
  1188. return 0;
  1189. }
  1190. static int qla4xxx_slave_configure(struct scsi_device *sdev)
  1191. {
  1192. sdev->tagged_supported = 1;
  1193. return 0;
  1194. }
  1195. static void qla4xxx_slave_destroy(struct scsi_device *sdev)
  1196. {
  1197. scsi_deactivate_tcq(sdev, 1);
  1198. }
  1199. /**
  1200. * qla4xxx_del_from_active_array - returns an active srb
  1201. * @ha: Pointer to host adapter structure.
  1202. * @index: index into to the active_array
  1203. *
  1204. * This routine removes and returns the srb at the specified index
  1205. **/
  1206. struct srb * qla4xxx_del_from_active_array(struct scsi_qla_host *ha, uint32_t index)
  1207. {
  1208. struct srb *srb = NULL;
  1209. struct scsi_cmnd *cmd;
  1210. if (!(cmd = scsi_host_find_tag(ha->host, index)))
  1211. return srb;
  1212. if (!(srb = (struct srb *)cmd->host_scribble))
  1213. return srb;
  1214. /* update counters */
  1215. if (srb->flags & SRB_DMA_VALID) {
  1216. ha->req_q_count += srb->iocb_cnt;
  1217. ha->iocb_cnt -= srb->iocb_cnt;
  1218. if (srb->cmd)
  1219. srb->cmd->host_scribble = NULL;
  1220. }
  1221. return srb;
  1222. }
  1223. /**
  1224. * qla4xxx_eh_wait_on_command - waits for command to be returned by firmware
  1225. * @ha: actual ha whose done queue will contain the comd returned by firmware.
  1226. * @cmd: Scsi Command to wait on.
  1227. *
  1228. * This routine waits for the command to be returned by the Firmware
  1229. * for some max time.
  1230. **/
  1231. static int qla4xxx_eh_wait_on_command(struct scsi_qla_host *ha,
  1232. struct scsi_cmnd *cmd)
  1233. {
  1234. int done = 0;
  1235. struct srb *rp;
  1236. uint32_t max_wait_time = EH_WAIT_CMD_TOV;
  1237. do {
  1238. /* Checking to see if its returned to OS */
  1239. rp = (struct srb *) cmd->SCp.ptr;
  1240. if (rp == NULL) {
  1241. done++;
  1242. break;
  1243. }
  1244. msleep(2000);
  1245. } while (max_wait_time--);
  1246. return done;
  1247. }
  1248. /**
  1249. * qla4xxx_wait_for_hba_online - waits for HBA to come online
  1250. * @ha: Pointer to host adapter structure
  1251. **/
  1252. static int qla4xxx_wait_for_hba_online(struct scsi_qla_host *ha)
  1253. {
  1254. unsigned long wait_online;
  1255. wait_online = jiffies + (30 * HZ);
  1256. while (time_before(jiffies, wait_online)) {
  1257. if (adapter_up(ha))
  1258. return QLA_SUCCESS;
  1259. else if (ha->retry_reset_ha_cnt == 0)
  1260. return QLA_ERROR;
  1261. msleep(2000);
  1262. }
  1263. return QLA_ERROR;
  1264. }
  1265. /**
  1266. * qla4xxx_eh_wait_for_active_target_commands - wait for active cmds to finish.
  1267. * @ha: pointer to to HBA
  1268. * @t: target id
  1269. * @l: lun id
  1270. *
  1271. * This function waits for all outstanding commands to a lun to complete. It
  1272. * returns 0 if all pending commands are returned and 1 otherwise.
  1273. **/
  1274. static int qla4xxx_eh_wait_for_active_target_commands(struct scsi_qla_host *ha,
  1275. int t, int l)
  1276. {
  1277. int cnt;
  1278. int status = 0;
  1279. struct scsi_cmnd *cmd;
  1280. /*
  1281. * Waiting for all commands for the designated target in the active
  1282. * array
  1283. */
  1284. for (cnt = 0; cnt < ha->host->can_queue; cnt++) {
  1285. cmd = scsi_host_find_tag(ha->host, cnt);
  1286. if (cmd && cmd->device->id == t && cmd->device->lun == l) {
  1287. if (!qla4xxx_eh_wait_on_command(ha, cmd)) {
  1288. status++;
  1289. break;
  1290. }
  1291. }
  1292. }
  1293. return status;
  1294. }
  1295. /**
  1296. * qla4xxx_eh_device_reset - callback for target reset.
  1297. * @cmd: Pointer to Linux's SCSI command structure
  1298. *
  1299. * This routine is called by the Linux OS to reset all luns on the
  1300. * specified target.
  1301. **/
  1302. static int qla4xxx_eh_device_reset(struct scsi_cmnd *cmd)
  1303. {
  1304. struct scsi_qla_host *ha = to_qla_host(cmd->device->host);
  1305. struct ddb_entry *ddb_entry = cmd->device->hostdata;
  1306. struct srb *sp;
  1307. int ret = FAILED, stat;
  1308. sp = (struct srb *) cmd->SCp.ptr;
  1309. if (!sp || !ddb_entry)
  1310. return ret;
  1311. dev_info(&ha->pdev->dev,
  1312. "scsi%ld:%d:%d:%d: DEVICE RESET ISSUED.\n", ha->host_no,
  1313. cmd->device->channel, cmd->device->id, cmd->device->lun);
  1314. DEBUG2(printk(KERN_INFO
  1315. "scsi%ld: DEVICE_RESET cmd=%p jiffies = 0x%lx, to=%x,"
  1316. "dpc_flags=%lx, status=%x allowed=%d\n", ha->host_no,
  1317. cmd, jiffies, cmd->timeout_per_command / HZ,
  1318. ha->dpc_flags, cmd->result, cmd->allowed));
  1319. /* FIXME: wait for hba to go online */
  1320. stat = qla4xxx_reset_lun(ha, ddb_entry, cmd->device->lun);
  1321. if (stat != QLA_SUCCESS) {
  1322. dev_info(&ha->pdev->dev, "DEVICE RESET FAILED. %d\n", stat);
  1323. goto eh_dev_reset_done;
  1324. }
  1325. /* Send marker. */
  1326. ha->marker_needed = 1;
  1327. /*
  1328. * If we are coming down the EH path, wait for all commands to complete
  1329. * for the device.
  1330. */
  1331. if (cmd->device->host->shost_state == SHOST_RECOVERY) {
  1332. if (qla4xxx_eh_wait_for_active_target_commands(ha,
  1333. cmd->device->id,
  1334. cmd->device->lun)){
  1335. dev_info(&ha->pdev->dev,
  1336. "DEVICE RESET FAILED - waiting for "
  1337. "commands.\n");
  1338. goto eh_dev_reset_done;
  1339. }
  1340. }
  1341. dev_info(&ha->pdev->dev,
  1342. "scsi(%ld:%d:%d:%d): DEVICE RESET SUCCEEDED.\n",
  1343. ha->host_no, cmd->device->channel, cmd->device->id,
  1344. cmd->device->lun);
  1345. ret = SUCCESS;
  1346. eh_dev_reset_done:
  1347. return ret;
  1348. }
  1349. /**
  1350. * qla4xxx_eh_host_reset - kernel callback
  1351. * @cmd: Pointer to Linux's SCSI command structure
  1352. *
  1353. * This routine is invoked by the Linux kernel to perform fatal error
  1354. * recovery on the specified adapter.
  1355. **/
  1356. static int qla4xxx_eh_host_reset(struct scsi_cmnd *cmd)
  1357. {
  1358. int return_status = FAILED;
  1359. struct scsi_qla_host *ha;
  1360. ha = (struct scsi_qla_host *) cmd->device->host->hostdata;
  1361. dev_info(&ha->pdev->dev,
  1362. "scsi(%ld:%d:%d:%d): ADAPTER RESET ISSUED.\n", ha->host_no,
  1363. cmd->device->channel, cmd->device->id, cmd->device->lun);
  1364. if (qla4xxx_wait_for_hba_online(ha) != QLA_SUCCESS) {
  1365. DEBUG2(printk("scsi%ld:%d: %s: Unable to reset host. Adapter "
  1366. "DEAD.\n", ha->host_no, cmd->device->channel,
  1367. __func__));
  1368. return FAILED;
  1369. }
  1370. if (qla4xxx_recover_adapter(ha, PRESERVE_DDB_LIST) == QLA_SUCCESS) {
  1371. return_status = SUCCESS;
  1372. }
  1373. dev_info(&ha->pdev->dev, "HOST RESET %s.\n",
  1374. return_status == FAILED ? "FAILED" : "SUCCEDED");
  1375. return return_status;
  1376. }
  1377. static struct pci_device_id qla4xxx_pci_tbl[] = {
  1378. {
  1379. .vendor = PCI_VENDOR_ID_QLOGIC,
  1380. .device = PCI_DEVICE_ID_QLOGIC_ISP4010,
  1381. .subvendor = PCI_ANY_ID,
  1382. .subdevice = PCI_ANY_ID,
  1383. },
  1384. {
  1385. .vendor = PCI_VENDOR_ID_QLOGIC,
  1386. .device = PCI_DEVICE_ID_QLOGIC_ISP4022,
  1387. .subvendor = PCI_ANY_ID,
  1388. .subdevice = PCI_ANY_ID,
  1389. },
  1390. {
  1391. .vendor = PCI_VENDOR_ID_QLOGIC,
  1392. .device = PCI_DEVICE_ID_QLOGIC_ISP4032,
  1393. .subvendor = PCI_ANY_ID,
  1394. .subdevice = PCI_ANY_ID,
  1395. },
  1396. {0, 0},
  1397. };
  1398. MODULE_DEVICE_TABLE(pci, qla4xxx_pci_tbl);
  1399. static struct pci_driver qla4xxx_pci_driver = {
  1400. .name = DRIVER_NAME,
  1401. .id_table = qla4xxx_pci_tbl,
  1402. .probe = qla4xxx_probe_adapter,
  1403. .remove = qla4xxx_remove_adapter,
  1404. };
  1405. static int __init qla4xxx_module_init(void)
  1406. {
  1407. int ret;
  1408. /* Allocate cache for SRBs. */
  1409. srb_cachep = kmem_cache_create("qla4xxx_srbs", sizeof(struct srb), 0,
  1410. SLAB_HWCACHE_ALIGN, NULL);
  1411. if (srb_cachep == NULL) {
  1412. printk(KERN_ERR
  1413. "%s: Unable to allocate SRB cache..."
  1414. "Failing load!\n", DRIVER_NAME);
  1415. ret = -ENOMEM;
  1416. goto no_srp_cache;
  1417. }
  1418. /* Derive version string. */
  1419. strcpy(qla4xxx_version_str, QLA4XXX_DRIVER_VERSION);
  1420. if (ql4xextended_error_logging)
  1421. strcat(qla4xxx_version_str, "-debug");
  1422. qla4xxx_scsi_transport =
  1423. iscsi_register_transport(&qla4xxx_iscsi_transport);
  1424. if (!qla4xxx_scsi_transport){
  1425. ret = -ENODEV;
  1426. goto release_srb_cache;
  1427. }
  1428. ret = pci_register_driver(&qla4xxx_pci_driver);
  1429. if (ret)
  1430. goto unregister_transport;
  1431. printk(KERN_INFO "QLogic iSCSI HBA Driver\n");
  1432. return 0;
  1433. unregister_transport:
  1434. iscsi_unregister_transport(&qla4xxx_iscsi_transport);
  1435. release_srb_cache:
  1436. kmem_cache_destroy(srb_cachep);
  1437. no_srp_cache:
  1438. return ret;
  1439. }
  1440. static void __exit qla4xxx_module_exit(void)
  1441. {
  1442. ql4_mod_unload = 1;
  1443. pci_unregister_driver(&qla4xxx_pci_driver);
  1444. iscsi_unregister_transport(&qla4xxx_iscsi_transport);
  1445. kmem_cache_destroy(srb_cachep);
  1446. }
  1447. module_init(qla4xxx_module_init);
  1448. module_exit(qla4xxx_module_exit);
  1449. MODULE_AUTHOR("QLogic Corporation");
  1450. MODULE_DESCRIPTION("QLogic iSCSI HBA Driver");
  1451. MODULE_LICENSE("GPL");
  1452. MODULE_VERSION(QLA4XXX_DRIVER_VERSION);