scsi: mpt3sas: Fix kdoc comments format (9133d27e) · Commits · 戴 / test

drivers/scsi/mpt3sas/mpt3sas_base.c

+8 −6

Original line number	Diff line number	Diff line
		@@ -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 @@ fall_back:

		/**
		* _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

drivers/scsi/mpt3sas/mpt3sas_ctl.c

+10 −6

Original line number	Diff line number	Diff line
		@@ -3660,8 +3660,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.
		*/
		@@ -3678,8 +3679,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.
		@@ -3696,8 +3698,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.

Admin message