User Manual

Rev 1.50

Mellanox Technologies

-w, --wait - Runs itrace in wait mode. itrace will exit only if you press <Ctrl-C>. This

is not the default behavior of itrace. Without the -w option, itrace will exit

if there have been no new traces in the last 0.5 seconds.

-d, --d=DEVICE - Specifies the name of the MST device driver for accessing the cr-space.

The default value is:/dev/mst/mt23108_pci_cr0.

To run itrace via the I2C interface, use this option to specify the following:

--d=device, where the device is an I2C device (such as mtusb-1)

--nomap - Sets itrace not to directly access memory (via memory mapping) for read-

ing the trace buffer, but to use the adapter memory access Gateway

instead. By default, itrace accesses the memory directly. If the cr-space

device specified by the -d parameter is one of the I2C devices, -nomap is

switched on.

--no-propel - Sets itrace not to animate the propeller in wait mode (-w option). By

default, animation is enabled.

-v, --version - Prints the MFT version and exits

-c, --color - Enables color in trace output

-D, --dump - Dumps the trace buffer and exits. This option is useful for debugging

itrace; it dumps the contents of the trace buffer in row format.

C.2 mstdump Utility

The mstdump utility dumps device internal configuration data. The data can be used by for hard-

ware troubleshooting. It can be applied to all Mellanox adapter devices, BridgeX device, InfiniS-

cale III switch devices and 4th generation switch devices.

C.2.1 Operation

The MST driver must be started prior to running mstdump tool. To start mstdump:

1. Start the MST driver (mst start

or mst restart

(0000002d ddaef0d5) SCHD: exes_scheduler: try to insert

(0000002e ddaef2d9) SCHD: SQP:0x000000 exes_scheduler chosen

(0000002f ddaef6aa) SCHD: EXES_GO(0x0)

Typing

--help

at the command line displays manual pages describing the syntax of the

itrace utility.

1. This step in not required in Windows.