•
•
•
•
•
•
1.
Debug Utilities
This section contains:
mstfwtrace Utility
mstregdump Utility
mstreg Utility
mstlink Utility
mstresourcedump Utility
mstresourceparse 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.
By default, the firmware does not print trace messages. Please contact your FAE for more details on
how to enable firmware tracing.
mstfwtrace Usage
Enter the following command:
# mstfwtrace [options...]
where
-h|--help Print this help message and exit
-d|--device PCI device (BDF)
--tracer_mode Tracer mode [MEM]
--real_ts Print real timestamps in [hh:mm:ss:nsec] format
-i|--irisc iRISC name (use the "all" option after -i)
-s|--stream Run in streaming mode
-m|--mask Trace class mask, use "+" to enable multiple classes or use integer
format, e.g: -m class1+class2+... or 0xff00ff00
•
•
•
When using secure firmware, the user needs to validate that tracer's value is set to "1" to
enable it.
For MLNX_OFED up to 4.6: /sys/kernel/debug/tracing/events/mlx5/fw_tracer/
enable
For MLNX_OFED 4.6 and above: /sys/kernel/debug/tracing/events/mlx5/mlx5_fw/
enable
For linux kernel tracer (when MLNX_OFED is not available): /sys/kernel/debug/
tracing/events/enable