Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

scsi: qla4xxx: Repair function documentation headers

Fix one formatting issue, one misspelling and three missing descriptions.

Fixes the following W=1 kernel build warning(s):

drivers/scsi/qla4xxx/ql4_isr.c:588: warning: Excess function parameter 'ret' description in 'qla4_83xx_loopback_in_progress'
drivers/scsi/qla4xxx/ql4_isr.c:661: warning: Function parameter or member 'mbox_status' not described in 'qla4xxx_isr_decode_mailbox'
drivers/scsi/qla4xxx/ql4_isr.c:661: warning: Excess function parameter 'mailbox_status' description in 'qla4xxx_isr_decode_mailbox'
drivers/scsi/qla4xxx/ql4_isr.c:1053: warning: Function parameter or member 'intr_status' not described in 'qla4_82xx_interrupt_service_routine'
drivers/scsi/qla4xxx/ql4_isr.c:1078: warning: Function parameter or member 'intr_status' not described in 'qla4xxx_interrupt_service_routine'

Link: https://lore.kernel.org/r/20200721164148.2617584-28-lee.jones@linaro.org
Cc: QLogic-Storage-Upstream@qlogic.com
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

authored by

Lee Jones and committed by
Martin K. Petersen
fc5fba6e cdeeb36d

+4 -2
+4 -2
drivers/scsi/qla4xxx/ql4_isr.c
··· 582 582 /** 583 583 * qla4_83xx_loopback_in_progress: Is loopback in progress? 584 584 * @ha: Pointer to host adapter structure. 585 - * @ret: 1 = loopback in progress, 0 = loopback not in progress 585 + * returns: 1 = loopback in progress, 0 = loopback not in progress 586 586 **/ 587 587 static int qla4_83xx_loopback_in_progress(struct scsi_qla_host *ha) 588 588 { ··· 651 651 /** 652 652 * qla4xxx_isr_decode_mailbox - decodes mailbox status 653 653 * @ha: Pointer to host adapter structure. 654 - * @mailbox_status: Mailbox status. 654 + * @mbox_status: Mailbox status. 655 655 * 656 656 * This routine decodes the mailbox status during the ISR. 657 657 * Hardware_lock locked upon entry. runs in interrupt context. ··· 1044 1044 /** 1045 1045 * qla4_82xx_interrupt_service_routine - isr 1046 1046 * @ha: pointer to host adapter structure. 1047 + * @intr_status: Local interrupt status/type. 1047 1048 * 1048 1049 * This is the main interrupt service routine. 1049 1050 * hardware_lock locked upon entry. runs in interrupt context. ··· 1070 1069 /** 1071 1070 * qla4xxx_interrupt_service_routine - isr 1072 1071 * @ha: pointer to host adapter structure. 1072 + * @intr_status: Local interrupt status/type. 1073 1073 * 1074 1074 * This is the main interrupt service routine. 1075 1075 * hardware_lock locked upon entry. runs in interrupt context.