drm_atomic_g...te_obj_state(9)
π drm_atomic_g...te_obj_state(9) β Kernel API Manual
okay bestie, gather round, because this one is a little kernel function with a very long name and a very specific job. it lives in section 9 of the Kernel API Manual (yes, the kernel-manpage section, we're fancy here), and it's literally called drm_atomic_get_new_private_obj_state β the header just truncated it all cute and dramatic like drm_atomic_g...te_obj_state(9).
β¨ NAME β¨
drm_atomic_get_new_private_obj_state β
and that's it. that's the whole description. the manpage literally leaves the dash hanging with nothing after it. no cap, she said nothing and left the group chat on read. iconic behavior, honestly.
πΈ SYNOPSIS πΈ
struct drm_private_state * drm_atomic_get_new_private_obj_state (const
struct drm_atomic_commit *state , struct drm_private_obj *obj );
so you're handing it a global atomic state (state) and a private object (obj), and it gives you back a struct drm_private_state *. that's the whole vibe. π¦
π ARGUMENTS π
stateβ the global atomic state object. like, the big picture. the main character of the whole atomic commit situation β¨objβ theprivate_objyou wanna grab the state of. the specific little guy you're investigating π
π DESCRIPTION π
okay so here's the tea: this function hands you the new private object state for the private_obj you passed in. that's it, that's the job. she's a getter, she's focused, she's not doing side quests. π
but!! and this is the important bit π«Ά β if that private_obj is not part of the global atomic state, you get NULL back. not an error, not a dramatic crash, just NULL. so like, vibe check your pointers before you dereference them, bestie, fr fr π
π SEE ALSO π
this list is long β she has a lot of friends, lowkey a whole extended family of atomic helpers. iykyk. here's everyone:
Kernel file ./drivers/gpu/drm/drm_atomic.cstate lifetime(9)drm_crtc_commit_wait(9)drm_atomic_commit_default_release(9)drm_atomic_commit_init(9)drm_atomic_commit_alloc(9)drm_atomic_commit_default_clear(9)drm_atomic_commit_clear(9)__drm_atomic_commit_free(9)drm_atomic_get_crtc_state(9)drm_atomic_get_plane_state(9)drm_atomic_get_colorop_state(9)drm_atomic_get_old_colorop_state(9)drm_atomic_get_new_colorop_state(9)drm_atomic_plane_check(9)handling driver private state(9)drm_atomic_private_obj_init(9)drm_atomic_private_obj_fini(9)drm_atomic_get_private_obj_state(9)drm_atomic_get_old_private_obj_state(9)drm_atomic_get_old_connector_for_encoder(9)drm_atomic_get_new_connector_for_encoder(9)drm_atomic_get_connector_for_encoder(9)drm_atomic_get_old_crtc_for_encoder(9)drm_atomic_get_new_crtc_for_encoder(9)drm_atomic_get_connector_state(9)drm_atomic_get_bridge_state(9)drm_atomic_get_old_bridge_state(9)drm_atomic_get_new_bridge_state(9)drm_atomic_add_encoder_bridges(9)drm_atomic_add_affected_connectors(9)drm_atomic_add_affected_planes(9)drm_atomic_add_affected_colorops(9)drm_atomic_check_only(9)drm_atomic_commit(9)drm_atomic_nonblocking_commit(9)drm_atomic_print_new_state(9)drm_state_dump(9)
ngl, if you're looking for the old one instead, that's drm_atomic_get_old_private_obj_state(9) β she's right there in the list, go say hi π«Ά
π§ sign-off π§
this little page came out of ./drivers/gpu/drm, and she's stamped October 2026 β β so yeah, remember the source path and the date, bestie, that's the receipt πβ¨π
π¦ 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