hl_state_dum...ock_monitors(9)

💅 hl_state_dum...ock_monitors 💅

okay so bestie, welcome to the Kernel API Manual — yes we're in the kernel docs now, and honestly? it's giving backstage pass energy 🎀. This one lives in hl_state_dum...ock_monitors(9), which is the truncated little nickname for a function with a whole government name: hl_state_dump_alloc_read_sm_block_monitors. she's long, she's iconic, she ate. 💅

---

✨ NAME ✨

hl_state_dump_alloc_read_sm_block_monitors — reads the monitors for one specific block, no cap 🫶

---

🌸 SYNOPSIS 🌸

struct hl_mon_state_dump * hl_state_dump_alloc_read_sm_block_monitors
(struct hl_device *hdev , u32 index );

literally that's the whole signature, copy it exactly bestie, don't get creative with the spacing 💀

---

🦋 ARGUMENTS 🦋

• hdev — pointer to the device. yes, the device device. the main character 🫶
• index — the sync manager block index, and it starts with E_N — like, that's the starting point, keep that in mind 🌈

---

👑 DESCRIPTION 👑

so what does she actually do? she returns an array of monitor data of size SP_MONITORS_AMOUNT — that's the size, exactly that, SP_MONITORS_AMOUNT ✨ — or NULL on error 😭. that's it. that's the whole vibe check. you ask for the monitors of a specific block, you either get a whole array of them or you get nothing at all. no in-between, periodt.

ngl, if you get NULL back that's the error path — don't go dereferencing it and then act surprised 💀

---

🎀 SEE ALSO 🎀

• Kernel file ./drivers/accel/habanalabs/common/state_dump.c — that's her house, that's where she lives 🏠
• hl_format_as_binary(9)
• resize_to_fit(9)
• hl_snprintf_resize(9)
• hl_sync_engine_to_string(9)
• hl_print_resize_sync_engine(9)
• hl_state_dump_get_sync_name(9)
• hl_state_dump_get_monitor_name(9)
• hl_state_dump_free_sync_to_engine_map(9)
• hl_state_dump_get_sync_to_engine(9)
• hl_state_dump_read_sync_objects(9)
• hl_state_dump_free_sync_objects(9)
• hl_state_dump_print_syncs_single_block(9)
• hl_state_dump_print_syncs(9)
• hl_state_dump_free_monitors(9)
• hl_state_dump_print_monitors_single_block(9)
• hl_state_dump_print_monitors(9)
• hl_state_dump_print_engine_fences(9)
• hl_state_dump_print_fences(9)
• hl_state_dump(9)

that's the whole friend group, go say hi to all of them, they're all linked, iykyk 🔥

---

and that's the page bestie!! 🧚 this little gem comes to you from ./drivers/accel/habanalabs/common, dated October 2026 — so like, future vibes but make it kernel 🦋. go read your state dumps, stay hydrated, and remember: SP_MONITORS_AMOUNT or NULL, there is no third option 💖✨