---
name: "mstfwtrace"
section: "1"
platform: "linux"
package: "mstflint"
version: "4.31.0+1-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mstfwtrace"
---

# mstfwtrace(1)

Extracts and prints trace messages generated by the firmware of 5th generation devices

## NAME

mstfwtrace - Extracts and prints trace messages generated by the firmware of 5th generation devices

## DESCRIPTION

usage: mstfwtrace **-d**\|--device DEVICE \[options\]

### optional arguments:

- **-h**, **--help**

  show this help message and exit

- **-v**, **--version**, **-v**

  Print tool version.

## OPTIONS

- **-d** DEVICE, **--device** DEVICE

  PCI device name

- **--tracer\_mode** TRACER\_MODE

  Tracer mode \[MEM\]

- **--real\_ts**

  Print real timestamps in \[hh:mm:ss:nsec\]

- **--ignore\_old\_events**

  Ignore collecting old events

### Format:

- **-i** IRISC, **--irisc** IRISC

  Irisc name \[all\]

- **-s**, **--stream**

  Run in streaming mode

- **-m** MASK, **--mask** MASK

  Trace class mask, use "+" to enable multiple classes or use integer format, e.g: **-m** class1+class2+... or 0xff00ff00

- **-l** LEVEL, **--level** LEVEL

  Trace level

Device Specific Info: ====================

-

  ConnectIB: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  SwitchIB: Trace classes:

-

  class1, class2

-

  ConnectX4: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  ConnectX5: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  BlueField: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  ConnectX6: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  ConnectX6DX: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  Spectrum: Trace classes:

-

  class1, class2

-

  ConnectX4LX: Trace classes:

-

  DEBUG\_INIT, INIT, ICM, ICM\_FREE\_LIST, HOST\_MNG CMD\_IF, PHY\_IB, PHY\_RX\_ADAP, PHY\_EYE\_OPN, PHY\_COMMON PHY\_MANAGER, PWR, FLR, ICM\_ACCESS, MAD RXT\_CHECKS, I2C, TRANSPORT, FW\_LL, RX\_ERRORS CMD\_DRIVER, PROFILING, MANAGEMENT, FLASH, STEERING IFARM, ICMD, PCI, DC\_CLEANUP, PHY\_ETH VIRT

-

  SwitchIB2: Trace classes:

-

  class1, class2

-

  Quantum: Trace classes:

-

  class1, class2

-

  Spectrum2: Trace classes:

-

  class1, class2

## SEE ALSO

**[mstflint(1)](/mstflint/1.md)**