drm_dp_dpcd_..._link_status(9)

📦 version 7.3.1, in nixpkgs unstable

okay so before we even start: this page lives in the Kernel API Manual, section 9, and the whole thing is literally called drm_dp_dpcd_..._link_status. yes the ... is part of the name, no i will not be elaborating, that's just how it is. 🎀

✨ NAME ✨

drm_dp_dpcd_read_phy_link_status — bestie, this is the one that goes and gets the link status info for a DP PHY 🦋

🌸 SYNOPSIS 🌸

int drm_dp_dpcd_read_phy_link_status (struct drm_dp_aux *aux , enum
drm_dp_phy dp_phy , u8 link_status[DP_LINK_STATUS_SIZE] );

like, that's the whole signature, copy it exactly, no notes 💖

🎀 ARGUMENTS 🎀

  • aux — the DisplayPort AUX channel, your little messenger 🧚
  • dp_phy — the DP PHY you want the link status for, i.e. which PHY, be specific bestie
  • link_status — the buffer where the status gets returned, u8 link_status[DP_LINK_STATUS_SIZE], ok so this is where the tea gets poured 🍓

👑 DESCRIPTION 👑

So what does it actually do? It fetches the AUX DPCD registers for the DPRX or an LTTPR PHY link status. that's the whole vibe check ✨

And the layout of the returned link_status? it matches the DPCD register layout of the DPRX PHY link status. no surprises, no cap 👑

It returns 0 if the information was read successfully, or a negative error code on failure. 😭 so like, check your return value, bestie, negative means it did not slay.

🔥 SEE ALSO 🔥

okay this list is LONG, but every single one of these deserves their moment, so here we go, no skipping, periodt 💅

First up, the kernel file itself: ./drivers/gpu/drm/display/drm_dp_helper.c 🌈 followed by:

if you made it to the end of that list, you're literally the main character 👑💜

lowkey important: the only thing this page promises is that 0 on success / negative on failure. don't go reading anything else into it, iykyk 🙈

and that's the page!! it comes to you from ./drivers/gpu/drm/display, dated October 2026, and it's filed under drm_dp_dpcd_..._link_status(9) — mwah, go read some DPCD registers bestie, you got this 💖✨🫶

📦 where this page comes from