drm_mode_con...nitial_state(9)

🦋 NAME 🦋

okay so bestie, welcome to the Kernel API Manual page for drm_mode_config_create_initial_state — and what does it do?? it allocates the initial state. that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

int drm_mode_config_create_initial_state (struct drm_device *dev );

like, you hand it a device and it gives you back an int. iconic signature, no notes. 🫶

---

🎀 ARGUMENTS 🎀

• dev — the drm device. that's it. that's the whole argument list. she's low-maintenance. 💖

---

🌸 DESCRIPTION 🌸

so this function creates the initial state for all the objects. yes, all of them. 🫡

drivers can use this in e.g. probe to initialize their software state. perfect for that "first day of school" moment where everything needs to exist before anything actually happens. ✨

now here's the tea, because it has two main differences with drm_mode_config_reset and you need to know them:

1. the reset hooks aren't called, and thus the hardware will be left untouched — like, she does NOT touch the hardware, she's strictly a software girlie here. 🙈
2. the drm_private_obj structures will be initialized, as opposed to drm_mode_config_reset, which skips them. so if you were relying on the reset path and wondering why your private objs are sitting there un-initialized… yeah. that's why. 💀

---

🔥 RETURN 🔥

• 0 on success 🎉
• negative error value on failure 😭

that's it. no secret third thing. periodt.

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/drm_mode_config.c — go read the source, iykwim 👀
• drm_mode_getresources(9)
• drm_mode_config_reset(9)
• drmm_mode_config_init(9)
• drm_mode_config_cleanup(9)

---

okay that's the whole page bestie, you ate that 🍓 — and for the credits moment: this one lives over in ./drivers/gpu/drm, dated October 2026, and the header's manual name is the Kernel API Manual. go forth and initialize your state, main character 💜🧚