37  * drm_sched_entity_init - Init a context entity used by scheduler when
40  * @entity: scheduler entity to init
41  * @priority: priority of the entity
43  *           entity can be submitted
48  * Note that the &sched_list must have at least one element to schedule the entity.
54  * An entity is cleaned up by callind drm_sched_entity_fini(). See also
59 int drm_sched_entity_init(struct drm_sched_entity *entity,  in drm_sched_entity_init()  argument
65 	if (!(entity && sched_list && (num_sched_list == 0 || sched_list[0])))  in drm_sched_entity_init()
68 	memset(entity, 0, sizeof(struct drm_sched_entity));  in drm_sched_entity_init()
69 	INIT_LIST_HEAD(&entity->list);  in drm_sched_entity_init()
70 	entity->rq = NULL;  in drm_sched_entity_init()
71 	entity->guilty = guilty;  in drm_sched_entity_init()
72 	entity->num_sched_list = num_sched_list;  in drm_sched_entity_init()
73 	entity->priority = priority;  in drm_sched_entity_init()
74 	entity->sched_list = num_sched_list > 1 ? sched_list : NULL;  in drm_sched_entity_init()
75 	entity->last_scheduled = NULL;  in drm_sched_entity_init()
78 		entity->rq = &sched_list[0]->sched_rq[entity->priority];  in drm_sched_entity_init()
80 	init_completion(&entity->entity_idle);  in drm_sched_entity_init()
83 	complete(&entity->entity_idle);  in drm_sched_entity_init()
85 	spin_lock_init(&entity->rq_lock);  in drm_sched_entity_init()
86 	spsc_queue_init(&entity->job_queue);  in drm_sched_entity_init()
88 	atomic_set(&entity->fence_seq, 0);  in drm_sched_entity_init()
89 	entity->fence_context = dma_fence_context_alloc(2);  in drm_sched_entity_init()
96  * drm_sched_entity_modify_sched - Modify sched of an entity
97  * @entity: scheduler entity to init
99  *		 existing entity->sched_list
102  * Note that this must be called under the same common lock for @entity as
105  * can be pushed to @entity.
107 void drm_sched_entity_modify_sched(struct drm_sched_entity *entity,  in drm_sched_entity_modify_sched()  argument
113 	entity->sched_list = sched_list;  in drm_sched_entity_modify_sched()
114 	entity->num_sched_list = num_sched_list;  in drm_sched_entity_modify_sched()
118 static bool drm_sched_entity_is_idle(struct drm_sched_entity *entity)  in drm_sched_entity_is_idle()  argument
122 	if (list_empty(&entity->list) ||  in drm_sched_entity_is_idle()
123 	    spsc_queue_count(&entity->job_queue) == 0 ||  in drm_sched_entity_is_idle()
124 	    entity->stopped)  in drm_sched_entity_is_idle()
130 /* Return true if entity could provide a job. */
131 bool drm_sched_entity_is_ready(struct drm_sched_entity *entity)  in drm_sched_entity_is_ready()  argument
133 	if (spsc_queue_peek(&entity->job_queue) == NULL)  in drm_sched_entity_is_ready()
136 	if (READ_ONCE(entity->dependency))  in drm_sched_entity_is_ready()
143  * drm_sched_entity_flush - Flush a context entity
145  * @entity: scheduler entity
149  * waiting, removes the entity from the runqueue and returns an error when the
154 long drm_sched_entity_flush(struct drm_sched_entity *entity, long timeout)  in drm_sched_entity_flush()  argument
160 	if (!entity->rq)  in drm_sched_entity_flush()
163 	sched = entity->rq->sched;  in drm_sched_entity_flush()
172 					drm_sched_entity_is_idle(entity),  in drm_sched_entity_flush()
176 				    drm_sched_entity_is_idle(entity));  in drm_sched_entity_flush()
180 	last_user = cmpxchg(&entity->last_user, current->group_leader, NULL);  in drm_sched_entity_flush()
183 		spin_lock(&entity->rq_lock);  in drm_sched_entity_flush()
184 		entity->stopped = true;  in drm_sched_entity_flush()
185 		drm_sched_rq_remove_entity(entity->rq, entity);  in drm_sched_entity_flush()
186 		spin_unlock(&entity->rq_lock);  in drm_sched_entity_flush()
203 /* Signal the scheduler finished fence when the entity in question is killed. */
217 			 struct drm_sched_entity *entity)  in drm_sched_job_dependency()  argument
223 		return job->sched->ops->dependency(job, entity);  in drm_sched_job_dependency()
228 static void drm_sched_entity_kill_jobs(struct drm_sched_entity *entity)  in drm_sched_entity_kill_jobs()  argument
234 	while ((job = to_drm_sched_job(spsc_queue_pop(&entity->job_queue)))) {  in drm_sched_entity_kill_jobs()
238 		while ((f = drm_sched_job_dependency(job, entity))) {  in drm_sched_entity_kill_jobs()
247 		 * When pipe is hanged by older entity, new entity might  in drm_sched_entity_kill_jobs()
249 		 * and so entity->last_scheduled will remain NULL  in drm_sched_entity_kill_jobs()
251 		if (!entity->last_scheduled) {  in drm_sched_entity_kill_jobs()
256 		dma_fence_get(entity->last_scheduled);  in drm_sched_entity_kill_jobs()
257 		r = dma_fence_add_callback(entity->last_scheduled,  in drm_sched_entity_kill_jobs()
268  * drm_sched_entity_fini - Destroy a context entity
270  * @entity: scheduler entity
272  * Cleanups up @entity which has been initialized by drm_sched_entity_init().
276  * the entity and signals all jobs with an error code if the process was killed.
278 void drm_sched_entity_fini(struct drm_sched_entity *entity)  in drm_sched_entity_fini()  argument
282 	if (entity->rq) {  in drm_sched_entity_fini()
283 		sched = entity->rq->sched;  in drm_sched_entity_fini()
284 		drm_sched_rq_remove_entity(entity->rq, entity);  in drm_sched_entity_fini()
290 	if (spsc_queue_count(&entity->job_queue)) {  in drm_sched_entity_fini()
294 			 * this entity.  in drm_sched_entity_fini()
296 			wait_for_completion(&entity->entity_idle);  in drm_sched_entity_fini()
299 		if (entity->dependency) {  in drm_sched_entity_fini()
300 			dma_fence_remove_callback(entity->dependency,  in drm_sched_entity_fini()
301 						  &entity->cb);  in drm_sched_entity_fini()
302 			dma_fence_put(entity->dependency);  in drm_sched_entity_fini()
303 			entity->dependency = NULL;  in drm_sched_entity_fini()
306 		drm_sched_entity_kill_jobs(entity);  in drm_sched_entity_fini()
309 	dma_fence_put(entity->last_scheduled);  in drm_sched_entity_fini()
310 	entity->last_scheduled = NULL;  in drm_sched_entity_fini()
315  * drm_sched_entity_destroy - Destroy a context entity
316  * @entity: scheduler entity
321 void drm_sched_entity_destroy(struct drm_sched_entity *entity)  in drm_sched_entity_destroy()  argument
323 	drm_sched_entity_flush(entity, MAX_WAIT_SCHED_ENTITY_Q_EMPTY);  in drm_sched_entity_destroy()
324 	drm_sched_entity_fini(entity);  in drm_sched_entity_destroy()
332 	struct drm_sched_entity *entity =  in drm_sched_entity_clear_dep()  local
335 	entity->dependency = NULL;  in drm_sched_entity_clear_dep()
346 	struct drm_sched_entity *entity =  in drm_sched_entity_wakeup()  local
350 	drm_sched_wakeup(entity->rq->sched);  in drm_sched_entity_wakeup()
354  * drm_sched_entity_set_priority - Sets priority of the entity
356  * @entity: scheduler entity
359  * Update the priority of runqueus used for the entity.
361 void drm_sched_entity_set_priority(struct drm_sched_entity *entity,  in drm_sched_entity_set_priority()  argument
364 	spin_lock(&entity->rq_lock);  in drm_sched_entity_set_priority()
365 	entity->priority = priority;  in drm_sched_entity_set_priority()
366 	spin_unlock(&entity->rq_lock);  in drm_sched_entity_set_priority()
371  * Add a callback to the current dependency of the entity to wake up the
372  * scheduler when the entity becomes available.
374 static bool drm_sched_entity_add_dependency_cb(struct drm_sched_entity *entity)  in drm_sched_entity_add_dependency_cb()  argument
376 	struct drm_gpu_scheduler *sched = entity->rq->sched;  in drm_sched_entity_add_dependency_cb()
377 	struct dma_fence *fence = entity->dependency;  in drm_sched_entity_add_dependency_cb()
380 	if (fence->context == entity->fence_context ||  in drm_sched_entity_add_dependency_cb()
381 	    fence->context == entity->fence_context + 1) {  in drm_sched_entity_add_dependency_cb()
384 		 * which belongs to the same entity, we can ignore  in drm_sched_entity_add_dependency_cb()
387 		dma_fence_put(entity->dependency);  in drm_sched_entity_add_dependency_cb()
400 		dma_fence_put(entity->dependency);  in drm_sched_entity_add_dependency_cb()
401 		entity->dependency = fence;  in drm_sched_entity_add_dependency_cb()
402 		if (!dma_fence_add_callback(fence, &entity->cb,  in drm_sched_entity_add_dependency_cb()
411 	if (!dma_fence_add_callback(entity->dependency, &entity->cb,  in drm_sched_entity_add_dependency_cb()
415 	dma_fence_put(entity->dependency);  in drm_sched_entity_add_dependency_cb()
419 struct drm_sched_job *drm_sched_entity_pop_job(struct drm_sched_entity *entity)  in drm_sched_entity_pop_job()  argument
423 	sched_job = to_drm_sched_job(spsc_queue_peek(&entity->job_queue));  in drm_sched_entity_pop_job()
427 	while ((entity->dependency =  in drm_sched_entity_pop_job()
428 			drm_sched_job_dependency(sched_job, entity))) {  in drm_sched_entity_pop_job()
429 		trace_drm_sched_job_wait_dep(sched_job, entity->dependency);  in drm_sched_entity_pop_job()
431 		if (drm_sched_entity_add_dependency_cb(entity))  in drm_sched_entity_pop_job()
435 	/* skip jobs from entity that marked guilty */  in drm_sched_entity_pop_job()
436 	if (entity->guilty && atomic_read(entity->guilty))  in drm_sched_entity_pop_job()
439 	dma_fence_put(entity->last_scheduled);  in drm_sched_entity_pop_job()
441 	entity->last_scheduled = dma_fence_get(&sched_job->s_fence->finished);  in drm_sched_entity_pop_job()
450 	spsc_queue_pop(&entity->job_queue);  in drm_sched_entity_pop_job()
454 void drm_sched_entity_select_rq(struct drm_sched_entity *entity)  in drm_sched_entity_select_rq()  argument
461 	if (!entity->sched_list)  in drm_sched_entity_select_rq()
465 	if (spsc_queue_count(&entity->job_queue))  in drm_sched_entity_select_rq()
476 	fence = entity->last_scheduled;  in drm_sched_entity_select_rq()
482 	spin_lock(&entity->rq_lock);  in drm_sched_entity_select_rq()
483 	sched = drm_sched_pick_best(entity->sched_list, entity->num_sched_list);  in drm_sched_entity_select_rq()
484 	rq = sched ? &sched->sched_rq[entity->priority] : NULL;  in drm_sched_entity_select_rq()
485 	if (rq != entity->rq) {  in drm_sched_entity_select_rq()
486 		drm_sched_rq_remove_entity(entity->rq, entity);  in drm_sched_entity_select_rq()
487 		entity->rq = rq;  in drm_sched_entity_select_rq()
489 	spin_unlock(&entity->rq_lock);  in drm_sched_entity_select_rq()
491 	if (entity->num_sched_list == 1)  in drm_sched_entity_select_rq()
492 		entity->sched_list = NULL;  in drm_sched_entity_select_rq()
496  * drm_sched_entity_push_job - Submit a job to the entity's job queue
508 	struct drm_sched_entity *entity = sched_job->entity;  in drm_sched_entity_push_job()  local
511 	trace_drm_sched_job(sched_job, entity);  in drm_sched_entity_push_job()
512 	atomic_inc(entity->rq->sched->score);  in drm_sched_entity_push_job()
513 	WRITE_ONCE(entity->last_user, current->group_leader);  in drm_sched_entity_push_job()
514 	first = spsc_queue_push(&entity->job_queue, &sched_job->queue_node);  in drm_sched_entity_push_job()
518 		/* Add the entity to the run queue */  in drm_sched_entity_push_job()
519 		spin_lock(&entity->rq_lock);  in drm_sched_entity_push_job()
520 		if (entity->stopped) {  in drm_sched_entity_push_job()
521 			spin_unlock(&entity->rq_lock);  in drm_sched_entity_push_job()
523 			DRM_ERROR("Trying to push to a killed entity\n");  in drm_sched_entity_push_job()
526 		drm_sched_rq_add_entity(entity->rq, entity);  in drm_sched_entity_push_job()
527 		spin_unlock(&entity->rq_lock);  in drm_sched_entity_push_job()
528 		drm_sched_wakeup(entity->rq->sched);  in drm_sched_entity_push_job()