STRUCT DRM_MOCK_SCHED_JOB(9)

✨ struct drm_mock_sched_job — implements a mock GPU job ✨

okay so bestie, welcome to the struct drm_mock_sched_job(9) page from the Kernel API Manual 💅 this is the whole vibe of a mock GPU job, and honestly? it's giving test-harness main character energy 🔥

---

🌸 SYNOPSIS 🌸

struct drm_mock_sched_job {
    struct drm_sched_job    base;
    struct completion       done;
  #define DRM_MOCK_SCHED_JOB_DONE                 0x1;
  #define DRM_MOCK_SCHED_JOB_TIMEDOUT             0x2;
  #define DRM_MOCK_SCHED_JOB_DONT_RESET           0x4;
  #define DRM_MOCK_SCHED_JOB_RESET_SKIPPED        0x8;
    unsigned long           flags;
    struct list_head        link;
    struct hrtimer          timer;
    unsigned int            duration_us;
    ktime_t finish_at;
    struct dma_fence        hw_fence;
    struct kunit            *test;
 };

like, that's the whole struct, no notes 💖

---

🎀 Members 🎀

• base — the DRM sched job base class, aka where it gets its whole sched-job inheritance from, slay 🫶
• done — a completion that signals the job is done. literally the "we're so back" notification 😭
• flags — flags that designate the job's state. the little status stickers of this struct ✨
• link — a list head element that the drm_mock_scheduler uses to keep track of the job. it's on the list, bestie 📋
• timer — a timer used for simulating how long the job takes to execute. fake execution, real vibes ⏱️
• duration_us — the simulated job duration in micro seconds, or zero if you're in manual timeline advance mode. zero means you're driving, not the timer 👑
• finish_at — the absolute time when jobs that have a duration set will complete. it's the deadline, and she knows it ⭐
• hw_fence — the fence that gets returned to the DRM scheduler as the hardware fence. handing over the official receipt 🧾
• test — a backpointer to the owning kunit test case. yes it knows who its parent is, it's giving very attached 💀

---

🦋 Description 🦋

so the Mock GPU sched job is what the test cases use to submit jobs to the mock scheduler. that's it, that's the whole job description — it's a fake GPU job for testing, no cap 🌈

---

🌟 SEE ALSO 🌟

Kernel file ./drivers/gpu/drm/scheduler/tests/sched_tests.h

• struct drm_mock_scheduler(9)
• struct drm_mock_sched_entity(9)
• drm_mock_sched_job_submit(9)
• drm_mock_sched_job_set_duration_us(9)
• drm_mock_sched_job_is_finished(9)
• drm_mock_sched_job_wait_finished(9)
• drm_mock_sched_job_wait_scheduled(9)

go read those too, iykyk 💜

---

ngl this whole thing lives down in ./drivers/gpu/drm/scheduler/tests, from October 2026, in the Kernel API Manual — so if you ever need to find her again, that's where she's at 🎀

k bye bestie, go write some tests, you're gonna ate 💅✨🔥