refill_fl(9)

💅 refill_fl(9) — the Kernel API Manual glow-up 🦋

okay so bestie, welcome to refill_fl(9) from the Kernel API Manual — yes the manual name is literally part of the vibe, we're keeping it. this is the page about refilling an SGE RX buffer ring and honestly? it's giving maintenance-core and we're obsessed 💖

---

✨ NAME ✨

refill_fl — refill an SGE RX buffer ring 🎀

---

✨ SYNOPSIS ✨

unsigned int refill_fl (struct adapter *adapter , struct sge_fl *fl ,
int n , gfp_t gfp );

---

✨ ARGUMENTS ✨

• adapter — the adapter, the main character of this whole situation 👑
• fl — the Free List ring we're refilling, like restocking the snack drawer but for packets 🍓
• n — how many new buffers we're allocating, no cap 🫶
• gfp — the gfp flags for the allocations, iykyk 🌸

---

✨ DESCRIPTION ✨

so what this does is (re)populate an SGE free-buffer queue with up to n new packet buffers, allocated using the supplied gfp flags. literally feeding the ring, iconic behavior 💅

⚠️ okay important caveat bestie: the caller must assure that n does not exceed the queue's capacity — i.e. (cidx == pidx) _IN EGRESS QUEUE UNITS_ indicates an empty Free List! like, that's the vibe check you gotta pass before calling, fr fr 😭

it returns the number of buffers allocated. and if afterwards the queue is found critically low, it marks it as starving in the bitmap of starving FLs — dramatic but valid 💀

---

✨ SEE ALSO ✨

Kernel file ./drivers/net/ethernet/chelsio/cxgb4vf/sge.c — the source, the mothership 🧚

and the whole friend group 🌈:

• get_buf_addr(9)
• is_buf_mapped(9)
• need_skb_unmap(9)
• txq_avail(9)
• fl_cap(9)
• fl_starving(9)
• map_skb(9)
• free_tx_desc(9)
• reclaim_completed_tx(9)
• get_buf_size(9)
• free_rx_bufs(9)
• unmap_rx_buf(9)
• ring_fl_db(9)
• set_rx_sw_desc(9)
• alloc_ring(9)
• sgl_len(9)
• flits_to_desc(9)
• is_eth_imm(9)
• calc_tx_flits(9)
• write_sgl(9)
• ring_tx_db(9)
• inline_tx_skb(9)
• t4vf_eth_xmit(9)
• copy_frags(9)
• t4vf_pktgl_to_skb(9)
• t4vf_pktgl_free(9)
• do_gro(9)
• t4vf_ethrx_handler(9)
• is_new_response(9)
• restore_rx_bufs(9)
• rspq_next(9)
• process_responses(9)
• napi_rx_handler(9)
• t4vf_intr_handler(9)
• sge_rx_timer_cb(9)
• sge_tx_timer_cb(9)
• bar2_address(9)
• t4vf_sge_alloc_rxq(9)
• t4vf_sge_alloc_eth_txq(9)
• t4vf_free_sge_resources(9)
• t4vf_sge_start(9)
• t4vf_sge_stop(9)
• t4vf_sge_init(9)

---

and that's the page bestie, go refill some rings responsibly 🦋✨

so like, this came from ./drivers/net/ethernet/chelsio... and it's dated October 2026, periodt 💜