NVIDIA Docs Hub Homepage NVIDIA Networking Networking Software Firmware Management MSTFLINT Package - Firmware Burning and Diagnostics Tools Documentation v4.30.0 mstresourceparse Utility

mstresourceparse Utility

The mstresourceparse tool parses and prints data segments content. The parser's output is used by NVIDIA representatives for debugging and troubleshooting.

Note

The tool's applicable parsing inputs can be the mstresourcedump outputs (bin file or “human readable” format), or the devlink JSON format output.

Note

To parse the segments data in the most efficient way, you must use the most suitable ADB file. For the ADB file, please contact NVIDIA Support.

mstresourceparse Usage

Copy
Copied!

            
            mstresourceparse -d DUMP_FILE -a ADB_FILE [-h] [--version] [-o OUT] [-r] [-v]

where

-d, --dump-file	Location of the dump file used for parsing
-a, --adb-file	Location of the ADB file
-h, --help	Shows this help message and exit
--version	Shows the tool's version and exit
-o, --out	Location of the output file
-r, --raw	Prints the raw data in addition to the parsed data
-v	Verbosity notice

Examples:

How to run basic parsing:

Copy
Copied!

            
            # mstresourceparse --dump-file notice.txt --adb-file fw-4119-rel-16_23_2008.adb
 
Parse 4 segments:
 
--------------------------------------------------------------------------------
 
                    Segment - segment_info (0xfffe)
 
segment_header.segment_type = 0xfffe
 
segment_header.length_dw = 0x4
 
dump_version = 0x0
 
hw_version = 0x0
 
fw_version = 0x1063232c
 
--------------------------------------------------------------------------------
 
                    Segment - segment_command (0xfffa)
 
segment_header.segment_type = 0xfffa
 
segment_header.length_dw = 0x5
 
vhca_id = 0x0
 
segment_called = 0x2000
 
index1 = 0x21
 
index2 = 0x0
 
num_of_obj1 = 0x0
 
num_of_obj2 = 0x0
 
--------------------------------------------------------------------------------
 
                    Segment - segment_notice (0xfff9)
 
segment_header.segment_type = 0xfff9
 
segment_header.length_dw = 0xc
 
syndrome_id = 0x211
 
notice[0] = 0x2000
 
notice[1] = 0x21
 
notice[2] = 0x0
 
notice[3] = 0x0
 
notice[4] = 0x496e7661
 
notice[5] = 0x6c696420
 
notice[6] = 0x52657300
 
notice[7] = 0x0
 
notice msg =  !Invalid Res
 
--------------------------------------------------------------------------------
 
                    Segment - segment_terminate (0xfffb)
 
segment_header.segment_type = 0xfffb
 
segment_header.length_dw = 0x1
 
--------------------------------------------------------------------------------

How to run parsing with ‘raw’ and ‘verbosity’ options:

Copy
Copied!

            
            # mstresourceparse --dump-file notice.txt --adb-file fw-4119-rel-16_23_2008.adb –raw -v
 
Notice - adb fw version 16.23.2008 is used for parsing while dump fw version is 16.99.9004
 
Parse 4 segments:
 
--------------------------------------------------------------------------------
 
                    Segment - segment_info (0xfffe)
 
segment_header.segment_type = 0xfffe
 
segment_header.length_dw = 0x4
 
dump_version = 0x0
 
hw_version = 0x0
 
fw_version = 0x1063232c
 
RAW DATA:
 
DWORD [0-3]    :0x0004FFFE 0x00000000 0x00000000 0x1063232C
 
--------------------------------------------------------------------------------
 
                    Segment - segment_command (0xfffa)
 
segment_header.segment_type = 0xfffa
 
segment_header.length_dw = 0x5
 
vhca_id = 0x0
 
segment_called = 0x2000
 
index1 = 0x21
 
index2 = 0x0
 
num_of_obj1 = 0x0
 
num_of_obj2 = 0x0
 
RAW DATA:
 
DWORD [0-3]    :0x0005FFFA 0x20000000 0x00000021 0x00000000
 
DWORD [4]      :0x00000000
 
--------------------------------------------------------------------------------
 
                    Segment - segment_notice (0xfff9)
 
segment_header.segment_type = 0xfff9
 
segment_header.length_dw = 0xc
 
syndrome_id = 0x211
 
notice[0] = 0x2000
 
notice[1] = 0x21
 
notice[2] = 0x0
 
notice[3] = 0x0
 
notice[4] = 0x496e7661
 
notice[5] = 0x6c696420
 
notice[6] = 0x52657300
 
notice[7] = 0x0
 
RAW DATA:
 
DWORD [0-3]    :0x000CFFF9 0x00000211 0x00000000 0x00000000
 
DWORD [4-7]    :0x00002000 0x00000021 0x00000000 0x00000000
 
DWORD [8-11]   :0x496E7661 0x6C696420 0x52657300 0x00000000
 
notice msg =  !Invalid Res
 
--------------------------------------------------------------------------------
 
                    Segment - segment_terminate (0xfffb)
 
segment_header.segment_type = 0xfffb
 
segment_header.length_dw = 0x1
 
RAW DATA:
 
DWORD [0]      :0x0001FFFB
 
--------------------------------------------------------------------------------

How to run parsing and save it into a file:

Copy
Copied!

            
            # mstresourceparse --dump-file notice.txt --adb-file fw-4119-rel-16_23_2008.adb –out out_flie.txt
 
write to file:  out_flie.txt