drm_crtc_vbl...cancel_timer(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_crtc_vblank_cancel_timer(9) — the kernel API manual, but make it make sense

okay so bestie, welcome to the glow-up edition of the kernel API manual page for drm_crtc_vblank_cancel_timer(9). yes that's a mouthful, no we're not renaming it, it's iconic as is. 🎀

✨ NAME ✨

drm_crtc_vblank_cancel_timer — literally just cancels the given CRTC's vblank timer. that's the whole vibe. 💅

🦋 SYNOPSIS 🦋

void drm_crtc_vblank_cancel_timer (struct drm_crtc *crtc );

notice it returns void, so like… no return value to obsess over. she just does the thing and dips. 🫶

🌸 ARGUMENTS 🌸

  • crtc — the CRTC. that's it. that's the argument. the main character of this whole function, fr fr. 👑

💖 DESCRIPTION 💖

so here's the tea: drivers should call this function from their CRTC's disable_vblank function to stop a vblank timer. 🛑⏱️

like, the way that works is — you're already in disable_vblank, you don't want that timer running anymore, so you hit this function and she cancels it. no cap, that's the entire job. lowkey elegant honestly.

⭐ SEE ALSO ⭐

the whole friend group, in the order the manpage introduced them, because we do NOT do alphabetical erasure here:

(and yes, drm_crtc_vblank_start_timer(9) is literally her opposite-number counterpart — the "start" to her "cancel" — so if you're reading this one you probably want that one too. iykyk 🧚)

heads up bestie: the manpage is super chill about it, but it does say drivers should call this from disable_vblank — so like, that's the intended spot, not wherever you feel like it. 🙈

and that's the page!! 🌈✨ this little gem lives in the kernel tree at ./drivers/gpu/drm, and the manual page is dated October 2026 — so if you're reading this from the future, hiii, you're doing amazing, hope your vblank timers are all cancelled 🎀💜🦋

📦 where this page comes from