Minki/linux
1
0
Fork 1
mirror of https://github.com/torvalds/linux.git synced 2024-09-20 23:13:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

powerpc/mpc52xx_lpbfifo: fix all kernel-doc warnings

Browse Source 
Fix multiple kernel-doc warnings in mpc52xx_lpbfifo.c:

arch/powerpc/platforms/52xx/mpc52xx_lpbfifo.c:377: warning: expecting prototype for mpc52xx_lpbfifo_bcom_poll(). Prototype was for mpc52xx_lpbfifo_poll() instead

mpc52xx_lpbfifo.c:221: warning: No description found for return value of 'mpc52xx_lpbfifo_irq'
mpc52xx_lpbfifo.c:327: warning: No description found for return value of 'mpc52xx_lpbfifo_bcom_irq'
mpc52xx_lpbfifo.c:398: warning: No description found for return value of 'mpc52xx_lpbfifo_submit'

mpc52xx_lpbfifo.c:64: warning: Function parameter or member 'req' not described in 'mpc52xx_lpbfifo_kick'
mpc52xx_lpbfifo.c:220: warning: contents before sections
mpc52xx_lpbfifo.c:223: warning: Function parameter or member 'irq' not described in 'mpc52xx_lpbfifo_irq'
mpc52xx_lpbfifo.c:223: warning: Function parameter or member 'dev_id' not described in 'mpc52xx_lpbfifo_irq'
mpc52xx_lpbfifo.c:328: warning: contents before sections
mpc52xx_lpbfifo.c:331: warning: Function parameter or member 'irq' not described in 'mpc52xx_lpbfifo_bcom_irq'
mpc52xx_lpbfifo.c:331: warning: Function parameter or member 'dev_id' not described in 'mpc52xx_lpbfifo_bcom_irq'

Reported-by: kernel test robot <lkp@intel.com>
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
Link: https://lore.kernel.org/r/20221124061918.1967-1-rdunlap@infradead.org
This commit is contained in:
Randy Dunlap 2022-11-23 22:19:18 -08:00 committed by Michael Ellerman
parent e75d07bd83
commit 4562bffb83
1 changed files with 13 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
arch/powerpc/platforms/52xx/mpc52xx_lpbfifo.c
View File

@ -59,6 +59,8 @@ static struct mpc52xx_lpbfifo lpbfifo;
/** /**
* mpc52xx_lpbfifo_kick - Trigger the next block of data to be transferred * mpc52xx_lpbfifo_kick - Trigger the next block of data to be transferred
*
* @req: Pointer to request structure
*/ */
static void mpc52xx_lpbfifo_kick(struct mpc52xx_lpbfifo_request *req) static void mpc52xx_lpbfifo_kick(struct mpc52xx_lpbfifo_request *req)
{ {
@ -178,6 +180,8 @@ static void mpc52xx_lpbfifo_kick(struct mpc52xx_lpbfifo_request *req)
/** /**
* mpc52xx_lpbfifo_irq - IRQ handler for LPB FIFO * mpc52xx_lpbfifo_irq - IRQ handler for LPB FIFO
* @irq: IRQ number to be handled
* @dev_id: device ID cookie
* *
* On transmit, the dma completion irq triggers before the fifo completion * On transmit, the dma completion irq triggers before the fifo completion
* triggers. Handle the dma completion here instead of the LPB FIFO Bestcomm * triggers. Handle the dma completion here instead of the LPB FIFO Bestcomm
@ -216,6 +220,8 @@ static void mpc52xx_lpbfifo_kick(struct mpc52xx_lpbfifo_request *req)
* or nested spinlock condition. The out path is non-trivial, so * or nested spinlock condition. The out path is non-trivial, so
* extra fiddling is done to make sure all paths lead to the same * extra fiddling is done to make sure all paths lead to the same
* outbound code. * outbound code.
*
* Return: irqreturn code (%IRQ_HANDLED)
*/ */
static irqreturn_t mpc52xx_lpbfifo_irq(int irq, void *dev_id) static irqreturn_t mpc52xx_lpbfifo_irq(int irq, void *dev_id)
{ {
@ -320,8 +326,12 @@ static irqreturn_t mpc52xx_lpbfifo_irq(int irq, void *dev_id)
/** /**
* mpc52xx_lpbfifo_bcom_irq - IRQ handler for LPB FIFO Bestcomm task * mpc52xx_lpbfifo_bcom_irq - IRQ handler for LPB FIFO Bestcomm task
* @irq: IRQ number to be handled
* @dev_id: device ID cookie
* *
* Only used when receiving data. * Only used when receiving data.
*
* Return: irqreturn code (%IRQ_HANDLED)
*/ */
static irqreturn_t mpc52xx_lpbfifo_bcom_irq(int irq, void *dev_id) static irqreturn_t mpc52xx_lpbfifo_bcom_irq(int irq, void *dev_id)
{ {
@ -372,7 +382,7 @@ static irqreturn_t mpc52xx_lpbfifo_bcom_irq(int irq, void *dev_id)
} }
/** /**
* mpc52xx_lpbfifo_bcom_poll - Poll for DMA completion * mpc52xx_lpbfifo_poll - Poll for DMA completion
*/ */
void mpc52xx_lpbfifo_poll(void) void mpc52xx_lpbfifo_poll(void)
{ {
@ -393,6 +403,8 @@ EXPORT_SYMBOL(mpc52xx_lpbfifo_poll);
/** /**
* mpc52xx_lpbfifo_submit - Submit an LPB FIFO transfer request. * mpc52xx_lpbfifo_submit - Submit an LPB FIFO transfer request.
* @req: Pointer to request structure * @req: Pointer to request structure
*
* Return: %0 on success, -errno code on error
*/ */
int mpc52xx_lpbfifo_submit(struct mpc52xx_lpbfifo_request *req) int mpc52xx_lpbfifo_submit(struct mpc52xx_lpbfifo_request *req)
{ {