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)