DRM_MODE_ATOMIC_TEST_ONLY(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… DRM_MODE_ATOMIC_TEST_ONLY(9) πŸ’…

ok so we're in the Kernel API Manual bestie, buckle up πŸŽ€


✨ NAME ✨

DRM_MODE_ATOMIC_TEST_ONLY β€” and honestly? the manpage gives us zero extra words here. the NAME section is literally just the name. no summary, no little dash-description, nothing. it's giving mysterious. we respect it 🫢


✨ SYNOPSIS ✨

DRM_MODE_ATOMIC_TEST_ONLY

that's it. that's the whole thing. no arguments, no parentheses, no nothing. just the flag, standing there, iconic πŸ‘‘


✨ DESCRIPTION ✨

okay so here's the tea πŸ”₯ this flag means: do NOT actually apply the atomic commit. like, don't touch the hardware, don't commit anything, don't make it real. instead, just check whether the hardware would even support this configuration.

it's a vibe check for your display config, basically. you're asking "hey, could you do this?" and the answer is yes or no β€” but nothing gets changed. no cap, nothing moves. πŸ¦‹

✨ really important bestie: this is a test-only commit. the whole point is that it does not apply. if you were expecting pixels to change, they will not. that's the feature, not a bug πŸ’–

and if you wanna know more about how test-only commits actually work under the hood, the page points you at drm_mode_config_funcs.atomic_check β€” that's where the details live. go read it, it's got the receipts πŸ“–


✨ SEE ALSO ✨

okay this list is LONG and it ate, so let's go through it, all of it, no skipping πŸ™ˆ

  • the Kernel file ./include/uapi/drm/drm_mode.h overview(9)
  • struct drm_mode_modeinfo(9)
  • struct drm_mode_get_plane(9)
  • struct drm_mode_get_connector(9)
  • struct drm_mode_property_enum(9)
  • struct drm_mode_get_property(9)
  • struct drm_mode_fb_cmd2(9)
  • enum drm_colorop_type(9)
  • enum drm_colorop_lut3d_interpolation_type(9)
  • enum drm_colorop_lut1d_interpolation_type(9)
  • struct drm_plane_size_hint(9)
  • struct hdr_metadata_infoframe(9)
  • struct hdr_output_metadata(9)
  • DRM_MODE_PAGE_FLIP_EVENT(9)
  • DRM_MODE_PAGE_FLIP_ASYNC(9)
  • DRM_MODE_PAGE_FLIP_FLAGS(9)
  • struct drm_mode_create_dumb(9)
  • DRM_MODE_ATOMIC_NONBLOCK(9)
  • DRM_MODE_ATOMIC_ALLOW_MODESET(9)
  • DRM_MODE_ATOMIC_FLAGS(9)
  • struct drm_mode_create_blob(9)
  • struct drm_mode_destroy_blob(9)
  • struct drm_mode_create_lease(9)
  • struct drm_mode_list_lessees(9)
  • struct drm_mode_get_lease(9)
  • struct drm_mode_revoke_lease(9)
  • struct drm_mode_rect(9)
  • struct drm_mode_closefb(9)

like I said. it ate. every single one of them πŸ’€βœ¨


and that's the whole page, bestie!! this one came from ./include/uapi/drm and it's dated October 2026 β€” so mark your calendars, screenshot it, send it to the group chat, whatever you gotta do πŸŽ€πŸ’–βœ¨ slay!! 🫢

πŸ“¦ where this page comes from