State Dumping

Upon several types of events, the drivers can produce a set of files reflecting the current state of the adapter.

Automatic state dumps are done upon the following events:

where:

• Provider: The driver creating the set of files.

• Default: Whether or not the state dumps are created by default upon this event.

• Tag: Part of the file name, used to identify the event that has triggered the state dump.

PORT_STATE events can be disabled by adding DumpModeFlags DWORD32 parameter into HKLM\System\CurrentControlSet\Services\xxx\Parameters (where xxx is either mlx4eth63 or ipoib6). It is a bit-field with the following bit meanings:

            

            
DUMP_MODE_FLAGS_DISABLE_DUMP_ON_PORT_DN (1 << 2)// i.e. 0x04
DUMP_MODE_FLAGS_DISABLE_DUMP_ON_PORT_NONE (1 << 3)// i.e. 0x08
DUMP_MODE_FLAGS_DISABLE_DUMP_ON_PORT_UP (1 << 4)// i.e. 0x10
        

The set consists of the following files:

• 3 consecutive mstdump files

• 2 EQ dump files

• 1 FW trace file

These files are created in the %SystemRoot%\temp directory, and should be sent to Mellanox Support for analysis when debugging WinOF driver problems. Their names have the following format:<Driver_mode_of_work>_<card_location>_<event_tag_name>_<event_number>_<event_name>_<file_type>_<file_index>.log
where:

• Driver_mode_of_work: The mode of driver work. For example: ‘SingleFunc’

• card_location: In form bus_device_function, For example: 4_0_0

• event_tag_name: One-symbol tag. See in Table 64 - “Events Causing Automatic State Dumps,” on page 214

• event_number: The index of dump files set and created for this event. This number is restricted by the hidden Registry parameter DumpEventsNum

• event_name: A short string naming the event. For example: ‘eth-down-1’ = “Ethernet port1 passed to DOWN state”

• file_type: Type of file in the set. For example: “crspace”, “fwtrace”, “eq_dump” and “eq_print”

• file_index: The file number of this type in the set

Example:
Name: SingleFunc_4_0_0_p000_eth-down-1_eq_dump_0.log
The default number of sets of files for each event is 20. It can be changed by adding DumpEventsNum DWORD32 parameter under HKLM\System\CurrnetControlSet\Services\mlx4_bus\Parameters and setting it to another value.