t4_read_cim_obq(9)

📦 version 7.3.1, in nixpkgs unstable

💅 t4_read_cim_obq — read the contents of a CIM outbound queue

okay so bestie, welcome to the Kernel API Manual ✨ this one's about t4_read_cim_obq, and it's honestly a whole vibe. grab a snack, we're reading a queue 🍓

✨ SYNOPSIS ✨

int t4_read_cim_obq (struct adapter *adap , unsigned int qid , u32 *data
, size_t n );

like, that's the whole signature. she's compact, she's iconic 👑

🎀 ARGUMENTS 🎀

  • adap — the adapter. the main character of this whole operation 💅
  • qid — the queue index. which queue we're pulling from, iykyk
  • data — where to store the queue contents. this is the destination, she's empty and waiting 🫶
  • n — capacity of data in 32-bit words. so like, how much room you've got

🌸 DESCRIPTION 🌸

okay so here's what she does: this function reads the contents of the selected CIM queue, starting at address 0, going up to the capacity of data. no skipping ahead, we start from the very beginning, periodt ✨

⚠️ real talk: n must be a multiple of 4. that is not a suggestion, that's a rule, and she will not be flexible about it 💀

and the return value? it's giving dual-purpose:

  • returns < 0 on error 😭
  • returns the number of 32-bit words actually read on success 🔥

so like, don't just check for nonzero — check the sign, bestie. negative means something went wrong, positive means you ate and left no crumbs 👑

🦋 SEE ALSO 🦋

first up, the source file herself:

  • Kernel file ./drivers/net/ethernet/chelsio/cxgb4/t4_hw.c

and now the extended family — honestly there are so many of them, it's giving family reunion 🎉

like, every single one of them. no cap, that's the whole list 🫶

okay that's the page!! mwah 💖 this one came from ./drivers/net/ethernet/chelsio... and she's dated October 2026 — go read some queues, bestie, you're gonna slay 🌈👑

📦 where this page comes from