i40e_init_arq(9)

💅 i40e_init_arq — a lil' kernel API manual moment (Kernel API Manual, bestie)

okay so welcome to i40e_init_arq(9), like the page literally called that, and honestly? it's giving "small function, big responsibility." sit down, grab a strawberry 🍓, let's get into it.

---

✨ NAME ✨

i40e_init_arq — initialize ARQ

(ARQ = Admin Receive Queue, and yes she's that girl 💅)

---

🌸 SYNOPSIS 🌸

int i40e_init_arq (struct i40e_hw *hw );

that's it. one function, one argument, returns an int. short and iconic 👑

---

🦋 ARGUMENTS 🦋

• hw — pointer to the hardware structure. like, the whole hardware vibe. hand it over and she'll do her thing 🫶

---

🎀 DESCRIPTION 🎀

So this is the main initialization routine for the Admin Receive (Event) Queue. it sets everything up, it's the main character of arq setup, no cap ✨

But — and this is the important part, bestie, listen — before you call this function, drivers _MUST_ set the following fields in the hw->aq structure:

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

those two. both of them. must. not "should," not "if you feel like it" — MUST. she needs her inputs, okay?? 🙈

⚠️ Do _NOT_ hold the lock when calling this, because the memory allocation routines it calls are not going to be atomic context safe. like, fr fr, do not do that. that's a whole mess you do not want 😭💀

---

👑 SEE ALSO 👑

Kernel file ./drivers/net/ethernet/intel/i40e/i40e_adminq.c — that's the source file, go look at her, she's gorgeous 🌈

and the whole friend group, in this exact order:

• i40e_alloc_adminq_asq_ring(9)
• i40e_alloc_adminq_arq_ring(9)
• i40e_free_adminq_asq(9)
• i40e_free_adminq_arq(9)
• i40e_alloc_arq_bufs(9)
• i40e_alloc_asq_bufs(9)
• i40e_free_arq_bufs(9)
• i40e_free_asq_bufs(9)
• i40e_config_asq_regs(9)
• i40e_config_arq_regs(9)
• i40e_init_asq(9)
• i40e_shutdown_asq(9)
• i40e_shutdown_arq(9)
• i40e_set_hw_caps(9)
• i40e_init_adminq(9)
• i40e_shutdown_adminq(9)
• i40e_clean_asq(9)
• i40e_asq_done(9)
• i40e_asq_send_command_atomic_exec(9)
• i40e_asq_send_command_atomic(9)
• i40e_asq_send_command_atomic_v2(9)
• i40e_fill_default_direct_cmd_desc(9)
• i40e_clean_arq_element(9)

the whole squad. iykyk 💜

---

okay that's the page!! and for the cute sign-off: this lil' beauty lives in ./drivers/net/ethernet/intel/i40e, and it's dated October 2026 — so she's from the future, slay 🧚⭐

periodt. go initialize that queue, bestie 💖🔥