1/*
2 * Copyright 2015 Advanced Micro Devices, Inc.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 *
22 */
23
24#ifndef _DRM_GPU_SCHEDULER_H_
25#define _DRM_GPU_SCHEDULER_H_
26
27#include <drm/spsc_queue.h>
28#include <linux/dma-fence.h>
29#include <linux/completion.h>
30#include <linux/xarray.h>
31#include <linux/workqueue.h>
32
33#define MAX_WAIT_SCHED_ENTITY_Q_EMPTY msecs_to_jiffies(1000)
34
35/**
36 * DRM_SCHED_FENCE_DONT_PIPELINE - Prevent dependency pipelining
37 *
38 * Setting this flag on a scheduler fence prevents pipelining of jobs depending
39 * on this fence. In other words we always insert a full CPU round trip before
40 * dependent jobs are pushed to the hw queue.
41 */
42#define DRM_SCHED_FENCE_DONT_PIPELINE DMA_FENCE_FLAG_USER_BITS
43
44/**
45 * DRM_SCHED_FENCE_FLAG_HAS_DEADLINE_BIT - A fence deadline hint has been set
46 *
47 * Because we could have a deadline hint can be set before the backing hw
48 * fence is created, we need to keep track of whether a deadline has already
49 * been set.
50 */
51#define DRM_SCHED_FENCE_FLAG_HAS_DEADLINE_BIT (DMA_FENCE_FLAG_USER_BITS + 1)
52
53enum dma_resv_usage;
54struct dma_resv;
55struct drm_gem_object;
56
57struct drm_gpu_scheduler;
58struct drm_sched_rq;
59
60struct drm_file;
61
62/* These are often used as an (initial) index
63 * to an array, and as such should start at 0.
64 */
65enum drm_sched_priority {
66 DRM_SCHED_PRIORITY_KERNEL,
67 DRM_SCHED_PRIORITY_HIGH,
68 DRM_SCHED_PRIORITY_NORMAL,
69 DRM_SCHED_PRIORITY_LOW,
70
71 DRM_SCHED_PRIORITY_COUNT
72};
73
74/**
75 * struct drm_sched_entity - A wrapper around a job queue (typically
76 * attached to the DRM file_priv).
77 *
78 * Entities will emit jobs in order to their corresponding hardware
79 * ring, and the scheduler will alternate between entities based on
80 * scheduling policy.
81 */
82struct drm_sched_entity {
83 /**
84 * @list:
85 *
86 * Used to append this struct to the list of entities in the runqueue
87 * @rq under &drm_sched_rq.entities.
88 *
89 * Protected by &drm_sched_rq.lock of @rq.
90 */
91 struct list_head list;
92
93 /**
94 * @lock:
95 *
96 * Lock protecting the run-queue (@rq) to which this entity belongs,
97 * @priority and the list of schedulers (@sched_list, @num_sched_list).
98 */
99 spinlock_t lock;
100
101 /**
102 * @rq:
103 *
104 * Runqueue on which this entity is currently scheduled.
105 *
106 * FIXME: Locking is very unclear for this. Writers are protected by
107 * @lock, but readers are generally lockless and seem to just race with
108 * not even a READ_ONCE.
109 */
110 struct drm_sched_rq *rq;
111
112 /**
113 * @sched_list:
114 *
115 * A list of schedulers (struct drm_gpu_scheduler). Jobs from this entity can
116 * be scheduled on any scheduler on this list.
117 *
118 * This can be modified by calling drm_sched_entity_modify_sched().
119 * Locking is entirely up to the driver, see the above function for more
120 * details.
121 *
122 * This will be set to NULL if &num_sched_list equals 1 and @rq has been
123 * set already.
124 *
125 * FIXME: This means priority changes through
126 * drm_sched_entity_set_priority() will be lost henceforth in this case.
127 */
128 struct drm_gpu_scheduler **sched_list;
129
130 /**
131 * @num_sched_list:
132 *
133 * Number of drm_gpu_schedulers in the @sched_list.
134 */
135 unsigned int num_sched_list;
136
137 /**
138 * @priority:
139 *
140 * Priority of the entity. This can be modified by calling
141 * drm_sched_entity_set_priority(). Protected by @lock.
142 */
143 enum drm_sched_priority priority;
144
145 /**
146 * @job_queue: the list of jobs of this entity.
147 */
148 struct spsc_queue job_queue;
149
150 /**
151 * @fence_seq:
152 *
153 * A linearly increasing seqno incremented with each new
154 * &drm_sched_fence which is part of the entity.
155 *
156 * FIXME: Callers of drm_sched_job_arm() need to ensure correct locking,
157 * this doesn't need to be atomic.
158 */
159 atomic_t fence_seq;
160
161 /**
162 * @fence_context:
163 *
164 * A unique context for all the fences which belong to this entity. The
165 * &drm_sched_fence.scheduled uses the fence_context but
166 * &drm_sched_fence.finished uses fence_context + 1.
167 */
168 uint64_t fence_context;
169
170 /**
171 * @dependency:
172 *
173 * The dependency fence of the job which is on the top of the job queue.
174 */
175 struct dma_fence *dependency;
176
177 /**
178 * @cb:
179 *
180 * Callback for the dependency fence above.
181 */
182 struct dma_fence_cb cb;
183
184 /**
185 * @guilty:
186 *
187 * Points to entities' guilty.
188 */
189 atomic_t *guilty;
190
191 /**
192 * @last_scheduled:
193 *
194 * Points to the finished fence of the last scheduled job. Only written
195 * by the scheduler thread, can be accessed locklessly from
196 * drm_sched_job_arm() if the queue is empty.
197 */
198 struct dma_fence __rcu *last_scheduled;
199
200 /**
201 * @last_user: last group leader pushing a job into the entity.
202 */
203 struct task_struct *last_user;
204
205 /**
206 * @stopped:
207 *
208 * Marks the enity as removed from rq and destined for
209 * termination. This is set by calling drm_sched_entity_flush() and by
210 * drm_sched_fini().
211 */
212 bool stopped;
213
214 /**
215 * @entity_idle:
216 *
217 * Signals when entity is not in use, used to sequence entity cleanup in
218 * drm_sched_entity_fini().
219 */
220 struct completion entity_idle;
221
222 /**
223 * @oldest_job_waiting:
224 *
225 * Marks earliest job waiting in SW queue
226 */
227 ktime_t oldest_job_waiting;
228
229 /**
230 * @rb_tree_node:
231 *
232 * The node used to insert this entity into time based priority queue
233 */
234 struct rb_node rb_tree_node;
235
236};
237
238/**
239 * struct drm_sched_rq - queue of entities to be scheduled.
240 *
241 * @sched: the scheduler to which this rq belongs to.
242 * @lock: protects @entities, @rb_tree_root and @current_entity.
243 * @current_entity: the entity which is to be scheduled.
244 * @entities: list of the entities to be scheduled.
245 * @rb_tree_root: root of time based priority queue of entities for FIFO scheduling
246 *
247 * Run queue is a set of entities scheduling command submissions for
248 * one specific ring. It implements the scheduling policy that selects
249 * the next entity to emit commands from.
250 */
251struct drm_sched_rq {
252 struct drm_gpu_scheduler *sched;
253
254 spinlock_t lock;
255 /* Following members are protected by the @lock: */
256 struct drm_sched_entity *current_entity;
257 struct list_head entities;
258 struct rb_root_cached rb_tree_root;
259};
260
261/**
262 * struct drm_sched_fence - fences corresponding to the scheduling of a job.
263 */
264struct drm_sched_fence {
265 /**
266 * @scheduled: this fence is what will be signaled by the scheduler
267 * when the job is scheduled.
268 */
269 struct dma_fence scheduled;
270
271 /**
272 * @finished: this fence is what will be signaled by the scheduler
273 * when the job is completed.
274 *
275 * When setting up an out fence for the job, you should use
276 * this, since it's available immediately upon
277 * drm_sched_job_init(), and the fence returned by the driver
278 * from run_job() won't be created until the dependencies have
279 * resolved.
280 */
281 struct dma_fence finished;
282
283 /**
284 * @deadline: deadline set on &drm_sched_fence.finished which
285 * potentially needs to be propagated to &drm_sched_fence.parent
286 */
287 ktime_t deadline;
288
289 /**
290 * @parent: the fence returned by &drm_sched_backend_ops.run_job
291 * when scheduling the job on hardware. We signal the
292 * &drm_sched_fence.finished fence once parent is signalled.
293 */
294 struct dma_fence *parent;
295 /**
296 * @sched: the scheduler instance to which the job having this struct
297 * belongs to.
298 */
299 struct drm_gpu_scheduler *sched;
300 /**
301 * @lock: the lock used by the scheduled and the finished fences.
302 */
303 spinlock_t lock;
304 /**
305 * @owner: job owner for debugging
306 */
307 void *owner;
308};
309
310struct drm_sched_fence *to_drm_sched_fence(struct dma_fence *f);
311
312/**
313 * struct drm_sched_job - A job to be run by an entity.
314 *
315 * @queue_node: used to append this struct to the queue of jobs in an entity.
316 * @list: a job participates in a "pending" and "done" lists.
317 * @sched: the scheduler instance on which this job is scheduled.
318 * @s_fence: contains the fences for the scheduling of job.
319 * @finish_cb: the callback for the finished fence.
320 * @credits: the number of credits this job contributes to the scheduler
321 * @work: Helper to reschedule job kill to different context.
322 * @id: a unique id assigned to each job scheduled on the scheduler.
323 * @karma: increment on every hang caused by this job. If this exceeds the hang
324 * limit of the scheduler then the job is marked guilty and will not
325 * be scheduled further.
326 * @s_priority: the priority of the job.
327 * @entity: the entity to which this job belongs.
328 * @cb: the callback for the parent fence in s_fence.
329 *
330 * A job is created by the driver using drm_sched_job_init(), and
331 * should call drm_sched_entity_push_job() once it wants the scheduler
332 * to schedule the job.
333 */
334struct drm_sched_job {
335 u64 id;
336
337 /**
338 * @submit_ts:
339 *
340 * When the job was pushed into the entity queue.
341 */
342 ktime_t submit_ts;
343
344 /**
345 * @sched:
346 *
347 * The scheduler this job is or will be scheduled on. Gets set by
348 * drm_sched_job_arm(). Valid until drm_sched_backend_ops.free_job()
349 * has finished.
350 */
351 struct drm_gpu_scheduler *sched;
352
353 struct drm_sched_fence *s_fence;
354 struct drm_sched_entity *entity;
355
356 enum drm_sched_priority s_priority;
357 u32 credits;
358 /** @last_dependency: tracks @dependencies as they signal */
359 unsigned int last_dependency;
360 atomic_t karma;
361
362 struct spsc_node queue_node;
363 struct list_head list;
364
365 /*
366 * work is used only after finish_cb has been used and will not be
367 * accessed anymore.
368 */
369 union {
370 struct dma_fence_cb finish_cb;
371 struct work_struct work;
372 };
373
374 struct dma_fence_cb cb;
375
376 /**
377 * @dependencies:
378 *
379 * Contains the dependencies as struct dma_fence for this job, see
380 * drm_sched_job_add_dependency() and
381 * drm_sched_job_add_implicit_dependencies().
382 */
383 struct xarray dependencies;
384};
385
386/**
387 * enum drm_gpu_sched_stat - the scheduler's status
388 *
389 * @DRM_GPU_SCHED_STAT_NONE: Reserved. Do not use.
390 * @DRM_GPU_SCHED_STAT_NOMINAL: Operation succeeded.
391 * @DRM_GPU_SCHED_STAT_ENODEV: Error: Device is not available anymore.
392 */
393enum drm_gpu_sched_stat {
394 DRM_GPU_SCHED_STAT_NONE,
395 DRM_GPU_SCHED_STAT_NOMINAL,
396 DRM_GPU_SCHED_STAT_ENODEV,
397};
398
399/**
400 * struct drm_sched_backend_ops - Define the backend operations
401 * called by the scheduler
402 *
403 * These functions should be implemented in the driver side.
404 */
405struct drm_sched_backend_ops {
406 /**
407 * @prepare_job:
408 *
409 * Called when the scheduler is considering scheduling this job next, to
410 * get another struct dma_fence for this job to block on. Once it
411 * returns NULL, run_job() may be called.
412 *
413 * Can be NULL if no additional preparation to the dependencies are
414 * necessary. Skipped when jobs are killed instead of run.
415 */
416 struct dma_fence *(*prepare_job)(struct drm_sched_job *sched_job,
417 struct drm_sched_entity *s_entity);
418
419 /**
420 * @run_job: Called to execute the job once all of the dependencies
421 * have been resolved.
422 *
423 * @sched_job: the job to run
424 *
425 * The deprecated drm_sched_resubmit_jobs() (called by &struct
426 * drm_sched_backend_ops.timedout_job) can invoke this again with the
427 * same parameters. Using this is discouraged because it violates
428 * dma_fence rules, notably dma_fence_init() has to be called on
429 * already initialized fences for a second time. Moreover, this is
430 * dangerous because attempts to allocate memory might deadlock with
431 * memory management code waiting for the reset to complete.
432 *
433 * TODO: Document what drivers should do / use instead.
434 *
435 * This method is called in a workqueue context - either from the
436 * submit_wq the driver passed through drm_sched_init(), or, if the
437 * driver passed NULL, a separate, ordered workqueue the scheduler
438 * allocated.
439 *
440 * Note that the scheduler expects to 'inherit' its own reference to
441 * this fence from the callback. It does not invoke an extra
442 * dma_fence_get() on it. Consequently, this callback must take a
443 * reference for the scheduler, and additional ones for the driver's
444 * respective needs.
445 *
446 * Return:
447 * * On success: dma_fence the driver must signal once the hardware has
448 * completed the job ("hardware fence").
449 * * On failure: NULL or an ERR_PTR.
450 */
451 struct dma_fence *(*run_job)(struct drm_sched_job *sched_job);
452
453 /**
454 * @timedout_job: Called when a job has taken too long to execute,
455 * to trigger GPU recovery.
456 *
457 * @sched_job: The job that has timed out
458 *
459 * Drivers typically issue a reset to recover from GPU hangs.
460 * This procedure looks very different depending on whether a firmware
461 * or a hardware scheduler is being used.
462 *
463 * For a FIRMWARE SCHEDULER, each ring has one scheduler, and each
464 * scheduler has one entity. Hence, the steps taken typically look as
465 * follows:
466 *
467 * 1. Stop the scheduler using drm_sched_stop(). This will pause the
468 * scheduler workqueues and cancel the timeout work, guaranteeing
469 * that nothing is queued while the ring is being removed.
470 * 2. Remove the ring. The firmware will make sure that the
471 * corresponding parts of the hardware are resetted, and that other
472 * rings are not impacted.
473 * 3. Kill the entity and the associated scheduler.
474 *
475 *
476 * For a HARDWARE SCHEDULER, a scheduler instance schedules jobs from
477 * one or more entities to one ring. This implies that all entities
478 * associated with the affected scheduler cannot be torn down, because
479 * this would effectively also affect innocent userspace processes which
480 * did not submit faulty jobs (for example).
481 *
482 * Consequently, the procedure to recover with a hardware scheduler
483 * should look like this:
484 *
485 * 1. Stop all schedulers impacted by the reset using drm_sched_stop().
486 * 2. Kill the entity the faulty job stems from.
487 * 3. Issue a GPU reset on all faulty rings (driver-specific).
488 * 4. Re-submit jobs on all schedulers impacted by re-submitting them to
489 * the entities which are still alive.
490 * 5. Restart all schedulers that were stopped in step #1 using
491 * drm_sched_start().
492 *
493 * Note that some GPUs have distinct hardware queues but need to reset
494 * the GPU globally, which requires extra synchronization between the
495 * timeout handlers of different schedulers. One way to achieve this
496 * synchronization is to create an ordered workqueue (using
497 * alloc_ordered_workqueue()) at the driver level, and pass this queue
498 * as drm_sched_init()'s @timeout_wq parameter. This will guarantee
499 * that timeout handlers are executed sequentially.
500 *
501 * Return: The scheduler's status, defined by &enum drm_gpu_sched_stat
502 *
503 */
504 enum drm_gpu_sched_stat (*timedout_job)(struct drm_sched_job *sched_job);
505
506 /**
507 * @free_job: Called once the job's finished fence has been signaled
508 * and it's time to clean it up.
509 */
510 void (*free_job)(struct drm_sched_job *sched_job);
511};
512
513/**
514 * struct drm_gpu_scheduler - scheduler instance-specific data
515 *
516 * @ops: backend operations provided by the driver.
517 * @credit_limit: the credit limit of this scheduler
518 * @credit_count: the current credit count of this scheduler
519 * @timeout: the time after which a job is removed from the scheduler.
520 * @name: name of the ring for which this scheduler is being used.
521 * @num_rqs: Number of run-queues. This is at most DRM_SCHED_PRIORITY_COUNT,
522 * as there's usually one run-queue per priority, but could be less.
523 * @sched_rq: An allocated array of run-queues of size @num_rqs;
524 * @job_scheduled: once @drm_sched_entity_do_release is called the scheduler
525 * waits on this wait queue until all the scheduled jobs are
526 * finished.
527 * @job_id_count: used to assign unique id to the each job.
528 * @submit_wq: workqueue used to queue @work_run_job and @work_free_job
529 * @timeout_wq: workqueue used to queue @work_tdr
530 * @work_run_job: work which calls run_job op of each scheduler.
531 * @work_free_job: work which calls free_job op of each scheduler.
532 * @work_tdr: schedules a delayed call to @drm_sched_job_timedout after the
533 * timeout interval is over.
534 * @pending_list: the list of jobs which are currently in the job queue.
535 * @job_list_lock: lock to protect the pending_list.
536 * @hang_limit: once the hangs by a job crosses this limit then it is marked
537 * guilty and it will no longer be considered for scheduling.
538 * @score: score to help loadbalancer pick a idle sched
539 * @_score: score used when the driver doesn't provide one
540 * @ready: marks if the underlying HW is ready to work
541 * @free_guilty: A hit to time out handler to free the guilty job.
542 * @pause_submit: pause queuing of @work_run_job on @submit_wq
543 * @own_submit_wq: scheduler owns allocation of @submit_wq
544 * @dev: system &struct device
545 *
546 * One scheduler is implemented for each hardware ring.
547 */
548struct drm_gpu_scheduler {
549 const struct drm_sched_backend_ops *ops;
550 u32 credit_limit;
551 atomic_t credit_count;
552 long timeout;
553 const char *name;
554 u32 num_rqs;
555 struct drm_sched_rq **sched_rq;
556 wait_queue_head_t job_scheduled;
557 atomic64_t job_id_count;
558 struct workqueue_struct *submit_wq;
559 struct workqueue_struct *timeout_wq;
560 struct work_struct work_run_job;
561 struct work_struct work_free_job;
562 struct delayed_work work_tdr;
563 struct list_head pending_list;
564 spinlock_t job_list_lock;
565 int hang_limit;
566 atomic_t *score;
567 atomic_t _score;
568 bool ready;
569 bool free_guilty;
570 bool pause_submit;
571 bool own_submit_wq;
572 struct device *dev;
573};
574
575/**
576 * struct drm_sched_init_args - parameters for initializing a DRM GPU scheduler
577 *
578 * @ops: backend operations provided by the driver
579 * @submit_wq: workqueue to use for submission. If NULL, an ordered wq is
580 * allocated and used.
581 * @num_rqs: Number of run-queues. This may be at most DRM_SCHED_PRIORITY_COUNT,
582 * as there's usually one run-queue per priority, but may be less.
583 * @credit_limit: the number of credits this scheduler can hold from all jobs
584 * @hang_limit: number of times to allow a job to hang before dropping it.
585 * This mechanism is DEPRECATED. Set it to 0.
586 * @timeout: timeout value in jiffies for submitted jobs.
587 * @timeout_wq: workqueue to use for timeout work. If NULL, the system_wq is used.
588 * @score: score atomic shared with other schedulers. May be NULL.
589 * @name: name (typically the driver's name). Used for debugging
590 * @dev: associated device. Used for debugging
591 */
592struct drm_sched_init_args {
593 const struct drm_sched_backend_ops *ops;
594 struct workqueue_struct *submit_wq;
595 struct workqueue_struct *timeout_wq;
596 u32 num_rqs;
597 u32 credit_limit;
598 unsigned int hang_limit;
599 long timeout;
600 atomic_t *score;
601 const char *name;
602 struct device *dev;
603};
604
605/* Scheduler operations */
606
607int drm_sched_init(struct drm_gpu_scheduler *sched,
608 const struct drm_sched_init_args *args);
609
610void drm_sched_fini(struct drm_gpu_scheduler *sched);
611
612unsigned long drm_sched_suspend_timeout(struct drm_gpu_scheduler *sched);
613void drm_sched_resume_timeout(struct drm_gpu_scheduler *sched,
614 unsigned long remaining);
615void drm_sched_tdr_queue_imm(struct drm_gpu_scheduler *sched);
616bool drm_sched_wqueue_ready(struct drm_gpu_scheduler *sched);
617void drm_sched_wqueue_stop(struct drm_gpu_scheduler *sched);
618void drm_sched_wqueue_start(struct drm_gpu_scheduler *sched);
619void drm_sched_stop(struct drm_gpu_scheduler *sched, struct drm_sched_job *bad);
620void drm_sched_start(struct drm_gpu_scheduler *sched, int errno);
621void drm_sched_resubmit_jobs(struct drm_gpu_scheduler *sched);
622void drm_sched_fault(struct drm_gpu_scheduler *sched);
623
624struct drm_gpu_scheduler *
625drm_sched_pick_best(struct drm_gpu_scheduler **sched_list,
626 unsigned int num_sched_list);
627
628/* Jobs */
629
630int drm_sched_job_init(struct drm_sched_job *job,
631 struct drm_sched_entity *entity,
632 u32 credits, void *owner);
633void drm_sched_job_arm(struct drm_sched_job *job);
634void drm_sched_entity_push_job(struct drm_sched_job *sched_job);
635int drm_sched_job_add_dependency(struct drm_sched_job *job,
636 struct dma_fence *fence);
637int drm_sched_job_add_syncobj_dependency(struct drm_sched_job *job,
638 struct drm_file *file,
639 u32 handle,
640 u32 point);
641int drm_sched_job_add_resv_dependencies(struct drm_sched_job *job,
642 struct dma_resv *resv,
643 enum dma_resv_usage usage);
644int drm_sched_job_add_implicit_dependencies(struct drm_sched_job *job,
645 struct drm_gem_object *obj,
646 bool write);
647bool drm_sched_job_has_dependency(struct drm_sched_job *job,
648 struct dma_fence *fence);
649void drm_sched_job_cleanup(struct drm_sched_job *job);
650void drm_sched_increase_karma(struct drm_sched_job *bad);
651
652static inline bool drm_sched_invalidate_job(struct drm_sched_job *s_job,
653 int threshold)
654{
655 return s_job && atomic_inc_return(v: &s_job->karma) > threshold;
656}
657
658/* Entities */
659
660int drm_sched_entity_init(struct drm_sched_entity *entity,
661 enum drm_sched_priority priority,
662 struct drm_gpu_scheduler **sched_list,
663 unsigned int num_sched_list,
664 atomic_t *guilty);
665long drm_sched_entity_flush(struct drm_sched_entity *entity, long timeout);
666void drm_sched_entity_fini(struct drm_sched_entity *entity);
667void drm_sched_entity_destroy(struct drm_sched_entity *entity);
668void drm_sched_entity_set_priority(struct drm_sched_entity *entity,
669 enum drm_sched_priority priority);
670int drm_sched_entity_error(struct drm_sched_entity *entity);
671void drm_sched_entity_modify_sched(struct drm_sched_entity *entity,
672 struct drm_gpu_scheduler **sched_list,
673 unsigned int num_sched_list);
674
675#endif
676

source code of linux/include/drm/gpu_scheduler.h