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.
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
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
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
68