Commit 2b46e5c1 authored by Damien Le Moal's avatar Damien Le Moal Committed by Martin K. Petersen
Browse files

scsi: megaraid: Fix kdoc comments format 

Fix kernel documentation comments to avoid various warnings when compiling
with W=1.

No functional changes.

Link: https://lore.kernel.org/r/20200706123345.451783-1-damien.lemoal@wdc.com


Signed-off-by: default avatarDamien Le Moal <damien.lemoal@wdc.com>
Signed-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
parent c3bfffa5

drivers/scsi/megaraid.c

+103 −103
Original line number Diff line number Diff line
@@ -124,7 +124,7 @@ static int trace_level; 


/**

 * mega_setup_mailbox()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Allocates a 8 byte aligned memory for the handshake mailbox.

 */
@@ -347,7 +347,7 @@ mega_query_adapter(adapter_t *adapter) 


/**

 * mega_runpendq()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Runs through the list of pending requests.

 */
@@ -413,8 +413,8 @@ static DEF_SCSI_QCMD(megaraid_queue) 


/**

 * mega_allocate_scb()

 * @adapter - pointer to our soft state

 * @cmd - scsi command from the mid-layer

 * @adapter: pointer to our soft state

 * @cmd: scsi command from the mid-layer

 *

 * Allocate a SCB structure. This is the central structure for controller

 * commands.
@@ -444,9 +444,9 @@ mega_allocate_scb(adapter_t *adapter, struct scsi_cmnd *cmd) 


/**

 * mega_get_ldrv_num()

 * @adapter - pointer to our soft state

 * @cmd - scsi mid layer command

 * @channel - channel on the controller

 * @adapter: pointer to our soft state

 * @cmd: scsi mid layer command

 * @channel: channel on the controller

 *

 * Calculate the logical drive number based on the information in scsi command

 * and the channel number.
@@ -503,9 +503,9 @@ mega_get_ldrv_num(adapter_t *adapter, struct scsi_cmnd *cmd, int channel) 


/**

 * mega_build_cmd()

 * @adapter - pointer to our soft state

 * @cmd - Prepare using this scsi command

 * @busy - busy flag if no resources

 * @adapter: pointer to our soft state

 * @cmd: Prepare using this scsi command

 * @busy: busy flag if no resources

 *

 * Prepares a command and scatter gather list for the controller. This routine

 * also finds out if the commands is intended for a logical drive or a
@@ -937,11 +937,11 @@ mega_build_cmd(adapter_t *adapter, struct scsi_cmnd *cmd, int *busy) 


/**

 * mega_prepare_passthru()

 * @adapter - pointer to our soft state

 * @scb - our scsi control block

 * @cmd - scsi command from the mid-layer

 * @channel - actual channel on the controller

 * @target - actual id on the controller.

 * @adapter: pointer to our soft state

 * @scb: our scsi control block

 * @cmd: scsi command from the mid-layer

 * @channel: actual channel on the controller

 * @target: actual id on the controller.

 *

 * prepare a command for the scsi physical devices.

 */
