drm_dp_mst_t...ogy_get_mstb(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_dp_mst_topology_get_mstb 💅

okay so bestie, welcome to the Kernel API Manual — yes, the whole manual, and yes we're gonna get through this together 🫶 this one's about a lil function called drm_dp_mst_topology_get_mstb, and it's honestly giving "quiet overachiever" energy. let's go ✨

🌸 NAME 🌸

drm_dp_mst_topology_get_mstb — bump the topology refcount on a branch device so it doesn't get yanked out from under you 💖

🎀 SYNOPSIS 🎀

void drm_dp_mst_topology_get_mstb (struct drm_dp_mst_branch *mstb );

literally that's it. one function, one argument, zero drama (mostly) 👑

🦋 ARGUMENTS 🦋

  • mstb — the struct drm_dp_mst_branch whose topology refcount you're about to increment, bestie. that's your main character right there 🌟

💀 DESCRIPTION 💀

so what this does is it increments drm_dp_mst_branch.topology_refcount — without checking whether or not it's already reached 0. no vibe check, no lookup, no "hey are you okay in there". it just goes ✨

⚠️ and this is the important part, don't skip it: this is only valid to use in scenarios where you are already guaranteed to have at least one active topology reference to mstb. like, you know it's alive. otherwise you must use drm_dp_mst_topology_try_get_mstb instead. this is not a suggestion, it's the whole rule 🙈

see also: drm_dp_mst_topology_try_get_mstb and drm_dp_mst_topology_put_mstb — the try-hard version and the "ok bye" version respectively 🎀

👑 SEE ALSO 👑

the kernel file in question: ./drivers/gpu/drm/display/drm_dp_mst_topology.c — that's where all the magic lives 🧚

and the whole friend group (iykyk):

like, that's a lot of siblings but every single one of them is iconic in their own way 💜

and that's the page!! 💖✨ this lil drop of kernel wisdom lives over in ./drivers/gpu/drm/display, and it's dated October 2026 — so yeah, future vibes only 🦋 go forth and increment responsibly, bestie, and remember: only bump that refcount when you already know somebody's holding a reference. periodt 💅🎀

📦 where this page comes from