Mellanox WinOF VPI Documentation v5.50.52000
Linux Kernel Upstream Release Notes v6.5

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:

Copy
Copied!
            

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.

© Copyright 2023, NVIDIA. Last updated on May 23, 2023.