STRUCT DRM_MODESET_ACQUIRE_CTX(9)

💅 struct drm_modeset_acquire_ctx(9) 🎀

okay so bestie, welcome to the Kernel API Manual — yes we're in the kernel manual, yes it's giving big-brain energy, and yes this page is literally about a struct. Stay with me, it's actually cute 🦋

✨ NAME ✨

struct drm_modeset_acquire_ctx — the locking context (see ww_acquire_ctx) 💖

---

🌸 SYNOPSIS 🌸

struct drm_modeset_acquire_ctx {
    struct ww_acquire_ctx ww_ctx;
    struct drm_modeset_lock *contended;
    depot_stack_handle_t stack_depot;
    struct list_head locked;
    bool trylock_only;
    bool interruptible;
};

🧚 MEMBERS 🧚

• ww_ctx — the base acquire ctx, the main character of the whole struct ngl 👑
• contended — used internally for -EDEADLK handling, like the little drama manager behind the scenes 💀
• stack_depot — used internally for contention debugging, so when things get messy there's receipts 🫶
• locked — a list_head of the held locks, i.e. the guest list of everything currently locked in 📋✨
• trylock_only — trylock mode, used in atomic contexts and panic notifiers, so basically the "no waiting around, we're in a crisis" mode 😭🔥
• interruptible — whether interruptible locking should be used, like, can we bail or not 🙈

---

🎀 DESCRIPTION 🎀

So here's the vibe: every thread that's competing for a set of locks has to use one acquire ctx. One. Per thread. No sharing, no cap. 💅

And if any lock fxn returns -EDEADLK, it must back off and retry — like babe, don't fight the deadlock, just step back and try again 🔁✨

lowkey important: this isn't optional behaviour, it's the rule fr fr 🫡

---

⭐ SEE ALSO ⭐

Kernel file ./include/drm/drm_modeset_lock.h struct drm_modeset_lock(9), drm_modeset_lock_fini(9), drm_modeset_is_locked(9), drm_modeset_lock_assert_held(9), DRM_MODESET_LOCK_ALL_BEGIN(9), DRM_MODESET_LOCK_ALL_END(9) — go read those too, iykyk 💖

---

and that's the whole page bestie 🎉 sourced straight from ./include/drm, dated October 2026, and yes we slayed the entire acquire ctx 😌💅 periodt 🌈⭐