STRUCT IWL_FW_INI_TRIGGER_TLV(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… NAME πŸ’…

struct iwl_fw_ini_trigger_tlv β€” the trigger TLV, bestie ✨

okay so this is straight out of the Kernel API Manual, and it's giving "small struct, huge responsibility" energy. no cap, this little guy is the thing that decides what gets collected when it goes off. let's get into it πŸŽ€


🌸 SYNOPSIS 🌸

struct iwl_fw_ini_trigger_tlv {
    struct iwl_fw_ini_header hdr;
    __le32 time_point;
    __le32 trigger_reason;
    __le32 apply_policy;
    __le32 dump_delay;
    __le32 occurrences;
    __le32 reserved;
    __le32 ignore_consec;
    __le32 reset_fw;
    __le32 multi_dut;
    __le64 regions_mask;
    __le32 data[];
};

like… the layout ate, honestly πŸ’… every field is exactly where it needs to be.


πŸ¦‹ Members πŸ¦‹

  • hdr β€” the debug header, aka the lil intro before the main character speaks πŸ‘‘
  • time_point β€” the time point. literally one of enum iwl_fw_ini_time_point, no improvising ✨
  • trigger_reason β€” the trigger reason, iykyk 🫢
  • apply_policy β€” uses enum iwl_fw_ini_trigger_apply_policy πŸŽ€
  • dump_delay β€” delay from trigger fire to dump, in usec. yes the unit matters, don't @ me πŸ’€
  • occurrences β€” max trigger fire occurrences allowed. it's giving "know your limits" πŸ™ˆ
  • reserved β€” unused. it's just sitting there, vibing πŸ¦‹
  • ignore_consec β€” ignore consecutive triggers, in usec ⭐
  • reset_fw β€” if non zero, will reset and reload the FW 😭 so like… mind the gap bestie
  • multi_dut β€” initiate debug dump data on several DUTs πŸ”₯
  • regions_mask β€” mask of regions to collect 🌈
  • data β€” trigger data πŸ’–

✨ Description ✨

so a trigger that, upon firing, determines what regions to collect. that's it, that's the whole vibe β€” it fires, and then it's like "okay bestie, these regions, go" πŸ’… periodt.


🧚 SEE ALSO 🧚

all the related lore lives in the Kernel file ./drivers/net/wireless/intel/iwlwifi/fw/api/dbg-tlv.h, and the friend group is:

  • struct iwl_fw_ini_hcmd(9)
  • struct iwl_fw_ini_header(9)
  • struct iwl_fw_ini_addr_size(9)
  • struct iwl_fw_ini_region_dev_addr_range(9)
  • struct iwl_fw_ini_region_dev_addr(9)
  • struct iwl_fw_ini_region_fifos(9)
  • struct iwl_fw_ini_region_err_table(9)
  • struct iwl_fw_ini_region_special_device_memory(9)
  • struct iwl_fw_ini_region_internal_buffer(9)
  • struct iwl_fw_ini_region_tlv(9)
  • struct iwl_fw_ini_debug_info_tlv(9)
  • struct iwl_fw_ini_allocation_tlv(9)
  • struct iwl_fw_ini_hcmd_tlv(9)
  • struct iwl_fw_ini_addr_val(9)
  • struct iwl_fw_ini_conf_set_tlv(9)
  • enum iwl_fw_ini_config_set_type(9)
  • enum iwl_fw_ini_allocation_id(9)
  • enum iwl_fw_ini_buffer_location(9)
  • enum iwl_fw_ini_region_type(9)
  • enum iwl_fw_ini_time_point(9)
  • enum iwl_fw_ini_trigger_apply_policy(9)
  • enum iwl_fw_ini_trigger_reset_fw_policy(9)
  • enum iwl_fw_ini_dump_policy(9)
  • enum iwl_fw_ini_dump_type(9)

go read them all, they're iconic, mwah πŸ’œ


ngl the source page is ./drivers/net/wireless/intel/i... and it's dated October 2026 β€” that's the whole sign-off bestie, love u, bye πŸ«ΆπŸŽ€βœ¨
πŸ“¦ where this page comes from