drm/i915/i915_scheduler.h

0001 /*
0002  * SPDX-License-Identifier: MIT
0003  *
0004  * Copyright © 2018 Intel Corporation
0005  */
0006
0007 #ifndef _I915_SCHEDULER_H_
0008 #define _I915_SCHEDULER_H_
0009
0010 #include <linux/bitops.h>
0011 #include <linux/list.h>
0012 #include <linux/kernel.h>
0013
0014 #include "i915_scheduler_types.h"
0015 #include "i915_tasklet.h"
0016
0017 struct drm_printer;
0018
0019 #define priolist_for_each_request(it, plist) \
0020     list_for_each_entry(it, &(plist)->requests, sched.link)
0021
0022 #define priolist_for_each_request_consume(it, n, plist) \
0023     list_for_each_entry_safe(it, n, &(plist)->requests, sched.link)
0024
0025 void i915_sched_node_init(struct i915_sched_node *node);
0026 void i915_sched_node_reinit(struct i915_sched_node *node);
0027
0028 bool __i915_sched_node_add_dependency(struct i915_sched_node *node,
0029                       struct i915_sched_node *signal,
0030                       struct i915_dependency *dep,
0031                       unsigned long flags);
0032
0033 int i915_sched_node_add_dependency(struct i915_sched_node *node,
0034                    struct i915_sched_node *signal,
0035                    unsigned long flags);
0036
0037 void i915_sched_node_fini(struct i915_sched_node *node);
0038
0039 void i915_schedule(struct i915_request *request,
0040            const struct i915_sched_attr *attr);
0041
0042 struct list_head *
0043 i915_sched_lookup_priolist(struct i915_sched_engine *sched_engine, int prio);
0044
0045 void __i915_priolist_free(struct i915_priolist *p);
0046 static inline void i915_priolist_free(struct i915_priolist *p)
0047 {
0048     if (p->priority != I915_PRIORITY_NORMAL)
0049         __i915_priolist_free(p);
0050 }
0051
0052 struct i915_sched_engine *
0053 i915_sched_engine_create(unsigned int subclass);
0054
0055 static inline struct i915_sched_engine *
0056 i915_sched_engine_get(struct i915_sched_engine *sched_engine)
0057 {
0058     kref_get(&sched_engine->ref);
0059     return sched_engine;
0060 }
0061
0062 static inline void
0063 i915_sched_engine_put(struct i915_sched_engine *sched_engine)
0064 {
0065     kref_put(&sched_engine->ref, sched_engine->destroy);
0066 }
0067
0068 static inline bool
0069 i915_sched_engine_is_empty(struct i915_sched_engine *sched_engine)
0070 {
0071     return RB_EMPTY_ROOT(&sched_engine->queue.rb_root);
0072 }
0073
0074 static inline void
0075 i915_sched_engine_reset_on_empty(struct i915_sched_engine *sched_engine)
0076 {
0077     if (i915_sched_engine_is_empty(sched_engine))
0078         sched_engine->no_priolist = false;
0079 }
0080
0081 static inline void
0082 i915_sched_engine_active_lock_bh(struct i915_sched_engine *sched_engine)
0083 {
0084     local_bh_disable(); /* prevent local softirq and lock recursion */
0085     tasklet_lock(&sched_engine->tasklet);
0086 }
0087
0088 static inline void
0089 i915_sched_engine_active_unlock_bh(struct i915_sched_engine *sched_engine)
0090 {
0091     tasklet_unlock(&sched_engine->tasklet);
0092     local_bh_enable(); /* restore softirq, and kick ksoftirqd! */
0093 }
0094
0095 void i915_request_show_with_schedule(struct drm_printer *m,
0096                      const struct i915_request *rq,
0097                      const char *prefix,
0098                      int indent);
0099
0100 static inline bool
0101 i915_sched_engine_disabled(struct i915_sched_engine *sched_engine)
0102 {
0103     return sched_engine->disabled(sched_engine);
0104 }
0105
0106 void i915_scheduler_module_exit(void);
0107 int i915_scheduler_module_init(void);
0108
0109 #endif /* _I915_SCHEDULER_H_ */