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