ENUM IWL_FW_ERROR_TYPE(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… enum iwl_fw_error_type πŸ’…

okay so this is a page from the Kernel API Manual (enum iwl_fw_error_type(9)) and it's literally all about telling you why your wifi firmware threw a tantrum. every possible reason, enumerated, no cap. let's get into it 🫢


✨ NAME ✨

enum iwl_fw_error_type β€” FW error types/sources 🌸

like, the whole taxonomy of "what went wrong bestie" for the firmware. iconic honestly.


πŸ¦‹ SYNOPSIS πŸ¦‹

enum iwl_fw_error_type {
    IWL_ERR_TYPE_IRQ ,
    IWL_ERR_TYPE_NMI_FORCED ,
    IWL_ERR_TYPE_RESET_HS_TIMEOUT ,
    IWL_ERR_TYPE_CMD_QUEUE_FULL ,
    IWL_ERR_TYPE_TOP_RESET_BY_BT ,
    IWL_ERR_TYPE_TOP_FATAL_ERROR ,
    IWL_ERR_TYPE_TOP_RESET_FAILED ,
    IWL_ERR_TYPE_DEBUGFS

};

look at her. eight little constants, all lined up, all ready to snitch on your device πŸ’€


πŸŽ€ Constants πŸŽ€

  • IWL_ERR_TYPE_IRQ β€” the "normal" FW error, coming at you through an IRQ πŸ’– (yes, "normal" is in quotes in the original too β€” the vibes are immaculate, the error is not)
  • IWL_ERR_TYPE_NMI_FORCED β€” the driver straight up forced an NMI. not the hardware's idea, not a coincidence, the driver did that on purpose πŸ”₯
  • IWL_ERR_TYPE_RESET_HS_TIMEOUT β€” the reset handshake timed out 😭 and here's the important part: any debug collection has to happen synchronously, because the device is going to be shut down. like, collect your receipts now bestie, the door is closing πŸšͺπŸ’¨
  • IWL_ERR_TYPE_CMD_QUEUE_FULL β€” command queue was full. too many girlies in the queue, literally πŸ™ˆ
  • IWL_ERR_TYPE_TOP_RESET_BY_<wbr>BT β€” a TOP reset that was initiated by BT πŸ¦‹
  • IWL_ERR_TYPE_TOP_FATAL_ERROR β€” TOP fatal error πŸ’€ that's it, that's the description, and honestly? it ate. fatal is fatal.
  • IWL_ERR_TYPE_TOP_RESET_FAILED β€” the TOP reset failed. a reset that reset nothing. embarrassing for everyone involved 😭
  • IWL_ERR_TYPE_DEBUGFS β€” an error/reset indication coming from debugfs ⭐

πŸ‘‘ SEE ALSO πŸ‘‘

go read these next, bestie, they're the supporting cast and they all understood the assignment:

  • Kernel file ./drivers/net/wireless/intel/iwlwifi/iwl-op-mode.h
  • Operational mode - what is it ?(9)
  • Life cycle of the Operational mode(9)
  • enum iwl_fw_error_context(9)
  • struct iwl_fw_error_dump_mode(9)
  • struct iwl_op_mode_ops(9)
  • struct iwl_op_mode(9)

quick reminder that IWL_ERR_TYPE_RESET_HS_TIMEOUT is the dramatic one β€” debug collection must happen synchronously because the device is getting shut down. no time for a lil coffee break, fr fr πŸ’…

🌈 that's the whole page! brought to you by the kernel docs at ./drivers/net/wireless/intel/i..., dated October 2026, living under the title enum iwl_fw_error_type(9). mwah, go read your dmesg responsibly πŸ’œβœ¨

πŸ“¦ where this page comes from