drm_pagemap_..._create_devm(9)

💅 drm_pagemap_..._create_devm(9) — from the Kernel API Manual, bestie ✨

okay so real talk, this page lives in the Kernel API Manual (section 9, the fun one where all the kernel functions hang out), and the star of the show is a function whose full name got so long the title had to go to the gym: drm_pagemap_shrinker_create_devm. Strap in 🎀

✨ NAME ✨

drm_pagemap_shrinker_create_devm — literally just create and register a pagemap shrinker. That's the whole assignment, no cap 🫶

🌸 SYNOPSIS 🌸

struct drm_pagemap_shrinker * drm_pagemap_shrinker_create_devm (struct
drm_device *drm );

yes bestie it returns a pointer to a struct drm_pagemap_shrinker — hold that thought, we're gonna circle back at RETURN 👀

🦋 ARGUMENTS 🦋

• drm — the drm device. that's it. that's the argument. she takes exactly one (1) struct drm_device * and she's thriving 💅

🔥 DESCRIPTION 🔥

so what does she do. She creates and registers a pagemap shrinker — like, both, in one call, main character energy ✨

And what's a pagemap shrinker for? It shrinks unused pagemaps, which reduces memory footprint. iykyk. Less wasted memory = happier system, and honestly we love a memory-footprint glow-up 🌈

The important vibe check here: the shrinker is drm_device managed, and it unregisters itself when the drm device is removed. So you don't have to babysit it or come back later to clean up — she handles her own exit, iconic behaviour fr fr 👑

💀 RETURN 💀

okay the manpage says: 0 on success, negative error code on failure. Write it exactly like that and don't @ me — yes, the SYNOPSIS shows a pointer return type, and yes, the RETURN section says 0/negative error code. That's what the docs say, so that's what I'm telling you. Both facts live here, bestie 😭

• 0 — success 🎉
• negative error code — failure 🙈

🧚 SEE ALSO 🧚

the whole friend group, no one left out 🫶 this all lives in the 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)
• struct drm_pagemap_owner(9)
• drm_pagemap_release_owner(9)
• interconnect_fn(9)
• drm_pagemap_acquire_owner(9)

---

and that's the page!! 🍓 shoutout to the ./drivers/gpu/drm directory for hosting all of this, dated October 2026 — go read the whole drm_pagemap_..._create_devm(9) saga whenever you need it, mwah 💖