dm_test_crtc..._cursor_only(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dm_test_crtc_handle_vblank_completes_cursor_only — bestie's guide to the vblank test ✨

okay so this is a page from the Kernel API Manual, section 9, and it's literally about one KUnit test. the whole thing is called dm_test_crtc_handle_vblank_completes_cursor_only and honestly? she's a small test with a big job 🎀

✨ NAME ✨

dm_test_crtc_handle_vblank_completes_cursor_only — the test that checks an event actually gets sent on vblank 🦋

🧚 SYNOPSIS 🧚

void dm_test_crtc_handle_vblank_completes_cursor_only (struct kunit *test );

periodt. that's the whole signature 💅

🌸 ARGUMENTS 🌸

  • test — the KUnit test context, aka the little backpack this test carries its stuff in 🎒

👑 DESCRIPTION 👑

here's the vibe: you've got a pending event whose flip is not AMDGPU_FLIP_SUBMITTED — think of it as a cursor-only commit 🖱️✨ — and this test is checking that it must be signalled on vblank. no cap.

and what does "signalled on vblank" actually mean here? all three of these things, bestie, and they all gotta happen:

  • the vblank event gets sent 📨
  • the vblank reference gets dropped 🫳
  • acrtc->event gets cleared 🧹

that's it. that's the whole test. she's thorough, she's specific, she ate 🔥

🦋 SEE ALSO 🦋

📁 the kernel file

./drivers/gpu/drm/amd/display/amdgpu_dm/tests/amdgpu_dm_crtc_test.c — go read it, it's right there 🫶

💖 the whole friend group (aka every sibling test, in order)

iykyk, that's a lot of friends 💀 but they're all listed, every single one, nothing skipped 💜

ngl, the two closest cousins to this one are dm_test_crtc_handle_vblank_no_event(9) and dm_test_crtc_handle_vblank_skips_when_flip_submitted(9) — like, the "no event" case and the "flip actually submitted, so skip" case. this page is the third one in that little trio: flip not submitted, event must fire 🎀

🌈 sign-off 🌈

that's the whole page, bestie!! source for all this good stuff is ./drivers/gpu/drm/amd/display/... and it's dated October 2026, standing proudly under the manual name dm_test_crtc..._cursor_only(9) ⭐ Kernel API Manual forever 👑 go forth and vblank responsibly 💖✨

📦 where this page comes from