dpdmai_get_tx_queue(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dpdmai_get_tx_queue — Kernel API Manual, bestie edition

okay so this is a page from the Kernel API Manual, and it's all about dpdmai_get_tx_queue — yeah, the name is a mouthful, we're gonna get through it together 🫶

✨ NAME ✨

dpdmai_get_tx_queue — retrieve Tx queue attributes. that's it, that's the whole gig 🎀 it goes and fetches the attributes of a transmit queue for you, no cap.

🌸 SYNOPSIS 🌸

int dpdmai_get_tx_queue (struct fsl_mc_io *mc_io , u32 cmd_flags , u16
token , u8 queue_idx , u8 priority , struct dpdmai_tx_queue_attr *attr
);

literally copy it exactly like that, spacing and all, because the synopsis is iconic and we don't touch it 💅 it returns an int, so yk it's gonna tell you how it went.

🦋 ARGUMENTS 🦋

six of them, count 'em, and every single one matters:

  • mc_io — pointer to the MC portal's I/O object, so basically the little doorway your command goes through 🚪 you gotta hand it over.
  • cmd_flags — command flags, and they're one or more of MC_CMD_FLAG_ (yes, the trailing underscore is part of the vibe, keep it).
  • token — the token of the DPDMAI object 🎟️ like your ticket that says "yes this object, right here."
  • queue_idx — the DMA queue index. just a lil number pointing at which queue you mean 🔢
  • priority — selects the queue relative to the number of priorities configured at DPDMAI creation 👑 so like, the priority layout got set up when the DPDMAI was made, and this picks the queue in relation to that.
  • attr — the returned DMA Tx queue attributes 💖 this is the output, the whole reason we're here, the payoff.

⭐ RETURN ⭐

so um. the page has a RETURN section and it's... empty 🫠 like genuinely nothing listed under it. no return values spelled out. the function signature says int, but this section is giving nothing and we're not gonna invent facts, so: consider this the blank space where a return description would live. iconic of it tbh 💀

💜 SEE ALSO 💜

go read these next, bestie, they're all in the kernel file ./drivers/dma/fsl-dpaa2-qdma/dpdmai.c and they're all siblings of this function:

reminder that cmd_flags wants one or more of MC_CMD_FLAG_ — don't just make stuff up, use the real flag names, iykyk 🙈

and that's the page, bestie 🌈 this one lives in ./drivers/dma/fsl-dpaa2-qdma and it's dated October 2026 — so yeah, future girl summer 🌸 mwah, go read dpdmai_get_rx_queue(9) next, the pair is iconic ✨

📦 where this page comes from