lpfc_bsg.c 85 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121
  1. /*******************************************************************
  2. * This file is part of the Emulex Linux Device Driver for *
  3. * Fibre Channel Host Bus Adapters. *
  4. * Copyright (C) 2009-2010 Emulex. All rights reserved. *
  5. * EMULEX and SLI are trademarks of Emulex. *
  6. * www.emulex.com *
  7. * *
  8. * This program is free software; you can redistribute it and/or *
  9. * modify it under the terms of version 2 of the GNU General *
  10. * Public License as published by the Free Software Foundation. *
  11. * This program is distributed in the hope that it will be useful. *
  12. * ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND *
  13. * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, *
  14. * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE *
  15. * DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD *
  16. * TO BE LEGALLY INVALID. See the GNU General Public License for *
  17. * more details, a copy of which can be found in the file COPYING *
  18. * included with this package. *
  19. *******************************************************************/
  20. #include <linux/interrupt.h>
  21. #include <linux/mempool.h>
  22. #include <linux/pci.h>
  23. #include <linux/slab.h>
  24. #include <linux/delay.h>
  25. #include <scsi/scsi.h>
  26. #include <scsi/scsi_host.h>
  27. #include <scsi/scsi_transport_fc.h>
  28. #include <scsi/scsi_bsg_fc.h>
  29. #include <scsi/fc/fc_fs.h>
  30. #include "lpfc_hw4.h"
  31. #include "lpfc_hw.h"
  32. #include "lpfc_sli.h"
  33. #include "lpfc_sli4.h"
  34. #include "lpfc_nl.h"
  35. #include "lpfc_bsg.h"
  36. #include "lpfc_disc.h"
  37. #include "lpfc_scsi.h"
  38. #include "lpfc.h"
  39. #include "lpfc_logmsg.h"
  40. #include "lpfc_crtn.h"
  41. #include "lpfc_vport.h"
  42. #include "lpfc_version.h"
  43. struct lpfc_bsg_event {
  44. struct list_head node;
  45. struct kref kref;
  46. wait_queue_head_t wq;
  47. /* Event type and waiter identifiers */
  48. uint32_t type_mask;
  49. uint32_t req_id;
  50. uint32_t reg_id;
  51. /* next two flags are here for the auto-delete logic */
  52. unsigned long wait_time_stamp;
  53. int waiting;
  54. /* seen and not seen events */
  55. struct list_head events_to_get;
  56. struct list_head events_to_see;
  57. /* job waiting for this event to finish */
  58. struct fc_bsg_job *set_job;
  59. };
  60. struct lpfc_bsg_iocb {
  61. struct lpfc_iocbq *cmdiocbq;
  62. struct lpfc_iocbq *rspiocbq;
  63. struct lpfc_dmabuf *bmp;
  64. struct lpfc_nodelist *ndlp;
  65. /* job waiting for this iocb to finish */
  66. struct fc_bsg_job *set_job;
  67. };
  68. struct lpfc_bsg_mbox {
  69. LPFC_MBOXQ_t *pmboxq;
  70. MAILBOX_t *mb;
  71. /* job waiting for this mbox command to finish */
  72. struct fc_bsg_job *set_job;
  73. };
  74. #define MENLO_DID 0x0000FC0E
  75. struct lpfc_bsg_menlo {
  76. struct lpfc_iocbq *cmdiocbq;
  77. struct lpfc_iocbq *rspiocbq;
  78. struct lpfc_dmabuf *bmp;
  79. /* job waiting for this iocb to finish */
  80. struct fc_bsg_job *set_job;
  81. };
  82. #define TYPE_EVT 1
  83. #define TYPE_IOCB 2
  84. #define TYPE_MBOX 3
  85. #define TYPE_MENLO 4
  86. struct bsg_job_data {
  87. uint32_t type;
  88. union {
  89. struct lpfc_bsg_event *evt;
  90. struct lpfc_bsg_iocb iocb;
  91. struct lpfc_bsg_mbox mbox;
  92. struct lpfc_bsg_menlo menlo;
  93. } context_un;
  94. };
  95. struct event_data {
  96. struct list_head node;
  97. uint32_t type;
  98. uint32_t immed_dat;
  99. void *data;
  100. uint32_t len;
  101. };
  102. #define BUF_SZ_4K 4096
  103. #define SLI_CT_ELX_LOOPBACK 0x10
  104. enum ELX_LOOPBACK_CMD {
  105. ELX_LOOPBACK_XRI_SETUP,
  106. ELX_LOOPBACK_DATA,
  107. };
  108. #define ELX_LOOPBACK_HEADER_SZ \
  109. (size_t)(&((struct lpfc_sli_ct_request *)NULL)->un)
  110. struct lpfc_dmabufext {
  111. struct lpfc_dmabuf dma;
  112. uint32_t size;
  113. uint32_t flag;
  114. };
  115. /**
  116. * lpfc_bsg_send_mgmt_cmd_cmp - lpfc_bsg_send_mgmt_cmd's completion handler
  117. * @phba: Pointer to HBA context object.
  118. * @cmdiocbq: Pointer to command iocb.
  119. * @rspiocbq: Pointer to response iocb.
  120. *
  121. * This function is the completion handler for iocbs issued using
  122. * lpfc_bsg_send_mgmt_cmd function. This function is called by the
  123. * ring event handler function without any lock held. This function
  124. * can be called from both worker thread context and interrupt
  125. * context. This function also can be called from another thread which
  126. * cleans up the SLI layer objects.
  127. * This function copies the contents of the response iocb to the
  128. * response iocb memory object provided by the caller of
  129. * lpfc_sli_issue_iocb_wait and then wakes up the thread which
  130. * sleeps for the iocb completion.
  131. **/
  132. static void
  133. lpfc_bsg_send_mgmt_cmd_cmp(struct lpfc_hba *phba,
  134. struct lpfc_iocbq *cmdiocbq,
  135. struct lpfc_iocbq *rspiocbq)
  136. {
  137. unsigned long iflags;
  138. struct bsg_job_data *dd_data;
  139. struct fc_bsg_job *job;
  140. IOCB_t *rsp;
  141. struct lpfc_dmabuf *bmp;
  142. struct lpfc_nodelist *ndlp;
  143. struct lpfc_bsg_iocb *iocb;
  144. unsigned long flags;
  145. int rc = 0;
  146. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  147. dd_data = cmdiocbq->context1;
  148. if (!dd_data) {
  149. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  150. return;
  151. }
  152. iocb = &dd_data->context_un.iocb;
  153. job = iocb->set_job;
  154. job->dd_data = NULL; /* so timeout handler does not reply */
  155. spin_lock_irqsave(&phba->hbalock, iflags);
  156. cmdiocbq->iocb_flag |= LPFC_IO_WAKE;
  157. if (cmdiocbq->context2 && rspiocbq)
  158. memcpy(&((struct lpfc_iocbq *)cmdiocbq->context2)->iocb,
  159. &rspiocbq->iocb, sizeof(IOCB_t));
  160. spin_unlock_irqrestore(&phba->hbalock, iflags);
  161. bmp = iocb->bmp;
  162. rspiocbq = iocb->rspiocbq;
  163. rsp = &rspiocbq->iocb;
  164. ndlp = iocb->ndlp;
  165. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  166. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  167. pci_unmap_sg(phba->pcidev, job->reply_payload.sg_list,
  168. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  169. if (rsp->ulpStatus) {
  170. if (rsp->ulpStatus == IOSTAT_LOCAL_REJECT) {
  171. switch (rsp->un.ulpWord[4] & 0xff) {
  172. case IOERR_SEQUENCE_TIMEOUT:
  173. rc = -ETIMEDOUT;
  174. break;
  175. case IOERR_INVALID_RPI:
  176. rc = -EFAULT;
  177. break;
  178. default:
  179. rc = -EACCES;
  180. break;
  181. }
  182. } else
  183. rc = -EACCES;
  184. } else
  185. job->reply->reply_payload_rcv_len =
  186. rsp->un.genreq64.bdl.bdeSize;
  187. lpfc_mbuf_free(phba, bmp->virt, bmp->phys);
  188. lpfc_sli_release_iocbq(phba, rspiocbq);
  189. lpfc_sli_release_iocbq(phba, cmdiocbq);
  190. lpfc_nlp_put(ndlp);
  191. kfree(bmp);
  192. kfree(dd_data);
  193. /* make error code available to userspace */
  194. job->reply->result = rc;
  195. /* complete the job back to userspace */
  196. job->job_done(job);
  197. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  198. return;
  199. }
  200. /**
  201. * lpfc_bsg_send_mgmt_cmd - send a CT command from a bsg request
  202. * @job: fc_bsg_job to handle
  203. **/
  204. static int
  205. lpfc_bsg_send_mgmt_cmd(struct fc_bsg_job *job)
  206. {
  207. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  208. struct lpfc_hba *phba = vport->phba;
  209. struct lpfc_rport_data *rdata = job->rport->dd_data;
  210. struct lpfc_nodelist *ndlp = rdata->pnode;
  211. struct ulp_bde64 *bpl = NULL;
  212. uint32_t timeout;
  213. struct lpfc_iocbq *cmdiocbq = NULL;
  214. struct lpfc_iocbq *rspiocbq = NULL;
  215. IOCB_t *cmd;
  216. IOCB_t *rsp;
  217. struct lpfc_dmabuf *bmp = NULL;
  218. int request_nseg;
  219. int reply_nseg;
  220. struct scatterlist *sgel = NULL;
  221. int numbde;
  222. dma_addr_t busaddr;
  223. struct bsg_job_data *dd_data;
  224. uint32_t creg_val;
  225. int rc = 0;
  226. /* in case no data is transferred */
  227. job->reply->reply_payload_rcv_len = 0;
  228. /* allocate our bsg tracking structure */
  229. dd_data = kmalloc(sizeof(struct bsg_job_data), GFP_KERNEL);
  230. if (!dd_data) {
  231. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  232. "2733 Failed allocation of dd_data\n");
  233. rc = -ENOMEM;
  234. goto no_dd_data;
  235. }
  236. if (!lpfc_nlp_get(ndlp)) {
  237. rc = -ENODEV;
  238. goto no_ndlp;
  239. }
  240. bmp = kmalloc(sizeof(struct lpfc_dmabuf), GFP_KERNEL);
  241. if (!bmp) {
  242. rc = -ENOMEM;
  243. goto free_ndlp;
  244. }
  245. if (ndlp->nlp_flag & NLP_ELS_SND_MASK) {
  246. rc = -ENODEV;
  247. goto free_bmp;
  248. }
  249. cmdiocbq = lpfc_sli_get_iocbq(phba);
  250. if (!cmdiocbq) {
  251. rc = -ENOMEM;
  252. goto free_bmp;
  253. }
  254. cmd = &cmdiocbq->iocb;
  255. rspiocbq = lpfc_sli_get_iocbq(phba);
  256. if (!rspiocbq) {
  257. rc = -ENOMEM;
  258. goto free_cmdiocbq;
  259. }
  260. rsp = &rspiocbq->iocb;
  261. bmp->virt = lpfc_mbuf_alloc(phba, 0, &bmp->phys);
  262. if (!bmp->virt) {
  263. rc = -ENOMEM;
  264. goto free_rspiocbq;
  265. }
  266. INIT_LIST_HEAD(&bmp->list);
  267. bpl = (struct ulp_bde64 *) bmp->virt;
  268. request_nseg = pci_map_sg(phba->pcidev, job->request_payload.sg_list,
  269. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  270. for_each_sg(job->request_payload.sg_list, sgel, request_nseg, numbde) {
  271. busaddr = sg_dma_address(sgel);
  272. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64;
  273. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  274. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  275. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  276. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  277. bpl++;
  278. }
  279. reply_nseg = pci_map_sg(phba->pcidev, job->reply_payload.sg_list,
  280. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  281. for_each_sg(job->reply_payload.sg_list, sgel, reply_nseg, numbde) {
  282. busaddr = sg_dma_address(sgel);
  283. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64I;
  284. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  285. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  286. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  287. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  288. bpl++;
  289. }
  290. cmd->un.genreq64.bdl.ulpIoTag32 = 0;
  291. cmd->un.genreq64.bdl.addrHigh = putPaddrHigh(bmp->phys);
  292. cmd->un.genreq64.bdl.addrLow = putPaddrLow(bmp->phys);
  293. cmd->un.genreq64.bdl.bdeFlags = BUFF_TYPE_BLP_64;
  294. cmd->un.genreq64.bdl.bdeSize =
  295. (request_nseg + reply_nseg) * sizeof(struct ulp_bde64);
  296. cmd->ulpCommand = CMD_GEN_REQUEST64_CR;
  297. cmd->un.genreq64.w5.hcsw.Fctl = (SI | LA);
  298. cmd->un.genreq64.w5.hcsw.Dfctl = 0;
  299. cmd->un.genreq64.w5.hcsw.Rctl = FC_RCTL_DD_UNSOL_CTL;
  300. cmd->un.genreq64.w5.hcsw.Type = FC_TYPE_CT;
  301. cmd->ulpBdeCount = 1;
  302. cmd->ulpLe = 1;
  303. cmd->ulpClass = CLASS3;
  304. cmd->ulpContext = ndlp->nlp_rpi;
  305. cmd->ulpOwner = OWN_CHIP;
  306. cmdiocbq->vport = phba->pport;
  307. cmdiocbq->context3 = bmp;
  308. cmdiocbq->iocb_flag |= LPFC_IO_LIBDFC;
  309. timeout = phba->fc_ratov * 2;
  310. cmd->ulpTimeout = timeout;
  311. cmdiocbq->iocb_cmpl = lpfc_bsg_send_mgmt_cmd_cmp;
  312. cmdiocbq->context1 = dd_data;
  313. cmdiocbq->context2 = rspiocbq;
  314. dd_data->type = TYPE_IOCB;
  315. dd_data->context_un.iocb.cmdiocbq = cmdiocbq;
  316. dd_data->context_un.iocb.rspiocbq = rspiocbq;
  317. dd_data->context_un.iocb.set_job = job;
  318. dd_data->context_un.iocb.bmp = bmp;
  319. dd_data->context_un.iocb.ndlp = ndlp;
  320. if (phba->cfg_poll & DISABLE_FCP_RING_INT) {
  321. creg_val = readl(phba->HCregaddr);
  322. creg_val |= (HC_R0INT_ENA << LPFC_FCP_RING);
  323. writel(creg_val, phba->HCregaddr);
  324. readl(phba->HCregaddr); /* flush */
  325. }
  326. rc = lpfc_sli_issue_iocb(phba, LPFC_ELS_RING, cmdiocbq, 0);
  327. if (rc == IOCB_SUCCESS)
  328. return 0; /* done for now */
  329. /* iocb failed so cleanup */
  330. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  331. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  332. pci_unmap_sg(phba->pcidev, job->reply_payload.sg_list,
  333. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  334. lpfc_mbuf_free(phba, bmp->virt, bmp->phys);
  335. free_rspiocbq:
  336. lpfc_sli_release_iocbq(phba, rspiocbq);
  337. free_cmdiocbq:
  338. lpfc_sli_release_iocbq(phba, cmdiocbq);
  339. free_bmp:
  340. kfree(bmp);
  341. free_ndlp:
  342. lpfc_nlp_put(ndlp);
  343. no_ndlp:
  344. kfree(dd_data);
  345. no_dd_data:
  346. /* make error code available to userspace */
  347. job->reply->result = rc;
  348. job->dd_data = NULL;
  349. return rc;
  350. }
  351. /**
  352. * lpfc_bsg_rport_els_cmp - lpfc_bsg_rport_els's completion handler
  353. * @phba: Pointer to HBA context object.
  354. * @cmdiocbq: Pointer to command iocb.
  355. * @rspiocbq: Pointer to response iocb.
  356. *
  357. * This function is the completion handler for iocbs issued using
  358. * lpfc_bsg_rport_els_cmp function. This function is called by the
  359. * ring event handler function without any lock held. This function
  360. * can be called from both worker thread context and interrupt
  361. * context. This function also can be called from other thread which
  362. * cleans up the SLI layer objects.
  363. * This function copies the contents of the response iocb to the
  364. * response iocb memory object provided by the caller of
  365. * lpfc_sli_issue_iocb_wait and then wakes up the thread which
  366. * sleeps for the iocb completion.
  367. **/
  368. static void
  369. lpfc_bsg_rport_els_cmp(struct lpfc_hba *phba,
  370. struct lpfc_iocbq *cmdiocbq,
  371. struct lpfc_iocbq *rspiocbq)
  372. {
  373. struct bsg_job_data *dd_data;
  374. struct fc_bsg_job *job;
  375. IOCB_t *rsp;
  376. struct lpfc_nodelist *ndlp;
  377. struct lpfc_dmabuf *pbuflist = NULL;
  378. struct fc_bsg_ctels_reply *els_reply;
  379. uint8_t *rjt_data;
  380. unsigned long flags;
  381. int rc = 0;
  382. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  383. dd_data = cmdiocbq->context1;
  384. /* normal completion and timeout crossed paths, already done */
  385. if (!dd_data) {
  386. spin_unlock_irqrestore(&phba->hbalock, flags);
  387. return;
  388. }
  389. cmdiocbq->iocb_flag |= LPFC_IO_WAKE;
  390. if (cmdiocbq->context2 && rspiocbq)
  391. memcpy(&((struct lpfc_iocbq *)cmdiocbq->context2)->iocb,
  392. &rspiocbq->iocb, sizeof(IOCB_t));
  393. job = dd_data->context_un.iocb.set_job;
  394. cmdiocbq = dd_data->context_un.iocb.cmdiocbq;
  395. rspiocbq = dd_data->context_un.iocb.rspiocbq;
  396. rsp = &rspiocbq->iocb;
  397. ndlp = dd_data->context_un.iocb.ndlp;
  398. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  399. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  400. pci_unmap_sg(phba->pcidev, job->reply_payload.sg_list,
  401. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  402. if (job->reply->result == -EAGAIN)
  403. rc = -EAGAIN;
  404. else if (rsp->ulpStatus == IOSTAT_SUCCESS)
  405. job->reply->reply_payload_rcv_len =
  406. rsp->un.elsreq64.bdl.bdeSize;
  407. else if (rsp->ulpStatus == IOSTAT_LS_RJT) {
  408. job->reply->reply_payload_rcv_len =
  409. sizeof(struct fc_bsg_ctels_reply);
  410. /* LS_RJT data returned in word 4 */
  411. rjt_data = (uint8_t *)&rsp->un.ulpWord[4];
  412. els_reply = &job->reply->reply_data.ctels_reply;
  413. els_reply->status = FC_CTELS_STATUS_REJECT;
  414. els_reply->rjt_data.action = rjt_data[3];
  415. els_reply->rjt_data.reason_code = rjt_data[2];
  416. els_reply->rjt_data.reason_explanation = rjt_data[1];
  417. els_reply->rjt_data.vendor_unique = rjt_data[0];
  418. } else
  419. rc = -EIO;
  420. pbuflist = (struct lpfc_dmabuf *) cmdiocbq->context3;
  421. lpfc_mbuf_free(phba, pbuflist->virt, pbuflist->phys);
  422. lpfc_sli_release_iocbq(phba, rspiocbq);
  423. lpfc_sli_release_iocbq(phba, cmdiocbq);
  424. lpfc_nlp_put(ndlp);
  425. kfree(dd_data);
  426. /* make error code available to userspace */
  427. job->reply->result = rc;
  428. job->dd_data = NULL;
  429. /* complete the job back to userspace */
  430. job->job_done(job);
  431. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  432. return;
  433. }
  434. /**
  435. * lpfc_bsg_rport_els - send an ELS command from a bsg request
  436. * @job: fc_bsg_job to handle
  437. **/
  438. static int
  439. lpfc_bsg_rport_els(struct fc_bsg_job *job)
  440. {
  441. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  442. struct lpfc_hba *phba = vport->phba;
  443. struct lpfc_rport_data *rdata = job->rport->dd_data;
  444. struct lpfc_nodelist *ndlp = rdata->pnode;
  445. uint32_t elscmd;
  446. uint32_t cmdsize;
  447. uint32_t rspsize;
  448. struct lpfc_iocbq *rspiocbq;
  449. struct lpfc_iocbq *cmdiocbq;
  450. IOCB_t *rsp;
  451. uint16_t rpi = 0;
  452. struct lpfc_dmabuf *pcmd;
  453. struct lpfc_dmabuf *prsp;
  454. struct lpfc_dmabuf *pbuflist = NULL;
  455. struct ulp_bde64 *bpl;
  456. int request_nseg;
  457. int reply_nseg;
  458. struct scatterlist *sgel = NULL;
  459. int numbde;
  460. dma_addr_t busaddr;
  461. struct bsg_job_data *dd_data;
  462. uint32_t creg_val;
  463. int rc = 0;
  464. /* in case no data is transferred */
  465. job->reply->reply_payload_rcv_len = 0;
  466. /* allocate our bsg tracking structure */
  467. dd_data = kmalloc(sizeof(struct bsg_job_data), GFP_KERNEL);
  468. if (!dd_data) {
  469. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  470. "2735 Failed allocation of dd_data\n");
  471. rc = -ENOMEM;
  472. goto no_dd_data;
  473. }
  474. if (!lpfc_nlp_get(ndlp)) {
  475. rc = -ENODEV;
  476. goto free_dd_data;
  477. }
  478. elscmd = job->request->rqst_data.r_els.els_code;
  479. cmdsize = job->request_payload.payload_len;
  480. rspsize = job->reply_payload.payload_len;
  481. rspiocbq = lpfc_sli_get_iocbq(phba);
  482. if (!rspiocbq) {
  483. lpfc_nlp_put(ndlp);
  484. rc = -ENOMEM;
  485. goto free_dd_data;
  486. }
  487. rsp = &rspiocbq->iocb;
  488. rpi = ndlp->nlp_rpi;
  489. cmdiocbq = lpfc_prep_els_iocb(vport, 1, cmdsize, 0, ndlp,
  490. ndlp->nlp_DID, elscmd);
  491. if (!cmdiocbq) {
  492. rc = -EIO;
  493. goto free_rspiocbq;
  494. }
  495. /* prep els iocb set context1 to the ndlp, context2 to the command
  496. * dmabuf, context3 holds the data dmabuf
  497. */
  498. pcmd = (struct lpfc_dmabuf *) cmdiocbq->context2;
  499. prsp = (struct lpfc_dmabuf *) pcmd->list.next;
  500. lpfc_mbuf_free(phba, pcmd->virt, pcmd->phys);
  501. kfree(pcmd);
  502. lpfc_mbuf_free(phba, prsp->virt, prsp->phys);
  503. kfree(prsp);
  504. cmdiocbq->context2 = NULL;
  505. pbuflist = (struct lpfc_dmabuf *) cmdiocbq->context3;
  506. bpl = (struct ulp_bde64 *) pbuflist->virt;
  507. request_nseg = pci_map_sg(phba->pcidev, job->request_payload.sg_list,
  508. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  509. for_each_sg(job->request_payload.sg_list, sgel, request_nseg, numbde) {
  510. busaddr = sg_dma_address(sgel);
  511. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64;
  512. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  513. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  514. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  515. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  516. bpl++;
  517. }
  518. reply_nseg = pci_map_sg(phba->pcidev, job->reply_payload.sg_list,
  519. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  520. for_each_sg(job->reply_payload.sg_list, sgel, reply_nseg, numbde) {
  521. busaddr = sg_dma_address(sgel);
  522. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64I;
  523. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  524. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  525. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  526. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  527. bpl++;
  528. }
  529. cmdiocbq->iocb.un.elsreq64.bdl.bdeSize =
  530. (request_nseg + reply_nseg) * sizeof(struct ulp_bde64);
  531. cmdiocbq->iocb.ulpContext = rpi;
  532. cmdiocbq->iocb_flag |= LPFC_IO_LIBDFC;
  533. cmdiocbq->context1 = NULL;
  534. cmdiocbq->context2 = NULL;
  535. cmdiocbq->iocb_cmpl = lpfc_bsg_rport_els_cmp;
  536. cmdiocbq->context1 = dd_data;
  537. cmdiocbq->context2 = rspiocbq;
  538. dd_data->type = TYPE_IOCB;
  539. dd_data->context_un.iocb.cmdiocbq = cmdiocbq;
  540. dd_data->context_un.iocb.rspiocbq = rspiocbq;
  541. dd_data->context_un.iocb.set_job = job;
  542. dd_data->context_un.iocb.bmp = NULL;;
  543. dd_data->context_un.iocb.ndlp = ndlp;
  544. if (phba->cfg_poll & DISABLE_FCP_RING_INT) {
  545. creg_val = readl(phba->HCregaddr);
  546. creg_val |= (HC_R0INT_ENA << LPFC_FCP_RING);
  547. writel(creg_val, phba->HCregaddr);
  548. readl(phba->HCregaddr); /* flush */
  549. }
  550. rc = lpfc_sli_issue_iocb(phba, LPFC_ELS_RING, cmdiocbq, 0);
  551. lpfc_nlp_put(ndlp);
  552. if (rc == IOCB_SUCCESS)
  553. return 0; /* done for now */
  554. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  555. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  556. pci_unmap_sg(phba->pcidev, job->reply_payload.sg_list,
  557. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  558. lpfc_mbuf_free(phba, pbuflist->virt, pbuflist->phys);
  559. lpfc_sli_release_iocbq(phba, cmdiocbq);
  560. free_rspiocbq:
  561. lpfc_sli_release_iocbq(phba, rspiocbq);
  562. free_dd_data:
  563. kfree(dd_data);
  564. no_dd_data:
  565. /* make error code available to userspace */
  566. job->reply->result = rc;
  567. job->dd_data = NULL;
  568. return rc;
  569. }
  570. /**
  571. * lpfc_bsg_event_free - frees an allocated event structure
  572. * @kref: Pointer to a kref.
  573. *
  574. * Called from kref_put. Back cast the kref into an event structure address.
  575. * Free any events to get, delete associated nodes, free any events to see,
  576. * free any data then free the event itself.
  577. **/
  578. static void
  579. lpfc_bsg_event_free(struct kref *kref)
  580. {
  581. struct lpfc_bsg_event *evt = container_of(kref, struct lpfc_bsg_event,
  582. kref);
  583. struct event_data *ed;
  584. list_del(&evt->node);
  585. while (!list_empty(&evt->events_to_get)) {
  586. ed = list_entry(evt->events_to_get.next, typeof(*ed), node);
  587. list_del(&ed->node);
  588. kfree(ed->data);
  589. kfree(ed);
  590. }
  591. while (!list_empty(&evt->events_to_see)) {
  592. ed = list_entry(evt->events_to_see.next, typeof(*ed), node);
  593. list_del(&ed->node);
  594. kfree(ed->data);
  595. kfree(ed);
  596. }
  597. kfree(evt);
  598. }
  599. /**
  600. * lpfc_bsg_event_ref - increments the kref for an event
  601. * @evt: Pointer to an event structure.
  602. **/
  603. static inline void
  604. lpfc_bsg_event_ref(struct lpfc_bsg_event *evt)
  605. {
  606. kref_get(&evt->kref);
  607. }
  608. /**
  609. * lpfc_bsg_event_unref - Uses kref_put to free an event structure
  610. * @evt: Pointer to an event structure.
  611. **/
  612. static inline void
  613. lpfc_bsg_event_unref(struct lpfc_bsg_event *evt)
  614. {
  615. kref_put(&evt->kref, lpfc_bsg_event_free);
  616. }
  617. /**
  618. * lpfc_bsg_event_new - allocate and initialize a event structure
  619. * @ev_mask: Mask of events.
  620. * @ev_reg_id: Event reg id.
  621. * @ev_req_id: Event request id.
  622. **/
  623. static struct lpfc_bsg_event *
  624. lpfc_bsg_event_new(uint32_t ev_mask, int ev_reg_id, uint32_t ev_req_id)
  625. {
  626. struct lpfc_bsg_event *evt = kzalloc(sizeof(*evt), GFP_KERNEL);
  627. if (!evt)
  628. return NULL;
  629. INIT_LIST_HEAD(&evt->events_to_get);
  630. INIT_LIST_HEAD(&evt->events_to_see);
  631. evt->type_mask = ev_mask;
  632. evt->req_id = ev_req_id;
  633. evt->reg_id = ev_reg_id;
  634. evt->wait_time_stamp = jiffies;
  635. init_waitqueue_head(&evt->wq);
  636. kref_init(&evt->kref);
  637. return evt;
  638. }
  639. /**
  640. * diag_cmd_data_free - Frees an lpfc dma buffer extension
  641. * @phba: Pointer to HBA context object.
  642. * @mlist: Pointer to an lpfc dma buffer extension.
  643. **/
  644. static int
  645. diag_cmd_data_free(struct lpfc_hba *phba, struct lpfc_dmabufext *mlist)
  646. {
  647. struct lpfc_dmabufext *mlast;
  648. struct pci_dev *pcidev;
  649. struct list_head head, *curr, *next;
  650. if ((!mlist) || (!lpfc_is_link_up(phba) &&
  651. (phba->link_flag & LS_LOOPBACK_MODE))) {
  652. return 0;
  653. }
  654. pcidev = phba->pcidev;
  655. list_add_tail(&head, &mlist->dma.list);
  656. list_for_each_safe(curr, next, &head) {
  657. mlast = list_entry(curr, struct lpfc_dmabufext , dma.list);
  658. if (mlast->dma.virt)
  659. dma_free_coherent(&pcidev->dev,
  660. mlast->size,
  661. mlast->dma.virt,
  662. mlast->dma.phys);
  663. kfree(mlast);
  664. }
  665. return 0;
  666. }
  667. /**
  668. * lpfc_bsg_ct_unsol_event - process an unsolicited CT command
  669. * @phba:
  670. * @pring:
  671. * @piocbq:
  672. *
  673. * This function is called when an unsolicited CT command is received. It
  674. * forwards the event to any processes registered to receive CT events.
  675. **/
  676. int
  677. lpfc_bsg_ct_unsol_event(struct lpfc_hba *phba, struct lpfc_sli_ring *pring,
  678. struct lpfc_iocbq *piocbq)
  679. {
  680. uint32_t evt_req_id = 0;
  681. uint32_t cmd;
  682. uint32_t len;
  683. struct lpfc_dmabuf *dmabuf = NULL;
  684. struct lpfc_bsg_event *evt;
  685. struct event_data *evt_dat = NULL;
  686. struct lpfc_iocbq *iocbq;
  687. size_t offset = 0;
  688. struct list_head head;
  689. struct ulp_bde64 *bde;
  690. dma_addr_t dma_addr;
  691. int i;
  692. struct lpfc_dmabuf *bdeBuf1 = piocbq->context2;
  693. struct lpfc_dmabuf *bdeBuf2 = piocbq->context3;
  694. struct lpfc_hbq_entry *hbqe;
  695. struct lpfc_sli_ct_request *ct_req;
  696. struct fc_bsg_job *job = NULL;
  697. unsigned long flags;
  698. int size = 0;
  699. INIT_LIST_HEAD(&head);
  700. list_add_tail(&head, &piocbq->list);
  701. if (piocbq->iocb.ulpBdeCount == 0 ||
  702. piocbq->iocb.un.cont64[0].tus.f.bdeSize == 0)
  703. goto error_ct_unsol_exit;
  704. if (phba->link_state == LPFC_HBA_ERROR ||
  705. (!(phba->sli.sli_flag & LPFC_SLI_ACTIVE)))
  706. goto error_ct_unsol_exit;
  707. if (phba->sli3_options & LPFC_SLI3_HBQ_ENABLED)
  708. dmabuf = bdeBuf1;
  709. else {
  710. dma_addr = getPaddr(piocbq->iocb.un.cont64[0].addrHigh,
  711. piocbq->iocb.un.cont64[0].addrLow);
  712. dmabuf = lpfc_sli_ringpostbuf_get(phba, pring, dma_addr);
  713. }
  714. if (dmabuf == NULL)
  715. goto error_ct_unsol_exit;
  716. ct_req = (struct lpfc_sli_ct_request *)dmabuf->virt;
  717. evt_req_id = ct_req->FsType;
  718. cmd = ct_req->CommandResponse.bits.CmdRsp;
  719. len = ct_req->CommandResponse.bits.Size;
  720. if (!(phba->sli3_options & LPFC_SLI3_HBQ_ENABLED))
  721. lpfc_sli_ringpostbuf_put(phba, pring, dmabuf);
  722. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  723. list_for_each_entry(evt, &phba->ct_ev_waiters, node) {
  724. if (!(evt->type_mask & FC_REG_CT_EVENT) ||
  725. evt->req_id != evt_req_id)
  726. continue;
  727. lpfc_bsg_event_ref(evt);
  728. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  729. evt_dat = kzalloc(sizeof(*evt_dat), GFP_KERNEL);
  730. if (evt_dat == NULL) {
  731. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  732. lpfc_bsg_event_unref(evt);
  733. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  734. "2614 Memory allocation failed for "
  735. "CT event\n");
  736. break;
  737. }
  738. if (phba->sli3_options & LPFC_SLI3_HBQ_ENABLED) {
  739. /* take accumulated byte count from the last iocbq */
  740. iocbq = list_entry(head.prev, typeof(*iocbq), list);
  741. evt_dat->len = iocbq->iocb.unsli3.rcvsli3.acc_len;
  742. } else {
  743. list_for_each_entry(iocbq, &head, list) {
  744. for (i = 0; i < iocbq->iocb.ulpBdeCount; i++)
  745. evt_dat->len +=
  746. iocbq->iocb.un.cont64[i].tus.f.bdeSize;
  747. }
  748. }
  749. evt_dat->data = kzalloc(evt_dat->len, GFP_KERNEL);
  750. if (evt_dat->data == NULL) {
  751. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  752. "2615 Memory allocation failed for "
  753. "CT event data, size %d\n",
  754. evt_dat->len);
  755. kfree(evt_dat);
  756. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  757. lpfc_bsg_event_unref(evt);
  758. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  759. goto error_ct_unsol_exit;
  760. }
  761. list_for_each_entry(iocbq, &head, list) {
  762. size = 0;
  763. if (phba->sli3_options & LPFC_SLI3_HBQ_ENABLED) {
  764. bdeBuf1 = iocbq->context2;
  765. bdeBuf2 = iocbq->context3;
  766. }
  767. for (i = 0; i < iocbq->iocb.ulpBdeCount; i++) {
  768. if (phba->sli3_options &
  769. LPFC_SLI3_HBQ_ENABLED) {
  770. if (i == 0) {
  771. hbqe = (struct lpfc_hbq_entry *)
  772. &iocbq->iocb.un.ulpWord[0];
  773. size = hbqe->bde.tus.f.bdeSize;
  774. dmabuf = bdeBuf1;
  775. } else if (i == 1) {
  776. hbqe = (struct lpfc_hbq_entry *)
  777. &iocbq->iocb.unsli3.
  778. sli3Words[4];
  779. size = hbqe->bde.tus.f.bdeSize;
  780. dmabuf = bdeBuf2;
  781. }
  782. if ((offset + size) > evt_dat->len)
  783. size = evt_dat->len - offset;
  784. } else {
  785. size = iocbq->iocb.un.cont64[i].
  786. tus.f.bdeSize;
  787. bde = &iocbq->iocb.un.cont64[i];
  788. dma_addr = getPaddr(bde->addrHigh,
  789. bde->addrLow);
  790. dmabuf = lpfc_sli_ringpostbuf_get(phba,
  791. pring, dma_addr);
  792. }
  793. if (!dmabuf) {
  794. lpfc_printf_log(phba, KERN_ERR,
  795. LOG_LIBDFC, "2616 No dmabuf "
  796. "found for iocbq 0x%p\n",
  797. iocbq);
  798. kfree(evt_dat->data);
  799. kfree(evt_dat);
  800. spin_lock_irqsave(&phba->ct_ev_lock,
  801. flags);
  802. lpfc_bsg_event_unref(evt);
  803. spin_unlock_irqrestore(
  804. &phba->ct_ev_lock, flags);
  805. goto error_ct_unsol_exit;
  806. }
  807. memcpy((char *)(evt_dat->data) + offset,
  808. dmabuf->virt, size);
  809. offset += size;
  810. if (evt_req_id != SLI_CT_ELX_LOOPBACK &&
  811. !(phba->sli3_options &
  812. LPFC_SLI3_HBQ_ENABLED)) {
  813. lpfc_sli_ringpostbuf_put(phba, pring,
  814. dmabuf);
  815. } else {
  816. switch (cmd) {
  817. case ELX_LOOPBACK_DATA:
  818. diag_cmd_data_free(phba,
  819. (struct lpfc_dmabufext *)
  820. dmabuf);
  821. break;
  822. case ELX_LOOPBACK_XRI_SETUP:
  823. if ((phba->sli_rev ==
  824. LPFC_SLI_REV2) ||
  825. (phba->sli3_options &
  826. LPFC_SLI3_HBQ_ENABLED
  827. )) {
  828. lpfc_in_buf_free(phba,
  829. dmabuf);
  830. } else {
  831. lpfc_post_buffer(phba,
  832. pring,
  833. 1);
  834. }
  835. break;
  836. default:
  837. if (!(phba->sli3_options &
  838. LPFC_SLI3_HBQ_ENABLED))
  839. lpfc_post_buffer(phba,
  840. pring,
  841. 1);
  842. break;
  843. }
  844. }
  845. }
  846. }
  847. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  848. if (phba->sli_rev == LPFC_SLI_REV4) {
  849. evt_dat->immed_dat = phba->ctx_idx;
  850. phba->ctx_idx = (phba->ctx_idx + 1) % 64;
  851. phba->ct_ctx[evt_dat->immed_dat].oxid =
  852. piocbq->iocb.ulpContext;
  853. phba->ct_ctx[evt_dat->immed_dat].SID =
  854. piocbq->iocb.un.rcvels.remoteID;
  855. } else
  856. evt_dat->immed_dat = piocbq->iocb.ulpContext;
  857. evt_dat->type = FC_REG_CT_EVENT;
  858. list_add(&evt_dat->node, &evt->events_to_see);
  859. if (evt_req_id == SLI_CT_ELX_LOOPBACK) {
  860. wake_up_interruptible(&evt->wq);
  861. lpfc_bsg_event_unref(evt);
  862. break;
  863. }
  864. list_move(evt->events_to_see.prev, &evt->events_to_get);
  865. lpfc_bsg_event_unref(evt);
  866. job = evt->set_job;
  867. evt->set_job = NULL;
  868. if (job) {
  869. job->reply->reply_payload_rcv_len = size;
  870. /* make error code available to userspace */
  871. job->reply->result = 0;
  872. job->dd_data = NULL;
  873. /* complete the job back to userspace */
  874. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  875. job->job_done(job);
  876. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  877. }
  878. }
  879. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  880. error_ct_unsol_exit:
  881. if (!list_empty(&head))
  882. list_del(&head);
  883. if (evt_req_id == SLI_CT_ELX_LOOPBACK)
  884. return 0;
  885. return 1;
  886. }
  887. /**
  888. * lpfc_bsg_hba_set_event - process a SET_EVENT bsg vendor command
  889. * @job: SET_EVENT fc_bsg_job
  890. **/
  891. static int
  892. lpfc_bsg_hba_set_event(struct fc_bsg_job *job)
  893. {
  894. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  895. struct lpfc_hba *phba = vport->phba;
  896. struct set_ct_event *event_req;
  897. struct lpfc_bsg_event *evt;
  898. int rc = 0;
  899. struct bsg_job_data *dd_data = NULL;
  900. uint32_t ev_mask;
  901. unsigned long flags;
  902. if (job->request_len <
  903. sizeof(struct fc_bsg_request) + sizeof(struct set_ct_event)) {
  904. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  905. "2612 Received SET_CT_EVENT below minimum "
  906. "size\n");
  907. rc = -EINVAL;
  908. goto job_error;
  909. }
  910. dd_data = kmalloc(sizeof(struct bsg_job_data), GFP_KERNEL);
  911. if (dd_data == NULL) {
  912. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  913. "2734 Failed allocation of dd_data\n");
  914. rc = -ENOMEM;
  915. goto job_error;
  916. }
  917. event_req = (struct set_ct_event *)
  918. job->request->rqst_data.h_vendor.vendor_cmd;
  919. ev_mask = ((uint32_t)(unsigned long)event_req->type_mask &
  920. FC_REG_EVENT_MASK);
  921. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  922. list_for_each_entry(evt, &phba->ct_ev_waiters, node) {
  923. if (evt->reg_id == event_req->ev_reg_id) {
  924. lpfc_bsg_event_ref(evt);
  925. evt->wait_time_stamp = jiffies;
  926. break;
  927. }
  928. }
  929. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  930. if (&evt->node == &phba->ct_ev_waiters) {
  931. /* no event waiting struct yet - first call */
  932. evt = lpfc_bsg_event_new(ev_mask, event_req->ev_reg_id,
  933. event_req->ev_req_id);
  934. if (!evt) {
  935. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  936. "2617 Failed allocation of event "
  937. "waiter\n");
  938. rc = -ENOMEM;
  939. goto job_error;
  940. }
  941. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  942. list_add(&evt->node, &phba->ct_ev_waiters);
  943. lpfc_bsg_event_ref(evt);
  944. evt->wait_time_stamp = jiffies;
  945. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  946. }
  947. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  948. evt->waiting = 1;
  949. dd_data->type = TYPE_EVT;
  950. dd_data->context_un.evt = evt;
  951. evt->set_job = job; /* for unsolicited command */
  952. job->dd_data = dd_data; /* for fc transport timeout callback*/
  953. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  954. return 0; /* call job done later */
  955. job_error:
  956. if (dd_data != NULL)
  957. kfree(dd_data);
  958. job->dd_data = NULL;
  959. return rc;
  960. }
  961. /**
  962. * lpfc_bsg_hba_get_event - process a GET_EVENT bsg vendor command
  963. * @job: GET_EVENT fc_bsg_job
  964. **/
  965. static int
  966. lpfc_bsg_hba_get_event(struct fc_bsg_job *job)
  967. {
  968. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  969. struct lpfc_hba *phba = vport->phba;
  970. struct get_ct_event *event_req;
  971. struct get_ct_event_reply *event_reply;
  972. struct lpfc_bsg_event *evt;
  973. struct event_data *evt_dat = NULL;
  974. unsigned long flags;
  975. uint32_t rc = 0;
  976. if (job->request_len <
  977. sizeof(struct fc_bsg_request) + sizeof(struct get_ct_event)) {
  978. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  979. "2613 Received GET_CT_EVENT request below "
  980. "minimum size\n");
  981. rc = -EINVAL;
  982. goto job_error;
  983. }
  984. event_req = (struct get_ct_event *)
  985. job->request->rqst_data.h_vendor.vendor_cmd;
  986. event_reply = (struct get_ct_event_reply *)
  987. job->reply->reply_data.vendor_reply.vendor_rsp;
  988. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  989. list_for_each_entry(evt, &phba->ct_ev_waiters, node) {
  990. if (evt->reg_id == event_req->ev_reg_id) {
  991. if (list_empty(&evt->events_to_get))
  992. break;
  993. lpfc_bsg_event_ref(evt);
  994. evt->wait_time_stamp = jiffies;
  995. evt_dat = list_entry(evt->events_to_get.prev,
  996. struct event_data, node);
  997. list_del(&evt_dat->node);
  998. break;
  999. }
  1000. }
  1001. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1002. /* The app may continue to ask for event data until it gets
  1003. * an error indicating that there isn't anymore
  1004. */
  1005. if (evt_dat == NULL) {
  1006. job->reply->reply_payload_rcv_len = 0;
  1007. rc = -ENOENT;
  1008. goto job_error;
  1009. }
  1010. if (evt_dat->len > job->request_payload.payload_len) {
  1011. evt_dat->len = job->request_payload.payload_len;
  1012. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  1013. "2618 Truncated event data at %d "
  1014. "bytes\n",
  1015. job->request_payload.payload_len);
  1016. }
  1017. event_reply->type = evt_dat->type;
  1018. event_reply->immed_data = evt_dat->immed_dat;
  1019. if (evt_dat->len > 0)
  1020. job->reply->reply_payload_rcv_len =
  1021. sg_copy_from_buffer(job->request_payload.sg_list,
  1022. job->request_payload.sg_cnt,
  1023. evt_dat->data, evt_dat->len);
  1024. else
  1025. job->reply->reply_payload_rcv_len = 0;
  1026. if (evt_dat) {
  1027. kfree(evt_dat->data);
  1028. kfree(evt_dat);
  1029. }
  1030. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1031. lpfc_bsg_event_unref(evt);
  1032. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1033. job->dd_data = NULL;
  1034. job->reply->result = 0;
  1035. job->job_done(job);
  1036. return 0;
  1037. job_error:
  1038. job->dd_data = NULL;
  1039. job->reply->result = rc;
  1040. return rc;
  1041. }
  1042. /**
  1043. * lpfc_issue_ct_rsp_cmp - lpfc_issue_ct_rsp's completion handler
  1044. * @phba: Pointer to HBA context object.
  1045. * @cmdiocbq: Pointer to command iocb.
  1046. * @rspiocbq: Pointer to response iocb.
  1047. *
  1048. * This function is the completion handler for iocbs issued using
  1049. * lpfc_issue_ct_rsp_cmp function. This function is called by the
  1050. * ring event handler function without any lock held. This function
  1051. * can be called from both worker thread context and interrupt
  1052. * context. This function also can be called from other thread which
  1053. * cleans up the SLI layer objects.
  1054. * This function copy the contents of the response iocb to the
  1055. * response iocb memory object provided by the caller of
  1056. * lpfc_sli_issue_iocb_wait and then wakes up the thread which
  1057. * sleeps for the iocb completion.
  1058. **/
  1059. static void
  1060. lpfc_issue_ct_rsp_cmp(struct lpfc_hba *phba,
  1061. struct lpfc_iocbq *cmdiocbq,
  1062. struct lpfc_iocbq *rspiocbq)
  1063. {
  1064. struct bsg_job_data *dd_data;
  1065. struct fc_bsg_job *job;
  1066. IOCB_t *rsp;
  1067. struct lpfc_dmabuf *bmp;
  1068. struct lpfc_nodelist *ndlp;
  1069. unsigned long flags;
  1070. int rc = 0;
  1071. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1072. dd_data = cmdiocbq->context1;
  1073. /* normal completion and timeout crossed paths, already done */
  1074. if (!dd_data) {
  1075. spin_unlock_irqrestore(&phba->hbalock, flags);
  1076. return;
  1077. }
  1078. job = dd_data->context_un.iocb.set_job;
  1079. bmp = dd_data->context_un.iocb.bmp;
  1080. rsp = &rspiocbq->iocb;
  1081. ndlp = dd_data->context_un.iocb.ndlp;
  1082. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  1083. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  1084. if (rsp->ulpStatus) {
  1085. if (rsp->ulpStatus == IOSTAT_LOCAL_REJECT) {
  1086. switch (rsp->un.ulpWord[4] & 0xff) {
  1087. case IOERR_SEQUENCE_TIMEOUT:
  1088. rc = -ETIMEDOUT;
  1089. break;
  1090. case IOERR_INVALID_RPI:
  1091. rc = -EFAULT;
  1092. break;
  1093. default:
  1094. rc = -EACCES;
  1095. break;
  1096. }
  1097. } else
  1098. rc = -EACCES;
  1099. } else
  1100. job->reply->reply_payload_rcv_len =
  1101. rsp->un.genreq64.bdl.bdeSize;
  1102. lpfc_mbuf_free(phba, bmp->virt, bmp->phys);
  1103. lpfc_sli_release_iocbq(phba, cmdiocbq);
  1104. lpfc_nlp_put(ndlp);
  1105. kfree(bmp);
  1106. kfree(dd_data);
  1107. /* make error code available to userspace */
  1108. job->reply->result = rc;
  1109. job->dd_data = NULL;
  1110. /* complete the job back to userspace */
  1111. job->job_done(job);
  1112. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1113. return;
  1114. }
  1115. /**
  1116. * lpfc_issue_ct_rsp - issue a ct response
  1117. * @phba: Pointer to HBA context object.
  1118. * @job: Pointer to the job object.
  1119. * @tag: tag index value into the ports context exchange array.
  1120. * @bmp: Pointer to a dma buffer descriptor.
  1121. * @num_entry: Number of enties in the bde.
  1122. **/
  1123. static int
  1124. lpfc_issue_ct_rsp(struct lpfc_hba *phba, struct fc_bsg_job *job, uint32_t tag,
  1125. struct lpfc_dmabuf *bmp, int num_entry)
  1126. {
  1127. IOCB_t *icmd;
  1128. struct lpfc_iocbq *ctiocb = NULL;
  1129. int rc = 0;
  1130. struct lpfc_nodelist *ndlp = NULL;
  1131. struct bsg_job_data *dd_data;
  1132. uint32_t creg_val;
  1133. /* allocate our bsg tracking structure */
  1134. dd_data = kmalloc(sizeof(struct bsg_job_data), GFP_KERNEL);
  1135. if (!dd_data) {
  1136. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  1137. "2736 Failed allocation of dd_data\n");
  1138. rc = -ENOMEM;
  1139. goto no_dd_data;
  1140. }
  1141. /* Allocate buffer for command iocb */
  1142. ctiocb = lpfc_sli_get_iocbq(phba);
  1143. if (!ctiocb) {
  1144. rc = ENOMEM;
  1145. goto no_ctiocb;
  1146. }
  1147. icmd = &ctiocb->iocb;
  1148. icmd->un.xseq64.bdl.ulpIoTag32 = 0;
  1149. icmd->un.xseq64.bdl.addrHigh = putPaddrHigh(bmp->phys);
  1150. icmd->un.xseq64.bdl.addrLow = putPaddrLow(bmp->phys);
  1151. icmd->un.xseq64.bdl.bdeFlags = BUFF_TYPE_BLP_64;
  1152. icmd->un.xseq64.bdl.bdeSize = (num_entry * sizeof(struct ulp_bde64));
  1153. icmd->un.xseq64.w5.hcsw.Fctl = (LS | LA);
  1154. icmd->un.xseq64.w5.hcsw.Dfctl = 0;
  1155. icmd->un.xseq64.w5.hcsw.Rctl = FC_RCTL_DD_SOL_CTL;
  1156. icmd->un.xseq64.w5.hcsw.Type = FC_TYPE_CT;
  1157. /* Fill in rest of iocb */
  1158. icmd->ulpCommand = CMD_XMIT_SEQUENCE64_CX;
  1159. icmd->ulpBdeCount = 1;
  1160. icmd->ulpLe = 1;
  1161. icmd->ulpClass = CLASS3;
  1162. if (phba->sli_rev == LPFC_SLI_REV4) {
  1163. /* Do not issue unsol response if oxid not marked as valid */
  1164. if (!(phba->ct_ctx[tag].flags & UNSOL_VALID)) {
  1165. rc = IOCB_ERROR;
  1166. goto issue_ct_rsp_exit;
  1167. }
  1168. icmd->ulpContext = phba->ct_ctx[tag].oxid;
  1169. ndlp = lpfc_findnode_did(phba->pport, phba->ct_ctx[tag].SID);
  1170. if (!ndlp) {
  1171. lpfc_printf_log(phba, KERN_WARNING, LOG_ELS,
  1172. "2721 ndlp null for oxid %x SID %x\n",
  1173. icmd->ulpContext,
  1174. phba->ct_ctx[tag].SID);
  1175. rc = IOCB_ERROR;
  1176. goto issue_ct_rsp_exit;
  1177. }
  1178. icmd->un.ulpWord[3] = ndlp->nlp_rpi;
  1179. /* The exchange is done, mark the entry as invalid */
  1180. phba->ct_ctx[tag].flags &= ~UNSOL_VALID;
  1181. } else
  1182. icmd->ulpContext = (ushort) tag;
  1183. icmd->ulpTimeout = phba->fc_ratov * 2;
  1184. /* Xmit CT response on exchange <xid> */
  1185. lpfc_printf_log(phba, KERN_INFO, LOG_ELS,
  1186. "2722 Xmit CT response on exchange x%x Data: x%x x%x\n",
  1187. icmd->ulpContext, icmd->ulpIoTag, phba->link_state);
  1188. ctiocb->iocb_cmpl = NULL;
  1189. ctiocb->iocb_flag |= LPFC_IO_LIBDFC;
  1190. ctiocb->vport = phba->pport;
  1191. ctiocb->context3 = bmp;
  1192. ctiocb->iocb_cmpl = lpfc_issue_ct_rsp_cmp;
  1193. ctiocb->context1 = dd_data;
  1194. ctiocb->context2 = NULL;
  1195. dd_data->type = TYPE_IOCB;
  1196. dd_data->context_un.iocb.cmdiocbq = ctiocb;
  1197. dd_data->context_un.iocb.rspiocbq = NULL;
  1198. dd_data->context_un.iocb.set_job = job;
  1199. dd_data->context_un.iocb.bmp = bmp;
  1200. dd_data->context_un.iocb.ndlp = ndlp;
  1201. if (phba->cfg_poll & DISABLE_FCP_RING_INT) {
  1202. creg_val = readl(phba->HCregaddr);
  1203. creg_val |= (HC_R0INT_ENA << LPFC_FCP_RING);
  1204. writel(creg_val, phba->HCregaddr);
  1205. readl(phba->HCregaddr); /* flush */
  1206. }
  1207. rc = lpfc_sli_issue_iocb(phba, LPFC_ELS_RING, ctiocb, 0);
  1208. if (rc == IOCB_SUCCESS)
  1209. return 0; /* done for now */
  1210. issue_ct_rsp_exit:
  1211. lpfc_sli_release_iocbq(phba, ctiocb);
  1212. no_ctiocb:
  1213. kfree(dd_data);
  1214. no_dd_data:
  1215. return rc;
  1216. }
  1217. /**
  1218. * lpfc_bsg_send_mgmt_rsp - process a SEND_MGMT_RESP bsg vendor command
  1219. * @job: SEND_MGMT_RESP fc_bsg_job
  1220. **/
  1221. static int
  1222. lpfc_bsg_send_mgmt_rsp(struct fc_bsg_job *job)
  1223. {
  1224. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  1225. struct lpfc_hba *phba = vport->phba;
  1226. struct send_mgmt_resp *mgmt_resp = (struct send_mgmt_resp *)
  1227. job->request->rqst_data.h_vendor.vendor_cmd;
  1228. struct ulp_bde64 *bpl;
  1229. struct lpfc_dmabuf *bmp = NULL;
  1230. struct scatterlist *sgel = NULL;
  1231. int request_nseg;
  1232. int numbde;
  1233. dma_addr_t busaddr;
  1234. uint32_t tag = mgmt_resp->tag;
  1235. unsigned long reqbfrcnt =
  1236. (unsigned long)job->request_payload.payload_len;
  1237. int rc = 0;
  1238. /* in case no data is transferred */
  1239. job->reply->reply_payload_rcv_len = 0;
  1240. if (!reqbfrcnt || (reqbfrcnt > (80 * BUF_SZ_4K))) {
  1241. rc = -ERANGE;
  1242. goto send_mgmt_rsp_exit;
  1243. }
  1244. bmp = kmalloc(sizeof(struct lpfc_dmabuf), GFP_KERNEL);
  1245. if (!bmp) {
  1246. rc = -ENOMEM;
  1247. goto send_mgmt_rsp_exit;
  1248. }
  1249. bmp->virt = lpfc_mbuf_alloc(phba, 0, &bmp->phys);
  1250. if (!bmp->virt) {
  1251. rc = -ENOMEM;
  1252. goto send_mgmt_rsp_free_bmp;
  1253. }
  1254. INIT_LIST_HEAD(&bmp->list);
  1255. bpl = (struct ulp_bde64 *) bmp->virt;
  1256. request_nseg = pci_map_sg(phba->pcidev, job->request_payload.sg_list,
  1257. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  1258. for_each_sg(job->request_payload.sg_list, sgel, request_nseg, numbde) {
  1259. busaddr = sg_dma_address(sgel);
  1260. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64;
  1261. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  1262. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  1263. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  1264. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  1265. bpl++;
  1266. }
  1267. rc = lpfc_issue_ct_rsp(phba, job, tag, bmp, request_nseg);
  1268. if (rc == IOCB_SUCCESS)
  1269. return 0; /* done for now */
  1270. /* TBD need to handle a timeout */
  1271. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  1272. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  1273. rc = -EACCES;
  1274. lpfc_mbuf_free(phba, bmp->virt, bmp->phys);
  1275. send_mgmt_rsp_free_bmp:
  1276. kfree(bmp);
  1277. send_mgmt_rsp_exit:
  1278. /* make error code available to userspace */
  1279. job->reply->result = rc;
  1280. job->dd_data = NULL;
  1281. return rc;
  1282. }
  1283. /**
  1284. * lpfc_bsg_diag_mode - process a LPFC_BSG_VENDOR_DIAG_MODE bsg vendor command
  1285. * @job: LPFC_BSG_VENDOR_DIAG_MODE
  1286. *
  1287. * This function is responsible for placing a port into diagnostic loopback
  1288. * mode in order to perform a diagnostic loopback test.
  1289. * All new scsi requests are blocked, a small delay is used to allow the
  1290. * scsi requests to complete then the link is brought down. If the link is
  1291. * is placed in loopback mode then scsi requests are again allowed
  1292. * so the scsi mid-layer doesn't give up on the port.
  1293. * All of this is done in-line.
  1294. */
  1295. static int
  1296. lpfc_bsg_diag_mode(struct fc_bsg_job *job)
  1297. {
  1298. struct Scsi_Host *shost = job->shost;
  1299. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  1300. struct lpfc_hba *phba = vport->phba;
  1301. struct diag_mode_set *loopback_mode;
  1302. struct lpfc_sli *psli = &phba->sli;
  1303. struct lpfc_sli_ring *pring = &psli->ring[LPFC_FCP_RING];
  1304. uint32_t link_flags;
  1305. uint32_t timeout;
  1306. struct lpfc_vport **vports;
  1307. LPFC_MBOXQ_t *pmboxq;
  1308. int mbxstatus;
  1309. int i = 0;
  1310. int rc = 0;
  1311. /* no data to return just the return code */
  1312. job->reply->reply_payload_rcv_len = 0;
  1313. if (job->request_len <
  1314. sizeof(struct fc_bsg_request) + sizeof(struct diag_mode_set)) {
  1315. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  1316. "2738 Received DIAG MODE request below minimum "
  1317. "size\n");
  1318. rc = -EINVAL;
  1319. goto job_error;
  1320. }
  1321. loopback_mode = (struct diag_mode_set *)
  1322. job->request->rqst_data.h_vendor.vendor_cmd;
  1323. link_flags = loopback_mode->type;
  1324. timeout = loopback_mode->timeout;
  1325. if ((phba->link_state == LPFC_HBA_ERROR) ||
  1326. (psli->sli_flag & LPFC_BLOCK_MGMT_IO) ||
  1327. (!(psli->sli_flag & LPFC_SLI_ACTIVE))) {
  1328. rc = -EACCES;
  1329. goto job_error;
  1330. }
  1331. pmboxq = mempool_alloc(phba->mbox_mem_pool, GFP_KERNEL);
  1332. if (!pmboxq) {
  1333. rc = -ENOMEM;
  1334. goto job_error;
  1335. }
  1336. vports = lpfc_create_vport_work_array(phba);
  1337. if (vports) {
  1338. for (i = 0; i <= phba->max_vpi && vports[i] != NULL; i++) {
  1339. shost = lpfc_shost_from_vport(vports[i]);
  1340. scsi_block_requests(shost);
  1341. }
  1342. lpfc_destroy_vport_work_array(phba, vports);
  1343. } else {
  1344. shost = lpfc_shost_from_vport(phba->pport);
  1345. scsi_block_requests(shost);
  1346. }
  1347. while (pring->txcmplq_cnt) {
  1348. if (i++ > 500) /* wait up to 5 seconds */
  1349. break;
  1350. msleep(10);
  1351. }
  1352. memset((void *)pmboxq, 0, sizeof(LPFC_MBOXQ_t));
  1353. pmboxq->u.mb.mbxCommand = MBX_DOWN_LINK;
  1354. pmboxq->u.mb.mbxOwner = OWN_HOST;
  1355. mbxstatus = lpfc_sli_issue_mbox_wait(phba, pmboxq, LPFC_MBOX_TMO);
  1356. if ((mbxstatus == MBX_SUCCESS) && (pmboxq->u.mb.mbxStatus == 0)) {
  1357. /* wait for link down before proceeding */
  1358. i = 0;
  1359. while (phba->link_state != LPFC_LINK_DOWN) {
  1360. if (i++ > timeout) {
  1361. rc = -ETIMEDOUT;
  1362. goto loopback_mode_exit;
  1363. }
  1364. msleep(10);
  1365. }
  1366. memset((void *)pmboxq, 0, sizeof(LPFC_MBOXQ_t));
  1367. if (link_flags == INTERNAL_LOOP_BACK)
  1368. pmboxq->u.mb.un.varInitLnk.link_flags = FLAGS_LOCAL_LB;
  1369. else
  1370. pmboxq->u.mb.un.varInitLnk.link_flags =
  1371. FLAGS_TOPOLOGY_MODE_LOOP;
  1372. pmboxq->u.mb.mbxCommand = MBX_INIT_LINK;
  1373. pmboxq->u.mb.mbxOwner = OWN_HOST;
  1374. mbxstatus = lpfc_sli_issue_mbox_wait(phba, pmboxq,
  1375. LPFC_MBOX_TMO);
  1376. if ((mbxstatus != MBX_SUCCESS) || (pmboxq->u.mb.mbxStatus))
  1377. rc = -ENODEV;
  1378. else {
  1379. phba->link_flag |= LS_LOOPBACK_MODE;
  1380. /* wait for the link attention interrupt */
  1381. msleep(100);
  1382. i = 0;
  1383. while (phba->link_state != LPFC_HBA_READY) {
  1384. if (i++ > timeout) {
  1385. rc = -ETIMEDOUT;
  1386. break;
  1387. }
  1388. msleep(10);
  1389. }
  1390. }
  1391. } else
  1392. rc = -ENODEV;
  1393. loopback_mode_exit:
  1394. vports = lpfc_create_vport_work_array(phba);
  1395. if (vports) {
  1396. for (i = 0; i <= phba->max_vpi && vports[i] != NULL; i++) {
  1397. shost = lpfc_shost_from_vport(vports[i]);
  1398. scsi_unblock_requests(shost);
  1399. }
  1400. lpfc_destroy_vport_work_array(phba, vports);
  1401. } else {
  1402. shost = lpfc_shost_from_vport(phba->pport);
  1403. scsi_unblock_requests(shost);
  1404. }
  1405. /*
  1406. * Let SLI layer release mboxq if mbox command completed after timeout.
  1407. */
  1408. if (mbxstatus != MBX_TIMEOUT)
  1409. mempool_free(pmboxq, phba->mbox_mem_pool);
  1410. job_error:
  1411. /* make error code available to userspace */
  1412. job->reply->result = rc;
  1413. /* complete the job back to userspace if no error */
  1414. if (rc == 0)
  1415. job->job_done(job);
  1416. return rc;
  1417. }
  1418. /**
  1419. * lpfcdiag_loop_self_reg - obtains a remote port login id
  1420. * @phba: Pointer to HBA context object
  1421. * @rpi: Pointer to a remote port login id
  1422. *
  1423. * This function obtains a remote port login id so the diag loopback test
  1424. * can send and receive its own unsolicited CT command.
  1425. **/
  1426. static int lpfcdiag_loop_self_reg(struct lpfc_hba *phba, uint16_t * rpi)
  1427. {
  1428. LPFC_MBOXQ_t *mbox;
  1429. struct lpfc_dmabuf *dmabuff;
  1430. int status;
  1431. mbox = mempool_alloc(phba->mbox_mem_pool, GFP_KERNEL);
  1432. if (!mbox)
  1433. return ENOMEM;
  1434. status = lpfc_reg_rpi(phba, 0, phba->pport->fc_myDID,
  1435. (uint8_t *)&phba->pport->fc_sparam, mbox, 0);
  1436. if (status) {
  1437. mempool_free(mbox, phba->mbox_mem_pool);
  1438. return ENOMEM;
  1439. }
  1440. dmabuff = (struct lpfc_dmabuf *) mbox->context1;
  1441. mbox->context1 = NULL;
  1442. status = lpfc_sli_issue_mbox_wait(phba, mbox, LPFC_MBOX_TMO);
  1443. if ((status != MBX_SUCCESS) || (mbox->u.mb.mbxStatus)) {
  1444. lpfc_mbuf_free(phba, dmabuff->virt, dmabuff->phys);
  1445. kfree(dmabuff);
  1446. if (status != MBX_TIMEOUT)
  1447. mempool_free(mbox, phba->mbox_mem_pool);
  1448. return ENODEV;
  1449. }
  1450. *rpi = mbox->u.mb.un.varWords[0];
  1451. lpfc_mbuf_free(phba, dmabuff->virt, dmabuff->phys);
  1452. kfree(dmabuff);
  1453. mempool_free(mbox, phba->mbox_mem_pool);
  1454. return 0;
  1455. }
  1456. /**
  1457. * lpfcdiag_loop_self_unreg - unregs from the rpi
  1458. * @phba: Pointer to HBA context object
  1459. * @rpi: Remote port login id
  1460. *
  1461. * This function unregisters the rpi obtained in lpfcdiag_loop_self_reg
  1462. **/
  1463. static int lpfcdiag_loop_self_unreg(struct lpfc_hba *phba, uint16_t rpi)
  1464. {
  1465. LPFC_MBOXQ_t *mbox;
  1466. int status;
  1467. /* Allocate mboxq structure */
  1468. mbox = mempool_alloc(phba->mbox_mem_pool, GFP_KERNEL);
  1469. if (mbox == NULL)
  1470. return ENOMEM;
  1471. lpfc_unreg_login(phba, 0, rpi, mbox);
  1472. status = lpfc_sli_issue_mbox_wait(phba, mbox, LPFC_MBOX_TMO);
  1473. if ((status != MBX_SUCCESS) || (mbox->u.mb.mbxStatus)) {
  1474. if (status != MBX_TIMEOUT)
  1475. mempool_free(mbox, phba->mbox_mem_pool);
  1476. return EIO;
  1477. }
  1478. mempool_free(mbox, phba->mbox_mem_pool);
  1479. return 0;
  1480. }
  1481. /**
  1482. * lpfcdiag_loop_get_xri - obtains the transmit and receive ids
  1483. * @phba: Pointer to HBA context object
  1484. * @rpi: Remote port login id
  1485. * @txxri: Pointer to transmit exchange id
  1486. * @rxxri: Pointer to response exchabge id
  1487. *
  1488. * This function obtains the transmit and receive ids required to send
  1489. * an unsolicited ct command with a payload. A special lpfc FsType and CmdRsp
  1490. * flags are used to the unsolicted response handler is able to process
  1491. * the ct command sent on the same port.
  1492. **/
  1493. static int lpfcdiag_loop_get_xri(struct lpfc_hba *phba, uint16_t rpi,
  1494. uint16_t *txxri, uint16_t * rxxri)
  1495. {
  1496. struct lpfc_bsg_event *evt;
  1497. struct lpfc_iocbq *cmdiocbq, *rspiocbq;
  1498. IOCB_t *cmd, *rsp;
  1499. struct lpfc_dmabuf *dmabuf;
  1500. struct ulp_bde64 *bpl = NULL;
  1501. struct lpfc_sli_ct_request *ctreq = NULL;
  1502. int ret_val = 0;
  1503. unsigned long flags;
  1504. *txxri = 0;
  1505. *rxxri = 0;
  1506. evt = lpfc_bsg_event_new(FC_REG_CT_EVENT, current->pid,
  1507. SLI_CT_ELX_LOOPBACK);
  1508. if (!evt)
  1509. return ENOMEM;
  1510. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1511. list_add(&evt->node, &phba->ct_ev_waiters);
  1512. lpfc_bsg_event_ref(evt);
  1513. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1514. cmdiocbq = lpfc_sli_get_iocbq(phba);
  1515. rspiocbq = lpfc_sli_get_iocbq(phba);
  1516. dmabuf = kmalloc(sizeof(struct lpfc_dmabuf), GFP_KERNEL);
  1517. if (dmabuf) {
  1518. dmabuf->virt = lpfc_mbuf_alloc(phba, 0, &dmabuf->phys);
  1519. INIT_LIST_HEAD(&dmabuf->list);
  1520. bpl = (struct ulp_bde64 *) dmabuf->virt;
  1521. memset(bpl, 0, sizeof(*bpl));
  1522. ctreq = (struct lpfc_sli_ct_request *)(bpl + 1);
  1523. bpl->addrHigh =
  1524. le32_to_cpu(putPaddrHigh(dmabuf->phys + sizeof(*bpl)));
  1525. bpl->addrLow =
  1526. le32_to_cpu(putPaddrLow(dmabuf->phys + sizeof(*bpl)));
  1527. bpl->tus.f.bdeFlags = 0;
  1528. bpl->tus.f.bdeSize = ELX_LOOPBACK_HEADER_SZ;
  1529. bpl->tus.w = le32_to_cpu(bpl->tus.w);
  1530. }
  1531. if (cmdiocbq == NULL || rspiocbq == NULL ||
  1532. dmabuf == NULL || bpl == NULL || ctreq == NULL) {
  1533. ret_val = ENOMEM;
  1534. goto err_get_xri_exit;
  1535. }
  1536. cmd = &cmdiocbq->iocb;
  1537. rsp = &rspiocbq->iocb;
  1538. memset(ctreq, 0, ELX_LOOPBACK_HEADER_SZ);
  1539. ctreq->RevisionId.bits.Revision = SLI_CT_REVISION;
  1540. ctreq->RevisionId.bits.InId = 0;
  1541. ctreq->FsType = SLI_CT_ELX_LOOPBACK;
  1542. ctreq->FsSubType = 0;
  1543. ctreq->CommandResponse.bits.CmdRsp = ELX_LOOPBACK_XRI_SETUP;
  1544. ctreq->CommandResponse.bits.Size = 0;
  1545. cmd->un.xseq64.bdl.addrHigh = putPaddrHigh(dmabuf->phys);
  1546. cmd->un.xseq64.bdl.addrLow = putPaddrLow(dmabuf->phys);
  1547. cmd->un.xseq64.bdl.bdeFlags = BUFF_TYPE_BLP_64;
  1548. cmd->un.xseq64.bdl.bdeSize = sizeof(*bpl);
  1549. cmd->un.xseq64.w5.hcsw.Fctl = LA;
  1550. cmd->un.xseq64.w5.hcsw.Dfctl = 0;
  1551. cmd->un.xseq64.w5.hcsw.Rctl = FC_RCTL_DD_UNSOL_CTL;
  1552. cmd->un.xseq64.w5.hcsw.Type = FC_TYPE_CT;
  1553. cmd->ulpCommand = CMD_XMIT_SEQUENCE64_CR;
  1554. cmd->ulpBdeCount = 1;
  1555. cmd->ulpLe = 1;
  1556. cmd->ulpClass = CLASS3;
  1557. cmd->ulpContext = rpi;
  1558. cmdiocbq->iocb_flag |= LPFC_IO_LIBDFC;
  1559. cmdiocbq->vport = phba->pport;
  1560. ret_val = lpfc_sli_issue_iocb_wait(phba, LPFC_ELS_RING, cmdiocbq,
  1561. rspiocbq,
  1562. (phba->fc_ratov * 2)
  1563. + LPFC_DRVR_TIMEOUT);
  1564. if (ret_val)
  1565. goto err_get_xri_exit;
  1566. *txxri = rsp->ulpContext;
  1567. evt->waiting = 1;
  1568. evt->wait_time_stamp = jiffies;
  1569. ret_val = wait_event_interruptible_timeout(
  1570. evt->wq, !list_empty(&evt->events_to_see),
  1571. ((phba->fc_ratov * 2) + LPFC_DRVR_TIMEOUT) * HZ);
  1572. if (list_empty(&evt->events_to_see))
  1573. ret_val = (ret_val) ? EINTR : ETIMEDOUT;
  1574. else {
  1575. ret_val = IOCB_SUCCESS;
  1576. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1577. list_move(evt->events_to_see.prev, &evt->events_to_get);
  1578. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1579. *rxxri = (list_entry(evt->events_to_get.prev,
  1580. typeof(struct event_data),
  1581. node))->immed_dat;
  1582. }
  1583. evt->waiting = 0;
  1584. err_get_xri_exit:
  1585. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1586. lpfc_bsg_event_unref(evt); /* release ref */
  1587. lpfc_bsg_event_unref(evt); /* delete */
  1588. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1589. if (dmabuf) {
  1590. if (dmabuf->virt)
  1591. lpfc_mbuf_free(phba, dmabuf->virt, dmabuf->phys);
  1592. kfree(dmabuf);
  1593. }
  1594. if (cmdiocbq && (ret_val != IOCB_TIMEDOUT))
  1595. lpfc_sli_release_iocbq(phba, cmdiocbq);
  1596. if (rspiocbq)
  1597. lpfc_sli_release_iocbq(phba, rspiocbq);
  1598. return ret_val;
  1599. }
  1600. /**
  1601. * diag_cmd_data_alloc - fills in a bde struct with dma buffers
  1602. * @phba: Pointer to HBA context object
  1603. * @bpl: Pointer to 64 bit bde structure
  1604. * @size: Number of bytes to process
  1605. * @nocopydata: Flag to copy user data into the allocated buffer
  1606. *
  1607. * This function allocates page size buffers and populates an lpfc_dmabufext.
  1608. * If allowed the user data pointed to with indataptr is copied into the kernel
  1609. * memory. The chained list of page size buffers is returned.
  1610. **/
  1611. static struct lpfc_dmabufext *
  1612. diag_cmd_data_alloc(struct lpfc_hba *phba,
  1613. struct ulp_bde64 *bpl, uint32_t size,
  1614. int nocopydata)
  1615. {
  1616. struct lpfc_dmabufext *mlist = NULL;
  1617. struct lpfc_dmabufext *dmp;
  1618. int cnt, offset = 0, i = 0;
  1619. struct pci_dev *pcidev;
  1620. pcidev = phba->pcidev;
  1621. while (size) {
  1622. /* We get chunks of 4K */
  1623. if (size > BUF_SZ_4K)
  1624. cnt = BUF_SZ_4K;
  1625. else
  1626. cnt = size;
  1627. /* allocate struct lpfc_dmabufext buffer header */
  1628. dmp = kmalloc(sizeof(struct lpfc_dmabufext), GFP_KERNEL);
  1629. if (!dmp)
  1630. goto out;
  1631. INIT_LIST_HEAD(&dmp->dma.list);
  1632. /* Queue it to a linked list */
  1633. if (mlist)
  1634. list_add_tail(&dmp->dma.list, &mlist->dma.list);
  1635. else
  1636. mlist = dmp;
  1637. /* allocate buffer */
  1638. dmp->dma.virt = dma_alloc_coherent(&pcidev->dev,
  1639. cnt,
  1640. &(dmp->dma.phys),
  1641. GFP_KERNEL);
  1642. if (!dmp->dma.virt)
  1643. goto out;
  1644. dmp->size = cnt;
  1645. if (nocopydata) {
  1646. bpl->tus.f.bdeFlags = 0;
  1647. pci_dma_sync_single_for_device(phba->pcidev,
  1648. dmp->dma.phys, LPFC_BPL_SIZE, PCI_DMA_TODEVICE);
  1649. } else {
  1650. memset((uint8_t *)dmp->dma.virt, 0, cnt);
  1651. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64I;
  1652. }
  1653. /* build buffer ptr list for IOCB */
  1654. bpl->addrLow = le32_to_cpu(putPaddrLow(dmp->dma.phys));
  1655. bpl->addrHigh = le32_to_cpu(putPaddrHigh(dmp->dma.phys));
  1656. bpl->tus.f.bdeSize = (ushort) cnt;
  1657. bpl->tus.w = le32_to_cpu(bpl->tus.w);
  1658. bpl++;
  1659. i++;
  1660. offset += cnt;
  1661. size -= cnt;
  1662. }
  1663. mlist->flag = i;
  1664. return mlist;
  1665. out:
  1666. diag_cmd_data_free(phba, mlist);
  1667. return NULL;
  1668. }
  1669. /**
  1670. * lpfcdiag_loop_post_rxbufs - post the receive buffers for an unsol CT cmd
  1671. * @phba: Pointer to HBA context object
  1672. * @rxxri: Receive exchange id
  1673. * @len: Number of data bytes
  1674. *
  1675. * This function allocates and posts a data buffer of sufficient size to recieve
  1676. * an unsolicted CT command.
  1677. **/
  1678. static int lpfcdiag_loop_post_rxbufs(struct lpfc_hba *phba, uint16_t rxxri,
  1679. size_t len)
  1680. {
  1681. struct lpfc_sli *psli = &phba->sli;
  1682. struct lpfc_sli_ring *pring = &psli->ring[LPFC_ELS_RING];
  1683. struct lpfc_iocbq *cmdiocbq;
  1684. IOCB_t *cmd = NULL;
  1685. struct list_head head, *curr, *next;
  1686. struct lpfc_dmabuf *rxbmp;
  1687. struct lpfc_dmabuf *dmp;
  1688. struct lpfc_dmabuf *mp[2] = {NULL, NULL};
  1689. struct ulp_bde64 *rxbpl = NULL;
  1690. uint32_t num_bde;
  1691. struct lpfc_dmabufext *rxbuffer = NULL;
  1692. int ret_val = 0;
  1693. int i = 0;
  1694. cmdiocbq = lpfc_sli_get_iocbq(phba);
  1695. rxbmp = kmalloc(sizeof(struct lpfc_dmabuf), GFP_KERNEL);
  1696. if (rxbmp != NULL) {
  1697. rxbmp->virt = lpfc_mbuf_alloc(phba, 0, &rxbmp->phys);
  1698. INIT_LIST_HEAD(&rxbmp->list);
  1699. rxbpl = (struct ulp_bde64 *) rxbmp->virt;
  1700. rxbuffer = diag_cmd_data_alloc(phba, rxbpl, len, 0);
  1701. }
  1702. if (!cmdiocbq || !rxbmp || !rxbpl || !rxbuffer) {
  1703. ret_val = ENOMEM;
  1704. goto err_post_rxbufs_exit;
  1705. }
  1706. /* Queue buffers for the receive exchange */
  1707. num_bde = (uint32_t)rxbuffer->flag;
  1708. dmp = &rxbuffer->dma;
  1709. cmd = &cmdiocbq->iocb;
  1710. i = 0;
  1711. INIT_LIST_HEAD(&head);
  1712. list_add_tail(&head, &dmp->list);
  1713. list_for_each_safe(curr, next, &head) {
  1714. mp[i] = list_entry(curr, struct lpfc_dmabuf, list);
  1715. list_del(curr);
  1716. if (phba->sli3_options & LPFC_SLI3_HBQ_ENABLED) {
  1717. mp[i]->buffer_tag = lpfc_sli_get_buffer_tag(phba);
  1718. cmd->un.quexri64cx.buff.bde.addrHigh =
  1719. putPaddrHigh(mp[i]->phys);
  1720. cmd->un.quexri64cx.buff.bde.addrLow =
  1721. putPaddrLow(mp[i]->phys);
  1722. cmd->un.quexri64cx.buff.bde.tus.f.bdeSize =
  1723. ((struct lpfc_dmabufext *)mp[i])->size;
  1724. cmd->un.quexri64cx.buff.buffer_tag = mp[i]->buffer_tag;
  1725. cmd->ulpCommand = CMD_QUE_XRI64_CX;
  1726. cmd->ulpPU = 0;
  1727. cmd->ulpLe = 1;
  1728. cmd->ulpBdeCount = 1;
  1729. cmd->unsli3.que_xri64cx_ext_words.ebde_count = 0;
  1730. } else {
  1731. cmd->un.cont64[i].addrHigh = putPaddrHigh(mp[i]->phys);
  1732. cmd->un.cont64[i].addrLow = putPaddrLow(mp[i]->phys);
  1733. cmd->un.cont64[i].tus.f.bdeSize =
  1734. ((struct lpfc_dmabufext *)mp[i])->size;
  1735. cmd->ulpBdeCount = ++i;
  1736. if ((--num_bde > 0) && (i < 2))
  1737. continue;
  1738. cmd->ulpCommand = CMD_QUE_XRI_BUF64_CX;
  1739. cmd->ulpLe = 1;
  1740. }
  1741. cmd->ulpClass = CLASS3;
  1742. cmd->ulpContext = rxxri;
  1743. ret_val = lpfc_sli_issue_iocb(phba, LPFC_ELS_RING, cmdiocbq, 0);
  1744. if (ret_val == IOCB_ERROR) {
  1745. diag_cmd_data_free(phba,
  1746. (struct lpfc_dmabufext *)mp[0]);
  1747. if (mp[1])
  1748. diag_cmd_data_free(phba,
  1749. (struct lpfc_dmabufext *)mp[1]);
  1750. dmp = list_entry(next, struct lpfc_dmabuf, list);
  1751. ret_val = EIO;
  1752. goto err_post_rxbufs_exit;
  1753. }
  1754. lpfc_sli_ringpostbuf_put(phba, pring, mp[0]);
  1755. if (mp[1]) {
  1756. lpfc_sli_ringpostbuf_put(phba, pring, mp[1]);
  1757. mp[1] = NULL;
  1758. }
  1759. /* The iocb was freed by lpfc_sli_issue_iocb */
  1760. cmdiocbq = lpfc_sli_get_iocbq(phba);
  1761. if (!cmdiocbq) {
  1762. dmp = list_entry(next, struct lpfc_dmabuf, list);
  1763. ret_val = EIO;
  1764. goto err_post_rxbufs_exit;
  1765. }
  1766. cmd = &cmdiocbq->iocb;
  1767. i = 0;
  1768. }
  1769. list_del(&head);
  1770. err_post_rxbufs_exit:
  1771. if (rxbmp) {
  1772. if (rxbmp->virt)
  1773. lpfc_mbuf_free(phba, rxbmp->virt, rxbmp->phys);
  1774. kfree(rxbmp);
  1775. }
  1776. if (cmdiocbq)
  1777. lpfc_sli_release_iocbq(phba, cmdiocbq);
  1778. return ret_val;
  1779. }
  1780. /**
  1781. * lpfc_bsg_diag_test - with a port in loopback issues a Ct cmd to itself
  1782. * @job: LPFC_BSG_VENDOR_DIAG_TEST fc_bsg_job
  1783. *
  1784. * This function receives a user data buffer to be transmitted and received on
  1785. * the same port, the link must be up and in loopback mode prior
  1786. * to being called.
  1787. * 1. A kernel buffer is allocated to copy the user data into.
  1788. * 2. The port registers with "itself".
  1789. * 3. The transmit and receive exchange ids are obtained.
  1790. * 4. The receive exchange id is posted.
  1791. * 5. A new els loopback event is created.
  1792. * 6. The command and response iocbs are allocated.
  1793. * 7. The cmd iocb FsType is set to elx loopback and the CmdRsp to looppback.
  1794. *
  1795. * This function is meant to be called n times while the port is in loopback
  1796. * so it is the apps responsibility to issue a reset to take the port out
  1797. * of loopback mode.
  1798. **/
  1799. static int
  1800. lpfc_bsg_diag_test(struct fc_bsg_job *job)
  1801. {
  1802. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  1803. struct lpfc_hba *phba = vport->phba;
  1804. struct diag_mode_test *diag_mode;
  1805. struct lpfc_bsg_event *evt;
  1806. struct event_data *evdat;
  1807. struct lpfc_sli *psli = &phba->sli;
  1808. uint32_t size;
  1809. uint32_t full_size;
  1810. size_t segment_len = 0, segment_offset = 0, current_offset = 0;
  1811. uint16_t rpi;
  1812. struct lpfc_iocbq *cmdiocbq, *rspiocbq;
  1813. IOCB_t *cmd, *rsp;
  1814. struct lpfc_sli_ct_request *ctreq;
  1815. struct lpfc_dmabuf *txbmp;
  1816. struct ulp_bde64 *txbpl = NULL;
  1817. struct lpfc_dmabufext *txbuffer = NULL;
  1818. struct list_head head;
  1819. struct lpfc_dmabuf *curr;
  1820. uint16_t txxri, rxxri;
  1821. uint32_t num_bde;
  1822. uint8_t *ptr = NULL, *rx_databuf = NULL;
  1823. int rc = 0;
  1824. unsigned long flags;
  1825. void *dataout = NULL;
  1826. uint32_t total_mem;
  1827. /* in case no data is returned return just the return code */
  1828. job->reply->reply_payload_rcv_len = 0;
  1829. if (job->request_len <
  1830. sizeof(struct fc_bsg_request) + sizeof(struct diag_mode_test)) {
  1831. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  1832. "2739 Received DIAG TEST request below minimum "
  1833. "size\n");
  1834. rc = -EINVAL;
  1835. goto loopback_test_exit;
  1836. }
  1837. if (job->request_payload.payload_len !=
  1838. job->reply_payload.payload_len) {
  1839. rc = -EINVAL;
  1840. goto loopback_test_exit;
  1841. }
  1842. diag_mode = (struct diag_mode_test *)
  1843. job->request->rqst_data.h_vendor.vendor_cmd;
  1844. if ((phba->link_state == LPFC_HBA_ERROR) ||
  1845. (psli->sli_flag & LPFC_BLOCK_MGMT_IO) ||
  1846. (!(psli->sli_flag & LPFC_SLI_ACTIVE))) {
  1847. rc = -EACCES;
  1848. goto loopback_test_exit;
  1849. }
  1850. if (!lpfc_is_link_up(phba) || !(phba->link_flag & LS_LOOPBACK_MODE)) {
  1851. rc = -EACCES;
  1852. goto loopback_test_exit;
  1853. }
  1854. size = job->request_payload.payload_len;
  1855. full_size = size + ELX_LOOPBACK_HEADER_SZ; /* plus the header */
  1856. if ((size == 0) || (size > 80 * BUF_SZ_4K)) {
  1857. rc = -ERANGE;
  1858. goto loopback_test_exit;
  1859. }
  1860. if (size >= BUF_SZ_4K) {
  1861. /*
  1862. * Allocate memory for ioctl data. If buffer is bigger than 64k,
  1863. * then we allocate 64k and re-use that buffer over and over to
  1864. * xfer the whole block. This is because Linux kernel has a
  1865. * problem allocating more than 120k of kernel space memory. Saw
  1866. * problem with GET_FCPTARGETMAPPING...
  1867. */
  1868. if (size <= (64 * 1024))
  1869. total_mem = size;
  1870. else
  1871. total_mem = 64 * 1024;
  1872. } else
  1873. /* Allocate memory for ioctl data */
  1874. total_mem = BUF_SZ_4K;
  1875. dataout = kmalloc(total_mem, GFP_KERNEL);
  1876. if (dataout == NULL) {
  1877. rc = -ENOMEM;
  1878. goto loopback_test_exit;
  1879. }
  1880. ptr = dataout;
  1881. ptr += ELX_LOOPBACK_HEADER_SZ;
  1882. sg_copy_to_buffer(job->request_payload.sg_list,
  1883. job->request_payload.sg_cnt,
  1884. ptr, size);
  1885. rc = lpfcdiag_loop_self_reg(phba, &rpi);
  1886. if (rc) {
  1887. rc = -ENOMEM;
  1888. goto loopback_test_exit;
  1889. }
  1890. rc = lpfcdiag_loop_get_xri(phba, rpi, &txxri, &rxxri);
  1891. if (rc) {
  1892. lpfcdiag_loop_self_unreg(phba, rpi);
  1893. rc = -ENOMEM;
  1894. goto loopback_test_exit;
  1895. }
  1896. rc = lpfcdiag_loop_post_rxbufs(phba, rxxri, full_size);
  1897. if (rc) {
  1898. lpfcdiag_loop_self_unreg(phba, rpi);
  1899. rc = -ENOMEM;
  1900. goto loopback_test_exit;
  1901. }
  1902. evt = lpfc_bsg_event_new(FC_REG_CT_EVENT, current->pid,
  1903. SLI_CT_ELX_LOOPBACK);
  1904. if (!evt) {
  1905. lpfcdiag_loop_self_unreg(phba, rpi);
  1906. rc = -ENOMEM;
  1907. goto loopback_test_exit;
  1908. }
  1909. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1910. list_add(&evt->node, &phba->ct_ev_waiters);
  1911. lpfc_bsg_event_ref(evt);
  1912. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1913. cmdiocbq = lpfc_sli_get_iocbq(phba);
  1914. rspiocbq = lpfc_sli_get_iocbq(phba);
  1915. txbmp = kmalloc(sizeof(struct lpfc_dmabuf), GFP_KERNEL);
  1916. if (txbmp) {
  1917. txbmp->virt = lpfc_mbuf_alloc(phba, 0, &txbmp->phys);
  1918. INIT_LIST_HEAD(&txbmp->list);
  1919. txbpl = (struct ulp_bde64 *) txbmp->virt;
  1920. if (txbpl)
  1921. txbuffer = diag_cmd_data_alloc(phba,
  1922. txbpl, full_size, 0);
  1923. }
  1924. if (!cmdiocbq || !rspiocbq || !txbmp || !txbpl || !txbuffer) {
  1925. rc = -ENOMEM;
  1926. goto err_loopback_test_exit;
  1927. }
  1928. cmd = &cmdiocbq->iocb;
  1929. rsp = &rspiocbq->iocb;
  1930. INIT_LIST_HEAD(&head);
  1931. list_add_tail(&head, &txbuffer->dma.list);
  1932. list_for_each_entry(curr, &head, list) {
  1933. segment_len = ((struct lpfc_dmabufext *)curr)->size;
  1934. if (current_offset == 0) {
  1935. ctreq = curr->virt;
  1936. memset(ctreq, 0, ELX_LOOPBACK_HEADER_SZ);
  1937. ctreq->RevisionId.bits.Revision = SLI_CT_REVISION;
  1938. ctreq->RevisionId.bits.InId = 0;
  1939. ctreq->FsType = SLI_CT_ELX_LOOPBACK;
  1940. ctreq->FsSubType = 0;
  1941. ctreq->CommandResponse.bits.CmdRsp = ELX_LOOPBACK_DATA;
  1942. ctreq->CommandResponse.bits.Size = size;
  1943. segment_offset = ELX_LOOPBACK_HEADER_SZ;
  1944. } else
  1945. segment_offset = 0;
  1946. BUG_ON(segment_offset >= segment_len);
  1947. memcpy(curr->virt + segment_offset,
  1948. ptr + current_offset,
  1949. segment_len - segment_offset);
  1950. current_offset += segment_len - segment_offset;
  1951. BUG_ON(current_offset > size);
  1952. }
  1953. list_del(&head);
  1954. /* Build the XMIT_SEQUENCE iocb */
  1955. num_bde = (uint32_t)txbuffer->flag;
  1956. cmd->un.xseq64.bdl.addrHigh = putPaddrHigh(txbmp->phys);
  1957. cmd->un.xseq64.bdl.addrLow = putPaddrLow(txbmp->phys);
  1958. cmd->un.xseq64.bdl.bdeFlags = BUFF_TYPE_BLP_64;
  1959. cmd->un.xseq64.bdl.bdeSize = (num_bde * sizeof(struct ulp_bde64));
  1960. cmd->un.xseq64.w5.hcsw.Fctl = (LS | LA);
  1961. cmd->un.xseq64.w5.hcsw.Dfctl = 0;
  1962. cmd->un.xseq64.w5.hcsw.Rctl = FC_RCTL_DD_UNSOL_CTL;
  1963. cmd->un.xseq64.w5.hcsw.Type = FC_TYPE_CT;
  1964. cmd->ulpCommand = CMD_XMIT_SEQUENCE64_CX;
  1965. cmd->ulpBdeCount = 1;
  1966. cmd->ulpLe = 1;
  1967. cmd->ulpClass = CLASS3;
  1968. cmd->ulpContext = txxri;
  1969. cmdiocbq->iocb_flag |= LPFC_IO_LIBDFC;
  1970. cmdiocbq->vport = phba->pport;
  1971. rc = lpfc_sli_issue_iocb_wait(phba, LPFC_ELS_RING, cmdiocbq, rspiocbq,
  1972. (phba->fc_ratov * 2) + LPFC_DRVR_TIMEOUT);
  1973. if ((rc != IOCB_SUCCESS) || (rsp->ulpStatus != IOCB_SUCCESS)) {
  1974. rc = -EIO;
  1975. goto err_loopback_test_exit;
  1976. }
  1977. evt->waiting = 1;
  1978. rc = wait_event_interruptible_timeout(
  1979. evt->wq, !list_empty(&evt->events_to_see),
  1980. ((phba->fc_ratov * 2) + LPFC_DRVR_TIMEOUT) * HZ);
  1981. evt->waiting = 0;
  1982. if (list_empty(&evt->events_to_see))
  1983. rc = (rc) ? -EINTR : -ETIMEDOUT;
  1984. else {
  1985. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  1986. list_move(evt->events_to_see.prev, &evt->events_to_get);
  1987. evdat = list_entry(evt->events_to_get.prev,
  1988. typeof(*evdat), node);
  1989. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  1990. rx_databuf = evdat->data;
  1991. if (evdat->len != full_size) {
  1992. lpfc_printf_log(phba, KERN_ERR, LOG_LIBDFC,
  1993. "1603 Loopback test did not receive expected "
  1994. "data length. actual length 0x%x expected "
  1995. "length 0x%x\n",
  1996. evdat->len, full_size);
  1997. rc = -EIO;
  1998. } else if (rx_databuf == NULL)
  1999. rc = -EIO;
  2000. else {
  2001. rc = IOCB_SUCCESS;
  2002. /* skip over elx loopback header */
  2003. rx_databuf += ELX_LOOPBACK_HEADER_SZ;
  2004. job->reply->reply_payload_rcv_len =
  2005. sg_copy_from_buffer(job->reply_payload.sg_list,
  2006. job->reply_payload.sg_cnt,
  2007. rx_databuf, size);
  2008. job->reply->reply_payload_rcv_len = size;
  2009. }
  2010. }
  2011. err_loopback_test_exit:
  2012. lpfcdiag_loop_self_unreg(phba, rpi);
  2013. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  2014. lpfc_bsg_event_unref(evt); /* release ref */
  2015. lpfc_bsg_event_unref(evt); /* delete */
  2016. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2017. if (cmdiocbq != NULL)
  2018. lpfc_sli_release_iocbq(phba, cmdiocbq);
  2019. if (rspiocbq != NULL)
  2020. lpfc_sli_release_iocbq(phba, rspiocbq);
  2021. if (txbmp != NULL) {
  2022. if (txbpl != NULL) {
  2023. if (txbuffer != NULL)
  2024. diag_cmd_data_free(phba, txbuffer);
  2025. lpfc_mbuf_free(phba, txbmp->virt, txbmp->phys);
  2026. }
  2027. kfree(txbmp);
  2028. }
  2029. loopback_test_exit:
  2030. kfree(dataout);
  2031. /* make error code available to userspace */
  2032. job->reply->result = rc;
  2033. job->dd_data = NULL;
  2034. /* complete the job back to userspace if no error */
  2035. if (rc == 0)
  2036. job->job_done(job);
  2037. return rc;
  2038. }
  2039. /**
  2040. * lpfc_bsg_get_dfc_rev - process a GET_DFC_REV bsg vendor command
  2041. * @job: GET_DFC_REV fc_bsg_job
  2042. **/
  2043. static int
  2044. lpfc_bsg_get_dfc_rev(struct fc_bsg_job *job)
  2045. {
  2046. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  2047. struct lpfc_hba *phba = vport->phba;
  2048. struct get_mgmt_rev *event_req;
  2049. struct get_mgmt_rev_reply *event_reply;
  2050. int rc = 0;
  2051. if (job->request_len <
  2052. sizeof(struct fc_bsg_request) + sizeof(struct get_mgmt_rev)) {
  2053. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2054. "2740 Received GET_DFC_REV request below "
  2055. "minimum size\n");
  2056. rc = -EINVAL;
  2057. goto job_error;
  2058. }
  2059. event_req = (struct get_mgmt_rev *)
  2060. job->request->rqst_data.h_vendor.vendor_cmd;
  2061. event_reply = (struct get_mgmt_rev_reply *)
  2062. job->reply->reply_data.vendor_reply.vendor_rsp;
  2063. if (job->reply_len <
  2064. sizeof(struct fc_bsg_request) + sizeof(struct get_mgmt_rev_reply)) {
  2065. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2066. "2741 Received GET_DFC_REV reply below "
  2067. "minimum size\n");
  2068. rc = -EINVAL;
  2069. goto job_error;
  2070. }
  2071. event_reply->info.a_Major = MANAGEMENT_MAJOR_REV;
  2072. event_reply->info.a_Minor = MANAGEMENT_MINOR_REV;
  2073. job_error:
  2074. job->reply->result = rc;
  2075. if (rc == 0)
  2076. job->job_done(job);
  2077. return rc;
  2078. }
  2079. /**
  2080. * lpfc_bsg_wake_mbox_wait - lpfc_bsg_issue_mbox mbox completion handler
  2081. * @phba: Pointer to HBA context object.
  2082. * @pmboxq: Pointer to mailbox command.
  2083. *
  2084. * This is completion handler function for mailbox commands issued from
  2085. * lpfc_bsg_issue_mbox function. This function is called by the
  2086. * mailbox event handler function with no lock held. This function
  2087. * will wake up thread waiting on the wait queue pointed by context1
  2088. * of the mailbox.
  2089. **/
  2090. void
  2091. lpfc_bsg_wake_mbox_wait(struct lpfc_hba *phba, LPFC_MBOXQ_t *pmboxq)
  2092. {
  2093. struct bsg_job_data *dd_data;
  2094. MAILBOX_t *pmb;
  2095. MAILBOX_t *mb;
  2096. struct fc_bsg_job *job;
  2097. uint32_t size;
  2098. unsigned long flags;
  2099. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  2100. dd_data = pmboxq->context1;
  2101. if (!dd_data) {
  2102. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2103. return;
  2104. }
  2105. pmb = &dd_data->context_un.mbox.pmboxq->u.mb;
  2106. mb = dd_data->context_un.mbox.mb;
  2107. job = dd_data->context_un.mbox.set_job;
  2108. memcpy(mb, pmb, sizeof(*pmb));
  2109. size = job->request_payload.payload_len;
  2110. job->reply->reply_payload_rcv_len =
  2111. sg_copy_from_buffer(job->reply_payload.sg_list,
  2112. job->reply_payload.sg_cnt,
  2113. mb, size);
  2114. job->reply->result = 0;
  2115. dd_data->context_un.mbox.set_job = NULL;
  2116. job->dd_data = NULL;
  2117. job->job_done(job);
  2118. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2119. mempool_free(dd_data->context_un.mbox.pmboxq, phba->mbox_mem_pool);
  2120. kfree(mb);
  2121. kfree(dd_data);
  2122. return;
  2123. }
  2124. /**
  2125. * lpfc_bsg_check_cmd_access - test for a supported mailbox command
  2126. * @phba: Pointer to HBA context object.
  2127. * @mb: Pointer to a mailbox object.
  2128. * @vport: Pointer to a vport object.
  2129. *
  2130. * Some commands require the port to be offline, some may not be called from
  2131. * the application.
  2132. **/
  2133. static int lpfc_bsg_check_cmd_access(struct lpfc_hba *phba,
  2134. MAILBOX_t *mb, struct lpfc_vport *vport)
  2135. {
  2136. /* return negative error values for bsg job */
  2137. switch (mb->mbxCommand) {
  2138. /* Offline only */
  2139. case MBX_INIT_LINK:
  2140. case MBX_DOWN_LINK:
  2141. case MBX_CONFIG_LINK:
  2142. case MBX_CONFIG_RING:
  2143. case MBX_RESET_RING:
  2144. case MBX_UNREG_LOGIN:
  2145. case MBX_CLEAR_LA:
  2146. case MBX_DUMP_CONTEXT:
  2147. case MBX_RUN_DIAGS:
  2148. case MBX_RESTART:
  2149. case MBX_SET_MASK:
  2150. if (!(vport->fc_flag & FC_OFFLINE_MODE)) {
  2151. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2152. "2743 Command 0x%x is illegal in on-line "
  2153. "state\n",
  2154. mb->mbxCommand);
  2155. return -EPERM;
  2156. }
  2157. case MBX_WRITE_NV:
  2158. case MBX_WRITE_VPARMS:
  2159. case MBX_LOAD_SM:
  2160. case MBX_READ_NV:
  2161. case MBX_READ_CONFIG:
  2162. case MBX_READ_RCONFIG:
  2163. case MBX_READ_STATUS:
  2164. case MBX_READ_XRI:
  2165. case MBX_READ_REV:
  2166. case MBX_READ_LNK_STAT:
  2167. case MBX_DUMP_MEMORY:
  2168. case MBX_DOWN_LOAD:
  2169. case MBX_UPDATE_CFG:
  2170. case MBX_KILL_BOARD:
  2171. case MBX_LOAD_AREA:
  2172. case MBX_LOAD_EXP_ROM:
  2173. case MBX_BEACON:
  2174. case MBX_DEL_LD_ENTRY:
  2175. case MBX_SET_DEBUG:
  2176. case MBX_WRITE_WWN:
  2177. case MBX_SLI4_CONFIG:
  2178. case MBX_READ_EVENT_LOG_STATUS:
  2179. case MBX_WRITE_EVENT_LOG:
  2180. case MBX_PORT_CAPABILITIES:
  2181. case MBX_PORT_IOV_CONTROL:
  2182. break;
  2183. case MBX_SET_VARIABLE:
  2184. lpfc_printf_log(phba, KERN_INFO, LOG_INIT,
  2185. "1226 mbox: set_variable 0x%x, 0x%x\n",
  2186. mb->un.varWords[0],
  2187. mb->un.varWords[1]);
  2188. if ((mb->un.varWords[0] == SETVAR_MLOMNT)
  2189. && (mb->un.varWords[1] == 1)) {
  2190. phba->wait_4_mlo_maint_flg = 1;
  2191. } else if (mb->un.varWords[0] == SETVAR_MLORST) {
  2192. phba->link_flag &= ~LS_LOOPBACK_MODE;
  2193. phba->fc_topology = TOPOLOGY_PT_PT;
  2194. }
  2195. break;
  2196. case MBX_RUN_BIU_DIAG64:
  2197. case MBX_READ_EVENT_LOG:
  2198. case MBX_READ_SPARM64:
  2199. case MBX_READ_LA:
  2200. case MBX_READ_LA64:
  2201. case MBX_REG_LOGIN:
  2202. case MBX_REG_LOGIN64:
  2203. case MBX_CONFIG_PORT:
  2204. case MBX_RUN_BIU_DIAG:
  2205. default:
  2206. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2207. "2742 Unknown Command 0x%x\n",
  2208. mb->mbxCommand);
  2209. return -EPERM;
  2210. }
  2211. return 0; /* ok */
  2212. }
  2213. /**
  2214. * lpfc_bsg_issue_mbox - issues a mailbox command on behalf of an app
  2215. * @phba: Pointer to HBA context object.
  2216. * @mb: Pointer to a mailbox object.
  2217. * @vport: Pointer to a vport object.
  2218. *
  2219. * Allocate a tracking object, mailbox command memory, get a mailbox
  2220. * from the mailbox pool, copy the caller mailbox command.
  2221. *
  2222. * If offline and the sli is active we need to poll for the command (port is
  2223. * being reset) and com-plete the job, otherwise issue the mailbox command and
  2224. * let our completion handler finish the command.
  2225. **/
  2226. static uint32_t
  2227. lpfc_bsg_issue_mbox(struct lpfc_hba *phba, struct fc_bsg_job *job,
  2228. struct lpfc_vport *vport)
  2229. {
  2230. LPFC_MBOXQ_t *pmboxq;
  2231. MAILBOX_t *pmb;
  2232. MAILBOX_t *mb;
  2233. struct bsg_job_data *dd_data;
  2234. uint32_t size;
  2235. int rc = 0;
  2236. /* allocate our bsg tracking structure */
  2237. dd_data = kmalloc(sizeof(struct bsg_job_data), GFP_KERNEL);
  2238. if (!dd_data) {
  2239. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2240. "2727 Failed allocation of dd_data\n");
  2241. return -ENOMEM;
  2242. }
  2243. mb = kzalloc(PAGE_SIZE, GFP_KERNEL);
  2244. if (!mb) {
  2245. kfree(dd_data);
  2246. return -ENOMEM;
  2247. }
  2248. pmboxq = mempool_alloc(phba->mbox_mem_pool, GFP_KERNEL);
  2249. if (!pmboxq) {
  2250. kfree(dd_data);
  2251. kfree(mb);
  2252. return -ENOMEM;
  2253. }
  2254. size = job->request_payload.payload_len;
  2255. job->reply->reply_payload_rcv_len =
  2256. sg_copy_to_buffer(job->request_payload.sg_list,
  2257. job->request_payload.sg_cnt,
  2258. mb, size);
  2259. rc = lpfc_bsg_check_cmd_access(phba, mb, vport);
  2260. if (rc != 0) {
  2261. kfree(dd_data);
  2262. kfree(mb);
  2263. mempool_free(pmboxq, phba->mbox_mem_pool);
  2264. return rc; /* must be negative */
  2265. }
  2266. memset(pmboxq, 0, sizeof(LPFC_MBOXQ_t));
  2267. pmb = &pmboxq->u.mb;
  2268. memcpy(pmb, mb, sizeof(*pmb));
  2269. pmb->mbxOwner = OWN_HOST;
  2270. pmboxq->context1 = NULL;
  2271. pmboxq->vport = vport;
  2272. if ((vport->fc_flag & FC_OFFLINE_MODE) ||
  2273. (!(phba->sli.sli_flag & LPFC_SLI_ACTIVE))) {
  2274. rc = lpfc_sli_issue_mbox(phba, pmboxq, MBX_POLL);
  2275. if (rc != MBX_SUCCESS) {
  2276. if (rc != MBX_TIMEOUT) {
  2277. kfree(dd_data);
  2278. kfree(mb);
  2279. mempool_free(pmboxq, phba->mbox_mem_pool);
  2280. }
  2281. return (rc == MBX_TIMEOUT) ? -ETIME : -ENODEV;
  2282. }
  2283. memcpy(mb, pmb, sizeof(*pmb));
  2284. job->reply->reply_payload_rcv_len =
  2285. sg_copy_from_buffer(job->reply_payload.sg_list,
  2286. job->reply_payload.sg_cnt,
  2287. mb, size);
  2288. kfree(dd_data);
  2289. kfree(mb);
  2290. mempool_free(pmboxq, phba->mbox_mem_pool);
  2291. /* not waiting mbox already done */
  2292. return 0;
  2293. }
  2294. /* setup wake call as IOCB callback */
  2295. pmboxq->mbox_cmpl = lpfc_bsg_wake_mbox_wait;
  2296. /* setup context field to pass wait_queue pointer to wake function */
  2297. pmboxq->context1 = dd_data;
  2298. dd_data->type = TYPE_MBOX;
  2299. dd_data->context_un.mbox.pmboxq = pmboxq;
  2300. dd_data->context_un.mbox.mb = mb;
  2301. dd_data->context_un.mbox.set_job = job;
  2302. job->dd_data = dd_data;
  2303. rc = lpfc_sli_issue_mbox(phba, pmboxq, MBX_NOWAIT);
  2304. if ((rc != MBX_SUCCESS) && (rc != MBX_BUSY)) {
  2305. kfree(dd_data);
  2306. kfree(mb);
  2307. mempool_free(pmboxq, phba->mbox_mem_pool);
  2308. return -EIO;
  2309. }
  2310. return 1;
  2311. }
  2312. /**
  2313. * lpfc_bsg_mbox_cmd - process an fc bsg LPFC_BSG_VENDOR_MBOX command
  2314. * @job: MBOX fc_bsg_job for LPFC_BSG_VENDOR_MBOX.
  2315. **/
  2316. static int
  2317. lpfc_bsg_mbox_cmd(struct fc_bsg_job *job)
  2318. {
  2319. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  2320. struct lpfc_hba *phba = vport->phba;
  2321. int rc = 0;
  2322. /* in case no data is transferred */
  2323. job->reply->reply_payload_rcv_len = 0;
  2324. if (job->request_len <
  2325. sizeof(struct fc_bsg_request) + sizeof(struct dfc_mbox_req)) {
  2326. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2327. "2737 Received MBOX_REQ request below "
  2328. "minimum size\n");
  2329. rc = -EINVAL;
  2330. goto job_error;
  2331. }
  2332. if (job->request_payload.payload_len != PAGE_SIZE) {
  2333. rc = -EINVAL;
  2334. goto job_error;
  2335. }
  2336. if (phba->sli.sli_flag & LPFC_BLOCK_MGMT_IO) {
  2337. rc = -EAGAIN;
  2338. goto job_error;
  2339. }
  2340. rc = lpfc_bsg_issue_mbox(phba, job, vport);
  2341. job_error:
  2342. if (rc == 0) {
  2343. /* job done */
  2344. job->reply->result = 0;
  2345. job->dd_data = NULL;
  2346. job->job_done(job);
  2347. } else if (rc == 1)
  2348. /* job submitted, will complete later*/
  2349. rc = 0; /* return zero, no error */
  2350. else {
  2351. /* some error occurred */
  2352. job->reply->result = rc;
  2353. job->dd_data = NULL;
  2354. }
  2355. return rc;
  2356. }
  2357. /**
  2358. * lpfc_bsg_menlo_cmd_cmp - lpfc_menlo_cmd completion handler
  2359. * @phba: Pointer to HBA context object.
  2360. * @cmdiocbq: Pointer to command iocb.
  2361. * @rspiocbq: Pointer to response iocb.
  2362. *
  2363. * This function is the completion handler for iocbs issued using
  2364. * lpfc_menlo_cmd function. This function is called by the
  2365. * ring event handler function without any lock held. This function
  2366. * can be called from both worker thread context and interrupt
  2367. * context. This function also can be called from another thread which
  2368. * cleans up the SLI layer objects.
  2369. * This function copies the contents of the response iocb to the
  2370. * response iocb memory object provided by the caller of
  2371. * lpfc_sli_issue_iocb_wait and then wakes up the thread which
  2372. * sleeps for the iocb completion.
  2373. **/
  2374. static void
  2375. lpfc_bsg_menlo_cmd_cmp(struct lpfc_hba *phba,
  2376. struct lpfc_iocbq *cmdiocbq,
  2377. struct lpfc_iocbq *rspiocbq)
  2378. {
  2379. struct bsg_job_data *dd_data;
  2380. struct fc_bsg_job *job;
  2381. IOCB_t *rsp;
  2382. struct lpfc_dmabuf *bmp;
  2383. struct lpfc_bsg_menlo *menlo;
  2384. unsigned long flags;
  2385. struct menlo_response *menlo_resp;
  2386. int rc = 0;
  2387. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  2388. dd_data = cmdiocbq->context1;
  2389. if (!dd_data) {
  2390. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2391. return;
  2392. }
  2393. menlo = &dd_data->context_un.menlo;
  2394. job = menlo->set_job;
  2395. job->dd_data = NULL; /* so timeout handler does not reply */
  2396. spin_lock_irqsave(&phba->hbalock, flags);
  2397. cmdiocbq->iocb_flag |= LPFC_IO_WAKE;
  2398. if (cmdiocbq->context2 && rspiocbq)
  2399. memcpy(&((struct lpfc_iocbq *)cmdiocbq->context2)->iocb,
  2400. &rspiocbq->iocb, sizeof(IOCB_t));
  2401. spin_unlock_irqrestore(&phba->hbalock, flags);
  2402. bmp = menlo->bmp;
  2403. rspiocbq = menlo->rspiocbq;
  2404. rsp = &rspiocbq->iocb;
  2405. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  2406. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  2407. pci_unmap_sg(phba->pcidev, job->reply_payload.sg_list,
  2408. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  2409. /* always return the xri, this would be used in the case
  2410. * of a menlo download to allow the data to be sent as a continuation
  2411. * of the exchange.
  2412. */
  2413. menlo_resp = (struct menlo_response *)
  2414. job->reply->reply_data.vendor_reply.vendor_rsp;
  2415. menlo_resp->xri = rsp->ulpContext;
  2416. if (rsp->ulpStatus) {
  2417. if (rsp->ulpStatus == IOSTAT_LOCAL_REJECT) {
  2418. switch (rsp->un.ulpWord[4] & 0xff) {
  2419. case IOERR_SEQUENCE_TIMEOUT:
  2420. rc = -ETIMEDOUT;
  2421. break;
  2422. case IOERR_INVALID_RPI:
  2423. rc = -EFAULT;
  2424. break;
  2425. default:
  2426. rc = -EACCES;
  2427. break;
  2428. }
  2429. } else
  2430. rc = -EACCES;
  2431. } else
  2432. job->reply->reply_payload_rcv_len =
  2433. rsp->un.genreq64.bdl.bdeSize;
  2434. lpfc_mbuf_free(phba, bmp->virt, bmp->phys);
  2435. lpfc_sli_release_iocbq(phba, rspiocbq);
  2436. lpfc_sli_release_iocbq(phba, cmdiocbq);
  2437. kfree(bmp);
  2438. kfree(dd_data);
  2439. /* make error code available to userspace */
  2440. job->reply->result = rc;
  2441. /* complete the job back to userspace */
  2442. job->job_done(job);
  2443. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2444. return;
  2445. }
  2446. /**
  2447. * lpfc_menlo_cmd - send an ioctl for menlo hardware
  2448. * @job: fc_bsg_job to handle
  2449. *
  2450. * This function issues a gen request 64 CR ioctl for all menlo cmd requests,
  2451. * all the command completions will return the xri for the command.
  2452. * For menlo data requests a gen request 64 CX is used to continue the exchange
  2453. * supplied in the menlo request header xri field.
  2454. **/
  2455. static int
  2456. lpfc_menlo_cmd(struct fc_bsg_job *job)
  2457. {
  2458. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  2459. struct lpfc_hba *phba = vport->phba;
  2460. struct lpfc_iocbq *cmdiocbq, *rspiocbq;
  2461. IOCB_t *cmd, *rsp;
  2462. int rc = 0;
  2463. struct menlo_command *menlo_cmd;
  2464. struct menlo_response *menlo_resp;
  2465. struct lpfc_dmabuf *bmp = NULL;
  2466. int request_nseg;
  2467. int reply_nseg;
  2468. struct scatterlist *sgel = NULL;
  2469. int numbde;
  2470. dma_addr_t busaddr;
  2471. struct bsg_job_data *dd_data;
  2472. struct ulp_bde64 *bpl = NULL;
  2473. /* in case no data is returned return just the return code */
  2474. job->reply->reply_payload_rcv_len = 0;
  2475. if (job->request_len <
  2476. sizeof(struct fc_bsg_request) +
  2477. sizeof(struct menlo_command)) {
  2478. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2479. "2784 Received MENLO_CMD request below "
  2480. "minimum size\n");
  2481. rc = -ERANGE;
  2482. goto no_dd_data;
  2483. }
  2484. if (job->reply_len <
  2485. sizeof(struct fc_bsg_request) + sizeof(struct menlo_response)) {
  2486. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2487. "2785 Received MENLO_CMD reply below "
  2488. "minimum size\n");
  2489. rc = -ERANGE;
  2490. goto no_dd_data;
  2491. }
  2492. if (!(phba->menlo_flag & HBA_MENLO_SUPPORT)) {
  2493. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2494. "2786 Adapter does not support menlo "
  2495. "commands\n");
  2496. rc = -EPERM;
  2497. goto no_dd_data;
  2498. }
  2499. menlo_cmd = (struct menlo_command *)
  2500. job->request->rqst_data.h_vendor.vendor_cmd;
  2501. menlo_resp = (struct menlo_response *)
  2502. job->reply->reply_data.vendor_reply.vendor_rsp;
  2503. /* allocate our bsg tracking structure */
  2504. dd_data = kmalloc(sizeof(struct bsg_job_data), GFP_KERNEL);
  2505. if (!dd_data) {
  2506. lpfc_printf_log(phba, KERN_WARNING, LOG_LIBDFC,
  2507. "2787 Failed allocation of dd_data\n");
  2508. rc = -ENOMEM;
  2509. goto no_dd_data;
  2510. }
  2511. bmp = kmalloc(sizeof(struct lpfc_dmabuf), GFP_KERNEL);
  2512. if (!bmp) {
  2513. rc = -ENOMEM;
  2514. goto free_dd;
  2515. }
  2516. cmdiocbq = lpfc_sli_get_iocbq(phba);
  2517. if (!cmdiocbq) {
  2518. rc = -ENOMEM;
  2519. goto free_bmp;
  2520. }
  2521. rspiocbq = lpfc_sli_get_iocbq(phba);
  2522. if (!rspiocbq) {
  2523. rc = -ENOMEM;
  2524. goto free_cmdiocbq;
  2525. }
  2526. rsp = &rspiocbq->iocb;
  2527. bmp->virt = lpfc_mbuf_alloc(phba, 0, &bmp->phys);
  2528. if (!bmp->virt) {
  2529. rc = -ENOMEM;
  2530. goto free_rspiocbq;
  2531. }
  2532. INIT_LIST_HEAD(&bmp->list);
  2533. bpl = (struct ulp_bde64 *) bmp->virt;
  2534. request_nseg = pci_map_sg(phba->pcidev, job->request_payload.sg_list,
  2535. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  2536. for_each_sg(job->request_payload.sg_list, sgel, request_nseg, numbde) {
  2537. busaddr = sg_dma_address(sgel);
  2538. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64;
  2539. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  2540. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  2541. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  2542. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  2543. bpl++;
  2544. }
  2545. reply_nseg = pci_map_sg(phba->pcidev, job->reply_payload.sg_list,
  2546. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  2547. for_each_sg(job->reply_payload.sg_list, sgel, reply_nseg, numbde) {
  2548. busaddr = sg_dma_address(sgel);
  2549. bpl->tus.f.bdeFlags = BUFF_TYPE_BDE_64I;
  2550. bpl->tus.f.bdeSize = sg_dma_len(sgel);
  2551. bpl->tus.w = cpu_to_le32(bpl->tus.w);
  2552. bpl->addrLow = cpu_to_le32(putPaddrLow(busaddr));
  2553. bpl->addrHigh = cpu_to_le32(putPaddrHigh(busaddr));
  2554. bpl++;
  2555. }
  2556. cmd = &cmdiocbq->iocb;
  2557. cmd->un.genreq64.bdl.ulpIoTag32 = 0;
  2558. cmd->un.genreq64.bdl.addrHigh = putPaddrHigh(bmp->phys);
  2559. cmd->un.genreq64.bdl.addrLow = putPaddrLow(bmp->phys);
  2560. cmd->un.genreq64.bdl.bdeFlags = BUFF_TYPE_BLP_64;
  2561. cmd->un.genreq64.bdl.bdeSize =
  2562. (request_nseg + reply_nseg) * sizeof(struct ulp_bde64);
  2563. cmd->un.genreq64.w5.hcsw.Fctl = (SI | LA);
  2564. cmd->un.genreq64.w5.hcsw.Dfctl = 0;
  2565. cmd->un.genreq64.w5.hcsw.Rctl = FC_RCTL_DD_UNSOL_CMD;
  2566. cmd->un.genreq64.w5.hcsw.Type = MENLO_TRANSPORT_TYPE; /* 0xfe */
  2567. cmd->ulpBdeCount = 1;
  2568. cmd->ulpClass = CLASS3;
  2569. cmd->ulpOwner = OWN_CHIP;
  2570. cmd->ulpLe = 1; /* Limited Edition */
  2571. cmdiocbq->iocb_flag |= LPFC_IO_LIBDFC;
  2572. cmdiocbq->vport = phba->pport;
  2573. /* We want the firmware to timeout before we do */
  2574. cmd->ulpTimeout = MENLO_TIMEOUT - 5;
  2575. cmdiocbq->context3 = bmp;
  2576. cmdiocbq->context2 = rspiocbq;
  2577. cmdiocbq->iocb_cmpl = lpfc_bsg_menlo_cmd_cmp;
  2578. cmdiocbq->context1 = dd_data;
  2579. cmdiocbq->context2 = rspiocbq;
  2580. if (menlo_cmd->cmd == LPFC_BSG_VENDOR_MENLO_CMD) {
  2581. cmd->ulpCommand = CMD_GEN_REQUEST64_CR;
  2582. cmd->ulpPU = MENLO_PU; /* 3 */
  2583. cmd->un.ulpWord[4] = MENLO_DID; /* 0x0000FC0E */
  2584. cmd->ulpContext = MENLO_CONTEXT; /* 0 */
  2585. } else {
  2586. cmd->ulpCommand = CMD_GEN_REQUEST64_CX;
  2587. cmd->ulpPU = 1;
  2588. cmd->un.ulpWord[4] = 0;
  2589. cmd->ulpContext = menlo_cmd->xri;
  2590. }
  2591. dd_data->type = TYPE_MENLO;
  2592. dd_data->context_un.menlo.cmdiocbq = cmdiocbq;
  2593. dd_data->context_un.menlo.rspiocbq = rspiocbq;
  2594. dd_data->context_un.menlo.set_job = job;
  2595. dd_data->context_un.menlo.bmp = bmp;
  2596. rc = lpfc_sli_issue_iocb(phba, LPFC_ELS_RING, cmdiocbq,
  2597. MENLO_TIMEOUT - 5);
  2598. if (rc == IOCB_SUCCESS)
  2599. return 0; /* done for now */
  2600. /* iocb failed so cleanup */
  2601. pci_unmap_sg(phba->pcidev, job->request_payload.sg_list,
  2602. job->request_payload.sg_cnt, DMA_TO_DEVICE);
  2603. pci_unmap_sg(phba->pcidev, job->reply_payload.sg_list,
  2604. job->reply_payload.sg_cnt, DMA_FROM_DEVICE);
  2605. lpfc_mbuf_free(phba, bmp->virt, bmp->phys);
  2606. free_rspiocbq:
  2607. lpfc_sli_release_iocbq(phba, rspiocbq);
  2608. free_cmdiocbq:
  2609. lpfc_sli_release_iocbq(phba, cmdiocbq);
  2610. free_bmp:
  2611. kfree(bmp);
  2612. free_dd:
  2613. kfree(dd_data);
  2614. no_dd_data:
  2615. /* make error code available to userspace */
  2616. job->reply->result = rc;
  2617. job->dd_data = NULL;
  2618. return rc;
  2619. }
  2620. /**
  2621. * lpfc_bsg_hst_vendor - process a vendor-specific fc_bsg_job
  2622. * @job: fc_bsg_job to handle
  2623. **/
  2624. static int
  2625. lpfc_bsg_hst_vendor(struct fc_bsg_job *job)
  2626. {
  2627. int command = job->request->rqst_data.h_vendor.vendor_cmd[0];
  2628. int rc;
  2629. switch (command) {
  2630. case LPFC_BSG_VENDOR_SET_CT_EVENT:
  2631. rc = lpfc_bsg_hba_set_event(job);
  2632. break;
  2633. case LPFC_BSG_VENDOR_GET_CT_EVENT:
  2634. rc = lpfc_bsg_hba_get_event(job);
  2635. break;
  2636. case LPFC_BSG_VENDOR_SEND_MGMT_RESP:
  2637. rc = lpfc_bsg_send_mgmt_rsp(job);
  2638. break;
  2639. case LPFC_BSG_VENDOR_DIAG_MODE:
  2640. rc = lpfc_bsg_diag_mode(job);
  2641. break;
  2642. case LPFC_BSG_VENDOR_DIAG_TEST:
  2643. rc = lpfc_bsg_diag_test(job);
  2644. break;
  2645. case LPFC_BSG_VENDOR_GET_MGMT_REV:
  2646. rc = lpfc_bsg_get_dfc_rev(job);
  2647. break;
  2648. case LPFC_BSG_VENDOR_MBOX:
  2649. rc = lpfc_bsg_mbox_cmd(job);
  2650. break;
  2651. case LPFC_BSG_VENDOR_MENLO_CMD:
  2652. case LPFC_BSG_VENDOR_MENLO_DATA:
  2653. rc = lpfc_menlo_cmd(job);
  2654. break;
  2655. default:
  2656. rc = -EINVAL;
  2657. job->reply->reply_payload_rcv_len = 0;
  2658. /* make error code available to userspace */
  2659. job->reply->result = rc;
  2660. break;
  2661. }
  2662. return rc;
  2663. }
  2664. /**
  2665. * lpfc_bsg_request - handle a bsg request from the FC transport
  2666. * @job: fc_bsg_job to handle
  2667. **/
  2668. int
  2669. lpfc_bsg_request(struct fc_bsg_job *job)
  2670. {
  2671. uint32_t msgcode;
  2672. int rc;
  2673. msgcode = job->request->msgcode;
  2674. switch (msgcode) {
  2675. case FC_BSG_HST_VENDOR:
  2676. rc = lpfc_bsg_hst_vendor(job);
  2677. break;
  2678. case FC_BSG_RPT_ELS:
  2679. rc = lpfc_bsg_rport_els(job);
  2680. break;
  2681. case FC_BSG_RPT_CT:
  2682. rc = lpfc_bsg_send_mgmt_cmd(job);
  2683. break;
  2684. default:
  2685. rc = -EINVAL;
  2686. job->reply->reply_payload_rcv_len = 0;
  2687. /* make error code available to userspace */
  2688. job->reply->result = rc;
  2689. break;
  2690. }
  2691. return rc;
  2692. }
  2693. /**
  2694. * lpfc_bsg_timeout - handle timeout of a bsg request from the FC transport
  2695. * @job: fc_bsg_job that has timed out
  2696. *
  2697. * This function just aborts the job's IOCB. The aborted IOCB will return to
  2698. * the waiting function which will handle passing the error back to userspace
  2699. **/
  2700. int
  2701. lpfc_bsg_timeout(struct fc_bsg_job *job)
  2702. {
  2703. struct lpfc_vport *vport = (struct lpfc_vport *)job->shost->hostdata;
  2704. struct lpfc_hba *phba = vport->phba;
  2705. struct lpfc_iocbq *cmdiocb;
  2706. struct lpfc_bsg_event *evt;
  2707. struct lpfc_bsg_iocb *iocb;
  2708. struct lpfc_bsg_mbox *mbox;
  2709. struct lpfc_bsg_menlo *menlo;
  2710. struct lpfc_sli_ring *pring = &phba->sli.ring[LPFC_ELS_RING];
  2711. struct bsg_job_data *dd_data;
  2712. unsigned long flags;
  2713. spin_lock_irqsave(&phba->ct_ev_lock, flags);
  2714. dd_data = (struct bsg_job_data *)job->dd_data;
  2715. /* timeout and completion crossed paths if no dd_data */
  2716. if (!dd_data) {
  2717. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2718. return 0;
  2719. }
  2720. switch (dd_data->type) {
  2721. case TYPE_IOCB:
  2722. iocb = &dd_data->context_un.iocb;
  2723. cmdiocb = iocb->cmdiocbq;
  2724. /* hint to completion handler that the job timed out */
  2725. job->reply->result = -EAGAIN;
  2726. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2727. /* this will call our completion handler */
  2728. spin_lock_irq(&phba->hbalock);
  2729. lpfc_sli_issue_abort_iotag(phba, pring, cmdiocb);
  2730. spin_unlock_irq(&phba->hbalock);
  2731. break;
  2732. case TYPE_EVT:
  2733. evt = dd_data->context_un.evt;
  2734. /* this event has no job anymore */
  2735. evt->set_job = NULL;
  2736. job->dd_data = NULL;
  2737. job->reply->reply_payload_rcv_len = 0;
  2738. /* Return -EAGAIN which is our way of signallying the
  2739. * app to retry.
  2740. */
  2741. job->reply->result = -EAGAIN;
  2742. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2743. job->job_done(job);
  2744. break;
  2745. case TYPE_MBOX:
  2746. mbox = &dd_data->context_un.mbox;
  2747. /* this mbox has no job anymore */
  2748. mbox->set_job = NULL;
  2749. job->dd_data = NULL;
  2750. job->reply->reply_payload_rcv_len = 0;
  2751. job->reply->result = -EAGAIN;
  2752. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2753. job->job_done(job);
  2754. break;
  2755. case TYPE_MENLO:
  2756. menlo = &dd_data->context_un.menlo;
  2757. cmdiocb = menlo->cmdiocbq;
  2758. /* hint to completion handler that the job timed out */
  2759. job->reply->result = -EAGAIN;
  2760. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2761. /* this will call our completion handler */
  2762. spin_lock_irq(&phba->hbalock);
  2763. lpfc_sli_issue_abort_iotag(phba, pring, cmdiocb);
  2764. spin_unlock_irq(&phba->hbalock);
  2765. break;
  2766. default:
  2767. spin_unlock_irqrestore(&phba->ct_ev_lock, flags);
  2768. break;
  2769. }
  2770. /* scsi transport fc fc_bsg_job_timeout expects a zero return code,
  2771. * otherwise an error message will be displayed on the console
  2772. * so always return success (zero)
  2773. */
  2774. return 0;
  2775. }