drm_connecto...tus_property(9)

📦 version 7.3.1, in nixpkgs unstable

okay bestie, welcome to the Kernel API Manual — yes that's the manual name, no I'm not making it up 💅 this is a (9) page, kernel-API territory, and we're gonna get through it together, hand in hand, no cap 🫶

🌸 NAME 🌸

drm_connector_set_link_status_property — sets the link status property of a connector, fr fr

🎀 SYNOPSIS 🎀

void drm_connector_set_link_status_property (struct drm_connector
*connector , uint64_t link_status );

like, that's the whole signature. she's cute, she's void, she takes two things 💖

🦋 ARGUMENTS 🦋

  • connector — the drm connector in question. the main character, honestly 👑
  • link_status — the new value of the link status property, and listen: 0 means Good, 1 means Bad. that's it, that's the whole scale, binary icon behavior 😭

⭐ DESCRIPTION ⭐

so in the usual working scenario — the happy path, the slay path — this link status property is always set to "GOOD" ✨

but if something fails during or after a mode set, the kernel driver may set this link status property to "BAD" 💀 and then? the caller needs to send a hotplug uevent so userspace goes and re-checks the valid modes through GET_CONNECTOR_IOCTL and retries the modeset. like a lil "hey bestie something changed, come look" 📣

🙈 NOTE 🙈

drivers cannot rely on userspace to support this property and issue a modeset. nope, not a thing. so drivers may choose to handle issues themselves — like re-training a link — without userspace's intervention at all. independent queen energy 💅

the reason this property exists is to handle link training failures, but it is not limited to DP or link training. for example — and this is the fun part — if we implement asynchronous setcrtc, this property can be used to report any failures in that too 🌈

lowkey important: this thing is not just a DP link-training accessory, it's a general "something went sideways" flag. iykyk.

🔥 SEE ALSO 🔥

okay this list is long long, so buckle up, we're going through every single one because I don't skip, ever 💜

yes, standard connector properties(9) shows up twice. I didn't merge them, I didn't "fix" them, I listed them exactly like the original said. leave her alone 🍓

💫 sign-off 💫

this little gem lives in ./drivers/gpu/drm, dated October 2026, page name drm_connecto...tus_property(9) (the truncation is canon, don't @ me 😭). go forth, set your link status, send your uevents, and remember: 0 is Good, 1 is Bad, and you're doing amazing 🧚💖

📦 where this page comes from