__libie_ctlq_xn_push_free(9)
β¨ __libie_ctlq_xn_push_free(9) β¨
okay so bestie, this page is straight out of the Kernel API Manual and it's giving "tiny function, big responsibilities" energy π like it's literally one bool and two pointers but the whole controlq world depends on it, iykyk.
πΈ NAME πΈ
__libie_ctlq_xn_push_free β unsafely push an xn entry into the free list π
yes bestie the unsafely is right there in the name, that's not me being dramatic, that's the manpage being dramatic. read it and respect it π«Ά
π¦ SYNOPSIS π¦
bool __libie_ctlq_xn_push_free (struct libie_ctlq_xn_manager *xnm ,
struct libie_ctlq_xn *xn );
π ARGUMENTS π
xnmβ the Xn transaction manager β¨ like, the boss of the whole xn situation, main character energy frxnβ the xn entry to be added into the free list π¦ this is the lil guy going home to the free pile
β RETURN β
returns a bool that tells you whether xnm destruction can be triggered by the caller π so like. the function hands you back the vibe check on whether you're the one who gets to tear the manager down. no cap, that's important, don't sleep on it π
π SEE ALSO π
the whole friend group π starting with the source file itself:
- Kernel file
./drivers/net/ethernet/intel/libie/controlq.c 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_deinit_dma(9)libie_ctlq_xn_init_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)
that's the whole squad, go read them too, they ate π β¨
and that's a wrap bestie π this iconic lil page came from ./drivers/net/ethernet/intel/l... and it's dated October 2026, so go forth, push your xn entries, and remember: it literally says unsafely in the name ππ₯ π§π
π¦ 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