Commit ae272a95 authored Jul 13, 2020 by Lee Jones Committed by Martin K. Petersen Jul 15, 2020

scsi: aacraid: Fill in the very parameter descriptions for rx_sync_cmd()

... and document aac_rx_ioremap() 'dev' param.

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

 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'p2' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'p3' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'p4' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'p5' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'p6' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'status' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'r1' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'r2' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'r3' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Function parameter or member 'r4' not described in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:156: warning: Excess function parameter 'ret' description in 'rx_sync_cmd'
 drivers/scsi/aacraid/rx.c:450: warning: Function parameter or member 'dev' not described in 'aac_rx_ioremap'

Link: https://lore.kernel.org/r/20200713080001.128044-10-lee.jones@linaro.org


Cc: Adaptec OEM Raid Solutions <aacraid@microsemi.com>
Cc: "PMC-Sierra, Inc" <aacraid@pmc-sierra.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

parent d2e51050

drivers/scsi/aacraid/rx.c

+11 −1

Original line number	Diff line number	Diff line
		@@ -144,7 +144,16 @@ static void aac_rx_enable_interrupt_message(struct aac_dev *dev)
		* @dev: Adapter
		* @command: Command to execute
		* @p1: first parameter
		* @ret: adapter status
		* @p2: second parameter
		* @p3: third parameter
		* @p4: forth parameter
		* @p5: fifth parameter
		* @p6: sixth parameter
		* @status: adapter status
		* @r1: first return value
		* @r2: second return value
		* @r3: third return value
		* @r4: forth return value
		*
		* This routine will send a synchronous command to the adapter and wait
		* for its completion.
		@@ -443,6 +452,7 @@ static int aac_rx_deliver_message(struct fib * fib)

		/**
		* aac_rx_ioremap
		* @dev: adapter
		* @size: mapping resize request
		*
		*/

Admin message