This feature helps dumping driver and firmware configuration using ethtool for ConnectX-4/ ConnectX-4 Lx adapter cards (mlx5 drivers). It creates a backup of the configuration files into a specified dump file.
Dump Parameters (Bitmap Flag)
The following bitmap parameters are used to set the type of dump:
Ring dump (Software context information for SQs, EQs, RQs, CQs)
MST dump + Ring dump (1+2)
Clear this parameter
In order to configure this feature, follow the steps below:
Set the dump bitmap parameter by running -W (uppercase) with the desired bitmap parameter value (see Bitmap Parameters table above). In the following example, the bitmap parameter value is 3.
Dump the file by running -w (lowercase) with the desired configuration file name.
[Optional] To get the bitmap parameter value, version and size of the dump, run the command above without the file name.
To open the dump file, run:
-f For the file to be parsed (the file that was just created) -m For the mst dump file -r For the ring dump file
Note: The output has been updated in MLNX_OFED v3.4 by adding the Management Cable IO and Notifications (MCION) firmware register. The status can be "present" and/or "rx los"/ "tx fault". For further information, refer to HowTo Dump Driver Configuration (via ethtool) Community post.
- Open the files.
The MST dump file will look as follows. In order to analyze it, contact NVIDIA Support.
The Ring dump file can help developers debug ring-related issues, and it looks as follows: