STRUCT HL_HW_QUEUE(9)

🌸 struct hl_hw_queue(9) — Kernel API Manual 🌸

okay bestie, welcome to the struct hl_hw_queue(9) page — yes, the manual name is right there, no cap. This whole page is about struct hl_hw_queue, and its job is literally to describe a H/W transport queue. Think of it as the profile card for one hardware queue: every field gets its little moment, and we are not skipping any of them. 💅

✨ NAME ✨

struct hl_hw_queue — describes a H/W transport queue. iconic, concise, done. 🎀

🦋 SYNOPSIS 🦋

this is the struct in all its exact, character-for-character glory:

       struct hl_hw_queue {
           struct hl_cs_job                        **shadow_queue;
           struct hl_sync_stream_properties        sync_stream_prop;
           enum hl_queue_type                      queue_type;
           enum hl_collective_mode                 collective_mode;
           void *kernel_address;
           dma_addr_t bus_address;
           u64 pq_dram_address;
           u32 pi;
           atomic_t ci;
           u32 hw_queue_id;
           u32 cq_id;
           u32 msi_vec;
           u16 int_queue_len;
           u8 valid;
           u8 supports_sync_stream;
           u8 dram_bd;
        };

💖 Members 💖

• shadow_queue — pointer to a shadow queue that holds pointers to jobs. it's giving backstage-pass energy: the shadow queue keeps the job pointers. 🫶
• sync_stream_prop — sync stream queue properties. lowkey just the property bag for the sync stream queue. ✨
• queue_type — type of queue. simple, iconic, no notes. 👑
• collective_mode — collective mode of current queue. yes bestie, the current queue's collective mode. 💅
• kernel_address — holds the queue's kernel virtual address. that's the kernel virtual address, periodt. 🧚
• bus_address — holds the queue's DMA address. DMA address says hi. 🌈
• pq_dram_address — holds the dram address when the PQ is allocated, used when dram_bd is true in queue properties. fr fr, that's the dram-address situation. 🍓
• pi — holds the queue's pi value. no cap. 🔥
• ci — holds the queue's ci value, AS CALCULATED BY THE DRIVER (not real ci). this is the important one, bestie. 😭
• hw_queue_id — the id of the H/W queue. 🎀
• cq_id — the id for the corresponding CQ for this H/W queue. CQ is right there, and it's matching. 🦋
• msi_vec — the IRQ number of the H/W queue. 💥
• int_queue_len — length of internal queue (number of entries). 🌸
• valid — is the queue valid (we have array of 32 queues, not all of them exist). so not every single one of those 32 queues is out here existing, and that's the vibe check. ⭐
• supports_sync_stream — True if queue supports sync stream. capital-T True, periodt. 🧚
• dram_bd — True if the bd should be copied to dram, needed for PQ which has been allocated on dram. 🌈

🌈 SEE ALSO 🌈

bestie, the SEE ALSO list is long and it ate. keeping every single ref, same order, no skips:

• Kernel file ./drivers/accel/habanalabs/common/habanalabs.h
• enum hl_mmu_page_table_location(9), struct iterate_module_ctx(9), struct hl_gen_wait_properties(9), struct pgt_info(9), enum hl_pci_match_mode(9), enum hl_fw_component(9), enum hl_fw_types(9), enum hl_queue_type(9), struct hw_queue_properties(9), enum vm_type(9)
• enum mmu_op_flags(9), enum hl_device_hw_state(9), struct hl_mmu_properties(9), struct hl_hints_range(9), struct asic_fixed_properties(9), struct hl_fence(9), struct hl_cs_compl(9), struct hl_ts_buff(9), struct hl_mem_mgr(9), struct hl_mem_mgr_fini_stats(9)
• struct hl_mmap_mem_buf_behavior(9), struct hl_mmap_mem_buf(9), struct hl_cb(9), struct hl_sync_stream_properties(9), struct hl_encaps_signals_mgr(9), struct hl_cq(9), struct hl_ts_free_jobs(9), struct hl_user_interrupt(9), struct timestamp_reg_free_node(9), struct hl_user_pending_interrupt(9)
• struct hl_eq(9), struct hl_dec(9), enum hl_asic_type(9), enum hl_pm_mng_profile(9), enum hl_pll_frequency(9), struct pci_mem_region(9), struct static_fw_load_mgr(9), struct fw_response(9), struct dynamic_fw_load_mgr(9), struct pre_fw_load_props(9)
• struct fw_image_props(9), struct fw_load_mgr(9), struct engines_data(9), struct hl_asic_funcs(9), enum hl_va_range_type(9), struct hl_va_range(9), struct hl_cs_counters_atomic(9), struct hl_dmabuf_priv(9), struct hl_cs_outcome(9), struct hl_cs_outcome_store(9)
• struct hl_ctx(9), struct hl_ctx_mgr(9), struct hl_userptr(9), struct hl_cs(9), struct hl_cs_job(9), struct hl_cs_parser(9), struct hl_vm_hash_node(9), struct hl_vm_hw_block_list_node(9), struct hl_vm_phys_pg_pack(9), struct hl_vm_va_block(9)
• struct hl_vm(9), struct hl_debug_params(9), struct hl_notifier_event(9), struct hl_fpriv(9), struct hl_info_list(9), struct hl_debugfs_entry(9), struct hl_dbg_device_entry(9), struct hl_debugfs_cfg_access_entry(9), struct hl_debugfs_cfg_access(9), struct hl_hw_obj_name_entry(9)
• struct hl_mon_state_dump(9), struct hl_sync_to_engine_map_entry(9), struct hl_sync_to_engine_map(9), struct hl_state_dump_specs_funcs(9), struct hl_state_dump_specs(9), struct hl_device_reset_work(9), struct hl_mmu_priv(9), struct hl_mmu_per_hop_info(9), struct hl_mmu_hop_info(9), struct hl_hr_mmu_funcs(9)
• struct hl_mmu_funcs(9), struct hl_prefetch_work(9), struct multi_cs_completion(9), struct multi_cs_data(9), struct hl_clk_throttle_timestamp(9), struct hl_clk_throttle(9), struct user_mapped_block(9), struct cs_timeout_info(9), struct undefined_opcode_info(9), struct page_fault_info(9)
• struct razwi_info(9), struct hw_err_info(9), struct fw_err_info(9), struct engine_err_info(9), struct hl_error_info(9), struct hl_reset_info(9), struct eq_heartbeat_debug_info(9), struct hl_device(9), struct hl_cs_encaps_sig_handle(9), struct hl_info_fw_err_info(9)
• hl_ioctl_t(9), struct hl_ioctl_desc(9), hl_get_sg_info(9), hl_mem_area_inside_range(9), hl_mem_area_crosses_range(9)

that's the whole page, bestie — source/version is ./drivers/accel/habanalabs/common, date October 2026, for the struct hl_hw_queue(9) page. mwah 💋✨