dprc_get_connection(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dprc_get_connection — Kernel API Manual, section 9 🎀

okay so bestie, gather round, because this one is a whole little detective mission in the fsl-mc bus code. It's dprc_get_connection(9), and it lives in the Kernel API Manual — yes, section 9, the ✨real✨ section. Basically: you hand it one endpoint, and it tells you whether that endpoint is connected to something, and if so, who/what that something is, plus whether the link is actually up. iykyk 💖

🌸 NAME 🌸

dprc_get_connection — get the connected endpoint, and the link status, if a connection exists. That's the whole vibe check. 🔥

✨ SYNOPSIS ✨

int dprc_get_connection (struct fsl_mc_io *mc_io , u32 cmd_flags , u16
token , const struct dprc_endpoint *endpoint1 , struct dprc_endpoint
*endpoint2 , int *state );

Like, yes, it's a lot of parameters, but we get through it together, one at a time. 🫶

🦋 ARGUMENTS 🦋

  • mc_io — Pointer to the MC portal's I/O object. This is your main character, the thing that actually talks to the management complex. 💅
  • cmd_flags — Command flags; one or more of MC_CMD_FLAG_. Pick your flags, bestie, they came to slay. ⭐
  • token — The token of the DPRC object. It's the little ID that says "yes, this DPRC, not the other one." 👑
  • endpoint1 — Endpoint 1 configuration parameters. This is the one you bring to the function — it's const, so it's not going anywhere, no cap.
  • endpoint2 — Returned endpoint 2 configuration parameters. Notice the word Returned — this is where the function writes the other end of the connection back to you. 🎁
  • state — Returned link state, and it's a little three-way thing, so pay attention:
    • 1 — link is up 🌈
    • 0 — link is down 💀
    • -1 — no connection at all, and heads up: in that case the endpoint2 information is irrelevant, so don't go reading it and making it a whole thing 🙈

🔥 RETURN 🔥

(no return info listed here — that's just how the page is, bestie, we don't make stuff up 💜)

💖 SEE ALSO 💖

Kernel file ./drivers/bus/fsl-mc/dprc.c — go read the source, it's giving lore:

honestly that's a whole friend group right there 🧚

and that's the page!! 🍓 source: ./drivers/bus/fsl-mc, dated October 2026, and the manual is dprc_get_connection(9) — mwah, go forth and check your connections, bestie 💋🫶

📦 where this page comes from