mptutil(1M)															       mptutil(1M)

NAME

       mptutil - Diagnostic utility for Ultra320 SCSI controllers and A7173A PCI-X Dual channel Host Bus Adapters

SYNOPSIS

       [options] <device_file>

DESCRIPTION

       The  command  is a diagnostic tool to be used for Ultra320 SCSI controllers claimed by the MPT driver. This command provides the ability to
       retrieve various configuration information, perform firmware downloads, issue Task Management commands and read accumulated  statistics	of
       the controller and connected target devices.

       The  utility  can be used with various options with a specified device file.  Each device file represents only a single channel on the SCSI
       controller.  Therefore, commands issued through this utility are channel specific and do not affect  the  whole	adapter  (except  firmware
       download).

   Prerequisites:
       You  must  be a privileged user in order to run the command. See privileges(5) for more information on privileged users.  In addition, some
       of the options are intended for use by HP support personnel and require detailed knowledge of the  Ultra320  SCSI  driver  or  firmware	to
       interpret the output.

   OPTIONS
       recognizes the following options. All keywords are case-sensitive and are position dependent.

       <device_file>  where specifies the MPT device file associated with one channel of the Ultra320 SCSI controller.

		      The  device files are created at boot time or during Online Addition of an adapter. They have the name /dev/mptX, where X is
		      the instance number of the SCSI channel, as reported by for the MPT driver and the

		      When used without any options it provides information such as the Driver and Firmware version, Vendor ID, Device ID, Adapter
		      NVRAM size, Vital Product Data (VPD) along with the driver's current state.

		      The following driver states are defined:

		      This  state  indicates  that  the hardware has not been initialized by the driver. This state could result if the driver was
		      unable to successfully initialize the channel.

		      This state indicates that the controller initialization is complete. Driver is in the process of retrieving/setting  various
		      configuration parameters.

		      This state indicates that driver is online and ready to perform normal SCSI I/O operation.

		      This  state  indicates  that  driver  is	currently performing Task Management commands such SCSI BUS RESET, ABORT TASK, BUS
		      DEVICE RESET etc.

		      This state indicates that driver has detected a controller fault and is currently recovering from that condition.

		      This state indicates that controller has been suspended by the user.

       This option is used to display the PCI Configuration data stored on the
		      card. Information is displayed as hexadecimal data.

       This option is used to download the MPT SCSI firmware onto the SCSI controller
		      that has an associated Flash ROM. The controller is specified by the argument.  WARNING: This is	a  DESTRUCTIVE	operation.
		      Active I/Os will be aborted. Should be used by qualified personnel only.

       This option is used to perform Task Management commands. The option
		      specifies the command type. Two types of Task Management commands are currently supported.

		      Perform a Bus Device Reset on the  device specified by the

		      Perform a SCSI Bus Reset. This will reset all the devices on the SCSI bus.

		      WARNING: This is a DESTRUCTIVE operation. Active I/Os will be aborted. Should be used by qualified personnel only.

       This option is used to upload the currently running firmware image to
		      file specified by the

       Clear Driver and Device Statistics

       Display Driver and Device Statistics

       Dump the driver trace information onto the console.

       Display Port Facts Information. The data is displayed as a series of
		      hexadecimal words.

EXAMPLES

       These examples show an Ultra320 SCSI controller that is associated with a SCSI bus with instance number 5.

       Display VPD and other general information stored on the controller

       Download Firmware to the controller

       Display driver and device statistics

       Perform a device reset represented by connected to the controller

AUTHOR

       was developed by HP.

FILES

       Executable file.

       Device files.

SEE ALSO

       mptconfig(1M), ioscan(1M), scsictl(1M), privileges(5)

																       mptutil(1M)