drmm_crtc_init_with_planes(9)

okay bestie, welcome to the Kernel API Manual page for drmm_crtc_init_with_planes(9) 💅✨ this one is all about setting up a brand-new CRTC object with its primary and cursor planes, and it is lowkey iconic.

✨ NAME ✨

drmm_crtc_init_with_planes — initialise a new CRTC object with the specified primary and cursor planes 🎀

📜 SYNOPSIS 📜

int drmm_crtc_init_with_planes (struct drm_device *dev , struct drm_crtc *crtc , struct drm_plane *primary , struct drm_plane *cursor , const struct drm_crtc_funcs *funcs , const char *name , ... );

🧾 ARGUMENTS 🧾

• dev — the DRM device, aka the whole vibe container 🫶
• crtc — the CRTC object you're initialising, main character energy 👑
• primary — the primary plane for the CRTC
• cursor — the cursor plane for the CRTC
• funcs — callbacks for the new CRTC, the little handler squad ✨
• name — a printf style format string for the CRTC name, or NULL for the default name
• ... — variable arguments, because sometimes you gotta bring the whole group chat 💬

💫 DESCRIPTION 💫

This initialises a new object created as the base part of a driver CRTC object. Drivers should use this function instead of drm_crtc_init, which is only provided for backwards compatibility with drivers which do not yet support universal planes).

Cleanup is automatically handled through registering drmm_crtc_cleanup with drmm_add_action 🧹✨. The crtc structure should be allocated with drmm_kzalloc.

⚠️ bestie, important: the drm_crtc_funcs.destroy hook must be NULL 💀 no cap.

The primary and cursor planes are only relevant for legacy uAPI, see drm_crtc.primary and drm_crtc.cursor 🌈.

🎯 RETURN 🎯

Returns zero on success, and an error code on failure 😭. That's the whole return vibe.

👀 SEE ALSO 👀

go peek at these besties:

• Kernel file ./drivers/gpu/drm/drm_crtc.c overview(9)
• drm_crtc_from_index(9)
• standard CRTC properties(9)
• drm_crtc_init_with_planes(9)
• drm_crtc_cleanup(9)
• drm_mode_getcrtc(9)
• drm_mode_set_config_internal(9)
• drm_crtc_check_viewport(9)
• drm_mode_setcrtc(9)
• drm_crtc_create_scaling_filter_property(9)
• drm_crtc_in_clone_mode(9)

---

xoxo, your kernel bestie 💖 — source/version: ./drivers/gpu/drm, date: October 2026, page: drmm_crtc_init_with_planes(9). bye bestie, go init those CRTCs responsibly 🎀✨