drm_sched_entity_init(9)

✨ drm_sched_entity_init ✨

okay bestie, buckle up 💅 this is a Kernel API Manual page for drm_sched_entity_init(9) and it's literally the glow-up moment for a scheduler entity. Think of it as: you're setting up a whole little identity for your jobs so the scheduler knows where to send them. main character energy fr fr.

---

🎀 NAME 🎀

drm_sched_entity_init — init a context entity used by the scheduler when you submit to the HW ring. yes that's the whole vibe 🦋

---

🌸 SYNOPSIS 🌸

int drm_sched_entity_init (struct drm_sched_entity *entity , enum
drm_sched_priority priority , struct drm_gpu_scheduler **sched_list ,
unsigned int num_sched_list , atomic_t *guilty );

like, five arguments, no cap. let's meet them 👑

---

💖 ARGUMENTS 💖

• entity — the scheduler entity you're initializing. this is the thing getting its whole life together ✨
• priority — the priority of the entity. how important is this babe? very. 🔥
• sched_list — the list of DRM scheds that jobs from this entity can be submitted to. it's giving "choose your own adventure" 🌈
• num_sched_list — the number of DRM sched entries in sched_list. gotta know how many we're working with 🧚
• guilty — an atomic_t that gets set to 1 when a job on this queue is found to be guilty, which causes a timeout. 😭 and yes, that's a real thing, not me being dramatic for once

---

🦋 DESCRIPTION 🦋

okay so important note first, bestie — the sched_list must have at least one element to schedule the entity. like, at least one. don't come at it with an empty list, it will not slay. 💀

for changing priority later on at runtime, see drm_sched_entity_set_priority. and for changing the set of schedulers sched_list at runtime, see drm_sched_entity_modify_sched. iykyk 🌟

an entity is cleaned up by calling drm_sched_entity_fini. see also drm_sched_entity_destroy if you want the full send 🫶

Returns 0 on success, or a negative error code on failure. lowkey the most normal return contract ever, we love a clean API 🌸

---

💜 SEE ALSO 💜

• Kernel file ./drivers/gpu/drm/scheduler/sched_entity.c — the actual source, go read it, it's iconic 👑
• drm_sched_entity_stats_release(9)
• drm_sched_entity_stats_new(9)
• drm_sched_entity_stats_job_add_gpu_time(9)
• drm_sched_entity_modify_sched(9)
• drm_sched_entity_error(9)
• drm_sched_entity_kill(9)
• drm_sched_entity_flush(9)
• drm_sched_entity_fini(9)
• drm_sched_entity_destroy(9)
• drm_sched_entity_set_priority(9)
• drm_sched_entity_push_job(9)

---

friendly reminder bestie: that atomic_t *guilty gets flipped to 1 when a job times out and is found guilty — it's not a toy, it's the timeout shame counter 😭 handle with care.

---

and that's the whole page, periodt 💅 this lil cutie lives over in ./drivers/gpu/drm/scheduler, dated October 2026 — so go forth, init your entities, and remember: at least one element in sched_list, always. mwah 🍓💖