MSTFWTRACE(1)

πŸ“¦
version 4.37.0_1.1 Β· 3 versions
, in centos-stream 10, centos-stream 9, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ mstfwtrace ✨

okay so bestie, this is the User Commands girlie of the manual pages, and she's called mstfwtrace πŸ’– she comes from mstflint and she's dated March 2020, and she is so good at her job, iykyk 🫢


πŸŽ€ NAME πŸŽ€

mstfwtrace β€” extracts and prints trace messages generated by the firmware of 5th generation devices πŸ’…βœ¨

like. she pulls the firmware's little diary entries out of the silicon and shows them to you. no cap.


πŸ¦‹ DESCRIPTION πŸ¦‹

the vibe, the usage, the whole thing:

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

that's it. that's the energy. -d or --device plus your options and off you go 🌸

πŸ’œ optional arguments

  • -h, --help β€” show this help message and exit πŸ₯° (she's helpful AND polite)
  • -v, --version, -v β€” print tool version. yes she wrote -v twice, and honestly? iconic. not a typo, a choice πŸ’€

πŸ”₯ OPTIONS πŸ”₯

  • -d DEVICE, --device DEVICE β€” PCI device name πŸ’– (this is the one you actually need, bestie, don't skip her)
  • --tracer_mode TRACER_MODE β€” tracer mode, default is MEM ✨
  • --real_ts β€” print real timestamps, in [hh:mm:ss:nsec] format πŸ•°οΈ so you actually know when things happened
  • --ignore_old_events β€” ignore collecting old events πŸ™ˆ (not me, ignoring my past)

🌈 Format:

  • -i IRISC, --irisc IRISC β€” Irisc name, defaults to all 🧚
  • -s, --stream β€” run in streaming mode 🌊 it's giving live feed
  • -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: ====================

okay so this is the part where she lists every single device and which trace classes each one has. do NOT skim, bestie, every one of these is real and every list is exactly as written πŸ’–

⭐ 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
lowkey a lot of these devices have the exact same list, and yes, bestie, that's not me being lazy, that's literally what the page says. do not merge them. do not "clean them up". leave them alone πŸ’€

🌸 SEE ALSO 🌸


and that's the whole thing πŸ’– written by mstflint, March 2020, page MSTFWTRACE(1), and she ate, no crumbs. go trace some firmware, bestie βœ¨πŸ‘‘πŸŒˆ

πŸ“¦ where this page comes from