iavf_init_asq(9)

💖 NAME 💖

okay so bestie, we're flipping through the Kernel API Manual and this page is all about iavf_init_asq(9) — the main initialization routine for ASQ. she's the setup girlie for the Admin Send Queue, and yes, the acronym is giving very admin-queue main character energy. ✨

🌸 SYNOPSIS 🌸

enum iavf_status iavf_init_asq (struct iavf_hw *hw );

🎀 ARGUMENTS 🎀

• hw — pointer to the hardware structure. that's it, that's the whole argument list, and she ate 💅

🦋 DESCRIPTION 🦋

okay so this is the main initialization routine for the Admin Send Queue. prior to calling this function, drivers MUST set these fields in the hw->aq structure:

• hw->aq.num_asq_entries
• hw->aq.arq_buf_size

and do NOT hold the lock when calling this, because the memory allocation routines called are not going to be atomic context safe. no cap, that part is important 😭

🚨 bestie warning: do NOT hold the lock when calling this. the memory allocation routines called are not going to be atomic context safe. that is not a vibe. periodt.

🌈 SEE ALSO 🌈

the kernel file is ./drivers/net/ethernet/intel/iavf/iavf_adminq.c, and the whole see-also friend group is:

• iavf_alloc_adminq_asq_ring(9)
• iavf_alloc_adminq_arq_ring(9)
• iavf_free_adminq_asq(9)
• iavf_free_adminq_arq(9)
• iavf_alloc_arq_bufs(9)
• iavf_alloc_asq_bufs(9)
• iavf_free_arq_bufs(9)
• iavf_free_asq_bufs(9)
• iavf_config_asq_regs(9)
• iavf_config_arq_regs(9)
• iavf_init_arq(9)
• iavf_shutdown_asq(9)
• iavf_shutdown_arq(9)
• iavf_init_adminq(9)
• iavf_shutdown_adminq(9)
• iavf_clean_asq(9)
• iavf_asq_done(9)
• iavf_asq_send_command(9)
• iavf_fill_default_direct_cmd_desc(9)
• iavf_clean_arq_element(9)

mwah 💋 — source/version: ./drivers/net/ethernet/intel/iavf, dated October 2026. that's the whole page, bestie, go make that ASQ proud 🫶👑