2 * SPDX-License-Identifier: MIT
4 * Copyright © 2011-2012 Intel Corporation
8 * This file implements HW context support. On gen5+ a HW context consists of an
9 * opaque GPU object which is referenced at times of context saves and restores.
10 * With RC6 enabled, the context is also referenced as the GPU enters and exists
11 * from RC6 (GPU has it's own internal power context, except on gen5). Though
12 * something like a context does exist for the media ring, the code only
13 * supports contexts for the render ring.
15 * In software, there is a distinction between contexts created by the user,
16 * and the default HW context. The default HW context is used by GPU clients
17 * that do not request setup of their own hardware context. The default
18 * context's state is never restored to help prevent programming errors. This
19 * would happen if a client ran and piggy-backed off another clients GPU state.
20 * The default context only exists to give the GPU some offset to load as the
21 * current to invoke a save of the context we actually care about. In fact, the
22 * code could likely be constructed, albeit in a more complicated fashion, to
23 * never use the default context, though that limits the driver's ability to
24 * swap out, and/or destroy other contexts.
26 * All other contexts are created as a request by the GPU client. These contexts
27 * store GPU state, and thus allow GPU clients to not re-emit state (and
28 * potentially query certain state) at any time. The kernel driver makes
29 * certain that the appropriate commands are inserted.
31 * The context life cycle is semi-complicated in that context BOs may live
32 * longer than the context itself because of the way the hardware, and object
33 * tracking works. Below is a very crude representation of the state machine
34 * describing the context life.
35 * refcount pincount active
36 * S0: initial state 0 0 0
37 * S1: context created 1 0 0
38 * S2: context is currently running 2 1 X
39 * S3: GPU referenced, but not current 2 0 1
40 * S4: context is current, but destroyed 1 1 0
41 * S5: like S3, but destroyed 1 0 1
43 * The most common (but not all) transitions:
44 * S0->S1: client creates a context
45 * S1->S2: client submits execbuf with context
46 * S2->S3: other clients submits execbuf with context
47 * S3->S1: context object was retired
48 * S3->S2: clients submits another execbuf
49 * S2->S4: context destroy called with current context
50 * S3->S5->S0: destroy path
51 * S4->S5->S0: destroy path on current context
53 * There are two confusing terms used above:
54 * The "current context" means the context which is currently running on the
55 * GPU. The GPU has loaded its state already and has stored away the gtt
56 * offset of the BO. The GPU is not actively referencing the data at this
57 * offset, but it will on the next context switch. The only way to avoid this
58 * is to do a GPU reset.
60 * An "active context' is one which was previously the "current context" and is
61 * on the active list waiting for the next context switch to occur. Until this
62 * happens, the object must remain at the same gtt offset. It is therefore
63 * possible to destroy a context, but it is still active.
67 #include <linux/highmem.h>
68 #include <linux/log2.h>
69 #include <linux/nospec.h>
71 #include <drm/drm_cache.h>
72 #include <drm/drm_syncobj.h>
74 #include "gt/gen6_ppgtt.h"
75 #include "gt/intel_context.h"
76 #include "gt/intel_context_param.h"
77 #include "gt/intel_engine_heartbeat.h"
78 #include "gt/intel_engine_user.h"
79 #include "gt/intel_gpu_commands.h"
80 #include "gt/intel_ring.h"
82 #include "pxp/intel_pxp.h"
84 #include "i915_file_private.h"
85 #include "i915_gem_context.h"
86 #include "i915_trace.h"
87 #include "i915_user_extensions.h"
89 #define ALL_L3_SLICES(dev) (1 << NUM_L3_SLICES(dev)) - 1
91 static struct kmem_cache *slab_luts;
93 struct i915_lut_handle *i915_lut_handle_alloc(void)
95 return kmem_cache_alloc(slab_luts, GFP_KERNEL);
98 void i915_lut_handle_free(struct i915_lut_handle *lut)
100 return kmem_cache_free(slab_luts, lut);
103 static void lut_close(struct i915_gem_context *ctx)
105 struct radix_tree_iter iter;
108 mutex_lock(&ctx->lut_mutex);
110 radix_tree_for_each_slot(slot, &ctx->handles_vma, &iter, 0) {
111 struct i915_vma *vma = rcu_dereference_raw(*slot);
112 struct drm_i915_gem_object *obj = vma->obj;
113 struct i915_lut_handle *lut;
115 if (!kref_get_unless_zero(&obj->base.refcount))
118 spin_lock(&obj->lut_lock);
119 list_for_each_entry(lut, &obj->lut_list, obj_link) {
123 if (lut->handle != iter.index)
126 list_del(&lut->obj_link);
129 spin_unlock(&obj->lut_lock);
131 if (&lut->obj_link != &obj->lut_list) {
132 i915_lut_handle_free(lut);
133 radix_tree_iter_delete(&ctx->handles_vma, &iter, slot);
135 i915_gem_object_put(obj);
138 i915_gem_object_put(obj);
141 mutex_unlock(&ctx->lut_mutex);
144 static struct intel_context *
145 lookup_user_engine(struct i915_gem_context *ctx,
147 const struct i915_engine_class_instance *ci)
148 #define LOOKUP_USER_INDEX BIT(0)
152 if (!!(flags & LOOKUP_USER_INDEX) != i915_gem_context_user_engines(ctx))
153 return ERR_PTR(-EINVAL);
155 if (!i915_gem_context_user_engines(ctx)) {
156 struct intel_engine_cs *engine;
158 engine = intel_engine_lookup_user(ctx->i915,
160 ci->engine_instance);
162 return ERR_PTR(-EINVAL);
164 idx = engine->legacy_idx;
166 idx = ci->engine_instance;
169 return i915_gem_context_get_engine(ctx, idx);
172 static int validate_priority(struct drm_i915_private *i915,
173 const struct drm_i915_gem_context_param *args)
175 s64 priority = args->value;
180 if (!(i915->caps.scheduler & I915_SCHEDULER_CAP_PRIORITY))
183 if (priority > I915_CONTEXT_MAX_USER_PRIORITY ||
184 priority < I915_CONTEXT_MIN_USER_PRIORITY)
187 if (priority > I915_CONTEXT_DEFAULT_PRIORITY &&
188 !capable(CAP_SYS_NICE))
194 static void proto_context_close(struct drm_i915_private *i915,
195 struct i915_gem_proto_context *pc)
200 intel_runtime_pm_put(&i915->runtime_pm, pc->pxp_wakeref);
203 if (pc->user_engines) {
204 for (i = 0; i < pc->num_user_engines; i++)
205 kfree(pc->user_engines[i].siblings);
206 kfree(pc->user_engines);
211 static int proto_context_set_persistence(struct drm_i915_private *i915,
212 struct i915_gem_proto_context *pc,
217 * Only contexts that are short-lived [that will expire or be
218 * reset] are allowed to survive past termination. We require
219 * hangcheck to ensure that the persistent requests are healthy.
221 if (!i915->params.enable_hangcheck)
224 pc->user_flags |= BIT(UCONTEXT_PERSISTENCE);
226 /* To cancel a context we use "preempt-to-idle" */
227 if (!(i915->caps.scheduler & I915_SCHEDULER_CAP_PREEMPTION))
231 * If the cancel fails, we then need to reset, cleanly!
233 * If the per-engine reset fails, all hope is lost! We resort
234 * to a full GPU reset in that unlikely case, but realistically
235 * if the engine could not reset, the full reset does not fare
236 * much better. The damage has been done.
238 * However, if we cannot reset an engine by itself, we cannot
239 * cleanup a hanging persistent context without causing
240 * colateral damage, and we should not pretend we can by
241 * exposing the interface.
243 if (!intel_has_reset_engine(to_gt(i915)))
246 pc->user_flags &= ~BIT(UCONTEXT_PERSISTENCE);
252 static int proto_context_set_protected(struct drm_i915_private *i915,
253 struct i915_gem_proto_context *pc,
259 pc->uses_protected_content = false;
260 } else if (!intel_pxp_is_enabled(i915->pxp)) {
262 } else if ((pc->user_flags & BIT(UCONTEXT_RECOVERABLE)) ||
263 !(pc->user_flags & BIT(UCONTEXT_BANNABLE))) {
266 pc->uses_protected_content = true;
269 * protected context usage requires the PXP session to be up,
270 * which in turn requires the device to be active.
272 pc->pxp_wakeref = intel_runtime_pm_get(&i915->runtime_pm);
274 if (!intel_pxp_is_active(i915->pxp))
275 ret = intel_pxp_start(i915->pxp);
281 static struct i915_gem_proto_context *
282 proto_context_create(struct drm_i915_file_private *fpriv,
283 struct drm_i915_private *i915, unsigned int flags)
285 struct i915_gem_proto_context *pc, *err;
287 pc = kzalloc(sizeof(*pc), GFP_KERNEL);
289 return ERR_PTR(-ENOMEM);
292 pc->num_user_engines = -1;
293 pc->user_engines = NULL;
294 pc->user_flags = BIT(UCONTEXT_BANNABLE) |
295 BIT(UCONTEXT_RECOVERABLE);
296 if (i915->params.enable_hangcheck)
297 pc->user_flags |= BIT(UCONTEXT_PERSISTENCE);
298 pc->sched.priority = I915_PRIORITY_NORMAL;
300 if (flags & I915_CONTEXT_CREATE_FLAGS_SINGLE_TIMELINE) {
301 if (!HAS_EXECLISTS(i915)) {
302 err = ERR_PTR(-EINVAL);
305 pc->single_timeline = true;
311 proto_context_close(i915, pc);
315 static int proto_context_register_locked(struct drm_i915_file_private *fpriv,
316 struct i915_gem_proto_context *pc,
322 lockdep_assert_held(&fpriv->proto_context_lock);
324 ret = xa_alloc(&fpriv->context_xa, id, NULL, xa_limit_32b, GFP_KERNEL);
328 old = xa_store(&fpriv->proto_context_xa, *id, pc, GFP_KERNEL);
329 if (xa_is_err(old)) {
330 xa_erase(&fpriv->context_xa, *id);
338 static int proto_context_register(struct drm_i915_file_private *fpriv,
339 struct i915_gem_proto_context *pc,
344 mutex_lock(&fpriv->proto_context_lock);
345 ret = proto_context_register_locked(fpriv, pc, id);
346 mutex_unlock(&fpriv->proto_context_lock);
351 static struct i915_address_space *
352 i915_gem_vm_lookup(struct drm_i915_file_private *file_priv, u32 id)
354 struct i915_address_space *vm;
356 xa_lock(&file_priv->vm_xa);
357 vm = xa_load(&file_priv->vm_xa, id);
360 xa_unlock(&file_priv->vm_xa);
365 static int set_proto_ctx_vm(struct drm_i915_file_private *fpriv,
366 struct i915_gem_proto_context *pc,
367 const struct drm_i915_gem_context_param *args)
369 struct drm_i915_private *i915 = fpriv->i915;
370 struct i915_address_space *vm;
375 if (!HAS_FULL_PPGTT(i915))
378 if (upper_32_bits(args->value))
381 vm = i915_gem_vm_lookup(fpriv, args->value);
392 struct set_proto_ctx_engines {
393 struct drm_i915_private *i915;
394 unsigned num_engines;
395 struct i915_gem_proto_engine *engines;
399 set_proto_ctx_engines_balance(struct i915_user_extension __user *base,
402 struct i915_context_engines_load_balance __user *ext =
403 container_of_user(base, typeof(*ext), base);
404 const struct set_proto_ctx_engines *set = data;
405 struct drm_i915_private *i915 = set->i915;
406 struct intel_engine_cs **siblings;
407 u16 num_siblings, idx;
411 if (!HAS_EXECLISTS(i915))
414 if (get_user(idx, &ext->engine_index))
417 if (idx >= set->num_engines) {
418 drm_dbg(&i915->drm, "Invalid placement value, %d >= %d\n",
419 idx, set->num_engines);
423 idx = array_index_nospec(idx, set->num_engines);
424 if (set->engines[idx].type != I915_GEM_ENGINE_TYPE_INVALID) {
426 "Invalid placement[%d], already occupied\n", idx);
430 if (get_user(num_siblings, &ext->num_siblings))
433 err = check_user_mbz(&ext->flags);
437 err = check_user_mbz(&ext->mbz64);
441 if (num_siblings == 0)
444 siblings = kmalloc_array(num_siblings, sizeof(*siblings), GFP_KERNEL);
448 for (n = 0; n < num_siblings; n++) {
449 struct i915_engine_class_instance ci;
451 if (copy_from_user(&ci, &ext->engines[n], sizeof(ci))) {
456 siblings[n] = intel_engine_lookup_user(i915,
461 "Invalid sibling[%d]: { class:%d, inst:%d }\n",
462 n, ci.engine_class, ci.engine_instance);
468 if (num_siblings == 1) {
469 set->engines[idx].type = I915_GEM_ENGINE_TYPE_PHYSICAL;
470 set->engines[idx].engine = siblings[0];
473 set->engines[idx].type = I915_GEM_ENGINE_TYPE_BALANCED;
474 set->engines[idx].num_siblings = num_siblings;
475 set->engines[idx].siblings = siblings;
487 set_proto_ctx_engines_bond(struct i915_user_extension __user *base, void *data)
489 struct i915_context_engines_bond __user *ext =
490 container_of_user(base, typeof(*ext), base);
491 const struct set_proto_ctx_engines *set = data;
492 struct drm_i915_private *i915 = set->i915;
493 struct i915_engine_class_instance ci;
494 struct intel_engine_cs *master;
498 if (GRAPHICS_VER(i915) >= 12 && !IS_TIGERLAKE(i915) &&
499 !IS_ROCKETLAKE(i915) && !IS_ALDERLAKE_S(i915)) {
501 "Bonding not supported on this platform\n");
505 if (get_user(idx, &ext->virtual_index))
508 if (idx >= set->num_engines) {
510 "Invalid index for virtual engine: %d >= %d\n",
511 idx, set->num_engines);
515 idx = array_index_nospec(idx, set->num_engines);
516 if (set->engines[idx].type == I915_GEM_ENGINE_TYPE_INVALID) {
517 drm_dbg(&i915->drm, "Invalid engine at %d\n", idx);
521 if (set->engines[idx].type != I915_GEM_ENGINE_TYPE_PHYSICAL) {
523 "Bonding with virtual engines not allowed\n");
527 err = check_user_mbz(&ext->flags);
531 for (n = 0; n < ARRAY_SIZE(ext->mbz64); n++) {
532 err = check_user_mbz(&ext->mbz64[n]);
537 if (copy_from_user(&ci, &ext->master, sizeof(ci)))
540 master = intel_engine_lookup_user(i915,
545 "Unrecognised master engine: { class:%u, instance:%u }\n",
546 ci.engine_class, ci.engine_instance);
550 if (intel_engine_uses_guc(master)) {
551 drm_dbg(&i915->drm, "bonding extension not supported with GuC submission");
555 if (get_user(num_bonds, &ext->num_bonds))
558 for (n = 0; n < num_bonds; n++) {
559 struct intel_engine_cs *bond;
561 if (copy_from_user(&ci, &ext->engines[n], sizeof(ci)))
564 bond = intel_engine_lookup_user(i915,
569 "Unrecognised engine[%d] for bonding: { class:%d, instance: %d }\n",
570 n, ci.engine_class, ci.engine_instance);
579 set_proto_ctx_engines_parallel_submit(struct i915_user_extension __user *base,
582 struct i915_context_engines_parallel_submit __user *ext =
583 container_of_user(base, typeof(*ext), base);
584 const struct set_proto_ctx_engines *set = data;
585 struct drm_i915_private *i915 = set->i915;
586 struct i915_engine_class_instance prev_engine;
588 int err = 0, n, i, j;
589 u16 slot, width, num_siblings;
590 struct intel_engine_cs **siblings = NULL;
591 intel_engine_mask_t prev_mask;
593 if (get_user(slot, &ext->engine_index))
596 if (get_user(width, &ext->width))
599 if (get_user(num_siblings, &ext->num_siblings))
602 if (!intel_uc_uses_guc_submission(&to_gt(i915)->uc) &&
604 drm_dbg(&i915->drm, "Only 1 sibling (%d) supported in non-GuC mode\n",
609 if (slot >= set->num_engines) {
610 drm_dbg(&i915->drm, "Invalid placement value, %d >= %d\n",
611 slot, set->num_engines);
615 if (set->engines[slot].type != I915_GEM_ENGINE_TYPE_INVALID) {
617 "Invalid placement[%d], already occupied\n", slot);
621 if (get_user(flags, &ext->flags))
625 drm_dbg(&i915->drm, "Unknown flags 0x%02llx", flags);
629 for (n = 0; n < ARRAY_SIZE(ext->mbz64); n++) {
630 err = check_user_mbz(&ext->mbz64[n]);
636 drm_dbg(&i915->drm, "Width (%d) < 2\n", width);
640 if (num_siblings < 1) {
641 drm_dbg(&i915->drm, "Number siblings (%d) < 1\n",
646 siblings = kmalloc_array(num_siblings * width,
652 /* Create contexts / engines */
653 for (i = 0; i < width; ++i) {
654 intel_engine_mask_t current_mask = 0;
656 for (j = 0; j < num_siblings; ++j) {
657 struct i915_engine_class_instance ci;
659 n = i * num_siblings + j;
660 if (copy_from_user(&ci, &ext->engines[n], sizeof(ci))) {
666 intel_engine_lookup_user(i915, ci.engine_class,
670 "Invalid sibling[%d]: { class:%d, inst:%d }\n",
671 n, ci.engine_class, ci.engine_instance);
677 * We don't support breadcrumb handshake on these
680 if (siblings[n]->class == RENDER_CLASS ||
681 siblings[n]->class == COMPUTE_CLASS) {
687 if (prev_engine.engine_class !=
690 "Mismatched class %d, %d\n",
691 prev_engine.engine_class,
699 current_mask |= siblings[n]->logical_mask;
703 if (current_mask != prev_mask << 1) {
705 "Non contiguous logical mask 0x%x, 0x%x\n",
706 prev_mask, current_mask);
711 prev_mask = current_mask;
714 set->engines[slot].type = I915_GEM_ENGINE_TYPE_PARALLEL;
715 set->engines[slot].num_siblings = num_siblings;
716 set->engines[slot].width = width;
717 set->engines[slot].siblings = siblings;
727 static const i915_user_extension_fn set_proto_ctx_engines_extensions[] = {
728 [I915_CONTEXT_ENGINES_EXT_LOAD_BALANCE] = set_proto_ctx_engines_balance,
729 [I915_CONTEXT_ENGINES_EXT_BOND] = set_proto_ctx_engines_bond,
730 [I915_CONTEXT_ENGINES_EXT_PARALLEL_SUBMIT] =
731 set_proto_ctx_engines_parallel_submit,
734 static int set_proto_ctx_engines(struct drm_i915_file_private *fpriv,
735 struct i915_gem_proto_context *pc,
736 const struct drm_i915_gem_context_param *args)
738 struct drm_i915_private *i915 = fpriv->i915;
739 struct set_proto_ctx_engines set = { .i915 = i915 };
740 struct i915_context_param_engines __user *user =
741 u64_to_user_ptr(args->value);
746 if (pc->num_user_engines >= 0) {
747 drm_dbg(&i915->drm, "Cannot set engines twice");
751 if (args->size < sizeof(*user) ||
752 !IS_ALIGNED(args->size - sizeof(*user), sizeof(*user->engines))) {
753 drm_dbg(&i915->drm, "Invalid size for engine array: %d\n",
758 set.num_engines = (args->size - sizeof(*user)) / sizeof(*user->engines);
759 /* RING_MASK has no shift so we can use it directly here */
760 if (set.num_engines > I915_EXEC_RING_MASK + 1)
763 set.engines = kmalloc_array(set.num_engines, sizeof(*set.engines), GFP_KERNEL);
767 for (n = 0; n < set.num_engines; n++) {
768 struct i915_engine_class_instance ci;
769 struct intel_engine_cs *engine;
771 if (copy_from_user(&ci, &user->engines[n], sizeof(ci))) {
776 memset(&set.engines[n], 0, sizeof(set.engines[n]));
778 if (ci.engine_class == (u16)I915_ENGINE_CLASS_INVALID &&
779 ci.engine_instance == (u16)I915_ENGINE_CLASS_INVALID_NONE)
782 engine = intel_engine_lookup_user(i915,
787 "Invalid engine[%d]: { class:%d, instance:%d }\n",
788 n, ci.engine_class, ci.engine_instance);
793 set.engines[n].type = I915_GEM_ENGINE_TYPE_PHYSICAL;
794 set.engines[n].engine = engine;
798 if (!get_user(extensions, &user->extensions))
799 err = i915_user_extensions(u64_to_user_ptr(extensions),
800 set_proto_ctx_engines_extensions,
801 ARRAY_SIZE(set_proto_ctx_engines_extensions),
808 pc->num_user_engines = set.num_engines;
809 pc->user_engines = set.engines;
814 static int set_proto_ctx_sseu(struct drm_i915_file_private *fpriv,
815 struct i915_gem_proto_context *pc,
816 struct drm_i915_gem_context_param *args)
818 struct drm_i915_private *i915 = fpriv->i915;
819 struct drm_i915_gem_context_param_sseu user_sseu;
820 struct intel_sseu *sseu;
823 if (args->size < sizeof(user_sseu))
826 if (GRAPHICS_VER(i915) != 11)
829 if (copy_from_user(&user_sseu, u64_to_user_ptr(args->value),
836 if (user_sseu.flags & ~(I915_CONTEXT_SSEU_FLAG_ENGINE_INDEX))
839 if (!!(user_sseu.flags & I915_CONTEXT_SSEU_FLAG_ENGINE_INDEX) != (pc->num_user_engines >= 0))
842 if (pc->num_user_engines >= 0) {
843 int idx = user_sseu.engine.engine_instance;
844 struct i915_gem_proto_engine *pe;
846 if (idx >= pc->num_user_engines)
849 idx = array_index_nospec(idx, pc->num_user_engines);
850 pe = &pc->user_engines[idx];
852 /* Only render engine supports RPCS configuration. */
853 if (pe->engine->class != RENDER_CLASS)
858 /* Only render engine supports RPCS configuration. */
859 if (user_sseu.engine.engine_class != I915_ENGINE_CLASS_RENDER)
862 /* There is only one render engine */
863 if (user_sseu.engine.engine_instance != 0)
866 sseu = &pc->legacy_rcs_sseu;
869 ret = i915_gem_user_to_context_sseu(to_gt(i915), &user_sseu, sseu);
873 args->size = sizeof(user_sseu);
878 static int set_proto_ctx_param(struct drm_i915_file_private *fpriv,
879 struct i915_gem_proto_context *pc,
880 struct drm_i915_gem_context_param *args)
884 switch (args->param) {
885 case I915_CONTEXT_PARAM_NO_ERROR_CAPTURE:
888 else if (args->value)
889 pc->user_flags |= BIT(UCONTEXT_NO_ERROR_CAPTURE);
891 pc->user_flags &= ~BIT(UCONTEXT_NO_ERROR_CAPTURE);
894 case I915_CONTEXT_PARAM_BANNABLE:
897 else if (!capable(CAP_SYS_ADMIN) && !args->value)
899 else if (args->value)
900 pc->user_flags |= BIT(UCONTEXT_BANNABLE);
901 else if (pc->uses_protected_content)
904 pc->user_flags &= ~BIT(UCONTEXT_BANNABLE);
907 case I915_CONTEXT_PARAM_RECOVERABLE:
910 else if (!args->value)
911 pc->user_flags &= ~BIT(UCONTEXT_RECOVERABLE);
912 else if (pc->uses_protected_content)
915 pc->user_flags |= BIT(UCONTEXT_RECOVERABLE);
918 case I915_CONTEXT_PARAM_PRIORITY:
919 ret = validate_priority(fpriv->i915, args);
921 pc->sched.priority = args->value;
924 case I915_CONTEXT_PARAM_SSEU:
925 ret = set_proto_ctx_sseu(fpriv, pc, args);
928 case I915_CONTEXT_PARAM_VM:
929 ret = set_proto_ctx_vm(fpriv, pc, args);
932 case I915_CONTEXT_PARAM_ENGINES:
933 ret = set_proto_ctx_engines(fpriv, pc, args);
936 case I915_CONTEXT_PARAM_PERSISTENCE:
940 ret = proto_context_set_persistence(fpriv->i915, pc,
944 case I915_CONTEXT_PARAM_PROTECTED_CONTENT:
945 ret = proto_context_set_protected(fpriv->i915, pc,
949 case I915_CONTEXT_PARAM_NO_ZEROMAP:
950 case I915_CONTEXT_PARAM_BAN_PERIOD:
951 case I915_CONTEXT_PARAM_RINGSIZE:
960 static int intel_context_set_gem(struct intel_context *ce,
961 struct i915_gem_context *ctx,
962 struct intel_sseu sseu)
966 GEM_BUG_ON(rcu_access_pointer(ce->gem_context));
967 RCU_INIT_POINTER(ce->gem_context, ctx);
969 GEM_BUG_ON(intel_context_is_pinned(ce));
971 if (ce->engine->class == COMPUTE_CLASS)
972 ce->ring_size = SZ_512K;
974 ce->ring_size = SZ_16K;
977 ce->vm = i915_gem_context_get_eb_vm(ctx);
979 if (ctx->sched.priority >= I915_PRIORITY_NORMAL &&
980 intel_engine_has_timeslices(ce->engine) &&
981 intel_engine_has_semaphores(ce->engine))
982 __set_bit(CONTEXT_USE_SEMAPHORES, &ce->flags);
984 if (CONFIG_DRM_I915_REQUEST_TIMEOUT &&
985 ctx->i915->params.request_timeout_ms) {
986 unsigned int timeout_ms = ctx->i915->params.request_timeout_ms;
988 intel_context_set_watchdog_us(ce, (u64)timeout_ms * 1000);
991 /* A valid SSEU has no zero fields */
992 if (sseu.slice_mask && !WARN_ON(ce->engine->class != RENDER_CLASS))
993 ret = intel_context_reconfigure_sseu(ce, sseu);
998 static void __unpin_engines(struct i915_gem_engines *e, unsigned int count)
1001 struct intel_context *ce = e->engines[count], *child;
1003 if (!ce || !test_bit(CONTEXT_PERMA_PIN, &ce->flags))
1006 for_each_child(ce, child)
1007 intel_context_unpin(child);
1008 intel_context_unpin(ce);
1012 static void unpin_engines(struct i915_gem_engines *e)
1014 __unpin_engines(e, e->num_engines);
1017 static void __free_engines(struct i915_gem_engines *e, unsigned int count)
1020 if (!e->engines[count])
1023 intel_context_put(e->engines[count]);
1028 static void free_engines(struct i915_gem_engines *e)
1030 __free_engines(e, e->num_engines);
1033 static void free_engines_rcu(struct rcu_head *rcu)
1035 struct i915_gem_engines *engines =
1036 container_of(rcu, struct i915_gem_engines, rcu);
1038 i915_sw_fence_fini(&engines->fence);
1039 free_engines(engines);
1042 static void accumulate_runtime(struct i915_drm_client *client,
1043 struct i915_gem_engines *engines)
1045 struct i915_gem_engines_iter it;
1046 struct intel_context *ce;
1051 /* Transfer accumulated runtime to the parent GEM context. */
1052 for_each_gem_engine(ce, engines, it) {
1053 unsigned int class = ce->engine->uabi_class;
1055 GEM_BUG_ON(class >= ARRAY_SIZE(client->past_runtime));
1056 atomic64_add(intel_context_get_total_runtime_ns(ce),
1057 &client->past_runtime[class]);
1062 engines_notify(struct i915_sw_fence *fence, enum i915_sw_fence_notify state)
1064 struct i915_gem_engines *engines =
1065 container_of(fence, typeof(*engines), fence);
1066 struct i915_gem_context *ctx = engines->ctx;
1069 case FENCE_COMPLETE:
1070 if (!list_empty(&engines->link)) {
1071 unsigned long flags;
1073 spin_lock_irqsave(&ctx->stale.lock, flags);
1074 list_del(&engines->link);
1075 spin_unlock_irqrestore(&ctx->stale.lock, flags);
1077 accumulate_runtime(ctx->client, engines);
1078 i915_gem_context_put(ctx);
1083 init_rcu_head(&engines->rcu);
1084 call_rcu(&engines->rcu, free_engines_rcu);
1091 static struct i915_gem_engines *alloc_engines(unsigned int count)
1093 struct i915_gem_engines *e;
1095 e = kzalloc(struct_size(e, engines, count), GFP_KERNEL);
1099 i915_sw_fence_init(&e->fence, engines_notify);
1103 static struct i915_gem_engines *default_engines(struct i915_gem_context *ctx,
1104 struct intel_sseu rcs_sseu)
1106 const unsigned int max = I915_NUM_ENGINES;
1107 struct intel_engine_cs *engine;
1108 struct i915_gem_engines *e, *err;
1110 e = alloc_engines(max);
1112 return ERR_PTR(-ENOMEM);
1114 for_each_uabi_engine(engine, ctx->i915) {
1115 struct intel_context *ce;
1116 struct intel_sseu sseu = {};
1119 if (engine->legacy_idx == INVALID_ENGINE)
1122 GEM_BUG_ON(engine->legacy_idx >= max);
1123 GEM_BUG_ON(e->engines[engine->legacy_idx]);
1125 ce = intel_context_create(engine);
1131 e->engines[engine->legacy_idx] = ce;
1132 e->num_engines = max(e->num_engines, engine->legacy_idx + 1);
1134 if (engine->class == RENDER_CLASS)
1137 ret = intel_context_set_gem(ce, ctx, sseu);
1152 static int perma_pin_contexts(struct intel_context *ce)
1154 struct intel_context *child;
1155 int i = 0, j = 0, ret;
1157 GEM_BUG_ON(!intel_context_is_parent(ce));
1159 ret = intel_context_pin(ce);
1163 for_each_child(ce, child) {
1164 ret = intel_context_pin(child);
1170 set_bit(CONTEXT_PERMA_PIN, &ce->flags);
1175 intel_context_unpin(ce);
1176 for_each_child(ce, child) {
1178 intel_context_unpin(child);
1186 static struct i915_gem_engines *user_engines(struct i915_gem_context *ctx,
1187 unsigned int num_engines,
1188 struct i915_gem_proto_engine *pe)
1190 struct i915_gem_engines *e, *err;
1193 e = alloc_engines(num_engines);
1195 return ERR_PTR(-ENOMEM);
1196 e->num_engines = num_engines;
1198 for (n = 0; n < num_engines; n++) {
1199 struct intel_context *ce, *child;
1202 switch (pe[n].type) {
1203 case I915_GEM_ENGINE_TYPE_PHYSICAL:
1204 ce = intel_context_create(pe[n].engine);
1207 case I915_GEM_ENGINE_TYPE_BALANCED:
1208 ce = intel_engine_create_virtual(pe[n].siblings,
1209 pe[n].num_siblings, 0);
1212 case I915_GEM_ENGINE_TYPE_PARALLEL:
1213 ce = intel_engine_create_parallel(pe[n].siblings,
1218 case I915_GEM_ENGINE_TYPE_INVALID:
1220 GEM_WARN_ON(pe[n].type != I915_GEM_ENGINE_TYPE_INVALID);
1231 ret = intel_context_set_gem(ce, ctx, pe->sseu);
1236 for_each_child(ce, child) {
1237 ret = intel_context_set_gem(child, ctx, pe->sseu);
1245 * XXX: Must be done after calling intel_context_set_gem as that
1246 * function changes the ring size. The ring is allocated when
1247 * the context is pinned. If the ring size is changed after
1248 * allocation we have a mismatch of the ring size and will cause
1249 * the context to hang. Presumably with a bit of reordering we
1250 * could move the perma-pin step to the backend function
1251 * intel_engine_create_parallel.
1253 if (pe[n].type == I915_GEM_ENGINE_TYPE_PARALLEL) {
1254 ret = perma_pin_contexts(ce);
1269 static void i915_gem_context_release_work(struct work_struct *work)
1271 struct i915_gem_context *ctx = container_of(work, typeof(*ctx),
1273 struct i915_address_space *vm;
1275 trace_i915_context_free(ctx);
1276 GEM_BUG_ON(!i915_gem_context_is_closed(ctx));
1278 spin_lock(&ctx->i915->gem.contexts.lock);
1279 list_del(&ctx->link);
1280 spin_unlock(&ctx->i915->gem.contexts.lock);
1283 drm_syncobj_put(ctx->syncobj);
1289 if (ctx->pxp_wakeref)
1290 intel_runtime_pm_put(&ctx->i915->runtime_pm, ctx->pxp_wakeref);
1293 i915_drm_client_put(ctx->client);
1295 mutex_destroy(&ctx->engines_mutex);
1296 mutex_destroy(&ctx->lut_mutex);
1299 mutex_destroy(&ctx->mutex);
1301 kfree_rcu(ctx, rcu);
1304 void i915_gem_context_release(struct kref *ref)
1306 struct i915_gem_context *ctx = container_of(ref, typeof(*ctx), ref);
1308 queue_work(ctx->i915->wq, &ctx->release_work);
1311 static inline struct i915_gem_engines *
1312 __context_engines_static(const struct i915_gem_context *ctx)
1314 return rcu_dereference_protected(ctx->engines, true);
1317 static void __reset_context(struct i915_gem_context *ctx,
1318 struct intel_engine_cs *engine)
1320 intel_gt_handle_error(engine->gt, engine->mask, 0,
1321 "context closure in %s", ctx->name);
1324 static bool __cancel_engine(struct intel_engine_cs *engine)
1327 * Send a "high priority pulse" down the engine to cause the
1328 * current request to be momentarily preempted. (If it fails to
1329 * be preempted, it will be reset). As we have marked our context
1330 * as banned, any incomplete request, including any running, will
1331 * be skipped following the preemption.
1333 * If there is no hangchecking (one of the reasons why we try to
1334 * cancel the context) and no forced preemption, there may be no
1335 * means by which we reset the GPU and evict the persistent hog.
1336 * Ergo if we are unable to inject a preemptive pulse that can
1337 * kill the banned context, we fallback to doing a local reset
1340 return intel_engine_pulse(engine) == 0;
1343 static struct intel_engine_cs *active_engine(struct intel_context *ce)
1345 struct intel_engine_cs *engine = NULL;
1346 struct i915_request *rq;
1348 if (intel_context_has_inflight(ce))
1349 return intel_context_inflight(ce);
1355 * rq->link is only SLAB_TYPESAFE_BY_RCU, we need to hold a reference
1356 * to the request to prevent it being transferred to a new timeline
1357 * (and onto a new timeline->requests list).
1360 list_for_each_entry_reverse(rq, &ce->timeline->requests, link) {
1363 /* timeline is already completed upto this point? */
1364 if (!i915_request_get_rcu(rq))
1367 /* Check with the backend if the request is inflight */
1369 if (likely(rcu_access_pointer(rq->timeline) == ce->timeline))
1370 found = i915_request_active_engine(rq, &engine);
1372 i915_request_put(rq);
1382 kill_engines(struct i915_gem_engines *engines, bool exit, bool persistent)
1384 struct i915_gem_engines_iter it;
1385 struct intel_context *ce;
1388 * Map the user's engine back to the actual engines; one virtual
1389 * engine will be mapped to multiple engines, and using ctx->engine[]
1390 * the same engine may be have multiple instances in the user's map.
1391 * However, we only care about pending requests, so only include
1392 * engines on which there are incomplete requests.
1394 for_each_gem_engine(ce, engines, it) {
1395 struct intel_engine_cs *engine;
1397 if ((exit || !persistent) && intel_context_revoke(ce))
1398 continue; /* Already marked. */
1401 * Check the current active state of this context; if we
1402 * are currently executing on the GPU we need to evict
1403 * ourselves. On the other hand, if we haven't yet been
1404 * submitted to the GPU or if everything is complete,
1405 * we have nothing to do.
1407 engine = active_engine(ce);
1409 /* First attempt to gracefully cancel the context */
1410 if (engine && !__cancel_engine(engine) && (exit || !persistent))
1412 * If we are unable to send a preemptive pulse to bump
1413 * the context from the GPU, we have to resort to a full
1414 * reset. We hope the collateral damage is worth it.
1416 __reset_context(engines->ctx, engine);
1420 static void kill_context(struct i915_gem_context *ctx)
1422 struct i915_gem_engines *pos, *next;
1424 spin_lock_irq(&ctx->stale.lock);
1425 GEM_BUG_ON(!i915_gem_context_is_closed(ctx));
1426 list_for_each_entry_safe(pos, next, &ctx->stale.engines, link) {
1427 if (!i915_sw_fence_await(&pos->fence)) {
1428 list_del_init(&pos->link);
1432 spin_unlock_irq(&ctx->stale.lock);
1434 kill_engines(pos, !ctx->i915->params.enable_hangcheck,
1435 i915_gem_context_is_persistent(ctx));
1437 spin_lock_irq(&ctx->stale.lock);
1438 GEM_BUG_ON(i915_sw_fence_signaled(&pos->fence));
1439 list_safe_reset_next(pos, next, link);
1440 list_del_init(&pos->link); /* decouple from FENCE_COMPLETE */
1442 i915_sw_fence_complete(&pos->fence);
1444 spin_unlock_irq(&ctx->stale.lock);
1447 static void engines_idle_release(struct i915_gem_context *ctx,
1448 struct i915_gem_engines *engines)
1450 struct i915_gem_engines_iter it;
1451 struct intel_context *ce;
1453 INIT_LIST_HEAD(&engines->link);
1455 engines->ctx = i915_gem_context_get(ctx);
1457 for_each_gem_engine(ce, engines, it) {
1460 /* serialises with execbuf */
1461 intel_context_close(ce);
1462 if (!intel_context_pin_if_active(ce))
1465 /* Wait until context is finally scheduled out and retired */
1466 err = i915_sw_fence_await_active(&engines->fence,
1468 I915_ACTIVE_AWAIT_BARRIER);
1469 intel_context_unpin(ce);
1474 spin_lock_irq(&ctx->stale.lock);
1475 if (!i915_gem_context_is_closed(ctx))
1476 list_add_tail(&engines->link, &ctx->stale.engines);
1477 spin_unlock_irq(&ctx->stale.lock);
1480 if (list_empty(&engines->link)) /* raced, already closed */
1481 kill_engines(engines, true,
1482 i915_gem_context_is_persistent(ctx));
1484 i915_sw_fence_commit(&engines->fence);
1487 static void set_closed_name(struct i915_gem_context *ctx)
1491 /* Replace '[]' with '<>' to indicate closed in debug prints */
1493 s = strrchr(ctx->name, '[');
1499 s = strchr(s + 1, ']');
1504 static void context_close(struct i915_gem_context *ctx)
1506 struct i915_drm_client *client;
1508 /* Flush any concurrent set_engines() */
1509 mutex_lock(&ctx->engines_mutex);
1510 unpin_engines(__context_engines_static(ctx));
1511 engines_idle_release(ctx, rcu_replace_pointer(ctx->engines, NULL, 1));
1512 i915_gem_context_set_closed(ctx);
1513 mutex_unlock(&ctx->engines_mutex);
1515 mutex_lock(&ctx->mutex);
1517 set_closed_name(ctx);
1520 * The LUT uses the VMA as a backpointer to unref the object,
1521 * so we need to clear the LUT before we close all the VMA (inside
1526 ctx->file_priv = ERR_PTR(-EBADF);
1528 client = ctx->client;
1530 spin_lock(&client->ctx_lock);
1531 list_del_rcu(&ctx->client_link);
1532 spin_unlock(&client->ctx_lock);
1535 mutex_unlock(&ctx->mutex);
1538 * If the user has disabled hangchecking, we can not be sure that
1539 * the batches will ever complete after the context is closed,
1540 * keeping the context and all resources pinned forever. So in this
1541 * case we opt to forcibly kill off all remaining requests on
1546 i915_gem_context_put(ctx);
1549 static int __context_set_persistence(struct i915_gem_context *ctx, bool state)
1551 if (i915_gem_context_is_persistent(ctx) == state)
1556 * Only contexts that are short-lived [that will expire or be
1557 * reset] are allowed to survive past termination. We require
1558 * hangcheck to ensure that the persistent requests are healthy.
1560 if (!ctx->i915->params.enable_hangcheck)
1563 i915_gem_context_set_persistence(ctx);
1565 /* To cancel a context we use "preempt-to-idle" */
1566 if (!(ctx->i915->caps.scheduler & I915_SCHEDULER_CAP_PREEMPTION))
1570 * If the cancel fails, we then need to reset, cleanly!
1572 * If the per-engine reset fails, all hope is lost! We resort
1573 * to a full GPU reset in that unlikely case, but realistically
1574 * if the engine could not reset, the full reset does not fare
1575 * much better. The damage has been done.
1577 * However, if we cannot reset an engine by itself, we cannot
1578 * cleanup a hanging persistent context without causing
1579 * colateral damage, and we should not pretend we can by
1580 * exposing the interface.
1582 if (!intel_has_reset_engine(to_gt(ctx->i915)))
1585 i915_gem_context_clear_persistence(ctx);
1591 static struct i915_gem_context *
1592 i915_gem_create_context(struct drm_i915_private *i915,
1593 const struct i915_gem_proto_context *pc)
1595 struct i915_gem_context *ctx;
1596 struct i915_address_space *vm = NULL;
1597 struct i915_gem_engines *e;
1601 ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
1603 return ERR_PTR(-ENOMEM);
1605 kref_init(&ctx->ref);
1607 ctx->sched = pc->sched;
1608 mutex_init(&ctx->mutex);
1609 INIT_LIST_HEAD(&ctx->link);
1610 INIT_WORK(&ctx->release_work, i915_gem_context_release_work);
1612 spin_lock_init(&ctx->stale.lock);
1613 INIT_LIST_HEAD(&ctx->stale.engines);
1616 vm = i915_vm_get(pc->vm);
1617 } else if (HAS_FULL_PPGTT(i915)) {
1618 struct i915_ppgtt *ppgtt;
1620 ppgtt = i915_ppgtt_create(to_gt(i915), 0);
1621 if (IS_ERR(ppgtt)) {
1622 drm_dbg(&i915->drm, "PPGTT setup failed (%ld)\n",
1624 err = PTR_ERR(ppgtt);
1627 ppgtt->vm.fpriv = pc->fpriv;
1633 mutex_init(&ctx->engines_mutex);
1634 if (pc->num_user_engines >= 0) {
1635 i915_gem_context_set_user_engines(ctx);
1636 e = user_engines(ctx, pc->num_user_engines, pc->user_engines);
1638 i915_gem_context_clear_user_engines(ctx);
1639 e = default_engines(ctx, pc->legacy_rcs_sseu);
1645 RCU_INIT_POINTER(ctx->engines, e);
1647 INIT_RADIX_TREE(&ctx->handles_vma, GFP_KERNEL);
1648 mutex_init(&ctx->lut_mutex);
1650 /* NB: Mark all slices as needing a remap so that when the context first
1651 * loads it will restore whatever remap state already exists. If there
1652 * is no remap info, it will be a NOP. */
1653 ctx->remap_slice = ALL_L3_SLICES(i915);
1655 ctx->user_flags = pc->user_flags;
1657 for (i = 0; i < ARRAY_SIZE(ctx->hang_timestamp); i++)
1658 ctx->hang_timestamp[i] = jiffies - CONTEXT_FAST_HANG_JIFFIES;
1660 if (pc->single_timeline) {
1661 err = drm_syncobj_create(&ctx->syncobj,
1662 DRM_SYNCOBJ_CREATE_SIGNALED,
1668 if (pc->uses_protected_content) {
1669 ctx->pxp_wakeref = intel_runtime_pm_get(&i915->runtime_pm);
1670 ctx->uses_protected_content = true;
1673 trace_i915_context_create(ctx);
1681 i915_vm_put(ctx->vm);
1684 return ERR_PTR(err);
1687 static void init_contexts(struct i915_gem_contexts *gc)
1689 spin_lock_init(&gc->lock);
1690 INIT_LIST_HEAD(&gc->list);
1693 void i915_gem_init__contexts(struct drm_i915_private *i915)
1695 init_contexts(&i915->gem.contexts);
1699 * Note that this implicitly consumes the ctx reference, by placing
1700 * the ctx in the context_xa.
1702 static void gem_context_register(struct i915_gem_context *ctx,
1703 struct drm_i915_file_private *fpriv,
1706 struct drm_i915_private *i915 = ctx->i915;
1709 ctx->file_priv = fpriv;
1711 ctx->pid = get_task_pid(current, PIDTYPE_PID);
1712 ctx->client = i915_drm_client_get(fpriv->client);
1714 snprintf(ctx->name, sizeof(ctx->name), "%s[%d]",
1715 current->comm, pid_nr(ctx->pid));
1717 spin_lock(&ctx->client->ctx_lock);
1718 list_add_tail_rcu(&ctx->client_link, &ctx->client->ctx_list);
1719 spin_unlock(&ctx->client->ctx_lock);
1721 spin_lock(&i915->gem.contexts.lock);
1722 list_add_tail(&ctx->link, &i915->gem.contexts.list);
1723 spin_unlock(&i915->gem.contexts.lock);
1725 /* And finally expose ourselves to userspace via the idr */
1726 old = xa_store(&fpriv->context_xa, id, ctx, GFP_KERNEL);
1730 int i915_gem_context_open(struct drm_i915_private *i915,
1731 struct drm_file *file)
1733 struct drm_i915_file_private *file_priv = file->driver_priv;
1734 struct i915_gem_proto_context *pc;
1735 struct i915_gem_context *ctx;
1738 mutex_init(&file_priv->proto_context_lock);
1739 xa_init_flags(&file_priv->proto_context_xa, XA_FLAGS_ALLOC);
1741 /* 0 reserved for the default context */
1742 xa_init_flags(&file_priv->context_xa, XA_FLAGS_ALLOC1);
1744 /* 0 reserved for invalid/unassigned ppgtt */
1745 xa_init_flags(&file_priv->vm_xa, XA_FLAGS_ALLOC1);
1747 pc = proto_context_create(file_priv, i915, 0);
1753 ctx = i915_gem_create_context(i915, pc);
1754 proto_context_close(i915, pc);
1760 gem_context_register(ctx, file_priv, 0);
1765 xa_destroy(&file_priv->vm_xa);
1766 xa_destroy(&file_priv->context_xa);
1767 xa_destroy(&file_priv->proto_context_xa);
1768 mutex_destroy(&file_priv->proto_context_lock);
1772 void i915_gem_context_close(struct drm_file *file)
1774 struct drm_i915_file_private *file_priv = file->driver_priv;
1775 struct i915_gem_proto_context *pc;
1776 struct i915_address_space *vm;
1777 struct i915_gem_context *ctx;
1780 xa_for_each(&file_priv->proto_context_xa, idx, pc)
1781 proto_context_close(file_priv->i915, pc);
1782 xa_destroy(&file_priv->proto_context_xa);
1783 mutex_destroy(&file_priv->proto_context_lock);
1785 xa_for_each(&file_priv->context_xa, idx, ctx)
1787 xa_destroy(&file_priv->context_xa);
1789 xa_for_each(&file_priv->vm_xa, idx, vm)
1791 xa_destroy(&file_priv->vm_xa);
1794 int i915_gem_vm_create_ioctl(struct drm_device *dev, void *data,
1795 struct drm_file *file)
1797 struct drm_i915_private *i915 = to_i915(dev);
1798 struct drm_i915_gem_vm_control *args = data;
1799 struct drm_i915_file_private *file_priv = file->driver_priv;
1800 struct i915_ppgtt *ppgtt;
1804 if (!HAS_FULL_PPGTT(i915))
1810 ppgtt = i915_ppgtt_create(to_gt(i915), 0);
1812 return PTR_ERR(ppgtt);
1814 if (args->extensions) {
1815 err = i915_user_extensions(u64_to_user_ptr(args->extensions),
1822 err = xa_alloc(&file_priv->vm_xa, &id, &ppgtt->vm,
1823 xa_limit_32b, GFP_KERNEL);
1827 GEM_BUG_ON(id == 0); /* reserved for invalid/unassigned ppgtt */
1829 ppgtt->vm.fpriv = file_priv;
1833 i915_vm_put(&ppgtt->vm);
1837 int i915_gem_vm_destroy_ioctl(struct drm_device *dev, void *data,
1838 struct drm_file *file)
1840 struct drm_i915_file_private *file_priv = file->driver_priv;
1841 struct drm_i915_gem_vm_control *args = data;
1842 struct i915_address_space *vm;
1847 if (args->extensions)
1850 vm = xa_erase(&file_priv->vm_xa, args->vm_id);
1858 static int get_ppgtt(struct drm_i915_file_private *file_priv,
1859 struct i915_gem_context *ctx,
1860 struct drm_i915_gem_context_param *args)
1862 struct i915_address_space *vm;
1866 if (!i915_gem_context_has_full_ppgtt(ctx))
1873 * Get a reference for the allocated handle. Once the handle is
1874 * visible in the vm_xa table, userspace could try to close it
1875 * from under our feet, so we need to hold the extra reference
1880 err = xa_alloc(&file_priv->vm_xa, &id, vm, xa_limit_32b, GFP_KERNEL);
1886 GEM_BUG_ON(id == 0); /* reserved for invalid/unassigned ppgtt */
1894 i915_gem_user_to_context_sseu(struct intel_gt *gt,
1895 const struct drm_i915_gem_context_param_sseu *user,
1896 struct intel_sseu *context)
1898 const struct sseu_dev_info *device = >->info.sseu;
1899 struct drm_i915_private *i915 = gt->i915;
1900 unsigned int dev_subslice_mask = intel_sseu_get_hsw_subslices(device, 0);
1902 /* No zeros in any field. */
1903 if (!user->slice_mask || !user->subslice_mask ||
1904 !user->min_eus_per_subslice || !user->max_eus_per_subslice)
1908 if (user->max_eus_per_subslice < user->min_eus_per_subslice)
1912 * Some future proofing on the types since the uAPI is wider than the
1913 * current internal implementation.
1915 if (overflows_type(user->slice_mask, context->slice_mask) ||
1916 overflows_type(user->subslice_mask, context->subslice_mask) ||
1917 overflows_type(user->min_eus_per_subslice,
1918 context->min_eus_per_subslice) ||
1919 overflows_type(user->max_eus_per_subslice,
1920 context->max_eus_per_subslice))
1923 /* Check validity against hardware. */
1924 if (user->slice_mask & ~device->slice_mask)
1927 if (user->subslice_mask & ~dev_subslice_mask)
1930 if (user->max_eus_per_subslice > device->max_eus_per_subslice)
1933 context->slice_mask = user->slice_mask;
1934 context->subslice_mask = user->subslice_mask;
1935 context->min_eus_per_subslice = user->min_eus_per_subslice;
1936 context->max_eus_per_subslice = user->max_eus_per_subslice;
1938 /* Part specific restrictions. */
1939 if (GRAPHICS_VER(i915) == 11) {
1940 unsigned int hw_s = hweight8(device->slice_mask);
1941 unsigned int hw_ss_per_s = hweight8(dev_subslice_mask);
1942 unsigned int req_s = hweight8(context->slice_mask);
1943 unsigned int req_ss = hweight8(context->subslice_mask);
1946 * Only full subslice enablement is possible if more than one
1947 * slice is turned on.
1949 if (req_s > 1 && req_ss != hw_ss_per_s)
1953 * If more than four (SScount bitfield limit) subslices are
1954 * requested then the number has to be even.
1956 if (req_ss > 4 && (req_ss & 1))
1960 * If only one slice is enabled and subslice count is below the
1961 * device full enablement, it must be at most half of the all
1962 * available subslices.
1964 if (req_s == 1 && req_ss < hw_ss_per_s &&
1965 req_ss > (hw_ss_per_s / 2))
1968 /* ABI restriction - VME use case only. */
1970 /* All slices or one slice only. */
1971 if (req_s != 1 && req_s != hw_s)
1975 * Half subslices or full enablement only when one slice is
1979 (req_ss != hw_ss_per_s && req_ss != (hw_ss_per_s / 2)))
1982 /* No EU configuration changes. */
1983 if ((user->min_eus_per_subslice !=
1984 device->max_eus_per_subslice) ||
1985 (user->max_eus_per_subslice !=
1986 device->max_eus_per_subslice))
1993 static int set_sseu(struct i915_gem_context *ctx,
1994 struct drm_i915_gem_context_param *args)
1996 struct drm_i915_private *i915 = ctx->i915;
1997 struct drm_i915_gem_context_param_sseu user_sseu;
1998 struct intel_context *ce;
1999 struct intel_sseu sseu;
2000 unsigned long lookup;
2003 if (args->size < sizeof(user_sseu))
2006 if (GRAPHICS_VER(i915) != 11)
2009 if (copy_from_user(&user_sseu, u64_to_user_ptr(args->value),
2016 if (user_sseu.flags & ~(I915_CONTEXT_SSEU_FLAG_ENGINE_INDEX))
2020 if (user_sseu.flags & I915_CONTEXT_SSEU_FLAG_ENGINE_INDEX)
2021 lookup |= LOOKUP_USER_INDEX;
2023 ce = lookup_user_engine(ctx, lookup, &user_sseu.engine);
2027 /* Only render engine supports RPCS configuration. */
2028 if (ce->engine->class != RENDER_CLASS) {
2033 ret = i915_gem_user_to_context_sseu(ce->engine->gt, &user_sseu, &sseu);
2037 ret = intel_context_reconfigure_sseu(ce, sseu);
2041 args->size = sizeof(user_sseu);
2044 intel_context_put(ce);
2049 set_persistence(struct i915_gem_context *ctx,
2050 const struct drm_i915_gem_context_param *args)
2055 return __context_set_persistence(ctx, args->value);
2058 static int set_priority(struct i915_gem_context *ctx,
2059 const struct drm_i915_gem_context_param *args)
2061 struct i915_gem_engines_iter it;
2062 struct intel_context *ce;
2065 err = validate_priority(ctx->i915, args);
2069 ctx->sched.priority = args->value;
2071 for_each_gem_engine(ce, i915_gem_context_lock_engines(ctx), it) {
2072 if (!intel_engine_has_timeslices(ce->engine))
2075 if (ctx->sched.priority >= I915_PRIORITY_NORMAL &&
2076 intel_engine_has_semaphores(ce->engine))
2077 intel_context_set_use_semaphores(ce);
2079 intel_context_clear_use_semaphores(ce);
2081 i915_gem_context_unlock_engines(ctx);
2086 static int get_protected(struct i915_gem_context *ctx,
2087 struct drm_i915_gem_context_param *args)
2090 args->value = i915_gem_context_uses_protected_content(ctx);
2095 static int ctx_setparam(struct drm_i915_file_private *fpriv,
2096 struct i915_gem_context *ctx,
2097 struct drm_i915_gem_context_param *args)
2101 switch (args->param) {
2102 case I915_CONTEXT_PARAM_NO_ERROR_CAPTURE:
2105 else if (args->value)
2106 i915_gem_context_set_no_error_capture(ctx);
2108 i915_gem_context_clear_no_error_capture(ctx);
2111 case I915_CONTEXT_PARAM_BANNABLE:
2114 else if (!capable(CAP_SYS_ADMIN) && !args->value)
2116 else if (args->value)
2117 i915_gem_context_set_bannable(ctx);
2118 else if (i915_gem_context_uses_protected_content(ctx))
2119 ret = -EPERM; /* can't clear this for protected contexts */
2121 i915_gem_context_clear_bannable(ctx);
2124 case I915_CONTEXT_PARAM_RECOVERABLE:
2127 else if (!args->value)
2128 i915_gem_context_clear_recoverable(ctx);
2129 else if (i915_gem_context_uses_protected_content(ctx))
2130 ret = -EPERM; /* can't set this for protected contexts */
2132 i915_gem_context_set_recoverable(ctx);
2135 case I915_CONTEXT_PARAM_PRIORITY:
2136 ret = set_priority(ctx, args);
2139 case I915_CONTEXT_PARAM_SSEU:
2140 ret = set_sseu(ctx, args);
2143 case I915_CONTEXT_PARAM_PERSISTENCE:
2144 ret = set_persistence(ctx, args);
2147 case I915_CONTEXT_PARAM_PROTECTED_CONTENT:
2148 case I915_CONTEXT_PARAM_NO_ZEROMAP:
2149 case I915_CONTEXT_PARAM_BAN_PERIOD:
2150 case I915_CONTEXT_PARAM_RINGSIZE:
2151 case I915_CONTEXT_PARAM_VM:
2152 case I915_CONTEXT_PARAM_ENGINES:
2162 struct i915_gem_proto_context *pc;
2163 struct drm_i915_file_private *fpriv;
2166 static int create_setparam(struct i915_user_extension __user *ext, void *data)
2168 struct drm_i915_gem_context_create_ext_setparam local;
2169 const struct create_ext *arg = data;
2171 if (copy_from_user(&local, ext, sizeof(local)))
2174 if (local.param.ctx_id)
2177 return set_proto_ctx_param(arg->fpriv, arg->pc, &local.param);
2180 static int invalid_ext(struct i915_user_extension __user *ext, void *data)
2185 static const i915_user_extension_fn create_extensions[] = {
2186 [I915_CONTEXT_CREATE_EXT_SETPARAM] = create_setparam,
2187 [I915_CONTEXT_CREATE_EXT_CLONE] = invalid_ext,
2190 static bool client_is_banned(struct drm_i915_file_private *file_priv)
2192 return atomic_read(&file_priv->ban_score) >= I915_CLIENT_SCORE_BANNED;
2195 static inline struct i915_gem_context *
2196 __context_lookup(struct drm_i915_file_private *file_priv, u32 id)
2198 struct i915_gem_context *ctx;
2201 ctx = xa_load(&file_priv->context_xa, id);
2202 if (ctx && !kref_get_unless_zero(&ctx->ref))
2209 static struct i915_gem_context *
2210 finalize_create_context_locked(struct drm_i915_file_private *file_priv,
2211 struct i915_gem_proto_context *pc, u32 id)
2213 struct i915_gem_context *ctx;
2216 lockdep_assert_held(&file_priv->proto_context_lock);
2218 ctx = i915_gem_create_context(file_priv->i915, pc);
2223 * One for the xarray and one for the caller. We need to grab
2224 * the reference *prior* to making the ctx visble to userspace
2225 * in gem_context_register(), as at any point after that
2226 * userspace can try to race us with another thread destroying
2227 * the context under our feet.
2229 i915_gem_context_get(ctx);
2231 gem_context_register(ctx, file_priv, id);
2233 old = xa_erase(&file_priv->proto_context_xa, id);
2234 GEM_BUG_ON(old != pc);
2235 proto_context_close(file_priv->i915, pc);
2240 struct i915_gem_context *
2241 i915_gem_context_lookup(struct drm_i915_file_private *file_priv, u32 id)
2243 struct i915_gem_proto_context *pc;
2244 struct i915_gem_context *ctx;
2246 ctx = __context_lookup(file_priv, id);
2250 mutex_lock(&file_priv->proto_context_lock);
2251 /* Try one more time under the lock */
2252 ctx = __context_lookup(file_priv, id);
2254 pc = xa_load(&file_priv->proto_context_xa, id);
2256 ctx = ERR_PTR(-ENOENT);
2258 ctx = finalize_create_context_locked(file_priv, pc, id);
2260 mutex_unlock(&file_priv->proto_context_lock);
2265 int i915_gem_context_create_ioctl(struct drm_device *dev, void *data,
2266 struct drm_file *file)
2268 struct drm_i915_private *i915 = to_i915(dev);
2269 struct drm_i915_gem_context_create_ext *args = data;
2270 struct create_ext ext_data;
2274 if (!DRIVER_CAPS(i915)->has_logical_contexts)
2277 if (args->flags & I915_CONTEXT_CREATE_FLAGS_UNKNOWN)
2280 ret = intel_gt_terminally_wedged(to_gt(i915));
2284 ext_data.fpriv = file->driver_priv;
2285 if (client_is_banned(ext_data.fpriv)) {
2287 "client %s[%d] banned from creating ctx\n",
2288 current->comm, task_pid_nr(current));
2292 ext_data.pc = proto_context_create(file->driver_priv, i915,
2294 if (IS_ERR(ext_data.pc))
2295 return PTR_ERR(ext_data.pc);
2297 if (args->flags & I915_CONTEXT_CREATE_FLAGS_USE_EXTENSIONS) {
2298 ret = i915_user_extensions(u64_to_user_ptr(args->extensions),
2300 ARRAY_SIZE(create_extensions),
2306 if (GRAPHICS_VER(i915) > 12) {
2307 struct i915_gem_context *ctx;
2309 /* Get ourselves a context ID */
2310 ret = xa_alloc(&ext_data.fpriv->context_xa, &id, NULL,
2311 xa_limit_32b, GFP_KERNEL);
2315 ctx = i915_gem_create_context(i915, ext_data.pc);
2321 proto_context_close(i915, ext_data.pc);
2322 gem_context_register(ctx, ext_data.fpriv, id);
2324 ret = proto_context_register(ext_data.fpriv, ext_data.pc, &id);
2334 proto_context_close(i915, ext_data.pc);
2338 int i915_gem_context_destroy_ioctl(struct drm_device *dev, void *data,
2339 struct drm_file *file)
2341 struct drm_i915_gem_context_destroy *args = data;
2342 struct drm_i915_file_private *file_priv = file->driver_priv;
2343 struct i915_gem_proto_context *pc;
2344 struct i915_gem_context *ctx;
2352 /* We need to hold the proto-context lock here to prevent races
2353 * with finalize_create_context_locked().
2355 mutex_lock(&file_priv->proto_context_lock);
2356 ctx = xa_erase(&file_priv->context_xa, args->ctx_id);
2357 pc = xa_erase(&file_priv->proto_context_xa, args->ctx_id);
2358 mutex_unlock(&file_priv->proto_context_lock);
2362 GEM_WARN_ON(ctx && pc);
2365 proto_context_close(file_priv->i915, pc);
2373 static int get_sseu(struct i915_gem_context *ctx,
2374 struct drm_i915_gem_context_param *args)
2376 struct drm_i915_gem_context_param_sseu user_sseu;
2377 struct intel_context *ce;
2378 unsigned long lookup;
2381 if (args->size == 0)
2383 else if (args->size < sizeof(user_sseu))
2386 if (copy_from_user(&user_sseu, u64_to_user_ptr(args->value),
2393 if (user_sseu.flags & ~(I915_CONTEXT_SSEU_FLAG_ENGINE_INDEX))
2397 if (user_sseu.flags & I915_CONTEXT_SSEU_FLAG_ENGINE_INDEX)
2398 lookup |= LOOKUP_USER_INDEX;
2400 ce = lookup_user_engine(ctx, lookup, &user_sseu.engine);
2404 err = intel_context_lock_pinned(ce); /* serialises with set_sseu */
2406 intel_context_put(ce);
2410 user_sseu.slice_mask = ce->sseu.slice_mask;
2411 user_sseu.subslice_mask = ce->sseu.subslice_mask;
2412 user_sseu.min_eus_per_subslice = ce->sseu.min_eus_per_subslice;
2413 user_sseu.max_eus_per_subslice = ce->sseu.max_eus_per_subslice;
2415 intel_context_unlock_pinned(ce);
2416 intel_context_put(ce);
2418 if (copy_to_user(u64_to_user_ptr(args->value), &user_sseu,
2423 args->size = sizeof(user_sseu);
2428 int i915_gem_context_getparam_ioctl(struct drm_device *dev, void *data,
2429 struct drm_file *file)
2431 struct drm_i915_file_private *file_priv = file->driver_priv;
2432 struct drm_i915_gem_context_param *args = data;
2433 struct i915_gem_context *ctx;
2434 struct i915_address_space *vm;
2437 ctx = i915_gem_context_lookup(file_priv, args->ctx_id);
2439 return PTR_ERR(ctx);
2441 switch (args->param) {
2442 case I915_CONTEXT_PARAM_GTT_SIZE:
2444 vm = i915_gem_context_get_eb_vm(ctx);
2445 args->value = vm->total;
2450 case I915_CONTEXT_PARAM_NO_ERROR_CAPTURE:
2452 args->value = i915_gem_context_no_error_capture(ctx);
2455 case I915_CONTEXT_PARAM_BANNABLE:
2457 args->value = i915_gem_context_is_bannable(ctx);
2460 case I915_CONTEXT_PARAM_RECOVERABLE:
2462 args->value = i915_gem_context_is_recoverable(ctx);
2465 case I915_CONTEXT_PARAM_PRIORITY:
2467 args->value = ctx->sched.priority;
2470 case I915_CONTEXT_PARAM_SSEU:
2471 ret = get_sseu(ctx, args);
2474 case I915_CONTEXT_PARAM_VM:
2475 ret = get_ppgtt(file_priv, ctx, args);
2478 case I915_CONTEXT_PARAM_PERSISTENCE:
2480 args->value = i915_gem_context_is_persistent(ctx);
2483 case I915_CONTEXT_PARAM_PROTECTED_CONTENT:
2484 ret = get_protected(ctx, args);
2487 case I915_CONTEXT_PARAM_NO_ZEROMAP:
2488 case I915_CONTEXT_PARAM_BAN_PERIOD:
2489 case I915_CONTEXT_PARAM_ENGINES:
2490 case I915_CONTEXT_PARAM_RINGSIZE:
2496 i915_gem_context_put(ctx);
2500 int i915_gem_context_setparam_ioctl(struct drm_device *dev, void *data,
2501 struct drm_file *file)
2503 struct drm_i915_file_private *file_priv = file->driver_priv;
2504 struct drm_i915_gem_context_param *args = data;
2505 struct i915_gem_proto_context *pc;
2506 struct i915_gem_context *ctx;
2509 mutex_lock(&file_priv->proto_context_lock);
2510 ctx = __context_lookup(file_priv, args->ctx_id);
2512 pc = xa_load(&file_priv->proto_context_xa, args->ctx_id);
2514 /* Contexts should be finalized inside
2515 * GEM_CONTEXT_CREATE starting with graphics
2518 WARN_ON(GRAPHICS_VER(file_priv->i915) > 12);
2519 ret = set_proto_ctx_param(file_priv, pc, args);
2524 mutex_unlock(&file_priv->proto_context_lock);
2527 ret = ctx_setparam(file_priv, ctx, args);
2528 i915_gem_context_put(ctx);
2534 int i915_gem_context_reset_stats_ioctl(struct drm_device *dev,
2535 void *data, struct drm_file *file)
2537 struct drm_i915_private *i915 = to_i915(dev);
2538 struct drm_i915_reset_stats *args = data;
2539 struct i915_gem_context *ctx;
2541 if (args->flags || args->pad)
2544 ctx = i915_gem_context_lookup(file->driver_priv, args->ctx_id);
2546 return PTR_ERR(ctx);
2549 * We opt for unserialised reads here. This may result in tearing
2550 * in the extremely unlikely event of a GPU hang on this context
2551 * as we are querying them. If we need that extra layer of protection,
2552 * we should wrap the hangstats with a seqlock.
2555 if (capable(CAP_SYS_ADMIN))
2556 args->reset_count = i915_reset_count(&i915->gpu_error);
2558 args->reset_count = 0;
2560 args->batch_active = atomic_read(&ctx->guilty_count);
2561 args->batch_pending = atomic_read(&ctx->active_count);
2563 i915_gem_context_put(ctx);
2567 /* GEM context-engines iterator: for_each_gem_engine() */
2568 struct intel_context *
2569 i915_gem_engines_iter_next(struct i915_gem_engines_iter *it)
2571 const struct i915_gem_engines *e = it->engines;
2572 struct intel_context *ctx;
2578 if (it->idx >= e->num_engines)
2581 ctx = e->engines[it->idx++];
2587 #if IS_ENABLED(CONFIG_DRM_I915_SELFTEST)
2588 #include "selftests/mock_context.c"
2589 #include "selftests/i915_gem_context.c"
2592 void i915_gem_context_module_exit(void)
2594 kmem_cache_destroy(slab_luts);
2597 int __init i915_gem_context_module_init(void)
2599 slab_luts = KMEM_CACHE(i915_lut_handle, 0);