2 * SPDX-License-Identifier: MIT
4 * Copyright © 2016 Intel Corporation
7 #ifndef __I915_GEM_CONTEXT_H__
8 #define __I915_GEM_CONTEXT_H__
10 #include "i915_gem_context_types.h"
12 #include "gt/intel_context.h"
15 #include "i915_scheduler.h"
16 #include "intel_device_info.h"
21 static inline bool i915_gem_context_is_closed(const struct i915_gem_context *ctx)
23 return test_bit(CONTEXT_CLOSED, &ctx->flags);
26 static inline void i915_gem_context_set_closed(struct i915_gem_context *ctx)
28 GEM_BUG_ON(i915_gem_context_is_closed(ctx));
29 set_bit(CONTEXT_CLOSED, &ctx->flags);
32 static inline bool i915_gem_context_no_error_capture(const struct i915_gem_context *ctx)
34 return test_bit(UCONTEXT_NO_ERROR_CAPTURE, &ctx->user_flags);
37 static inline void i915_gem_context_set_no_error_capture(struct i915_gem_context *ctx)
39 set_bit(UCONTEXT_NO_ERROR_CAPTURE, &ctx->user_flags);
42 static inline void i915_gem_context_clear_no_error_capture(struct i915_gem_context *ctx)
44 clear_bit(UCONTEXT_NO_ERROR_CAPTURE, &ctx->user_flags);
47 static inline bool i915_gem_context_is_bannable(const struct i915_gem_context *ctx)
49 return test_bit(UCONTEXT_BANNABLE, &ctx->user_flags);
52 static inline void i915_gem_context_set_bannable(struct i915_gem_context *ctx)
54 set_bit(UCONTEXT_BANNABLE, &ctx->user_flags);
57 static inline void i915_gem_context_clear_bannable(struct i915_gem_context *ctx)
59 clear_bit(UCONTEXT_BANNABLE, &ctx->user_flags);
62 static inline bool i915_gem_context_is_recoverable(const struct i915_gem_context *ctx)
64 return test_bit(UCONTEXT_RECOVERABLE, &ctx->user_flags);
67 static inline void i915_gem_context_set_recoverable(struct i915_gem_context *ctx)
69 set_bit(UCONTEXT_RECOVERABLE, &ctx->user_flags);
72 static inline void i915_gem_context_clear_recoverable(struct i915_gem_context *ctx)
74 clear_bit(UCONTEXT_RECOVERABLE, &ctx->user_flags);
77 static inline bool i915_gem_context_is_banned(const struct i915_gem_context *ctx)
79 return test_bit(CONTEXT_BANNED, &ctx->flags);
82 static inline void i915_gem_context_set_banned(struct i915_gem_context *ctx)
84 set_bit(CONTEXT_BANNED, &ctx->flags);
87 static inline bool i915_gem_context_force_single_submission(const struct i915_gem_context *ctx)
89 return test_bit(CONTEXT_FORCE_SINGLE_SUBMISSION, &ctx->flags);
92 static inline void i915_gem_context_set_force_single_submission(struct i915_gem_context *ctx)
94 __set_bit(CONTEXT_FORCE_SINGLE_SUBMISSION, &ctx->flags);
98 i915_gem_context_user_engines(const struct i915_gem_context *ctx)
100 return test_bit(CONTEXT_USER_ENGINES, &ctx->flags);
104 i915_gem_context_set_user_engines(struct i915_gem_context *ctx)
106 set_bit(CONTEXT_USER_ENGINES, &ctx->flags);
110 i915_gem_context_clear_user_engines(struct i915_gem_context *ctx)
112 clear_bit(CONTEXT_USER_ENGINES, &ctx->flags);
115 int __i915_gem_context_pin_hw_id(struct i915_gem_context *ctx);
116 static inline int i915_gem_context_pin_hw_id(struct i915_gem_context *ctx)
118 if (atomic_inc_not_zero(&ctx->hw_id_pin_count))
121 return __i915_gem_context_pin_hw_id(ctx);
124 static inline void i915_gem_context_unpin_hw_id(struct i915_gem_context *ctx)
126 GEM_BUG_ON(atomic_read(&ctx->hw_id_pin_count) == 0u);
127 atomic_dec(&ctx->hw_id_pin_count);
130 static inline bool i915_gem_context_is_kernel(struct i915_gem_context *ctx)
132 return !ctx->file_priv;
135 /* i915_gem_context.c */
136 int __must_check i915_gem_contexts_init(struct drm_i915_private *dev_priv);
137 void i915_gem_contexts_fini(struct drm_i915_private *dev_priv);
139 int i915_gem_context_open(struct drm_i915_private *i915,
140 struct drm_file *file);
141 void i915_gem_context_close(struct drm_file *file);
143 void i915_gem_context_release(struct kref *ctx_ref);
144 struct i915_gem_context *
145 i915_gem_context_create_gvt(struct drm_device *dev);
147 int i915_gem_vm_create_ioctl(struct drm_device *dev, void *data,
148 struct drm_file *file);
149 int i915_gem_vm_destroy_ioctl(struct drm_device *dev, void *data,
150 struct drm_file *file);
152 int i915_gem_context_create_ioctl(struct drm_device *dev, void *data,
153 struct drm_file *file);
154 int i915_gem_context_destroy_ioctl(struct drm_device *dev, void *data,
155 struct drm_file *file);
156 int i915_gem_context_getparam_ioctl(struct drm_device *dev, void *data,
157 struct drm_file *file_priv);
158 int i915_gem_context_setparam_ioctl(struct drm_device *dev, void *data,
159 struct drm_file *file_priv);
160 int i915_gem_context_reset_stats_ioctl(struct drm_device *dev, void *data,
161 struct drm_file *file);
163 struct i915_gem_context *
164 i915_gem_context_create_kernel(struct drm_i915_private *i915, int prio);
166 static inline struct i915_gem_context *
167 i915_gem_context_get(struct i915_gem_context *ctx)
173 static inline void i915_gem_context_put(struct i915_gem_context *ctx)
175 kref_put(&ctx->ref, i915_gem_context_release);
178 static inline struct i915_gem_engines *
179 i915_gem_context_engines(struct i915_gem_context *ctx)
181 return rcu_dereference_protected(ctx->engines,
182 lockdep_is_held(&ctx->engines_mutex));
185 static inline struct i915_gem_engines *
186 i915_gem_context_lock_engines(struct i915_gem_context *ctx)
187 __acquires(&ctx->engines_mutex)
189 mutex_lock(&ctx->engines_mutex);
190 return i915_gem_context_engines(ctx);
194 i915_gem_context_unlock_engines(struct i915_gem_context *ctx)
195 __releases(&ctx->engines_mutex)
197 mutex_unlock(&ctx->engines_mutex);
200 static inline struct intel_context *
201 i915_gem_context_get_engine(struct i915_gem_context *ctx, unsigned int idx)
203 struct intel_context *ce = ERR_PTR(-EINVAL);
206 struct i915_gem_engines *e = rcu_dereference(ctx->engines);
207 if (likely(idx < e->num_engines && e->engines[idx]))
208 ce = intel_context_get(e->engines[idx]);
215 i915_gem_engines_iter_init(struct i915_gem_engines_iter *it,
216 struct i915_gem_engines *engines)
218 GEM_BUG_ON(!engines);
219 it->engines = engines;
223 struct intel_context *
224 i915_gem_engines_iter_next(struct i915_gem_engines_iter *it);
226 #define for_each_gem_engine(ce, engines, it) \
227 for (i915_gem_engines_iter_init(&(it), (engines)); \
228 ((ce) = i915_gem_engines_iter_next(&(it)));)
230 struct i915_lut_handle *i915_lut_handle_alloc(void);
231 void i915_lut_handle_free(struct i915_lut_handle *lut);
233 #endif /* !__I915_GEM_CONTEXT_H__ */