/**
  * ipr_init_ipr_cmnd - Initialize an IPR Cmnd block
  * @ipr_cmd:   ipr command struct
+ * @fast_done: fast done function call-back
  *
  * Return value:
  *     none
 
 /**
  * __ipr_get_free_ipr_cmnd - Get a free IPR Cmnd block
- * @ioa_cfg:   ioa config struct
+ * @hrrq:      hrr queue
  *
  * Return value:
  *     pointer to ipr command struct
 /**
  * __ipr_format_res_path - Format the resource path for printing.
  * @res_path:  resource path
- * @buf:       buffer
+ * @buffer:    buffer
  * @len:       length of buffer provided
  *
  * Return value:
  * ipr_format_res_path - Format the resource path for printing.
  * @ioa_cfg:   ioa config struct
  * @res_path:  resource path
- * @buf:       buffer
+ * @buffer:    buffer
  * @len:       length of buffer provided
  *
  * Return value:
  * ipr_clear_res_target - Clear the bit in the bit map representing the target
  *                       for the resource.
  * @res:       resource entry struct
- * @cfgtew:    config table entry wrapper struct
  *
  * Return value:
  *      none
 
 /**
  * ipr_timeout -  An internally generated op has timed out.
- * @ipr_cmd:   ipr command struct
+ * @t: Timer context used to fetch ipr command struct
  *
  * This function blocks host requests and initiates an
  * adapter reset.
 
 /**
  * ipr_oper_timeout -  Adapter timed out transitioning to operational
- * @ipr_cmd:   ipr command struct
+ * @t: Timer context used to fetch ipr command struct
  *
  * This function blocks host requests and initiates an
  * adapter reset.
 /**
  * ipr_show_fw_version - Show the firmware version
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  *
  * Return value:
 /**
  * ipr_show_log_level - Show the adapter's error logging level
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  *
  * Return value:
 /**
  * ipr_store_log_level - Change the adapter's error logging level
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
+ * @count:     buffer size
  *
  * Return value:
  *     number of bytes printed to buffer
 /**
  * ipr_store_diagnostics - IOA Diagnostics interface
  * @dev:       device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  * @count:     buffer size
  *
 
 /**
  * ipr_show_adapter_state - Show the adapter's state
- * @class_dev: device struct
+ * @dev:       device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  *
  * Return value:
 /**
  * ipr_store_adapter_state - Change adapter state
  * @dev:       device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  * @count:     buffer size
  *
 /**
  * ipr_store_reset_adapter - Reset the adapter
  * @dev:       device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  * @count:     buffer size
  *
  /**
  * ipr_show_iopoll_weight - Show ipr polling mode
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  *
  * Return value:
 /**
  * ipr_store_iopoll_weight - Change the adapter's polling mode
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
+ * @count:     buffer size
  *
  * Return value:
  *     number of bytes printed to buffer
 
 /**
  * ipr_free_ucode_buffer - Frees a microcode download buffer
- * @p_dnld:            scatter/gather list pointer
+ * @sglist:            scatter/gather list pointer
  *
  * Free a DMA'able ucode download buffer previously allocated with
  * ipr_alloc_ucode_buffer
 
 /**
  * ipr_store_update_fw - Update the firmware on the adapter
- * @class_dev: device struct
+ * @dev:       device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  * @count:     buffer size
  *
 /**
  * ipr_show_fw_type - Show the adapter's firmware type.
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  *
  * Return value:
  * ipr_change_queue_depth - Change the device's queue depth
  * @sdev:      scsi device struct
  * @qdepth:    depth to set
- * @reason:    calling context
  *
  * Return value:
  *     actual depth set
 /**
  * ipr_show_raw_mode - Show the adapter's raw mode
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
  *
  * Return value:
 /**
  * ipr_store_raw_mode - Change the adapter's raw mode
  * @dev:       class device struct
+ * @attr:      device attribute (unused)
  * @buf:       buffer
+ * @count:             buffer size
  *
  * Return value:
  *     number of bytes printed to buffer
 
 /**
  * ipr_cmnd_is_free - Check if a command is free or not
- * @ipr_cmd    ipr command struct
+ * @ipr_cmd:   ipr command struct
  *
  * Returns:
  *     true / false
 
 /**
  * ipr_wait_for_ops - Wait for matching commands to complete
- * @ipr_cmd:   ipr command struct
+ * @ioa_cfg:   ioa config struct
  * @device:            device to match (sdev)
  * @match:             match function to use
  *
  * ipr_sata_reset - Reset the SATA port
  * @link:      SATA link to reset
  * @classes:   class of the attached device
+ * @deadline:  unused
  *
  * This function issues a SATA phy reset to the affected ATA link.
  *
 
 /**
  * ipr_abort_timeout - An abort task has timed out
- * @ipr_cmd:   ipr command struct
+ * @t: Timer context used to fetch ipr command struct
  *
  * This function handles when an abort task times out. If this
  * happens we issue a bus reset since we have resources tied
 
 /**
  * ipr_eh_abort - Abort a single op
- * @scsi_cmd:  scsi command struct
+ * @shost:           scsi host struct
+ * @elapsed_time:    elapsed time
  *
  * Return value:
  *     0 if scan in progress / 1 if scan is complete
  * ipr_isr_eh - Interrupt service routine error handler
  * @ioa_cfg:   ioa config struct
  * @msg:       message to log
+ * @number:    various meanings depending on the caller/message
  *
  * Return value:
  *     none
 
 /**
  * ipr_gen_sense - Generate SCSI sense data from an IOASA
- * @ioasa:             IOASA
- * @sense_buf: sense data buffer
+ * @ipr_cmd:   ipr command struct
  *
  * Return value:
  *     none
 
 /**
  * ipr_info - Get information about the card/driver
- * @scsi_host: scsi host struct
+ * @host:      scsi host struct
  *
  * Return value:
  *     pointer to buffer with description string
 /**
  * ipr_build_mode_sense - Builds a mode sense command
  * @ipr_cmd:   ipr command struct
- * @res:               resource entry struct
+ * @res_handle:                resource entry struct
  * @parm:              Byte 2 of mode sense command
  * @dma_addr:  DMA address of mode sense buffer
  * @xfer_len:  Size of DMA buffer
 /**
  * ipr_ioafp_set_caching_parameters - Issue Set Cache parameters service
  * action
+ * @ipr_cmd:   ipr command struct
  *
  * Return value:
  *     none
 /**
  * ipr_ioafp_inquiry - Send an Inquiry to the adapter.
  * @ipr_cmd:   ipr command struct
+ * @flags:     flags to send
+ * @page:      page to inquire
+ * @dma_addr:  DMA address
+ * @xfer_len:  transfer data length
  *
  * This utility function sends an inquiry to the adapter.
  *
 
 /**
  * ipr_reset_timer_done - Adapter reset timer function
- * @ipr_cmd:   ipr command struct
+ * @t: Timer context used to fetch ipr command struct
  *
  * Description: This function is used in adapter reset processing
  * for timing events. If the reset_cmd pointer in the IOA
  * Description: This is the second phase of adapter initialization
  * This function takes care of initilizing the adapter to the point
  * where it can accept new commands.
-
  * Return value:
  *     0 on success / -EIO on failure
  **/
 
 /**
  * ipr_free_all_resources - Free all allocated resources for an adapter.
- * @ipr_cmd:   ipr command struct
+ * @ioa_cfg:   ioa config struct
  *
  * This function frees all allocated resources for the
  * specified adapter.
 
 /**
  * ipr_test_intr - Handle the interrupt generated in ipr_test_msi().
- * @pdev:              PCI device struct
+ * @devp:              PCI device struct
+ * @irq:               IRQ number
  *
  * Description: Simply set the msi_received flag to 1 indicating that
  * Message Signaled Interrupts are supported.
 
 /**
  * ipr_test_msi - Test for Message Signaled Interrupt (MSI) support.
+ * @ioa_cfg:           ioa config struct
  * @pdev:              PCI device struct
  *
  * Description: This routine sets up and initiates a test interrupt to determine
 
 /**
  * ipr_probe - Adapter hot plug add entry point
+ * @pdev:      pci device struct
+ * @dev_id:    pci device ID
  *
  * Return value:
  *     0 on success / non-zero on failure
 
 /**
  * ipr_halt_done - Shutdown prepare completion
+ * @ipr_cmd:   ipr command struct
  *
  * Return value:
  *     none
 
 /**
  * ipr_halt - Issue shutdown prepare to all adapters
+ * @nb: Notifier block
+ * @event: Notifier event
+ * @buf: Notifier data (unused)
  *
  * Return value:
  *     NOTIFY_OK on success / NOTIFY_DONE on failure