bfad.c 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185
  1. /*
  2. * Copyright (c) 2005-2009 Brocade Communications Systems, Inc.
  3. * All rights reserved
  4. * www.brocade.com
  5. *
  6. * Linux driver for Brocade Fibre Channel Host Bus Adapter.
  7. *
  8. * This program is free software; you can redistribute it and/or modify it
  9. * under the terms of the GNU General Public License (GPL) Version 2 as
  10. * published by the Free Software Foundation
  11. *
  12. * This program is distributed in the hope that it will be useful, but
  13. * WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * General Public License for more details.
  16. */
  17. /**
  18. * bfad.c Linux driver PCI interface module.
  19. */
  20. #include <linux/module.h>
  21. #include "bfad_drv.h"
  22. #include "bfad_im.h"
  23. #include "bfad_tm.h"
  24. #include "bfad_ipfc.h"
  25. #include "bfad_trcmod.h"
  26. #include <fcb/bfa_fcb_vf.h>
  27. #include <fcb/bfa_fcb_rport.h>
  28. #include <fcb/bfa_fcb_port.h>
  29. #include <fcb/bfa_fcb.h>
  30. BFA_TRC_FILE(LDRV, BFAD);
  31. static DEFINE_MUTEX(bfad_mutex);
  32. LIST_HEAD(bfad_list);
  33. static int bfad_inst;
  34. int bfad_supported_fc4s;
  35. static char *host_name;
  36. static char *os_name;
  37. static char *os_patch;
  38. static int num_rports;
  39. static int num_ios;
  40. static int num_tms;
  41. static int num_fcxps;
  42. static int num_ufbufs;
  43. static int reqq_size;
  44. static int rspq_size;
  45. static int num_sgpgs;
  46. static int rport_del_timeout = BFA_FCS_RPORT_DEF_DEL_TIMEOUT;
  47. static int bfa_io_max_sge = BFAD_IO_MAX_SGE;
  48. static int log_level = BFA_LOG_WARNING;
  49. static int ioc_auto_recover = BFA_TRUE;
  50. static int ipfc_enable = BFA_FALSE;
  51. static int ipfc_mtu = -1;
  52. static int fdmi_enable = BFA_TRUE;
  53. int bfa_lun_queue_depth = BFAD_LUN_QUEUE_DEPTH;
  54. int bfa_linkup_delay = -1;
  55. module_param(os_name, charp, S_IRUGO | S_IWUSR);
  56. module_param(os_patch, charp, S_IRUGO | S_IWUSR);
  57. module_param(host_name, charp, S_IRUGO | S_IWUSR);
  58. module_param(num_rports, int, S_IRUGO | S_IWUSR);
  59. module_param(num_ios, int, S_IRUGO | S_IWUSR);
  60. module_param(num_tms, int, S_IRUGO | S_IWUSR);
  61. module_param(num_fcxps, int, S_IRUGO | S_IWUSR);
  62. module_param(num_ufbufs, int, S_IRUGO | S_IWUSR);
  63. module_param(reqq_size, int, S_IRUGO | S_IWUSR);
  64. module_param(rspq_size, int, S_IRUGO | S_IWUSR);
  65. module_param(num_sgpgs, int, S_IRUGO | S_IWUSR);
  66. module_param(rport_del_timeout, int, S_IRUGO | S_IWUSR);
  67. module_param(bfa_lun_queue_depth, int, S_IRUGO | S_IWUSR);
  68. module_param(bfa_io_max_sge, int, S_IRUGO | S_IWUSR);
  69. module_param(log_level, int, S_IRUGO | S_IWUSR);
  70. module_param(ioc_auto_recover, int, S_IRUGO | S_IWUSR);
  71. module_param(ipfc_enable, int, S_IRUGO | S_IWUSR);
  72. module_param(ipfc_mtu, int, S_IRUGO | S_IWUSR);
  73. module_param(fdmi_enable, int, S_IRUGO | S_IWUSR);
  74. module_param(bfa_linkup_delay, int, S_IRUGO | S_IWUSR);
  75. /*
  76. * Stores the module parm num_sgpgs value;
  77. * used to reset for bfad next instance.
  78. */
  79. static int num_sgpgs_parm;
  80. static bfa_status_t
  81. bfad_fc4_probe(struct bfad_s *bfad)
  82. {
  83. int rc;
  84. rc = bfad_im_probe(bfad);
  85. if (rc != BFA_STATUS_OK)
  86. goto ext;
  87. bfad_tm_probe(bfad);
  88. if (ipfc_enable)
  89. bfad_ipfc_probe(bfad);
  90. ext:
  91. return rc;
  92. }
  93. static void
  94. bfad_fc4_probe_undo(struct bfad_s *bfad)
  95. {
  96. bfad_im_probe_undo(bfad);
  97. bfad_tm_probe_undo(bfad);
  98. if (ipfc_enable)
  99. bfad_ipfc_probe_undo(bfad);
  100. }
  101. static void
  102. bfad_fc4_probe_post(struct bfad_s *bfad)
  103. {
  104. if (bfad->im)
  105. bfad_im_probe_post(bfad->im);
  106. bfad_tm_probe_post(bfad);
  107. if (ipfc_enable)
  108. bfad_ipfc_probe_post(bfad);
  109. }
  110. static bfa_status_t
  111. bfad_fc4_port_new(struct bfad_s *bfad, struct bfad_port_s *port, int roles)
  112. {
  113. int rc = BFA_STATUS_FAILED;
  114. if (roles & BFA_PORT_ROLE_FCP_IM)
  115. rc = bfad_im_port_new(bfad, port);
  116. if (rc != BFA_STATUS_OK)
  117. goto ext;
  118. if (roles & BFA_PORT_ROLE_FCP_TM)
  119. rc = bfad_tm_port_new(bfad, port);
  120. if (rc != BFA_STATUS_OK)
  121. goto ext;
  122. if ((roles & BFA_PORT_ROLE_FCP_IPFC) && ipfc_enable)
  123. rc = bfad_ipfc_port_new(bfad, port, port->pvb_type);
  124. ext:
  125. return rc;
  126. }
  127. static void
  128. bfad_fc4_port_delete(struct bfad_s *bfad, struct bfad_port_s *port, int roles)
  129. {
  130. if (roles & BFA_PORT_ROLE_FCP_IM)
  131. bfad_im_port_delete(bfad, port);
  132. if (roles & BFA_PORT_ROLE_FCP_TM)
  133. bfad_tm_port_delete(bfad, port);
  134. if ((roles & BFA_PORT_ROLE_FCP_IPFC) && ipfc_enable)
  135. bfad_ipfc_port_delete(bfad, port);
  136. }
  137. /**
  138. * BFA callbacks
  139. */
  140. void
  141. bfad_hcb_comp(void *arg, bfa_status_t status)
  142. {
  143. struct bfad_hal_comp *fcomp = (struct bfad_hal_comp *)arg;
  144. fcomp->status = status;
  145. complete(&fcomp->comp);
  146. }
  147. /**
  148. * bfa_init callback
  149. */
  150. void
  151. bfa_cb_init(void *drv, bfa_status_t init_status)
  152. {
  153. struct bfad_s *bfad = drv;
  154. if (init_status == BFA_STATUS_OK)
  155. bfad->bfad_flags |= BFAD_HAL_INIT_DONE;
  156. complete(&bfad->comp);
  157. }
  158. /**
  159. * BFA_FCS callbacks
  160. */
  161. static struct bfad_port_s *
  162. bfad_get_drv_port(struct bfad_s *bfad, struct bfad_vf_s *vf_drv,
  163. struct bfad_vport_s *vp_drv)
  164. {
  165. return (vp_drv) ? (&(vp_drv)->drv_port)
  166. : ((vf_drv) ? (&(vf_drv)->base_port) : (&(bfad)->pport));
  167. }
  168. struct bfad_port_s *
  169. bfa_fcb_port_new(struct bfad_s *bfad, struct bfa_fcs_port_s *port,
  170. enum bfa_port_role roles, struct bfad_vf_s *vf_drv,
  171. struct bfad_vport_s *vp_drv)
  172. {
  173. bfa_status_t rc;
  174. struct bfad_port_s *port_drv;
  175. if (!vp_drv && !vf_drv) {
  176. port_drv = &bfad->pport;
  177. port_drv->pvb_type = BFAD_PORT_PHYS_BASE;
  178. } else if (!vp_drv && vf_drv) {
  179. port_drv = &vf_drv->base_port;
  180. port_drv->pvb_type = BFAD_PORT_VF_BASE;
  181. } else if (vp_drv && !vf_drv) {
  182. port_drv = &vp_drv->drv_port;
  183. port_drv->pvb_type = BFAD_PORT_PHYS_VPORT;
  184. } else {
  185. port_drv = &vp_drv->drv_port;
  186. port_drv->pvb_type = BFAD_PORT_VF_VPORT;
  187. }
  188. port_drv->fcs_port = port;
  189. port_drv->roles = roles;
  190. rc = bfad_fc4_port_new(bfad, port_drv, roles);
  191. if (rc != BFA_STATUS_OK) {
  192. bfad_fc4_port_delete(bfad, port_drv, roles);
  193. port_drv = NULL;
  194. }
  195. return port_drv;
  196. }
  197. void
  198. bfa_fcb_port_delete(struct bfad_s *bfad, enum bfa_port_role roles,
  199. struct bfad_vf_s *vf_drv, struct bfad_vport_s *vp_drv)
  200. {
  201. struct bfad_port_s *port_drv;
  202. /*
  203. * this will be only called from rmmod context
  204. */
  205. if (vp_drv && !vp_drv->comp_del) {
  206. port_drv = bfad_get_drv_port(bfad, vf_drv, vp_drv);
  207. bfa_trc(bfad, roles);
  208. bfad_fc4_port_delete(bfad, port_drv, roles);
  209. }
  210. }
  211. void
  212. bfa_fcb_port_online(struct bfad_s *bfad, enum bfa_port_role roles,
  213. struct bfad_vf_s *vf_drv, struct bfad_vport_s *vp_drv)
  214. {
  215. struct bfad_port_s *port_drv = bfad_get_drv_port(bfad, vf_drv, vp_drv);
  216. if (roles & BFA_PORT_ROLE_FCP_IM)
  217. bfad_im_port_online(bfad, port_drv);
  218. if (roles & BFA_PORT_ROLE_FCP_TM)
  219. bfad_tm_port_online(bfad, port_drv);
  220. if ((roles & BFA_PORT_ROLE_FCP_IPFC) && ipfc_enable)
  221. bfad_ipfc_port_online(bfad, port_drv);
  222. bfad->bfad_flags |= BFAD_PORT_ONLINE;
  223. }
  224. void
  225. bfa_fcb_port_offline(struct bfad_s *bfad, enum bfa_port_role roles,
  226. struct bfad_vf_s *vf_drv, struct bfad_vport_s *vp_drv)
  227. {
  228. struct bfad_port_s *port_drv = bfad_get_drv_port(bfad, vf_drv, vp_drv);
  229. if (roles & BFA_PORT_ROLE_FCP_IM)
  230. bfad_im_port_offline(bfad, port_drv);
  231. if (roles & BFA_PORT_ROLE_FCP_TM)
  232. bfad_tm_port_offline(bfad, port_drv);
  233. if ((roles & BFA_PORT_ROLE_FCP_IPFC) && ipfc_enable)
  234. bfad_ipfc_port_offline(bfad, port_drv);
  235. }
  236. void
  237. bfa_fcb_vport_delete(struct bfad_vport_s *vport_drv)
  238. {
  239. if (vport_drv->comp_del) {
  240. complete(vport_drv->comp_del);
  241. return;
  242. }
  243. kfree(vport_drv);
  244. }
  245. /**
  246. * FCS RPORT alloc callback, after successful PLOGI by FCS
  247. */
  248. bfa_status_t
  249. bfa_fcb_rport_alloc(struct bfad_s *bfad, struct bfa_fcs_rport_s **rport,
  250. struct bfad_rport_s **rport_drv)
  251. {
  252. bfa_status_t rc = BFA_STATUS_OK;
  253. *rport_drv = kzalloc(sizeof(struct bfad_rport_s), GFP_ATOMIC);
  254. if (*rport_drv == NULL) {
  255. rc = BFA_STATUS_ENOMEM;
  256. goto ext;
  257. }
  258. *rport = &(*rport_drv)->fcs_rport;
  259. ext:
  260. return rc;
  261. }
  262. void
  263. bfad_hal_mem_release(struct bfad_s *bfad)
  264. {
  265. int i;
  266. struct bfa_meminfo_s *hal_meminfo = &bfad->meminfo;
  267. struct bfa_mem_elem_s *meminfo_elem;
  268. for (i = 0; i < BFA_MEM_TYPE_MAX; i++) {
  269. meminfo_elem = &hal_meminfo->meminfo[i];
  270. if (meminfo_elem->kva != NULL) {
  271. switch (meminfo_elem->mem_type) {
  272. case BFA_MEM_TYPE_KVA:
  273. vfree(meminfo_elem->kva);
  274. break;
  275. case BFA_MEM_TYPE_DMA:
  276. dma_free_coherent(&bfad->pcidev->dev,
  277. meminfo_elem->mem_len,
  278. meminfo_elem->kva,
  279. (dma_addr_t) meminfo_elem->dma);
  280. break;
  281. default:
  282. bfa_assert(0);
  283. break;
  284. }
  285. }
  286. }
  287. memset(hal_meminfo, 0, sizeof(struct bfa_meminfo_s));
  288. }
  289. void
  290. bfad_update_hal_cfg(struct bfa_iocfc_cfg_s *bfa_cfg)
  291. {
  292. if (num_rports > 0)
  293. bfa_cfg->fwcfg.num_rports = num_rports;
  294. if (num_ios > 0)
  295. bfa_cfg->fwcfg.num_ioim_reqs = num_ios;
  296. if (num_tms > 0)
  297. bfa_cfg->fwcfg.num_tskim_reqs = num_tms;
  298. if (num_fcxps > 0)
  299. bfa_cfg->fwcfg.num_fcxp_reqs = num_fcxps;
  300. if (num_ufbufs > 0)
  301. bfa_cfg->fwcfg.num_uf_bufs = num_ufbufs;
  302. if (reqq_size > 0)
  303. bfa_cfg->drvcfg.num_reqq_elems = reqq_size;
  304. if (rspq_size > 0)
  305. bfa_cfg->drvcfg.num_rspq_elems = rspq_size;
  306. if (num_sgpgs > 0)
  307. bfa_cfg->drvcfg.num_sgpgs = num_sgpgs;
  308. /*
  309. * populate the hal values back to the driver for sysfs use.
  310. * otherwise, the default values will be shown as 0 in sysfs
  311. */
  312. num_rports = bfa_cfg->fwcfg.num_rports;
  313. num_ios = bfa_cfg->fwcfg.num_ioim_reqs;
  314. num_tms = bfa_cfg->fwcfg.num_tskim_reqs;
  315. num_fcxps = bfa_cfg->fwcfg.num_fcxp_reqs;
  316. num_ufbufs = bfa_cfg->fwcfg.num_uf_bufs;
  317. reqq_size = bfa_cfg->drvcfg.num_reqq_elems;
  318. rspq_size = bfa_cfg->drvcfg.num_rspq_elems;
  319. num_sgpgs = bfa_cfg->drvcfg.num_sgpgs;
  320. }
  321. bfa_status_t
  322. bfad_hal_mem_alloc(struct bfad_s *bfad)
  323. {
  324. struct bfa_meminfo_s *hal_meminfo = &bfad->meminfo;
  325. struct bfa_mem_elem_s *meminfo_elem;
  326. bfa_status_t rc = BFA_STATUS_OK;
  327. dma_addr_t phys_addr;
  328. int retry_count = 0;
  329. int reset_value = 1;
  330. int min_num_sgpgs = 512;
  331. void *kva;
  332. int i;
  333. bfa_cfg_get_default(&bfad->ioc_cfg);
  334. retry:
  335. bfad_update_hal_cfg(&bfad->ioc_cfg);
  336. bfad->cfg_data.ioc_queue_depth = bfad->ioc_cfg.fwcfg.num_ioim_reqs;
  337. bfa_cfg_get_meminfo(&bfad->ioc_cfg, hal_meminfo);
  338. for (i = 0; i < BFA_MEM_TYPE_MAX; i++) {
  339. meminfo_elem = &hal_meminfo->meminfo[i];
  340. switch (meminfo_elem->mem_type) {
  341. case BFA_MEM_TYPE_KVA:
  342. kva = vmalloc(meminfo_elem->mem_len);
  343. if (kva == NULL) {
  344. bfad_hal_mem_release(bfad);
  345. rc = BFA_STATUS_ENOMEM;
  346. goto ext;
  347. }
  348. memset(kva, 0, meminfo_elem->mem_len);
  349. meminfo_elem->kva = kva;
  350. break;
  351. case BFA_MEM_TYPE_DMA:
  352. kva = dma_alloc_coherent(&bfad->pcidev->dev,
  353. meminfo_elem->mem_len,
  354. &phys_addr, GFP_KERNEL);
  355. if (kva == NULL) {
  356. bfad_hal_mem_release(bfad);
  357. /*
  358. * If we cannot allocate with default
  359. * num_sgpages try with half the value.
  360. */
  361. if (num_sgpgs > min_num_sgpgs) {
  362. printk(KERN_INFO "bfad[%d]: memory"
  363. " allocation failed with"
  364. " num_sgpgs: %d\n",
  365. bfad->inst_no, num_sgpgs);
  366. nextLowerInt(&num_sgpgs);
  367. printk(KERN_INFO "bfad[%d]: trying to"
  368. " allocate memory with"
  369. " num_sgpgs: %d\n",
  370. bfad->inst_no, num_sgpgs);
  371. retry_count++;
  372. goto retry;
  373. } else {
  374. if (num_sgpgs_parm > 0)
  375. num_sgpgs = num_sgpgs_parm;
  376. else {
  377. reset_value =
  378. (1 << retry_count);
  379. num_sgpgs *= reset_value;
  380. }
  381. rc = BFA_STATUS_ENOMEM;
  382. goto ext;
  383. }
  384. }
  385. if (num_sgpgs_parm > 0)
  386. num_sgpgs = num_sgpgs_parm;
  387. else {
  388. reset_value = (1 << retry_count);
  389. num_sgpgs *= reset_value;
  390. }
  391. memset(kva, 0, meminfo_elem->mem_len);
  392. meminfo_elem->kva = kva;
  393. meminfo_elem->dma = phys_addr;
  394. break;
  395. default:
  396. break;
  397. }
  398. }
  399. ext:
  400. return rc;
  401. }
  402. /**
  403. * Create a vport under a vf.
  404. */
  405. bfa_status_t
  406. bfad_vport_create(struct bfad_s *bfad, u16 vf_id,
  407. struct bfa_port_cfg_s *port_cfg)
  408. {
  409. struct bfad_vport_s *vport;
  410. int rc = BFA_STATUS_OK;
  411. unsigned long flags;
  412. struct completion fcomp;
  413. vport = kzalloc(sizeof(struct bfad_vport_s), GFP_KERNEL);
  414. if (!vport) {
  415. rc = BFA_STATUS_ENOMEM;
  416. goto ext;
  417. }
  418. vport->drv_port.bfad = bfad;
  419. spin_lock_irqsave(&bfad->bfad_lock, flags);
  420. rc = bfa_fcs_vport_create(&vport->fcs_vport, &bfad->bfa_fcs, vf_id,
  421. port_cfg, vport);
  422. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  423. if (rc != BFA_STATUS_OK)
  424. goto ext_free_vport;
  425. if (port_cfg->roles & BFA_PORT_ROLE_FCP_IM) {
  426. rc = bfad_im_scsi_host_alloc(bfad, vport->drv_port.im_port);
  427. if (rc != BFA_STATUS_OK)
  428. goto ext_free_fcs_vport;
  429. }
  430. spin_lock_irqsave(&bfad->bfad_lock, flags);
  431. bfa_fcs_vport_start(&vport->fcs_vport);
  432. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  433. return BFA_STATUS_OK;
  434. ext_free_fcs_vport:
  435. spin_lock_irqsave(&bfad->bfad_lock, flags);
  436. vport->comp_del = &fcomp;
  437. init_completion(vport->comp_del);
  438. bfa_fcs_vport_delete(&vport->fcs_vport);
  439. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  440. wait_for_completion(vport->comp_del);
  441. ext_free_vport:
  442. kfree(vport);
  443. ext:
  444. return rc;
  445. }
  446. /**
  447. * Create a vf and its base vport implicitely.
  448. */
  449. bfa_status_t
  450. bfad_vf_create(struct bfad_s *bfad, u16 vf_id,
  451. struct bfa_port_cfg_s *port_cfg)
  452. {
  453. struct bfad_vf_s *vf;
  454. int rc = BFA_STATUS_OK;
  455. vf = kzalloc(sizeof(struct bfad_vf_s), GFP_KERNEL);
  456. if (!vf) {
  457. rc = BFA_STATUS_FAILED;
  458. goto ext;
  459. }
  460. rc = bfa_fcs_vf_create(&vf->fcs_vf, &bfad->bfa_fcs, vf_id, port_cfg,
  461. vf);
  462. if (rc != BFA_STATUS_OK)
  463. kfree(vf);
  464. ext:
  465. return rc;
  466. }
  467. void
  468. bfad_bfa_tmo(unsigned long data)
  469. {
  470. struct bfad_s *bfad = (struct bfad_s *)data;
  471. unsigned long flags;
  472. struct list_head doneq;
  473. spin_lock_irqsave(&bfad->bfad_lock, flags);
  474. bfa_timer_tick(&bfad->bfa);
  475. bfa_comp_deq(&bfad->bfa, &doneq);
  476. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  477. if (!list_empty(&doneq)) {
  478. bfa_comp_process(&bfad->bfa, &doneq);
  479. spin_lock_irqsave(&bfad->bfad_lock, flags);
  480. bfa_comp_free(&bfad->bfa, &doneq);
  481. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  482. }
  483. mod_timer(&bfad->hal_tmo, jiffies + msecs_to_jiffies(BFA_TIMER_FREQ));
  484. }
  485. void
  486. bfad_init_timer(struct bfad_s *bfad)
  487. {
  488. init_timer(&bfad->hal_tmo);
  489. bfad->hal_tmo.function = bfad_bfa_tmo;
  490. bfad->hal_tmo.data = (unsigned long)bfad;
  491. mod_timer(&bfad->hal_tmo, jiffies + msecs_to_jiffies(BFA_TIMER_FREQ));
  492. }
  493. int
  494. bfad_pci_init(struct pci_dev *pdev, struct bfad_s *bfad)
  495. {
  496. unsigned long bar0_len;
  497. int rc = -ENODEV;
  498. if (pci_enable_device(pdev)) {
  499. BFA_PRINTF(BFA_ERR, "pci_enable_device fail %p\n", pdev);
  500. goto out;
  501. }
  502. if (pci_request_regions(pdev, BFAD_DRIVER_NAME))
  503. goto out_disable_device;
  504. pci_set_master(pdev);
  505. if (pci_set_dma_mask(pdev, DMA_BIT_MASK(64)) != 0)
  506. if (pci_set_dma_mask(pdev, DMA_BIT_MASK(32)) != 0) {
  507. BFA_PRINTF(BFA_ERR, "pci_set_dma_mask fail %p\n", pdev);
  508. goto out_release_region;
  509. }
  510. bfad->pci_bar0_map = pci_resource_start(pdev, 0);
  511. bar0_len = pci_resource_len(pdev, 0);
  512. bfad->pci_bar0_kva = ioremap(bfad->pci_bar0_map, bar0_len);
  513. if (bfad->pci_bar0_kva == NULL) {
  514. BFA_PRINTF(BFA_ERR, "Fail to map bar0\n");
  515. goto out_release_region;
  516. }
  517. bfad->hal_pcidev.pci_slot = PCI_SLOT(pdev->devfn);
  518. bfad->hal_pcidev.pci_func = PCI_FUNC(pdev->devfn);
  519. bfad->hal_pcidev.pci_bar_kva = bfad->pci_bar0_kva;
  520. bfad->hal_pcidev.device_id = pdev->device;
  521. bfad->pci_name = pci_name(pdev);
  522. bfad->pci_attr.vendor_id = pdev->vendor;
  523. bfad->pci_attr.device_id = pdev->device;
  524. bfad->pci_attr.ssid = pdev->subsystem_device;
  525. bfad->pci_attr.ssvid = pdev->subsystem_vendor;
  526. bfad->pci_attr.pcifn = PCI_FUNC(pdev->devfn);
  527. bfad->pcidev = pdev;
  528. return 0;
  529. out_release_region:
  530. pci_release_regions(pdev);
  531. out_disable_device:
  532. pci_disable_device(pdev);
  533. out:
  534. return rc;
  535. }
  536. void
  537. bfad_pci_uninit(struct pci_dev *pdev, struct bfad_s *bfad)
  538. {
  539. #if defined(__ia64__)
  540. pci_iounmap(pdev, bfad->pci_bar0_kva);
  541. #else
  542. iounmap(bfad->pci_bar0_kva);
  543. #endif
  544. pci_release_regions(pdev);
  545. pci_disable_device(pdev);
  546. pci_set_drvdata(pdev, NULL);
  547. }
  548. void
  549. bfad_fcs_port_cfg(struct bfad_s *bfad)
  550. {
  551. struct bfa_port_cfg_s port_cfg;
  552. struct bfa_pport_attr_s attr;
  553. char symname[BFA_SYMNAME_MAXLEN];
  554. sprintf(symname, "%s-%d", BFAD_DRIVER_NAME, bfad->inst_no);
  555. memcpy(port_cfg.sym_name.symname, symname, strlen(symname));
  556. bfa_pport_get_attr(&bfad->bfa, &attr);
  557. port_cfg.nwwn = attr.nwwn;
  558. port_cfg.pwwn = attr.pwwn;
  559. bfa_fcs_cfg_base_port(&bfad->bfa_fcs, &port_cfg);
  560. }
  561. bfa_status_t
  562. bfad_drv_init(struct bfad_s *bfad)
  563. {
  564. bfa_status_t rc;
  565. unsigned long flags;
  566. struct bfa_fcs_driver_info_s driver_info;
  567. int i;
  568. bfad->cfg_data.rport_del_timeout = rport_del_timeout;
  569. bfad->cfg_data.lun_queue_depth = bfa_lun_queue_depth;
  570. bfad->cfg_data.io_max_sge = bfa_io_max_sge;
  571. bfad->cfg_data.binding_method = FCP_PWWN_BINDING;
  572. rc = bfad_hal_mem_alloc(bfad);
  573. if (rc != BFA_STATUS_OK) {
  574. printk(KERN_WARNING "bfad%d bfad_hal_mem_alloc failure\n",
  575. bfad->inst_no);
  576. printk(KERN_WARNING
  577. "Not enough memory to attach all Brocade HBA ports,"
  578. " System may need more memory.\n");
  579. goto out_hal_mem_alloc_failure;
  580. }
  581. bfa_init_log(&bfad->bfa, bfad->logmod);
  582. bfa_init_trc(&bfad->bfa, bfad->trcmod);
  583. bfa_init_aen(&bfad->bfa, bfad->aen);
  584. INIT_LIST_HEAD(&bfad->file_q);
  585. INIT_LIST_HEAD(&bfad->file_free_q);
  586. for (i = 0; i < BFAD_AEN_MAX_APPS; i++) {
  587. bfa_q_qe_init(&bfad->file_buf[i].qe);
  588. list_add_tail(&bfad->file_buf[i].qe, &bfad->file_free_q);
  589. }
  590. bfa_init_plog(&bfad->bfa, &bfad->plog_buf);
  591. bfa_plog_init(&bfad->plog_buf);
  592. bfa_plog_str(&bfad->plog_buf, BFA_PL_MID_DRVR, BFA_PL_EID_DRIVER_START,
  593. 0, "Driver Attach");
  594. bfa_attach(&bfad->bfa, bfad, &bfad->ioc_cfg, &bfad->meminfo,
  595. &bfad->hal_pcidev);
  596. init_completion(&bfad->comp);
  597. /*
  598. * Enable Interrupt and wait bfa_init completion
  599. */
  600. if (bfad_setup_intr(bfad)) {
  601. printk(KERN_WARNING "bfad%d: bfad_setup_intr failed\n",
  602. bfad->inst_no);
  603. goto out_setup_intr_failure;
  604. }
  605. spin_lock_irqsave(&bfad->bfad_lock, flags);
  606. bfa_init(&bfad->bfa);
  607. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  608. /*
  609. * Set up interrupt handler for each vectors
  610. */
  611. if ((bfad->bfad_flags & BFAD_MSIX_ON)
  612. && bfad_install_msix_handler(bfad)) {
  613. printk(KERN_WARNING "%s: install_msix failed, bfad%d\n",
  614. __func__, bfad->inst_no);
  615. }
  616. bfad_init_timer(bfad);
  617. wait_for_completion(&bfad->comp);
  618. memset(&driver_info, 0, sizeof(driver_info));
  619. strncpy(driver_info.version, BFAD_DRIVER_VERSION,
  620. sizeof(driver_info.version) - 1);
  621. if (host_name)
  622. strncpy(driver_info.host_machine_name, host_name,
  623. sizeof(driver_info.host_machine_name) - 1);
  624. if (os_name)
  625. strncpy(driver_info.host_os_name, os_name,
  626. sizeof(driver_info.host_os_name) - 1);
  627. if (os_patch)
  628. strncpy(driver_info.host_os_patch, os_patch,
  629. sizeof(driver_info.host_os_patch) - 1);
  630. strncpy(driver_info.os_device_name, bfad->pci_name,
  631. sizeof(driver_info.os_device_name - 1));
  632. /*
  633. * FCS INIT
  634. */
  635. spin_lock_irqsave(&bfad->bfad_lock, flags);
  636. bfa_fcs_log_init(&bfad->bfa_fcs, bfad->logmod);
  637. bfa_fcs_trc_init(&bfad->bfa_fcs, bfad->trcmod);
  638. bfa_fcs_aen_init(&bfad->bfa_fcs, bfad->aen);
  639. bfa_fcs_init(&bfad->bfa_fcs, &bfad->bfa, bfad, BFA_FALSE);
  640. bfa_fcs_driver_info_init(&bfad->bfa_fcs, &driver_info);
  641. bfa_fcs_set_fdmi_param(&bfad->bfa_fcs, fdmi_enable);
  642. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  643. bfad->bfad_flags |= BFAD_DRV_INIT_DONE;
  644. return BFA_STATUS_OK;
  645. out_setup_intr_failure:
  646. bfa_detach(&bfad->bfa);
  647. bfad_hal_mem_release(bfad);
  648. out_hal_mem_alloc_failure:
  649. return BFA_STATUS_FAILED;
  650. }
  651. void
  652. bfad_drv_uninit(struct bfad_s *bfad)
  653. {
  654. del_timer_sync(&bfad->hal_tmo);
  655. bfa_isr_disable(&bfad->bfa);
  656. bfa_detach(&bfad->bfa);
  657. bfad_remove_intr(bfad);
  658. bfa_assert(list_empty(&bfad->file_q));
  659. bfad_hal_mem_release(bfad);
  660. }
  661. void
  662. bfad_drv_start(struct bfad_s *bfad)
  663. {
  664. unsigned long flags;
  665. spin_lock_irqsave(&bfad->bfad_lock, flags);
  666. bfa_start(&bfad->bfa);
  667. bfa_fcs_start(&bfad->bfa_fcs);
  668. bfad->bfad_flags |= BFAD_HAL_START_DONE;
  669. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  670. bfad_fc4_probe_post(bfad);
  671. }
  672. void
  673. bfad_drv_stop(struct bfad_s *bfad)
  674. {
  675. unsigned long flags;
  676. spin_lock_irqsave(&bfad->bfad_lock, flags);
  677. init_completion(&bfad->comp);
  678. bfad->pport.flags |= BFAD_PORT_DELETE;
  679. bfa_fcs_exit(&bfad->bfa_fcs);
  680. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  681. wait_for_completion(&bfad->comp);
  682. spin_lock_irqsave(&bfad->bfad_lock, flags);
  683. init_completion(&bfad->comp);
  684. bfa_stop(&bfad->bfa);
  685. bfad->bfad_flags &= ~BFAD_HAL_START_DONE;
  686. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  687. wait_for_completion(&bfad->comp);
  688. }
  689. bfa_status_t
  690. bfad_cfg_pport(struct bfad_s *bfad, enum bfa_port_role role)
  691. {
  692. int rc = BFA_STATUS_OK;
  693. /*
  694. * Allocate scsi_host for the physical port
  695. */
  696. if ((bfad_supported_fc4s & BFA_PORT_ROLE_FCP_IM)
  697. && (role & BFA_PORT_ROLE_FCP_IM)) {
  698. if (bfad->pport.im_port == NULL) {
  699. rc = BFA_STATUS_FAILED;
  700. goto out;
  701. }
  702. rc = bfad_im_scsi_host_alloc(bfad, bfad->pport.im_port);
  703. if (rc != BFA_STATUS_OK)
  704. goto out;
  705. bfad->pport.roles |= BFA_PORT_ROLE_FCP_IM;
  706. }
  707. bfad->bfad_flags |= BFAD_CFG_PPORT_DONE;
  708. out:
  709. return rc;
  710. }
  711. void
  712. bfad_uncfg_pport(struct bfad_s *bfad)
  713. {
  714. if ((bfad->pport.roles & BFA_PORT_ROLE_FCP_IPFC) && ipfc_enable) {
  715. bfad_ipfc_port_delete(bfad, &bfad->pport);
  716. bfad->pport.roles &= ~BFA_PORT_ROLE_FCP_IPFC;
  717. }
  718. if ((bfad_supported_fc4s & BFA_PORT_ROLE_FCP_IM)
  719. && (bfad->pport.roles & BFA_PORT_ROLE_FCP_IM)) {
  720. bfad_im_scsi_host_free(bfad, bfad->pport.im_port);
  721. bfad_im_port_clean(bfad->pport.im_port);
  722. kfree(bfad->pport.im_port);
  723. bfad->pport.roles &= ~BFA_PORT_ROLE_FCP_IM;
  724. }
  725. bfad->bfad_flags &= ~BFAD_CFG_PPORT_DONE;
  726. }
  727. void
  728. bfad_drv_log_level_set(struct bfad_s *bfad)
  729. {
  730. if (log_level > BFA_LOG_INVALID && log_level <= BFA_LOG_LEVEL_MAX)
  731. bfa_log_set_level_all(&bfad->log_data, log_level);
  732. }
  733. /*
  734. * PCI_entry PCI driver entries * {
  735. */
  736. /**
  737. * PCI probe entry.
  738. */
  739. int
  740. bfad_pci_probe(struct pci_dev *pdev, const struct pci_device_id *pid)
  741. {
  742. struct bfad_s *bfad;
  743. int error = -ENODEV, retval;
  744. char buf[16];
  745. /*
  746. * For single port cards - only claim function 0
  747. */
  748. if ((pdev->device == BFA_PCI_DEVICE_ID_FC_8G1P)
  749. && (PCI_FUNC(pdev->devfn) != 0))
  750. return -ENODEV;
  751. BFA_TRACE(BFA_INFO, "bfad_pci_probe entry");
  752. bfad = kzalloc(sizeof(struct bfad_s), GFP_KERNEL);
  753. if (!bfad) {
  754. error = -ENOMEM;
  755. goto out;
  756. }
  757. bfad->trcmod = kzalloc(sizeof(struct bfa_trc_mod_s), GFP_KERNEL);
  758. if (!bfad->trcmod) {
  759. printk(KERN_WARNING "Error alloc trace buffer!\n");
  760. error = -ENOMEM;
  761. goto out_alloc_trace_failure;
  762. }
  763. /*
  764. * LOG/TRACE INIT
  765. */
  766. bfa_trc_init(bfad->trcmod);
  767. bfa_trc(bfad, bfad_inst);
  768. bfad->logmod = &bfad->log_data;
  769. sprintf(buf, "%d", bfad_inst);
  770. bfa_log_init(bfad->logmod, buf, bfa_os_printf);
  771. bfad_drv_log_level_set(bfad);
  772. bfad->aen = &bfad->aen_buf;
  773. if (!(bfad_load_fwimg(pdev))) {
  774. printk(KERN_WARNING "bfad_load_fwimg failure!\n");
  775. kfree(bfad->trcmod);
  776. goto out_alloc_trace_failure;
  777. }
  778. retval = bfad_pci_init(pdev, bfad);
  779. if (retval) {
  780. printk(KERN_WARNING "bfad_pci_init failure!\n");
  781. error = retval;
  782. goto out_pci_init_failure;
  783. }
  784. mutex_lock(&bfad_mutex);
  785. bfad->inst_no = bfad_inst++;
  786. list_add_tail(&bfad->list_entry, &bfad_list);
  787. mutex_unlock(&bfad_mutex);
  788. spin_lock_init(&bfad->bfad_lock);
  789. pci_set_drvdata(pdev, bfad);
  790. bfad->ref_count = 0;
  791. bfad->pport.bfad = bfad;
  792. retval = bfad_drv_init(bfad);
  793. if (retval != BFA_STATUS_OK)
  794. goto out_drv_init_failure;
  795. if (!(bfad->bfad_flags & BFAD_HAL_INIT_DONE)) {
  796. printk(KERN_WARNING "bfad%d: hal init failed\n", bfad->inst_no);
  797. goto ok;
  798. }
  799. /*
  800. * PPORT FCS config
  801. */
  802. bfad_fcs_port_cfg(bfad);
  803. retval = bfad_cfg_pport(bfad, BFA_PORT_ROLE_FCP_IM);
  804. if (retval != BFA_STATUS_OK)
  805. goto out_cfg_pport_failure;
  806. /*
  807. * BFAD level FC4 (IM/TM/IPFC) specific resource allocation
  808. */
  809. retval = bfad_fc4_probe(bfad);
  810. if (retval != BFA_STATUS_OK) {
  811. printk(KERN_WARNING "bfad_fc4_probe failed\n");
  812. goto out_fc4_probe_failure;
  813. }
  814. bfad_drv_start(bfad);
  815. /*
  816. * If bfa_linkup_delay is set to -1 default; try to retrive the
  817. * value using the bfad_os_get_linkup_delay(); else use the
  818. * passed in module param value as the bfa_linkup_delay.
  819. */
  820. if (bfa_linkup_delay < 0) {
  821. bfa_linkup_delay = bfad_os_get_linkup_delay(bfad);
  822. bfad_os_rport_online_wait(bfad);
  823. bfa_linkup_delay = -1;
  824. } else {
  825. bfad_os_rport_online_wait(bfad);
  826. }
  827. bfa_log(bfad->logmod, BFA_LOG_LINUX_DEVICE_CLAIMED, bfad->pci_name);
  828. ok:
  829. return 0;
  830. out_fc4_probe_failure:
  831. bfad_fc4_probe_undo(bfad);
  832. bfad_uncfg_pport(bfad);
  833. out_cfg_pport_failure:
  834. bfad_drv_uninit(bfad);
  835. out_drv_init_failure:
  836. mutex_lock(&bfad_mutex);
  837. bfad_inst--;
  838. list_del(&bfad->list_entry);
  839. mutex_unlock(&bfad_mutex);
  840. bfad_pci_uninit(pdev, bfad);
  841. out_pci_init_failure:
  842. kfree(bfad->trcmod);
  843. out_alloc_trace_failure:
  844. kfree(bfad);
  845. out:
  846. return error;
  847. }
  848. /**
  849. * PCI remove entry.
  850. */
  851. void
  852. bfad_pci_remove(struct pci_dev *pdev)
  853. {
  854. struct bfad_s *bfad = pci_get_drvdata(pdev);
  855. unsigned long flags;
  856. bfa_trc(bfad, bfad->inst_no);
  857. if ((bfad->bfad_flags & BFAD_DRV_INIT_DONE)
  858. && !(bfad->bfad_flags & BFAD_HAL_INIT_DONE)) {
  859. spin_lock_irqsave(&bfad->bfad_lock, flags);
  860. init_completion(&bfad->comp);
  861. bfa_stop(&bfad->bfa);
  862. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  863. wait_for_completion(&bfad->comp);
  864. bfad_remove_intr(bfad);
  865. del_timer_sync(&bfad->hal_tmo);
  866. goto hal_detach;
  867. } else if (!(bfad->bfad_flags & BFAD_DRV_INIT_DONE)) {
  868. goto remove_sysfs;
  869. }
  870. if (bfad->bfad_flags & BFAD_HAL_START_DONE)
  871. bfad_drv_stop(bfad);
  872. bfad_remove_intr(bfad);
  873. del_timer_sync(&bfad->hal_tmo);
  874. bfad_fc4_probe_undo(bfad);
  875. if (bfad->bfad_flags & BFAD_CFG_PPORT_DONE)
  876. bfad_uncfg_pport(bfad);
  877. hal_detach:
  878. spin_lock_irqsave(&bfad->bfad_lock, flags);
  879. bfa_detach(&bfad->bfa);
  880. spin_unlock_irqrestore(&bfad->bfad_lock, flags);
  881. bfad_hal_mem_release(bfad);
  882. remove_sysfs:
  883. mutex_lock(&bfad_mutex);
  884. bfad_inst--;
  885. list_del(&bfad->list_entry);
  886. mutex_unlock(&bfad_mutex);
  887. bfad_pci_uninit(pdev, bfad);
  888. kfree(bfad->trcmod);
  889. kfree(bfad);
  890. }
  891. static struct pci_device_id bfad_id_table[] = {
  892. {
  893. .vendor = BFA_PCI_VENDOR_ID_BROCADE,
  894. .device = BFA_PCI_DEVICE_ID_FC_8G2P,
  895. .subvendor = PCI_ANY_ID,
  896. .subdevice = PCI_ANY_ID,
  897. },
  898. {
  899. .vendor = BFA_PCI_VENDOR_ID_BROCADE,
  900. .device = BFA_PCI_DEVICE_ID_FC_8G1P,
  901. .subvendor = PCI_ANY_ID,
  902. .subdevice = PCI_ANY_ID,
  903. },
  904. {
  905. .vendor = BFA_PCI_VENDOR_ID_BROCADE,
  906. .device = BFA_PCI_DEVICE_ID_CT,
  907. .subvendor = PCI_ANY_ID,
  908. .subdevice = PCI_ANY_ID,
  909. .class = (PCI_CLASS_SERIAL_FIBER << 8),
  910. .class_mask = ~0,
  911. },
  912. {0, 0},
  913. };
  914. MODULE_DEVICE_TABLE(pci, bfad_id_table);
  915. static struct pci_driver bfad_pci_driver = {
  916. .name = BFAD_DRIVER_NAME,
  917. .id_table = bfad_id_table,
  918. .probe = bfad_pci_probe,
  919. .remove = __devexit_p(bfad_pci_remove),
  920. };
  921. /**
  922. * Linux driver module functions
  923. */
  924. bfa_status_t
  925. bfad_fc4_module_init(void)
  926. {
  927. int rc;
  928. rc = bfad_im_module_init();
  929. if (rc != BFA_STATUS_OK)
  930. goto ext;
  931. bfad_tm_module_init();
  932. if (ipfc_enable)
  933. bfad_ipfc_module_init();
  934. ext:
  935. return rc;
  936. }
  937. void
  938. bfad_fc4_module_exit(void)
  939. {
  940. if (ipfc_enable)
  941. bfad_ipfc_module_exit();
  942. bfad_tm_module_exit();
  943. bfad_im_module_exit();
  944. }
  945. /**
  946. * Driver module init.
  947. */
  948. static int __init
  949. bfad_init(void)
  950. {
  951. int error = 0;
  952. printk(KERN_INFO "Brocade BFA FC/FCOE SCSI driver - version: %s\n",
  953. BFAD_DRIVER_VERSION);
  954. if (num_sgpgs > 0)
  955. num_sgpgs_parm = num_sgpgs;
  956. error = bfad_fc4_module_init();
  957. if (error) {
  958. error = -ENOMEM;
  959. printk(KERN_WARNING "bfad_fc4_module_init failure\n");
  960. goto ext;
  961. }
  962. if (!strcmp(FCPI_NAME, " fcpim"))
  963. bfad_supported_fc4s |= BFA_PORT_ROLE_FCP_IM;
  964. if (!strcmp(FCPT_NAME, " fcptm"))
  965. bfad_supported_fc4s |= BFA_PORT_ROLE_FCP_TM;
  966. if (!strcmp(IPFC_NAME, " ipfc"))
  967. bfad_supported_fc4s |= BFA_PORT_ROLE_FCP_IPFC;
  968. bfa_ioc_auto_recover(ioc_auto_recover);
  969. bfa_fcs_rport_set_del_timeout(rport_del_timeout);
  970. error = pci_register_driver(&bfad_pci_driver);
  971. if (error) {
  972. printk(KERN_WARNING "bfad pci_register_driver failure\n");
  973. goto ext;
  974. }
  975. return 0;
  976. ext:
  977. bfad_fc4_module_exit();
  978. return error;
  979. }
  980. /**
  981. * Driver module exit.
  982. */
  983. static void __exit
  984. bfad_exit(void)
  985. {
  986. pci_unregister_driver(&bfad_pci_driver);
  987. bfad_fc4_module_exit();
  988. bfad_free_fwimg();
  989. }
  990. #define BFAD_PROTO_NAME FCPI_NAME FCPT_NAME IPFC_NAME
  991. module_init(bfad_init);
  992. module_exit(bfad_exit);
  993. MODULE_LICENSE("GPL");
  994. MODULE_DESCRIPTION("Brocade Fibre Channel HBA Driver" BFAD_PROTO_NAME);
  995. MODULE_AUTHOR("Brocade Communications Systems, Inc.");
  996. MODULE_VERSION(BFAD_DRIVER_VERSION);