diff options
author | Jing Huang <huangj@brocade.com> | 2010-10-18 20:17:23 -0400 |
---|---|---|
committer | James Bottomley <James.Bottomley@suse.de> | 2010-10-25 17:28:09 -0400 |
commit | 5fbe25c7a664601666895e8f95eaa59bd9741392 (patch) | |
tree | f2d452938ba5ba924d0e8cc4f173f963df13018e /drivers/scsi/bfa/bfa_ioc_cb.c | |
parent | acdc79a60cb3cbbc9f07bb5032d890e9cf94f0ff (diff) |
[SCSI] bfa: fix comments for c files
This patch addresses the comments from Randy Dunlap (Randy.Dunlap@oracle.com)
regarding comment blocks that begining with "/**". bfa driver comments
currently do not follow kernel-doc convention, we hence replace all
/** with /* and **/ with */.
Signed-off-by: Jing Huang <huangj@brocade.com>
Signed-off-by: James Bottomley <James.Bottomley@suse.de>
Diffstat (limited to 'drivers/scsi/bfa/bfa_ioc_cb.c')
-rw-r--r-- | drivers/scsi/bfa/bfa_ioc_cb.c | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/drivers/scsi/bfa/bfa_ioc_cb.c b/drivers/scsi/bfa/bfa_ioc_cb.c index 86210a5f7249..909945043850 100644 --- a/drivers/scsi/bfa/bfa_ioc_cb.c +++ b/drivers/scsi/bfa/bfa_ioc_cb.c | |||
@@ -34,7 +34,7 @@ static void bfa_ioc_cb_ownership_reset(struct bfa_ioc_s *ioc); | |||
34 | 34 | ||
35 | struct bfa_ioc_hwif_s hwif_cb; | 35 | struct bfa_ioc_hwif_s hwif_cb; |
36 | 36 | ||
37 | /** | 37 | /* |
38 | * Called from bfa_ioc_attach() to map asic specific calls. | 38 | * Called from bfa_ioc_attach() to map asic specific calls. |
39 | */ | 39 | */ |
40 | void | 40 | void |
@@ -52,7 +52,7 @@ bfa_ioc_set_cb_hwif(struct bfa_ioc_s *ioc) | |||
52 | ioc->ioc_hwif = &hwif_cb; | 52 | ioc->ioc_hwif = &hwif_cb; |
53 | } | 53 | } |
54 | 54 | ||
55 | /** | 55 | /* |
56 | * Return true if firmware of current driver matches the running firmware. | 56 | * Return true if firmware of current driver matches the running firmware. |
57 | */ | 57 | */ |
58 | static bfa_boolean_t | 58 | static bfa_boolean_t |
@@ -66,7 +66,7 @@ bfa_ioc_cb_firmware_unlock(struct bfa_ioc_s *ioc) | |||
66 | { | 66 | { |
67 | } | 67 | } |
68 | 68 | ||
69 | /** | 69 | /* |
70 | * Notify other functions on HB failure. | 70 | * Notify other functions on HB failure. |
71 | */ | 71 | */ |
72 | static void | 72 | static void |
@@ -76,7 +76,7 @@ bfa_ioc_cb_notify_hbfail(struct bfa_ioc_s *ioc) | |||
76 | readl(ioc->ioc_regs.err_set); | 76 | readl(ioc->ioc_regs.err_set); |
77 | } | 77 | } |
78 | 78 | ||
79 | /** | 79 | /* |
80 | * Host to LPU mailbox message addresses | 80 | * Host to LPU mailbox message addresses |
81 | */ | 81 | */ |
82 | static struct { u32 hfn_mbox, lpu_mbox, hfn_pgn; } iocreg_fnreg[] = { | 82 | static struct { u32 hfn_mbox, lpu_mbox, hfn_pgn; } iocreg_fnreg[] = { |
@@ -84,7 +84,7 @@ static struct { u32 hfn_mbox, lpu_mbox, hfn_pgn; } iocreg_fnreg[] = { | |||
84 | { HOSTFN1_LPU_MBOX0_8, LPU_HOSTFN1_MBOX0_8, HOST_PAGE_NUM_FN1 } | 84 | { HOSTFN1_LPU_MBOX0_8, LPU_HOSTFN1_MBOX0_8, HOST_PAGE_NUM_FN1 } |
85 | }; | 85 | }; |
86 | 86 | ||
87 | /** | 87 | /* |
88 | * Host <-> LPU mailbox command/status registers | 88 | * Host <-> LPU mailbox command/status registers |
89 | */ | 89 | */ |
90 | static struct { u32 hfn, lpu; } iocreg_mbcmd[] = { | 90 | static struct { u32 hfn, lpu; } iocreg_mbcmd[] = { |
@@ -113,7 +113,7 @@ bfa_ioc_cb_reg_init(struct bfa_ioc_s *ioc) | |||
113 | ioc->ioc_regs.ioc_fwstate = (rb + BFA_IOC1_STATE_REG); | 113 | ioc->ioc_regs.ioc_fwstate = (rb + BFA_IOC1_STATE_REG); |
114 | } | 114 | } |
115 | 115 | ||
116 | /** | 116 | /* |
117 | * Host <-> LPU mailbox command/status registers | 117 | * Host <-> LPU mailbox command/status registers |
118 | */ | 118 | */ |
119 | ioc->ioc_regs.hfn_mbox_cmd = rb + iocreg_mbcmd[pcifn].hfn; | 119 | ioc->ioc_regs.hfn_mbox_cmd = rb + iocreg_mbcmd[pcifn].hfn; |
@@ -133,7 +133,7 @@ bfa_ioc_cb_reg_init(struct bfa_ioc_s *ioc) | |||
133 | ioc->ioc_regs.ioc_sem_reg = (rb + HOST_SEM0_REG); | 133 | ioc->ioc_regs.ioc_sem_reg = (rb + HOST_SEM0_REG); |
134 | ioc->ioc_regs.ioc_init_sem_reg = (rb + HOST_SEM2_REG); | 134 | ioc->ioc_regs.ioc_init_sem_reg = (rb + HOST_SEM2_REG); |
135 | 135 | ||
136 | /** | 136 | /* |
137 | * sram memory access | 137 | * sram memory access |
138 | */ | 138 | */ |
139 | ioc->ioc_regs.smem_page_start = (rb + PSS_SMEM_PAGE_START); | 139 | ioc->ioc_regs.smem_page_start = (rb + PSS_SMEM_PAGE_START); |
@@ -145,14 +145,14 @@ bfa_ioc_cb_reg_init(struct bfa_ioc_s *ioc) | |||
145 | ioc->ioc_regs.err_set = (rb + ERR_SET_REG); | 145 | ioc->ioc_regs.err_set = (rb + ERR_SET_REG); |
146 | } | 146 | } |
147 | 147 | ||
148 | /** | 148 | /* |
149 | * Initialize IOC to port mapping. | 149 | * Initialize IOC to port mapping. |
150 | */ | 150 | */ |
151 | 151 | ||
152 | static void | 152 | static void |
153 | bfa_ioc_cb_map_port(struct bfa_ioc_s *ioc) | 153 | bfa_ioc_cb_map_port(struct bfa_ioc_s *ioc) |
154 | { | 154 | { |
155 | /** | 155 | /* |
156 | * For crossbow, port id is same as pci function. | 156 | * For crossbow, port id is same as pci function. |
157 | */ | 157 | */ |
158 | ioc->port_id = bfa_ioc_pcifn(ioc); | 158 | ioc->port_id = bfa_ioc_pcifn(ioc); |
@@ -160,7 +160,7 @@ bfa_ioc_cb_map_port(struct bfa_ioc_s *ioc) | |||
160 | bfa_trc(ioc, ioc->port_id); | 160 | bfa_trc(ioc, ioc->port_id); |
161 | } | 161 | } |
162 | 162 | ||
163 | /** | 163 | /* |
164 | * Set interrupt mode for a function: INTX or MSIX | 164 | * Set interrupt mode for a function: INTX or MSIX |
165 | */ | 165 | */ |
166 | static void | 166 | static void |
@@ -168,7 +168,7 @@ bfa_ioc_cb_isr_mode_set(struct bfa_ioc_s *ioc, bfa_boolean_t msix) | |||
168 | { | 168 | { |
169 | } | 169 | } |
170 | 170 | ||
171 | /** | 171 | /* |
172 | * Cleanup hw semaphore and usecnt registers | 172 | * Cleanup hw semaphore and usecnt registers |
173 | */ | 173 | */ |
174 | static void | 174 | static void |