intel_dp_link_caps_update(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

okay so bestie, this is the page for intel_dp_link_caps_update(9) from the Kernel API Manual, and honestly? it's giving "quiet little function that quietly rebuilds the entire vibe of your DisplayPort link config." iconic. let's get into it 🫢


✨ NAME ✨

intel_dp_link_caps_update β€” rebuild the supported link configuration state. that's it. that's the whole job. lowkey important though πŸ’…


✨ SYNOPSIS ✨

bool intel_dp_link_caps_update (struct intel_dp_link_caps *link_caps ,
const int *rates , int num_rates , int max_lane_count , bool reset );

yes she returns a bool, yes she takes five args, no we are not scared of her 🌸


✨ ARGUMENTS ✨

  • link_caps β€” the link capabilities state. this is the little baby we're rebuilding, so keep your eyes on her πŸŽ€
  • rates β€” the supported common link rates. plural. a whole squad of rates.
  • num_rates β€” the number of entries in rates. like, how many of the squad actually showed up. no cap.
  • max_lane_count β€” the supported maximum lane count. lanes, bestie. we love a multi-lane moment.
  • reset β€” reset limits and disabled configs. flip this and things get ✨fresh✨ (details below, keep reading, i got you)

✨ DESCRIPTION ✨

so the whole point: rebuild the supported link configuration state from rates and max_lane_count. that's the core loop, the main character energy of this function πŸ’«

now, if reset is true, she resets the maximum link limits to the maximum supported rate and lane count, and re-enables all configurations. so basically a full glow-up reset: limits back to max, every config un-disabled. slay. 🧚

this function is called regularly β€” at least after a sink is connected β€” but it may also get called later whenever the sink capabilities may have changed. example given in the original, and i quote the vibe: in response to HPD IRQ / RX_CAP_CHANGED signaling. so yeah, sink says "i changed," and this function says "bet." πŸ’…

in the Intel driver, this function is currently called whenever the connector detect handler runs, after reading the sink capabilities. and here's the caveat bestie, listen up πŸ‘‘: this may change if those capabilities are cached until the sink is disconnected, or until RX_CAP_CHANGED is signaled. in any case, this function should be called whenever the sink capabilities were read out and may have changed. so like... read the caps, then call her. every time. periodt.

🫢 tl;dr: read the sink capabilities β†’ call this β†’ state stays accurate. skip it and your link config is living a lie.

✨ RETURN ✨

  • true if the link capabilities have changed, false otherwise.

that's the whole return contract. boolean. clean. no drama (for once) πŸ’–


✨ SEE ALSO ✨

like, the whole friend group fr fr 🌈 go read them, they're all part of the same little intel_dp_link_caps cinematic universe πŸ¦‹


and that's the page!! πŸŽ€ this one lives over in ./drivers/gpu/drm/i915/display, dated October 2026 β€” so yeah, she's from the future (or at least the future of this doc build), and she ate. mwah πŸ’‹πŸ’œ

πŸ“¦ where this page comes from