@@ -1000,11 +1000,11 @@ mega_prepare_passthru(adapter_t *adapter, scb_t *scb, struct scsi_cmnd *cmd, 


/**

 * mega_prepare_extpassthru()

 * @adapter - pointer to our soft state

 * @scb - our scsi control block

 * @cmd - scsi command from the mid-layer

 * @channel - actual channel on the controller

 * @target - actual id on the controller.

 * @adapter: pointer to our soft state

 * @scb: our scsi control block

 * @cmd: scsi command from the mid-layer

 * @channel: actual channel on the controller

 * @target: actual id on the controller.

 *

 * prepare a command for the scsi physical devices. This rountine prepares

 * commands for devices which can take extended CDBs (>10 bytes)
@@ -1085,8 +1085,8 @@ __mega_runpendq(adapter_t *adapter) 


/**

 * issue_scb()

 * @adapter - pointer to our soft state

 * @scb - scsi control block

 * @adapter: pointer to our soft state

 * @scb: scsi control block

 *

 * Post a command to the card if the mailbox is available, otherwise return

 * busy. We also take the scb from the pending list if the mailbox is
@@ -1166,8 +1166,8 @@ mega_busywait_mbox (adapter_t *adapter) 


/**

 * issue_scb_block()

 * @adapter - pointer to our soft state

 * @raw_mbox - the mailbox

 * @adapter: pointer to our soft state

 * @raw_mbox: the mailbox

 *

 * Issue a scb in synchronous and non-interrupt mode

 */
@@ -1247,8 +1247,8 @@ bug_blocked_mailbox: 


/**

 * megaraid_isr_iomapped()

 * @irq - irq

 * @devp - pointer to our soft state

 * @irq: irq

 * @devp: pointer to our soft state

 *

 * Interrupt service routine for io-mapped controllers.

 * Find out if our device is interrupting. If yes, acknowledge the interrupt
@@ -1323,8 +1323,8 @@ megaraid_isr_iomapped(int irq, void *devp) 


/**

 * megaraid_isr_memmapped()

 * @irq - irq

 * @devp - pointer to our soft state

 * @irq: irq

 * @devp: pointer to our soft state

 *

 * Interrupt service routine for memory-mapped controllers.

 * Find out if our device is interrupting. If yes, acknowledge the interrupt
@@ -1401,10 +1401,10 @@ megaraid_isr_memmapped(int irq, void *devp) 
}

/**

 * mega_cmd_done()

 * @adapter - pointer to our soft state

 * @completed - array of ids of completed commands

 * @nstatus - number of completed commands

 * @status - status of the last command completed

 * @adapter: pointer to our soft state

 * @completed: array of ids of completed commands

 * @nstatus: number of completed commands

 * @status: status of the last command completed

 *

 * Complete the commands and call the scsi mid-layer callback hooks.

 */
@@ -1921,9 +1921,9 @@ megaraid_reset(struct scsi_cmnd *cmd) 


/**

 * megaraid_abort_and_reset()

 * @adapter - megaraid soft state

 * @cmd - scsi command to be aborted or reset

 * @aor - abort or reset flag

 * @adapter: megaraid soft state

 * @cmd: scsi command to be aborted or reset

 * @aor: abort or reset flag

 *

 * Try to locate the scsi command in the pending queue. If found and is not

 * issued to the controller, abort/reset it. Otherwise return failure
@@ -2021,8 +2021,8 @@ free_local_pdev(struct pci_dev *pdev) 


/**

 * mega_allocate_inquiry()

 * @dma_handle - handle returned for dma address

 * @pdev - handle to pci device

 * @dma_handle: handle returned for dma address

 * @pdev: handle to pci device

 *

 * allocates memory for inquiry structure

 */
@@ -2045,8 +2045,8 @@ mega_free_inquiry(void *inquiry, dma_addr_t dma_handle, struct pci_dev *pdev) 


/**

 * proc_show_config()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display configuration information about the controller.

 */
@@ -2109,8 +2109,8 @@ proc_show_config(struct seq_file *m, void *v) 


/**

 * proc_show_stat()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display statistical information about the I/O activity.

 */
@@ -2143,8 +2143,8 @@ proc_show_stat(struct seq_file *m, void *v) 


/**

 * proc_show_mbox()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display mailbox information for the last command issued. This information

 * is good for debugging.
@@ -2171,8 +2171,8 @@ proc_show_mbox(struct seq_file *m, void *v) 


/**

 * proc_show_rebuild_rate()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display current rebuild rate

 */
@@ -2214,8 +2214,8 @@ free_pdev: 


/**

 * proc_show_battery()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display information about the battery module on the controller.

 */
@@ -2317,9 +2317,9 @@ mega_print_inquiry(struct seq_file *m, char *scsi_inq) 


/**

 * proc_show_pdrv()

 * @m - Synthetic file construction data

 * @page - buffer to write the data in

 * @adapter - pointer to our soft state

 * @m: Synthetic file construction data

 * @adapter: pointer to our soft state

 * @channel: channel

 *

 * Display information about the physical drives.

 */
@@ -2433,8 +2433,8 @@ free_pdev: 


/**

 * proc_show_pdrv_ch0()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display information about the physical drives on physical channel 0.

 */
@@ -2447,8 +2447,8 @@ proc_show_pdrv_ch0(struct seq_file *m, void *v) 


/**

 * proc_show_pdrv_ch1()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display information about the physical drives on physical channel 1.

 */
@@ -2461,8 +2461,8 @@ proc_show_pdrv_ch1(struct seq_file *m, void *v) 


/**

 * proc_show_pdrv_ch2()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display information about the physical drives on physical channel 2.

 */
@@ -2475,8 +2475,8 @@ proc_show_pdrv_ch2(struct seq_file *m, void *v) 


/**

 * proc_show_pdrv_ch3()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display information about the physical drives on physical channel 3.

 */
@@ -2489,10 +2489,10 @@ proc_show_pdrv_ch3(struct seq_file *m, void *v) 


/**

 * proc_show_rdrv()

 * @m - Synthetic file construction data

 * @adapter - pointer to our soft state

 * @start - starting logical drive to display

 * @end - ending logical drive to display

 * @m: Synthetic file construction data

 * @adapter: pointer to our soft state

 * @start: starting logical drive to display

 * @end: ending logical drive to display

 *

 * We do not print the inquiry information since its already available through

 * /proc/scsi/scsi interface
@@ -2674,8 +2674,8 @@ free_pdev: 


/**

 * proc_show_rdrv_10()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display real time information about the logical drives 0 through 9.

 */
@@ -2688,8 +2688,8 @@ proc_show_rdrv_10(struct seq_file *m, void *v) 


/**

 * proc_show_rdrv_20()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display real time information about the logical drives 0 through 9.

 */
@@ -2702,8 +2702,8 @@ proc_show_rdrv_20(struct seq_file *m, void *v) 


/**

 * proc_show_rdrv_30()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display real time information about the logical drives 0 through 9.

 */
@@ -2716,8 +2716,8 @@ proc_show_rdrv_30(struct seq_file *m, void *v) 


/**

 * proc_show_rdrv_40()

 * @m - Synthetic file construction data

 * @v - File iterator

 * @m: Synthetic file construction data

 * @v: File iterator

 *

 * Display real time information about the logical drives 0 through 9.

 */
@@ -2729,8 +2729,8 @@ proc_show_rdrv_40(struct seq_file *m, void *v) 


/**

 * mega_create_proc_entry()

 * @index - index in soft state array

 * @parent - parent node for this /proc entry

 * @index: index in soft state array

 * @parent: parent node for this /proc entry

 *

 * Creates /proc entries for our controllers.

 */
@@ -2785,7 +2785,7 @@ static inline void mega_create_proc_entry(int index, struct proc_dir_entry *pare 
#endif





/**

/*

 * megaraid_biosparam()

 *

 * Return the disk geometry for a particular disk
@@ -2854,7 +2854,7 @@ megaraid_biosparam(struct scsi_device *sdev, struct block_device *bdev, 


/**

 * mega_init_scb()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Allocate memory for the various pointers in the scb structures:

 * scatter-gather list pointer, passthru and extended passthru structure
@@ -2934,8 +2934,8 @@ mega_init_scb(adapter_t *adapter) 


/**

 * megadev_open()

 * @inode - unused

 * @filep - unused

 * @inode: unused

 * @filep: unused

 *

 * Routines for the character/ioctl interface to the driver. Find out if this

 * is a valid open.
@@ -2954,10 +2954,9 @@ megadev_open (struct inode *inode, struct file *filep) 


/**

 * megadev_ioctl()

 * @inode - Our device inode

 * @filep - unused

 * @cmd - ioctl command

 * @arg - user buffer

 * @filep: Our device file

 * @cmd: ioctl command

 * @arg: user buffer

 *

 * ioctl entry point for our private ioctl interface. We move the data in from

 * the user space, prepare the command (if necessary, convert the old MIMD
@@ -3370,8 +3369,8 @@ megadev_unlocked_ioctl(struct file *filep, unsigned int cmd, unsigned long arg) 


/**

 * mega_m_to_n()

 * @arg - user address

 * @uioc - new ioctl structure

 * @arg: user address

 * @uioc: new ioctl structure

 *

 * A thin layer to convert older mimd interface ioctl structure to NIT ioctl

 * structure
@@ -3498,8 +3497,8 @@ mega_m_to_n(void __user *arg, nitioctl_t *uioc) 


/*

 * mega_n_to_m()

 * @arg - user address

 * @mc - mailbox command

 * @arg: user address

 * @mc: mailbox command

 *

 * Updates the status information to the application, depending on application

 * conforms to older mimd ioctl interface or newer NIT ioctl interface
@@ -3565,7 +3564,7 @@ mega_n_to_m(void __user *arg, megacmd_t *mc) 


/**

 * mega_is_bios_enabled()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * issue command to find out if the BIOS is enabled for this controller

 */
@@ -3596,7 +3595,7 @@ mega_is_bios_enabled(adapter_t *adapter) 


/**

 * mega_enum_raid_scsi()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Find out what channels are RAID/SCSI. This information is used to

 * differentiate the virtual channels and physical channels and to support
@@ -3651,7 +3650,7 @@ mega_enum_raid_scsi(adapter_t *adapter) 


/**

 * mega_get_boot_drv()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Find out which device is the boot device. Note, any logical drive or any

 * phyical device (e.g., a CDROM) can be designated as a boot device.
@@ -3718,7 +3717,7 @@ mega_get_boot_drv(adapter_t *adapter) 


/**

 * mega_support_random_del()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Find out if this controller supports random deletion and addition of

 * logical drives
@@ -3748,7 +3747,7 @@ mega_support_random_del(adapter_t *adapter) 


/**

 * mega_support_ext_cdb()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Find out if this firmware support cdblen > 10

 */
@@ -3776,8 +3775,8 @@ mega_support_ext_cdb(adapter_t *adapter) 


/**

 * mega_del_logdrv()

 * @adapter - pointer to our soft state

 * @logdrv - logical drive to be deleted

 * @adapter: pointer to our soft state

 * @logdrv: logical drive to be deleted

 *

 * Delete the specified logical drive. It is the responsibility of the user

 * app to let the OS know about this operation.
@@ -3862,7 +3861,7 @@ mega_do_del_logdrv(adapter_t *adapter, int logdrv) 


/**

 * mega_get_max_sgl()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Find out the maximum number of scatter-gather elements supported by this

 * version of the firmware
@@ -3908,7 +3907,7 @@ mega_get_max_sgl(adapter_t *adapter) 


/**

 * mega_support_cluster()

 * @adapter - pointer to our soft state

 * @adapter: pointer to our soft state

 *

 * Find out if this firmware support cluster calls.

 */
@@ -3950,8 +3949,8 @@ mega_support_cluster(adapter_t *adapter) 
#ifdef CONFIG_PROC_FS

/**

 * mega_adapinq()

 * @adapter - pointer to our soft state

 * @dma_handle - DMA address of the buffer

 * @adapter: pointer to our soft state

 * @dma_handle: DMA address of the buffer

 *

 * Issue internal commands while interrupts are available.

 * We only issue direct mailbox commands from within the driver. ioctl()
@@ -3983,11 +3982,12 @@ mega_adapinq(adapter_t *adapter, dma_addr_t dma_handle) 
}





/** mega_internal_dev_inquiry()

 * @adapter - pointer to our soft state

 * @ch - channel for this device

 * @tgt - ID of this device

 * @buf_dma_handle - DMA address of the buffer

/**

 * mega_internal_dev_inquiry()

 * @adapter: pointer to our soft state

 * @ch: channel for this device

 * @tgt: ID of this device

 * @buf_dma_handle: DMA address of the buffer

 *

 * Issue the scsi inquiry for the specified device.

 */
@@ -4056,9 +4056,9 @@ mega_internal_dev_inquiry(adapter_t *adapter, u8 ch, u8 tgt, 


/**

 * mega_internal_command()

 * @adapter - pointer to our soft state

 * @mc - the mailbox command

 * @pthru - Passthru structure for DCDB commands

 * @adapter: pointer to our soft state

 * @mc: the mailbox command

 * @pthru: Passthru structure for DCDB commands

 *

 * Issue the internal commands in interrupt mode.

 * The last argument is the address of the passthru structure if the command

drivers/scsi/megaraid/megaraid_mbox.c

+2 −2
Original line number Diff line number Diff line
@@ -3304,7 +3304,6 @@ blocked_mailbox: 
 * megaraid_mbox_display_scb - display SCB information, mostly debug purposes

 * @adapter		: controller's soft state

 * @scb			: SCB to be displayed

 * @level		: debug level for console print

 *

 * Diplay information about the given SCB iff the current debug level is

 * verbose.
@@ -3972,7 +3971,8 @@ megaraid_sysfs_get_ldmap(adapter_t *adapter) 


/**

 * megaraid_sysfs_show_app_hndl - display application handle for this adapter

 * @cdev	: class device object representation for the host

 * @dev		: class device object representation for the host

 * @attr	: device attribute (unused)

 * @buf		: buffer to send data to

 *

 * Display the handle used by the applications while executing management

drivers/scsi/megaraid/megaraid_mm.c

+0 −1
Original line number Diff line number Diff line
@@ -95,7 +95,6 @@ mraid_mm_open(struct inode *inode, struct file *filep) 


/**

 * mraid_mm_ioctl - module entry-point for ioctls

 * @inode	: inode (ignored)

 * @filep	: file operations pointer (ignored)

 * @cmd		: ioctl command

 * @arg		: user ioctl packet

drivers/scsi/megaraid/megaraid_sas_base.c

+97 −74
Original line number Diff line number Diff line
@@ -427,14 +427,14 @@ megasas_decode_evt(struct megasas_instance *instance) 
			evt_detail->description);

}



/**

/*

 * The following functions are defined for xscale

 * (deviceid : 1064R, PERC5) controllers

 */



/**

 * megasas_enable_intr_xscale -	Enables interrupts

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_enable_intr_xscale(struct megasas_instance *instance)
@@ -450,7 +450,7 @@ megasas_enable_intr_xscale(struct megasas_instance *instance) 


/**

 * megasas_disable_intr_xscale -Disables interrupt

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_disable_intr_xscale(struct megasas_instance *instance)
@@ -466,7 +466,7 @@ megasas_disable_intr_xscale(struct megasas_instance *instance) 


/**

 * megasas_read_fw_status_reg_xscale - returns the current FW status value

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static u32

megasas_read_fw_status_reg_xscale(struct megasas_instance *instance)
@@ -475,7 +475,7 @@ megasas_read_fw_status_reg_xscale(struct megasas_instance *instance) 
}

/**

 * megasas_clear_interrupt_xscale -	Check & clear interrupt

 * @regs:				MFI register set

 * @instance:	Adapter soft state

 */

static int

megasas_clear_intr_xscale(struct megasas_instance *instance)
@@ -509,6 +509,7 @@ megasas_clear_intr_xscale(struct megasas_instance *instance) 


/**

 * megasas_fire_cmd_xscale -	Sends command to the FW

 * @instance:		Adapter soft state

 * @frame_phys_addr :	Physical address of cmd

 * @frame_count :	Number of frames for the command

 * @regs :		MFI register set
@@ -529,6 +530,7 @@ megasas_fire_cmd_xscale(struct megasas_instance *instance, 


/**

 * megasas_adp_reset_xscale -  For controller reset

 * @instance:	Adapter soft state

 * @regs:	MFI register set

 */

static int
@@ -570,6 +572,7 @@ megasas_adp_reset_xscale(struct megasas_instance *instance, 


/**

 * megasas_check_reset_xscale -	For controller reset check

 * @instance:	Adapter soft state

 * @regs:	MFI register set

 */

static int
@@ -599,19 +602,19 @@ static struct megasas_instance_template megasas_instance_template_xscale = { 
	.issue_dcmd = megasas_issue_dcmd,

};



/**

/*

 * This is the end of set of functions & definitions specific

 * to xscale (deviceid : 1064R, PERC5) controllers

 */



/**

/*

 * The following functions are defined for ppc (deviceid : 0x60)

 * controllers

 */



/**

 * megasas_enable_intr_ppc -	Enables interrupts

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_enable_intr_ppc(struct megasas_instance *instance)
@@ -629,7 +632,7 @@ megasas_enable_intr_ppc(struct megasas_instance *instance) 


/**

 * megasas_disable_intr_ppc -	Disable interrupt

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_disable_intr_ppc(struct megasas_instance *instance)
@@ -645,7 +648,7 @@ megasas_disable_intr_ppc(struct megasas_instance *instance) 


/**

 * megasas_read_fw_status_reg_ppc - returns the current FW status value

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static u32

megasas_read_fw_status_reg_ppc(struct megasas_instance *instance)
@@ -655,7 +658,7 @@ megasas_read_fw_status_reg_ppc(struct megasas_instance *instance) 


/**

 * megasas_clear_interrupt_ppc -	Check & clear interrupt

 * @regs:				MFI register set

 * @instance:	Adapter soft state

 */

static int

megasas_clear_intr_ppc(struct megasas_instance *instance)
@@ -688,6 +691,7 @@ megasas_clear_intr_ppc(struct megasas_instance *instance) 


/**

 * megasas_fire_cmd_ppc -	Sends command to the FW

 * @instance:		Adapter soft state

 * @frame_phys_addr:	Physical address of cmd

 * @frame_count:	Number of frames for the command

 * @regs:		MFI register set
@@ -708,6 +712,7 @@ megasas_fire_cmd_ppc(struct megasas_instance *instance, 


/**

 * megasas_check_reset_ppc -	For controller reset check

 * @instance:	Adapter soft state

 * @regs:	MFI register set

 */

static int
@@ -738,7 +743,7 @@ static struct megasas_instance_template megasas_instance_template_ppc = { 


/**

 * megasas_enable_intr_skinny -	Enables interrupts

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_enable_intr_skinny(struct megasas_instance *instance)
@@ -756,7 +761,7 @@ megasas_enable_intr_skinny(struct megasas_instance *instance) 


/**

 * megasas_disable_intr_skinny -	Disables interrupt

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_disable_intr_skinny(struct megasas_instance *instance)
@@ -772,7 +777,7 @@ megasas_disable_intr_skinny(struct megasas_instance *instance) 


/**

 * megasas_read_fw_status_reg_skinny - returns the current FW status value

 * @regs:			MFI register set

 * @instance:	Adapter soft state

 */

static u32

megasas_read_fw_status_reg_skinny(struct megasas_instance *instance)
@@ -782,7 +787,7 @@ megasas_read_fw_status_reg_skinny(struct megasas_instance *instance) 


/**

 * megasas_clear_interrupt_skinny -	Check & clear interrupt

 * @regs:				MFI register set

 * @instance:	Adapter soft state

 */

static int

megasas_clear_intr_skinny(struct megasas_instance *instance)
@@ -825,6 +830,7 @@ megasas_clear_intr_skinny(struct megasas_instance *instance) 


/**

 * megasas_fire_cmd_skinny -	Sends command to the FW

 * @instance:		Adapter soft state

 * @frame_phys_addr:	Physical address of cmd

 * @frame_count:	Number of frames for the command

 * @regs:		MFI register set
@@ -847,6 +853,7 @@ megasas_fire_cmd_skinny(struct megasas_instance *instance, 


/**

 * megasas_check_reset_skinny -	For controller reset check

 * @instance:	Adapter soft state

 * @regs:	MFI register set

 */

static int
@@ -876,14 +883,14 @@ static struct megasas_instance_template megasas_instance_template_skinny = { 
};





/**

/*

 * The following functions are defined for gen2 (deviceid : 0x78 0x79)

 * controllers

 */



/**

 * megasas_enable_intr_gen2 -  Enables interrupts

 * @regs:                      MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_enable_intr_gen2(struct megasas_instance *instance)
@@ -902,7 +909,7 @@ megasas_enable_intr_gen2(struct megasas_instance *instance) 


/**

 * megasas_disable_intr_gen2 - Disables interrupt

 * @regs:                      MFI register set

 * @instance:	Adapter soft state

 */

static inline void

megasas_disable_intr_gen2(struct megasas_instance *instance)
@@ -918,7 +925,7 @@ megasas_disable_intr_gen2(struct megasas_instance *instance) 


/**

 * megasas_read_fw_status_reg_gen2 - returns the current FW status value

 * @regs:                      MFI register set

 * @instance:	Adapter soft state

 */

static u32

megasas_read_fw_status_reg_gen2(struct megasas_instance *instance)
@@ -928,7 +935,7 @@ megasas_read_fw_status_reg_gen2(struct megasas_instance *instance) 


/**

 * megasas_clear_interrupt_gen2 -      Check & clear interrupt

 * @regs:                              MFI register set

 * @instance:	Adapter soft state

 */

static int

megasas_clear_intr_gen2(struct megasas_instance *instance)
@@ -961,8 +968,10 @@ megasas_clear_intr_gen2(struct megasas_instance *instance) 


	return mfiStatus;

}



/**

 * megasas_fire_cmd_gen2 -     Sends command to the FW

 * @instance:		Adapter soft state

 * @frame_phys_addr:	Physical address of cmd

 * @frame_count:	Number of frames for the command

 * @regs:		MFI register set
@@ -983,7 +992,8 @@ megasas_fire_cmd_gen2(struct megasas_instance *instance, 


/**

 * megasas_adp_reset_gen2 -	For controller reset

 * @regs:				MFI register set

 * @instance:	Adapter soft state

 * @reg_set:	MFI register set

 */

static int

megasas_adp_reset_gen2(struct megasas_instance *instance,
@@ -1043,6 +1053,7 @@ megasas_adp_reset_gen2(struct megasas_instance *instance, 


/**

 * megasas_check_reset_gen2 -	For controller reset check

 * @instance:	Adapter soft state

 * @regs:	MFI register set

 */

static int
@@ -1071,7 +1082,7 @@ static struct megasas_instance_template megasas_instance_template_gen2 = { 
	.issue_dcmd = megasas_issue_dcmd,

};



/**

/*

 * This is the end of set of functions & definitions

 * specific to gen2 (deviceid : 0x78, 0x79) controllers

 */
@@ -1609,7 +1620,7 @@ megasas_build_ldio(struct megasas_instance *instance, struct scsi_cmnd *scp, 
/**

 * megasas_cmd_type -		Checks if the cmd is for logical drive/sysPD

 *				and whether it's RW or non RW

 * @scmd:			SCSI command

 * @cmd:			SCSI command

 *

 */

inline int megasas_cmd_type(struct scsi_cmnd *cmd)
@@ -1749,8 +1760,8 @@ out_return_cmd: 


/**

 * megasas_queue_command -	Queue entry point

 * @shost:			adapter SCSI host

 * @scmd:			SCSI command to be queued

 * @done:			Callback entry point

 */

static int

megasas_queue_command(struct Scsi_Host *shost, struct scsi_cmnd *scmd)
@@ -2916,11 +2927,7 @@ megasas_dump(void *buf, int sz, int format) 


/**

 * megasas_dump_reg_set -	This function will print hexdump of register set

 * @buf:			Buffer to be dumped

 * @sz:				Size in bytes

 * @format:			Different formats of dumping e.g. format=n will

 *				cause only 'n' 32 bit words to be dumped in a

 *				single line.

 * @reg_set:	Register set to be dumped

 */

inline void

megasas_dump_reg_set(void __iomem *reg_set)
@@ -2997,6 +3004,7 @@ megasas_dump_sys_regs(void __iomem *reg_set, char *buf) 


/**

 * megasas_reset_bus_host -	Bus & host reset handler entry point

 * @scmd:			Mid-layer SCSI command

 */

static int megasas_reset_bus_host(struct scsi_cmnd *scmd)

{
@@ -3777,7 +3785,7 @@ megasas_issue_pending_cmds_again(struct megasas_instance *instance) 
	megasas_register_aen(instance, seq_num, class_locale.word);

}



/**

/*

 * Move the internal reset pending commands to a deferred queue.

 *

 * We move the commands pending at internal reset time to a
@@ -3785,7 +3793,7 @@ megasas_issue_pending_cmds_again(struct megasas_instance *instance) 
 * completion of the internal reset sequence. if the internal reset

 * did not complete in time, the kernel reset handler would flush

 * these commands.

 **/

 */

static void

megasas_internal_reset_defer_cmds(struct megasas_instance *instance)

{
@@ -3963,8 +3971,11 @@ megasas_deplete_reply_queue(struct megasas_instance *instance, 
	tasklet_schedule(&instance->isr_tasklet);

	return IRQ_HANDLED;

}



/**

 * megasas_isr - isr entry point

 * @irq:	IRQ number

 * @devp:	IRQ context address

 */

static irqreturn_t megasas_isr(int irq, void *devp)

{
@@ -3986,6 +3997,7 @@ static irqreturn_t megasas_isr(int irq, void *devp) 
/**

 * megasas_transition_to_ready -	Move the FW to READY state

 * @instance:				Adapter soft state

 * @ocr:				Adapter reset state

 *

 * During the initialization, FW passes can potentially be in any one of

 * several possible states. If the FW in operational, waiting-for-handshake
@@ -4743,7 +4755,7 @@ megasas_get_ld_list(struct megasas_instance *instance) 
/**

 * megasas_ld_list_query -	Returns FW's ld_list structure

 * @instance:				Adapter soft state

 * @ld_list:				ld_list structure

 * @query_type:				ld_list structure type

 *

 * Issues an internal command (DCMD) to get the FW's controller PD

 * list structure.  This information is mainly used to find out SYSTEM
@@ -5653,7 +5665,6 @@ megasas_destroy_irqs(struct megasas_instance *instance) { 
/**

 * megasas_setup_jbod_map -	setup jbod map for FP seq_number.

 * @instance:				Adapter soft state

 * @is_probe:				Driver probe check

 *

 * Return 0 on success.

 */
@@ -6494,7 +6505,7 @@ dcmd_failed: 
 * megasas_register_aen -	Registers for asynchronous event notification

 * @instance:			Adapter soft state

 * @seq_num:			The starting sequence number

 * @class_locale:		Class of the event

 * @class_locale_word:		Class of the event

 *

 * This function subscribes for AEN for events beyond the @seq_num. It requests

 * to be notified if and only if the event is of type @class_locale
@@ -7014,8 +7025,9 @@ static inline void megasas_free_ctrl_mem(struct megasas_instance *instance) 
 * megasas_alloc_ctrl_dma_buffers -	Allocate consistent DMA buffers during

 *					driver load time

 *

 * @instance-				Adapter soft instance

 * @return-				O for SUCCESS

 * @instance:				Adapter soft instance

 *

 * @return:				O for SUCCESS

 */

static inline

int megasas_alloc_ctrl_dma_buffers(struct megasas_instance *instance)
@@ -7931,7 +7943,7 @@ skip_firing_dcmds: 


/**

 * megasas_shutdown -	Shutdown entry point

 * @device:		Generic device structure

 * @pdev:		Generic device structure

 */

static void megasas_shutdown(struct pci_dev *pdev)

{
@@ -7956,8 +7968,10 @@ skip_firing_dcmds: 
		pci_free_irq_vectors(instance->pdev);

}



/**

/*

 * megasas_mgmt_open -	char node "open" entry point

 * @inode:	char node inode

 * @filep:	char node file

 */

static int megasas_mgmt_open(struct inode *inode, struct file *filep)

{
@@ -7970,8 +7984,11 @@ static int megasas_mgmt_open(struct inode *inode, struct file *filep) 
	return 0;

}



/**

/*

 * megasas_mgmt_fasync -	Async notifier registration from applications

 * @fd:		char node file descriptor number

 * @filep:	char node file

 * @mode:	notifier on/off

 *

 * This function adds the calling process to a driver global queue. When an

 * event occurs, SIGIO will be sent to all processes in this queue.
@@ -7997,9 +8014,11 @@ static int megasas_mgmt_fasync(int fd, struct file *filep, int mode) 
	return rc;

}



/**

/*

 * megasas_mgmt_poll -  char node "poll" entry point

 * */

 * @filep:	char node file

 * @wait:	Events to poll for

 */

static __poll_t megasas_mgmt_poll(struct file *file, poll_table *wait)

{

	__poll_t mask;
@@ -8057,7 +8076,8 @@ static int megasas_set_crash_dump_params_ioctl(struct megasas_cmd *cmd) 
/**

 * megasas_mgmt_fw_ioctl -	Issues management ioctls to FW

 * @instance:			Adapter soft state

 * @argp:			User's ioctl packet

 * @user_ioc:			User's ioctl packet

 * @ioc:			ioctl packet

 */

static int

megasas_mgmt_fw_ioctl(struct megasas_instance *instance,
@@ -8397,6 +8417,9 @@ static int megasas_mgmt_ioctl_aen(struct file *file, unsigned long arg) 


/**

 * megasas_mgmt_ioctl -	char node ioctl entry point

 * @file:	char device file pointer

 * @cmd:	ioctl command

 * @arg:	ioctl command arguments address

 */

static long

megasas_mgmt_ioctl(struct file *file, unsigned int cmd, unsigned long arg)

drivers/scsi/megaraid/megaraid_sas_fusion.c

+48 −30

File changed.

Preview size limit exceeded, changes collapsed.

CRA Git | Maintained and supported by SUSTech CRA and CCSE