libie_ctlq_xn_init_dma(9)
π libie_ctlq_xn_init_dma β the kernel API manual, bestie edition π
okay so picture this: you're deep in the libie control queue code (iykyk πΈ), and this little function is the one that pre-allocates DMA memory for send messages that use stack variables. basically it's the responsible friend who books the venue before the party, so nothing has to be scrambled together last minute. iconic behavior honestly π
β¨ SYNOPSIS β¨
int libie_ctlq_xn_init_dma (struct device *dev , struct libie_ctlq_xn_manager *xnm );
π¦ ARGUMENTS π¦
devβ the device pointer. like, the actual hardware situation you're doing this for πxnmβ pointer to the transaction manager. the main character of this whole operation, fr fr β¨
π RETURN π
0 on success, or an error if memory allocation fails π (yes bestie, allocation can flop β that's just life)
π SEE ALSO π
π«Ά the kernel file
- Kernel file
./drivers/net/ethernet/intel/libie/controlq.c
πΈ the whole friend group, in order
libie_ctlq_free_fq(9)libie_ctlq_init_fq(9)libie_ctlq_prep_rx_desc(9)libie_ctlq_post_rx_buffs(9)libie_ctlq_free_tx_msgs(9)libie_ctlq_alloc_tx_msgs(9)libie_cp_free_desc_mem(9)libie_ctlq_dealloc_ring_res(9)libie_cp_alloc_desc_mem(9)libie_ctlq_alloc_queue_res(9)libie_ctlq_init_regs(9)libie_find_ctlq(9)libie_ctlq_add(9)libie_ctlq_remove(9)libie_ctlq_init(9)libie_ctlq_deinit(9)libie_ctlq_tx_desc_from_msg(9)libie_ctlq_send_desc_avail(9)libie_ctlq_send(9)libie_ctlq_send_clean(9)libie_ctlq_fill_rx_msg(9)libie_ctlq_recv(9)libie_ctlq_xn_pop_free(9)__libie_ctlq_xn_push_free(9)libie_ctlq_xn_push_free(9)libie_ctlq_xn_deinit_dma(9)libie_ctlq_xn_process_recv(9)libie_xn_check_async_timeout(9)libie_ctlq_xn_recv(9)libie_cp_map_dma_mem(9)libie_cp_unmap_dma_mem(9)libie_ctlq_xn_process_send(9)libie_ctlq_xn_send(9)struct libie_ctlq_xn_rel_tx_ctx(9)libie_ctlq_xn_rel_tx_buf(9)libie_ctlq_xn_send_clean(9)libie_ctlq_xn_shutdown(9)libie_ctlq_xn_deinit(9)libie_ctlq_xn_init(9)
heads up bestie: it's a pre-allocation situation, so if the memory allocation fails you're getting a non-zero error back β check your return value, don't just vibe past it π
and that's the page!! π
this one's sourced from ./drivers/net/ethernet/intel/l..., dated October 2026, and yes the manual section is libie_ctlq_xn_init_dma(9) β bookmark it, screenshot it, send it to the group chat π«Άβ¨π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms