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"
16 #include "i915_scheduler.h"
17 #include "intel_device_info.h"
22 static inline bool i915_gem_context_is_closed(const struct i915_gem_context *ctx)
24 return test_bit(CONTEXT_CLOSED, &ctx->flags);
27 static inline void i915_gem_context_set_closed(struct i915_gem_context *ctx)
29 GEM_BUG_ON(i915_gem_context_is_closed(ctx));
30 set_bit(CONTEXT_CLOSED, &ctx->flags);
33 static inline bool i915_gem_context_no_error_capture(const struct i915_gem_context *ctx)
35 return test_bit(UCONTEXT_NO_ERROR_CAPTURE, &ctx->user_flags);
38 static inline void i915_gem_context_set_no_error_capture(struct i915_gem_context *ctx)
40 set_bit(UCONTEXT_NO_ERROR_CAPTURE, &ctx->user_flags);
43 static inline void i915_gem_context_clear_no_error_capture(struct i915_gem_context *ctx)
45 clear_bit(UCONTEXT_NO_ERROR_CAPTURE, &ctx->user_flags);
48 static inline bool i915_gem_context_is_bannable(const struct i915_gem_context *ctx)
50 return test_bit(UCONTEXT_BANNABLE, &ctx->user_flags);
53 static inline void i915_gem_context_set_bannable(struct i915_gem_context *ctx)
55 set_bit(UCONTEXT_BANNABLE, &ctx->user_flags);
58 static inline void i915_gem_context_clear_bannable(struct i915_gem_context *ctx)
60 clear_bit(UCONTEXT_BANNABLE, &ctx->user_flags);
63 static inline bool i915_gem_context_is_recoverable(const struct i915_gem_context *ctx)
65 return test_bit(UCONTEXT_RECOVERABLE, &ctx->user_flags);
68 static inline void i915_gem_context_set_recoverable(struct i915_gem_context *ctx)
70 set_bit(UCONTEXT_RECOVERABLE, &ctx->user_flags);
73 static inline void i915_gem_context_clear_recoverable(struct i915_gem_context *ctx)
75 clear_bit(UCONTEXT_RECOVERABLE, &ctx->user_flags);
78 static inline bool i915_gem_context_is_persistent(const struct i915_gem_context *ctx)
80 return test_bit(UCONTEXT_PERSISTENCE, &ctx->user_flags);
83 static inline void i915_gem_context_set_persistence(struct i915_gem_context *ctx)
85 set_bit(UCONTEXT_PERSISTENCE, &ctx->user_flags);
88 static inline void i915_gem_context_clear_persistence(struct i915_gem_context *ctx)
90 clear_bit(UCONTEXT_PERSISTENCE, &ctx->user_flags);
94 i915_gem_context_user_engines(const struct i915_gem_context *ctx)
96 return test_bit(CONTEXT_USER_ENGINES, &ctx->flags);
100 i915_gem_context_set_user_engines(struct i915_gem_context *ctx)
102 set_bit(CONTEXT_USER_ENGINES, &ctx->flags);
106 i915_gem_context_clear_user_engines(struct i915_gem_context *ctx)
108 clear_bit(CONTEXT_USER_ENGINES, &ctx->flags);
112 i915_gem_context_uses_protected_content(const struct i915_gem_context *ctx)
114 return ctx->uses_protected_content;
117 /* i915_gem_context.c */
118 void i915_gem_init__contexts(struct drm_i915_private *i915);
120 int i915_gem_context_open(struct drm_i915_private *i915,
121 struct drm_file *file);
122 void i915_gem_context_close(struct drm_file *file);
124 void i915_gem_context_release(struct kref *ctx_ref);
126 int i915_gem_vm_create_ioctl(struct drm_device *dev, void *data,
127 struct drm_file *file);
128 int i915_gem_vm_destroy_ioctl(struct drm_device *dev, void *data,
129 struct drm_file *file);
131 int i915_gem_context_create_ioctl(struct drm_device *dev, void *data,
132 struct drm_file *file);
133 int i915_gem_context_destroy_ioctl(struct drm_device *dev, void *data,
134 struct drm_file *file);
135 int i915_gem_context_getparam_ioctl(struct drm_device *dev, void *data,
136 struct drm_file *file_priv);
137 int i915_gem_context_setparam_ioctl(struct drm_device *dev, void *data,
138 struct drm_file *file_priv);
139 int i915_gem_context_reset_stats_ioctl(struct drm_device *dev, void *data,
140 struct drm_file *file);
142 struct i915_gem_context *
143 i915_gem_context_lookup(struct drm_i915_file_private *file_priv, u32 id);
145 static inline struct i915_gem_context *
146 i915_gem_context_get(struct i915_gem_context *ctx)
152 static inline void i915_gem_context_put(struct i915_gem_context *ctx)
154 kref_put(&ctx->ref, i915_gem_context_release);
157 static inline struct i915_address_space *
158 i915_gem_context_vm(struct i915_gem_context *ctx)
160 return rcu_dereference_protected(ctx->vm, lockdep_is_held(&ctx->mutex));
163 static inline bool i915_gem_context_has_full_ppgtt(struct i915_gem_context *ctx)
165 GEM_BUG_ON(!!ctx->vm != HAS_FULL_PPGTT(ctx->i915));
170 static inline struct i915_address_space *
171 i915_gem_context_get_eb_vm(struct i915_gem_context *ctx)
173 struct i915_address_space *vm;
177 vm = &to_gt(ctx->i915)->ggtt->vm;
178 vm = i915_vm_get(vm);
183 static inline struct i915_gem_engines *
184 i915_gem_context_engines(struct i915_gem_context *ctx)
186 return rcu_dereference_protected(ctx->engines,
187 lockdep_is_held(&ctx->engines_mutex));
190 static inline struct i915_gem_engines *
191 i915_gem_context_lock_engines(struct i915_gem_context *ctx)
192 __acquires(&ctx->engines_mutex)
194 mutex_lock(&ctx->engines_mutex);
195 return i915_gem_context_engines(ctx);
199 i915_gem_context_unlock_engines(struct i915_gem_context *ctx)
200 __releases(&ctx->engines_mutex)
202 mutex_unlock(&ctx->engines_mutex);
205 static inline struct intel_context *
206 i915_gem_context_get_engine(struct i915_gem_context *ctx, unsigned int idx)
208 struct intel_context *ce;
211 struct i915_gem_engines *e = rcu_dereference(ctx->engines);
212 if (unlikely(!e)) /* context was closed! */
213 ce = ERR_PTR(-ENOENT);
214 else if (likely(idx < e->num_engines && e->engines[idx]))
215 ce = intel_context_get(e->engines[idx]);
217 ce = ERR_PTR(-EINVAL);
224 i915_gem_engines_iter_init(struct i915_gem_engines_iter *it,
225 struct i915_gem_engines *engines)
227 it->engines = engines;
231 struct intel_context *
232 i915_gem_engines_iter_next(struct i915_gem_engines_iter *it);
234 #define for_each_gem_engine(ce, engines, it) \
235 for (i915_gem_engines_iter_init(&(it), (engines)); \
236 ((ce) = i915_gem_engines_iter_next(&(it)));)
238 void i915_gem_context_module_exit(void);
239 int i915_gem_context_module_init(void);
241 struct i915_lut_handle *i915_lut_handle_alloc(void);
242 void i915_lut_handle_free(struct i915_lut_handle *lut);
244 int i915_gem_user_to_context_sseu(struct intel_gt *gt,
245 const struct drm_i915_gem_context_param_sseu *user,
246 struct intel_sseu *context);
248 #endif /* !__I915_GEM_CONTEXT_H__ */