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/bfad_im.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/bfad_im.c')
-rw-r--r-- | drivers/scsi/bfa/bfad_im.c | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/drivers/scsi/bfa/bfad_im.c b/drivers/scsi/bfa/bfad_im.c index 7a6f48b277c2..8daa716739d1 100644 --- a/drivers/scsi/bfa/bfad_im.c +++ b/drivers/scsi/bfa/bfad_im.c | |||
@@ -15,7 +15,7 @@ | |||
15 | * General Public License for more details. | 15 | * General Public License for more details. |
16 | */ | 16 | */ |
17 | 17 | ||
18 | /** | 18 | /* |
19 | * bfad_im.c Linux driver IM module. | 19 | * bfad_im.c Linux driver IM module. |
20 | */ | 20 | */ |
21 | 21 | ||
@@ -164,10 +164,10 @@ bfa_cb_tskim_done(void *bfad, struct bfad_tskim_s *dtsk, | |||
164 | wake_up(wq); | 164 | wake_up(wq); |
165 | } | 165 | } |
166 | 166 | ||
167 | /** | 167 | /* |
168 | * Scsi_Host_template SCSI host template | 168 | * Scsi_Host_template SCSI host template |
169 | */ | 169 | */ |
170 | /** | 170 | /* |
171 | * Scsi_Host template entry, returns BFAD PCI info. | 171 | * Scsi_Host template entry, returns BFAD PCI info. |
172 | */ | 172 | */ |
173 | static const char * | 173 | static const char * |
@@ -196,7 +196,7 @@ bfad_im_info(struct Scsi_Host *shost) | |||
196 | return bfa_buf; | 196 | return bfa_buf; |
197 | } | 197 | } |
198 | 198 | ||
199 | /** | 199 | /* |
200 | * Scsi_Host template entry, aborts the specified SCSI command. | 200 | * Scsi_Host template entry, aborts the specified SCSI command. |
201 | * | 201 | * |
202 | * Returns: SUCCESS or FAILED. | 202 | * Returns: SUCCESS or FAILED. |
@@ -280,7 +280,7 @@ out: | |||
280 | return rc; | 280 | return rc; |
281 | } | 281 | } |
282 | 282 | ||
283 | /** | 283 | /* |
284 | * Scsi_Host template entry, resets a LUN and abort its all commands. | 284 | * Scsi_Host template entry, resets a LUN and abort its all commands. |
285 | * | 285 | * |
286 | * Returns: SUCCESS or FAILED. | 286 | * Returns: SUCCESS or FAILED. |
@@ -319,7 +319,7 @@ bfad_im_reset_lun_handler(struct scsi_cmnd *cmnd) | |||
319 | goto out; | 319 | goto out; |
320 | } | 320 | } |
321 | 321 | ||
322 | /** | 322 | /* |
323 | * Set host_scribble to NULL to avoid aborting a task command | 323 | * Set host_scribble to NULL to avoid aborting a task command |
324 | * if happens. | 324 | * if happens. |
325 | */ | 325 | */ |
@@ -346,7 +346,7 @@ out: | |||
346 | return rc; | 346 | return rc; |
347 | } | 347 | } |
348 | 348 | ||
349 | /** | 349 | /* |
350 | * Scsi_Host template entry, resets the bus and abort all commands. | 350 | * Scsi_Host template entry, resets the bus and abort all commands. |
351 | */ | 351 | */ |
352 | static int | 352 | static int |
@@ -396,7 +396,7 @@ bfad_im_reset_bus_handler(struct scsi_cmnd *cmnd) | |||
396 | return SUCCESS; | 396 | return SUCCESS; |
397 | } | 397 | } |
398 | 398 | ||
399 | /** | 399 | /* |
400 | * Scsi_Host template entry slave_destroy. | 400 | * Scsi_Host template entry slave_destroy. |
401 | */ | 401 | */ |
402 | static void | 402 | static void |
@@ -406,11 +406,11 @@ bfad_im_slave_destroy(struct scsi_device *sdev) | |||
406 | return; | 406 | return; |
407 | } | 407 | } |
408 | 408 | ||
409 | /** | 409 | /* |
410 | * BFA FCS itnim callbacks | 410 | * BFA FCS itnim callbacks |
411 | */ | 411 | */ |
412 | 412 | ||
413 | /** | 413 | /* |
414 | * BFA FCS itnim alloc callback, after successful PRLI | 414 | * BFA FCS itnim alloc callback, after successful PRLI |
415 | * Context: Interrupt | 415 | * Context: Interrupt |
416 | */ | 416 | */ |
@@ -433,7 +433,7 @@ bfa_fcb_itnim_alloc(struct bfad_s *bfad, struct bfa_fcs_itnim_s **itnim, | |||
433 | bfad->bfad_flags |= BFAD_RPORT_ONLINE; | 433 | bfad->bfad_flags |= BFAD_RPORT_ONLINE; |
434 | } | 434 | } |
435 | 435 | ||
436 | /** | 436 | /* |
437 | * BFA FCS itnim free callback. | 437 | * BFA FCS itnim free callback. |
438 | * Context: Interrupt. bfad_lock is held | 438 | * Context: Interrupt. bfad_lock is held |
439 | */ | 439 | */ |
@@ -471,7 +471,7 @@ bfa_fcb_itnim_free(struct bfad_s *bfad, struct bfad_itnim_s *itnim_drv) | |||
471 | queue_work(im->drv_workq, &itnim_drv->itnim_work); | 471 | queue_work(im->drv_workq, &itnim_drv->itnim_work); |
472 | } | 472 | } |
473 | 473 | ||
474 | /** | 474 | /* |
475 | * BFA FCS itnim online callback. | 475 | * BFA FCS itnim online callback. |
476 | * Context: Interrupt. bfad_lock is held | 476 | * Context: Interrupt. bfad_lock is held |
477 | */ | 477 | */ |
@@ -492,7 +492,7 @@ bfa_fcb_itnim_online(struct bfad_itnim_s *itnim_drv) | |||
492 | queue_work(im->drv_workq, &itnim_drv->itnim_work); | 492 | queue_work(im->drv_workq, &itnim_drv->itnim_work); |
493 | } | 493 | } |
494 | 494 | ||
495 | /** | 495 | /* |
496 | * BFA FCS itnim offline callback. | 496 | * BFA FCS itnim offline callback. |
497 | * Context: Interrupt. bfad_lock is held | 497 | * Context: Interrupt. bfad_lock is held |
498 | */ | 498 | */ |
@@ -519,7 +519,7 @@ bfa_fcb_itnim_offline(struct bfad_itnim_s *itnim_drv) | |||
519 | queue_work(im->drv_workq, &itnim_drv->itnim_work); | 519 | queue_work(im->drv_workq, &itnim_drv->itnim_work); |
520 | } | 520 | } |
521 | 521 | ||
522 | /** | 522 | /* |
523 | * Allocate a Scsi_Host for a port. | 523 | * Allocate a Scsi_Host for a port. |
524 | */ | 524 | */ |
525 | int | 525 | int |
@@ -751,7 +751,7 @@ bfad_os_thread_workq(struct bfad_s *bfad) | |||
751 | return BFA_STATUS_OK; | 751 | return BFA_STATUS_OK; |
752 | } | 752 | } |
753 | 753 | ||
754 | /** | 754 | /* |
755 | * Scsi_Host template entry. | 755 | * Scsi_Host template entry. |
756 | * | 756 | * |
757 | * Description: | 757 | * Description: |
@@ -896,7 +896,7 @@ bfad_os_get_itnim(struct bfad_im_port_s *im_port, int id) | |||
896 | return NULL; | 896 | return NULL; |
897 | } | 897 | } |
898 | 898 | ||
899 | /** | 899 | /* |
900 | * Scsi_Host template entry slave_alloc | 900 | * Scsi_Host template entry slave_alloc |
901 | */ | 901 | */ |
902 | static int | 902 | static int |
@@ -973,7 +973,7 @@ bfad_os_fc_host_init(struct bfad_im_port_s *im_port) | |||
973 | sprintf(fc_host_symbolic_name(host), "%s", symname); | 973 | sprintf(fc_host_symbolic_name(host), "%s", symname); |
974 | 974 | ||
975 | fc_host_supported_speeds(host) = bfad_im_supported_speeds(&bfad->bfa); | 975 | fc_host_supported_speeds(host) = bfad_im_supported_speeds(&bfad->bfa); |
976 | fc_host_maxframe_size(host) = fcport->cfg.maxfrsize; | 976 | fc_host_maxframe_size(host) = fcport->cfg.maxfrsize; |
977 | } | 977 | } |
978 | 978 | ||
979 | static void | 979 | static void |
@@ -1016,7 +1016,7 @@ bfad_im_fc_rport_add(struct bfad_im_port_s *im_port, struct bfad_itnim_s *itnim) | |||
1016 | return; | 1016 | return; |
1017 | } | 1017 | } |
1018 | 1018 | ||
1019 | /** | 1019 | /* |
1020 | * Work queue handler using FC transport service | 1020 | * Work queue handler using FC transport service |
1021 | * Context: kernel | 1021 | * Context: kernel |
1022 | */ | 1022 | */ |
@@ -1116,7 +1116,7 @@ bfad_im_itnim_work_handler(struct work_struct *work) | |||
1116 | spin_unlock_irqrestore(&bfad->bfad_lock, flags); | 1116 | spin_unlock_irqrestore(&bfad->bfad_lock, flags); |
1117 | } | 1117 | } |
1118 | 1118 | ||
1119 | /** | 1119 | /* |
1120 | * Scsi_Host template entry, queue a SCSI command to the BFAD. | 1120 | * Scsi_Host template entry, queue a SCSI command to the BFAD. |
1121 | */ | 1121 | */ |
1122 | static int | 1122 | static int |