STRUCT DRM_SCHED_JOB(9)

✨ struct drm_sched_job(9) ✨

okay so bestie, welcome to the Kernel API Manual for struct drm_sched_job — literally the blueprint for "a job to be run by an entity" 💅 this is the glow-up version, no cap.

---

🦋 SYNOPSIS 🦋

like, here's the whole struct, every single field, exactly as it lives in the header:

struct drm_sched_job {
    ktime_t submit_ts;
    struct drm_gpu_scheduler        *sched;
    struct drm_sched_fence          *s_fence;
    struct drm_sched_entity         *entity;
    struct drm_sched_entity_stats   *entity_stats;
    enum drm_sched_priority         s_priority;
    u32 credits;
    unsigned int                    last_dependency;
    atomic_t karma;
    struct spsc_node                queue_node;
    struct list_head                list;
    union {
      struct dma_fence_cb     finish_cb;
      struct work_struct      work;
    };
    struct dma_fence_cb             cb;
    struct xarray                   dependencies;
 };

---

👑 Members 👑

okay so let's go field by field, bestie, because every single one matters:

• submit_ts — when the job got pushed into the entity queue. the literal timestamp of "it's giving scheduled" ✨
• sched — the scheduler this job is or will be scheduled on. gets set by drm_sched_job_arm. valid until drm_sched_backend_ops.free_job has finished. so like, don't touch it after that, periodt 💀
• s_fence — contains the fences for the scheduling of job. it's giving "hold the door" energy 🚪
• entity — the entity to which this job belongs. main character association, fr fr 👑
• entity_stats — stats object reference held by the job and entity. keeping receipts on the metrics, iykyk 📊
• s_priority — the priority of the job. highkey important for queue order 💅
• credits — the number of credits this job contributes to the scheduler. like, budget allocation but make it kernel 🪙
• last_dependency — tracks dependencies as they signal. lowkey the job's little dependency diary 📓
• karma — increment on every hang caused by this job. if this exceeds the hang limit of the scheduler then the job is marked guilty and will not be scheduled further. literally the naughty list, no cap 😭🚫
• queue_node — used to append this struct to the queue of jobs in an entity. the queue is giving linked-list realness 🔗
• list — a job participates in a "pending" and "done" lists. both vibes, two lists, one job 🎀
• {unnamed_union} — anonymous. mysterious. iconic. no name needed 💫
• finish_cb — the callback for the finished fence. like a little "we're done here" notification 🛎️
• work — helper to reschedule job kill to different context. yes bestie, even the kill gets rescheduled 🙈
• cb — the callback for the parent fence in s_fence. the callback's callback, iykyk 🔁
• dependencies — contains the dependencies as struct dma_fence for this job. see drm_sched_job_add_dependency and drm_sched_job_add_implicit_dependencies. it's literally the job's whole relationship web 🕸️

---

🌸 Description 🌸

so a job is created by the driver using drm_sched_job_init, and then it should call drm_sched_entity_push_job once it wants the scheduler to schedule the job. like, create it, then yeet it into the scheduler. that's the whole flow, bestie ✨🫶

---

💖 SEE ALSO 💖

the whole squad, no cap:

• Kernel file ./include/drm/gpu_scheduler.h
• DRM_SCHED_FENCE_DONT_PIPELINE(9)
• DRM_SCHED_FENCE_FLAG_HAS_DEADLINE_BIT(9)
• struct drm_sched_entity(9)
• struct drm_sched_rq(9)
• struct drm_sched_fence(9)
• enum drm_gpu_sched_stat(9)
• struct drm_sched_backend_ops(9)
• struct drm_gpu_scheduler(9)
• struct drm_sched_init_args(9)
• struct drm_sched_pending_job_iter(9)
• drm_sched_for_each_pending_job(9)

---

okay and that's the whole page, bestie — signed, sealed, delivered by the ./include/drm girlies, dated October 2026, and that's on periodt 💅🎀🦋