Linux Audio

Check our new training course

Loading...
v6.13.7
   1// SPDX-License-Identifier: GPL-2.0 OR MIT
   2/**************************************************************************
   3 *
   4 * Copyright (c) 2009-2024 Broadcom. All Rights Reserved. The term
   5 * “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
   6 *
   7 * Permission is hereby granted, free of charge, to any person obtaining a
   8 * copy of this software and associated documentation files (the
   9 * "Software"), to deal in the Software without restriction, including
  10 * without limitation the rights to use, copy, modify, merge, publish,
  11 * distribute, sub license, and/or sell copies of the Software, and to
  12 * permit persons to whom the Software is furnished to do so, subject to
  13 * the following conditions:
  14 *
  15 * The above copyright notice and this permission notice (including the
  16 * next paragraph) shall be included in all copies or substantial portions
  17 * of the Software.
  18 *
  19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  22 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
  23 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  24 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  25 * USE OR OTHER DEALINGS IN THE SOFTWARE.
  26 *
  27 **************************************************************************/
  28
  29#include "vmwgfx_bo.h"
 
  30#include "vmwgfx_drv.h"
  31#include "vmwgfx_resource_priv.h"
  32#include "vmwgfx_so.h"
  33#include "vmwgfx_binding.h"
  34#include "vmw_surface_cache.h"
  35#include "device_include/svga3d_surfacedefs.h"
  36
  37#include <drm/ttm/ttm_placement.h>
  38
  39#define SVGA3D_FLAGS_64(upper32, lower32) (((uint64_t)upper32 << 32) | lower32)
 
 
 
  40
  41/**
  42 * struct vmw_user_surface - User-space visible surface resource
  43 *
  44 * @prime:          The TTM prime object.
  45 * @srf:            The surface metadata.
  46 * @master:         Master of the creating client. Used for security check.
 
  47 */
  48struct vmw_user_surface {
  49	struct ttm_prime_object prime;
  50	struct vmw_surface srf;
 
  51	struct drm_master *master;
 
  52};
  53
  54/**
  55 * struct vmw_surface_offset - Backing store mip level offset info
  56 *
  57 * @face:           Surface face.
  58 * @mip:            Mip level.
  59 * @bo_offset:      Offset into backing store of this mip level.
  60 *
  61 */
  62struct vmw_surface_offset {
  63	uint32_t face;
  64	uint32_t mip;
  65	uint32_t bo_offset;
  66};
  67
  68/**
  69 * struct vmw_surface_dirty - Surface dirty-tracker
  70 * @cache: Cached layout information of the surface.
  71 * @num_subres: Number of subresources.
  72 * @boxes: Array of SVGA3dBoxes indicating dirty regions. One per subresource.
  73 */
  74struct vmw_surface_dirty {
  75	struct vmw_surface_cache cache;
  76	u32 num_subres;
  77	SVGA3dBox boxes[] __counted_by(num_subres);
  78};
  79
  80static void vmw_user_surface_free(struct vmw_resource *res);
  81static struct vmw_resource *
  82vmw_user_surface_base_to_res(struct ttm_base_object *base);
  83static int vmw_legacy_srf_bind(struct vmw_resource *res,
  84			       struct ttm_validate_buffer *val_buf);
  85static int vmw_legacy_srf_unbind(struct vmw_resource *res,
  86				 bool readback,
  87				 struct ttm_validate_buffer *val_buf);
  88static int vmw_legacy_srf_create(struct vmw_resource *res);
  89static int vmw_legacy_srf_destroy(struct vmw_resource *res);
  90static int vmw_gb_surface_create(struct vmw_resource *res);
  91static int vmw_gb_surface_bind(struct vmw_resource *res,
  92			       struct ttm_validate_buffer *val_buf);
  93static int vmw_gb_surface_unbind(struct vmw_resource *res,
  94				 bool readback,
  95				 struct ttm_validate_buffer *val_buf);
  96static int vmw_gb_surface_destroy(struct vmw_resource *res);
  97static int
  98vmw_gb_surface_define_internal(struct drm_device *dev,
  99			       struct drm_vmw_gb_surface_create_ext_req *req,
 100			       struct drm_vmw_gb_surface_create_rep *rep,
 101			       struct drm_file *file_priv);
 102static int
 103vmw_gb_surface_reference_internal(struct drm_device *dev,
 104				  struct drm_vmw_surface_arg *req,
 105				  struct drm_vmw_gb_surface_ref_ext_rep *rep,
 106				  struct drm_file *file_priv);
 107
 108static void vmw_surface_dirty_free(struct vmw_resource *res);
 109static int vmw_surface_dirty_alloc(struct vmw_resource *res);
 110static int vmw_surface_dirty_sync(struct vmw_resource *res);
 111static void vmw_surface_dirty_range_add(struct vmw_resource *res, size_t start,
 112					size_t end);
 113static int vmw_surface_clean(struct vmw_resource *res);
 114
 115static const struct vmw_user_resource_conv user_surface_conv = {
 116	.object_type = VMW_RES_SURFACE,
 117	.base_obj_to_res = vmw_user_surface_base_to_res,
 118	.res_free = vmw_user_surface_free
 119};
 120
 121const struct vmw_user_resource_conv *user_surface_converter =
 122	&user_surface_conv;
 123
 
 
 
 124static const struct vmw_res_func vmw_legacy_surface_func = {
 125	.res_type = vmw_res_surface,
 126	.needs_guest_memory = false,
 127	.may_evict = true,
 128	.prio = 1,
 129	.dirty_prio = 1,
 130	.type_name = "legacy surfaces",
 131	.domain = VMW_BO_DOMAIN_GMR,
 132	.busy_domain = VMW_BO_DOMAIN_GMR | VMW_BO_DOMAIN_VRAM,
 133	.create = &vmw_legacy_srf_create,
 134	.destroy = &vmw_legacy_srf_destroy,
 135	.bind = &vmw_legacy_srf_bind,
 136	.unbind = &vmw_legacy_srf_unbind
 137};
 138
 139static const struct vmw_res_func vmw_gb_surface_func = {
 140	.res_type = vmw_res_surface,
 141	.needs_guest_memory = true,
 142	.may_evict = true,
 143	.prio = 1,
 144	.dirty_prio = 2,
 145	.type_name = "guest backed surfaces",
 146	.domain = VMW_BO_DOMAIN_MOB,
 147	.busy_domain = VMW_BO_DOMAIN_MOB,
 148	.create = vmw_gb_surface_create,
 149	.destroy = vmw_gb_surface_destroy,
 150	.bind = vmw_gb_surface_bind,
 151	.unbind = vmw_gb_surface_unbind,
 152	.dirty_alloc = vmw_surface_dirty_alloc,
 153	.dirty_free = vmw_surface_dirty_free,
 154	.dirty_sync = vmw_surface_dirty_sync,
 155	.dirty_range_add = vmw_surface_dirty_range_add,
 156	.clean = vmw_surface_clean,
 157};
 158
 159/*
 160 * struct vmw_surface_dma - SVGA3D DMA command
 161 */
 162struct vmw_surface_dma {
 163	SVGA3dCmdHeader header;
 164	SVGA3dCmdSurfaceDMA body;
 165	SVGA3dCopyBox cb;
 166	SVGA3dCmdSurfaceDMASuffix suffix;
 167};
 168
 169/*
 170 * struct vmw_surface_define - SVGA3D Surface Define command
 171 */
 172struct vmw_surface_define {
 173	SVGA3dCmdHeader header;
 174	SVGA3dCmdDefineSurface body;
 175};
 176
 177/*
 178 * struct vmw_surface_destroy - SVGA3D Surface Destroy command
 179 */
 180struct vmw_surface_destroy {
 181	SVGA3dCmdHeader header;
 182	SVGA3dCmdDestroySurface body;
 183};
 184
 185
 186/**
 187 * vmw_surface_dma_size - Compute fifo size for a dma command.
 188 *
 189 * @srf: Pointer to a struct vmw_surface
 190 *
 191 * Computes the required size for a surface dma command for backup or
 192 * restoration of the surface represented by @srf.
 193 */
 194static inline uint32_t vmw_surface_dma_size(const struct vmw_surface *srf)
 195{
 196	return srf->metadata.num_sizes * sizeof(struct vmw_surface_dma);
 197}
 198
 199
 200/**
 201 * vmw_surface_define_size - Compute fifo size for a surface define command.
 202 *
 203 * @srf: Pointer to a struct vmw_surface
 204 *
 205 * Computes the required size for a surface define command for the definition
 206 * of the surface represented by @srf.
 207 */
 208static inline uint32_t vmw_surface_define_size(const struct vmw_surface *srf)
 209{
 210	return sizeof(struct vmw_surface_define) + srf->metadata.num_sizes *
 211		sizeof(SVGA3dSize);
 212}
 213
 214
 215/**
 216 * vmw_surface_destroy_size - Compute fifo size for a surface destroy command.
 217 *
 218 * Computes the required size for a surface destroy command for the destruction
 219 * of a hw surface.
 220 */
 221static inline uint32_t vmw_surface_destroy_size(void)
 222{
 223	return sizeof(struct vmw_surface_destroy);
 224}
 225
 226/**
 227 * vmw_surface_destroy_encode - Encode a surface_destroy command.
 228 *
 229 * @id: The surface id
 230 * @cmd_space: Pointer to memory area in which the commands should be encoded.
 231 */
 232static void vmw_surface_destroy_encode(uint32_t id,
 233				       void *cmd_space)
 234{
 235	struct vmw_surface_destroy *cmd = (struct vmw_surface_destroy *)
 236		cmd_space;
 237
 238	cmd->header.id = SVGA_3D_CMD_SURFACE_DESTROY;
 239	cmd->header.size = sizeof(cmd->body);
 240	cmd->body.sid = id;
 241}
 242
 243/**
 244 * vmw_surface_define_encode - Encode a surface_define command.
 245 *
 246 * @srf: Pointer to a struct vmw_surface object.
 247 * @cmd_space: Pointer to memory area in which the commands should be encoded.
 248 */
 249static void vmw_surface_define_encode(const struct vmw_surface *srf,
 250				      void *cmd_space)
 251{
 252	struct vmw_surface_define *cmd = (struct vmw_surface_define *)
 253		cmd_space;
 254	struct drm_vmw_size *src_size;
 255	SVGA3dSize *cmd_size;
 256	uint32_t cmd_len;
 257	int i;
 258
 259	cmd_len = sizeof(cmd->body) + srf->metadata.num_sizes *
 260		sizeof(SVGA3dSize);
 261
 262	cmd->header.id = SVGA_3D_CMD_SURFACE_DEFINE;
 263	cmd->header.size = cmd_len;
 264	cmd->body.sid = srf->res.id;
 265	/*
 266	 * Downcast of surfaceFlags, was upcasted when received from user-space,
 267	 * since driver internally stores as 64 bit.
 268	 * For legacy surface define only 32 bit flag is supported.
 269	 */
 270	cmd->body.surfaceFlags = (SVGA3dSurface1Flags)srf->metadata.flags;
 271	cmd->body.format = srf->metadata.format;
 272	for (i = 0; i < DRM_VMW_MAX_SURFACE_FACES; ++i)
 273		cmd->body.face[i].numMipLevels = srf->metadata.mip_levels[i];
 274
 275	cmd += 1;
 276	cmd_size = (SVGA3dSize *) cmd;
 277	src_size = srf->metadata.sizes;
 278
 279	for (i = 0; i < srf->metadata.num_sizes; ++i, cmd_size++, src_size++) {
 280		cmd_size->width = src_size->width;
 281		cmd_size->height = src_size->height;
 282		cmd_size->depth = src_size->depth;
 283	}
 284}
 285
 286/**
 287 * vmw_surface_dma_encode - Encode a surface_dma command.
 288 *
 289 * @srf: Pointer to a struct vmw_surface object.
 290 * @cmd_space: Pointer to memory area in which the commands should be encoded.
 291 * @ptr: Pointer to an SVGAGuestPtr indicating where the surface contents
 292 * should be placed or read from.
 293 * @to_surface: Boolean whether to DMA to the surface or from the surface.
 294 */
 295static void vmw_surface_dma_encode(struct vmw_surface *srf,
 296				   void *cmd_space,
 297				   const SVGAGuestPtr *ptr,
 298				   bool to_surface)
 299{
 300	uint32_t i;
 301	struct vmw_surface_dma *cmd = (struct vmw_surface_dma *)cmd_space;
 302	const struct SVGA3dSurfaceDesc *desc =
 303		vmw_surface_get_desc(srf->metadata.format);
 304
 305	for (i = 0; i < srf->metadata.num_sizes; ++i) {
 306		SVGA3dCmdHeader *header = &cmd->header;
 307		SVGA3dCmdSurfaceDMA *body = &cmd->body;
 308		SVGA3dCopyBox *cb = &cmd->cb;
 309		SVGA3dCmdSurfaceDMASuffix *suffix = &cmd->suffix;
 310		const struct vmw_surface_offset *cur_offset = &srf->offsets[i];
 311		const struct drm_vmw_size *cur_size = &srf->metadata.sizes[i];
 312
 313		header->id = SVGA_3D_CMD_SURFACE_DMA;
 314		header->size = sizeof(*body) + sizeof(*cb) + sizeof(*suffix);
 315
 316		body->guest.ptr = *ptr;
 317		body->guest.ptr.offset += cur_offset->bo_offset;
 318		body->guest.pitch = vmw_surface_calculate_pitch(desc, cur_size);
 
 319		body->host.sid = srf->res.id;
 320		body->host.face = cur_offset->face;
 321		body->host.mipmap = cur_offset->mip;
 322		body->transfer = ((to_surface) ?  SVGA3D_WRITE_HOST_VRAM :
 323				  SVGA3D_READ_HOST_VRAM);
 324		cb->x = 0;
 325		cb->y = 0;
 326		cb->z = 0;
 327		cb->srcx = 0;
 328		cb->srcy = 0;
 329		cb->srcz = 0;
 330		cb->w = cur_size->width;
 331		cb->h = cur_size->height;
 332		cb->d = cur_size->depth;
 333
 334		suffix->suffixSize = sizeof(*suffix);
 335		suffix->maximumOffset =
 336			vmw_surface_get_image_buffer_size(desc, cur_size,
 337							    body->guest.pitch);
 338		suffix->flags.discard = 0;
 339		suffix->flags.unsynchronized = 0;
 340		suffix->flags.reserved = 0;
 341		++cmd;
 342	}
 343};
 344
 345
 346/**
 347 * vmw_hw_surface_destroy - destroy a Device surface
 348 *
 349 * @res:        Pointer to a struct vmw_resource embedded in a struct
 350 *              vmw_surface.
 351 *
 352 * Destroys a the device surface associated with a struct vmw_surface if
 353 * any, and adjusts resource count accordingly.
 354 */
 355static void vmw_hw_surface_destroy(struct vmw_resource *res)
 356{
 357
 358	struct vmw_private *dev_priv = res->dev_priv;
 
 359	void *cmd;
 360
 361	if (res->func->destroy == vmw_gb_surface_destroy) {
 362		(void) vmw_gb_surface_destroy(res);
 363		return;
 364	}
 365
 366	if (res->id != -1) {
 367
 368		cmd = VMW_CMD_RESERVE(dev_priv, vmw_surface_destroy_size());
 369		if (unlikely(!cmd))
 370			return;
 371
 372		vmw_surface_destroy_encode(res->id, cmd);
 373		vmw_cmd_commit(dev_priv, vmw_surface_destroy_size());
 374
 375		/*
 376		 * used_memory_size_atomic, or separate lock
 377		 * to avoid taking dev_priv::cmdbuf_mutex in
 378		 * the destroy path.
 379		 */
 380
 381		mutex_lock(&dev_priv->cmdbuf_mutex);
 382		dev_priv->used_memory_size -= res->guest_memory_size;
 
 383		mutex_unlock(&dev_priv->cmdbuf_mutex);
 384	}
 385}
 386
 387/**
 388 * vmw_legacy_srf_create - Create a device surface as part of the
 389 * resource validation process.
 390 *
 391 * @res: Pointer to a struct vmw_surface.
 392 *
 393 * If the surface doesn't have a hw id.
 394 *
 395 * Returns -EBUSY if there wasn't sufficient device resources to
 396 * complete the validation. Retry after freeing up resources.
 397 *
 398 * May return other errors if the kernel is out of guest resources.
 399 */
 400static int vmw_legacy_srf_create(struct vmw_resource *res)
 401{
 402	struct vmw_private *dev_priv = res->dev_priv;
 403	struct vmw_surface *srf;
 404	uint32_t submit_size;
 405	uint8_t *cmd;
 406	int ret;
 407
 408	if (likely(res->id != -1))
 409		return 0;
 410
 411	srf = vmw_res_to_srf(res);
 412	if (unlikely(dev_priv->used_memory_size + res->guest_memory_size >=
 413		     dev_priv->memory_size))
 414		return -EBUSY;
 415
 416	/*
 417	 * Alloc id for the resource.
 418	 */
 419
 420	ret = vmw_resource_alloc_id(res);
 421	if (unlikely(ret != 0)) {
 422		DRM_ERROR("Failed to allocate a surface id.\n");
 423		goto out_no_id;
 424	}
 425
 426	if (unlikely(res->id >= SVGA3D_HB_MAX_SURFACE_IDS)) {
 427		ret = -EBUSY;
 428		goto out_no_fifo;
 429	}
 430
 431	/*
 432	 * Encode surface define- commands.
 433	 */
 434
 435	submit_size = vmw_surface_define_size(srf);
 436	cmd = VMW_CMD_RESERVE(dev_priv, submit_size);
 437	if (unlikely(!cmd)) {
 438		ret = -ENOMEM;
 439		goto out_no_fifo;
 440	}
 441
 442	vmw_surface_define_encode(srf, cmd);
 443	vmw_cmd_commit(dev_priv, submit_size);
 444	vmw_fifo_resource_inc(dev_priv);
 445
 446	/*
 447	 * Surface memory usage accounting.
 448	 */
 449
 450	dev_priv->used_memory_size += res->guest_memory_size;
 451	return 0;
 452
 453out_no_fifo:
 454	vmw_resource_release_id(res);
 455out_no_id:
 456	return ret;
 457}
 458
 459/**
 460 * vmw_legacy_srf_dma - Copy backup data to or from a legacy surface.
 461 *
 462 * @res:            Pointer to a struct vmw_res embedded in a struct
 463 *                  vmw_surface.
 464 * @val_buf:        Pointer to a struct ttm_validate_buffer containing
 465 *                  information about the backup buffer.
 466 * @bind:           Boolean wether to DMA to the surface.
 467 *
 468 * Transfer backup data to or from a legacy surface as part of the
 469 * validation process.
 470 * May return other errors if the kernel is out of guest resources.
 471 * The backup buffer will be fenced or idle upon successful completion,
 472 * and if the surface needs persistent backup storage, the backup buffer
 473 * will also be returned reserved iff @bind is true.
 474 */
 475static int vmw_legacy_srf_dma(struct vmw_resource *res,
 476			      struct ttm_validate_buffer *val_buf,
 477			      bool bind)
 478{
 479	SVGAGuestPtr ptr;
 480	struct vmw_fence_obj *fence;
 481	uint32_t submit_size;
 482	struct vmw_surface *srf = vmw_res_to_srf(res);
 483	uint8_t *cmd;
 484	struct vmw_private *dev_priv = res->dev_priv;
 485
 486	BUG_ON(!val_buf->bo);
 487	submit_size = vmw_surface_dma_size(srf);
 488	cmd = VMW_CMD_RESERVE(dev_priv, submit_size);
 489	if (unlikely(!cmd))
 490		return -ENOMEM;
 491
 492	vmw_bo_get_guest_ptr(val_buf->bo, &ptr);
 493	vmw_surface_dma_encode(srf, cmd, &ptr, bind);
 494
 495	vmw_cmd_commit(dev_priv, submit_size);
 496
 497	/*
 498	 * Create a fence object and fence the backup buffer.
 499	 */
 500
 501	(void) vmw_execbuf_fence_commands(NULL, dev_priv,
 502					  &fence, NULL);
 503
 504	vmw_bo_fence_single(val_buf->bo, fence);
 505
 506	if (likely(fence != NULL))
 507		vmw_fence_obj_unreference(&fence);
 508
 509	return 0;
 510}
 511
 512/**
 513 * vmw_legacy_srf_bind - Perform a legacy surface bind as part of the
 514 *                       surface validation process.
 515 *
 516 * @res:            Pointer to a struct vmw_res embedded in a struct
 517 *                  vmw_surface.
 518 * @val_buf:        Pointer to a struct ttm_validate_buffer containing
 519 *                  information about the backup buffer.
 520 *
 521 * This function will copy backup data to the surface if the
 522 * backup buffer is dirty.
 523 */
 524static int vmw_legacy_srf_bind(struct vmw_resource *res,
 525			       struct ttm_validate_buffer *val_buf)
 526{
 527	if (!res->guest_memory_dirty)
 528		return 0;
 529
 530	return vmw_legacy_srf_dma(res, val_buf, true);
 531}
 532
 533
 534/**
 535 * vmw_legacy_srf_unbind - Perform a legacy surface unbind as part of the
 536 *                         surface eviction process.
 537 *
 538 * @res:            Pointer to a struct vmw_res embedded in a struct
 539 *                  vmw_surface.
 540 * @readback:       Readback - only true if dirty
 541 * @val_buf:        Pointer to a struct ttm_validate_buffer containing
 542 *                  information about the backup buffer.
 543 *
 544 * This function will copy backup data from the surface.
 545 */
 546static int vmw_legacy_srf_unbind(struct vmw_resource *res,
 547				 bool readback,
 548				 struct ttm_validate_buffer *val_buf)
 549{
 550	if (unlikely(readback))
 551		return vmw_legacy_srf_dma(res, val_buf, false);
 552	return 0;
 553}
 554
 555/**
 556 * vmw_legacy_srf_destroy - Destroy a device surface as part of a
 557 *                          resource eviction process.
 558 *
 559 * @res:            Pointer to a struct vmw_res embedded in a struct
 560 *                  vmw_surface.
 561 */
 562static int vmw_legacy_srf_destroy(struct vmw_resource *res)
 563{
 564	struct vmw_private *dev_priv = res->dev_priv;
 565	uint32_t submit_size;
 566	uint8_t *cmd;
 567
 568	BUG_ON(res->id == -1);
 569
 570	/*
 571	 * Encode the dma- and surface destroy commands.
 572	 */
 573
 574	submit_size = vmw_surface_destroy_size();
 575	cmd = VMW_CMD_RESERVE(dev_priv, submit_size);
 576	if (unlikely(!cmd))
 577		return -ENOMEM;
 578
 579	vmw_surface_destroy_encode(res->id, cmd);
 580	vmw_cmd_commit(dev_priv, submit_size);
 581
 582	/*
 583	 * Surface memory usage accounting.
 584	 */
 585
 586	dev_priv->used_memory_size -= res->guest_memory_size;
 587
 588	/*
 589	 * Release the surface ID.
 590	 */
 591
 592	vmw_resource_release_id(res);
 593	vmw_fifo_resource_dec(dev_priv);
 594
 595	return 0;
 596}
 597
 598
 599/**
 600 * vmw_surface_init - initialize a struct vmw_surface
 601 *
 602 * @dev_priv:       Pointer to a device private struct.
 603 * @srf:            Pointer to the struct vmw_surface to initialize.
 604 * @res_free:       Pointer to a resource destructor used to free
 605 *                  the object.
 606 */
 607static int vmw_surface_init(struct vmw_private *dev_priv,
 608			    struct vmw_surface *srf,
 609			    void (*res_free) (struct vmw_resource *res))
 610{
 611	int ret;
 612	struct vmw_resource *res = &srf->res;
 613
 614	BUG_ON(!res_free);
 615	ret = vmw_resource_init(dev_priv, res, true, res_free,
 616				(dev_priv->has_mob) ? &vmw_gb_surface_func :
 617				&vmw_legacy_surface_func);
 618
 619	if (unlikely(ret != 0)) {
 620		res_free(res);
 621		return ret;
 622	}
 623
 624	/*
 625	 * The surface won't be visible to hardware until a
 626	 * surface validate.
 627	 */
 628
 629	INIT_LIST_HEAD(&srf->view_list);
 630	res->hw_destroy = vmw_hw_surface_destroy;
 631	return ret;
 632}
 633
 634/**
 635 * vmw_user_surface_base_to_res - TTM base object to resource converter for
 636 *                                user visible surfaces
 637 *
 638 * @base:           Pointer to a TTM base object
 639 *
 640 * Returns the struct vmw_resource embedded in a struct vmw_surface
 641 * for the user-visible object identified by the TTM base object @base.
 642 */
 643static struct vmw_resource *
 644vmw_user_surface_base_to_res(struct ttm_base_object *base)
 645{
 646	return &(container_of(base, struct vmw_user_surface,
 647			      prime.base)->srf.res);
 648}
 649
 650/**
 651 * vmw_user_surface_free - User visible surface resource destructor
 652 *
 653 * @res:            A struct vmw_resource embedded in a struct vmw_surface.
 654 */
 655static void vmw_user_surface_free(struct vmw_resource *res)
 656{
 657	struct vmw_surface *srf = vmw_res_to_srf(res);
 658	struct vmw_user_surface *user_srf =
 659	    container_of(srf, struct vmw_user_surface, srf);
 
 
 660
 661	WARN_ON_ONCE(res->dirty);
 662	if (user_srf->master)
 663		drm_master_put(&user_srf->master);
 664	kfree(srf->offsets);
 665	kfree(srf->metadata.sizes);
 666	kfree(srf->snooper.image);
 667	ttm_prime_object_kfree(user_srf, prime);
 
 668}
 669
 670/**
 671 * vmw_user_surface_base_release - User visible surface TTM base object destructor
 672 *
 673 * @p_base:         Pointer to a pointer to a TTM base object
 674 *                  embedded in a struct vmw_user_surface.
 675 *
 676 * Drops the base object's reference on its resource, and the
 677 * pointer pointed to by *p_base is set to NULL.
 678 */
 679static void vmw_user_surface_base_release(struct ttm_base_object **p_base)
 680{
 681	struct ttm_base_object *base = *p_base;
 682	struct vmw_user_surface *user_srf =
 683	    container_of(base, struct vmw_user_surface, prime.base);
 684	struct vmw_resource *res = &user_srf->srf.res;
 685
 686	*p_base = NULL;
 687
 688	/*
 689	 * Dumb buffers own the resource and they'll unref the
 690	 * resource themselves
 691	 */
 692	if (res && res->guest_memory_bo && res->guest_memory_bo->is_dumb)
 693		return;
 694
 695	vmw_resource_unreference(&res);
 696}
 697
 698/**
 699 * vmw_surface_destroy_ioctl - Ioctl function implementing
 700 *                                  the user surface destroy functionality.
 701 *
 702 * @dev:            Pointer to a struct drm_device.
 703 * @data:           Pointer to data copied from / to user-space.
 704 * @file_priv:      Pointer to a drm file private structure.
 705 */
 706int vmw_surface_destroy_ioctl(struct drm_device *dev, void *data,
 707			      struct drm_file *file_priv)
 708{
 709	struct drm_vmw_surface_arg *arg = (struct drm_vmw_surface_arg *)data;
 710	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 711
 712	return ttm_ref_object_base_unref(tfile, arg->sid);
 713}
 714
 715/**
 716 * vmw_surface_define_ioctl - Ioctl function implementing
 717 *                                  the user surface define functionality.
 718 *
 719 * @dev:            Pointer to a struct drm_device.
 720 * @data:           Pointer to data copied from / to user-space.
 721 * @file_priv:      Pointer to a drm file private structure.
 722 */
 723int vmw_surface_define_ioctl(struct drm_device *dev, void *data,
 724			     struct drm_file *file_priv)
 725{
 726	struct vmw_private *dev_priv = vmw_priv(dev);
 727	struct vmw_user_surface *user_srf;
 728	struct vmw_surface *srf;
 729	struct vmw_surface_metadata *metadata;
 730	struct vmw_resource *res;
 731	struct vmw_resource *tmp;
 732	union drm_vmw_surface_create_arg *arg =
 733	    (union drm_vmw_surface_create_arg *)data;
 734	struct drm_vmw_surface_create_req *req = &arg->req;
 735	struct drm_vmw_surface_arg *rep = &arg->rep;
 736	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 
 
 
 
 737	int ret;
 738	int i, j;
 739	uint32_t cur_bo_offset;
 740	struct drm_vmw_size *cur_size;
 741	struct vmw_surface_offset *cur_offset;
 742	uint32_t num_sizes;
 743	const SVGA3dSurfaceDesc *desc;
 
 
 
 
 
 744
 745	num_sizes = 0;
 746	for (i = 0; i < DRM_VMW_MAX_SURFACE_FACES; ++i) {
 747		if (req->mip_levels[i] > DRM_VMW_MAX_MIP_LEVELS)
 748			return -EINVAL;
 749		num_sizes += req->mip_levels[i];
 750	}
 751
 752	if (num_sizes > DRM_VMW_MAX_SURFACE_FACES * DRM_VMW_MAX_MIP_LEVELS ||
 753	    num_sizes == 0)
 754		return -EINVAL;
 755
 756	desc = vmw_surface_get_desc(req->format);
 757	if (unlikely(desc->blockDesc == SVGA3DBLOCKDESC_NONE)) {
 
 
 
 
 758		VMW_DEBUG_USER("Invalid format %d for surface creation.\n",
 759			       req->format);
 760		return -EINVAL;
 761	}
 762
 
 
 
 
 
 
 
 
 
 
 
 
 763	user_srf = kzalloc(sizeof(*user_srf), GFP_KERNEL);
 764	if (unlikely(!user_srf)) {
 765		ret = -ENOMEM;
 766		goto out_unlock;
 767	}
 768
 769	srf = &user_srf->srf;
 770	metadata = &srf->metadata;
 771	res = &srf->res;
 772
 773	/* Driver internally stores as 64-bit flags */
 774	metadata->flags = (SVGA3dSurfaceAllFlags)req->flags;
 775	metadata->format = req->format;
 776	metadata->scanout = req->scanout;
 777
 778	memcpy(metadata->mip_levels, req->mip_levels,
 779	       sizeof(metadata->mip_levels));
 780	metadata->num_sizes = num_sizes;
 781	metadata->sizes =
 782		memdup_array_user((struct drm_vmw_size __user *)(unsigned long)
 783			    req->size_addr,
 784			    metadata->num_sizes, sizeof(*metadata->sizes));
 785	if (IS_ERR(metadata->sizes)) {
 786		ret = PTR_ERR(metadata->sizes);
 787		goto out_no_sizes;
 788	}
 789	srf->offsets = kmalloc_array(metadata->num_sizes, sizeof(*srf->offsets),
 
 790				     GFP_KERNEL);
 791	if (unlikely(!srf->offsets)) {
 792		ret = -ENOMEM;
 793		goto out_no_offsets;
 794	}
 795
 796	metadata->base_size = *srf->metadata.sizes;
 797	metadata->autogen_filter = SVGA3D_TEX_FILTER_NONE;
 798	metadata->multisample_count = 0;
 799	metadata->multisample_pattern = SVGA3D_MS_PATTERN_NONE;
 800	metadata->quality_level = SVGA3D_MS_QUALITY_NONE;
 801
 802	cur_bo_offset = 0;
 803	cur_offset = srf->offsets;
 804	cur_size = metadata->sizes;
 805
 806	for (i = 0; i < DRM_VMW_MAX_SURFACE_FACES; ++i) {
 807		for (j = 0; j < metadata->mip_levels[i]; ++j) {
 808			uint32_t stride = vmw_surface_calculate_pitch(
 809						  desc, cur_size);
 810
 811			cur_offset->face = i;
 812			cur_offset->mip = j;
 813			cur_offset->bo_offset = cur_bo_offset;
 814			cur_bo_offset += vmw_surface_get_image_buffer_size
 815				(desc, cur_size, stride);
 816			++cur_offset;
 817			++cur_size;
 818		}
 819	}
 820	res->guest_memory_size = cur_bo_offset;
 821	if (!file_priv->atomic &&
 822	    metadata->scanout &&
 823	    metadata->num_sizes == 1 &&
 824	    metadata->sizes[0].width == VMW_CURSOR_SNOOP_WIDTH &&
 825	    metadata->sizes[0].height == VMW_CURSOR_SNOOP_HEIGHT &&
 826	    metadata->format == VMW_CURSOR_SNOOP_FORMAT) {
 827		const struct SVGA3dSurfaceDesc *desc =
 828			vmw_surface_get_desc(VMW_CURSOR_SNOOP_FORMAT);
 829		const u32 cursor_size_bytes = VMW_CURSOR_SNOOP_WIDTH *
 830					      VMW_CURSOR_SNOOP_HEIGHT *
 831					      desc->pitchBytesPerBlock;
 832		srf->snooper.image = kzalloc(cursor_size_bytes, GFP_KERNEL);
 833		if (!srf->snooper.image) {
 834			DRM_ERROR("Failed to allocate cursor_image\n");
 835			ret = -ENOMEM;
 836			goto out_no_copy;
 837		}
 838	} else {
 839		srf->snooper.image = NULL;
 840	}
 841
 
 
 842	if (drm_is_primary_client(file_priv))
 843		user_srf->master = drm_file_get_master(file_priv);
 844
 845	/**
 846	 * From this point, the generic resource management functions
 847	 * destroy the object on failure.
 848	 */
 849
 850	ret = vmw_surface_init(dev_priv, srf, vmw_user_surface_free);
 851	if (unlikely(ret != 0))
 852		goto out_unlock;
 853
 854	/*
 855	 * A gb-aware client referencing a surface will expect a backup
 856	 * buffer to be present.
 857	 */
 858	if (dev_priv->has_mob) {
 859		struct vmw_bo_params params = {
 860			.domain = VMW_BO_DOMAIN_SYS,
 861			.busy_domain = VMW_BO_DOMAIN_SYS,
 862			.bo_type = ttm_bo_type_device,
 863			.size = res->guest_memory_size,
 864			.pin = false
 865		};
 866
 867		ret = vmw_gem_object_create(dev_priv,
 868					    &params,
 869					    &res->guest_memory_bo);
 870		if (unlikely(ret != 0)) {
 871			vmw_resource_unreference(&res);
 872			goto out_unlock;
 873		}
 874		vmw_bo_add_detached_resource(res->guest_memory_bo, res);
 875	}
 876
 877	tmp = vmw_resource_reference(&srf->res);
 878	ret = ttm_prime_object_init(tfile, res->guest_memory_size,
 879				    &user_srf->prime,
 880				    VMW_RES_SURFACE,
 881				    &vmw_user_surface_base_release);
 882
 883	if (unlikely(ret != 0)) {
 884		vmw_resource_unreference(&tmp);
 885		vmw_resource_unreference(&res);
 886		goto out_unlock;
 887	}
 888
 889	rep->sid = user_srf->prime.base.handle;
 890	vmw_resource_unreference(&res);
 891
 
 892	return 0;
 893out_no_copy:
 894	kfree(srf->offsets);
 895out_no_offsets:
 896	kfree(metadata->sizes);
 897out_no_sizes:
 898	ttm_prime_object_kfree(user_srf, prime);
 
 
 899out_unlock:
 
 900	return ret;
 901}
 902
 903static struct vmw_user_surface *
 904vmw_lookup_user_surface_for_buffer(struct vmw_private *vmw, struct vmw_bo *bo,
 905				   u32 handle)
 906{
 907	struct vmw_user_surface *user_srf = NULL;
 908	struct vmw_surface *surf;
 909	struct ttm_base_object *base;
 910
 911	surf = vmw_bo_surface(bo);
 912	if (surf) {
 913		rcu_read_lock();
 914		user_srf = container_of(surf, struct vmw_user_surface, srf);
 915		base = &user_srf->prime.base;
 916		if (base && !kref_get_unless_zero(&base->refcount)) {
 917			drm_dbg_driver(&vmw->drm,
 918				       "%s: referencing a stale surface handle %d\n",
 919					__func__, handle);
 920			base = NULL;
 921			user_srf = NULL;
 922		}
 923		rcu_read_unlock();
 924	}
 925
 926	return user_srf;
 927}
 928
 929struct vmw_surface *vmw_lookup_surface_for_buffer(struct vmw_private *vmw,
 930						  struct vmw_bo *bo,
 931						  u32 handle)
 932{
 933	struct vmw_user_surface *user_srf =
 934		vmw_lookup_user_surface_for_buffer(vmw, bo, handle);
 935	struct vmw_surface *surf = NULL;
 936	struct ttm_base_object *base;
 937
 938	if (user_srf) {
 939		surf = vmw_surface_reference(&user_srf->srf);
 940		base = &user_srf->prime.base;
 941		ttm_base_object_unref(&base);
 942	}
 943	return surf;
 944}
 945
 946u32 vmw_lookup_surface_handle_for_buffer(struct vmw_private *vmw,
 947					 struct vmw_bo *bo,
 948					 u32 handle)
 949{
 950	struct vmw_user_surface *user_srf =
 951		vmw_lookup_user_surface_for_buffer(vmw, bo, handle);
 952	int surf_handle = 0;
 953	struct ttm_base_object *base;
 954
 955	if (user_srf) {
 956		base = &user_srf->prime.base;
 957		surf_handle = (u32)base->handle;
 958		ttm_base_object_unref(&base);
 959	}
 960	return surf_handle;
 961}
 962
 963static int vmw_buffer_prime_to_surface_base(struct vmw_private *dev_priv,
 964					    struct drm_file *file_priv,
 965					    u32 fd, u32 *handle,
 966					    struct ttm_base_object **base_p)
 967{
 968	struct ttm_base_object *base;
 969	struct vmw_bo *bo;
 970	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 971	struct vmw_user_surface *user_srf;
 972	int ret;
 973
 974	ret = drm_gem_prime_fd_to_handle(&dev_priv->drm, file_priv, fd, handle);
 975	if (ret) {
 976		drm_warn(&dev_priv->drm,
 977			 "Wasn't able to find user buffer for fd = %u.\n", fd);
 978		return ret;
 979	}
 980
 981	ret = vmw_user_bo_lookup(file_priv, *handle, &bo);
 982	if (ret) {
 983		drm_warn(&dev_priv->drm,
 984			 "Wasn't able to lookup user buffer for handle = %u.\n", *handle);
 985		return ret;
 986	}
 987
 988	user_srf = vmw_lookup_user_surface_for_buffer(dev_priv, bo, *handle);
 989	if (WARN_ON(!user_srf)) {
 990		drm_warn(&dev_priv->drm,
 991			 "User surface fd %d (handle %d) is null.\n", fd, *handle);
 992		ret = -EINVAL;
 993		goto out;
 994	}
 995
 996	base = &user_srf->prime.base;
 997	ret = ttm_ref_object_add(tfile, base, NULL, false);
 998	if (ret) {
 999		drm_warn(&dev_priv->drm,
1000			 "Couldn't add an object ref for the buffer (%d).\n", *handle);
1001		goto out;
1002	}
1003
1004	*base_p = base;
1005out:
1006	vmw_user_bo_unref(&bo);
1007
1008	return ret;
1009}
1010
1011static int
1012vmw_surface_handle_reference(struct vmw_private *dev_priv,
1013			     struct drm_file *file_priv,
1014			     uint32_t u_handle,
1015			     enum drm_vmw_handle_type handle_type,
1016			     struct ttm_base_object **base_p)
1017{
1018	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
1019	struct vmw_user_surface *user_srf = NULL;
1020	uint32_t handle;
1021	struct ttm_base_object *base;
1022	int ret;
 
1023
1024	if (handle_type == DRM_VMW_HANDLE_PRIME) {
1025		ret = ttm_prime_fd_to_handle(tfile, u_handle, &handle);
1026		if (ret)
1027			return vmw_buffer_prime_to_surface_base(dev_priv,
1028								file_priv,
1029								u_handle,
1030								&handle,
1031								base_p);
1032	} else {
 
 
 
1033		handle = u_handle;
1034	}
1035
1036	ret = -EINVAL;
1037	base = ttm_base_object_lookup_for_ref(dev_priv->tdev, handle);
1038	if (unlikely(!base)) {
1039		VMW_DEBUG_USER("Could not find surface to reference.\n");
1040		goto out_no_lookup;
1041	}
1042
1043	if (unlikely(ttm_base_object_type(base) != VMW_RES_SURFACE)) {
1044		VMW_DEBUG_USER("Referenced object is not a surface.\n");
1045		goto out_bad_resource;
1046	}
1047	if (handle_type != DRM_VMW_HANDLE_PRIME) {
1048		bool require_exist = false;
1049
 
1050		user_srf = container_of(base, struct vmw_user_surface,
1051					prime.base);
1052
1053		/* Error out if we are unauthenticated primary */
1054		if (drm_is_primary_client(file_priv) &&
1055		    !file_priv->authenticated) {
1056			ret = -EACCES;
1057			goto out_bad_resource;
1058		}
1059
1060		/*
1061		 * Make sure the surface creator has the same
1062		 * authenticating master, or is already registered with us.
1063		 */
1064		if (drm_is_primary_client(file_priv) &&
1065		    user_srf->master != file_priv->master)
1066			require_exist = true;
1067
1068		if (unlikely(drm_is_render_client(file_priv)))
1069			require_exist = true;
1070
1071		ret = ttm_ref_object_add(tfile, base, NULL, require_exist);
1072		if (unlikely(ret != 0)) {
1073			DRM_ERROR("Could not add a reference to a surface.\n");
1074			goto out_bad_resource;
1075		}
1076	}
1077
1078	*base_p = base;
1079	return 0;
1080
1081out_bad_resource:
1082	ttm_base_object_unref(&base);
1083out_no_lookup:
1084	if (handle_type == DRM_VMW_HANDLE_PRIME)
1085		(void) ttm_ref_object_base_unref(tfile, handle);
1086
1087	return ret;
1088}
1089
1090/**
1091 * vmw_surface_reference_ioctl - Ioctl function implementing
1092 *                                  the user surface reference functionality.
1093 *
1094 * @dev:            Pointer to a struct drm_device.
1095 * @data:           Pointer to data copied from / to user-space.
1096 * @file_priv:      Pointer to a drm file private structure.
1097 */
1098int vmw_surface_reference_ioctl(struct drm_device *dev, void *data,
1099				struct drm_file *file_priv)
1100{
1101	struct vmw_private *dev_priv = vmw_priv(dev);
1102	union drm_vmw_surface_reference_arg *arg =
1103	    (union drm_vmw_surface_reference_arg *)data;
1104	struct drm_vmw_surface_arg *req = &arg->req;
1105	struct drm_vmw_surface_create_req *rep = &arg->rep;
1106	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
1107	struct vmw_surface *srf;
1108	struct vmw_user_surface *user_srf;
1109	struct drm_vmw_size __user *user_sizes;
1110	struct ttm_base_object *base;
1111	int ret;
1112
1113	ret = vmw_surface_handle_reference(dev_priv, file_priv, req->sid,
1114					   req->handle_type, &base);
1115	if (unlikely(ret != 0))
1116		return ret;
1117
1118	user_srf = container_of(base, struct vmw_user_surface, prime.base);
1119	srf = &user_srf->srf;
1120
1121	/* Downcast of flags when sending back to user space */
1122	rep->flags = (uint32_t)srf->metadata.flags;
1123	rep->format = srf->metadata.format;
1124	memcpy(rep->mip_levels, srf->metadata.mip_levels,
1125	       sizeof(srf->metadata.mip_levels));
1126	user_sizes = (struct drm_vmw_size __user *)(unsigned long)
1127	    rep->size_addr;
1128
1129	if (user_sizes)
1130		ret = copy_to_user(user_sizes, &srf->metadata.base_size,
1131				   sizeof(srf->metadata.base_size));
1132	if (unlikely(ret != 0)) {
1133		VMW_DEBUG_USER("copy_to_user failed %p %u\n", user_sizes,
1134			       srf->metadata.num_sizes);
1135		ttm_ref_object_base_unref(tfile, base->handle);
1136		ret = -EFAULT;
1137	}
1138
1139	ttm_base_object_unref(&base);
1140
1141	return ret;
1142}
1143
1144/**
1145 * vmw_gb_surface_create - Encode a surface_define command.
1146 *
1147 * @res:        Pointer to a struct vmw_resource embedded in a struct
1148 *              vmw_surface.
1149 */
1150static int vmw_gb_surface_create(struct vmw_resource *res)
1151{
1152	struct vmw_private *dev_priv = res->dev_priv;
1153	struct vmw_surface *srf = vmw_res_to_srf(res);
1154	struct vmw_surface_metadata *metadata = &srf->metadata;
1155	uint32_t cmd_len, cmd_id, submit_len;
1156	int ret;
1157	struct {
1158		SVGA3dCmdHeader header;
1159		SVGA3dCmdDefineGBSurface body;
1160	} *cmd;
1161	struct {
1162		SVGA3dCmdHeader header;
1163		SVGA3dCmdDefineGBSurface_v2 body;
1164	} *cmd2;
1165	struct {
1166		SVGA3dCmdHeader header;
1167		SVGA3dCmdDefineGBSurface_v3 body;
1168	} *cmd3;
1169	struct {
1170		SVGA3dCmdHeader header;
1171		SVGA3dCmdDefineGBSurface_v4 body;
1172	} *cmd4;
1173
1174	if (likely(res->id != -1))
1175		return 0;
1176
1177	vmw_fifo_resource_inc(dev_priv);
1178	ret = vmw_resource_alloc_id(res);
1179	if (unlikely(ret != 0)) {
1180		DRM_ERROR("Failed to allocate a surface id.\n");
1181		goto out_no_id;
1182	}
1183
1184	if (unlikely(res->id >= VMWGFX_NUM_GB_SURFACE)) {
1185		ret = -EBUSY;
1186		goto out_no_fifo;
1187	}
1188
1189	if (has_sm5_context(dev_priv) && metadata->array_size > 0) {
1190		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE_V4;
1191		cmd_len = sizeof(cmd4->body);
1192		submit_len = sizeof(*cmd4);
1193	} else if (has_sm4_1_context(dev_priv) && metadata->array_size > 0) {
1194		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE_V3;
1195		cmd_len = sizeof(cmd3->body);
1196		submit_len = sizeof(*cmd3);
1197	} else if (metadata->array_size > 0) {
1198		/* VMW_SM_4 support verified at creation time. */
1199		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE_V2;
1200		cmd_len = sizeof(cmd2->body);
1201		submit_len = sizeof(*cmd2);
1202	} else {
1203		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE;
1204		cmd_len = sizeof(cmd->body);
1205		submit_len = sizeof(*cmd);
1206	}
1207
1208	cmd = VMW_CMD_RESERVE(dev_priv, submit_len);
1209	cmd2 = (typeof(cmd2))cmd;
1210	cmd3 = (typeof(cmd3))cmd;
1211	cmd4 = (typeof(cmd4))cmd;
1212	if (unlikely(!cmd)) {
1213		ret = -ENOMEM;
1214		goto out_no_fifo;
1215	}
1216
1217	if (has_sm5_context(dev_priv) && metadata->array_size > 0) {
1218		cmd4->header.id = cmd_id;
1219		cmd4->header.size = cmd_len;
1220		cmd4->body.sid = srf->res.id;
1221		cmd4->body.surfaceFlags = metadata->flags;
1222		cmd4->body.format = metadata->format;
1223		cmd4->body.numMipLevels = metadata->mip_levels[0];
1224		cmd4->body.multisampleCount = metadata->multisample_count;
1225		cmd4->body.multisamplePattern = metadata->multisample_pattern;
1226		cmd4->body.qualityLevel = metadata->quality_level;
1227		cmd4->body.autogenFilter = metadata->autogen_filter;
1228		cmd4->body.size.width = metadata->base_size.width;
1229		cmd4->body.size.height = metadata->base_size.height;
1230		cmd4->body.size.depth = metadata->base_size.depth;
1231		cmd4->body.arraySize = metadata->array_size;
1232		cmd4->body.bufferByteStride = metadata->buffer_byte_stride;
1233	} else if (has_sm4_1_context(dev_priv) && metadata->array_size > 0) {
1234		cmd3->header.id = cmd_id;
1235		cmd3->header.size = cmd_len;
1236		cmd3->body.sid = srf->res.id;
1237		cmd3->body.surfaceFlags = metadata->flags;
1238		cmd3->body.format = metadata->format;
1239		cmd3->body.numMipLevels = metadata->mip_levels[0];
1240		cmd3->body.multisampleCount = metadata->multisample_count;
1241		cmd3->body.multisamplePattern = metadata->multisample_pattern;
1242		cmd3->body.qualityLevel = metadata->quality_level;
1243		cmd3->body.autogenFilter = metadata->autogen_filter;
1244		cmd3->body.size.width = metadata->base_size.width;
1245		cmd3->body.size.height = metadata->base_size.height;
1246		cmd3->body.size.depth = metadata->base_size.depth;
1247		cmd3->body.arraySize = metadata->array_size;
1248	} else if (metadata->array_size > 0) {
1249		cmd2->header.id = cmd_id;
1250		cmd2->header.size = cmd_len;
1251		cmd2->body.sid = srf->res.id;
1252		cmd2->body.surfaceFlags = metadata->flags;
1253		cmd2->body.format = metadata->format;
1254		cmd2->body.numMipLevels = metadata->mip_levels[0];
1255		cmd2->body.multisampleCount = metadata->multisample_count;
1256		cmd2->body.autogenFilter = metadata->autogen_filter;
1257		cmd2->body.size.width = metadata->base_size.width;
1258		cmd2->body.size.height = metadata->base_size.height;
1259		cmd2->body.size.depth = metadata->base_size.depth;
1260		cmd2->body.arraySize = metadata->array_size;
1261	} else {
1262		cmd->header.id = cmd_id;
1263		cmd->header.size = cmd_len;
1264		cmd->body.sid = srf->res.id;
1265		cmd->body.surfaceFlags = metadata->flags;
1266		cmd->body.format = metadata->format;
1267		cmd->body.numMipLevels = metadata->mip_levels[0];
1268		cmd->body.multisampleCount = metadata->multisample_count;
1269		cmd->body.autogenFilter = metadata->autogen_filter;
1270		cmd->body.size.width = metadata->base_size.width;
1271		cmd->body.size.height = metadata->base_size.height;
1272		cmd->body.size.depth = metadata->base_size.depth;
1273	}
1274
1275	vmw_cmd_commit(dev_priv, submit_len);
1276
1277	return 0;
1278
1279out_no_fifo:
1280	vmw_resource_release_id(res);
1281out_no_id:
1282	vmw_fifo_resource_dec(dev_priv);
1283	return ret;
1284}
1285
1286
1287static int vmw_gb_surface_bind(struct vmw_resource *res,
1288			       struct ttm_validate_buffer *val_buf)
1289{
1290	struct vmw_private *dev_priv = res->dev_priv;
1291	struct {
1292		SVGA3dCmdHeader header;
1293		SVGA3dCmdBindGBSurface body;
1294	} *cmd1;
1295	struct {
1296		SVGA3dCmdHeader header;
1297		SVGA3dCmdUpdateGBSurface body;
1298	} *cmd2;
1299	uint32_t submit_size;
1300	struct ttm_buffer_object *bo = val_buf->bo;
1301
1302	BUG_ON(bo->resource->mem_type != VMW_PL_MOB);
1303
1304	submit_size = sizeof(*cmd1) + (res->guest_memory_dirty ? sizeof(*cmd2) : 0);
1305
1306	cmd1 = VMW_CMD_RESERVE(dev_priv, submit_size);
1307	if (unlikely(!cmd1))
1308		return -ENOMEM;
1309
1310	cmd1->header.id = SVGA_3D_CMD_BIND_GB_SURFACE;
1311	cmd1->header.size = sizeof(cmd1->body);
1312	cmd1->body.sid = res->id;
1313	cmd1->body.mobid = bo->resource->start;
1314	if (res->guest_memory_dirty) {
1315		cmd2 = (void *) &cmd1[1];
1316		cmd2->header.id = SVGA_3D_CMD_UPDATE_GB_SURFACE;
1317		cmd2->header.size = sizeof(cmd2->body);
1318		cmd2->body.sid = res->id;
 
1319	}
1320	vmw_cmd_commit(dev_priv, submit_size);
1321
1322	if (res->guest_memory_bo->dirty && res->guest_memory_dirty) {
1323		/* We've just made a full upload. Cear dirty regions. */
1324		vmw_bo_dirty_clear_res(res);
1325	}
1326
1327	res->guest_memory_dirty = false;
1328
1329	return 0;
1330}
1331
1332static int vmw_gb_surface_unbind(struct vmw_resource *res,
1333				 bool readback,
1334				 struct ttm_validate_buffer *val_buf)
1335{
1336	struct vmw_private *dev_priv = res->dev_priv;
1337	struct ttm_buffer_object *bo = val_buf->bo;
1338	struct vmw_fence_obj *fence;
1339
1340	struct {
1341		SVGA3dCmdHeader header;
1342		SVGA3dCmdReadbackGBSurface body;
1343	} *cmd1;
1344	struct {
1345		SVGA3dCmdHeader header;
1346		SVGA3dCmdInvalidateGBSurface body;
1347	} *cmd2;
1348	struct {
1349		SVGA3dCmdHeader header;
1350		SVGA3dCmdBindGBSurface body;
1351	} *cmd3;
1352	uint32_t submit_size;
1353	uint8_t *cmd;
1354
1355
1356	BUG_ON(bo->resource->mem_type != VMW_PL_MOB);
1357
1358	submit_size = sizeof(*cmd3) + (readback ? sizeof(*cmd1) : sizeof(*cmd2));
1359	cmd = VMW_CMD_RESERVE(dev_priv, submit_size);
1360	if (unlikely(!cmd))
1361		return -ENOMEM;
1362
1363	if (readback) {
1364		cmd1 = (void *) cmd;
1365		cmd1->header.id = SVGA_3D_CMD_READBACK_GB_SURFACE;
1366		cmd1->header.size = sizeof(cmd1->body);
1367		cmd1->body.sid = res->id;
1368		cmd3 = (void *) &cmd1[1];
1369	} else {
1370		cmd2 = (void *) cmd;
1371		cmd2->header.id = SVGA_3D_CMD_INVALIDATE_GB_SURFACE;
1372		cmd2->header.size = sizeof(cmd2->body);
1373		cmd2->body.sid = res->id;
1374		cmd3 = (void *) &cmd2[1];
1375	}
1376
1377	cmd3->header.id = SVGA_3D_CMD_BIND_GB_SURFACE;
1378	cmd3->header.size = sizeof(cmd3->body);
1379	cmd3->body.sid = res->id;
1380	cmd3->body.mobid = SVGA3D_INVALID_ID;
1381
1382	vmw_cmd_commit(dev_priv, submit_size);
1383
1384	/*
1385	 * Create a fence object and fence the backup buffer.
1386	 */
1387
1388	(void) vmw_execbuf_fence_commands(NULL, dev_priv,
1389					  &fence, NULL);
1390
1391	vmw_bo_fence_single(val_buf->bo, fence);
1392
1393	if (likely(fence != NULL))
1394		vmw_fence_obj_unreference(&fence);
1395
1396	return 0;
1397}
1398
1399static int vmw_gb_surface_destroy(struct vmw_resource *res)
1400{
1401	struct vmw_private *dev_priv = res->dev_priv;
1402	struct vmw_surface *srf = vmw_res_to_srf(res);
1403	struct {
1404		SVGA3dCmdHeader header;
1405		SVGA3dCmdDestroyGBSurface body;
1406	} *cmd;
1407
1408	if (likely(res->id == -1))
1409		return 0;
1410
1411	mutex_lock(&dev_priv->binding_mutex);
1412	vmw_view_surface_list_destroy(dev_priv, &srf->view_list);
1413	vmw_binding_res_list_scrub(&res->binding_head);
1414
1415	cmd = VMW_CMD_RESERVE(dev_priv, sizeof(*cmd));
1416	if (unlikely(!cmd)) {
1417		mutex_unlock(&dev_priv->binding_mutex);
1418		return -ENOMEM;
1419	}
1420
1421	cmd->header.id = SVGA_3D_CMD_DESTROY_GB_SURFACE;
1422	cmd->header.size = sizeof(cmd->body);
1423	cmd->body.sid = res->id;
1424	vmw_cmd_commit(dev_priv, sizeof(*cmd));
1425	mutex_unlock(&dev_priv->binding_mutex);
1426	vmw_resource_release_id(res);
1427	vmw_fifo_resource_dec(dev_priv);
1428
1429	return 0;
1430}
1431
 
