blob: 9683e62ec61aa041e661daba39b167bb09e48d82 [file] [log] [blame]
Ben Widawsky254f9652012-06-04 14:42:42 -07001/*
2 * Copyright © 2011-2012 Intel Corporation
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 (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21 * IN THE SOFTWARE.
22 *
23 * Authors:
24 * Ben Widawsky <ben@bwidawsk.net>
25 *
26 */
27
28/*
29 * This file implements HW context support. On gen5+ a HW context consists of an
30 * opaque GPU object which is referenced at times of context saves and restores.
31 * With RC6 enabled, the context is also referenced as the GPU enters and exists
32 * from RC6 (GPU has it's own internal power context, except on gen5). Though
33 * something like a context does exist for the media ring, the code only
34 * supports contexts for the render ring.
35 *
36 * In software, there is a distinction between contexts created by the user,
37 * and the default HW context. The default HW context is used by GPU clients
38 * that do not request setup of their own hardware context. The default
39 * context's state is never restored to help prevent programming errors. This
40 * would happen if a client ran and piggy-backed off another clients GPU state.
41 * The default context only exists to give the GPU some offset to load as the
42 * current to invoke a save of the context we actually care about. In fact, the
43 * code could likely be constructed, albeit in a more complicated fashion, to
44 * never use the default context, though that limits the driver's ability to
45 * swap out, and/or destroy other contexts.
46 *
47 * All other contexts are created as a request by the GPU client. These contexts
48 * store GPU state, and thus allow GPU clients to not re-emit state (and
49 * potentially query certain state) at any time. The kernel driver makes
50 * certain that the appropriate commands are inserted.
51 *
52 * The context life cycle is semi-complicated in that context BOs may live
53 * longer than the context itself because of the way the hardware, and object
54 * tracking works. Below is a very crude representation of the state machine
55 * describing the context life.
56 * refcount pincount active
57 * S0: initial state 0 0 0
58 * S1: context created 1 0 0
59 * S2: context is currently running 2 1 X
60 * S3: GPU referenced, but not current 2 0 1
61 * S4: context is current, but destroyed 1 1 0
62 * S5: like S3, but destroyed 1 0 1
63 *
64 * The most common (but not all) transitions:
65 * S0->S1: client creates a context
66 * S1->S2: client submits execbuf with context
67 * S2->S3: other clients submits execbuf with context
68 * S3->S1: context object was retired
69 * S3->S2: clients submits another execbuf
70 * S2->S4: context destroy called with current context
71 * S3->S5->S0: destroy path
72 * S4->S5->S0: destroy path on current context
73 *
74 * There are two confusing terms used above:
75 * The "current context" means the context which is currently running on the
Damien Lespiau508842a2013-08-30 14:40:26 +010076 * GPU. The GPU has loaded its state already and has stored away the gtt
Ben Widawsky254f9652012-06-04 14:42:42 -070077 * offset of the BO. The GPU is not actively referencing the data at this
78 * offset, but it will on the next context switch. The only way to avoid this
79 * is to do a GPU reset.
80 *
81 * An "active context' is one which was previously the "current context" and is
82 * on the active list waiting for the next context switch to occur. Until this
83 * happens, the object must remain at the same gtt offset. It is therefore
84 * possible to destroy a context, but it is still active.
85 *
86 */
87
David Howells760285e2012-10-02 18:01:07 +010088#include <drm/drmP.h>
89#include <drm/i915_drm.h>
Ben Widawsky254f9652012-06-04 14:42:42 -070090#include "i915_drv.h"
91
Ben Widawsky40521052012-06-04 14:42:43 -070092/* This is a HW constraint. The value below is the largest known requirement
93 * I've seen in a spec to date, and that was a workaround for a non-shipping
94 * part. It should be safe to decrease this, but it's more future proof as is.
95 */
Ben Widawskyb731d332013-12-06 14:10:59 -080096#define GEN6_CONTEXT_ALIGN (64<<10)
97#define GEN7_CONTEXT_ALIGN 4096
Ben Widawsky40521052012-06-04 14:42:43 -070098
Ben Widawskyb731d332013-12-06 14:10:59 -080099static size_t get_context_alignment(struct drm_device *dev)
100{
101 if (IS_GEN6(dev))
102 return GEN6_CONTEXT_ALIGN;
103
104 return GEN7_CONTEXT_ALIGN;
105}
106
Ben Widawsky254f9652012-06-04 14:42:42 -0700107static int get_context_size(struct drm_device *dev)
108{
109 struct drm_i915_private *dev_priv = dev->dev_private;
110 int ret;
111 u32 reg;
112
113 switch (INTEL_INFO(dev)->gen) {
114 case 6:
115 reg = I915_READ(CXT_SIZE);
116 ret = GEN6_CXT_TOTAL_SIZE(reg) * 64;
117 break;
118 case 7:
Ben Widawsky4f91dd62012-07-18 10:10:09 -0700119 reg = I915_READ(GEN7_CXT_SIZE);
Ben Widawsky2e4291e2012-07-24 20:47:30 -0700120 if (IS_HASWELL(dev))
Ben Widawskya0de80a2013-06-25 21:53:40 -0700121 ret = HSW_CXT_TOTAL_SIZE;
Ben Widawsky2e4291e2012-07-24 20:47:30 -0700122 else
123 ret = GEN7_CXT_TOTAL_SIZE(reg) * 64;
Ben Widawsky254f9652012-06-04 14:42:42 -0700124 break;
Ben Widawsky88976442013-11-02 21:07:05 -0700125 case 8:
126 ret = GEN8_CXT_TOTAL_SIZE;
127 break;
Ben Widawsky254f9652012-06-04 14:42:42 -0700128 default:
129 BUG();
130 }
131
132 return ret;
133}
134
Mika Kuoppaladce32712013-04-30 13:30:33 +0300135void i915_gem_context_free(struct kref *ctx_ref)
Ben Widawsky40521052012-06-04 14:42:43 -0700136{
Oscar Mateo273497e2014-05-22 14:13:37 +0100137 struct intel_context *ctx = container_of(ctx_ref,
Daniel Vetterae6c4802014-08-06 15:04:53 +0200138 typeof(*ctx), ref);
Ben Widawsky40521052012-06-04 14:42:43 -0700139
Daniel Vetterae6c4802014-08-06 15:04:53 +0200140 if (i915.enable_execlists)
Oscar Mateoede7d422014-07-24 17:04:12 +0100141 intel_lr_context_free(ctx);
Ben Widawskyc7c48df2013-12-06 14:11:15 -0800142
Daniel Vetterae6c4802014-08-06 15:04:53 +0200143 i915_ppgtt_put(ctx->ppgtt);
144
Ben Widawsky2f295792014-07-01 11:17:47 -0700145 if (ctx->legacy_hw_ctx.rcs_state)
146 drm_gem_object_unreference(&ctx->legacy_hw_ctx.rcs_state->base);
Ben Widawskyc7c48df2013-12-06 14:11:15 -0800147 list_del(&ctx->link);
Ben Widawsky40521052012-06-04 14:42:43 -0700148 kfree(ctx);
149}
150
Oscar Mateo8c8579172014-07-24 17:04:14 +0100151struct drm_i915_gem_object *
Oscar Mateoaa0c13d2014-07-03 16:27:58 +0100152i915_gem_alloc_context_obj(struct drm_device *dev, size_t size)
153{
154 struct drm_i915_gem_object *obj;
155 int ret;
156
157 obj = i915_gem_alloc_object(dev, size);
158 if (obj == NULL)
159 return ERR_PTR(-ENOMEM);
160
161 /*
162 * Try to make the context utilize L3 as well as LLC.
163 *
164 * On VLV we don't have L3 controls in the PTEs so we
165 * shouldn't touch the cache level, especially as that
166 * would make the object snooped which might have a
167 * negative performance impact.
168 */
169 if (INTEL_INFO(dev)->gen >= 7 && !IS_VALLEYVIEW(dev)) {
170 ret = i915_gem_object_set_cache_level(obj, I915_CACHE_L3_LLC);
171 /* Failure shouldn't ever happen this early */
172 if (WARN_ON(ret)) {
173 drm_gem_object_unreference(&obj->base);
174 return ERR_PTR(ret);
175 }
176 }
177
178 return obj;
179}
180
Oscar Mateo273497e2014-05-22 14:13:37 +0100181static struct intel_context *
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800182__create_hw_context(struct drm_device *dev,
Daniel Vetteree960be2014-08-06 15:04:45 +0200183 struct drm_i915_file_private *file_priv)
Ben Widawsky40521052012-06-04 14:42:43 -0700184{
185 struct drm_i915_private *dev_priv = dev->dev_private;
Oscar Mateo273497e2014-05-22 14:13:37 +0100186 struct intel_context *ctx;
Tejun Heoc8c470a2013-02-27 17:04:10 -0800187 int ret;
Ben Widawsky40521052012-06-04 14:42:43 -0700188
Ben Widawskyf94982b2012-11-10 10:56:04 -0800189 ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
Ben Widawsky146937e2012-06-29 10:30:39 -0700190 if (ctx == NULL)
191 return ERR_PTR(-ENOMEM);
Ben Widawsky40521052012-06-04 14:42:43 -0700192
Mika Kuoppaladce32712013-04-30 13:30:33 +0300193 kref_init(&ctx->ref);
Ben Widawskya33afea2013-09-17 21:12:45 -0700194 list_add_tail(&ctx->link, &dev_priv->context_list);
Ben Widawsky40521052012-06-04 14:42:43 -0700195
Chris Wilson691e6412014-04-09 09:07:36 +0100196 if (dev_priv->hw_context_size) {
Oscar Mateoaa0c13d2014-07-03 16:27:58 +0100197 struct drm_i915_gem_object *obj =
198 i915_gem_alloc_context_obj(dev, dev_priv->hw_context_size);
199 if (IS_ERR(obj)) {
200 ret = PTR_ERR(obj);
Chris Wilson691e6412014-04-09 09:07:36 +0100201 goto err_out;
202 }
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100203 ctx->legacy_hw_ctx.rcs_state = obj;
Chris Wilson691e6412014-04-09 09:07:36 +0100204 }
205
206 /* Default context will never have a file_priv */
207 if (file_priv != NULL) {
208 ret = idr_alloc(&file_priv->context_idr, ctx,
Oscar Mateo821d66d2014-07-03 16:28:00 +0100209 DEFAULT_CONTEXT_HANDLE, 0, GFP_KERNEL);
Chris Wilson691e6412014-04-09 09:07:36 +0100210 if (ret < 0)
211 goto err_out;
212 } else
Oscar Mateo821d66d2014-07-03 16:28:00 +0100213 ret = DEFAULT_CONTEXT_HANDLE;
Mika Kuoppaladce32712013-04-30 13:30:33 +0300214
215 ctx->file_priv = file_priv;
Oscar Mateo821d66d2014-07-03 16:28:00 +0100216 ctx->user_handle = ret;
Ben Widawsky3ccfd192013-09-18 19:03:18 -0700217 /* NB: Mark all slices as needing a remap so that when the context first
218 * loads it will restore whatever remap state already exists. If there
219 * is no remap info, it will be a NOP. */
220 ctx->remap_slice = (1 << NUM_L3_SLICES(dev)) - 1;
Ben Widawsky40521052012-06-04 14:42:43 -0700221
Ben Widawsky146937e2012-06-29 10:30:39 -0700222 return ctx;
Ben Widawsky40521052012-06-04 14:42:43 -0700223
224err_out:
Mika Kuoppaladce32712013-04-30 13:30:33 +0300225 i915_gem_context_unreference(ctx);
Ben Widawsky146937e2012-06-29 10:30:39 -0700226 return ERR_PTR(ret);
Ben Widawsky40521052012-06-04 14:42:43 -0700227}
228
Ben Widawsky254f9652012-06-04 14:42:42 -0700229/**
230 * The default context needs to exist per ring that uses contexts. It stores the
231 * context state of the GPU for applications that don't utilize HW contexts, as
232 * well as an idle case.
233 */
Oscar Mateo273497e2014-05-22 14:13:37 +0100234static struct intel_context *
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800235i915_gem_create_context(struct drm_device *dev,
Daniel Vetterd624d862014-08-06 15:04:54 +0200236 struct drm_i915_file_private *file_priv)
Ben Widawsky254f9652012-06-04 14:42:42 -0700237{
Chris Wilson42c3b602014-01-23 19:40:02 +0000238 const bool is_global_default_ctx = file_priv == NULL;
Oscar Mateo273497e2014-05-22 14:13:37 +0100239 struct intel_context *ctx;
Ben Widawskybdf4fd72013-12-06 14:11:18 -0800240 int ret = 0;
Ben Widawsky40521052012-06-04 14:42:43 -0700241
Ben Widawskyb731d332013-12-06 14:10:59 -0800242 BUG_ON(!mutex_is_locked(&dev->struct_mutex));
Ben Widawsky40521052012-06-04 14:42:43 -0700243
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800244 ctx = __create_hw_context(dev, file_priv);
Ben Widawsky146937e2012-06-29 10:30:39 -0700245 if (IS_ERR(ctx))
Ben Widawskya45d0f62013-12-06 14:11:05 -0800246 return ctx;
Ben Widawsky40521052012-06-04 14:42:43 -0700247
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100248 if (is_global_default_ctx && ctx->legacy_hw_ctx.rcs_state) {
Chris Wilson42c3b602014-01-23 19:40:02 +0000249 /* We may need to do things with the shrinker which
250 * require us to immediately switch back to the default
251 * context. This can cause a problem as pinning the
252 * default context also requires GTT space which may not
253 * be available. To avoid this we always pin the default
254 * context.
255 */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100256 ret = i915_gem_obj_ggtt_pin(ctx->legacy_hw_ctx.rcs_state,
Daniel Vetter1ec9e262014-02-14 14:01:11 +0100257 get_context_alignment(dev), 0);
Chris Wilson42c3b602014-01-23 19:40:02 +0000258 if (ret) {
259 DRM_DEBUG_DRIVER("Couldn't pin %d\n", ret);
260 goto err_destroy;
261 }
262 }
263
Daniel Vetterd624d862014-08-06 15:04:54 +0200264 if (USES_FULL_PPGTT(dev)) {
Daniel Vetter4d884702014-08-06 15:04:47 +0200265 struct i915_hw_ppgtt *ppgtt = i915_ppgtt_create(dev, file_priv);
Ben Widawskybdf4fd72013-12-06 14:11:18 -0800266
267 if (IS_ERR_OR_NULL(ppgtt)) {
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800268 DRM_DEBUG_DRIVER("PPGTT setup failed (%ld)\n",
269 PTR_ERR(ppgtt));
Ben Widawskybdf4fd72013-12-06 14:11:18 -0800270 ret = PTR_ERR(ppgtt);
Chris Wilson42c3b602014-01-23 19:40:02 +0000271 goto err_unpin;
Daniel Vetterae6c4802014-08-06 15:04:53 +0200272 }
273
274 ctx->ppgtt = ppgtt;
275 }
Ben Widawskybdf4fd72013-12-06 14:11:18 -0800276
Ben Widawskya45d0f62013-12-06 14:11:05 -0800277 return ctx;
Chris Wilson9a3b5302012-07-15 12:34:24 +0100278
Chris Wilson42c3b602014-01-23 19:40:02 +0000279err_unpin:
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100280 if (is_global_default_ctx && ctx->legacy_hw_ctx.rcs_state)
281 i915_gem_object_ggtt_unpin(ctx->legacy_hw_ctx.rcs_state);
Chris Wilson9a3b5302012-07-15 12:34:24 +0100282err_destroy:
Mika Kuoppaladce32712013-04-30 13:30:33 +0300283 i915_gem_context_unreference(ctx);
Ben Widawskya45d0f62013-12-06 14:11:05 -0800284 return ERR_PTR(ret);
Ben Widawsky254f9652012-06-04 14:42:42 -0700285}
286
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800287void i915_gem_context_reset(struct drm_device *dev)
288{
289 struct drm_i915_private *dev_priv = dev->dev_private;
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800290 int i;
291
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800292 /* Prevent the hardware from restoring the last context (which hung) on
293 * the next switch */
294 for (i = 0; i < I915_NUM_RINGS; i++) {
Oscar Mateoa4872ba2014-05-22 14:13:33 +0100295 struct intel_engine_cs *ring = &dev_priv->ring[i];
Oscar Mateo273497e2014-05-22 14:13:37 +0100296 struct intel_context *dctx = ring->default_context;
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100297 struct intel_context *lctx = ring->last_context;
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800298
299 /* Do a fake switch to the default context */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100300 if (lctx == dctx)
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800301 continue;
302
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100303 if (!lctx)
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800304 continue;
305
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100306 if (dctx->legacy_hw_ctx.rcs_state && i == RCS) {
307 WARN_ON(i915_gem_obj_ggtt_pin(dctx->legacy_hw_ctx.rcs_state,
Daniel Vetter1ec9e262014-02-14 14:01:11 +0100308 get_context_alignment(dev), 0));
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800309 /* Fake a finish/inactive */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100310 dctx->legacy_hw_ctx.rcs_state->base.write_domain = 0;
311 dctx->legacy_hw_ctx.rcs_state->active = 0;
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800312 }
313
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100314 if (lctx->legacy_hw_ctx.rcs_state && i == RCS)
315 i915_gem_object_ggtt_unpin(lctx->legacy_hw_ctx.rcs_state);
Ville Syrjälä4bfad3d2014-06-18 22:04:48 +0300316
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100317 i915_gem_context_unreference(lctx);
Ben Widawskyacce9ff2013-12-06 14:11:03 -0800318 i915_gem_context_reference(dctx);
319 ring->last_context = dctx;
320 }
321}
322
Ben Widawsky8245be32013-11-06 13:56:29 -0200323int i915_gem_context_init(struct drm_device *dev)
Ben Widawsky254f9652012-06-04 14:42:42 -0700324{
325 struct drm_i915_private *dev_priv = dev->dev_private;
Oscar Mateo273497e2014-05-22 14:13:37 +0100326 struct intel_context *ctx;
Ben Widawskya45d0f62013-12-06 14:11:05 -0800327 int i;
Ben Widawsky254f9652012-06-04 14:42:42 -0700328
Ben Widawsky2fa48d82013-12-06 14:11:04 -0800329 /* Init should only be called once per module load. Eventually the
330 * restriction on the context_disabled check can be loosened. */
331 if (WARN_ON(dev_priv->ring[RCS].default_context))
Ben Widawsky8245be32013-11-06 13:56:29 -0200332 return 0;
Ben Widawsky254f9652012-06-04 14:42:42 -0700333
Oscar Mateoede7d422014-07-24 17:04:12 +0100334 if (i915.enable_execlists) {
335 /* NB: intentionally left blank. We will allocate our own
336 * backing objects as we need them, thank you very much */
337 dev_priv->hw_context_size = 0;
338 } else if (HAS_HW_CONTEXTS(dev)) {
Chris Wilson691e6412014-04-09 09:07:36 +0100339 dev_priv->hw_context_size = round_up(get_context_size(dev), 4096);
340 if (dev_priv->hw_context_size > (1<<20)) {
341 DRM_DEBUG_DRIVER("Disabling HW Contexts; invalid size %d\n",
342 dev_priv->hw_context_size);
343 dev_priv->hw_context_size = 0;
344 }
Ben Widawsky254f9652012-06-04 14:42:42 -0700345 }
346
Daniel Vetterd624d862014-08-06 15:04:54 +0200347 ctx = i915_gem_create_context(dev, NULL);
Chris Wilson691e6412014-04-09 09:07:36 +0100348 if (IS_ERR(ctx)) {
349 DRM_ERROR("Failed to create default global context (error %ld)\n",
350 PTR_ERR(ctx));
351 return PTR_ERR(ctx);
Ben Widawsky254f9652012-06-04 14:42:42 -0700352 }
353
Oscar Mateoede7d422014-07-24 17:04:12 +0100354 for (i = 0; i < I915_NUM_RINGS; i++) {
355 struct intel_engine_cs *ring = &dev_priv->ring[i];
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800356
Oscar Mateoede7d422014-07-24 17:04:12 +0100357 /* NB: RCS will hold a ref for all rings */
358 ring->default_context = ctx;
Oscar Mateoede7d422014-07-24 17:04:12 +0100359 }
360
361 DRM_DEBUG_DRIVER("%s context support initialized\n",
362 i915.enable_execlists ? "LR" :
363 dev_priv->hw_context_size ? "HW" : "fake");
Ben Widawsky8245be32013-11-06 13:56:29 -0200364 return 0;
Ben Widawsky254f9652012-06-04 14:42:42 -0700365}
366
367void i915_gem_context_fini(struct drm_device *dev)
368{
369 struct drm_i915_private *dev_priv = dev->dev_private;
Oscar Mateo273497e2014-05-22 14:13:37 +0100370 struct intel_context *dctx = dev_priv->ring[RCS].default_context;
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800371 int i;
Ben Widawsky254f9652012-06-04 14:42:42 -0700372
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100373 if (dctx->legacy_hw_ctx.rcs_state) {
Chris Wilson691e6412014-04-09 09:07:36 +0100374 /* The only known way to stop the gpu from accessing the hw context is
375 * to reset it. Do this as the very last operation to avoid confusing
376 * other code, leading to spurious errors. */
377 intel_gpu_reset(dev);
Ben Widawsky40521052012-06-04 14:42:43 -0700378
Chris Wilson691e6412014-04-09 09:07:36 +0100379 /* When default context is created and switched to, base object refcount
380 * will be 2 (+1 from object creation and +1 from do_switch()).
381 * i915_gem_context_fini() will be called after gpu_idle() has switched
382 * to default context. So we need to unreference the base object once
383 * to offset the do_switch part, so that i915_gem_context_unreference()
384 * can then free the base object correctly. */
385 WARN_ON(!dev_priv->ring[RCS].last_context);
386 if (dev_priv->ring[RCS].last_context == dctx) {
387 /* Fake switch to NULL context */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100388 WARN_ON(dctx->legacy_hw_ctx.rcs_state->active);
389 i915_gem_object_ggtt_unpin(dctx->legacy_hw_ctx.rcs_state);
Chris Wilson691e6412014-04-09 09:07:36 +0100390 i915_gem_context_unreference(dctx);
391 dev_priv->ring[RCS].last_context = NULL;
392 }
Chris Wilsond3b448d2014-05-16 18:59:00 +0100393
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100394 i915_gem_object_ggtt_unpin(dctx->legacy_hw_ctx.rcs_state);
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800395 }
396
397 for (i = 0; i < I915_NUM_RINGS; i++) {
Oscar Mateoa4872ba2014-05-22 14:13:33 +0100398 struct intel_engine_cs *ring = &dev_priv->ring[i];
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800399
400 if (ring->last_context)
401 i915_gem_context_unreference(ring->last_context);
402
403 ring->default_context = NULL;
Ben Widawsky0009e462013-12-06 14:11:02 -0800404 ring->last_context = NULL;
Ben Widawsky71b76d02013-10-14 10:01:37 -0700405 }
406
Mika Kuoppaladce32712013-04-30 13:30:33 +0300407 i915_gem_context_unreference(dctx);
Ben Widawsky254f9652012-06-04 14:42:42 -0700408}
409
Ben Widawsky2fa48d82013-12-06 14:11:04 -0800410int i915_gem_context_enable(struct drm_i915_private *dev_priv)
411{
Oscar Mateoa4872ba2014-05-22 14:13:33 +0100412 struct intel_engine_cs *ring;
Ben Widawsky2fa48d82013-12-06 14:11:04 -0800413 int ret, i;
414
Ben Widawsky2fa48d82013-12-06 14:11:04 -0800415 /* FIXME: We should make this work, even in reset */
416 if (i915_reset_in_progress(&dev_priv->gpu_error))
417 return 0;
418
419 BUG_ON(!dev_priv->ring[RCS].default_context);
Ben Widawskybdf4fd72013-12-06 14:11:18 -0800420
Ben Widawsky2fa48d82013-12-06 14:11:04 -0800421 for_each_ring(ring, dev_priv, i) {
Chris Wilson691e6412014-04-09 09:07:36 +0100422 ret = i915_switch_context(ring, ring->default_context);
Ben Widawsky2fa48d82013-12-06 14:11:04 -0800423 if (ret)
424 return ret;
425 }
426
427 return 0;
428}
429
Ben Widawsky40521052012-06-04 14:42:43 -0700430static int context_idr_cleanup(int id, void *p, void *data)
431{
Oscar Mateo273497e2014-05-22 14:13:37 +0100432 struct intel_context *ctx = p;
Ben Widawsky40521052012-06-04 14:42:43 -0700433
Mika Kuoppaladce32712013-04-30 13:30:33 +0300434 i915_gem_context_unreference(ctx);
Ben Widawsky40521052012-06-04 14:42:43 -0700435 return 0;
Ben Widawsky254f9652012-06-04 14:42:42 -0700436}
437
Ben Widawskye422b882013-12-06 14:10:58 -0800438int i915_gem_context_open(struct drm_device *dev, struct drm_file *file)
439{
440 struct drm_i915_file_private *file_priv = file->driver_priv;
Oscar Mateof83d6512014-05-22 14:13:38 +0100441 struct intel_context *ctx;
Ben Widawskye422b882013-12-06 14:10:58 -0800442
443 idr_init(&file_priv->context_idr);
444
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800445 mutex_lock(&dev->struct_mutex);
Daniel Vetterd624d862014-08-06 15:04:54 +0200446 ctx = i915_gem_create_context(dev, file_priv);
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800447 mutex_unlock(&dev->struct_mutex);
448
Oscar Mateof83d6512014-05-22 14:13:38 +0100449 if (IS_ERR(ctx)) {
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800450 idr_destroy(&file_priv->context_idr);
Oscar Mateof83d6512014-05-22 14:13:38 +0100451 return PTR_ERR(ctx);
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800452 }
453
Ben Widawskye422b882013-12-06 14:10:58 -0800454 return 0;
455}
456
Ben Widawsky254f9652012-06-04 14:42:42 -0700457void i915_gem_context_close(struct drm_device *dev, struct drm_file *file)
458{
Ben Widawsky40521052012-06-04 14:42:43 -0700459 struct drm_i915_file_private *file_priv = file->driver_priv;
Ben Widawsky254f9652012-06-04 14:42:42 -0700460
Daniel Vetter73c273e2012-06-19 20:27:39 +0200461 idr_for_each(&file_priv->context_idr, context_idr_cleanup, NULL);
Ben Widawsky40521052012-06-04 14:42:43 -0700462 idr_destroy(&file_priv->context_idr);
Ben Widawsky40521052012-06-04 14:42:43 -0700463}
464
Oscar Mateo273497e2014-05-22 14:13:37 +0100465struct intel_context *
Ben Widawsky40521052012-06-04 14:42:43 -0700466i915_gem_context_get(struct drm_i915_file_private *file_priv, u32 id)
467{
Oscar Mateo273497e2014-05-22 14:13:37 +0100468 struct intel_context *ctx;
Ben Widawsky72ad5c42014-01-02 19:50:27 -1000469
Oscar Mateo273497e2014-05-22 14:13:37 +0100470 ctx = (struct intel_context *)idr_find(&file_priv->context_idr, id);
Ben Widawsky72ad5c42014-01-02 19:50:27 -1000471 if (!ctx)
472 return ERR_PTR(-ENOENT);
473
474 return ctx;
Ben Widawsky254f9652012-06-04 14:42:42 -0700475}
Ben Widawskye0556842012-06-04 14:42:46 -0700476
477static inline int
Oscar Mateoa4872ba2014-05-22 14:13:33 +0100478mi_set_context(struct intel_engine_cs *ring,
Oscar Mateo273497e2014-05-22 14:13:37 +0100479 struct intel_context *new_context,
Ben Widawskye0556842012-06-04 14:42:46 -0700480 u32 hw_flags)
481{
482 int ret;
483
Ben Widawsky12b02862012-06-04 14:42:50 -0700484 /* w/a: If Flush TLB Invalidation Mode is enabled, driver must do a TLB
485 * invalidation prior to MI_SET_CONTEXT. On GEN6 we don't set the value
486 * explicitly, so we rely on the value at ring init, stored in
487 * itlb_before_ctx_switch.
488 */
Ben Widawsky057f6a82014-04-02 22:30:23 -0700489 if (IS_GEN6(ring->dev)) {
Chris Wilsonac82ea22012-10-01 14:27:04 +0100490 ret = ring->flush(ring, I915_GEM_GPU_DOMAINS, 0);
Ben Widawsky12b02862012-06-04 14:42:50 -0700491 if (ret)
492 return ret;
493 }
494
Ben Widawskye37ec392012-06-04 14:42:48 -0700495 ret = intel_ring_begin(ring, 6);
Ben Widawskye0556842012-06-04 14:42:46 -0700496 if (ret)
497 return ret;
498
Ville Syrjäläb3f797a2014-04-28 14:31:09 +0300499 /* WaProgramMiArbOnOffAroundMiSetContext:ivb,vlv,hsw,bdw,chv */
Ville Syrjälä64bed782014-03-31 18:17:18 +0300500 if (INTEL_INFO(ring->dev)->gen >= 7)
Ben Widawskye37ec392012-06-04 14:42:48 -0700501 intel_ring_emit(ring, MI_ARB_ON_OFF | MI_ARB_DISABLE);
502 else
503 intel_ring_emit(ring, MI_NOOP);
504
Ben Widawskye0556842012-06-04 14:42:46 -0700505 intel_ring_emit(ring, MI_NOOP);
506 intel_ring_emit(ring, MI_SET_CONTEXT);
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100507 intel_ring_emit(ring, i915_gem_obj_ggtt_offset(new_context->legacy_hw_ctx.rcs_state) |
Ben Widawskye0556842012-06-04 14:42:46 -0700508 MI_MM_SPACE_GTT |
509 MI_SAVE_EXT_STATE_EN |
510 MI_RESTORE_EXT_STATE_EN |
511 hw_flags);
Ville Syrjälä2b7e8082014-01-22 21:32:43 +0200512 /*
513 * w/a: MI_SET_CONTEXT must always be followed by MI_NOOP
514 * WaMiSetContext_Hang:snb,ivb,vlv
515 */
Ben Widawskye0556842012-06-04 14:42:46 -0700516 intel_ring_emit(ring, MI_NOOP);
517
Ville Syrjälä64bed782014-03-31 18:17:18 +0300518 if (INTEL_INFO(ring->dev)->gen >= 7)
Ben Widawskye37ec392012-06-04 14:42:48 -0700519 intel_ring_emit(ring, MI_ARB_ON_OFF | MI_ARB_ENABLE);
520 else
521 intel_ring_emit(ring, MI_NOOP);
522
Ben Widawskye0556842012-06-04 14:42:46 -0700523 intel_ring_advance(ring);
524
525 return ret;
526}
527
Oscar Mateoa4872ba2014-05-22 14:13:33 +0100528static int do_switch(struct intel_engine_cs *ring,
Oscar Mateo273497e2014-05-22 14:13:37 +0100529 struct intel_context *to)
Ben Widawskye0556842012-06-04 14:42:46 -0700530{
Ben Widawsky6f65e292013-12-06 14:10:56 -0800531 struct drm_i915_private *dev_priv = ring->dev->dev_private;
Oscar Mateo273497e2014-05-22 14:13:37 +0100532 struct intel_context *from = ring->last_context;
Ben Widawskye0556842012-06-04 14:42:46 -0700533 u32 hw_flags = 0;
Chris Wilson967ab6b2014-05-30 14:16:30 +0100534 bool uninitialized = false;
Ben Widawsky3ccfd192013-09-18 19:03:18 -0700535 int ret, i;
Ben Widawskye0556842012-06-04 14:42:46 -0700536
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800537 if (from != NULL && ring == &dev_priv->ring[RCS]) {
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100538 BUG_ON(from->legacy_hw_ctx.rcs_state == NULL);
539 BUG_ON(!i915_gem_obj_is_pinned(from->legacy_hw_ctx.rcs_state));
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800540 }
Ben Widawskye0556842012-06-04 14:42:46 -0700541
Oscar Mateo14d8ec52014-06-18 17:16:03 +0100542 if (from == to && !to->remap_slice)
Chris Wilson9a3b5302012-07-15 12:34:24 +0100543 return 0;
544
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800545 /* Trying to pin first makes error handling easier. */
546 if (ring == &dev_priv->ring[RCS]) {
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100547 ret = i915_gem_obj_ggtt_pin(to->legacy_hw_ctx.rcs_state,
Daniel Vetter1ec9e262014-02-14 14:01:11 +0100548 get_context_alignment(ring->dev), 0);
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800549 if (ret)
550 return ret;
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800551 }
552
Daniel Vetteracc240d2013-12-05 15:42:34 +0100553 /*
554 * Pin can switch back to the default context if we end up calling into
555 * evict_everything - as a last ditch gtt defrag effort that also
556 * switches to the default context. Hence we need to reload from here.
557 */
558 from = ring->last_context;
559
Daniel Vetterae6c4802014-08-06 15:04:53 +0200560 if (to->ppgtt) {
561 ret = to->ppgtt->switch_mm(to->ppgtt, ring, false);
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800562 if (ret)
563 goto unpin_out;
564 }
565
566 if (ring != &dev_priv->ring[RCS]) {
567 if (from)
568 i915_gem_context_unreference(from);
569 goto done;
570 }
571
Daniel Vetteracc240d2013-12-05 15:42:34 +0100572 /*
573 * Clear this page out of any CPU caches for coherent swap-in/out. Note
Chris Wilsond3373a22012-07-15 12:34:22 +0100574 * that thanks to write = false in this call and us not setting any gpu
575 * write domains when putting a context object onto the active list
576 * (when switching away from it), this won't block.
Daniel Vetteracc240d2013-12-05 15:42:34 +0100577 *
578 * XXX: We need a real interface to do this instead of trickery.
579 */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100580 ret = i915_gem_object_set_to_gtt_domain(to->legacy_hw_ctx.rcs_state, false);
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800581 if (ret)
582 goto unpin_out;
Chris Wilsond3373a22012-07-15 12:34:22 +0100583
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100584 if (!to->legacy_hw_ctx.rcs_state->has_global_gtt_mapping) {
585 struct i915_vma *vma = i915_gem_obj_to_vma(to->legacy_hw_ctx.rcs_state,
Ben Widawsky6f65e292013-12-06 14:10:56 -0800586 &dev_priv->gtt.base);
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100587 vma->bind_vma(vma, to->legacy_hw_ctx.rcs_state->cache_level, GLOBAL_BIND);
Ben Widawsky6f65e292013-12-06 14:10:56 -0800588 }
Daniel Vetter3af7b852012-06-14 00:08:32 +0200589
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100590 if (!to->legacy_hw_ctx.initialized || i915_gem_context_is_default(to))
Ben Widawskye0556842012-06-04 14:42:46 -0700591 hw_flags |= MI_RESTORE_INHIBIT;
Ben Widawskye0556842012-06-04 14:42:46 -0700592
Ben Widawskye0556842012-06-04 14:42:46 -0700593 ret = mi_set_context(ring, to, hw_flags);
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800594 if (ret)
595 goto unpin_out;
Ben Widawskye0556842012-06-04 14:42:46 -0700596
Ben Widawsky3ccfd192013-09-18 19:03:18 -0700597 for (i = 0; i < MAX_L3_SLICES; i++) {
598 if (!(to->remap_slice & (1<<i)))
599 continue;
600
601 ret = i915_gem_l3_remap(ring, i);
602 /* If it failed, try again next round */
603 if (ret)
604 DRM_DEBUG_DRIVER("L3 remapping failed\n");
605 else
606 to->remap_slice &= ~(1<<i);
607 }
608
Ben Widawskye0556842012-06-04 14:42:46 -0700609 /* The backing object for the context is done after switching to the
610 * *next* context. Therefore we cannot retire the previous context until
611 * the next context has already started running. In fact, the below code
612 * is a bit suboptimal because the retiring can occur simply after the
613 * MI_SET_CONTEXT instead of when the next seqno has completed.
614 */
Chris Wilson112522f2013-05-02 16:48:07 +0300615 if (from != NULL) {
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100616 from->legacy_hw_ctx.rcs_state->base.read_domains = I915_GEM_DOMAIN_INSTRUCTION;
617 i915_vma_move_to_active(i915_gem_obj_to_ggtt(from->legacy_hw_ctx.rcs_state), ring);
Ben Widawskye0556842012-06-04 14:42:46 -0700618 /* As long as MI_SET_CONTEXT is serializing, ie. it flushes the
619 * whole damn pipeline, we don't need to explicitly mark the
620 * object dirty. The only exception is that the context must be
621 * correct in case the object gets swapped out. Ideally we'd be
622 * able to defer doing this until we know the object would be
623 * swapped, but there is no way to do that yet.
624 */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100625 from->legacy_hw_ctx.rcs_state->dirty = 1;
626 BUG_ON(from->legacy_hw_ctx.rcs_state->ring != ring);
Chris Wilsonb259b312012-07-15 12:34:23 +0100627
Chris Wilsonc0321e22013-08-26 19:50:53 -0300628 /* obj is kept alive until the next request by its active ref */
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100629 i915_gem_object_ggtt_unpin(from->legacy_hw_ctx.rcs_state);
Chris Wilson112522f2013-05-02 16:48:07 +0300630 i915_gem_context_unreference(from);
Ben Widawskye0556842012-06-04 14:42:46 -0700631 }
632
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100633 uninitialized = !to->legacy_hw_ctx.initialized && from == NULL;
634 to->legacy_hw_ctx.initialized = true;
Chris Wilson967ab6b2014-05-30 14:16:30 +0100635
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800636done:
Chris Wilson112522f2013-05-02 16:48:07 +0300637 i915_gem_context_reference(to);
638 ring->last_context = to;
Ben Widawskye0556842012-06-04 14:42:46 -0700639
Chris Wilson967ab6b2014-05-30 14:16:30 +0100640 if (uninitialized) {
Mika Kuoppala46470fc92014-05-21 19:01:06 +0300641 ret = i915_gem_render_state_init(ring);
642 if (ret)
643 DRM_ERROR("init render state: %d\n", ret);
644 }
645
Ben Widawskye0556842012-06-04 14:42:46 -0700646 return 0;
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800647
648unpin_out:
649 if (ring->id == RCS)
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100650 i915_gem_object_ggtt_unpin(to->legacy_hw_ctx.rcs_state);
Ben Widawsky7e0d96b2013-12-06 14:11:26 -0800651 return ret;
Ben Widawskye0556842012-06-04 14:42:46 -0700652}
653
654/**
655 * i915_switch_context() - perform a GPU context switch.
656 * @ring: ring for which we'll execute the context switch
Damien Lespiau96a6f0f2014-03-03 23:57:24 +0000657 * @to: the context to switch to
Ben Widawskye0556842012-06-04 14:42:46 -0700658 *
659 * The context life cycle is simple. The context refcount is incremented and
660 * decremented by 1 and create and destroy. If the context is in use by the GPU,
661 * it will have a refoucnt > 1. This allows us to destroy the context abstract
662 * object while letting the normal object tracking destroy the backing BO.
663 */
Oscar Mateoa4872ba2014-05-22 14:13:33 +0100664int i915_switch_context(struct intel_engine_cs *ring,
Oscar Mateo273497e2014-05-22 14:13:37 +0100665 struct intel_context *to)
Ben Widawskye0556842012-06-04 14:42:46 -0700666{
667 struct drm_i915_private *dev_priv = ring->dev->dev_private;
Ben Widawskye0556842012-06-04 14:42:46 -0700668
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800669 WARN_ON(!mutex_is_locked(&dev_priv->dev->struct_mutex));
670
Oscar Mateoea0c76f2014-07-03 16:27:59 +0100671 if (to->legacy_hw_ctx.rcs_state == NULL) { /* We have the fake context */
Chris Wilson691e6412014-04-09 09:07:36 +0100672 if (to != ring->last_context) {
673 i915_gem_context_reference(to);
674 if (ring->last_context)
675 i915_gem_context_unreference(ring->last_context);
676 ring->last_context = to;
677 }
Ben Widawskyc4829722013-12-06 14:11:20 -0800678 return 0;
Mika Kuoppalaa95f6a02014-03-14 16:22:10 +0200679 }
Ben Widawskyc4829722013-12-06 14:11:20 -0800680
Ben Widawsky67e3d2972013-12-06 14:11:01 -0800681 return do_switch(ring, to);
Ben Widawskye0556842012-06-04 14:42:46 -0700682}
Ben Widawsky84624812012-06-04 14:42:54 -0700683
Oscar Mateoec3e9962014-07-24 17:04:18 +0100684static bool contexts_enabled(struct drm_device *dev)
Chris Wilson691e6412014-04-09 09:07:36 +0100685{
Oscar Mateoec3e9962014-07-24 17:04:18 +0100686 return i915.enable_execlists || to_i915(dev)->hw_context_size;
Chris Wilson691e6412014-04-09 09:07:36 +0100687}
688
Ben Widawsky84624812012-06-04 14:42:54 -0700689int i915_gem_context_create_ioctl(struct drm_device *dev, void *data,
690 struct drm_file *file)
691{
Ben Widawsky84624812012-06-04 14:42:54 -0700692 struct drm_i915_gem_context_create *args = data;
693 struct drm_i915_file_private *file_priv = file->driver_priv;
Oscar Mateo273497e2014-05-22 14:13:37 +0100694 struct intel_context *ctx;
Ben Widawsky84624812012-06-04 14:42:54 -0700695 int ret;
696
Oscar Mateoec3e9962014-07-24 17:04:18 +0100697 if (!contexts_enabled(dev))
Daniel Vetter5fa8be62012-06-19 17:16:01 +0200698 return -ENODEV;
699
Ben Widawsky84624812012-06-04 14:42:54 -0700700 ret = i915_mutex_lock_interruptible(dev);
701 if (ret)
702 return ret;
703
Daniel Vetterd624d862014-08-06 15:04:54 +0200704 ctx = i915_gem_create_context(dev, file_priv);
Ben Widawsky84624812012-06-04 14:42:54 -0700705 mutex_unlock(&dev->struct_mutex);
Dan Carpenterbe636382012-07-17 09:44:49 +0300706 if (IS_ERR(ctx))
707 return PTR_ERR(ctx);
Ben Widawsky84624812012-06-04 14:42:54 -0700708
Oscar Mateo821d66d2014-07-03 16:28:00 +0100709 args->ctx_id = ctx->user_handle;
Ben Widawsky84624812012-06-04 14:42:54 -0700710 DRM_DEBUG_DRIVER("HW context %d created\n", args->ctx_id);
711
Dan Carpenterbe636382012-07-17 09:44:49 +0300712 return 0;
Ben Widawsky84624812012-06-04 14:42:54 -0700713}
714
715int i915_gem_context_destroy_ioctl(struct drm_device *dev, void *data,
716 struct drm_file *file)
717{
718 struct drm_i915_gem_context_destroy *args = data;
719 struct drm_i915_file_private *file_priv = file->driver_priv;
Oscar Mateo273497e2014-05-22 14:13:37 +0100720 struct intel_context *ctx;
Ben Widawsky84624812012-06-04 14:42:54 -0700721 int ret;
722
Oscar Mateo821d66d2014-07-03 16:28:00 +0100723 if (args->ctx_id == DEFAULT_CONTEXT_HANDLE)
Ben Widawskyc2cf2412013-12-24 16:02:54 -0800724 return -ENOENT;
Ben Widawsky0eea67e2013-12-06 14:11:19 -0800725
Ben Widawsky84624812012-06-04 14:42:54 -0700726 ret = i915_mutex_lock_interruptible(dev);
727 if (ret)
728 return ret;
729
730 ctx = i915_gem_context_get(file_priv, args->ctx_id);
Ben Widawsky72ad5c42014-01-02 19:50:27 -1000731 if (IS_ERR(ctx)) {
Ben Widawsky84624812012-06-04 14:42:54 -0700732 mutex_unlock(&dev->struct_mutex);
Ben Widawsky72ad5c42014-01-02 19:50:27 -1000733 return PTR_ERR(ctx);
Ben Widawsky84624812012-06-04 14:42:54 -0700734 }
735
Oscar Mateo821d66d2014-07-03 16:28:00 +0100736 idr_remove(&ctx->file_priv->context_idr, ctx->user_handle);
Mika Kuoppaladce32712013-04-30 13:30:33 +0300737 i915_gem_context_unreference(ctx);
Ben Widawsky84624812012-06-04 14:42:54 -0700738 mutex_unlock(&dev->struct_mutex);
739
740 DRM_DEBUG_DRIVER("HW context %d destroyed\n", args->ctx_id);
741 return 0;
742}