vkms_config_...rimary_plane(9)
π vkms_config_crtc_primary_plane(9) β like, the Kernel API Manual page bestie π
okay so this is the vkms_config_...rimary_plane(9) page from the Kernel API Manual, and honestly? it's a lil cutie. tiny function, big "where's my plane" energy. let's get into it β¨
β¨ NAME β¨
vkms_config_crtc_primary_plane β returns the primary plane for a CRTC π₯οΈπ
πΈ SYNOPSIS πΈ
struct vkms_config_plane * vkms_config_crtc_primary_plane (const struct
vkms_config *config , struct vkms_config_crtc *crtc_cfg );
π¦ ARGUMENTS π¦
configβ the configuration that contains the CRTC. that's the container, the vibe-holder, the whole situation π«Άcrtc_cfgβ -- undescribed -- π yeah. the docs literally just say "undescribed" here. not me exposing upstream like this π it's astruct vkms_config_crtc *, that's all we're given, bestie
π DESCRIPTION π
so here's the tea: if this function finds multiple primary planes, it hands you back the first one. and like... that's not a slay. in that case, the configuration will be invalid. check vkms_config_is_valid for that. no cap π₯
β οΈ fr fr if you're getting more than one primary plane back, something's cooked β go validate your config.
π RETURN π
the primary plane, or NULL if none is assigned yet. that's it. that's the whole return π«‘
π SEE ALSO π
okay this is the long part and we are NOT skipping a single one, iykyk. Kernel file ./drivers/gpu/drm/vkms/vkms_config.h, plus:
struct vkms_config(9)struct vkms_config_plane(9)struct vkms_config_crtc(9)struct vkms_config_encoder(9)struct vkms_config_connector(9)vkms_config_for_each_plane(9)vkms_config_for_each_crtc(9)vkms_config_for_each_encoder(9)vkms_config_for_each_connector(9)vkms_config_plane_for_each_possible_crtc(9)vkms_config_encoder_for_each_possible_crtc(9)vkms_config_connector_for_each_possible_encoder(9)vkms_config_create(9)vkms_config_default_create(9)vkms_config_destroy(9)vkms_config_get_device_name(9)vkms_config_get_num_crtcs(9)vkms_config_is_valid(9)vkms_config_register_debugfs(9)vkms_config_create_plane(9)vkms_config_destroy_plane(9)vkms_config_plane_set_type(9)vkms_config_plane_get_default_pipeline(9)vkms_config_plane_set_default_pipeline(9)vkms_config_plane_attach_crtc(9)vkms_config_plane_detach_crtc(9)vkms_config_create_crtc(9)vkms_config_destroy_crtc(9)vkms_config_crtc_get_writeback(9)vkms_config_crtc_set_writeback(9)vkms_config_crtc_cursor_plane(9)vkms_config_create_encoder(9)vkms_config_destroy_encoder(9)vkms_config_encoder_attach_crtc(9)vkms_config_encoder_detach_crtc(9)vkms_config_create_connector(9)vkms_config_destroy_connector(9)vkms_config_connector_attach_encoder(9)vkms_config_connector_detach_encoder(9)vkms_config_connector_get_status(9)vkms_config_connector_set_status(9)
like, go read them. all of them. it's giving "study group" πβ¨
and that's the page!! this icon lived in ./drivers/gpu/drm/vkms and dropped way back in October 2026 β main character energy from the kernel docs honestly π
π bye bestie, go find that primary plane π¦
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms