pdc_receive_one(9)

📦 version 7.3.1, in nixpkgs unstable

💌 pdc_receive_one(9) — from the Kernel API Manual

okay bestie, welcome to the group chat. this one's about pdc_receive_one, a kernel function that literally just goes and grabs one (1) response message from one (1) SPU. that's the whole vibe. ✨

🌸 NAME 🌸

pdc_receive_one — receive a response message from a given SPU. yep, that's it. one message. one SPU. she's focused, she's slaying, she's not doing extra credit. 💅

🎀 SYNOPSIS 🎀

int pdc_receive_one (struct pdc_state *pdcs );

like, copy-paste exactly that, bestie — spaces and all, don't you dare "clean it up" for her. 😭

🦋 ARGUMENTS 🦋

  • pdcs — the PDC state for the SPU you wanna receive from. that's the one thing she needs. give her the state, she does the rest. 🫶

✨ DESCRIPTION ✨

so here's the tea, and it's short and iconic: when the return code says success, the response message is just there, chillin' in the receive buffers that you provided before you submitted the request. that's the whole plot twist — you already handed over the buffers earlier, and now the message has landed in them.

highkey the energy of "you left the door unlocked and the delivery already came through it." 📦💖

🔥 RETURN 🔥

she returns one of these three, so check your vibes:

  • PDC_SUCCESS — one or more receive descriptors was processed. she ate. 💅
  • -EAGAIN — no response message is available. nothing for you yet, babes, try again later. 🙈
  • -EIO — an error occurred. it's giving chaos, something went wrong. 💀

🌈 SEE ALSO 🌈

first up, the kernel file where all this lives:

./drivers/mailbox/bcm-pdc-mailbox.c

and now the whole friend group, no one gets left out — the way that this list is long. era. 👑

and that's the whole page, bestie, you understood it perfectly, i'm so proud of you 🥹💜

little sign-off so we stay factually correct: this page comes from ./drivers/mailbox, and it's dated October 2026. periodt. 🎀
📦 where this page comes from