ENUM IWL_FW_ERROR_TYPE(9)
π 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
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms