1 // SPDX-License-Identifier: GPL-2.0 OR MIT
2 /**************************************************************************
3 * Copyright 2014-2015 VMware, Inc., Palo Alto, CA., USA
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sub license, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
13 * The above copyright notice and this permission notice (including the
14 * next paragraph) shall be included in all copies or substantial portions
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
20 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
21 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
22 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
23 * USE OR OTHER DEALINGS IN THE SOFTWARE.
25 **************************************************************************/
27 #include "vmwgfx_drv.h"
28 #include "vmwgfx_resource_priv.h"
29 #include "vmwgfx_so.h"
30 #include "vmwgfx_binding.h"
33 * The currently only reason we need to keep track of views is that if we
34 * destroy a hardware surface, all views pointing to it must also be destroyed,
35 * otherwise the device will error.
36 * So in particuar if a surface is evicted, we must destroy all views pointing
37 * to it, and all context bindings of that view. Similarly we must restore
38 * the view bindings, views and surfaces pointed to by the views when a
39 * context is referenced in the command stream.
43 * struct vmw_view - view metadata
45 * @res: The struct vmw_resource we derive from
46 * @ctx: Non-refcounted pointer to the context this view belongs to.
47 * @srf: Refcounted pointer to the surface pointed to by this view.
48 * @cotable: Refcounted pointer to the cotable holding this view.
49 * @srf_head: List head for the surface-to-view list.
50 * @cotable_head: List head for the cotable-to_view list.
51 * @view_type: View type.
52 * @view_id: User-space per context view id. Currently used also as per
53 * context device view id.
54 * @cmd_size: Size of the SVGA3D define view command that we've copied from the
56 * @committed: Whether the view is actually created or pending creation at the
58 * @cmd: The SVGA3D define view command copied from the command stream.
62 struct vmw_resource res
;
63 struct vmw_resource
*ctx
; /* Immutable */
64 struct vmw_resource
*srf
; /* Immutable */
65 struct vmw_resource
*cotable
; /* Immutable */
66 struct list_head srf_head
; /* Protected by binding_mutex */
67 struct list_head cotable_head
; /* Protected by binding_mutex */
68 unsigned view_type
; /* Immutable */
69 unsigned view_id
; /* Immutable */
70 u32 cmd_size
; /* Immutable */
71 bool committed
; /* Protected by binding_mutex */
72 u32 cmd
[1]; /* Immutable */
75 static int vmw_view_create(struct vmw_resource
*res
);
76 static int vmw_view_destroy(struct vmw_resource
*res
);
77 static void vmw_hw_view_destroy(struct vmw_resource
*res
);
78 static void vmw_view_commit_notify(struct vmw_resource
*res
,
79 enum vmw_cmdbuf_res_state state
);
81 static const struct vmw_res_func vmw_view_func
= {
82 .res_type
= vmw_res_view
,
83 .needs_backup
= false,
85 .type_name
= "DX view",
86 .backup_placement
= NULL
,
87 .create
= vmw_view_create
,
88 .commit_notify
= vmw_view_commit_notify
,
92 * struct vmw_view - view define command body stub
94 * @view_id: The device id of the view being defined
95 * @sid: The surface id of the view being defined
97 * This generic struct is used by the code to change @view_id and @sid of a
98 * saved view define command.
100 struct vmw_view_define
{
106 * vmw_view - Convert a struct vmw_resource to a struct vmw_view
108 * @res: Pointer to the resource to convert.
110 * Returns a pointer to a struct vmw_view.
112 static struct vmw_view
*vmw_view(struct vmw_resource
*res
)
114 return container_of(res
, struct vmw_view
, res
);
118 * vmw_view_commit_notify - Notify that a view operation has been committed to
119 * hardware from a user-supplied command stream.
121 * @res: Pointer to the view resource.
122 * @state: Indicating whether a creation or removal has been committed.
125 static void vmw_view_commit_notify(struct vmw_resource
*res
,
126 enum vmw_cmdbuf_res_state state
)
128 struct vmw_view
*view
= vmw_view(res
);
129 struct vmw_private
*dev_priv
= res
->dev_priv
;
131 mutex_lock(&dev_priv
->binding_mutex
);
132 if (state
== VMW_CMDBUF_RES_ADD
) {
133 struct vmw_surface
*srf
= vmw_res_to_srf(view
->srf
);
135 list_add_tail(&view
->srf_head
, &srf
->view_list
);
136 vmw_cotable_add_resource(view
->cotable
, &view
->cotable_head
);
137 view
->committed
= true;
138 res
->id
= view
->view_id
;
141 list_del_init(&view
->cotable_head
);
142 list_del_init(&view
->srf_head
);
143 view
->committed
= false;
146 mutex_unlock(&dev_priv
->binding_mutex
);
150 * vmw_view_create - Create a hardware view.
152 * @res: Pointer to the view resource.
154 * Create a hardware view. Typically used if that view has previously been
155 * destroyed by an eviction operation.
157 static int vmw_view_create(struct vmw_resource
*res
)
159 struct vmw_view
*view
= vmw_view(res
);
160 struct vmw_surface
*srf
= vmw_res_to_srf(view
->srf
);
161 struct vmw_private
*dev_priv
= res
->dev_priv
;
163 SVGA3dCmdHeader header
;
164 struct vmw_view_define body
;
167 mutex_lock(&dev_priv
->binding_mutex
);
168 if (!view
->committed
) {
169 mutex_unlock(&dev_priv
->binding_mutex
);
173 cmd
= vmw_fifo_reserve_dx(res
->dev_priv
, view
->cmd_size
,
176 DRM_ERROR("Failed reserving FIFO space for view creation.\n");
177 mutex_unlock(&dev_priv
->binding_mutex
);
180 memcpy(cmd
, &view
->cmd
, view
->cmd_size
);
181 WARN_ON(cmd
->body
.view_id
!= view
->view_id
);
182 /* Sid may have changed due to surface eviction. */
183 WARN_ON(view
->srf
->id
== SVGA3D_INVALID_ID
);
184 cmd
->body
.sid
= view
->srf
->id
;
185 vmw_fifo_commit(res
->dev_priv
, view
->cmd_size
);
186 res
->id
= view
->view_id
;
187 list_add_tail(&view
->srf_head
, &srf
->view_list
);
188 vmw_cotable_add_resource(view
->cotable
, &view
->cotable_head
);
189 mutex_unlock(&dev_priv
->binding_mutex
);
195 * vmw_view_destroy - Destroy a hardware view.
197 * @res: Pointer to the view resource.
199 * Destroy a hardware view. Typically used on unexpected termination of the
200 * owning process or if the surface the view is pointing to is destroyed.
202 static int vmw_view_destroy(struct vmw_resource
*res
)
204 struct vmw_private
*dev_priv
= res
->dev_priv
;
205 struct vmw_view
*view
= vmw_view(res
);
207 SVGA3dCmdHeader header
;
208 union vmw_view_destroy body
;
211 lockdep_assert_held_once(&dev_priv
->binding_mutex
);
212 vmw_binding_res_list_scrub(&res
->binding_head
);
214 if (!view
->committed
|| res
->id
== -1)
217 cmd
= vmw_fifo_reserve_dx(dev_priv
, sizeof(*cmd
), view
->ctx
->id
);
219 DRM_ERROR("Failed reserving FIFO space for view "
224 cmd
->header
.id
= vmw_view_destroy_cmds
[view
->view_type
];
225 cmd
->header
.size
= sizeof(cmd
->body
);
226 cmd
->body
.view_id
= view
->view_id
;
227 vmw_fifo_commit(dev_priv
, sizeof(*cmd
));
229 list_del_init(&view
->cotable_head
);
230 list_del_init(&view
->srf_head
);
236 * vmw_hw_view_destroy - Destroy a hardware view as part of resource cleanup.
238 * @res: Pointer to the view resource.
240 * Destroy a hardware view if it's still present.
242 static void vmw_hw_view_destroy(struct vmw_resource
*res
)
244 struct vmw_private
*dev_priv
= res
->dev_priv
;
246 mutex_lock(&dev_priv
->binding_mutex
);
247 WARN_ON(vmw_view_destroy(res
));
249 mutex_unlock(&dev_priv
->binding_mutex
);
253 * vmw_view_key - Compute a view key suitable for the cmdbuf resource manager
255 * @user_key: The user-space id used for the view.
256 * @view_type: The view type.
258 * Destroy a hardware view if it's still present.
260 static u32
vmw_view_key(u32 user_key
, enum vmw_view_type view_type
)
262 return user_key
| (view_type
<< 20);
266 * vmw_view_id_ok - Basic view id and type range checks.
268 * @user_key: The user-space id used for the view.
269 * @view_type: The view type.
271 * Checks that the view id and type (typically provided by user-space) is
274 static bool vmw_view_id_ok(u32 user_key
, enum vmw_view_type view_type
)
276 return (user_key
< SVGA_COTABLE_MAX_IDS
&&
277 view_type
< vmw_view_max
);
281 * vmw_view_res_free - resource res_free callback for view resources
283 * @res: Pointer to a struct vmw_resource
285 * Frees memory and memory accounting held by a struct vmw_view.
287 static void vmw_view_res_free(struct vmw_resource
*res
)
289 struct vmw_view
*view
= vmw_view(res
);
290 size_t size
= offsetof(struct vmw_view
, cmd
) + view
->cmd_size
;
291 struct vmw_private
*dev_priv
= res
->dev_priv
;
293 vmw_resource_unreference(&view
->cotable
);
294 vmw_resource_unreference(&view
->srf
);
295 kfree_rcu(view
, rcu
);
296 ttm_mem_global_free(vmw_mem_glob(dev_priv
), size
);
300 * vmw_view_add - Create a view resource and stage it for addition
301 * as a command buffer managed resource.
303 * @man: Pointer to the compat shader manager identifying the shader namespace.
304 * @ctx: Pointer to a struct vmw_resource identifying the active context.
305 * @srf: Pointer to a struct vmw_resource identifying the surface the view
307 * @view_type: The view type deduced from the view create command.
308 * @user_key: The key that is used to identify the shader. The key is
309 * unique to the view type and to the context.
310 * @cmd: Pointer to the view create command in the command stream.
311 * @cmd_size: Size of the view create command in the command stream.
312 * @list: Caller's list of staged command buffer resource actions.
314 int vmw_view_add(struct vmw_cmdbuf_res_manager
*man
,
315 struct vmw_resource
*ctx
,
316 struct vmw_resource
*srf
,
317 enum vmw_view_type view_type
,
321 struct list_head
*list
)
323 static const size_t vmw_view_define_sizes
[] = {
324 [vmw_view_sr
] = sizeof(SVGA3dCmdDXDefineShaderResourceView
),
325 [vmw_view_rt
] = sizeof(SVGA3dCmdDXDefineRenderTargetView
),
326 [vmw_view_ds
] = sizeof(SVGA3dCmdDXDefineDepthStencilView
)
329 struct vmw_private
*dev_priv
= ctx
->dev_priv
;
330 struct vmw_resource
*res
;
331 struct vmw_view
*view
;
332 struct ttm_operation_ctx ttm_opt_ctx
= {
333 .interruptible
= true,
339 if (cmd_size
!= vmw_view_define_sizes
[view_type
] +
340 sizeof(SVGA3dCmdHeader
)) {
341 DRM_ERROR("Illegal view create command size.\n");
345 if (!vmw_view_id_ok(user_key
, view_type
)) {
346 DRM_ERROR("Illegal view add view id.\n");
350 size
= offsetof(struct vmw_view
, cmd
) + cmd_size
;
352 ret
= ttm_mem_global_alloc(vmw_mem_glob(dev_priv
), size
, &ttm_opt_ctx
);
354 if (ret
!= -ERESTARTSYS
)
355 DRM_ERROR("Out of graphics memory for view"
360 view
= kmalloc(size
, GFP_KERNEL
);
362 ttm_mem_global_free(vmw_mem_glob(dev_priv
), size
);
368 view
->srf
= vmw_resource_reference(srf
);
369 view
->cotable
= vmw_resource_reference
370 (vmw_context_cotable(ctx
, vmw_view_cotables
[view_type
]));
371 view
->view_type
= view_type
;
372 view
->view_id
= user_key
;
373 view
->cmd_size
= cmd_size
;
374 view
->committed
= false;
375 INIT_LIST_HEAD(&view
->srf_head
);
376 INIT_LIST_HEAD(&view
->cotable_head
);
377 memcpy(&view
->cmd
, cmd
, cmd_size
);
378 ret
= vmw_resource_init(dev_priv
, res
, true,
379 vmw_view_res_free
, &vmw_view_func
);
381 goto out_resource_init
;
383 ret
= vmw_cmdbuf_res_add(man
, vmw_cmdbuf_res_view
,
384 vmw_view_key(user_key
, view_type
),
387 goto out_resource_init
;
389 res
->id
= view
->view_id
;
390 res
->hw_destroy
= vmw_hw_view_destroy
;
393 vmw_resource_unreference(&res
);
399 * vmw_view_remove - Stage a view for removal.
401 * @man: Pointer to the view manager identifying the shader namespace.
402 * @user_key: The key that is used to identify the view. The key is
403 * unique to the view type.
404 * @view_type: View type
405 * @list: Caller's list of staged command buffer resource actions.
406 * @res_p: If the resource is in an already committed state, points to the
407 * struct vmw_resource on successful return. The pointer will be
410 int vmw_view_remove(struct vmw_cmdbuf_res_manager
*man
,
411 u32 user_key
, enum vmw_view_type view_type
,
412 struct list_head
*list
,
413 struct vmw_resource
**res_p
)
415 if (!vmw_view_id_ok(user_key
, view_type
)) {
416 DRM_ERROR("Illegal view remove view id.\n");
420 return vmw_cmdbuf_res_remove(man
, vmw_cmdbuf_res_view
,
421 vmw_view_key(user_key
, view_type
),
426 * vmw_view_cotable_list_destroy - Evict all views belonging to a cotable.
428 * @dev_priv: Pointer to a device private struct.
429 * @list: List of views belonging to a cotable.
430 * @readback: Unused. Needed for function interface only.
432 * This function evicts all views belonging to a cotable.
433 * It must be called with the binding_mutex held, and the caller must hold
434 * a reference to the view resource. This is typically called before the
435 * cotable is paged out.
437 void vmw_view_cotable_list_destroy(struct vmw_private
*dev_priv
,
438 struct list_head
*list
,
441 struct vmw_view
*entry
, *next
;
443 lockdep_assert_held_once(&dev_priv
->binding_mutex
);
445 list_for_each_entry_safe(entry
, next
, list
, cotable_head
)
446 WARN_ON(vmw_view_destroy(&entry
->res
));
450 * vmw_view_surface_list_destroy - Evict all views pointing to a surface
452 * @dev_priv: Pointer to a device private struct.
453 * @list: List of views pointing to a surface.
455 * This function evicts all views pointing to a surface. This is typically
456 * called before the surface is evicted.
458 void vmw_view_surface_list_destroy(struct vmw_private
*dev_priv
,
459 struct list_head
*list
)
461 struct vmw_view
*entry
, *next
;
463 lockdep_assert_held_once(&dev_priv
->binding_mutex
);
465 list_for_each_entry_safe(entry
, next
, list
, srf_head
)
466 WARN_ON(vmw_view_destroy(&entry
->res
));
470 * vmw_view_srf - Return a non-refcounted pointer to the surface a view is
473 * @res: pointer to a view resource.
475 * Note that the view itself is holding a reference, so as long
476 * the view resource is alive, the surface resource will be.
478 struct vmw_resource
*vmw_view_srf(struct vmw_resource
*res
)
480 return vmw_view(res
)->srf
;
484 * vmw_view_lookup - Look up a view.
486 * @man: The context's cmdbuf ref manager.
487 * @view_type: The view type.
488 * @user_key: The view user id.
490 * returns a refcounted pointer to a view or an error pointer if not found.
492 struct vmw_resource
*vmw_view_lookup(struct vmw_cmdbuf_res_manager
*man
,
493 enum vmw_view_type view_type
,
496 return vmw_cmdbuf_res_lookup(man
, vmw_cmdbuf_res_view
,
497 vmw_view_key(user_key
, view_type
));
500 const u32 vmw_view_destroy_cmds
[] = {
501 [vmw_view_sr
] = SVGA_3D_CMD_DX_DESTROY_SHADERRESOURCE_VIEW
,
502 [vmw_view_rt
] = SVGA_3D_CMD_DX_DESTROY_RENDERTARGET_VIEW
,
503 [vmw_view_ds
] = SVGA_3D_CMD_DX_DESTROY_DEPTHSTENCIL_VIEW
,
506 const SVGACOTableType vmw_view_cotables
[] = {
507 [vmw_view_sr
] = SVGA_COTABLE_SRVIEW
,
508 [vmw_view_rt
] = SVGA_COTABLE_RTVIEW
,
509 [vmw_view_ds
] = SVGA_COTABLE_DSVIEW
,
512 const SVGACOTableType vmw_so_cotables
[] = {
513 [vmw_so_el
] = SVGA_COTABLE_ELEMENTLAYOUT
,
514 [vmw_so_bs
] = SVGA_COTABLE_BLENDSTATE
,
515 [vmw_so_ds
] = SVGA_COTABLE_DEPTHSTENCIL
,
516 [vmw_so_rs
] = SVGA_COTABLE_RASTERIZERSTATE
,
517 [vmw_so_ss
] = SVGA_COTABLE_SAMPLER
,
518 [vmw_so_so
] = SVGA_COTABLE_STREAMOUTPUT
522 /* To remove unused function warning */
523 static void vmw_so_build_asserts(void) __attribute__((used
));
527 * This function is unused at run-time, and only used to dump various build
528 * asserts important for code optimization assumptions.
530 static void vmw_so_build_asserts(void)
532 /* Assert that our vmw_view_cmd_to_type() function is correct. */
533 BUILD_BUG_ON(SVGA_3D_CMD_DX_DESTROY_SHADERRESOURCE_VIEW
!=
534 SVGA_3D_CMD_DX_DEFINE_SHADERRESOURCE_VIEW
+ 1);
535 BUILD_BUG_ON(SVGA_3D_CMD_DX_DEFINE_RENDERTARGET_VIEW
!=
536 SVGA_3D_CMD_DX_DEFINE_SHADERRESOURCE_VIEW
+ 2);
537 BUILD_BUG_ON(SVGA_3D_CMD_DX_DESTROY_RENDERTARGET_VIEW
!=
538 SVGA_3D_CMD_DX_DEFINE_SHADERRESOURCE_VIEW
+ 3);
539 BUILD_BUG_ON(SVGA_3D_CMD_DX_DEFINE_DEPTHSTENCIL_VIEW
!=
540 SVGA_3D_CMD_DX_DEFINE_SHADERRESOURCE_VIEW
+ 4);
541 BUILD_BUG_ON(SVGA_3D_CMD_DX_DESTROY_DEPTHSTENCIL_VIEW
!=
542 SVGA_3D_CMD_DX_DEFINE_SHADERRESOURCE_VIEW
+ 5);
544 /* Assert that our "one body fits all" assumption is valid */
545 BUILD_BUG_ON(sizeof(union vmw_view_destroy
) != sizeof(u32
));
547 /* Assert that the view key space can hold all view ids. */
548 BUILD_BUG_ON(SVGA_COTABLE_MAX_IDS
>= ((1 << 20) - 1));
551 * Assert that the offset of sid in all view define commands
552 * is what we assume it to be.
554 BUILD_BUG_ON(offsetof(struct vmw_view_define
, sid
) !=
555 offsetof(SVGA3dCmdDXDefineShaderResourceView
, sid
));
556 BUILD_BUG_ON(offsetof(struct vmw_view_define
, sid
) !=
557 offsetof(SVGA3dCmdDXDefineRenderTargetView
, sid
));
558 BUILD_BUG_ON(offsetof(struct vmw_view_define
, sid
) !=
559 offsetof(SVGA3dCmdDXDefineDepthStencilView
, sid
));