hl_ack_pb_with_mask(9)

📦 version 7.3.1, in nixpkgs unstable

💅 hl_ack_pb_with_mask — NAME ✨

okay so bestie, welcome to hl_ack_pb_with_mask(9) from the Kernel API Manual 🫶 — this one is literally hl_ack_pb_with_mask: ack pb with mask in HW according to given configuration. yes that's the whole vibe. it's giving "one job, does it well" 👑

🌸 SYNOPSIS 🌸

void hl_ack_pb_with_mask (struct hl_device *hdev , u32 num_dcores , u32
dcore_offset , u32 num_instances , u32 instance_offset , const u32
pb_blocks[] , u32 blocks_array_size , u64 mask );

no cap, that's the exact signature — copy it character for character or the compiler will absolutely humble you 😭

🎀 ARGUMENTS 🎀

  • hdev — pointer to hl_device structure. it's the main character, the whole device, the moment 💖
  • num_dcores — number of decores to apply configuration to. lowkey important: set it to HL_PB_SHARED if you need to apply only once 👀
  • dcore_offset — the offset between dcores. spacing matters, bestie ✨
  • num_instances — number of instances to apply configuration to. how many little guys are getting the treatment 🦋
  • instance_offset — the offset between instances. yes, also spacing. we love consistency 💅
  • pb_blocks — blocks array. it's an array. of blocks. iconic 🎀
  • blocks_array_size — blocks array size. (the size of the blocks array. iykyk 🌸)
  • mask — enabled instances mask: 1 = enabled, 0 = disabled. that's it, that's the whole bit situation 🧚

🔥 SEE ALSO 🔥

kernel file ./drivers/accel/habanalabs/common/security.c — go read the source, it's highkey the real manpage 💜

and then the whole friend group, in this exact order:

⭐ reminder bestie: mask is 1-enabled / 0-disabled, and num_dcores gets HL_PB_SHARED when you only want to apply it once. those are the two little details that'll get you every time 🙈

alright that's the page!! brought to you by the good people over at ./drivers/accel/habanalabs/common, dated October 2026 — mwah, go ack some pbs responsibly 💖🎀🫶

📦 where this page comes from