STRUCT HL_INFO_CLK_THROTTLE(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

🌸 NAME 🌸

struct hl_info_clk_throttle β€” clock throttling reason πŸ’…βœ¨ and yes bestie, this is the struct hl_info_clk_throttle(9) page from the Kernel API Manual, so buckle up 🫢


✨ SYNOPSIS ✨

Okay so here's the whole struct, no cap β€” copy it exactly if you're typing it out, because we do not freehand kernel structs in this group chat πŸ˜­πŸ’€

       struct hl_info_clk_throttle {
           __u32 clk_throttling_reason;
           __u32 pad;
           __u64 clk_throttling_timestamp_us[HL_CLK_THROTTLE_TYPE_MAX];
           __u64 clk_throttling_duration_ns[HL_CLK_THROTTLE_TYPE_MAX];
        };

And yeah, there's a pad field in there too β€” the Members list on this page doesn't give it its own little paragraph, so I'm not gonna invent lore for it πŸ™ˆ it's just present in the struct, periodt.


πŸ’« Members πŸ’«

  • clk_throttling_reason β€” each bit represents a clk throttling reason πŸ‘‘ so like, bit-by-bit, that's the reason map, iykyk.
  • clk_throttling_timestamp_us β€” represents CPU timestamp in microseconds of the start-event πŸ• this one's a __u64 array sized HL_CLK_THROTTLE_TYPE_MAX in the struct, and it's giving timestamp energy for the start-event, fr fr.
  • clk_throttling_duration_ns β€” the clock throttle time in nanosec πŸ’… yes, nanosec exactly as written β€” that's the duration field, and it's also a __u64 array sized HL_CLK_THROTTLE_TYPE_MAX 🌸
tiny note bestie: the struct also has __u32 pad; in the synopsis, but this page doesn't give it a separate member description, so we're just acknowledging it and moving on 🫢

πŸ¦‹ SEE ALSO πŸ¦‹

Go peek at these, bestie πŸ‘€ the whole little kernel-adjacent friend group is here:

  • Kernel file ./include/uapi/drm/habanalabs_accel.h enum
  • hl_goya_dma_direction(9)
  • enum hl_device_status(9)
  • struct hl_info_hw_ip_info(9)
  • struct hl_info_pci_counters(9)
  • struct hl_info_energy(9)
  • struct hl_open_stats_info(9)
  • struct hl_power_info(9)
  • struct hl_info_sync_manager(9)
  • struct hl_info_cs_counters(9)
  • struct hl_info_last_err_open_dev_time(9)
  • struct hl_info_cs_timeout_event(9)
  • struct hl_info_razwi_event(9)
  • struct hl_info_undefined_opcode_event(9)
  • struct hl_info_hw_err_event(9)
  • struct hl_info_fw_err_event(9)
  • struct hl_info_engine_err_event(9)
  • struct hl_info_dev_memalloc_page_sizes(9)
  • struct hl_page_fault_info(9)
  • struct hl_user_mapping(9)
  • struct hl_info_args(9)

okay bye bestie 🫢 this page's footer tea is: source/version ./include/uapi/drm, date October 2026, and the title is literally struct hl_info_clk_throttle(9) β€” iconic, no notes πŸ’…βœ¨

πŸ“¦ where this page comes from