diff options
author | Jing Huang <huangj@brocade.com> | 2010-10-18 20:15:55 -0400 |
---|---|---|
committer | James Bottomley <James.Bottomley@suse.de> | 2010-10-25 17:26:57 -0400 |
commit | acdc79a60cb3cbbc9f07bb5032d890e9cf94f0ff (patch) | |
tree | cea700a23bf6e96e084bee54392b11bc4d307710 /drivers/scsi/bfa/bfa_fcpim.h | |
parent | e0a08a30c9451333c9c4a8981fbfccc80b87ce78 (diff) |
[SCSI] bfa: fix comments for header 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_fcpim.h')
-rw-r--r-- | drivers/scsi/bfa/bfa_fcpim.h | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/drivers/scsi/bfa/bfa_fcpim.h b/drivers/scsi/bfa/bfa_fcpim.h index 3bf343160aac..db53717eeb4b 100644 --- a/drivers/scsi/bfa/bfa_fcpim.h +++ b/drivers/scsi/bfa/bfa_fcpim.h | |||
@@ -104,7 +104,7 @@ struct bfa_fcpim_mod_s { | |||
104 | bfa_fcpim_profile_t profile_start; | 104 | bfa_fcpim_profile_t profile_start; |
105 | }; | 105 | }; |
106 | 106 | ||
107 | /** | 107 | /* |
108 | * BFA IO (initiator mode) | 108 | * BFA IO (initiator mode) |
109 | */ | 109 | */ |
110 | struct bfa_ioim_s { | 110 | struct bfa_ioim_s { |
@@ -137,7 +137,7 @@ struct bfa_ioim_sp_s { | |||
137 | struct bfa_tskim_s *tskim; /* Relevant TM cmd */ | 137 | struct bfa_tskim_s *tskim; /* Relevant TM cmd */ |
138 | }; | 138 | }; |
139 | 139 | ||
140 | /** | 140 | /* |
141 | * BFA Task management command (initiator mode) | 141 | * BFA Task management command (initiator mode) |
142 | */ | 142 | */ |
143 | struct bfa_tskim_s { | 143 | struct bfa_tskim_s { |
@@ -160,7 +160,7 @@ struct bfa_tskim_s { | |||
160 | }; | 160 | }; |
161 | 161 | ||
162 | 162 | ||
163 | /** | 163 | /* |
164 | * BFA i-t-n (initiator mode) | 164 | * BFA i-t-n (initiator mode) |
165 | */ | 165 | */ |
166 | struct bfa_itnim_s { | 166 | struct bfa_itnim_s { |
@@ -303,7 +303,7 @@ bfa_status_t bfa_itnim_get_ioprofile(struct bfa_itnim_s *itnim, | |||
303 | struct bfa_itnim_ioprofile_s *ioprofile); | 303 | struct bfa_itnim_ioprofile_s *ioprofile); |
304 | #define bfa_itnim_get_reqq(__ioim) (((struct bfa_ioim_s *)__ioim)->itnim->reqq) | 304 | #define bfa_itnim_get_reqq(__ioim) (((struct bfa_ioim_s *)__ioim)->itnim->reqq) |
305 | 305 | ||
306 | /** | 306 | /* |
307 | * BFA completion callback for bfa_itnim_online(). | 307 | * BFA completion callback for bfa_itnim_online(). |
308 | * | 308 | * |
309 | * @param[in] itnim FCS or driver itnim instance | 309 | * @param[in] itnim FCS or driver itnim instance |
@@ -312,7 +312,7 @@ bfa_status_t bfa_itnim_get_ioprofile(struct bfa_itnim_s *itnim, | |||
312 | */ | 312 | */ |
313 | void bfa_cb_itnim_online(void *itnim); | 313 | void bfa_cb_itnim_online(void *itnim); |
314 | 314 | ||
315 | /** | 315 | /* |
316 | * BFA completion callback for bfa_itnim_offline(). | 316 | * BFA completion callback for bfa_itnim_offline(). |
317 | * | 317 | * |
318 | * @param[in] itnim FCS or driver itnim instance | 318 | * @param[in] itnim FCS or driver itnim instance |
@@ -323,7 +323,7 @@ void bfa_cb_itnim_offline(void *itnim); | |||
323 | void bfa_cb_itnim_tov_begin(void *itnim); | 323 | void bfa_cb_itnim_tov_begin(void *itnim); |
324 | void bfa_cb_itnim_tov(void *itnim); | 324 | void bfa_cb_itnim_tov(void *itnim); |
325 | 325 | ||
326 | /** | 326 | /* |
327 | * BFA notification to FCS/driver for second level error recovery. | 327 | * BFA notification to FCS/driver for second level error recovery. |
328 | * | 328 | * |
329 | * Atleast one I/O request has timedout and target is unresponsive to | 329 | * Atleast one I/O request has timedout and target is unresponsive to |
@@ -351,7 +351,7 @@ void bfa_ioim_delayed_comp(struct bfa_ioim_s *ioim, | |||
351 | bfa_boolean_t iotov); | 351 | bfa_boolean_t iotov); |
352 | 352 | ||
353 | 353 | ||
354 | /** | 354 | /* |
355 | * I/O completion notification. | 355 | * I/O completion notification. |
356 | * | 356 | * |
357 | * @param[in] dio driver IO structure | 357 | * @param[in] dio driver IO structure |
@@ -368,7 +368,7 @@ void bfa_cb_ioim_done(void *bfad, struct bfad_ioim_s *dio, | |||
368 | u8 scsi_status, int sns_len, | 368 | u8 scsi_status, int sns_len, |
369 | u8 *sns_info, s32 residue); | 369 | u8 *sns_info, s32 residue); |
370 | 370 | ||
371 | /** | 371 | /* |
372 | * I/O good completion notification. | 372 | * I/O good completion notification. |
373 | * | 373 | * |
374 | * @param[in] dio driver IO structure | 374 | * @param[in] dio driver IO structure |
@@ -377,7 +377,7 @@ void bfa_cb_ioim_done(void *bfad, struct bfad_ioim_s *dio, | |||
377 | */ | 377 | */ |
378 | void bfa_cb_ioim_good_comp(void *bfad, struct bfad_ioim_s *dio); | 378 | void bfa_cb_ioim_good_comp(void *bfad, struct bfad_ioim_s *dio); |
379 | 379 | ||
380 | /** | 380 | /* |
381 | * I/O abort completion notification | 381 | * I/O abort completion notification |
382 | * | 382 | * |
383 | * @param[in] dio driver IO that was aborted | 383 | * @param[in] dio driver IO that was aborted |