You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
136 lines
5.0 KiB
136 lines
5.0 KiB
From a2370100396a4f123256dcd5842c26c8848f7c05 Mon Sep 17 00:00:00 2001
|
|
From: Tomas Henzl <thenzl@redhat.com>
|
|
Date: Fri, 9 Oct 2020 14:06:23 -0400
|
|
Subject: [PATCH 05/33] [scsi] scsi: mpt3sas: Fix kdoc comments format
|
|
|
|
Message-id: <20201009140636.7976-6-thenzl@redhat.com>
|
|
Patchwork-id: 330360
|
|
Patchwork-instance: patchwork
|
|
O-Subject: [RHEL8.4 e-stor PATCH 05/18] scsi: mpt3sas: Fix kdoc comments format
|
|
Bugzilla: 1851440
|
|
RH-Acked-by: Ewan Milne <emilne@redhat.com>
|
|
RH-Acked-by: Jarod Wilson <jarod@redhat.com>
|
|
RH-Acked-by: Maurizio Lombardi <mlombard@redhat.com>
|
|
RH-Acked-by: Tony Camuso <tcamuso@redhat.com>
|
|
|
|
Fix kdoc comments format to avoid compiler warnings when compiling with
|
|
W=1.
|
|
|
|
No functional changes.
|
|
|
|
Link: https://lore.kernel.org/r/20200706123358.452180-1-damien.lemoal@wdc.com
|
|
Signed-off-by: Damien Le Moal <damien.lemoal@wdc.com>
|
|
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
|
|
(cherry picked from commit 9133d27ef104207416db7a97204c0062d27f8b33)
|
|
Signed-off-by: Tomas Henzl <thenzl@redhat.com>
|
|
Signed-off-by: Jan Stancek <jstancek@redhat.com>
|
|
---
|
|
drivers/scsi/mpt3sas/mpt3sas_base.c | 14 ++++++++------
|
|
drivers/scsi/mpt3sas/mpt3sas_ctl.c | 16 ++++++++++------
|
|
2 files changed, 18 insertions(+), 12 deletions(-)
|
|
|
|
diff --git a/drivers/scsi/mpt3sas/mpt3sas_base.c b/drivers/scsi/mpt3sas/mpt3sas_base.c
|
|
index 96b78fdc6b8a..1d64524cd863 100644
|
|
--- a/drivers/scsi/mpt3sas/mpt3sas_base.c
|
|
+++ b/drivers/scsi/mpt3sas/mpt3sas_base.c
|
|
@@ -190,7 +190,7 @@ module_param_call(mpt3sas_fwfault_debug, _scsih_set_fwfault_debug,
|
|
|
|
/**
|
|
* _base_readl_aero - retry readl for max three times.
|
|
- * @addr - MPT Fusion system interface register address
|
|
+ * @addr: MPT Fusion system interface register address
|
|
*
|
|
* Retry the readl() for max three times if it gets zero value
|
|
* while reading the system interface register.
|
|
@@ -817,6 +817,7 @@ mpt3sas_base_coredump_info(struct MPT3SAS_ADAPTER *ioc, u16 fault_code)
|
|
* mpt3sas_base_wait_for_coredump_completion - Wait until coredump
|
|
* completes or times out
|
|
* @ioc: per adapter object
|
|
+ * @caller: caller function name
|
|
*
|
|
* Returns 0 for success, non-zero for failure.
|
|
*/
|
|
@@ -1718,8 +1719,8 @@ _base_interrupt(int irq, void *bus_id)
|
|
|
|
/**
|
|
* _base_irqpoll - IRQ poll callback handler
|
|
- * @irqpoll - irq_poll object
|
|
- * @budget - irq poll weight
|
|
+ * @irqpoll: irq_poll object
|
|
+ * @budget: irq poll weight
|
|
*
|
|
* returns number of reply descriptors processed
|
|
*/
|
|
@@ -3048,8 +3049,8 @@ _base_assign_reply_queues(struct MPT3SAS_ADAPTER *ioc)
|
|
|
|
/**
|
|
* _base_check_and_enable_high_iops_queues - enable high iops mode
|
|
- * @ ioc - per adapter object
|
|
- * @ hba_msix_vector_count - msix vectors supported by HBA
|
|
+ * @ioc: per adapter object
|
|
+ * @hba_msix_vector_count: msix vectors supported by HBA
|
|
*
|
|
* Enable high iops queues only if
|
|
* - HBA is a SEA/AERO controller and
|
|
@@ -5621,6 +5622,7 @@ _base_wait_on_iocstate(struct MPT3SAS_ADAPTER *ioc, u32 ioc_state, int timeout)
|
|
* _base_wait_for_doorbell_int - waiting for controller interrupt(generated by
|
|
* a write to the doorbell)
|
|
* @ioc: per adapter object
|
|
+ * @timeout: timeout in seconds
|
|
*
|
|
* Return: 0 for success, non-zero for failure.
|
|
*
|
|
@@ -5833,7 +5835,7 @@ _base_send_ioc_reset(struct MPT3SAS_ADAPTER *ioc, u8 reset_type, int timeout)
|
|
/**
|
|
* mpt3sas_wait_for_ioc - IOC's operational state is checked here.
|
|
* @ioc: per adapter object
|
|
- * @wait_count: timeout in seconds
|
|
+ * @timeout: timeout in seconds
|
|
*
|
|
* Return: Waits up to timeout seconds for the IOC to
|
|
* become operational. Returns 0 if IOC is present
|
|
diff --git a/drivers/scsi/mpt3sas/mpt3sas_ctl.c b/drivers/scsi/mpt3sas/mpt3sas_ctl.c
|
|
index 983e568ff231..43260306668c 100644
|
|
--- a/drivers/scsi/mpt3sas/mpt3sas_ctl.c
|
|
+++ b/drivers/scsi/mpt3sas/mpt3sas_ctl.c
|
|
@@ -3662,8 +3662,9 @@ static DEVICE_ATTR_RW(diag_trigger_mpi);
|
|
|
|
/**
|
|
* drv_support_bitmap_show - driver supported feature bitmap
|
|
- * @cdev - pointer to embedded class device
|
|
- * @buf - the buffer returned
|
|
+ * @cdev: pointer to embedded class device
|
|
+ * @attr: unused
|
|
+ * @buf: the buffer returned
|
|
*
|
|
* A sysfs 'read-only' shost attribute.
|
|
*/
|
|
@@ -3680,8 +3681,9 @@ static DEVICE_ATTR_RO(drv_support_bitmap);
|
|
|
|
/**
|
|
* enable_sdev_max_qd_show - display whether sdev max qd is enabled/disabled
|
|
- * @cdev - pointer to embedded class device
|
|
- * @buf - the buffer returned
|
|
+ * @cdev: pointer to embedded class device
|
|
+ * @attr: unused
|
|
+ * @buf: the buffer returned
|
|
*
|
|
* A sysfs read/write shost attribute. This attribute is used to set the
|
|
* targets queue depth to HBA IO queue depth if this attribute is enabled.
|
|
@@ -3698,8 +3700,10 @@ enable_sdev_max_qd_show(struct device *cdev,
|
|
|
|
/**
|
|
* enable_sdev_max_qd_store - Enable/disable sdev max qd
|
|
- * @cdev - pointer to embedded class device
|
|
- * @buf - the buffer returned
|
|
+ * @cdev: pointer to embedded class device
|
|
+ * @attr: unused
|
|
+ * @buf: the buffer returned
|
|
+ * @count: unused
|
|
*
|
|
* A sysfs read/write shost attribute. This attribute is used to set the
|
|
* targets queue depth to HBA IO queue depth if this attribute is enabled.
|
|
--
|
|
2.13.6
|
|
|