STRUCT MULTI_CS_COMPLETION(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… struct multi_cs_completion(9) β€” from the Kernel API Manual, bestie

okay so picture this: you're deep in the kernel API docs, right, and you bump into struct multi_cs_completion. That's literally the whole vibe of this page β€” it's the little struct that handles multi CS wait completion, and ngl it's giving "small but crucial" main character energy. Let's get into it ✨


🌸 SYNOPSIS 🌸

struct multi_cs_completion {
    struct completion       completion;
    spinlock_t lock;
    s64 timestamp;
    u32 stream_master_qid_map;
    u8 used;
 };

five members, zero skips, we're reading all of them πŸ’–


πŸŽ€ Members πŸŽ€

  • completion β€” the completion for any of the CS in the list. like, any of them β€” that's the whole point, bestie 🫢
  • lock β€” a spinlock guarding the completion structure. yes it's a spinlock, yes it's serious, no you don't get to be cute with it πŸ”’
  • timestamp β€” the timestamp for the multi-CS completion. temporal queen behavior ⏰
  • stream_master_qid_map β€” a bitmap of all the stream masters that this multi-CS is waiting on. all of them. every single one πŸ’€
  • used β€” 1 if it's in use, otherwise 0. that's it, that's the whole field, iconic binary honesty πŸ‘‘
lowkey the most important part: those types are exactly struct completion, spinlock_t, s64, u32, u8 β€” do not freestyle them, fr fr πŸ™ˆ

πŸ¦‹ SEE ALSO πŸ¦‹

the Kernel file ./drivers/accel/habanalabs/common/habanalabs.h, plus this absolute stack of neighbours β€” yes I'm listing every single one, we don't do skipping here πŸ’…

  • 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_hw_queue(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_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 a lot of cross-references and you're gonna read them all. iykyk 🧚

✨ okay so that's the whole page, and here's your cute little sign-off ✨

Straight from ./drivers/accel/habanalabs/common, dated October 2026 β€” that's the source and the version/date, and no I would never leave those out, that would be a crime πŸ’€πŸ’– Go forth and multi-CS-complete responsibly, bestie πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from