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:
Event Type |
Description |
Provider |
Default |
Tag |
PORT_STATE |
The port state changes |
Mlx4eth63, IPoIB6x |
On |
p |
ON_IOCTL |
User application asks to generate dump files |
Mlx4_bus |
N/A |
u |
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.