drm_event_r..._init_locked(9)

✨ drm_event_reserve_init_locked 💅

okay bestie, welcome to the Kernel API Manual, this is the page for drm_event_reserve_init_locked and it's lowkey the moment you've been waiting for 🎀

---

🌸 NAME 🌸

drm_event_reserve_init_locked — init a DRM event and reserve space for it, no cap ✨

---

🦋 SYNOPSIS 🦋

int drm_event_reserve_init_locked (struct drm_device *dev , struct
drm_file *file_priv , struct drm_pending_event *p , struct drm_event *e
);

like... that's the whole vibe right there, four args, one int coming back, periodt 💅

---

🎀 ARGUMENTS 🎀

• dev — the DRM device, your main character 🫶
• file_priv — the DRM file private data, the backstage pass bestie 🎟️
• p — tracking structure for the pending event, it's literally keeping tabs 👀
• e — actual event data to deliver to userspace, the payload, the moment 💌

---

🔥 DESCRIPTION 🔥

okay so here's the tea 🍵 — this function prepares the event you passed in for eventual delivery. It's giving "get ready, you're about to be sent" energy ✨

but listen 👑 — if the event doesn't get delivered (because the IOCTL fails later on, before anything gets queued up), then the event must be cancelled and freed using drm_event_cancel_free. no exceptions, bestie, that's not me being dramatic, that's just the rules 😭

and the successfully initialized ones? those should be sent out using drm_send_event or drm_send_event_locked to signal completion of the asynchronous event to userspace. slay, that's the whole point 💖

ngl there's one very important detail: if callers embedded p into a larger structure, it must be allocated with kmalloc and p must be the first member element. not optional, not a suggestion, it's fr fr mandatory 🙈

and lastly — this is the locked version of drm_event_reserve_init for callers which already hold drm_device.event_lock. so if you've already got the lock, this is your girl 🦋

---

⭐ RETURN ⭐

0 on success, or a negative error code on failure. that's it, that's the answer 💀✨

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/drm_file.c file operations(9)
• drm_file_alloc(9)
• drm_file_free(9)
• drm_open(9)
• drm_release(9)
• drm_release_noglobal(9)
• drm_read(9)
• drm_poll(9)
• drm_event_reserve_init(9)
• drm_event_cancel_free(9)
• drm_send_event_timestamp_locked(9)
• drm_send_event_locked(9)
• drm_send_event(9)
• drm_print_memory_stats(9)
• drm_show_memory_stats(9)
• drm_show_fdinfo(9)
• drm_file_err(9)
• mock_drm_getfile(9)

like go read them all, iykyk 📚💜

---

and that's the whole page bestie 🧚 source lives at ./drivers/gpu/drm, dated October 2026, and yes we're still out here reading kernel docs in the year 2026 — iconic behavior honestly 👑💖 see you in the next manpage!! 🌸🫶