Commit 100ec495 authored by Lee Jones's avatar Lee Jones Committed by Martin K. Petersen

scsi: initio: Fix a few kernel-doc misdemeanours

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

 drivers/scsi/initio.c:560: warning: Excess function parameter 'num_scbs' description in 'initio_init'
 drivers/scsi/initio.c:1899: warning: expecting prototype for int_initio_scsi_resel(). Prototype was for int_initio_resel() instead
 drivers/scsi/initio.c:2615: warning: expecting prototype for i91u_queuecommand(). Prototype was for i91u_queuecommand_lck() instead
 drivers/scsi/initio.c:2667: warning: Function parameter or member 'dev' not described in 'i91u_biosparam'
 drivers/scsi/initio.c:2667: warning: expecting prototype for i91u_biospararm(). Prototype was for i91u_biosparam() instead
 drivers/scsi/initio.c:2740: warning: Function parameter or member 'host_mem' not described in 'i91uSCBPost'
 drivers/scsi/initio.c:2740: warning: Function parameter or member 'cblk_mem' not described in 'i91uSCBPost'
 drivers/scsi/initio.c:2740: warning: Excess function parameter 'host' description in 'i91uSCBPost'
 drivers/scsi/initio.c:2740: warning: Excess function parameter 'cmnd' description in 'i91uSCBPost'

Link: https://lore.kernel.org/r/20210317091230.2912389-11-lee.jones@linaro.org
Cc: "James E.J. Bottomley" <jejb@linux.ibm.com>
Cc: "Martin K. Petersen" <martin.petersen@oracle.com>
Cc: Bas Vermeulen <bvermeul@blackstar.xs4all.nl>
Cc: Christoph Hellwig <hch@lst.de>
Cc: Brian Macy <bmacy@sunshinecomputing.com>
Cc: linux-scsi@vger.kernel.org
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Signed-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
parent 33c8ef95
...@@ -546,7 +546,6 @@ static int initio_reset_scsi(struct initio_host * host, int seconds) ...@@ -546,7 +546,6 @@ static int initio_reset_scsi(struct initio_host * host, int seconds)
/** /**
* initio_init - set up an InitIO host adapter * initio_init - set up an InitIO host adapter
* @host: InitIO host adapter * @host: InitIO host adapter
* @num_scbs: Number of SCBS
* @bios_addr: BIOS address * @bios_addr: BIOS address
* *
* Set up the host adapter and devices according to the configuration * Set up the host adapter and devices according to the configuration
...@@ -1887,7 +1886,7 @@ static int int_initio_scsi_rst(struct initio_host * host) ...@@ -1887,7 +1886,7 @@ static int int_initio_scsi_rst(struct initio_host * host)
} }
/** /**
* int_initio_scsi_resel - Reselection occurred * int_initio_resel - Reselection occurred
* @host: InitIO host adapter * @host: InitIO host adapter
* *
* A SCSI reselection event has been signalled and the interrupt * A SCSI reselection event has been signalled and the interrupt
...@@ -2601,7 +2600,7 @@ static void initio_build_scb(struct initio_host * host, struct scsi_ctrl_blk * c ...@@ -2601,7 +2600,7 @@ static void initio_build_scb(struct initio_host * host, struct scsi_ctrl_blk * c
} }
/** /**
* i91u_queuecommand - Queue a new command if possible * i91u_queuecommand_lck - Queue a new command if possible
* @cmd: SCSI command block from the mid layer * @cmd: SCSI command block from the mid layer
* @done: Completion handler * @done: Completion handler
* *
...@@ -2650,9 +2649,9 @@ static int i91u_bus_reset(struct scsi_cmnd * cmnd) ...@@ -2650,9 +2649,9 @@ static int i91u_bus_reset(struct scsi_cmnd * cmnd)
} }
/** /**
* i91u_biospararm - return the "logical geometry * i91u_biosparam - return the "logical geometry
* @sdev: SCSI device * @sdev: SCSI device
* @dev; Matching block device * @dev: Matching block device
* @capacity: Sector size of drive * @capacity: Sector size of drive
* @info_array: Return space for BIOS geometry * @info_array: Return space for BIOS geometry
* *
...@@ -2727,10 +2726,8 @@ static void i91u_unmap_scb(struct pci_dev *pci_dev, struct scsi_cmnd *cmnd) ...@@ -2727,10 +2726,8 @@ static void i91u_unmap_scb(struct pci_dev *pci_dev, struct scsi_cmnd *cmnd)
} }
} }
/** /*
* i91uSCBPost - SCSI callback * i91uSCBPost - SCSI callback
* @host: Pointer to host adapter control block.
* @cmnd: Pointer to SCSI control block.
* *
* This is callback routine be called when tulip finish one * This is callback routine be called when tulip finish one
* SCSI command. * SCSI command.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment