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

scsi: qla4xxx: Fix some kerneldoc parameter documentation issues

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

drivers/scsi/qla4xxx/ql4_os.c:4551: warning: Function parameter or member 't' not described in 'qla4xxx_timer'
drivers/scsi/qla4xxx/ql4_os.c:4551: warning: Excess function parameter 'ha' description in 'qla4xxx_timer'
drivers/scsi/qla4xxx/ql4_os.c:5312: warning: Function parameter or member 'work' not described in 'qla4xxx_do_dpc'
drivers/scsi/qla4xxx/ql4_os.c:5312: warning: Excess function parameter 'data' description in 'qla4xxx_do_dpc'
drivers/scsi/qla4xxx/ql4_os.c:8627: warning: Function parameter or member 'ent' not described in 'qla4xxx_probe_adapter'
drivers/scsi/qla4xxx/ql4_os.c:8627: warning: Excess function parameter 'pci_device_id' description in 'qla4xxx_probe_adapter'
drivers/scsi/qla4xxx/ql4_os.c:9008: warning: Function parameter or member 'pdev' not described in 'qla4xxx_remove_adapter'
drivers/scsi/qla4xxx/ql4_os.c:9008: warning: Excess function parameter 'pci_dev' description in 'qla4xxx_remove_adapter'
drivers/scsi/qla4xxx/ql4_os.c:9181: warning: Function parameter or member 'stgt' not described in 'qla4xxx_eh_wait_for_commands'
drivers/scsi/qla4xxx/ql4_os.c:9181: warning: Function parameter or member 'sdev' not described in 'qla4xxx_eh_wait_for_commands'
drivers/scsi/qla4xxx/ql4_os.c:9181: warning: Excess function parameter 't' description in 'qla4xxx_eh_wait_for_commands'
drivers/scsi/qla4xxx/ql4_os.c:9181: warning: Excess function parameter 'l' description in 'qla4xxx_eh_wait_for_commands'
drivers/scsi/qla4xxx/ql4_os.c:9646: warning: Function parameter or member 'pdev' not described in 'qla4xxx_pci_mmio_enabled'

Link: https://lore.kernel.org/r/20200721164148.2617584-27-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
cdeeb36d ea310f57

+7 -6
+7 -6
drivers/scsi/qla4xxx/ql4_os.c
··· 4545 4545 4546 4546 /** 4547 4547 * qla4xxx_timer - checks every second for work to do. 4548 - * @ha: Pointer to host adapter structure. 4548 + * @t: Context to obtain pointer to host adapter structure. 4549 4549 **/ 4550 4550 static void qla4xxx_timer(struct timer_list *t) 4551 4551 { ··· 5299 5299 5300 5300 /** 5301 5301 * qla4xxx_do_dpc - dpc routine 5302 - * @data: in our case pointer to adapter structure 5302 + * @work: Context to obtain pointer to host adapter structure. 5303 5303 * 5304 5304 * This routine is a task that is schedule by the interrupt handler 5305 5305 * to perform the background processing for interrupts. We put it ··· 8616 8616 /** 8617 8617 * qla4xxx_probe_adapter - callback function to probe HBA 8618 8618 * @pdev: pointer to pci_dev structure 8619 - * @pci_device_id: pointer to pci_device entry 8619 + * @ent: pointer to pci_device entry 8620 8620 * 8621 8621 * This routine will probe for Qlogic 4xxx iSCSI host adapters. 8622 8622 * It returns zero if successful. It also initializes all data necessary for ··· 9002 9002 } 9003 9003 /** 9004 9004 * qla4xxx_remove_adapter - callback function to remove adapter. 9005 - * @pci_dev: PCI device pointer 9005 + * @pdev: PCI device pointer 9006 9006 **/ 9007 9007 static void qla4xxx_remove_adapter(struct pci_dev *pdev) 9008 9008 { ··· 9169 9169 /** 9170 9170 * qla4xxx_eh_wait_for_commands - wait for active cmds to finish. 9171 9171 * @ha: pointer to HBA 9172 - * @t: target id 9173 - * @l: lun id 9172 + * @stgt: pointer to SCSI target 9173 + * @sdev: pointer to SCSI device 9174 9174 * 9175 9175 * This function waits for all outstanding commands to a lun to complete. It 9176 9176 * returns 0 if all pending commands are returned and 1 otherwise. ··· 9640 9640 * qla4xxx_pci_mmio_enabled() gets called if 9641 9641 * qla4xxx_pci_error_detected() returns PCI_ERS_RESULT_CAN_RECOVER 9642 9642 * and read/write to the device still works. 9643 + * @pdev: PCI device pointer 9643 9644 **/ 9644 9645 static pci_ers_result_t 9645 9646 qla4xxx_pci_mmio_enabled(struct pci_dev *pdev)