1432/**
1433 * vmw_gb_surface_define_ioctl - Ioctl function implementing
1434 * the user surface define functionality.
1435 *
1436 * @dev: Pointer to a struct drm_device.
1437 * @data: Pointer to data copied from / to user-space.
1438 * @file_priv: Pointer to a drm file private structure.
1439 */
1440int vmw_gb_surface_define_ioctl(struct drm_device *dev, void *data,
1441				struct drm_file *file_priv)
1442{
1443	union drm_vmw_gb_surface_create_arg *arg =
1444	    (union drm_vmw_gb_surface_create_arg *)data;
1445	struct drm_vmw_gb_surface_create_rep *rep = &arg->rep;
1446	struct drm_vmw_gb_surface_create_ext_req req_ext;
1447
1448	req_ext.base = arg->req;
1449	req_ext.version = drm_vmw_gb_surface_v1;
1450	req_ext.svga3d_flags_upper_32_bits = 0;
1451	req_ext.multisample_pattern = SVGA3D_MS_PATTERN_NONE;
1452	req_ext.quality_level = SVGA3D_MS_QUALITY_NONE;
1453	req_ext.buffer_byte_stride = 0;
1454	req_ext.must_be_zero = 0;
1455
1456	return vmw_gb_surface_define_internal(dev, &req_ext, rep, file_priv);
1457}
1458
1459/**
1460 * vmw_gb_surface_reference_ioctl - Ioctl function implementing
1461 * the user surface reference functionality.
1462 *
1463 * @dev: Pointer to a struct drm_device.
1464 * @data: Pointer to data copied from / to user-space.
1465 * @file_priv: Pointer to a drm file private structure.
1466 */
1467int vmw_gb_surface_reference_ioctl(struct drm_device *dev, void *data,
1468				   struct drm_file *file_priv)
1469{
1470	union drm_vmw_gb_surface_reference_arg *arg =
1471	    (union drm_vmw_gb_surface_reference_arg *)data;
1472	struct drm_vmw_surface_arg *req = &arg->req;
1473	struct drm_vmw_gb_surface_ref_rep *rep = &arg->rep;
1474	struct drm_vmw_gb_surface_ref_ext_rep rep_ext;
1475	int ret;
1476
1477	ret = vmw_gb_surface_reference_internal(dev, req, &rep_ext, file_priv);
1478
1479	if (unlikely(ret != 0))
1480		return ret;
1481
1482	rep->creq = rep_ext.creq.base;
1483	rep->crep = rep_ext.crep;
1484
1485	return ret;
1486}
1487
1488/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1489 * vmw_gb_surface_define_ext_ioctl - Ioctl function implementing
1490 * the user surface define functionality.
1491 *
1492 * @dev: Pointer to a struct drm_device.
1493 * @data: Pointer to data copied from / to user-space.
1494 * @file_priv: Pointer to a drm file private structure.
1495 */
1496int vmw_gb_surface_define_ext_ioctl(struct drm_device *dev, void *data,
1497				struct drm_file *file_priv)
1498{
1499	union drm_vmw_gb_surface_create_ext_arg *arg =
1500	    (union drm_vmw_gb_surface_create_ext_arg *)data;
1501	struct drm_vmw_gb_surface_create_ext_req *req = &arg->req;
1502	struct drm_vmw_gb_surface_create_rep *rep = &arg->rep;
1503
1504	return vmw_gb_surface_define_internal(dev, req, rep, file_priv);
1505}
1506
1507/**
1508 * vmw_gb_surface_reference_ext_ioctl - Ioctl function implementing
1509 * the user surface reference functionality.
1510 *
1511 * @dev: Pointer to a struct drm_device.
1512 * @data: Pointer to data copied from / to user-space.
1513 * @file_priv: Pointer to a drm file private structure.
1514 */
1515int vmw_gb_surface_reference_ext_ioctl(struct drm_device *dev, void *data,
1516				   struct drm_file *file_priv)
1517{
1518	union drm_vmw_gb_surface_reference_ext_arg *arg =
1519	    (union drm_vmw_gb_surface_reference_ext_arg *)data;
1520	struct drm_vmw_surface_arg *req = &arg->req;
1521	struct drm_vmw_gb_surface_ref_ext_rep *rep = &arg->rep;
1522
1523	return vmw_gb_surface_reference_internal(dev, req, rep, file_priv);
1524}
1525
1526/**
1527 * vmw_gb_surface_define_internal - Ioctl function implementing
1528 * the user surface define functionality.
1529 *
1530 * @dev: Pointer to a struct drm_device.
1531 * @req: Request argument from user-space.
1532 * @rep: Response argument to user-space.
1533 * @file_priv: Pointer to a drm file private structure.
1534 */
1535static int
1536vmw_gb_surface_define_internal(struct drm_device *dev,
1537			       struct drm_vmw_gb_surface_create_ext_req *req,
1538			       struct drm_vmw_gb_surface_create_rep *rep,
1539			       struct drm_file *file_priv)
1540{
1541	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
1542	struct vmw_private *dev_priv = vmw_priv(dev);
1543	struct vmw_user_surface *user_srf;
1544	struct vmw_surface_metadata metadata = {0};
1545	struct vmw_surface *srf;
1546	struct vmw_resource *res;
1547	struct vmw_resource *tmp;
1548	int ret = 0;
 
 
1549	uint32_t backup_handle = 0;
1550	SVGA3dSurfaceAllFlags svga3d_flags_64 =
1551		SVGA3D_FLAGS_64(req->svga3d_flags_upper_32_bits,
1552				req->base.svga3d_flags);
1553
1554	/* array_size must be null for non-GL3 host. */
1555	if (req->base.array_size > 0 && !has_sm4_context(dev_priv)) {
1556		VMW_DEBUG_USER("SM4 surface not supported.\n");
1557		return -EINVAL;
1558	}
1559
1560	if (!has_sm4_1_context(dev_priv)) {
1561		if (req->svga3d_flags_upper_32_bits != 0)
1562			ret = -EINVAL;
1563
1564		if (req->base.multisample_count != 0)
1565			ret = -EINVAL;
1566
1567		if (req->multisample_pattern != SVGA3D_MS_PATTERN_NONE)
1568			ret = -EINVAL;
1569
1570		if (req->quality_level != SVGA3D_MS_QUALITY_NONE)
1571			ret = -EINVAL;
1572
1573		if (ret) {
1574			VMW_DEBUG_USER("SM4.1 surface not supported.\n");
1575			return ret;
1576		}
1577	}
1578
1579	if (req->buffer_byte_stride > 0 && !has_sm5_context(dev_priv)) {
1580		VMW_DEBUG_USER("SM5 surface not supported.\n");
1581		return -EINVAL;
1582	}
1583
1584	if ((svga3d_flags_64 & SVGA3D_SURFACE_MULTISAMPLE) &&
1585	    req->base.multisample_count == 0) {
1586		VMW_DEBUG_USER("Invalid sample count.\n");
1587		return -EINVAL;
1588	}
1589
1590	if (req->base.mip_levels > DRM_VMW_MAX_MIP_LEVELS) {
1591		VMW_DEBUG_USER("Invalid mip level.\n");
1592		return -EINVAL;
1593	}
1594
1595	metadata.flags = svga3d_flags_64;
1596	metadata.format = req->base.format;
1597	metadata.mip_levels[0] = req->base.mip_levels;
1598	metadata.multisample_count = req->base.multisample_count;
1599	metadata.multisample_pattern = req->multisample_pattern;
1600	metadata.quality_level = req->quality_level;
1601	metadata.array_size = req->base.array_size;
1602	metadata.buffer_byte_stride = req->buffer_byte_stride;
1603	metadata.num_sizes = 1;
1604	metadata.base_size = req->base.base_size;
1605	metadata.scanout = req->base.drm_surface_flags &
1606		drm_vmw_surface_flag_scanout;
1607
1608	/* Define a surface based on the parameters. */
1609	ret = vmw_gb_surface_define(dev_priv, &metadata, &srf);
1610	if (ret != 0) {
1611		VMW_DEBUG_USER("Failed to define surface.\n");
 
 
 
 
 
 
 
 
 
 
 
1612		return ret;
1613	}
1614
1615	user_srf = container_of(srf, struct vmw_user_surface, srf);
1616	if (drm_is_primary_client(file_priv))
1617		user_srf->master = drm_file_get_master(file_priv);
 
 
 
 
1618
1619	res = &user_srf->srf.res;
1620
1621	if (req->base.buffer_handle != SVGA3D_INVALID_ID) {
1622		ret = vmw_user_bo_lookup(file_priv, req->base.buffer_handle,
1623					 &res->guest_memory_bo);
 
1624		if (ret == 0) {
1625			if (res->guest_memory_bo->is_dumb) {
1626				VMW_DEBUG_USER("Can't backup surface with a dumb buffer.\n");
1627				vmw_user_bo_unref(&res->guest_memory_bo);
1628				ret = -EINVAL;
1629				goto out_unlock;
1630			} else if (res->guest_memory_bo->tbo.base.size < res->guest_memory_size) {
1631				VMW_DEBUG_USER("Surface backup buffer too small.\n");
1632				vmw_user_bo_unref(&res->guest_memory_bo);
1633				ret = -EINVAL;
1634				goto out_unlock;
1635			} else {
1636				backup_handle = req->base.buffer_handle;
1637			}
1638		}
1639	} else if (req->base.drm_surface_flags &
1640		   (drm_vmw_surface_flag_create_buffer |
1641		    drm_vmw_surface_flag_coherent)) {
1642		ret = vmw_gem_object_create_with_handle(dev_priv, file_priv,
1643							res->guest_memory_size,
1644							&backup_handle,
1645							&res->guest_memory_bo);
1646	}
 
1647
1648	if (unlikely(ret != 0)) {
1649		vmw_resource_unreference(&res);
1650		goto out_unlock;
1651	}
1652
1653	if (req->base.drm_surface_flags & drm_vmw_surface_flag_coherent) {
1654		struct vmw_bo *backup = res->guest_memory_bo;
1655
1656		ttm_bo_reserve(&backup->tbo, false, false, NULL);
1657		if (!res->func->dirty_alloc)
1658			ret = -EINVAL;
1659		if (!ret)
1660			ret = vmw_bo_dirty_add(backup);
1661		if (!ret) {
1662			res->coherent = true;
1663			ret = res->func->dirty_alloc(res);
1664		}
1665		ttm_bo_unreserve(&backup->tbo);
1666		if (ret) {
1667			vmw_resource_unreference(&res);
1668			goto out_unlock;
1669		}
1670
1671	}
1672
1673	tmp = vmw_resource_reference(res);
1674	ret = ttm_prime_object_init(tfile, res->guest_memory_size, &user_srf->prime,
 
 
1675				    VMW_RES_SURFACE,
1676				    &vmw_user_surface_base_release);
1677
1678	if (unlikely(ret != 0)) {
1679		vmw_resource_unreference(&tmp);
1680		vmw_resource_unreference(&res);
1681		goto out_unlock;
1682	}
1683
1684	rep->handle      = user_srf->prime.base.handle;
1685	rep->backup_size = res->guest_memory_size;
1686	if (res->guest_memory_bo) {
1687		vmw_bo_add_detached_resource(res->guest_memory_bo, res);
1688		rep->buffer_map_handle =
1689			drm_vma_node_offset_addr(&res->guest_memory_bo->tbo.base.vma_node);
1690		rep->buffer_size = res->guest_memory_bo->tbo.base.size;
1691		rep->buffer_handle = backup_handle;
1692	} else {
1693		rep->buffer_map_handle = 0;
1694		rep->buffer_size = 0;
1695		rep->buffer_handle = SVGA3D_INVALID_ID;
1696	}
 
1697	vmw_resource_unreference(&res);
1698
1699out_unlock:
 
1700	return ret;
1701}
1702
1703/**
1704 * vmw_gb_surface_reference_internal - Ioctl function implementing
1705 * the user surface reference functionality.
1706 *
1707 * @dev: Pointer to a struct drm_device.
1708 * @req: Pointer to user-space request surface arg.
1709 * @rep: Pointer to response to user-space.
1710 * @file_priv: Pointer to a drm file private structure.
1711 */
1712static int
1713vmw_gb_surface_reference_internal(struct drm_device *dev,
1714				  struct drm_vmw_surface_arg *req,
1715				  struct drm_vmw_gb_surface_ref_ext_rep *rep,
1716				  struct drm_file *file_priv)
1717{
1718	struct vmw_private *dev_priv = vmw_priv(dev);
 
1719	struct vmw_surface *srf;
1720	struct vmw_user_surface *user_srf;
1721	struct vmw_surface_metadata *metadata;
1722	struct ttm_base_object *base;
1723	u32 backup_handle;
1724	int ret;
1725
1726	ret = vmw_surface_handle_reference(dev_priv, file_priv, req->sid,
1727					   req->handle_type, &base);
1728	if (unlikely(ret != 0))
1729		return ret;
1730
1731	user_srf = container_of(base, struct vmw_user_surface, prime.base);
1732	srf = &user_srf->srf;
1733	if (!srf->res.guest_memory_bo) {
1734		DRM_ERROR("Shared GB surface is missing a backup buffer.\n");
1735		goto out_bad_resource;
1736	}
1737	metadata = &srf->metadata;
1738
1739	mutex_lock(&dev_priv->cmdbuf_mutex); /* Protect res->backup */
1740	ret = drm_gem_handle_create(file_priv, &srf->res.guest_memory_bo->tbo.base,
1741				    &backup_handle);
1742	mutex_unlock(&dev_priv->cmdbuf_mutex);
1743	if (ret != 0) {
1744		drm_err(dev, "Wasn't able to create a backing handle for surface sid = %u.\n",
1745			req->sid);
 
 
 
1746		goto out_bad_resource;
1747	}
1748
1749	rep->creq.base.svga3d_flags = SVGA3D_FLAGS_LOWER_32(metadata->flags);
1750	rep->creq.base.format = metadata->format;
1751	rep->creq.base.mip_levels = metadata->mip_levels[0];
1752	rep->creq.base.drm_surface_flags = 0;
1753	rep->creq.base.multisample_count = metadata->multisample_count;
1754	rep->creq.base.autogen_filter = metadata->autogen_filter;
1755	rep->creq.base.array_size = metadata->array_size;
1756	rep->creq.base.buffer_handle = backup_handle;
1757	rep->creq.base.base_size = metadata->base_size;
1758	rep->crep.handle = user_srf->prime.base.handle;
1759	rep->crep.backup_size = srf->res.guest_memory_size;
1760	rep->crep.buffer_handle = backup_handle;
1761	rep->crep.buffer_map_handle =
1762		drm_vma_node_offset_addr(&srf->res.guest_memory_bo->tbo.base.vma_node);
1763	rep->crep.buffer_size = srf->res.guest_memory_bo->tbo.base.size;
1764
1765	rep->creq.version = drm_vmw_gb_surface_v1;
1766	rep->creq.svga3d_flags_upper_32_bits =
1767		SVGA3D_FLAGS_UPPER_32(metadata->flags);
1768	rep->creq.multisample_pattern = metadata->multisample_pattern;
1769	rep->creq.quality_level = metadata->quality_level;
1770	rep->creq.must_be_zero = 0;
1771
1772out_bad_resource:
1773	ttm_base_object_unref(&base);
1774
1775	return ret;
1776}
1777
1778/**
1779 * vmw_subres_dirty_add - Add a dirty region to a subresource
1780 * @dirty: The surfaces's dirty tracker.
1781 * @loc_start: The location corresponding to the start of the region.
1782 * @loc_end: The location corresponding to the end of the region.
1783 *
1784 * As we are assuming that @loc_start and @loc_end represent a sequential
1785 * range of backing store memory, if the region spans multiple lines then
1786 * regardless of the x coordinate, the full lines are dirtied.
1787 * Correspondingly if the region spans multiple z slices, then full rather
1788 * than partial z slices are dirtied.
1789 */
1790static void vmw_subres_dirty_add(struct vmw_surface_dirty *dirty,
1791				 const struct vmw_surface_loc *loc_start,
1792				 const struct vmw_surface_loc *loc_end)
1793{
1794	const struct vmw_surface_cache *cache = &dirty->cache;
1795	SVGA3dBox *box = &dirty->boxes[loc_start->sub_resource];
1796	u32 mip = loc_start->sub_resource % cache->num_mip_levels;
1797	const struct drm_vmw_size *size = &cache->mip[mip].size;
1798	u32 box_c2 = box->z + box->d;
1799
1800	if (WARN_ON(loc_start->sub_resource >= dirty->num_subres))
1801		return;
1802
1803	if (box->d == 0 || box->z > loc_start->z)
1804		box->z = loc_start->z;
1805	if (box_c2 < loc_end->z)
1806		box->d = loc_end->z - box->z;
1807
1808	if (loc_start->z + 1 == loc_end->z) {
1809		box_c2 = box->y + box->h;
1810		if (box->h == 0 || box->y > loc_start->y)
1811			box->y = loc_start->y;
1812		if (box_c2 < loc_end->y)
1813			box->h = loc_end->y - box->y;
1814
1815		if (loc_start->y + 1 == loc_end->y) {
1816			box_c2 = box->x + box->w;
1817			if (box->w == 0 || box->x > loc_start->x)
1818				box->x = loc_start->x;
1819			if (box_c2 < loc_end->x)
1820				box->w = loc_end->x - box->x;
1821		} else {
1822			box->x = 0;
1823			box->w = size->width;
1824		}
1825	} else {
1826		box->y = 0;
1827		box->h = size->height;
1828		box->x = 0;
1829		box->w = size->width;
1830	}
1831}
1832
1833/**
1834 * vmw_subres_dirty_full - Mark a full subresource as dirty
1835 * @dirty: The surface's dirty tracker.
1836 * @subres: The subresource
1837 */
1838static void vmw_subres_dirty_full(struct vmw_surface_dirty *dirty, u32 subres)
1839{
1840	const struct vmw_surface_cache *cache = &dirty->cache;
1841	u32 mip = subres % cache->num_mip_levels;
1842	const struct drm_vmw_size *size = &cache->mip[mip].size;
1843	SVGA3dBox *box = &dirty->boxes[subres];
1844
1845	box->x = 0;
1846	box->y = 0;
1847	box->z = 0;
1848	box->w = size->width;
1849	box->h = size->height;
1850	box->d = size->depth;
1851}
1852
1853/*
1854 * vmw_surface_tex_dirty_add_range - The dirty_add_range callback for texture
1855 * surfaces.
1856 */
1857static void vmw_surface_tex_dirty_range_add(struct vmw_resource *res,
1858					    size_t start, size_t end)
1859{
1860	struct vmw_surface_dirty *dirty =
1861		(struct vmw_surface_dirty *) res->dirty;
1862	size_t backup_end = res->guest_memory_offset + res->guest_memory_size;
1863	struct vmw_surface_loc loc1, loc2;
1864	const struct vmw_surface_cache *cache;
1865
1866	start = max_t(size_t, start, res->guest_memory_offset) - res->guest_memory_offset;
1867	end = min(end, backup_end) - res->guest_memory_offset;
1868	cache = &dirty->cache;
1869	vmw_surface_get_loc(cache, &loc1, start);
1870	vmw_surface_get_loc(cache, &loc2, end - 1);
1871	vmw_surface_inc_loc(cache, &loc2);
1872
1873	if (loc1.sheet != loc2.sheet) {
1874		u32 sub_res;
1875
1876		/*
1877		 * Multiple multisample sheets. To do this in an optimized
1878		 * fashion, compute the dirty region for each sheet and the
1879		 * resulting union. Since this is not a common case, just dirty
1880		 * the whole surface.
1881		 */
1882		for (sub_res = 0; sub_res < dirty->num_subres; ++sub_res)
1883			vmw_subres_dirty_full(dirty, sub_res);
1884		return;
1885	}
1886	if (loc1.sub_resource + 1 == loc2.sub_resource) {
1887		/* Dirty range covers a single sub-resource */
1888		vmw_subres_dirty_add(dirty, &loc1, &loc2);
1889	} else {
1890		/* Dirty range covers multiple sub-resources */
1891		struct vmw_surface_loc loc_min, loc_max;
1892		u32 sub_res;
1893
1894		vmw_surface_max_loc(cache, loc1.sub_resource, &loc_max);
1895		vmw_subres_dirty_add(dirty, &loc1, &loc_max);
1896		vmw_surface_min_loc(cache, loc2.sub_resource - 1, &loc_min);
1897		vmw_subres_dirty_add(dirty, &loc_min, &loc2);
1898		for (sub_res = loc1.sub_resource + 1;
1899		     sub_res < loc2.sub_resource - 1; ++sub_res)
1900			vmw_subres_dirty_full(dirty, sub_res);
1901	}
1902}
1903
1904/*
1905 * vmw_surface_tex_dirty_add_range - The dirty_add_range callback for buffer
1906 * surfaces.
1907 */
1908static void vmw_surface_buf_dirty_range_add(struct vmw_resource *res,
1909					    size_t start, size_t end)
1910{
1911	struct vmw_surface_dirty *dirty =
1912		(struct vmw_surface_dirty *) res->dirty;
1913	const struct vmw_surface_cache *cache = &dirty->cache;
1914	size_t backup_end = res->guest_memory_offset + cache->mip_chain_bytes;
1915	SVGA3dBox *box = &dirty->boxes[0];
1916	u32 box_c2;
1917
1918	box->h = box->d = 1;
1919	start = max_t(size_t, start, res->guest_memory_offset) - res->guest_memory_offset;
1920	end = min(end, backup_end) - res->guest_memory_offset;
1921	box_c2 = box->x + box->w;
1922	if (box->w == 0 || box->x > start)
1923		box->x = start;
1924	if (box_c2 < end)
1925		box->w = end - box->x;
1926}
1927
1928/*
1929 * vmw_surface_tex_dirty_add_range - The dirty_add_range callback for surfaces
1930 */
1931static void vmw_surface_dirty_range_add(struct vmw_resource *res, size_t start,
1932					size_t end)
1933{
1934	struct vmw_surface *srf = vmw_res_to_srf(res);
1935
1936	if (WARN_ON(end <= res->guest_memory_offset ||
1937		    start >= res->guest_memory_offset + res->guest_memory_size))
1938		return;
1939
1940	if (srf->metadata.format == SVGA3D_BUFFER)
1941		vmw_surface_buf_dirty_range_add(res, start, end);
1942	else
1943		vmw_surface_tex_dirty_range_add(res, start, end);
1944}
1945
1946/*
1947 * vmw_surface_dirty_sync - The surface's dirty_sync callback.
1948 */
1949static int vmw_surface_dirty_sync(struct vmw_resource *res)
1950{
1951	struct vmw_private *dev_priv = res->dev_priv;
1952	u32 i, num_dirty;
1953	struct vmw_surface_dirty *dirty =
1954		(struct vmw_surface_dirty *) res->dirty;
1955	size_t alloc_size;
1956	const struct vmw_surface_cache *cache = &dirty->cache;
1957	struct {
1958		SVGA3dCmdHeader header;
1959		SVGA3dCmdDXUpdateSubResource body;
1960	} *cmd1;
1961	struct {
1962		SVGA3dCmdHeader header;
1963		SVGA3dCmdUpdateGBImage body;
1964	} *cmd2;
1965	void *cmd;
1966
1967	num_dirty = 0;
1968	for (i = 0; i < dirty->num_subres; ++i) {
1969		const SVGA3dBox *box = &dirty->boxes[i];
1970
1971		if (box->d)
1972			num_dirty++;
1973	}
1974
1975	if (!num_dirty)
1976		goto out;
1977
1978	alloc_size = num_dirty * ((has_sm4_context(dev_priv)) ? sizeof(*cmd1) : sizeof(*cmd2));
1979	cmd = VMW_CMD_RESERVE(dev_priv, alloc_size);
1980	if (!cmd)
1981		return -ENOMEM;
1982
1983	cmd1 = cmd;
1984	cmd2 = cmd;
1985
1986	for (i = 0; i < dirty->num_subres; ++i) {
1987		const SVGA3dBox *box = &dirty->boxes[i];
1988
1989		if (!box->d)
1990			continue;
1991
1992		/*
1993		 * DX_UPDATE_SUBRESOURCE is aware of array surfaces.
1994		 * UPDATE_GB_IMAGE is not.
1995		 */
1996		if (has_sm4_context(dev_priv)) {
1997			cmd1->header.id = SVGA_3D_CMD_DX_UPDATE_SUBRESOURCE;
1998			cmd1->header.size = sizeof(cmd1->body);
1999			cmd1->body.sid = res->id;
2000			cmd1->body.subResource = i;
2001			cmd1->body.box = *box;
2002			cmd1++;
2003		} else {
2004			cmd2->header.id = SVGA_3D_CMD_UPDATE_GB_IMAGE;
2005			cmd2->header.size = sizeof(cmd2->body);
2006			cmd2->body.image.sid = res->id;
2007			cmd2->body.image.face = i / cache->num_mip_levels;
2008			cmd2->body.image.mipmap = i -
2009				(cache->num_mip_levels * cmd2->body.image.face);
2010			cmd2->body.box = *box;
2011			cmd2++;
2012		}
2013
2014	}
2015	vmw_cmd_commit(dev_priv, alloc_size);
2016 out:
2017	memset(&dirty->boxes[0], 0, sizeof(dirty->boxes[0]) *
2018	       dirty->num_subres);
2019
2020	return 0;
2021}
2022
2023/*
2024 * vmw_surface_dirty_alloc - The surface's dirty_alloc callback.
2025 */
2026static int vmw_surface_dirty_alloc(struct vmw_resource *res)
2027{
2028	struct vmw_surface *srf = vmw_res_to_srf(res);
2029	const struct vmw_surface_metadata *metadata = &srf->metadata;
2030	struct vmw_surface_dirty *dirty;
2031	u32 num_layers = 1;
2032	u32 num_mip;
2033	u32 num_subres;
2034	u32 num_samples;
2035	size_t dirty_size;
2036	int ret;
2037
2038	if (metadata->array_size)
2039		num_layers = metadata->array_size;
2040	else if (metadata->flags & SVGA3D_SURFACE_CUBEMAP)
2041		num_layers *= SVGA3D_MAX_SURFACE_FACES;
2042
2043	num_mip = metadata->mip_levels[0];
2044	if (!num_mip)
2045		num_mip = 1;
2046
2047	num_subres = num_layers * num_mip;
2048	dirty_size = struct_size(dirty, boxes, num_subres);
2049
2050	dirty = kvzalloc(dirty_size, GFP_KERNEL);
2051	if (!dirty) {
2052		ret = -ENOMEM;
2053		goto out_no_dirty;
2054	}
2055
2056	num_samples = max_t(u32, 1, metadata->multisample_count);
2057	ret = vmw_surface_setup_cache(&metadata->base_size, metadata->format,
2058				      num_mip, num_layers, num_samples,
2059				      &dirty->cache);
2060	if (ret)
2061		goto out_no_cache;
2062
2063	dirty->num_subres = num_subres;
2064	res->dirty = (struct vmw_resource_dirty *) dirty;
2065
2066	return 0;
2067
2068out_no_cache:
2069	kvfree(dirty);
2070out_no_dirty:
2071	return ret;
2072}
2073
2074/*
2075 * vmw_surface_dirty_free - The surface's dirty_free callback
2076 */
2077static void vmw_surface_dirty_free(struct vmw_resource *res)
2078{
2079	struct vmw_surface_dirty *dirty =
2080		(struct vmw_surface_dirty *) res->dirty;
2081
2082	kvfree(dirty);
2083	res->dirty = NULL;
2084}
2085
2086/*
2087 * vmw_surface_clean - The surface's clean callback
2088 */
2089static int vmw_surface_clean(struct vmw_resource *res)
2090{
2091	struct vmw_private *dev_priv = res->dev_priv;
2092	size_t alloc_size;
2093	struct {
2094		SVGA3dCmdHeader header;
2095		SVGA3dCmdReadbackGBSurface body;
2096	} *cmd;
2097
2098	alloc_size = sizeof(*cmd);
2099	cmd = VMW_CMD_RESERVE(dev_priv, alloc_size);
2100	if (!cmd)
2101		return -ENOMEM;
2102
2103	cmd->header.id = SVGA_3D_CMD_READBACK_GB_SURFACE;
2104	cmd->header.size = sizeof(cmd->body);
2105	cmd->body.sid = res->id;
2106	vmw_cmd_commit(dev_priv, alloc_size);
2107
2108	return 0;
2109}
2110
2111/*
2112 * vmw_gb_surface_define - Define a private GB surface
2113 *
2114 * @dev_priv: Pointer to a device private.
2115 * @metadata: Metadata representing the surface to create.
2116 * @user_srf_out: allocated user_srf. Set to NULL on failure.
2117 *
2118 * GB surfaces allocated by this function will not have a user mode handle, and
2119 * thus will only be visible to vmwgfx.  For optimization reasons the
2120 * surface may later be given a user mode handle by another function to make
2121 * it available to user mode drivers.
2122 */
2123int vmw_gb_surface_define(struct vmw_private *dev_priv,
2124			  const struct vmw_surface_metadata *req,
2125			  struct vmw_surface **srf_out)
2126{
2127	struct vmw_surface_metadata *metadata;
2128	struct vmw_user_surface *user_srf;
2129	struct vmw_surface *srf;
2130	u32 sample_count = 1;
2131	u32 num_layers = 1;
2132	int ret;
2133
2134	*srf_out = NULL;
2135
2136	if (req->scanout) {
2137		if (!vmw_surface_is_screen_target_format(req->format)) {
2138			VMW_DEBUG_USER("Invalid Screen Target surface format.");
2139			return -EINVAL;
2140		}
2141
2142		if (req->base_size.width > dev_priv->texture_max_width ||
2143		    req->base_size.height > dev_priv->texture_max_height) {
2144			VMW_DEBUG_USER("%ux%u\n, exceed max surface size %ux%u",
2145				       req->base_size.width,
2146				       req->base_size.height,
2147				       dev_priv->texture_max_width,
2148				       dev_priv->texture_max_height);
2149			return -EINVAL;
2150		}
2151	} else {
2152		const SVGA3dSurfaceDesc *desc =
2153			vmw_surface_get_desc(req->format);
2154
2155		if (desc->blockDesc == SVGA3DBLOCKDESC_NONE) {
2156			VMW_DEBUG_USER("Invalid surface format.\n");
2157			return -EINVAL;
2158		}
2159	}
2160
2161	if (req->autogen_filter != SVGA3D_TEX_FILTER_NONE)
2162		return -EINVAL;
2163
2164	if (req->num_sizes != 1)
2165		return -EINVAL;
2166
2167	if (req->sizes != NULL)
2168		return -EINVAL;
2169
2170	user_srf = kzalloc(sizeof(*user_srf), GFP_KERNEL);
2171	if (unlikely(!user_srf)) {
2172		ret = -ENOMEM;
2173		goto out_unlock;
2174	}
2175
2176	*srf_out  = &user_srf->srf;
2177
2178	srf = &user_srf->srf;
2179	srf->metadata = *req;
2180	srf->offsets = NULL;
2181
2182	metadata = &srf->metadata;
2183
2184	if (metadata->array_size)
2185		num_layers = req->array_size;
2186	else if (metadata->flags & SVGA3D_SURFACE_CUBEMAP)
2187		num_layers = SVGA3D_MAX_SURFACE_FACES;
2188
2189	if (metadata->flags & SVGA3D_SURFACE_MULTISAMPLE)
2190		sample_count = metadata->multisample_count;
2191
2192	srf->res.guest_memory_size =
2193		vmw_surface_get_serialized_size_extended(
2194				metadata->format,
2195				metadata->base_size,
2196				metadata->mip_levels[0],
2197				num_layers,
2198				sample_count);
2199
2200	if (metadata->flags & SVGA3D_SURFACE_BIND_STREAM_OUTPUT)
2201		srf->res.guest_memory_size += sizeof(SVGA3dDXSOState);
2202
2203	/*
2204	 * Don't set SVGA3D_SURFACE_SCREENTARGET flag for a scanout surface with
2205	 * size greater than STDU max width/height. This is really a workaround
2206	 * to support creation of big framebuffer requested by some user-space
2207	 * for whole topology. That big framebuffer won't really be used for
2208	 * binding with screen target as during prepare_fb a separate surface is
2209	 * created so it's safe to ignore SVGA3D_SURFACE_SCREENTARGET flag.
2210	 */
2211	if (dev_priv->active_display_unit == vmw_du_screen_target &&
2212	    metadata->scanout &&
2213	    metadata->base_size.width <= dev_priv->stdu_max_width &&
2214	    metadata->base_size.height <= dev_priv->stdu_max_height)
2215		metadata->flags |= SVGA3D_SURFACE_SCREENTARGET;
2216
2217	/*
2218	 * From this point, the generic resource management functions
2219	 * destroy the object on failure.
2220	 */
2221	ret = vmw_surface_init(dev_priv, srf, vmw_user_surface_free);
2222
2223	return ret;
2224
2225out_unlock:
2226	return ret;
2227}
2228
2229static SVGA3dSurfaceFormat vmw_format_bpp_to_svga(struct vmw_private *vmw,
2230						  int bpp)
2231{
2232	switch (bpp) {
2233	case 8: /* DRM_FORMAT_C8 */
2234		return SVGA3D_P8;
2235	case 16: /* DRM_FORMAT_RGB565 */
2236		return SVGA3D_R5G6B5;
2237	case 32: /* DRM_FORMAT_XRGB8888 */
2238		if (has_sm4_context(vmw))
2239			return SVGA3D_B8G8R8X8_UNORM;
2240		return SVGA3D_X8R8G8B8;
2241	default:
2242		drm_warn(&vmw->drm, "Unsupported format bpp: %d\n", bpp);
2243		return SVGA3D_X8R8G8B8;
2244	}
2245}
2246
2247/**
2248 * vmw_dumb_create - Create a dumb kms buffer
2249 *
2250 * @file_priv: Pointer to a struct drm_file identifying the caller.
2251 * @dev: Pointer to the drm device.
2252 * @args: Pointer to a struct drm_mode_create_dumb structure
2253 * Return: Zero on success, negative error code on failure.
2254 *
2255 * This is a driver callback for the core drm create_dumb functionality.
2256 * Note that this is very similar to the vmw_bo_alloc ioctl, except
2257 * that the arguments have a different format.
2258 */
2259int vmw_dumb_create(struct drm_file *file_priv,
2260		    struct drm_device *dev,
2261		    struct drm_mode_create_dumb *args)
2262{
2263	struct vmw_private *dev_priv = vmw_priv(dev);
2264	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
2265	struct vmw_bo *vbo = NULL;
2266	struct vmw_resource *res = NULL;
2267	union drm_vmw_gb_surface_create_ext_arg arg = { 0 };
2268	struct drm_vmw_gb_surface_create_ext_req *req = &arg.req;
2269	int ret;
2270	struct drm_vmw_size drm_size = {
2271		.width = args->width,
2272		.height = args->height,
2273		.depth = 1,
2274	};
2275	SVGA3dSurfaceFormat format = vmw_format_bpp_to_svga(dev_priv, args->bpp);
2276	const struct SVGA3dSurfaceDesc *desc = vmw_surface_get_desc(format);
2277	SVGA3dSurfaceAllFlags flags = SVGA3D_SURFACE_HINT_TEXTURE |
2278				      SVGA3D_SURFACE_HINT_RENDERTARGET |
2279				      SVGA3D_SURFACE_SCREENTARGET;
2280
2281	if (vmw_surface_is_dx_screen_target_format(format)) {
2282		flags |= SVGA3D_SURFACE_BIND_SHADER_RESOURCE |
2283			 SVGA3D_SURFACE_BIND_RENDER_TARGET;
2284	}
2285
2286	/*
2287	 * Without mob support we're just going to use raw memory buffer
2288	 * because we wouldn't be able to support full surface coherency
2289	 * without mobs. There also no reason to support surface coherency
2290	 * without 3d (i.e. gpu usage on the host) because then all the
2291	 * contents is going to be rendered guest side.
2292	 */
2293	if (!dev_priv->has_mob || !vmw_supports_3d(dev_priv)) {
2294		int cpp = DIV_ROUND_UP(args->bpp, 8);
2295
2296		switch (cpp) {
2297		case 1: /* DRM_FORMAT_C8 */
2298		case 2: /* DRM_FORMAT_RGB565 */
2299		case 4: /* DRM_FORMAT_XRGB8888 */
2300			break;
2301		default:
2302			/*
2303			 * Dumb buffers don't allow anything else.
2304			 * This is tested via IGT's dumb_buffers
2305			 */
2306			return -EINVAL;
2307		}
2308
2309		args->pitch = args->width * cpp;
2310		args->size = ALIGN(args->pitch * args->height, PAGE_SIZE);
2311
2312		ret = vmw_gem_object_create_with_handle(dev_priv, file_priv,
2313							args->size, &args->handle,
2314							&vbo);
2315		/* drop reference from allocate - handle holds it now */
2316		drm_gem_object_put(&vbo->tbo.base);
2317		return ret;
2318	}
2319
2320	req->version = drm_vmw_gb_surface_v1;
2321	req->multisample_pattern = SVGA3D_MS_PATTERN_NONE;
2322	req->quality_level = SVGA3D_MS_QUALITY_NONE;
2323	req->buffer_byte_stride = 0;
2324	req->must_be_zero = 0;
2325	req->base.svga3d_flags = SVGA3D_FLAGS_LOWER_32(flags);
2326	req->svga3d_flags_upper_32_bits = SVGA3D_FLAGS_UPPER_32(flags);
2327	req->base.format = (uint32_t)format;
2328	req->base.drm_surface_flags = drm_vmw_surface_flag_scanout;
2329	req->base.drm_surface_flags |= drm_vmw_surface_flag_shareable;
2330	req->base.drm_surface_flags |= drm_vmw_surface_flag_create_buffer;
2331	req->base.drm_surface_flags |= drm_vmw_surface_flag_coherent;
2332	req->base.base_size.width = args->width;
2333	req->base.base_size.height = args->height;
2334	req->base.base_size.depth = 1;
2335	req->base.array_size = 0;
2336	req->base.mip_levels = 1;
2337	req->base.multisample_count = 0;
2338	req->base.buffer_handle = SVGA3D_INVALID_ID;
2339	req->base.autogen_filter = SVGA3D_TEX_FILTER_NONE;
2340	ret = vmw_gb_surface_define_ext_ioctl(dev, &arg, file_priv);
2341	if (ret) {
2342		drm_warn(dev, "Unable to create a dumb buffer\n");
2343		return ret;
2344	}
2345
2346	args->handle = arg.rep.buffer_handle;
2347	args->size = arg.rep.buffer_size;
2348	args->pitch = vmw_surface_calculate_pitch(desc, &drm_size);
2349
2350	ret = vmw_user_resource_lookup_handle(dev_priv, tfile, arg.rep.handle,
2351					      user_surface_converter,
2352					      &res);
2353	if (ret) {
2354		drm_err(dev, "Created resource handle doesn't exist!\n");
2355		goto err;
2356	}
2357
2358	vbo = res->guest_memory_bo;
2359	vbo->is_dumb = true;
2360	vbo->dumb_surface = vmw_res_to_srf(res);
2361
2362err:
2363	if (res)
2364		vmw_resource_unreference(&res);
2365	if (ret)
2366		ttm_ref_object_base_unref(tfile, arg.rep.handle);
2367
2368	return ret;
2369}
v5.4
   1// SPDX-License-Identifier: GPL-2.0 OR MIT
   2/**************************************************************************
   3 *
   4 * Copyright 2009-2015 VMware, Inc., Palo Alto, CA., USA
 
   5 *
   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:
  13 *
  14 * The above copyright notice and this permission notice (including the
  15 * next paragraph) shall be included in all copies or substantial portions
  16 * of the Software.
  17 *
  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.
  25 *
  26 **************************************************************************/
  27
  28#include <drm/ttm/ttm_placement.h>
  29
  30#include "vmwgfx_drv.h"
  31#include "vmwgfx_resource_priv.h"
  32#include "vmwgfx_so.h"
  33#include "vmwgfx_binding.h"
 
  34#include "device_include/svga3d_surfacedefs.h"
  35
 
 
  36#define SVGA3D_FLAGS_64(upper32, lower32) (((uint64_t)upper32 << 32) | lower32)
  37#define SVGA3D_FLAGS_UPPER_32(svga3d_flags) (svga3d_flags >> 32)
  38#define SVGA3D_FLAGS_LOWER_32(svga3d_flags) \
  39	(svga3d_flags & ((uint64_t)U32_MAX))
  40
  41/**
  42 * struct vmw_user_surface - User-space visible surface resource
  43 *
  44 * @base:           The TTM base object handling user-space visibility.
  45 * @srf:            The surface metadata.
  46 * @size:           TTM accounting size for the surface.
  47 * @master: master of the creating client. Used for security check.
  48 */
  49struct vmw_user_surface {
  50	struct ttm_prime_object prime;
  51	struct vmw_surface srf;
  52	uint32_t size;
  53	struct drm_master *master;
  54	struct ttm_base_object *backup_base;
  55};
  56
  57/**
  58 * struct vmw_surface_offset - Backing store mip level offset info
  59 *
  60 * @face:           Surface face.
  61 * @mip:            Mip level.
  62 * @bo_offset:      Offset into backing store of this mip level.
  63 *
  64 */
  65struct vmw_surface_offset {
  66	uint32_t face;
  67	uint32_t mip;
  68	uint32_t bo_offset;
  69};
  70
 
 
 
 
 
 
 
 
 
 
 
 
  71static void vmw_user_surface_free(struct vmw_resource *res);
  72static struct vmw_resource *
  73vmw_user_surface_base_to_res(struct ttm_base_object *base);
  74static int vmw_legacy_srf_bind(struct vmw_resource *res,
  75			       struct ttm_validate_buffer *val_buf);
  76static int vmw_legacy_srf_unbind(struct vmw_resource *res,
  77				 bool readback,
  78				 struct ttm_validate_buffer *val_buf);
  79static int vmw_legacy_srf_create(struct vmw_resource *res);
  80static int vmw_legacy_srf_destroy(struct vmw_resource *res);
  81static int vmw_gb_surface_create(struct vmw_resource *res);
  82static int vmw_gb_surface_bind(struct vmw_resource *res,
  83			       struct ttm_validate_buffer *val_buf);
  84static int vmw_gb_surface_unbind(struct vmw_resource *res,
  85				 bool readback,
  86				 struct ttm_validate_buffer *val_buf);
  87static int vmw_gb_surface_destroy(struct vmw_resource *res);
  88static int
  89vmw_gb_surface_define_internal(struct drm_device *dev,
  90			       struct drm_vmw_gb_surface_create_ext_req *req,
  91			       struct drm_vmw_gb_surface_create_rep *rep,
  92			       struct drm_file *file_priv);
  93static int
  94vmw_gb_surface_reference_internal(struct drm_device *dev,
  95				  struct drm_vmw_surface_arg *req,
  96				  struct drm_vmw_gb_surface_ref_ext_rep *rep,
  97				  struct drm_file *file_priv);
  98
 
 
 
 
 
 
 
  99static const struct vmw_user_resource_conv user_surface_conv = {
 100	.object_type = VMW_RES_SURFACE,
 101	.base_obj_to_res = vmw_user_surface_base_to_res,
 102	.res_free = vmw_user_surface_free
 103};
 104
 105const struct vmw_user_resource_conv *user_surface_converter =
 106	&user_surface_conv;
 107
 108
 109static uint64_t vmw_user_surface_size;
 110
 111static const struct vmw_res_func vmw_legacy_surface_func = {
 112	.res_type = vmw_res_surface,
 113	.needs_backup = false,
 114	.may_evict = true,
 115	.prio = 1,
 116	.dirty_prio = 1,
 117	.type_name = "legacy surfaces",
 118	.backup_placement = &vmw_srf_placement,
 
 119	.create = &vmw_legacy_srf_create,
 120	.destroy = &vmw_legacy_srf_destroy,
 121	.bind = &vmw_legacy_srf_bind,
 122	.unbind = &vmw_legacy_srf_unbind
 123};
 124
 125static const struct vmw_res_func vmw_gb_surface_func = {
 126	.res_type = vmw_res_surface,
 127	.needs_backup = true,
 128	.may_evict = true,
 129	.prio = 1,
 130	.dirty_prio = 2,
 131	.type_name = "guest backed surfaces",
 132	.backup_placement = &vmw_mob_placement,
 
 133	.create = vmw_gb_surface_create,
 134	.destroy = vmw_gb_surface_destroy,
 135	.bind = vmw_gb_surface_bind,
 136	.unbind = vmw_gb_surface_unbind
 
 
 
 
 
 137};
 138
 139/**
 140 * struct vmw_surface_dma - SVGA3D DMA command
 141 */
 142struct vmw_surface_dma {
 143	SVGA3dCmdHeader header;
 144	SVGA3dCmdSurfaceDMA body;
 145	SVGA3dCopyBox cb;
 146	SVGA3dCmdSurfaceDMASuffix suffix;
 147};
 148
 149/**
 150 * struct vmw_surface_define - SVGA3D Surface Define command
 151 */
 152struct vmw_surface_define {
 153	SVGA3dCmdHeader header;
 154	SVGA3dCmdDefineSurface body;
 155};
 156
 157/**
 158 * struct vmw_surface_destroy - SVGA3D Surface Destroy command
 159 */
 160struct vmw_surface_destroy {
 161	SVGA3dCmdHeader header;
 162	SVGA3dCmdDestroySurface body;
 163};
 164
 165
 166/**
 167 * vmw_surface_dma_size - Compute fifo size for a dma command.
 168 *
 169 * @srf: Pointer to a struct vmw_surface
 170 *
 171 * Computes the required size for a surface dma command for backup or
 172 * restoration of the surface represented by @srf.
 173 */
 174static inline uint32_t vmw_surface_dma_size(const struct vmw_surface *srf)
 175{
 176	return srf->num_sizes * sizeof(struct vmw_surface_dma);
 177}
 178
 179
 180/**
 181 * vmw_surface_define_size - Compute fifo size for a surface define command.
 182 *
 183 * @srf: Pointer to a struct vmw_surface
 184 *
 185 * Computes the required size for a surface define command for the definition
 186 * of the surface represented by @srf.
 187 */
 188static inline uint32_t vmw_surface_define_size(const struct vmw_surface *srf)
 189{
 190	return sizeof(struct vmw_surface_define) + srf->num_sizes *
 191		sizeof(SVGA3dSize);
 192}
 193
 194
 195/**
 196 * vmw_surface_destroy_size - Compute fifo size for a surface destroy command.
 197 *
 198 * Computes the required size for a surface destroy command for the destruction
 199 * of a hw surface.
 200 */
 201static inline uint32_t vmw_surface_destroy_size(void)
 202{
 203	return sizeof(struct vmw_surface_destroy);
 204}
 205
 206/**
 207 * vmw_surface_destroy_encode - Encode a surface_destroy command.
 208 *
 209 * @id: The surface id
 210 * @cmd_space: Pointer to memory area in which the commands should be encoded.
 211 */
 212static void vmw_surface_destroy_encode(uint32_t id,
 213				       void *cmd_space)
 214{
 215	struct vmw_surface_destroy *cmd = (struct vmw_surface_destroy *)
 216		cmd_space;
 217
 218	cmd->header.id = SVGA_3D_CMD_SURFACE_DESTROY;
 219	cmd->header.size = sizeof(cmd->body);
 220	cmd->body.sid = id;
 221}
 222
 223/**
 224 * vmw_surface_define_encode - Encode a surface_define command.
 225 *
 226 * @srf: Pointer to a struct vmw_surface object.
 227 * @cmd_space: Pointer to memory area in which the commands should be encoded.
 228 */
 229static void vmw_surface_define_encode(const struct vmw_surface *srf,
 230				      void *cmd_space)
 231{
 232	struct vmw_surface_define *cmd = (struct vmw_surface_define *)
 233		cmd_space;
 234	struct drm_vmw_size *src_size;
 235	SVGA3dSize *cmd_size;
 236	uint32_t cmd_len;
 237	int i;
 238
 239	cmd_len = sizeof(cmd->body) + srf->num_sizes * sizeof(SVGA3dSize);
 
 240
 241	cmd->header.id = SVGA_3D_CMD_SURFACE_DEFINE;
 242	cmd->header.size = cmd_len;
 243	cmd->body.sid = srf->res.id;
 244	/*
 245	 * Downcast of surfaceFlags, was upcasted when received from user-space,
 246	 * since driver internally stores as 64 bit.
 247	 * For legacy surface define only 32 bit flag is supported.
 248	 */
 249	cmd->body.surfaceFlags = (SVGA3dSurface1Flags)srf->flags;
 250	cmd->body.format = srf->format;
 251	for (i = 0; i < DRM_VMW_MAX_SURFACE_FACES; ++i)
 252		cmd->body.face[i].numMipLevels = srf->mip_levels[i];
 253
 254	cmd += 1;
 255	cmd_size = (SVGA3dSize *) cmd;
 256	src_size = srf->sizes;
 257
 258	for (i = 0; i < srf->num_sizes; ++i, cmd_size++, src_size++) {
 259		cmd_size->width = src_size->width;
 260		cmd_size->height = src_size->height;
 261		cmd_size->depth = src_size->depth;
 262	}
 263}
 264
 265/**
 266 * vmw_surface_dma_encode - Encode a surface_dma command.
 267 *
 268 * @srf: Pointer to a struct vmw_surface object.
 269 * @cmd_space: Pointer to memory area in which the commands should be encoded.
 270 * @ptr: Pointer to an SVGAGuestPtr indicating where the surface contents
 271 * should be placed or read from.
 272 * @to_surface: Boolean whether to DMA to the surface or from the surface.
 273 */
 274static void vmw_surface_dma_encode(struct vmw_surface *srf,
 275				   void *cmd_space,
 276				   const SVGAGuestPtr *ptr,
 277				   bool to_surface)
 278{
 279	uint32_t i;
 280	struct vmw_surface_dma *cmd = (struct vmw_surface_dma *)cmd_space;
 281	const struct svga3d_surface_desc *desc =
 282		svga3dsurface_get_desc(srf->format);
 283
 284	for (i = 0; i < srf->num_sizes; ++i) {
 285		SVGA3dCmdHeader *header = &cmd->header;
 286		SVGA3dCmdSurfaceDMA *body = &cmd->body;
 287		SVGA3dCopyBox *cb = &cmd->cb;
 288		SVGA3dCmdSurfaceDMASuffix *suffix = &cmd->suffix;
 289		const struct vmw_surface_offset *cur_offset = &srf->offsets[i];
 290		const struct drm_vmw_size *cur_size = &srf->sizes[i];
 291
 292		header->id = SVGA_3D_CMD_SURFACE_DMA;
 293		header->size = sizeof(*body) + sizeof(*cb) + sizeof(*suffix);
 294
 295		body->guest.ptr = *ptr;
 296		body->guest.ptr.offset += cur_offset->bo_offset;
 297		body->guest.pitch = svga3dsurface_calculate_pitch(desc,
 298								  cur_size);
 299		body->host.sid = srf->res.id;
 300		body->host.face = cur_offset->face;
 301		body->host.mipmap = cur_offset->mip;
 302		body->transfer = ((to_surface) ?  SVGA3D_WRITE_HOST_VRAM :
 303				  SVGA3D_READ_HOST_VRAM);
 304		cb->x = 0;
 305		cb->y = 0;
 306		cb->z = 0;
 307		cb->srcx = 0;
 308		cb->srcy = 0;
 309		cb->srcz = 0;
 310		cb->w = cur_size->width;
 311		cb->h = cur_size->height;
 312		cb->d = cur_size->depth;
 313
 314		suffix->suffixSize = sizeof(*suffix);
 315		suffix->maximumOffset =
 316			svga3dsurface_get_image_buffer_size(desc, cur_size,
 317							    body->guest.pitch);
 318		suffix->flags.discard = 0;
 319		suffix->flags.unsynchronized = 0;
 320		suffix->flags.reserved = 0;
 321		++cmd;
 322	}
 323};
 324
 325
 326/**
 327 * vmw_hw_surface_destroy - destroy a Device surface
 328 *
 329 * @res:        Pointer to a struct vmw_resource embedded in a struct
 330 *              vmw_surface.
 331 *
 332 * Destroys a the device surface associated with a struct vmw_surface if
 333 * any, and adjusts accounting and resource count accordingly.
 334 */
 335static void vmw_hw_surface_destroy(struct vmw_resource *res)
 336{
 337
 338	struct vmw_private *dev_priv = res->dev_priv;
 339	struct vmw_surface *srf;
 340	void *cmd;
 341
 342	if (res->func->destroy == vmw_gb_surface_destroy) {
 343		(void) vmw_gb_surface_destroy(res);
 344		return;
 345	}
 346
 347	if (res->id != -1) {
 348
 349		cmd = VMW_FIFO_RESERVE(dev_priv, vmw_surface_destroy_size());
 350		if (unlikely(!cmd))
 351			return;
 352
 353		vmw_surface_destroy_encode(res->id, cmd);
 354		vmw_fifo_commit(dev_priv, vmw_surface_destroy_size());
 355
 356		/*
 357		 * used_memory_size_atomic, or separate lock
 358		 * to avoid taking dev_priv::cmdbuf_mutex in
 359		 * the destroy path.
 360		 */
 361
 362		mutex_lock(&dev_priv->cmdbuf_mutex);
 363		srf = vmw_res_to_srf(res);
 364		dev_priv->used_memory_size -= res->backup_size;
 365		mutex_unlock(&dev_priv->cmdbuf_mutex);
 366	}
 367}
 368
 369/**
 370 * vmw_legacy_srf_create - Create a device surface as part of the
 371 * resource validation process.
 372 *
 373 * @res: Pointer to a struct vmw_surface.
 374 *
 375 * If the surface doesn't have a hw id.
 376 *
 377 * Returns -EBUSY if there wasn't sufficient device resources to
 378 * complete the validation. Retry after freeing up resources.
 379 *
 380 * May return other errors if the kernel is out of guest resources.
 381 */
 382static int vmw_legacy_srf_create(struct vmw_resource *res)
 383{
 384	struct vmw_private *dev_priv = res->dev_priv;
 385	struct vmw_surface *srf;
 386	uint32_t submit_size;
 387	uint8_t *cmd;
 388	int ret;
 389
 390	if (likely(res->id != -1))
 391		return 0;
 392
 393	srf = vmw_res_to_srf(res);
 394	if (unlikely(dev_priv->used_memory_size + res->backup_size >=
 395		     dev_priv->memory_size))
 396		return -EBUSY;
 397
 398	/*
 399	 * Alloc id for the resource.
 400	 */
 401
 402	ret = vmw_resource_alloc_id(res);
 403	if (unlikely(ret != 0)) {
 404		DRM_ERROR("Failed to allocate a surface id.\n");
 405		goto out_no_id;
 406	}
 407
 408	if (unlikely(res->id >= SVGA3D_MAX_SURFACE_IDS)) {
 409		ret = -EBUSY;
 410		goto out_no_fifo;
 411	}
 412
 413	/*
 414	 * Encode surface define- commands.
 415	 */
 416
 417	submit_size = vmw_surface_define_size(srf);
 418	cmd = VMW_FIFO_RESERVE(dev_priv, submit_size);
 419	if (unlikely(!cmd)) {
 420		ret = -ENOMEM;
 421		goto out_no_fifo;
 422	}
 423
 424	vmw_surface_define_encode(srf, cmd);
 425	vmw_fifo_commit(dev_priv, submit_size);
 426	vmw_fifo_resource_inc(dev_priv);
 427
 428	/*
 429	 * Surface memory usage accounting.
 430	 */
 431
 432	dev_priv->used_memory_size += res->backup_size;
 433	return 0;
 434
 435out_no_fifo:
 436	vmw_resource_release_id(res);
 437out_no_id:
 438	return ret;
 439}
 440
 441/**
 442 * vmw_legacy_srf_dma - Copy backup data to or from a legacy surface.
 443 *
 444 * @res:            Pointer to a struct vmw_res embedded in a struct
 445 *                  vmw_surface.
 446 * @val_buf:        Pointer to a struct ttm_validate_buffer containing
 447 *                  information about the backup buffer.
 448 * @bind:           Boolean wether to DMA to the surface.
 449 *
 450 * Transfer backup data to or from a legacy surface as part of the
 451 * validation process.
 452 * May return other errors if the kernel is out of guest resources.
 453 * The backup buffer will be fenced or idle upon successful completion,
 454 * and if the surface needs persistent backup storage, the backup buffer
 455 * will also be returned reserved iff @bind is true.
 456 */
 457static int vmw_legacy_srf_dma(struct vmw_resource *res,
 458			      struct ttm_validate_buffer *val_buf,
 459			      bool bind)
 460{
 461	SVGAGuestPtr ptr;
 462	struct vmw_fence_obj *fence;
 463	uint32_t submit_size;
 464	struct vmw_surface *srf = vmw_res_to_srf(res);
 465	uint8_t *cmd;
 466	struct vmw_private *dev_priv = res->dev_priv;
 467
 468	BUG_ON(!val_buf->bo);
 469	submit_size = vmw_surface_dma_size(srf);
 470	cmd = VMW_FIFO_RESERVE(dev_priv, submit_size);
 471	if (unlikely(!cmd))
 472		return -ENOMEM;
 473
 474	vmw_bo_get_guest_ptr(val_buf->bo, &ptr);
 475	vmw_surface_dma_encode(srf, cmd, &ptr, bind);
 476
 477	vmw_fifo_commit(dev_priv, submit_size);
 478
 479	/*
 480	 * Create a fence object and fence the backup buffer.
 481	 */
 482
 483	(void) vmw_execbuf_fence_commands(NULL, dev_priv,
 484					  &fence, NULL);
 485
 486	vmw_bo_fence_single(val_buf->bo, fence);
 487
 488	if (likely(fence != NULL))
 489		vmw_fence_obj_unreference(&fence);
 490
 491	return 0;
 492}
 493
 494/**
 495 * vmw_legacy_srf_bind - Perform a legacy surface bind as part of the
 496 *                       surface validation process.
 497 *
 498 * @res:            Pointer to a struct vmw_res embedded in a struct
 499 *                  vmw_surface.
 500 * @val_buf:        Pointer to a struct ttm_validate_buffer containing
 501 *                  information about the backup buffer.
 502 *
 503 * This function will copy backup data to the surface if the
 504 * backup buffer is dirty.
 505 */
 506static int vmw_legacy_srf_bind(struct vmw_resource *res,
 507			       struct ttm_validate_buffer *val_buf)
 508{
 509	if (!res->backup_dirty)
 510		return 0;
 511
 512	return vmw_legacy_srf_dma(res, val_buf, true);
 513}
 514
 515
 516/**
 517 * vmw_legacy_srf_unbind - Perform a legacy surface unbind as part of the
 518 *                         surface eviction process.
 519 *
 520 * @res:            Pointer to a struct vmw_res embedded in a struct
 521 *                  vmw_surface.
 
 522 * @val_buf:        Pointer to a struct ttm_validate_buffer containing
 523 *                  information about the backup buffer.
 524 *
 525 * This function will copy backup data from the surface.
 526 */
 527static int vmw_legacy_srf_unbind(struct vmw_resource *res,
 528				 bool readback,
 529				 struct ttm_validate_buffer *val_buf)
 530{
 531	if (unlikely(readback))
 532		return vmw_legacy_srf_dma(res, val_buf, false);
 533	return 0;
 534}
 535
 536/**
 537 * vmw_legacy_srf_destroy - Destroy a device surface as part of a
 538 *                          resource eviction process.
 539 *
 540 * @res:            Pointer to a struct vmw_res embedded in a struct
 541 *                  vmw_surface.
 542 */
 543static int vmw_legacy_srf_destroy(struct vmw_resource *res)
 544{
 545	struct vmw_private *dev_priv = res->dev_priv;
 546	uint32_t submit_size;
 547	uint8_t *cmd;
 548
 549	BUG_ON(res->id == -1);
 550
 551	/*
 552	 * Encode the dma- and surface destroy commands.
 553	 */
 554
 555	submit_size = vmw_surface_destroy_size();
 556	cmd = VMW_FIFO_RESERVE(dev_priv, submit_size);
 557	if (unlikely(!cmd))
 558		return -ENOMEM;
 559
 560	vmw_surface_destroy_encode(res->id, cmd);
 561	vmw_fifo_commit(dev_priv, submit_size);
 562
 563	/*
 564	 * Surface memory usage accounting.
 565	 */
 566
 567	dev_priv->used_memory_size -= res->backup_size;
 568
 569	/*
 570	 * Release the surface ID.
 571	 */
 572
 573	vmw_resource_release_id(res);
 574	vmw_fifo_resource_dec(dev_priv);
 575
 576	return 0;
 577}
 578
 579
 580/**
 581 * vmw_surface_init - initialize a struct vmw_surface
 582 *
 583 * @dev_priv:       Pointer to a device private struct.
 584 * @srf:            Pointer to the struct vmw_surface to initialize.
 585 * @res_free:       Pointer to a resource destructor used to free
 586 *                  the object.
 587 */
 588static int vmw_surface_init(struct vmw_private *dev_priv,
 589			    struct vmw_surface *srf,
 590			    void (*res_free) (struct vmw_resource *res))
 591{
 592	int ret;
 593	struct vmw_resource *res = &srf->res;
 594
 595	BUG_ON(!res_free);
 596	ret = vmw_resource_init(dev_priv, res, true, res_free,
 597				(dev_priv->has_mob) ? &vmw_gb_surface_func :
 598				&vmw_legacy_surface_func);
 599
 600	if (unlikely(ret != 0)) {
 601		res_free(res);
 602		return ret;
 603	}
 604
 605	/*
 606	 * The surface won't be visible to hardware until a
 607	 * surface validate.
 608	 */
 609
 610	INIT_LIST_HEAD(&srf->view_list);
 611	res->hw_destroy = vmw_hw_surface_destroy;
 612	return ret;
 613}
 614
 615/**
 616 * vmw_user_surface_base_to_res - TTM base object to resource converter for
 617 *                                user visible surfaces
 618 *
 619 * @base:           Pointer to a TTM base object
 620 *
 621 * Returns the struct vmw_resource embedded in a struct vmw_surface
 622 * for the user-visible object identified by the TTM base object @base.
 623 */
 624static struct vmw_resource *
 625vmw_user_surface_base_to_res(struct ttm_base_object *base)
 626{
 627	return &(container_of(base, struct vmw_user_surface,
 628			      prime.base)->srf.res);
 629}
 630
 631/**
 632 * vmw_user_surface_free - User visible surface resource destructor
 633 *
 634 * @res:            A struct vmw_resource embedded in a struct vmw_surface.
 635 */
 636static void vmw_user_surface_free(struct vmw_resource *res)
 637{
 638	struct vmw_surface *srf = vmw_res_to_srf(res);
 639	struct vmw_user_surface *user_srf =
 640	    container_of(srf, struct vmw_user_surface, srf);
 641	struct vmw_private *dev_priv = srf->res.dev_priv;
 642	uint32_t size = user_srf->size;
 643
 
 644	if (user_srf->master)
 645		drm_master_put(&user_srf->master);
 646	kfree(srf->offsets);
 647	kfree(srf->sizes);
 648	kfree(srf->snooper.image);
 649	ttm_prime_object_kfree(user_srf, prime);
 650	ttm_mem_global_free(vmw_mem_glob(dev_priv), size);
 651}
 652
 653/**
 654 * vmw_user_surface_free - User visible surface TTM base object destructor
 655 *
 656 * @p_base:         Pointer to a pointer to a TTM base object
 657 *                  embedded in a struct vmw_user_surface.
 658 *
 659 * Drops the base object's reference on its resource, and the
 660 * pointer pointed to by *p_base is set to NULL.
 661 */
 662static void vmw_user_surface_base_release(struct ttm_base_object **p_base)
 663{
 664	struct ttm_base_object *base = *p_base;
 665	struct vmw_user_surface *user_srf =
 666	    container_of(base, struct vmw_user_surface, prime.base);
 667	struct vmw_resource *res = &user_srf->srf.res;
 668
 669	*p_base = NULL;
 670	if (user_srf->backup_base)
 671		ttm_base_object_unref(&user_srf->backup_base);
 
 
 
 
 
 
 672	vmw_resource_unreference(&res);
 673}
 674
 675/**
 676 * vmw_user_surface_destroy_ioctl - Ioctl function implementing
 677 *                                  the user surface destroy functionality.
 678 *
 679 * @dev:            Pointer to a struct drm_device.
 680 * @data:           Pointer to data copied from / to user-space.
 681 * @file_priv:      Pointer to a drm file private structure.
 682 */
 683int vmw_surface_destroy_ioctl(struct drm_device *dev, void *data,
 684			      struct drm_file *file_priv)
 685{
 686	struct drm_vmw_surface_arg *arg = (struct drm_vmw_surface_arg *)data;
 687	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 688
 689	return ttm_ref_object_base_unref(tfile, arg->sid, TTM_REF_USAGE);
 690}
 691
 692/**
 693 * vmw_user_surface_define_ioctl - Ioctl function implementing
 694 *                                  the user surface define functionality.
 695 *
 696 * @dev:            Pointer to a struct drm_device.
 697 * @data:           Pointer to data copied from / to user-space.
 698 * @file_priv:      Pointer to a drm file private structure.
 699 */
 700int vmw_surface_define_ioctl(struct drm_device *dev, void *data,
 701			     struct drm_file *file_priv)
 702{
 703	struct vmw_private *dev_priv = vmw_priv(dev);
 704	struct vmw_user_surface *user_srf;
 705	struct vmw_surface *srf;
 
 706	struct vmw_resource *res;
 707	struct vmw_resource *tmp;
 708	union drm_vmw_surface_create_arg *arg =
 709	    (union drm_vmw_surface_create_arg *)data;
 710	struct drm_vmw_surface_create_req *req = &arg->req;
 711	struct drm_vmw_surface_arg *rep = &arg->rep;
 712	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 713	struct ttm_operation_ctx ctx = {
 714		.interruptible = true,
 715		.no_wait_gpu = false
 716	};
 717	int ret;
 718	int i, j;
 719	uint32_t cur_bo_offset;
 720	struct drm_vmw_size *cur_size;
 721	struct vmw_surface_offset *cur_offset;
 722	uint32_t num_sizes;
 723	uint32_t size;
 724	const struct svga3d_surface_desc *desc;
 725
 726	if (unlikely(vmw_user_surface_size == 0))
 727		vmw_user_surface_size = ttm_round_pot(sizeof(*user_srf)) +
 728			VMW_IDA_ACC_SIZE + TTM_OBJ_EXTRA_SIZE;
 729
 730	num_sizes = 0;
 731	for (i = 0; i < DRM_VMW_MAX_SURFACE_FACES; ++i) {
 732		if (req->mip_levels[i] > DRM_VMW_MAX_MIP_LEVELS)
 733			return -EINVAL;
 734		num_sizes += req->mip_levels[i];
 735	}
 736
 737	if (num_sizes > DRM_VMW_MAX_SURFACE_FACES * DRM_VMW_MAX_MIP_LEVELS ||
 738	    num_sizes == 0)
 739		return -EINVAL;
 740
 741	size = vmw_user_surface_size +
 742		ttm_round_pot(num_sizes * sizeof(struct drm_vmw_size)) +
 743		ttm_round_pot(num_sizes * sizeof(struct vmw_surface_offset));
 744
 745	desc = svga3dsurface_get_desc(req->format);
 746	if (unlikely(desc->block_desc == SVGA3DBLOCKDESC_NONE)) {
 747		VMW_DEBUG_USER("Invalid format %d for surface creation.\n",
 748			       req->format);
 749		return -EINVAL;
 750	}
 751
 752	ret = ttm_read_lock(&dev_priv->reservation_sem, true);
 753	if (unlikely(ret != 0))
 754		return ret;
 755
 756	ret = ttm_mem_global_alloc(vmw_mem_glob(dev_priv),
 757				   size, &ctx);
 758	if (unlikely(ret != 0)) {
 759		if (ret != -ERESTARTSYS)
 760			DRM_ERROR("Out of graphics memory for surface.\n");
 761		goto out_unlock;
 762	}
 763
 764	user_srf = kzalloc(sizeof(*user_srf), GFP_KERNEL);
 765	if (unlikely(!user_srf)) {
 766		ret = -ENOMEM;
 767		goto out_no_user_srf;
 768	}
 769
 770	srf = &user_srf->srf;
 
 771	res = &srf->res;
 772
 773	/* Driver internally stores as 64-bit flags */
 774	srf->flags = (SVGA3dSurfaceAllFlags)req->flags;
 775	srf->format = req->format;
 776	srf->scanout = req->scanout;
 777
 778	memcpy(srf->mip_levels, req->mip_levels, sizeof(srf->mip_levels));
 779	srf->num_sizes = num_sizes;
 780	user_srf->size = size;
 781	srf->sizes = memdup_user((struct drm_vmw_size __user *)(unsigned long)
 782				 req->size_addr,
 783				 sizeof(*srf->sizes) * srf->num_sizes);
 784	if (IS_ERR(srf->sizes)) {
 785		ret = PTR_ERR(srf->sizes);
 
 786		goto out_no_sizes;
 787	}
 788	srf->offsets = kmalloc_array(srf->num_sizes,
 789				     sizeof(*srf->offsets),
 790				     GFP_KERNEL);
 791	if (unlikely(!srf->offsets)) {
 792		ret = -ENOMEM;
 793		goto out_no_offsets;
 794	}
 795
 796	srf->base_size = *srf->sizes;
 797	srf->autogen_filter = SVGA3D_TEX_FILTER_NONE;
 798	srf->multisample_count = 0;
 799	srf->multisample_pattern = SVGA3D_MS_PATTERN_NONE;
 800	srf->quality_level = SVGA3D_MS_QUALITY_NONE;
 801
 802	cur_bo_offset = 0;
 803	cur_offset = srf->offsets;
 804	cur_size = srf->sizes;
 805
 806	for (i = 0; i < DRM_VMW_MAX_SURFACE_FACES; ++i) {
 807		for (j = 0; j < srf->mip_levels[i]; ++j) {
 808			uint32_t stride = svga3dsurface_calculate_pitch
 809				(desc, cur_size);
 810
 811			cur_offset->face = i;
 812			cur_offset->mip = j;
 813			cur_offset->bo_offset = cur_bo_offset;
 814			cur_bo_offset += svga3dsurface_get_image_buffer_size
 815				(desc, cur_size, stride);
 816			++cur_offset;
 817			++cur_size;
 818		}
 819	}
 820	res->backup_size = cur_bo_offset;
 821	if (srf->scanout &&
 822	    srf->num_sizes == 1 &&
 823	    srf->sizes[0].width == 64 &&
 824	    srf->sizes[0].height == 64 &&
 825	    srf->format == SVGA3D_A8R8G8B8) {
 826
 827		srf->snooper.image = kzalloc(64 * 64 * 4, GFP_KERNEL);
 
 
 
 
 
 828		if (!srf->snooper.image) {
 829			DRM_ERROR("Failed to allocate cursor_image\n");
 830			ret = -ENOMEM;
 831			goto out_no_copy;
 832		}
 833	} else {
 834		srf->snooper.image = NULL;
 835	}
 836
 837	user_srf->prime.base.shareable = false;
 838	user_srf->prime.base.tfile = NULL;
 839	if (drm_is_primary_client(file_priv))
 840		user_srf->master = drm_master_get(file_priv->master);
 841
 842	/**
 843	 * From this point, the generic resource management functions
 844	 * destroy the object on failure.
 845	 */
 846
 847	ret = vmw_surface_init(dev_priv, srf, vmw_user_surface_free);
 848	if (unlikely(ret != 0))
 849		goto out_unlock;
 850
 851	/*
 852	 * A gb-aware client referencing a shared surface will
 853	 * expect a backup buffer to be present.
 854	 */
 855	if (dev_priv->has_mob && req->shareable) {
 856		uint32_t backup_handle;
 857
 858		ret = vmw_user_bo_alloc(dev_priv, tfile,
 859					res->backup_size,
 860					true,
 861					&backup_handle,
 862					&res->backup,
 863					&user_srf->backup_base);
 
 
 
 864		if (unlikely(ret != 0)) {
 865			vmw_resource_unreference(&res);
 866			goto out_unlock;
 867		}
 
 868	}
 869
 870	tmp = vmw_resource_reference(&srf->res);
 871	ret = ttm_prime_object_init(tfile, res->backup_size, &user_srf->prime,
 872				    req->shareable, VMW_RES_SURFACE,
 873				    &vmw_user_surface_base_release, NULL);
 
 874
 875	if (unlikely(ret != 0)) {
 876		vmw_resource_unreference(&tmp);
 877		vmw_resource_unreference(&res);
 878		goto out_unlock;
 879	}
 880
 881	rep->sid = user_srf->prime.base.handle;
 882	vmw_resource_unreference(&res);
 883
 884	ttm_read_unlock(&dev_priv->reservation_sem);
 885	return 0;
 886out_no_copy:
 887	kfree(srf->offsets);
 888out_no_offsets:
 889	kfree(srf->sizes);
 890out_no_sizes:
 891	ttm_prime_object_kfree(user_srf, prime);
 892out_no_user_srf:
 893	ttm_mem_global_free(vmw_mem_glob(dev_priv), size);
 894out_unlock:
 895	ttm_read_unlock(&dev_priv->reservation_sem);
 896	return ret;
 897}
 898
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 899
 900static int
 901vmw_surface_handle_reference(struct vmw_private *dev_priv,
 902			     struct drm_file *file_priv,
 903			     uint32_t u_handle,
 904			     enum drm_vmw_handle_type handle_type,
 905			     struct ttm_base_object **base_p)
 906{
 907	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 908	struct vmw_user_surface *user_srf;
 909	uint32_t handle;
 910	struct ttm_base_object *base;
 911	int ret;
 912	bool require_exist = false;
 913
 914	if (handle_type == DRM_VMW_HANDLE_PRIME) {
 915		ret = ttm_prime_fd_to_handle(tfile, u_handle, &handle);
 916		if (unlikely(ret != 0))
 917			return ret;
 
 
 
 
 918	} else {
 919		if (unlikely(drm_is_render_client(file_priv)))
 920			require_exist = true;
 921
 922		handle = u_handle;
 923	}
 924
 925	ret = -EINVAL;
 926	base = ttm_base_object_lookup_for_ref(dev_priv->tdev, handle);
 927	if (unlikely(!base)) {
 928		VMW_DEBUG_USER("Could not find surface to reference.\n");
 929		goto out_no_lookup;
 930	}
 931
 932	if (unlikely(ttm_base_object_type(base) != VMW_RES_SURFACE)) {
 933		VMW_DEBUG_USER("Referenced object is not a surface.\n");
 934		goto out_bad_resource;
 935	}
 
 
 936
 937	if (handle_type != DRM_VMW_HANDLE_PRIME) {
 938		user_srf = container_of(base, struct vmw_user_surface,
 939					prime.base);
 940
 
 
 
 
 
 
 
 941		/*
 942		 * Make sure the surface creator has the same
 943		 * authenticating master, or is already registered with us.
 944		 */
 945		if (drm_is_primary_client(file_priv) &&
 946		    user_srf->master != file_priv->master)
 947			require_exist = true;
 948
 949		ret = ttm_ref_object_add(tfile, base, TTM_REF_USAGE, NULL,
 950					 require_exist);
 
 
 951		if (unlikely(ret != 0)) {
 952			DRM_ERROR("Could not add a reference to a surface.\n");
 953			goto out_bad_resource;
 954		}
 955	}
 956
 957	*base_p = base;
 958	return 0;
 959
 960out_bad_resource:
 961	ttm_base_object_unref(&base);
 962out_no_lookup:
 963	if (handle_type == DRM_VMW_HANDLE_PRIME)
 964		(void) ttm_ref_object_base_unref(tfile, handle, TTM_REF_USAGE);
 965
 966	return ret;
 967}
 968
 969/**
 970 * vmw_user_surface_define_ioctl - Ioctl function implementing
 971 *                                  the user surface reference functionality.
 972 *
 973 * @dev:            Pointer to a struct drm_device.
 974 * @data:           Pointer to data copied from / to user-space.
 975 * @file_priv:      Pointer to a drm file private structure.
 976 */
 977int vmw_surface_reference_ioctl(struct drm_device *dev, void *data,
 978				struct drm_file *file_priv)
 979{
 980	struct vmw_private *dev_priv = vmw_priv(dev);
 981	union drm_vmw_surface_reference_arg *arg =
 982	    (union drm_vmw_surface_reference_arg *)data;
 983	struct drm_vmw_surface_arg *req = &arg->req;
 984	struct drm_vmw_surface_create_req *rep = &arg->rep;
 985	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
 986	struct vmw_surface *srf;
 987	struct vmw_user_surface *user_srf;
 988	struct drm_vmw_size __user *user_sizes;
 989	struct ttm_base_object *base;
 990	int ret;
 991
 992	ret = vmw_surface_handle_reference(dev_priv, file_priv, req->sid,
 993					   req->handle_type, &base);
 994	if (unlikely(ret != 0))
 995		return ret;
 996
 997	user_srf = container_of(base, struct vmw_user_surface, prime.base);
 998	srf = &user_srf->srf;
 999
1000	/* Downcast of flags when sending back to user space */
1001	rep->flags = (uint32_t)srf->flags;
1002	rep->format = srf->format;
1003	memcpy(rep->mip_levels, srf->mip_levels, sizeof(srf->mip_levels));
 
1004	user_sizes = (struct drm_vmw_size __user *)(unsigned long)
1005	    rep->size_addr;
1006
1007	if (user_sizes)
1008		ret = copy_to_user(user_sizes, &srf->base_size,
1009				   sizeof(srf->base_size));
1010	if (unlikely(ret != 0)) {
1011		VMW_DEBUG_USER("copy_to_user failed %p %u\n", user_sizes,
1012			       srf->num_sizes);
1013		ttm_ref_object_base_unref(tfile, base->handle, TTM_REF_USAGE);
1014		ret = -EFAULT;
1015	}
1016
1017	ttm_base_object_unref(&base);
1018
1019	return ret;
1020}
1021
1022/**
1023 * vmw_surface_define_encode - Encode a surface_define command.
1024 *
1025 * @srf: Pointer to a struct vmw_surface object.
1026 * @cmd_space: Pointer to memory area in which the commands should be encoded.
1027 */
1028static int vmw_gb_surface_create(struct vmw_resource *res)
1029{
1030	struct vmw_private *dev_priv = res->dev_priv;
1031	struct vmw_surface *srf = vmw_res_to_srf(res);
 
1032	uint32_t cmd_len, cmd_id, submit_len;
1033	int ret;
1034	struct {
1035		SVGA3dCmdHeader header;
1036		SVGA3dCmdDefineGBSurface body;
1037	} *cmd;
1038	struct {
1039		SVGA3dCmdHeader header;
1040		SVGA3dCmdDefineGBSurface_v2 body;
1041	} *cmd2;
1042	struct {
1043		SVGA3dCmdHeader header;
1044		SVGA3dCmdDefineGBSurface_v3 body;
1045	} *cmd3;
 
 
 
 
1046
1047	if (likely(res->id != -1))
1048		return 0;
1049
1050	vmw_fifo_resource_inc(dev_priv);
1051	ret = vmw_resource_alloc_id(res);
1052	if (unlikely(ret != 0)) {
1053		DRM_ERROR("Failed to allocate a surface id.\n");
1054		goto out_no_id;
1055	}
1056
1057	if (unlikely(res->id >= VMWGFX_NUM_GB_SURFACE)) {
1058		ret = -EBUSY;
1059		goto out_no_fifo;
1060	}
1061
1062	if (dev_priv->has_sm4_1 && srf->array_size > 0) {
 
 
 
 
1063		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE_V3;
1064		cmd_len = sizeof(cmd3->body);
1065		submit_len = sizeof(*cmd3);
1066	} else if (srf->array_size > 0) {
1067		/* has_dx checked on creation time. */
1068		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE_V2;
1069		cmd_len = sizeof(cmd2->body);
1070		submit_len = sizeof(*cmd2);
1071	} else {
1072		cmd_id = SVGA_3D_CMD_DEFINE_GB_SURFACE;
1073		cmd_len = sizeof(cmd->body);
1074		submit_len = sizeof(*cmd);
1075	}
1076
1077	cmd = VMW_FIFO_RESERVE(dev_priv, submit_len);
1078	cmd2 = (typeof(cmd2))cmd;
1079	cmd3 = (typeof(cmd3))cmd;
 
1080	if (unlikely(!cmd)) {
1081		ret = -ENOMEM;
1082		goto out_no_fifo;
1083	}
1084
1085	if (dev_priv->has_sm4_1 && srf->array_size > 0) {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1086		cmd3->header.id = cmd_id;
1087		cmd3->header.size = cmd_len;
1088		cmd3->body.sid = srf->res.id;
1089		cmd3->body.surfaceFlags = srf->flags;
1090		cmd3->body.format = srf->format;
1091		cmd3->body.numMipLevels = srf->mip_levels[0];
1092		cmd3->body.multisampleCount = srf->multisample_count;
1093		cmd3->body.multisamplePattern = srf->multisample_pattern;
1094		cmd3->body.qualityLevel = srf->quality_level;
1095		cmd3->body.autogenFilter = srf->autogen_filter;
1096		cmd3->body.size.width = srf->base_size.width;
1097		cmd3->body.size.height = srf->base_size.height;
1098		cmd3->body.size.depth = srf->base_size.depth;
1099		cmd3->body.arraySize = srf->array_size;
1100	} else if (srf->array_size > 0) {
1101		cmd2->header.id = cmd_id;
1102		cmd2->header.size = cmd_len;
1103		cmd2->body.sid = srf->res.id;
1104		cmd2->body.surfaceFlags = srf->flags;
1105		cmd2->body.format = srf->format;
1106		cmd2->body.numMipLevels = srf->mip_levels[0];
1107		cmd2->body.multisampleCount = srf->multisample_count;
1108		cmd2->body.autogenFilter = srf->autogen_filter;
1109		cmd2->body.size.width = srf->base_size.width;
1110		cmd2->body.size.height = srf->base_size.height;
1111		cmd2->body.size.depth = srf->base_size.depth;
1112		cmd2->body.arraySize = srf->array_size;
1113	} else {
1114		cmd->header.id = cmd_id;
1115		cmd->header.size = cmd_len;
1116		cmd->body.sid = srf->res.id;
1117		cmd->body.surfaceFlags = srf->flags;
1118		cmd->body.format = srf->format;
1119		cmd->body.numMipLevels = srf->mip_levels[0];
1120		cmd->body.multisampleCount = srf->multisample_count;
1121		cmd->body.autogenFilter = srf->autogen_filter;
1122		cmd->body.size.width = srf->base_size.width;
1123		cmd->body.size.height = srf->base_size.height;
1124		cmd->body.size.depth = srf->base_size.depth;
1125	}
1126
1127	vmw_fifo_commit(dev_priv, submit_len);
1128
1129	return 0;
1130
1131out_no_fifo:
1132	vmw_resource_release_id(res);
1133out_no_id:
1134	vmw_fifo_resource_dec(dev_priv);
1135	return ret;
1136}
1137
1138
1139static int vmw_gb_surface_bind(struct vmw_resource *res,
1140			       struct ttm_validate_buffer *val_buf)
1141{
1142	struct vmw_private *dev_priv = res->dev_priv;
1143	struct {
1144		SVGA3dCmdHeader header;
1145		SVGA3dCmdBindGBSurface body;
1146	} *cmd1;
1147	struct {
1148		SVGA3dCmdHeader header;
1149		SVGA3dCmdUpdateGBSurface body;
1150	} *cmd2;
1151	uint32_t submit_size;
1152	struct ttm_buffer_object *bo = val_buf->bo;
1153
1154	BUG_ON(bo->mem.mem_type != VMW_PL_MOB);
1155
1156	submit_size = sizeof(*cmd1) + (res->backup_dirty ? sizeof(*cmd2) : 0);
1157
1158	cmd1 = VMW_FIFO_RESERVE(dev_priv, submit_size);
1159	if (unlikely(!cmd1))
1160		return -ENOMEM;
1161
1162	cmd1->header.id = SVGA_3D_CMD_BIND_GB_SURFACE;
1163	cmd1->header.size = sizeof(cmd1->body);
1164	cmd1->body.sid = res->id;
1165	cmd1->body.mobid = bo->mem.start;
1166	if (res->backup_dirty) {
1167		cmd2 = (void *) &cmd1[1];
1168		cmd2->header.id = SVGA_3D_CMD_UPDATE_GB_SURFACE;
1169		cmd2->header.size = sizeof(cmd2->body);
1170		cmd2->body.sid = res->id;
1171		res->backup_dirty = false;
1172	}
1173	vmw_fifo_commit(dev_priv, submit_size);
 
 
 
 
 
 
 
1174
1175	return 0;
1176}
1177
1178static int vmw_gb_surface_unbind(struct vmw_resource *res,
1179				 bool readback,
1180				 struct ttm_validate_buffer *val_buf)
1181{
1182	struct vmw_private *dev_priv = res->dev_priv;
1183	struct ttm_buffer_object *bo = val_buf->bo;
1184	struct vmw_fence_obj *fence;
1185
1186	struct {
1187		SVGA3dCmdHeader header;
1188		SVGA3dCmdReadbackGBSurface body;
1189	} *cmd1;
1190	struct {
1191		SVGA3dCmdHeader header;
1192		SVGA3dCmdInvalidateGBSurface body;
1193	} *cmd2;
1194	struct {
1195		SVGA3dCmdHeader header;
1196		SVGA3dCmdBindGBSurface body;
1197	} *cmd3;
1198	uint32_t submit_size;
1199	uint8_t *cmd;
1200
1201
1202	BUG_ON(bo->mem.mem_type != VMW_PL_MOB);
1203
1204	submit_size = sizeof(*cmd3) + (readback ? sizeof(*cmd1) : sizeof(*cmd2));
1205	cmd = VMW_FIFO_RESERVE(dev_priv, submit_size);
1206	if (unlikely(!cmd))
1207		return -ENOMEM;
1208
1209	if (readback) {
1210		cmd1 = (void *) cmd;
1211		cmd1->header.id = SVGA_3D_CMD_READBACK_GB_SURFACE;
1212		cmd1->header.size = sizeof(cmd1->body);
1213		cmd1->body.sid = res->id;
1214		cmd3 = (void *) &cmd1[1];
1215	} else {
1216		cmd2 = (void *) cmd;
1217		cmd2->header.id = SVGA_3D_CMD_INVALIDATE_GB_SURFACE;
1218		cmd2->header.size = sizeof(cmd2->body);
1219		cmd2->body.sid = res->id;
1220		cmd3 = (void *) &cmd2[1];
1221	}
1222
1223	cmd3->header.id = SVGA_3D_CMD_BIND_GB_SURFACE;
1224	cmd3->header.size = sizeof(cmd3->body);
1225	cmd3->body.sid = res->id;
1226	cmd3->body.mobid = SVGA3D_INVALID_ID;
1227
1228	vmw_fifo_commit(dev_priv, submit_size);
1229
1230	/*
1231	 * Create a fence object and fence the backup buffer.
1232	 */
1233
1234	(void) vmw_execbuf_fence_commands(NULL, dev_priv,
1235					  &fence, NULL);
1236
1237	vmw_bo_fence_single(val_buf->bo, fence);
1238
1239	if (likely(fence != NULL))
1240		vmw_fence_obj_unreference(&fence);
1241
1242	return 0;
1243}
1244
1245static int vmw_gb_surface_destroy(struct vmw_resource *res)
1246{
1247	struct vmw_private *dev_priv = res->dev_priv;
1248	struct vmw_surface *srf = vmw_res_to_srf(res);
1249	struct {
1250		SVGA3dCmdHeader header;
1251		SVGA3dCmdDestroyGBSurface body;
1252	} *cmd;
1253
1254	if (likely(res->id == -1))
1255		return 0;
1256
1257	mutex_lock(&dev_priv->binding_mutex);
1258	vmw_view_surface_list_destroy(dev_priv, &srf->view_list);
1259	vmw_binding_res_list_scrub(&res->binding_head);
1260
1261	cmd = VMW_FIFO_RESERVE(dev_priv, sizeof(*cmd));
1262	if (unlikely(!cmd)) {
1263		mutex_unlock(&dev_priv->binding_mutex);
1264		return -ENOMEM;
1265	}
1266
1267	cmd->header.id = SVGA_3D_CMD_DESTROY_GB_SURFACE;
1268	cmd->header.size = sizeof(cmd->body);
1269	cmd->body.sid = res->id;
1270	vmw_fifo_commit(dev_priv, sizeof(*cmd));
1271	mutex_unlock(&dev_priv->binding_mutex);
1272	vmw_resource_release_id(res);
1273	vmw_fifo_resource_dec(dev_priv);
1274
1275	return 0;
1276}
1277
1278
1279/**
1280 * vmw_gb_surface_define_ioctl - Ioctl function implementing
1281 * the user surface define functionality.
1282 *
1283 * @dev: Pointer to a struct drm_device.
1284 * @data: Pointer to data copied from / to user-space.
1285 * @file_priv: Pointer to a drm file private structure.
1286 */
1287int vmw_gb_surface_define_ioctl(struct drm_device *dev, void *data,
1288				struct drm_file *file_priv)
1289{
1290	union drm_vmw_gb_surface_create_arg *arg =
1291	    (union drm_vmw_gb_surface_create_arg *)data;
1292	struct drm_vmw_gb_surface_create_rep *rep = &arg->rep;
1293	struct drm_vmw_gb_surface_create_ext_req req_ext;
1294
1295	req_ext.base = arg->req;
1296	req_ext.version = drm_vmw_gb_surface_v1;
1297	req_ext.svga3d_flags_upper_32_bits = 0;
1298	req_ext.multisample_pattern = SVGA3D_MS_PATTERN_NONE;
1299	req_ext.quality_level = SVGA3D_MS_QUALITY_NONE;
 
1300	req_ext.must_be_zero = 0;
1301
1302	return vmw_gb_surface_define_internal(dev, &req_ext, rep, file_priv);
1303}
1304
1305/**
1306 * vmw_gb_surface_reference_ioctl - Ioctl function implementing
1307 * the user surface reference functionality.
1308 *
1309 * @dev: Pointer to a struct drm_device.
1310 * @data: Pointer to data copied from / to user-space.
1311 * @file_priv: Pointer to a drm file private structure.
1312 */
1313int vmw_gb_surface_reference_ioctl(struct drm_device *dev, void *data,
1314				   struct drm_file *file_priv)
1315{
1316	union drm_vmw_gb_surface_reference_arg *arg =
1317	    (union drm_vmw_gb_surface_reference_arg *)data;
1318	struct drm_vmw_surface_arg *req = &arg->req;
1319	struct drm_vmw_gb_surface_ref_rep *rep = &arg->rep;
1320	struct drm_vmw_gb_surface_ref_ext_rep rep_ext;
1321	int ret;
1322
1323	ret = vmw_gb_surface_reference_internal(dev, req, &rep_ext, file_priv);
1324
1325	if (unlikely(ret != 0))
1326		return ret;
1327
1328	rep->creq = rep_ext.creq.base;
1329	rep->crep = rep_ext.crep;
1330
1331	return ret;
1332}
1333
1334/**
1335 * vmw_surface_gb_priv_define - Define a private GB surface
1336 *
1337 * @dev:  Pointer to a struct drm_device
1338 * @user_accounting_size:  Used to track user-space memory usage, set
1339 *                         to 0 for kernel mode only memory
1340 * @svga3d_flags: SVGA3d surface flags for the device
1341 * @format: requested surface format
1342 * @for_scanout: true if inteded to be used for scanout buffer
1343 * @num_mip_levels:  number of MIP levels
1344 * @multisample_count:
1345 * @array_size: Surface array size.
1346 * @size: width, heigh, depth of the surface requested
1347 * @multisample_pattern: Multisampling pattern when msaa is supported
1348 * @quality_level: Precision settings
1349 * @user_srf_out: allocated user_srf.  Set to NULL on failure.
1350 *
1351 * GB surfaces allocated by this function will not have a user mode handle, and
1352 * thus will only be visible to vmwgfx.  For optimization reasons the
1353 * surface may later be given a user mode handle by another function to make
1354 * it available to user mode drivers.
1355 */
1356int vmw_surface_gb_priv_define(struct drm_device *dev,
1357			       uint32_t user_accounting_size,
1358			       SVGA3dSurfaceAllFlags svga3d_flags,
1359			       SVGA3dSurfaceFormat format,
1360			       bool for_scanout,
1361			       uint32_t num_mip_levels,
1362			       uint32_t multisample_count,
1363			       uint32_t array_size,
1364			       struct drm_vmw_size size,
1365			       SVGA3dMSPattern multisample_pattern,
1366			       SVGA3dMSQualityLevel quality_level,
1367			       struct vmw_surface **srf_out)
1368{
1369	struct vmw_private *dev_priv = vmw_priv(dev);
1370	struct vmw_user_surface *user_srf;
1371	struct ttm_operation_ctx ctx = {
1372		.interruptible = true,
1373		.no_wait_gpu = false
1374	};
1375	struct vmw_surface *srf;
1376	int ret;
1377	u32 num_layers = 1;
1378	u32 sample_count = 1;
1379
1380	*srf_out = NULL;
1381
1382	if (for_scanout) {
1383		if (!svga3dsurface_is_screen_target_format(format)) {
1384			VMW_DEBUG_USER("Invalid Screen Target surface format.");
1385			return -EINVAL;
1386		}
1387
1388		if (size.width > dev_priv->texture_max_width ||
1389		    size.height > dev_priv->texture_max_height) {
1390			VMW_DEBUG_USER("%ux%u\n, exceeds max surface size %ux%u",
1391				       size.width, size.height,
1392				       dev_priv->texture_max_width,
1393				       dev_priv->texture_max_height);
1394			return -EINVAL;
1395		}
1396	} else {
1397		const struct svga3d_surface_desc *desc;
1398
1399		desc = svga3dsurface_get_desc(format);
1400		if (unlikely(desc->block_desc == SVGA3DBLOCKDESC_NONE)) {
1401			VMW_DEBUG_USER("Invalid surface format.\n");
1402			return -EINVAL;
1403		}
1404	}
1405
1406	/* array_size must be null for non-GL3 host. */
1407	if (array_size > 0 && !dev_priv->has_dx) {
1408		VMW_DEBUG_USER("Tried to create DX surface on non-DX host.\n");
1409		return -EINVAL;
1410	}
1411
1412	ret = ttm_read_lock(&dev_priv->reservation_sem, true);
1413	if (unlikely(ret != 0))
1414		return ret;
1415
1416	ret = ttm_mem_global_alloc(vmw_mem_glob(dev_priv),
1417				   user_accounting_size, &ctx);
1418	if (unlikely(ret != 0)) {
1419		if (ret != -ERESTARTSYS)
1420			DRM_ERROR("Out of graphics memory for surface"
1421				  " creation.\n");
1422		goto out_unlock;
1423	}
1424
1425	user_srf = kzalloc(sizeof(*user_srf), GFP_KERNEL);
1426	if (unlikely(!user_srf)) {
1427		ret = -ENOMEM;
1428		goto out_no_user_srf;
1429	}
1430
1431	*srf_out  = &user_srf->srf;
1432	user_srf->size = user_accounting_size;
1433	user_srf->prime.base.shareable = false;
1434	user_srf->prime.base.tfile     = NULL;
1435
1436	srf = &user_srf->srf;
1437	srf->flags             = svga3d_flags;
1438	srf->format            = format;
1439	srf->scanout           = for_scanout;
1440	srf->mip_levels[0]     = num_mip_levels;
1441	srf->num_sizes         = 1;
1442	srf->sizes             = NULL;
1443	srf->offsets           = NULL;
1444	srf->base_size         = size;
1445	srf->autogen_filter    = SVGA3D_TEX_FILTER_NONE;
1446	srf->array_size        = array_size;
1447	srf->multisample_count = multisample_count;
1448	srf->multisample_pattern = multisample_pattern;
1449	srf->quality_level = quality_level;
1450
1451	if (array_size)
1452		num_layers = array_size;
1453	else if (svga3d_flags & SVGA3D_SURFACE_CUBEMAP)
1454		num_layers = SVGA3D_MAX_SURFACE_FACES;
1455
1456	if (srf->flags & SVGA3D_SURFACE_MULTISAMPLE)
1457		sample_count = srf->multisample_count;
1458
1459	srf->res.backup_size   =
1460		svga3dsurface_get_serialized_size_extended(srf->format,
1461							   srf->base_size,
1462							   srf->mip_levels[0],
1463							   num_layers,
1464							   sample_count);
1465
1466	if (srf->flags & SVGA3D_SURFACE_BIND_STREAM_OUTPUT)
1467		srf->res.backup_size += sizeof(SVGA3dDXSOState);
1468
1469	/*
1470	 * Don't set SVGA3D_SURFACE_SCREENTARGET flag for a scanout surface with
1471	 * size greater than STDU max width/height. This is really a workaround
1472	 * to support creation of big framebuffer requested by some user-space
1473	 * for whole topology. That big framebuffer won't really be used for
1474	 * binding with screen target as during prepare_fb a separate surface is
1475	 * created so it's safe to ignore SVGA3D_SURFACE_SCREENTARGET flag.
1476	 */
1477	if (dev_priv->active_display_unit == vmw_du_screen_target &&
1478	    for_scanout && size.width <= dev_priv->stdu_max_width &&
1479	    size.height <= dev_priv->stdu_max_height)
1480		srf->flags |= SVGA3D_SURFACE_SCREENTARGET;
1481
1482	/*
1483	 * From this point, the generic resource management functions
1484	 * destroy the object on failure.
1485	 */
1486	ret = vmw_surface_init(dev_priv, srf, vmw_user_surface_free);
1487
1488	ttm_read_unlock(&dev_priv->reservation_sem);
1489	return ret;
1490
1491out_no_user_srf:
1492	ttm_mem_global_free(vmw_mem_glob(dev_priv), user_accounting_size);
1493
1494out_unlock:
1495	ttm_read_unlock(&dev_priv->reservation_sem);
1496	return ret;
1497}
1498
1499/**
1500 * vmw_gb_surface_define_ext_ioctl - Ioctl function implementing
1501 * the user surface define functionality.
1502 *
1503 * @dev: Pointer to a struct drm_device.
1504 * @data: Pointer to data copied from / to user-space.
1505 * @file_priv: Pointer to a drm file private structure.
1506 */
1507int vmw_gb_surface_define_ext_ioctl(struct drm_device *dev, void *data,
1508				struct drm_file *file_priv)
1509{
1510	union drm_vmw_gb_surface_create_ext_arg *arg =
1511	    (union drm_vmw_gb_surface_create_ext_arg *)data;
1512	struct drm_vmw_gb_surface_create_ext_req *req = &arg->req;
1513	struct drm_vmw_gb_surface_create_rep *rep = &arg->rep;
1514
1515	return vmw_gb_surface_define_internal(dev, req, rep, file_priv);
1516}
1517
1518/**
1519 * vmw_gb_surface_reference_ext_ioctl - Ioctl function implementing
1520 * the user surface reference functionality.
1521 *
1522 * @dev: Pointer to a struct drm_device.
1523 * @data: Pointer to data copied from / to user-space.
1524 * @file_priv: Pointer to a drm file private structure.
1525 */
1526int vmw_gb_surface_reference_ext_ioctl(struct drm_device *dev, void *data,
1527				   struct drm_file *file_priv)
1528{
1529	union drm_vmw_gb_surface_reference_ext_arg *arg =
1530	    (union drm_vmw_gb_surface_reference_ext_arg *)data;
1531	struct drm_vmw_surface_arg *req = &arg->req;
1532	struct drm_vmw_gb_surface_ref_ext_rep *rep = &arg->rep;
1533
1534	return vmw_gb_surface_reference_internal(dev, req, rep, file_priv);
1535}
1536
1537/**
1538 * vmw_gb_surface_define_internal - Ioctl function implementing
1539 * the user surface define functionality.
1540 *
1541 * @dev: Pointer to a struct drm_device.
1542 * @req: Request argument from user-space.
1543 * @rep: Response argument to user-space.
1544 * @file_priv: Pointer to a drm file private structure.
1545 */
1546static int
1547vmw_gb_surface_define_internal(struct drm_device *dev,
1548			       struct drm_vmw_gb_surface_create_ext_req *req,
1549			       struct drm_vmw_gb_surface_create_rep *rep,
1550			       struct drm_file *file_priv)
1551{
 
1552	struct vmw_private *dev_priv = vmw_priv(dev);
1553	struct vmw_user_surface *user_srf;
 
1554	struct vmw_surface *srf;
1555	struct vmw_resource *res;
1556	struct vmw_resource *tmp;
1557	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
1558	int ret;
1559	uint32_t size;
1560	uint32_t backup_handle = 0;
1561	SVGA3dSurfaceAllFlags svga3d_flags_64 =
1562		SVGA3D_FLAGS_64(req->svga3d_flags_upper_32_bits,
1563				req->base.svga3d_flags);
1564
1565	if (!dev_priv->has_sm4_1) {
1566		/*
1567		 * If SM4_1 is not support then cannot send 64-bit flag to
1568		 * device.
1569		 */
 
 
1570		if (req->svga3d_flags_upper_32_bits != 0)
1571			return -EINVAL;
1572
1573		if (req->base.multisample_count != 0)
1574			return -EINVAL;
1575
1576		if (req->multisample_pattern != SVGA3D_MS_PATTERN_NONE)
1577			return -EINVAL;
1578
1579		if (req->quality_level != SVGA3D_MS_QUALITY_NONE)
1580			return -EINVAL;
 
 
 
 
 
 
 
 
 
 
1581	}
1582
1583	if ((svga3d_flags_64 & SVGA3D_SURFACE_MULTISAMPLE) &&
1584	    req->base.multisample_count == 0)
 
1585		return -EINVAL;
 
1586
1587	if (req->base.mip_levels > DRM_VMW_MAX_MIP_LEVELS)
 
1588		return -EINVAL;
 
1589
1590	if (unlikely(vmw_user_surface_size == 0))
1591		vmw_user_surface_size = ttm_round_pot(sizeof(*user_srf)) +
1592			VMW_IDA_ACC_SIZE + TTM_OBJ_EXTRA_SIZE;
1593
1594	size = vmw_user_surface_size;
 
 
 
 
 
 
 
1595
1596	/* Define a surface based on the parameters. */
1597	ret = vmw_surface_gb_priv_define(dev,
1598					 size,
1599					 svga3d_flags_64,
1600					 req->base.format,
1601					 req->base.drm_surface_flags &
1602					 drm_vmw_surface_flag_scanout,
1603					 req->base.mip_levels,
1604					 req->base.multisample_count,
1605					 req->base.array_size,
1606					 req->base.base_size,
1607					 req->multisample_pattern,
1608					 req->quality_level,
1609					 &srf);
1610	if (unlikely(ret != 0))
1611		return ret;
 
1612
1613	user_srf = container_of(srf, struct vmw_user_surface, srf);
1614	if (drm_is_primary_client(file_priv))
1615		user_srf->master = drm_master_get(file_priv->master);
1616
1617	ret = ttm_read_lock(&dev_priv->reservation_sem, true);
1618	if (unlikely(ret != 0))
1619		return ret;
1620
1621	res = &user_srf->srf.res;
1622
1623	if (req->base.buffer_handle != SVGA3D_INVALID_ID) {
1624		ret = vmw_user_bo_lookup(tfile, req->base.buffer_handle,
1625					 &res->backup,
1626					 &user_srf->backup_base);
1627		if (ret == 0) {
1628			if (res->backup->base.num_pages * PAGE_SIZE <
1629			    res->backup_size) {
 
 
 
 
1630				VMW_DEBUG_USER("Surface backup buffer too small.\n");
1631				vmw_bo_unreference(&res->backup);
1632				ret = -EINVAL;
1633				goto out_unlock;
1634			} else {
1635				backup_handle = req->base.buffer_handle;
1636			}
1637		}
1638	} else if (req->base.drm_surface_flags &
1639		   drm_vmw_surface_flag_create_buffer)
1640		ret = vmw_user_bo_alloc(dev_priv, tfile,
1641					res->backup_size,
1642					req->base.drm_surface_flags &
1643					drm_vmw_surface_flag_shareable,
1644					&backup_handle,
1645					&res->backup,
1646					&user_srf->backup_base);
1647
1648	if (unlikely(ret != 0)) {
1649		vmw_resource_unreference(&res);
1650		goto out_unlock;
1651	}
1652
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1653	tmp = vmw_resource_reference(res);
1654	ret = ttm_prime_object_init(tfile, res->backup_size, &user_srf->prime,
1655				    req->base.drm_surface_flags &
1656				    drm_vmw_surface_flag_shareable,
1657				    VMW_RES_SURFACE,
1658				    &vmw_user_surface_base_release, NULL);
1659
1660	if (unlikely(ret != 0)) {
1661		vmw_resource_unreference(&tmp);
1662		vmw_resource_unreference(&res);
1663		goto out_unlock;
1664	}
1665
1666	rep->handle      = user_srf->prime.base.handle;
1667	rep->backup_size = res->backup_size;
1668	if (res->backup) {
 
1669		rep->buffer_map_handle =
1670			drm_vma_node_offset_addr(&res->backup->base.base.vma_node);
1671		rep->buffer_size = res->backup->base.num_pages * PAGE_SIZE;
1672		rep->buffer_handle = backup_handle;
1673	} else {
1674		rep->buffer_map_handle = 0;
1675		rep->buffer_size = 0;
1676		rep->buffer_handle = SVGA3D_INVALID_ID;
1677	}
1678
1679	vmw_resource_unreference(&res);
1680
1681out_unlock:
1682	ttm_read_unlock(&dev_priv->reservation_sem);
1683	return ret;
1684}
1685
1686/**
1687 * vmw_gb_surface_reference_internal - Ioctl function implementing
1688 * the user surface reference functionality.
1689 *
1690 * @dev: Pointer to a struct drm_device.
1691 * @req: Pointer to user-space request surface arg.
1692 * @rep: Pointer to response to user-space.
1693 * @file_priv: Pointer to a drm file private structure.
1694 */
1695static int
1696vmw_gb_surface_reference_internal(struct drm_device *dev,
1697				  struct drm_vmw_surface_arg *req,
1698				  struct drm_vmw_gb_surface_ref_ext_rep *rep,
1699				  struct drm_file *file_priv)
1700{
1701	struct vmw_private *dev_priv = vmw_priv(dev);
1702	struct ttm_object_file *tfile = vmw_fpriv(file_priv)->tfile;
1703	struct vmw_surface *srf;
1704	struct vmw_user_surface *user_srf;
 
1705	struct ttm_base_object *base;
1706	uint32_t backup_handle;
1707	int ret = -EINVAL;
1708
1709	ret = vmw_surface_handle_reference(dev_priv, file_priv, req->sid,
1710					   req->handle_type, &base);
1711	if (unlikely(ret != 0))
1712		return ret;
1713
1714	user_srf = container_of(base, struct vmw_user_surface, prime.base);
1715	srf = &user_srf->srf;
1716	if (!srf->res.backup) {
1717		DRM_ERROR("Shared GB surface is missing a backup buffer.\n");
1718		goto out_bad_resource;
1719	}
 
1720
1721	mutex_lock(&dev_priv->cmdbuf_mutex); /* Protect res->backup */
1722	ret = vmw_user_bo_reference(tfile, srf->res.backup, &backup_handle);
 
1723	mutex_unlock(&dev_priv->cmdbuf_mutex);
1724
1725	if (unlikely(ret != 0)) {
1726		DRM_ERROR("Could not add a reference to a GB surface "
1727			  "backup buffer.\n");
1728		(void) ttm_ref_object_base_unref(tfile, base->handle,
1729						 TTM_REF_USAGE);
1730		goto out_bad_resource;
1731	}
1732
1733	rep->creq.base.svga3d_flags = SVGA3D_FLAGS_LOWER_32(srf->flags);
1734	rep->creq.base.format = srf->format;
1735	rep->creq.base.mip_levels = srf->mip_levels[0];
1736	rep->creq.base.drm_surface_flags = 0;
1737	rep->creq.base.multisample_count = srf->multisample_count;
1738	rep->creq.base.autogen_filter = srf->autogen_filter;
1739	rep->creq.base.array_size = srf->array_size;
1740	rep->creq.base.buffer_handle = backup_handle;
1741	rep->creq.base.base_size = srf->base_size;
1742	rep->crep.handle = user_srf->prime.base.handle;
1743	rep->crep.backup_size = srf->res.backup_size;
1744	rep->crep.buffer_handle = backup_handle;
1745	rep->crep.buffer_map_handle =
1746		drm_vma_node_offset_addr(&srf->res.backup->base.base.vma_node);
1747	rep->crep.buffer_size = srf->res.backup->base.num_pages * PAGE_SIZE;
1748
1749	rep->creq.version = drm_vmw_gb_surface_v1;
1750	rep->creq.svga3d_flags_upper_32_bits =
1751		SVGA3D_FLAGS_UPPER_32(srf->flags);
1752	rep->creq.multisample_pattern = srf->multisample_pattern;
1753	rep->creq.quality_level = srf->quality_level;
1754	rep->creq.must_be_zero = 0;
1755
1756out_bad_resource:
1757	ttm_base_object_unref(&base);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1758
1759	return ret;
1760}