Skip to contentSkip to conversation

drm/sched: Make drm_sched_entity_kill() a public function

PATCH Applied Philipp Stanner 3 participants 4 messages Apr 15 – Apr 17

Subsystems (4)
lore
Share & tools
lore

Philipp Stanner

author maintainer
#0 lore raw

PATCH v2 1/2 drm/sched: Make drm_sched_entity_kill() a public function

Some drivers do not care on teardown whether the last jobs pending in an entity are actually executed before teardown completed. For such scenarios, drm_sched_entity_flush() is not the ideal function since it's intended to wait for jobs to complete.

Make drm_sched_entity_kill() public for that use-case and update the documentation.

---
Changes in v2:
- Improve wording, fix typo.

---
 drivers/gpu/drm/scheduler/sched_entity.c | 13 +++++++++++--
 include/drm/gpu_scheduler.h              |  1 +
 2 files changed, 12 insertions(+), 2 deletions(-)
drivers/gpu/drm/scheduler/sched_entity.c +11 -2
index 61a4818cc87b..7be5811b90cd 100644
@@ -267,8 +267,16 @@ static void drm_sched_entity_kill_jobs_cb(struct dma_fence *f,
 	schedule_work(&job->work);
 }
 
-/* Remove the entity from the scheduler and kill all pending jobs */
-static void drm_sched_entity_kill(struct drm_sched_entity *entity)
+/**
+ * drm_sched_entity_kill - kill an entity's pending jobs and remove it
+ * @entity: the entity to remove
+ *
+ * Removes the entity from the scheduler's run queue and kills all pending jobs.
+ *
+ * This function should be used over drm_sched_entity_flush() if it is not
+ * desired to actually wait for all pending jobs to finish.
+ */
+void drm_sched_entity_kill(struct drm_sched_entity *entity)
 {
 	struct drm_sched_job *job;
 	struct dma_fence *prev;
@@ -306,6 +314,7 @@ static void drm_sched_entity_kill(struct drm_sched_entity *entity)
 	}
 	dma_fence_put(prev);
 }
+EXPORT_SYMBOL(drm_sched_entity_kill);
 
 /**
  * drm_sched_entity_flush - Flush a context entity
include/drm/gpu_scheduler.h +1 -0
index 53417baebd49..d61c19e78182 100644
@@ -693,6 +693,7 @@ int drm_sched_entity_init(struct drm_sched_entity *entity,
 			  unsigned int num_sched_list,
 			  atomic_t *guilty);
 long drm_sched_entity_flush(struct drm_sched_entity *entity, long timeout);
+void drm_sched_entity_kill(struct drm_sched_entity *entity);
 void drm_sched_entity_fini(struct drm_sched_entity *entity);
 void drm_sched_entity_destroy(struct drm_sched_entity *entity);
 void drm_sched_entity_set_priority(struct drm_sched_entity *entity,
Signature · 1 line
2.49.0
author maintainer
#1 lore raw

PATCH v2 2/2 drm/nouveau: Fix double call to drm_sched_entity_fini()

nouveau_abi16_chan_fini() does invoke drm_sched_entity_fini() twice:
Once directly, and a second time through nouveau_sched_destroy().

That's likely undesired behavior and might be a bug since drm_sched_entity_fini() decrements reference counts.

Fix the issue by using the appropriate function, drm_sched_entity_kill(), to kill all remaining jobs within the entity.

Fixes 9a0c32d698c1 ("drm/nouveau: don't fini scheduler if not initialized")

---
Changes in v2:
- Fix commit message (wrong named function). (Guys on IRC, M Henning)

---
 drivers/gpu/drm/nouveau/nouveau_abi16.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/gpu/drm/nouveau/nouveau_abi16.c +1 -1
index 7860877d909b..291203121f0c 100644
@@ -176,7 +176,7 @@ nouveau_abi16_chan_fini(struct nouveau_abi16 *abi16,
 
 	/* Cancel all jobs from the entity's queue. */
 	if (chan->sched)
-		drm_sched_entity_fini(&chan->sched->entity);
+		drm_sched_entity_kill(&chan->sched->entity);
 
 	if (chan->chan)
 		nouveau_channel_idle(chan->chan);
Signature · 1 line
2.49.0
maintainer Applied
#2 lore raw
In reply to Philipp Stanner
Quoted 1 line · Philipp Stanner

[PATCH v2 1/2] drm/sched: Make drm_sched_entity_kill() a public function

Applied, thanks!

Branch: drm-misc-next
Tree: https://gitlab.freedesktop.org/drm/misc/kernel.git

[1/2] drm/sched: Make drm_sched_entity_kill() a public function

      commit: 2f5f05633e22
[2/2] drm/nouveau: Fix double call to drm_sched_entity_fini()
      commit: cac96c8d93fa

The patches will appear in the next linux-next integration (typically within 24 hours on weekdays.)

The patches is queued up for the upcoming merge window for the next major kernel release.

#3 lore raw
In reply to Philipp Stanner
Quoted 7 lines · Philipp Stanner

Some drivers do not care on teardown whether the last jobs pending in an entity are actually executed before teardown completed. For such scenarios, drm_sched_entity_flush() is not the ideal function since it's intended to wait for jobs to complete.

Make drm_sched_entity_kill() public for that use-case and update the documentation.

This is a good patch and great suggestion by Danilo.

Quoted 20 lines

---
Changes in v2:
- Improve wording, fix typo.

---
 drivers/gpu/drm/scheduler/sched_entity.c | 13 +++++++++++--
 include/drm/gpu_scheduler.h              |  1 +
 2 files changed, 12 insertions(+), 2 deletions(-)
drivers/gpu/drm/scheduler/sched_entity.c +0 -1
index 61a4818cc87b..7be5811b90cd 100644
@@ -267,8 +267,16 @@ static void drm_sched_entity_kill_jobs_cb(struct dma_fence *f,
 	schedule_work(&job->work);
 }
 
-/* Remove the entity from the scheduler and kill all pending jobs */

drivers/gpu/drm/scheduler/sched_entity.c static void drm_sched_entity_kill_jobs_cb(struct dma_fence *f, · line 278

Quoted 10 lines
drivers/gpu/drm/scheduler/sched_entity.c +9 -1
-static void drm_sched_entity_kill(struct drm_sched_entity *entity)
+/**
+ * drm_sched_entity_kill - kill an entity's pending jobs and remove it
+ * @entity: the entity to remove
+ *
+ * Removes the entity from the scheduler's run queue and kills all pending jobs.
+ *
+ * This function should be used over drm_sched_entity_flush() if it is not
+ * desired to actually wait for all pending jobs to finish.
+ */

I felt that the email body above describing this patch was somewhat clearer. Perhaps something like:
(Notice the change "if" --> "when".)

"Use this function over drm_sched_entity_flush(), when the caller is not interested to wait
for pending jobs to complete. This function kills any pending jobs."

Signature · 2 lines
Regards,
Luben