1 // SPDX-License-Identifier: GPL-2.0 OR MIT
2 /**************************************************************************
4 * Copyright 2014-2015 VMware, Inc., Palo Alto, CA., USA
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
22 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
23 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
24 * USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
28 * Treat context OTables as resources to make use of the resource
29 * backing MOB eviction mechanism, that is used to read back the COTable
30 * whenever the backing MOB is evicted.
33 #include <drm/ttm/ttm_placement.h>
35 #include "vmwgfx_drv.h"
36 #include "vmwgfx_resource_priv.h"
37 #include "vmwgfx_so.h"
40 * struct vmw_cotable - Context Object Table resource
42 * @res: struct vmw_resource we are deriving from.
43 * @ctx: non-refcounted pointer to the owning context.
44 * @size_read_back: Size of data read back during eviction.
45 * @seen_entries: Seen entries in command stream for this cotable.
46 * @type: The cotable type.
47 * @scrubbed: Whether the cotable has been scrubbed.
48 * @resource_list: List of resources in the cotable.
51 struct vmw_resource res
;
52 struct vmw_resource
*ctx
;
53 size_t size_read_back
;
57 struct list_head resource_list
;
61 * struct vmw_cotable_info - Static info about cotable types
63 * @min_initial_entries: Min number of initial intries at cotable allocation
64 * for this cotable type.
65 * @size: Size of each entry.
67 struct vmw_cotable_info
{
68 u32 min_initial_entries
;
70 void (*unbind_func
)(struct vmw_private
*, struct list_head
*,
74 static const struct vmw_cotable_info co_info
[] = {
75 {1, sizeof(SVGACOTableDXRTViewEntry
), &vmw_view_cotable_list_destroy
},
76 {1, sizeof(SVGACOTableDXDSViewEntry
), &vmw_view_cotable_list_destroy
},
77 {1, sizeof(SVGACOTableDXSRViewEntry
), &vmw_view_cotable_list_destroy
},
78 {1, sizeof(SVGACOTableDXElementLayoutEntry
), NULL
},
79 {1, sizeof(SVGACOTableDXBlendStateEntry
), NULL
},
80 {1, sizeof(SVGACOTableDXDepthStencilEntry
), NULL
},
81 {1, sizeof(SVGACOTableDXRasterizerStateEntry
), NULL
},
82 {1, sizeof(SVGACOTableDXSamplerEntry
), NULL
},
83 {1, sizeof(SVGACOTableDXStreamOutputEntry
), &vmw_dx_streamoutput_cotable_list_scrub
},
84 {1, sizeof(SVGACOTableDXQueryEntry
), NULL
},
85 {1, sizeof(SVGACOTableDXShaderEntry
), &vmw_dx_shader_cotable_list_scrub
},
86 {1, sizeof(SVGACOTableDXUAViewEntry
), &vmw_view_cotable_list_destroy
}
90 * Cotables with bindings that we remove must be scrubbed first,
91 * otherwise, the device will swap in an invalid context when we remove
92 * bindings before scrubbing a cotable...
94 const SVGACOTableType vmw_cotable_scrub_order
[] = {
98 SVGA_COTABLE_DXSHADER
,
99 SVGA_COTABLE_ELEMENTLAYOUT
,
100 SVGA_COTABLE_BLENDSTATE
,
101 SVGA_COTABLE_DEPTHSTENCIL
,
102 SVGA_COTABLE_RASTERIZERSTATE
,
103 SVGA_COTABLE_SAMPLER
,
104 SVGA_COTABLE_STREAMOUTPUT
,
105 SVGA_COTABLE_DXQUERY
,
109 static int vmw_cotable_bind(struct vmw_resource
*res
,
110 struct ttm_validate_buffer
*val_buf
);
111 static int vmw_cotable_unbind(struct vmw_resource
*res
,
113 struct ttm_validate_buffer
*val_buf
);
114 static int vmw_cotable_create(struct vmw_resource
*res
);
115 static int vmw_cotable_destroy(struct vmw_resource
*res
);
117 static const struct vmw_res_func vmw_cotable_func
= {
118 .res_type
= vmw_res_cotable
,
119 .needs_backup
= true,
123 .type_name
= "context guest backed object tables",
124 .backup_placement
= &vmw_mob_placement
,
125 .create
= vmw_cotable_create
,
126 .destroy
= vmw_cotable_destroy
,
127 .bind
= vmw_cotable_bind
,
128 .unbind
= vmw_cotable_unbind
,
132 * vmw_cotable - Convert a struct vmw_resource pointer to a struct
133 * vmw_cotable pointer
135 * @res: Pointer to the resource.
137 static struct vmw_cotable
*vmw_cotable(struct vmw_resource
*res
)
139 return container_of(res
, struct vmw_cotable
, res
);
143 * vmw_cotable_destroy - Cotable resource destroy callback
145 * @res: Pointer to the cotable resource.
147 * There is no device cotable destroy command, so this function only
148 * makes sure that the resource id is set to invalid.
150 static int vmw_cotable_destroy(struct vmw_resource
*res
)
157 * vmw_cotable_unscrub - Undo a cotable unscrub operation
159 * @res: Pointer to the cotable resource
161 * This function issues commands to (re)bind the cotable to
162 * its backing mob, which needs to be validated and reserved at this point.
163 * This is identical to bind() except the function interface looks different.
165 static int vmw_cotable_unscrub(struct vmw_resource
*res
)
167 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
168 struct vmw_private
*dev_priv
= res
->dev_priv
;
169 struct ttm_buffer_object
*bo
= &res
->backup
->base
;
171 SVGA3dCmdHeader header
;
172 SVGA3dCmdDXSetCOTable body
;
175 WARN_ON_ONCE(bo
->mem
.mem_type
!= VMW_PL_MOB
);
176 dma_resv_assert_held(bo
->base
.resv
);
178 cmd
= VMW_FIFO_RESERVE(dev_priv
, sizeof(*cmd
));
182 WARN_ON(vcotbl
->ctx
->id
== SVGA3D_INVALID_ID
);
183 WARN_ON(bo
->mem
.mem_type
!= VMW_PL_MOB
);
184 cmd
->header
.id
= SVGA_3D_CMD_DX_SET_COTABLE
;
185 cmd
->header
.size
= sizeof(cmd
->body
);
186 cmd
->body
.cid
= vcotbl
->ctx
->id
;
187 cmd
->body
.type
= vcotbl
->type
;
188 cmd
->body
.mobid
= bo
->mem
.start
;
189 cmd
->body
.validSizeInBytes
= vcotbl
->size_read_back
;
191 vmw_fifo_commit_flush(dev_priv
, sizeof(*cmd
));
192 vcotbl
->scrubbed
= false;
198 * vmw_cotable_bind - Undo a cotable unscrub operation
200 * @res: Pointer to the cotable resource
201 * @val_buf: Pointer to a struct ttm_validate_buffer prepared by the caller
202 * for convenience / fencing.
204 * This function issues commands to (re)bind the cotable to
205 * its backing mob, which needs to be validated and reserved at this point.
207 static int vmw_cotable_bind(struct vmw_resource
*res
,
208 struct ttm_validate_buffer
*val_buf
)
211 * The create() callback may have changed @res->backup without
212 * the caller noticing, and with val_buf->bo still pointing to
213 * the old backup buffer. Although hackish, and not used currently,
214 * take the opportunity to correct the value here so that it's not
215 * misused in the future.
217 val_buf
->bo
= &res
->backup
->base
;
219 return vmw_cotable_unscrub(res
);
223 * vmw_cotable_scrub - Scrub the cotable from the device.
225 * @res: Pointer to the cotable resource.
226 * @readback: Whether initiate a readback of the cotable data to the backup
229 * In some situations (context swapouts) it might be desirable to make the
230 * device forget about the cotable without performing a full unbind. A full
231 * unbind requires reserved backup buffers and it might not be possible to
232 * reserve them due to locking order violation issues. The vmw_cotable_scrub
233 * function implements a partial unbind() without that requirement but with the
234 * following restrictions.
235 * 1) Before the cotable is again used by the GPU, vmw_cotable_unscrub() must
237 * 2) Before the cotable backing buffer is used by the CPU, or during the
238 * resource destruction, vmw_cotable_unbind() must be called.
240 int vmw_cotable_scrub(struct vmw_resource
*res
, bool readback
)
242 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
243 struct vmw_private
*dev_priv
= res
->dev_priv
;
247 SVGA3dCmdHeader header
;
248 SVGA3dCmdDXReadbackCOTable body
;
251 SVGA3dCmdHeader header
;
252 SVGA3dCmdDXSetCOTable body
;
255 if (vcotbl
->scrubbed
)
258 if (co_info
[vcotbl
->type
].unbind_func
)
259 co_info
[vcotbl
->type
].unbind_func(dev_priv
,
260 &vcotbl
->resource_list
,
262 submit_size
= sizeof(*cmd1
);
264 submit_size
+= sizeof(*cmd0
);
266 cmd1
= VMW_FIFO_RESERVE(dev_priv
, submit_size
);
270 vcotbl
->size_read_back
= 0;
272 cmd0
= (void *) cmd1
;
273 cmd0
->header
.id
= SVGA_3D_CMD_DX_READBACK_COTABLE
;
274 cmd0
->header
.size
= sizeof(cmd0
->body
);
275 cmd0
->body
.cid
= vcotbl
->ctx
->id
;
276 cmd0
->body
.type
= vcotbl
->type
;
277 cmd1
= (void *) &cmd0
[1];
278 vcotbl
->size_read_back
= res
->backup_size
;
280 cmd1
->header
.id
= SVGA_3D_CMD_DX_SET_COTABLE
;
281 cmd1
->header
.size
= sizeof(cmd1
->body
);
282 cmd1
->body
.cid
= vcotbl
->ctx
->id
;
283 cmd1
->body
.type
= vcotbl
->type
;
284 cmd1
->body
.mobid
= SVGA3D_INVALID_ID
;
285 cmd1
->body
.validSizeInBytes
= 0;
286 vmw_fifo_commit_flush(dev_priv
, submit_size
);
287 vcotbl
->scrubbed
= true;
289 /* Trigger a create() on next validate. */
296 * vmw_cotable_unbind - Cotable resource unbind callback
298 * @res: Pointer to the cotable resource.
299 * @readback: Whether to read back cotable data to the backup buffer.
300 * val_buf: Pointer to a struct ttm_validate_buffer prepared by the caller
301 * for convenience / fencing.
303 * Unbinds the cotable from the device and fences the backup buffer.
305 static int vmw_cotable_unbind(struct vmw_resource
*res
,
307 struct ttm_validate_buffer
*val_buf
)
309 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
310 struct vmw_private
*dev_priv
= res
->dev_priv
;
311 struct ttm_buffer_object
*bo
= val_buf
->bo
;
312 struct vmw_fence_obj
*fence
;
314 if (!vmw_resource_mob_attached(res
))
317 WARN_ON_ONCE(bo
->mem
.mem_type
!= VMW_PL_MOB
);
318 dma_resv_assert_held(bo
->base
.resv
);
320 mutex_lock(&dev_priv
->binding_mutex
);
321 if (!vcotbl
->scrubbed
)
322 vmw_dx_context_scrub_cotables(vcotbl
->ctx
, readback
);
323 mutex_unlock(&dev_priv
->binding_mutex
);
324 (void) vmw_execbuf_fence_commands(NULL
, dev_priv
, &fence
, NULL
);
325 vmw_bo_fence_single(bo
, fence
);
326 if (likely(fence
!= NULL
))
327 vmw_fence_obj_unreference(&fence
);
333 * vmw_cotable_readback - Read back a cotable without unbinding.
335 * @res: The cotable resource.
337 * Reads back a cotable to its backing mob without scrubbing the MOB from
338 * the cotable. The MOB is fenced for subsequent CPU access.
340 static int vmw_cotable_readback(struct vmw_resource
*res
)
342 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
343 struct vmw_private
*dev_priv
= res
->dev_priv
;
346 SVGA3dCmdHeader header
;
347 SVGA3dCmdDXReadbackCOTable body
;
349 struct vmw_fence_obj
*fence
;
351 if (!vcotbl
->scrubbed
) {
352 cmd
= VMW_FIFO_RESERVE(dev_priv
, sizeof(*cmd
));
356 cmd
->header
.id
= SVGA_3D_CMD_DX_READBACK_COTABLE
;
357 cmd
->header
.size
= sizeof(cmd
->body
);
358 cmd
->body
.cid
= vcotbl
->ctx
->id
;
359 cmd
->body
.type
= vcotbl
->type
;
360 vcotbl
->size_read_back
= res
->backup_size
;
361 vmw_fifo_commit(dev_priv
, sizeof(*cmd
));
364 (void) vmw_execbuf_fence_commands(NULL
, dev_priv
, &fence
, NULL
);
365 vmw_bo_fence_single(&res
->backup
->base
, fence
);
366 vmw_fence_obj_unreference(&fence
);
372 * vmw_cotable_resize - Resize a cotable.
374 * @res: The cotable resource.
375 * @new_size: The new size.
377 * Resizes a cotable and binds the new backup buffer.
378 * On failure the cotable is left intact.
379 * Important! This function may not fail once the MOB switch has been
380 * committed to hardware. That would put the device context in an
381 * invalid state which we can't currently recover from.
383 static int vmw_cotable_resize(struct vmw_resource
*res
, size_t new_size
)
385 struct ttm_operation_ctx ctx
= { false, false };
386 struct vmw_private
*dev_priv
= res
->dev_priv
;
387 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
388 struct vmw_buffer_object
*buf
, *old_buf
= res
->backup
;
389 struct ttm_buffer_object
*bo
, *old_bo
= &res
->backup
->base
;
390 size_t old_size
= res
->backup_size
;
391 size_t old_size_read_back
= vcotbl
->size_read_back
;
392 size_t cur_size_read_back
;
393 struct ttm_bo_kmap_obj old_map
, new_map
;
397 ret
= vmw_cotable_readback(res
);
401 cur_size_read_back
= vcotbl
->size_read_back
;
402 vcotbl
->size_read_back
= old_size_read_back
;
405 * While device is processing, Allocate and reserve a buffer object
406 * for the new COTable. Initially pin the buffer object to make sure
407 * we can use tryreserve without failure.
409 buf
= kzalloc(sizeof(*buf
), GFP_KERNEL
);
413 ret
= vmw_bo_init(dev_priv
, buf
, new_size
, &vmw_mob_placement
,
414 true, true, vmw_bo_bo_free
);
416 DRM_ERROR("Failed initializing new cotable MOB.\n");
421 WARN_ON_ONCE(ttm_bo_reserve(bo
, false, true, NULL
));
423 ret
= ttm_bo_wait(old_bo
, false, false);
424 if (unlikely(ret
!= 0)) {
425 DRM_ERROR("Failed waiting for cotable unbind.\n");
430 * Do a page by page copy of COTables. This eliminates slow vmap()s.
431 * This should really be a TTM utility.
433 for (i
= 0; i
< old_bo
->num_pages
; ++i
) {
436 ret
= ttm_bo_kmap(old_bo
, i
, 1, &old_map
);
437 if (unlikely(ret
!= 0)) {
438 DRM_ERROR("Failed mapping old COTable on resize.\n");
441 ret
= ttm_bo_kmap(bo
, i
, 1, &new_map
);
442 if (unlikely(ret
!= 0)) {
443 DRM_ERROR("Failed mapping new COTable on resize.\n");
446 memcpy(ttm_kmap_obj_virtual(&new_map
, &dummy
),
447 ttm_kmap_obj_virtual(&old_map
, &dummy
),
449 ttm_bo_kunmap(&new_map
);
450 ttm_bo_kunmap(&old_map
);
453 /* Unpin new buffer, and switch backup buffers. */
454 ret
= ttm_bo_validate(bo
, &vmw_mob_placement
, &ctx
);
455 if (unlikely(ret
!= 0)) {
456 DRM_ERROR("Failed validating new COTable backup buffer.\n");
460 vmw_resource_mob_detach(res
);
462 res
->backup_size
= new_size
;
463 vcotbl
->size_read_back
= cur_size_read_back
;
466 * Now tell the device to switch. If this fails, then we need to
467 * revert the full resize.
469 ret
= vmw_cotable_unscrub(res
);
471 DRM_ERROR("Failed switching COTable backup buffer.\n");
472 res
->backup
= old_buf
;
473 res
->backup_size
= old_size
;
474 vcotbl
->size_read_back
= old_size_read_back
;
475 vmw_resource_mob_attach(res
);
479 vmw_resource_mob_attach(res
);
480 /* Let go of the old mob. */
481 vmw_bo_unreference(&old_buf
);
482 res
->id
= vcotbl
->type
;
487 ttm_bo_kunmap(&old_map
);
489 ttm_bo_unreserve(bo
);
490 vmw_bo_unreference(&buf
);
496 * vmw_cotable_create - Cotable resource create callback
498 * @res: Pointer to a cotable resource.
500 * There is no separate create command for cotables, so this callback, which
501 * is called before bind() in the validation sequence is instead used for two
503 * 1) Unscrub the cotable if it is scrubbed and still attached to a backup
505 * 2) Resize the cotable if needed.
507 static int vmw_cotable_create(struct vmw_resource
*res
)
509 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
510 size_t new_size
= res
->backup_size
;
514 /* Check whether we need to resize the cotable */
515 needed_size
= (vcotbl
->seen_entries
+ 1) * co_info
[vcotbl
->type
].size
;
516 while (needed_size
> new_size
)
519 if (likely(new_size
<= res
->backup_size
)) {
520 if (vcotbl
->scrubbed
&& vmw_resource_mob_attached(res
)) {
521 ret
= vmw_cotable_unscrub(res
);
525 res
->id
= vcotbl
->type
;
529 return vmw_cotable_resize(res
, new_size
);
533 * vmw_hw_cotable_destroy - Cotable hw_destroy callback
535 * @res: Pointer to a cotable resource.
537 * The final (part of resource destruction) destroy callback.
539 static void vmw_hw_cotable_destroy(struct vmw_resource
*res
)
541 (void) vmw_cotable_destroy(res
);
544 static size_t cotable_acc_size
;
547 * vmw_cotable_free - Cotable resource destructor
549 * @res: Pointer to a cotable resource.
551 static void vmw_cotable_free(struct vmw_resource
*res
)
553 struct vmw_private
*dev_priv
= res
->dev_priv
;
556 ttm_mem_global_free(vmw_mem_glob(dev_priv
), cotable_acc_size
);
560 * vmw_cotable_alloc - Create a cotable resource
562 * @dev_priv: Pointer to a device private struct.
563 * @ctx: Pointer to the context resource.
564 * The cotable resource will not add a refcount.
565 * @type: The cotable type.
567 struct vmw_resource
*vmw_cotable_alloc(struct vmw_private
*dev_priv
,
568 struct vmw_resource
*ctx
,
571 struct vmw_cotable
*vcotbl
;
572 struct ttm_operation_ctx ttm_opt_ctx
= {
573 .interruptible
= true,
579 if (unlikely(cotable_acc_size
== 0))
580 cotable_acc_size
= ttm_round_pot(sizeof(struct vmw_cotable
));
582 ret
= ttm_mem_global_alloc(vmw_mem_glob(dev_priv
),
583 cotable_acc_size
, &ttm_opt_ctx
);
587 vcotbl
= kzalloc(sizeof(*vcotbl
), GFP_KERNEL
);
588 if (unlikely(!vcotbl
)) {
593 ret
= vmw_resource_init(dev_priv
, &vcotbl
->res
, true,
594 vmw_cotable_free
, &vmw_cotable_func
);
595 if (unlikely(ret
!= 0))
598 INIT_LIST_HEAD(&vcotbl
->resource_list
);
599 vcotbl
->res
.id
= type
;
600 vcotbl
->res
.backup_size
= PAGE_SIZE
;
601 num_entries
= PAGE_SIZE
/ co_info
[type
].size
;
602 if (num_entries
< co_info
[type
].min_initial_entries
) {
603 vcotbl
->res
.backup_size
= co_info
[type
].min_initial_entries
*
605 vcotbl
->res
.backup_size
=
606 (vcotbl
->res
.backup_size
+ PAGE_SIZE
- 1) & PAGE_MASK
;
609 vcotbl
->scrubbed
= true;
610 vcotbl
->seen_entries
= -1;
614 vcotbl
->res
.hw_destroy
= vmw_hw_cotable_destroy
;
621 ttm_mem_global_free(vmw_mem_glob(dev_priv
), cotable_acc_size
);
626 * vmw_cotable_notify - Notify the cotable about an item creation
628 * @res: Pointer to a cotable resource.
631 int vmw_cotable_notify(struct vmw_resource
*res
, int id
)
633 struct vmw_cotable
*vcotbl
= vmw_cotable(res
);
635 if (id
< 0 || id
>= SVGA_COTABLE_MAX_IDS
) {
636 DRM_ERROR("Illegal COTable id. Type is %u. Id is %d\n",
637 (unsigned) vcotbl
->type
, id
);
641 if (vcotbl
->seen_entries
< id
) {
642 /* Trigger a call to create() on next validate */
644 vcotbl
->seen_entries
= id
;
651 * vmw_cotable_add_view - add a view to the cotable's list of active views.
653 * @res: pointer struct vmw_resource representing the cotable.
654 * @head: pointer to the struct list_head member of the resource, dedicated
655 * to the cotable active resource list.
657 void vmw_cotable_add_resource(struct vmw_resource
*res
, struct list_head
*head
)
659 struct vmw_cotable
*vcotbl
=
660 container_of(res
, struct vmw_cotable
, res
);
662 list_add_tail(head
, &vcotbl
->resource_list
);