Debug Utilities
This section contains:
•
mstfwtrace Utility
•
mstregdump Utility
•
mstreg Utility
•
mstlink Utility
•
mstresourcedump Utility
mstfwtrace Utility
The mstfwtrace utility extracts and prints trace messages generated by the firmware running on 5th
generation (Group II) devices iRISCs.
These trace messages inform developers of software drivers about internal status, events, critical
errors, etc. Trace messages generated by iRISCs are stored in the trace buffer. The trace buffer is
located in host memory.
When using secure firmware, the user needs to validate that the value "1" is set to /sys/kernel/
debug/tracing/events/mlx5/fw_tracer/enable.
By default, the firmware does not print trace messages. Please contact your FAE for more details on
how to enable firmware tracing.
mstfwtrace Usage
1.
Enter the following command:
# mstfwtrace [options...]
where
-h|--help
-d|--device
--tracer_mode
--real_ts
-i|--irisc
-s|--stream
-m|--mask
-l|--level
-v|--version
--ignore_old_events
Device-Specific Information:
Print this help message and exit
PCI device (BDF)
Tracer mode [MEM]
Print real timestamps in [hh:mm:ss:nsec] format
iRISC name (use the "all" option after -i)
Run in streaming mode
Trace class mask, use "+" to enable multiple classes or use
integer format, e.g: -m class1+class2+... or 0xff00ff00
Trace level
Print tool's version and exit
Ignore collecting old events
83