resourcedump Utility

The resourcedump tool extracts and prints data segments generated by the firmware. It is supported in 5th generation NIC’s devices. The dump output is used by NVIDIA for debug and troubleshooting.

Warning

mstresourcedump can be used only if Python 3.x is installed. Using lower versions will result in tool's failure.

Warning

To use the memory mode, the user must install the MLNX_OFED driver version that includes the rdma-core package, and in addition, must install the scapy package.

Warning

It is important for the user to generate a bin file for debugging and troubleshooting cases when needed by NVIDIA.

Warning

If the firmware version used is not supported, the tool will generate the following error message:
“Error: Failed to fetch query data with exception: Failed to send Register RESOURCE DUMP with rc: 515. Exiting...”.

Copy
Copied!
            

resourcedump [-h] [-v] {dump,query}

where

dump

Dump command

query

Query command

-h, --help

Show help message and exit

-v, --version

Shows tool version and exit

resourcedump query Usage

Copy
Copied!
            

resourcedump query [-h] [--virtual-hca-id VIRTUAL_HCA_ID] [--mem] --device DEVICE

where

-h, --help

Show help message and exit

--virtual-hca-id

The virtual HCA (host channel adapter, NIC) ID

-d, --device

The device name

--mem

Perform the dump through memory (ofed with rdma-core dependency).

Accepts: [ibv device (for example "mlx5_4")]

An example of how to run the query command:

Copy
Copied!
            

# resourcedump query --device /dev/mst/mt4119_pciconf0 __________________________________________________________________   Segment Type - 0x1300 (FULL_EQC) Dump Params Applicability Special Values -------------------------------- -------------- -------------- index1 (EQN) Mandatory N/A num-of-obj1 N/A N/A index2 (N/A) N/A N/A num-of-obj2 N/A N/A __________________________________________________________________ __________________________________________________________________   Segment Type - 0x1000 (FULL_QPC) Dump Params Applicability Special Values -------------------------------- -------------- -------------- index1 (QPN) Mandatory N/A num-of-obj1 N/A N/A index2 (N/A) N/A N/A num-of-obj2 N/A N/A … … …

resourcedump dump Usage

Copy
Copied!
            

resourcedump dump [-h] --device DEVICE --segment SEGMENT [--virtual-hca-id VIRTUAL_HCA_ID] [--index1 INDEX1] [--index2 INDEX2] [--num-of-obj1 NUM_OF_OBJ1] [--num-of-obj2 NUM_OF_OBJ2] [--depth DEPTH] [--bin BIN] [--mem]

where

-h, --help

Show help message and exit

--virtual-hca-id

The virtual HCA (host channel adapter, NIC) ID

--index1

The first context index to dump (if supported for this segment)

--index2

The second context index to dump (if supported for this segment)

--num-of-obj1

The number of objects to be dumped (if supported for this segment). accepts: ["all", "active", number, depends on the capabilities]

--num-of-obj2

The number of objects to be dumped (if supported for this segment). accepts: ["all", "active", number, depends on the capabilities]

--depth

The depth of walking through reference segments. 0 stands for flat, 1 allows crawling of a single layer down the struct, etc. "inf" for all

--bin

The output to a binary file that replaces the default print in hexadecimal, a readable format

-d, --device

The device name

--segment

The segment to dump

--mem

Perform the dump through memory (ofed with rdma-core dependency).

Accepts: [ibv device (for example "mlx5_4")]


Examples of how to:

  • Run the dump command:

    Copy
    Copied!
                

    # resourcedump dump --device /dev/mst/mt4119_pciconf0 --segment 0x1200 --index1 0x404 --depth 0 Found 10 segments: ------------------------------------------- Segment Type: 0xfffe Segment Size: 16 Bytes Segment Data: 0x0004FFFE 0x00000000 0x00000000 0x101A0111 ------------------------------------------- Segment Type: 0xfffa Segment Size: 20 Bytes Segment Data: 0x0005FFFA 0x12000000 0x00000404 0x00000000 0x00000000 -------------------------------------------

  • Run the Dump command and save it in bin file:

    Copy
    Copied!
                

    # resourcedump dump --device /dev/mst/mt4119_pciconf0 --segment 0x1200 --index1 0x404 --depth 0 -–bin segment_1200.bin write to file: segment_1200.bin

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