reuse_rx_pools(9)

✨ reuse_rx_pools ✨ (that's the reuse_rx_pools(9) kernel API manual, bestie)

Okay so picture this: you're deep in the ibmvnic driver, section 9 of the kernel API manual, and you just need to know one thing — can I keep my existing rx pools or not? That's literally the whole function. Let's get into it 💅

---

🌸 SYNOPSIS 🌸

bool reuse_rx_pools (struct ibmvnic_adapter *adapter );

That's it. One arg, one bool back. Iconic, low-effort, high-value 🫶

---

🎀 ARGUMENTS 🎀

• adapter — the ibmvnic adapter, aka the main character of this whole story. That's the thing you're passing in 💖

---

🦋 DESCRIPTION 🦋

So what this does: it checks whether the rx pools that already exist in the adapter can be reused instead of getting torn down and rebuilt (which, respectfully, is a lot).

The pools can be reused if the pool parameters haven't changed — and there are exactly three of those:

• the number of pools,
• the number of buffers in the pool,
• and the size of each buffer.

If all three are still the same, congratulations, the pools are reusable, no cap ✨

---

💀 NOTE 💀

Heads up bestie, this assumes that all pools have the same number of buffers — which is the case currently. But if that ever changes, we must fix this. So like… don't forget. Fr fr. 😭

---

👑 RETURN 👑

• true if the rx pools can be reused 🙌
• false otherwise 🙈

---

🌈 SEE ALSO 🌈

The kernel file, right here:

• ./drivers/net/ethernet/ibm/ibmvnic.c

And the whole friend group, in order:

• ibmvnic_wait_for_completion(9)
• reuse_ltb(9)
• alloc_long_term_buff(9)
• free_ltb_set(9)
• alloc_ltb_set(9)
• map_rxpool_buf_to_ltb(9)
• map_txpool_buf_to_ltb(9)
• release_rx_pools(9)
• init_rx_pools(9)
• release_tx_pools(9)
• reuse_tx_pools(9)
• init_tx_pools(9)
• get_hdr_lens(9)
• create_hdr_descs(9)
• build_hdr_descs_arr(9)
• do_passive_init(9)

---

That's the whole page, babes 🧚 Go check your pool parameters and slay 💜

Sign-off time: this one lives under ./drivers/net/ethernet/ibm, dated October 2026, and yes, it's giving very much "kernel docs but make it cute" 🎀💖