drm_sched_stop(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_sched_stop(9) — like, the Kernel API Manual page, bestie ✨

Okay so we're in the Kernel API Manual today and this one's called drm_sched_stop(9) and honestly? It does exactly what it says on the tin. Let's get into it 🫶

🌸 NAME 🌸

drm_sched_stop — stop the scheduler. That's it. That's the whole vibe. ✨

🎀 SYNOPSIS 🎀

void drm_sched_stop (struct drm_gpu_scheduler *sched , struct
       drm_sched_job *bad );

🦋 ARGUMENTS 🦋

  • sched — the scheduler instance in question. Your main character, basically 👑
  • bad — the job that caused the time out. Yeah. That one. 💀

💖 DESCRIPTION 💖

So what it does is: it stops the scheduler, and it also like... removes and frees all the completed jobs. Both. At once. Multi-tasking icon behavior, no cap. 🧚

💅 NOTE 💅

Okay this part actually matters so read it, bestie — I'm serious 🙈

The bad job will not be freed, because it might get used later. So it's the caller's responsibility to release it manually if it's not part of the pending list any more. Not me doing your cleanup for you, periodt. 💀

This function is typically used for reset recovery — see the docu of drm_sched_backend_ops.timedout_job for the details if you want the full lore iykyk. Do not call it for scheduler teardown, i.e., before calling drm_sched_fini. Just don't. 🚫

And since it's only used for reset recovery, drivers must not call this function in their struct drm_sched_backend_ops.timedout_job callback when they skip a reset using enum drm_gpu_sched_stat.DRM_GPU_SCHED_STAT_NO_HANG. Like, that's the rule. Full stop. 🎀

Fr fr, these caveats are the whole point of the page — skipping a reset with DRM_GPU_SCHED_STAT_NO_HANG and then calling this anyway is not the move. 💀

✨ SEE ALSO ✨

Right, buckle up, this list is long long, but every single one of these ate and we're listing them all because we don't do leaving-things-out here: 💜

Okay that's the whole page, you're officially educated 💖 This little drop came from ./drivers/gpu/drm/scheduler and it's dated October 2026 — go off, king 👑✨

📦 where this page comes from