drm_pagemap_acquire_owner(9)

💅 drm_pagemap_acquire_owner(9) — like, the interconnect group join era

okay bestie, welcome to the kernel API manual page for drm_pagemap_acquire_owner(9) — yes that's the whole title, she's long, she's iconic, we love her 💖

---

✨ NAME ✨

drm_pagemap_acquire_owner — join an interconnect group 🫶

---

🦋 SYNOPSIS 🦋

int drm_pagemap_acquire_owner (struct drm_pagemap_peer *peer , struct
drm_pagemap_owner_list *owner_list , interconnect_fn has_interconnect );

---

🌸 ARGUMENTS 🌸

• peer — a struct drm_pagemap_peer that's keeping track of the device interconnect, she's got the receipts 📋
• owner_list — pointer to the owner_list, which keeps track of literally all the interconnects
• has_interconnect — the callback function that figures out whether two peers have a fast local interconnect. the vibe checker, basically ⚡

---

💜 DESCRIPTION 💜

so what happens is: drm_pagemap_acquire_owner repeatedly calls has_interconnect for peer and the other peers chilling on owner_list, to figure out the set of peers that peer has a fast interconnect with. ngl that set is gonna share a common struct drm_pagemap_owner, and when the call returns successfully, peer::owner points at that struct — holding a reference, no cap — and peer gets registered in owner_list. slay 💅

and if peer has no fast interconnects to any other peers? then a brand new unique struct drm_pagemap_owner gets allocated just for it 🎀 — and that one can totally be shared later with other peers that, at some future point, turn out to have a fast interconnect with peer. main character energy, but make it shareable ✨

🚨 super important bestie: when peer is done participating in an interconnect group, you must call drm_pagemap_release_owner to drop the reference on the struct drm_pagemap_owner. don't leave her hanging 😭

---

🔥 RETURN 🔥

0 on success, and a negative error code on failure. that's it, that's the whole thing 💀

---

🌈 SEE ALSO 🌈

• kernel file ./drivers/gpu/drm/drm_pagemap_util.c
• struct drm_pagemap_cache(9)
• struct drm_pagemap_shrinker(9)
• drm_pagemap_cache_create_devm(9)
• Cache lookup(9)
• drm_pagemap_cache_lock_lookup(9)
• drm_pagemap_cache_unlock_lookup(9)
• drm_pagemap_get_from_cache(9)
• drm_pagemap_cache_set_pagemap(9)
• drm_pagemap_get_from_cache_if_active(9)
• drm_pagemap_shrinker_might_lock(9)
• drm_pagemap_shrinker_add(9)
• drm_pagemap_shrinker_create_devm(9)
• struct drm_pagemap_owner(9)
• drm_pagemap_release_owner(9)
• interconnect_fn(9)

---

and that's the page, bestie 🧚💖 sign-off time: this lil beauty lives over in ./drivers/gpu/drm, dated October 2026, and it's filed under drm_pagemap_acquire_owner(9). obsessed. periodt. 👑