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