mptutil - Diagnostic utility for Ultra320 SCSI controllers and A7173A
PCI-X Dual channel Host Bus Adapters
/opt/mpt/bin/mptutil [options] <device_file>
The mptutil 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 does not affect the whole adapter (except
Prerequisites: An effective user ID of 0 (superuser) is required in
order to run the mptutil command. In addition, some of the mptutil
options are intended for use by HP support personnel and require
detailed knowledge of the Ultra320 SCSI driver or firmware to
interpret the output.
mptutil recognizes the following options. All keywords are case-
sensitive and are position dependent.
<device_file> where device_file specifies the MPT device file
associated with one channel of the Ultra320 SCSI
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 ioscan(1M) for the MPT driver
and the ext_bus.
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.
Hewlett-Packard Company - 1 - HP-UX Release 11i: May 20, 2003
The following driver states are defined:
UNINITIALIZED 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.
CONFIGURING This state indicates that the controller
initialization is complete. Driver is in the process of
retrieving/setting various configuration parameters.
OPERATIONAL This state indicates that driver is online
and ready to perform normal SCSI I/O operation.
TASK_MGMT This state indicates that driver is currently
performing Task Management commands such SCSI BUS
RESET, ABORT TASK, BUS DEVICE RESET etc.
REPAIRING This state indicates that driver has detected
a controller fault and is currently recovering from
SUSPENDED This state indicates that controller has been
suspended by the user.
-c This option is used to display the PCI Configuration
data stored on the card. Information is displayed as
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 <<<<device_file>>>>
argument. WARNING: This is a DESTRUCTIVE operation.
Active I/Os will be aborted. Should be used qualified
-t <<<<tmtype>>>> [target_id]
This option is used to perform Task Management
commands. The option <<<<tmtype>>>> specifies the command
type. Two types of Task Management commands are
tgt_reset <<<<target_id>>>> Perform a Bus Device Reset on the
device specified by the <<<<target_id>>>>
bus_reset 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 qualified personnel
Hewlett-Packard Company - 2 - HP-UX Release 11i: May 20, 2003
-u <<<<filename>>>> This option is used to upload the currently running
firmware image to file specified by the filename
-R Clear Driver and Device Statistics
-S Display Driver and Device Statistics
-T Dump the driver trace information onto the console.
-P Display Port Facts Information. The data is displayed
as a series of hexadecimal words.
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
mptutil -d a7173a_1_03_06_im.img /dev/mpt5
Display driver and device statistics
mptutil -S /dev/mpt5
Perform a device reset represented by target_id 1 connected to the
mptutil -t tgt_reset 1 /dev/mpt5
/opt/bin/mptutil was developed by HP.
/opt/mpt/bin/mptutil Executable file.
/dev/mpt<<<<X>>>> Device files.
mptconfig(1M), ioscan(1M), scsictl(1M)
Hewlett-Packard Company - 3 - HP-UX Release 11i: May 20, 2003