1 // SPDX-License-Identifier: GPL-2.0 OR MIT
4  * Copyright 2011-2015 VMware, Inc., Palo Alto, CA., USA
20  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
45  * struct vmw_kms_sou_surface_dirty - Closure structure for
48  * @left: Left side of bounding box.
50  * @top: Top side of bounding box.
58 	s32 left, right, top, bottom;  member
101 	vmw_du_cleanup(&sou->base);  in vmw_sou_destroy()
132 	BUG_ON(!sou->buffer);  in vmw_sou_fifo_create()
137 		return -ENOMEM;  in vmw_sou_fifo_create()
140 	cmd->header.cmdType = SVGA_CMD_DEFINE_SCREEN;  in vmw_sou_fifo_create()
141 	cmd->obj.structSize = sizeof(SVGAScreenObject);  in vmw_sou_fifo_create()
142 	cmd->obj.id = sou->base.unit;  in vmw_sou_fifo_create()
143 	cmd->obj.flags = SVGA_SCREEN_HAS_ROOT |  in vmw_sou_fifo_create()
144 		(sou->base.unit == 0 ? SVGA_SCREEN_IS_PRIMARY : 0);  in vmw_sou_fifo_create()
145 	cmd->obj.size.width = mode->hdisplay;  in vmw_sou_fifo_create()
146 	cmd->obj.size.height = mode->vdisplay;  in vmw_sou_fifo_create()
147 	cmd->obj.root.x = x;  in vmw_sou_fifo_create()
148 	cmd->obj.root.y = y;  in vmw_sou_fifo_create()
149 	sou->base.set_gui_x = cmd->obj.root.x;  in vmw_sou_fifo_create()
150 	sou->base.set_gui_y = cmd->obj.root.y;  in vmw_sou_fifo_create()
153 	vmw_bo_get_guest_ptr(&sou->buffer->base, &cmd->obj.backingStore.ptr);  in vmw_sou_fifo_create()
154 	cmd->obj.backingStore.pitch = mode->hdisplay * 4;  in vmw_sou_fifo_create()
158 	sou->defined = true;  in vmw_sou_fifo_create()
180 	if (unlikely(!sou->defined))  in vmw_sou_fifo_destroy()
186 		return -ENOMEM;  in vmw_sou_fifo_destroy()
189 	cmd->header.cmdType = SVGA_CMD_DESTROY_SCREEN;  in vmw_sou_fifo_destroy()
190 	cmd->body.screenId = sou->base.unit;  in vmw_sou_fifo_destroy()
199 		sou->defined = false;  in vmw_sou_fifo_destroy()
205  * vmw_sou_crtc_mode_set_nofb - Create new screen
223 	dev_priv = vmw_priv(crtc->dev);  in vmw_sou_crtc_mode_set_nofb()
224 	ps = crtc->primary->state;  in vmw_sou_crtc_mode_set_nofb()
225 	fb = ps->fb;  in vmw_sou_crtc_mode_set_nofb()
230 	if (sou->defined) {  in vmw_sou_crtc_mode_set_nofb()
243 		sou->buffer = vps->bo;  in vmw_sou_crtc_mode_set_nofb()
244 		sou->buffer_size = vps->bo_size;  in vmw_sou_crtc_mode_set_nofb()
246 		conn_state = sou->base.connector.state;  in vmw_sou_crtc_mode_set_nofb()
249 		x = vmw_conn_state->gui_x;  in vmw_sou_crtc_mode_set_nofb()
250 		y = vmw_conn_state->gui_y;  in vmw_sou_crtc_mode_set_nofb()
252 		ret = vmw_sou_fifo_create(dev_priv, sou, x, y, &crtc->mode);  in vmw_sou_crtc_mode_set_nofb()
255 				  crtc->x, crtc->y);  in vmw_sou_crtc_mode_set_nofb()
258 		sou->buffer = NULL;  in vmw_sou_crtc_mode_set_nofb()
259 		sou->buffer_size = 0;  in vmw_sou_crtc_mode_set_nofb()
264  * vmw_sou_crtc_helper_prepare - Noop
275  * vmw_sou_crtc_atomic_enable - Noop
288  * vmw_sou_crtc_atomic_disable - Turns off CRTC
307 	dev_priv = vmw_priv(crtc->dev);  in vmw_sou_crtc_atomic_disable()
309 	if (sou->defined) {  in vmw_sou_crtc_atomic_disable()
373  * vmw_sou_primary_plane_cleanup_fb - Frees sou backing buffer
387 	struct drm_crtc *crtc = plane->state->crtc ?  in vmw_sou_primary_plane_cleanup_fb()
388 		plane->state->crtc : old_state->crtc;  in vmw_sou_primary_plane_cleanup_fb()
390 	if (vps->bo)  in vmw_sou_primary_plane_cleanup_fb()
391 		vmw_bo_unpin(vmw_priv(crtc->dev), vps->bo, false);  in vmw_sou_primary_plane_cleanup_fb()
392 	vmw_bo_unreference(&vps->bo);  in vmw_sou_primary_plane_cleanup_fb()
393 	vps->bo_size = 0;  in vmw_sou_primary_plane_cleanup_fb()
400  * vmw_sou_primary_plane_prepare_fb - allocate backing buffer
413 	struct drm_framebuffer *new_fb = new_state->fb;  in vmw_sou_primary_plane_prepare_fb()
414 	struct drm_crtc *crtc = plane->state->crtc ?: new_state->crtc;  in vmw_sou_primary_plane_prepare_fb()
422 		vmw_bo_unreference(&vps->bo);  in vmw_sou_primary_plane_prepare_fb()
423 		vps->bo_size = 0;  in vmw_sou_primary_plane_prepare_fb()
428 	size = new_state->crtc_w * new_state->crtc_h * 4;  in vmw_sou_primary_plane_prepare_fb()
429 	dev_priv = vmw_priv(crtc->dev);  in vmw_sou_primary_plane_prepare_fb()
431 	if (vps->bo) {  in vmw_sou_primary_plane_prepare_fb()
432 		if (vps->bo_size == size) {  in vmw_sou_primary_plane_prepare_fb()
434 			 * Note that this might temporarily up the pin-count  in vmw_sou_primary_plane_prepare_fb()
437 			return vmw_bo_pin_in_vram(dev_priv, vps->bo,  in vmw_sou_primary_plane_prepare_fb()
441 		vmw_bo_unreference(&vps->bo);  in vmw_sou_primary_plane_prepare_fb()
442 		vps->bo_size = 0;  in vmw_sou_primary_plane_prepare_fb()
445 	vps->bo = kzalloc(sizeof(*vps->bo), GFP_KERNEL);  in vmw_sou_primary_plane_prepare_fb()
446 	if (!vps->bo)  in vmw_sou_primary_plane_prepare_fb()
447 		return -ENOMEM;  in vmw_sou_primary_plane_prepare_fb()
455 	ret = vmw_bo_init(dev_priv, vps->bo, size,  in vmw_sou_primary_plane_prepare_fb()
460 		vps->bo = NULL; /* vmw_bo_init frees on error */  in vmw_sou_primary_plane_prepare_fb()
464 	vps->bo_size = size;  in vmw_sou_primary_plane_prepare_fb()
470 	return vmw_bo_pin_in_vram(dev_priv, vps->bo, true);  in vmw_sou_primary_plane_prepare_fb()
484 		container_of(update->vfb, typeof(*vfbbo), base);  in vmw_sou_bo_define_gmrfb()
486 	int depth = update->vfb->base.format->depth;  in vmw_sou_bo_define_gmrfb()
495 	gmr->header = SVGA_CMD_DEFINE_GMRFB;  in vmw_sou_bo_define_gmrfb()
497 	gmr->body.format.bitsPerPixel = update->vfb->base.format->cpp[0] * 8;  in vmw_sou_bo_define_gmrfb()
498 	gmr->body.format.colorDepth = depth;  in vmw_sou_bo_define_gmrfb()
499 	gmr->body.format.reserved = 0;  in vmw_sou_bo_define_gmrfb()
500 	gmr->body.bytesPerLine = update->vfb->base.pitches[0];  in vmw_sou_bo_define_gmrfb()
501 	vmw_bo_get_guest_ptr(&vfbbo->buffer->base, &gmr->body.ptr);  in vmw_sou_bo_define_gmrfb()
512 	blit->header = SVGA_CMD_BLIT_GMRFB_TO_SCREEN;  in vmw_sou_bo_populate_clip()
513 	blit->body.destScreenId = update->du->unit;  in vmw_sou_bo_populate_clip()
514 	blit->body.srcOrigin.x = fb_x;  in vmw_sou_bo_populate_clip()
515 	blit->body.srcOrigin.y = fb_y;  in vmw_sou_bo_populate_clip()
516 	blit->body.destRect.left = clip->x1;  in vmw_sou_bo_populate_clip()
517 	blit->body.destRect.top = clip->y1;  in vmw_sou_bo_populate_clip()
518 	blit->body.destRect.right = clip->x2;  in vmw_sou_bo_populate_clip()
519 	blit->body.destRect.bottom = clip->y2;  in vmw_sou_bo_populate_clip()
531  * vmw_sou_plane_update_bo - Update display unit for bo backed fb.
536  * @out_fence: If non-NULL, will return a ref-counted pointer to vmw_fence_obj.
554 	bo_update.base.du = vmw_crtc_to_du(plane->state->crtc);  in vmw_sou_plane_update_bo()
588 	srf_update->cmd_start = cmd;  in vmw_sou_surface_post_prepare()
599 	vfbs = container_of(update->vfb, typeof(*vfbs), base);  in vmw_sou_surface_pre_clip()
601 	blit->header.id = SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN;  in vmw_sou_surface_pre_clip()
602 	blit->header.size = sizeof(blit->body) + sizeof(SVGASignedRect) *  in vmw_sou_surface_pre_clip()
605 	blit->body.srcImage.sid = vfbs->surface->res.id;  in vmw_sou_surface_pre_clip()
606 	blit->body.destScreenId = update->du->unit;  in vmw_sou_surface_pre_clip()
609 	blit->body.srcRect.left = 0;  in vmw_sou_surface_pre_clip()
610 	blit->body.srcRect.top = 0;  in vmw_sou_surface_pre_clip()
611 	blit->body.srcRect.right = 0;  in vmw_sou_surface_pre_clip()
612 	blit->body.srcRect.bottom = 0;  in vmw_sou_surface_pre_clip()
614 	blit->body.destRect.left = 0;  in vmw_sou_surface_pre_clip()
615 	blit->body.destRect.top = 0;  in vmw_sou_surface_pre_clip()
616 	blit->body.destRect.right = 0;  in vmw_sou_surface_pre_clip()
617 	blit->body.destRect.bottom = 0;  in vmw_sou_surface_pre_clip()
632 	rect->left = clip->x1;  in vmw_sou_surface_clip_rect()
633 	rect->top = clip->y1;  in vmw_sou_surface_clip_rect()
634 	rect->right = clip->x2;  in vmw_sou_surface_clip_rect()
635 	rect->bottom = clip->y2;  in vmw_sou_surface_clip_rect()
644 	struct drm_plane_state *state = update->plane->state;  in vmw_sou_surface_post_clip()
655 	blit = srf_update->cmd_start;  in vmw_sou_surface_post_clip()
658 	num_hits = (blit->header.size - sizeof(blit->body))/  in vmw_sou_surface_post_clip()
664 	translate_src_x = (state->src_x >> 16) - state->crtc_x;  in vmw_sou_surface_post_clip()
665 	translate_src_y = (state->src_y >> 16) - state->crtc_y;  in vmw_sou_surface_post_clip()
669 	blit->body.srcRect.left = src_bb.x1;  in vmw_sou_surface_post_clip()
670 	blit->body.srcRect.top = src_bb.y1;  in vmw_sou_surface_post_clip()
671 	blit->body.srcRect.right = src_bb.x2;  in vmw_sou_surface_post_clip()
672 	blit->body.srcRect.bottom = src_bb.y2;  in vmw_sou_surface_post_clip()
674 	blit->body.destRect.left = bb->x1;  in vmw_sou_surface_post_clip()
675 	blit->body.destRect.top = bb->y1;  in vmw_sou_surface_post_clip()
676 	blit->body.destRect.right = bb->x2;  in vmw_sou_surface_post_clip()
677 	blit->body.destRect.bottom = bb->y2;  in vmw_sou_surface_post_clip()
681 		rect->left -= bb->x1;  in vmw_sou_surface_post_clip()
682 		rect->top -= bb->y1;  in vmw_sou_surface_post_clip()
683 		rect->right -= bb->x1;  in vmw_sou_surface_post_clip()
684 		rect->bottom -= bb->y1;  in vmw_sou_surface_post_clip()
692  * vmw_sou_plane_update_surface - Update display unit for surface backed fb.
697  * @out_fence: If non-NULL, will return a ref-counted pointer to vmw_fence_obj.
715 	srf_update.base.du = vmw_crtc_to_du(plane->state->crtc);  in vmw_sou_plane_update_surface()
718 	srf_update.base.mutex = &dev_priv->cmdbuf_mutex;  in vmw_sou_plane_update_surface()
737 	struct drm_crtc *crtc = new_state->crtc;  in vmw_sou_primary_plane_atomic_update()
743 	if (crtc && new_state->fb) {  in vmw_sou_primary_plane_atomic_update()
744 		struct vmw_private *dev_priv = vmw_priv(crtc->dev);  in vmw_sou_primary_plane_atomic_update()
746 			vmw_framebuffer_to_vfb(new_state->fb);  in vmw_sou_primary_plane_atomic_update()
748 		if (vfb->bo)  in vmw_sou_primary_plane_atomic_update()
763 	event = crtc->state->event;  in vmw_sou_primary_plane_atomic_update()
765 		struct drm_file *file_priv = event->base.file_priv;  in vmw_sou_primary_plane_atomic_update()
769 						   &event->base,  in vmw_sou_primary_plane_atomic_update()
770 						   &event->event.vbl.tv_sec,  in vmw_sou_primary_plane_atomic_update()
771 						   &event->event.vbl.tv_usec,  in vmw_sou_primary_plane_atomic_update()
777 			crtc->state->event = NULL;  in vmw_sou_primary_plane_atomic_update()
836 	struct drm_device *dev = &dev_priv->drm;  in vmw_sou_init()
845 		return -ENOMEM;  in vmw_sou_init()
847 	sou->base.unit = unit;  in vmw_sou_init()
848 	crtc = &sou->base.crtc;  in vmw_sou_init()
849 	encoder = &sou->base.encoder;  in vmw_sou_init()
850 	connector = &sou->base.connector;  in vmw_sou_init()
851 	primary = &sou->base.primary;  in vmw_sou_init()
852 	cursor = &sou->base.cursor;  in vmw_sou_init()
854 	sou->base.pref_active = (unit == 0);  in vmw_sou_init()
855 	sou->base.pref_width = dev_priv->initial_width;  in vmw_sou_init()
856 	sou->base.pref_height = dev_priv->initial_height;  in vmw_sou_init()
857 	sou->base.pref_mode = NULL;  in vmw_sou_init()
863 	sou->base.is_implicit = false;  in vmw_sou_init()
866 	ret = drm_universal_plane_init(dev, &sou->base.primary,  in vmw_sou_init()
880 	ret = drm_universal_plane_init(dev, &sou->base.cursor,  in vmw_sou_init()
887 		drm_plane_cleanup(&sou->base.primary);  in vmw_sou_init()
901 	connector->status = vmw_du_connector_detect(connector, true);  in vmw_sou_init()
911 	encoder->possible_crtcs = (1 << unit);  in vmw_sou_init()
912 	encoder->possible_clones = 0;  in vmw_sou_init()
920 	ret = drm_crtc_init_with_planes(dev, crtc, &sou->base.primary,  in vmw_sou_init()
921 					&sou->base.cursor,  in vmw_sou_init()
932 	drm_object_attach_property(&connector->base,  in vmw_sou_init()
933 				   dev_priv->hotplug_mode_update_property, 1);  in vmw_sou_init()
934 	drm_object_attach_property(&connector->base,  in vmw_sou_init()
935 				   dev->mode_config.suggested_x_property, 0);  in vmw_sou_init()
936 	drm_object_attach_property(&connector->base,  in vmw_sou_init()
937 				   dev->mode_config.suggested_y_property, 0);  in vmw_sou_init()
953 	struct drm_device *dev = &dev_priv->drm;  in vmw_kms_sou_init_display()
956 	if (!(dev_priv->capabilities & SVGA_CAP_SCREEN_OBJECT_2)) {  in vmw_kms_sou_init_display()
957 		return -ENOSYS;  in vmw_kms_sou_init_display()
960 	ret = -ENOMEM;  in vmw_kms_sou_init_display()
969 	dev_priv->active_display_unit = vmw_du_screen_object;  in vmw_kms_sou_init_display()
981 			     base)->buffer;  in do_bo_define_gmrfb()
982 	int depth = framebuffer->base.format->depth;  in do_bo_define_gmrfb()
997 		return -ENOMEM;  in do_bo_define_gmrfb()
999 	cmd->header = SVGA_CMD_DEFINE_GMRFB;  in do_bo_define_gmrfb()
1000 	cmd->body.format.bitsPerPixel = framebuffer->base.format->cpp[0] * 8;  in do_bo_define_gmrfb()
1001 	cmd->body.format.colorDepth = depth;  in do_bo_define_gmrfb()
1002 	cmd->body.format.reserved = 0;  in do_bo_define_gmrfb()
1003 	cmd->body.bytesPerLine = framebuffer->base.pitches[0];  in do_bo_define_gmrfb()
1005 	vmw_bo_get_guest_ptr(&buf->base, &cmd->body.ptr);  in do_bo_define_gmrfb()
1012  * vmw_sou_surface_fifo_commit - Callback to fill in and submit a
1024 	struct vmw_kms_sou_dirty_cmd *cmd = dirty->cmd;  in vmw_sou_surface_fifo_commit()
1025 	s32 trans_x = dirty->unit->crtc.x - sdirty->dst_x;  in vmw_sou_surface_fifo_commit()
1026 	s32 trans_y = dirty->unit->crtc.y - sdirty->dst_y;  in vmw_sou_surface_fifo_commit()
1027 	size_t region_size = dirty->num_hits * sizeof(SVGASignedRect);  in vmw_sou_surface_fifo_commit()
1031 	if (!dirty->num_hits) {  in vmw_sou_surface_fifo_commit()
1032 		vmw_cmd_commit(dirty->dev_priv, 0);  in vmw_sou_surface_fifo_commit()
1036 	cmd->header.id = SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN;  in vmw_sou_surface_fifo_commit()
1037 	cmd->header.size = sizeof(cmd->body) + region_size;  in vmw_sou_surface_fifo_commit()
1040 	 * Use the destination bounding box to specify destination - and  in vmw_sou_surface_fifo_commit()
1043 	cmd->body.destRect.left = sdirty->left;  in vmw_sou_surface_fifo_commit()
1044 	cmd->body.destRect.right = sdirty->right;  in vmw_sou_surface_fifo_commit()
1045 	cmd->body.destRect.top = sdirty->top;  in vmw_sou_surface_fifo_commit()
1046 	cmd->body.destRect.bottom = sdirty->bottom;  in vmw_sou_surface_fifo_commit()
1048 	cmd->body.srcRect.left = sdirty->left + trans_x;  in vmw_sou_surface_fifo_commit()
1049 	cmd->body.srcRect.right = sdirty->right + trans_x;  in vmw_sou_surface_fifo_commit()
1050 	cmd->body.srcRect.top = sdirty->top + trans_y;  in vmw_sou_surface_fifo_commit()
1051 	cmd->body.srcRect.bottom = sdirty->bottom + trans_y;  in vmw_sou_surface_fifo_commit()
1053 	cmd->body.srcImage.sid = sdirty->sid;  in vmw_sou_surface_fifo_commit()
1054 	cmd->body.destScreenId = dirty->unit->unit;  in vmw_sou_surface_fifo_commit()
1057 	for (i = 0; i < dirty->num_hits; ++i, ++blit) {  in vmw_sou_surface_fifo_commit()
1058 		blit->left -= sdirty->left;  in vmw_sou_surface_fifo_commit()
1059 		blit->right -= sdirty->left;  in vmw_sou_surface_fifo_commit()
1060 		blit->top -= sdirty->top;  in vmw_sou_surface_fifo_commit()
1061 		blit->bottom -= sdirty->top;  in vmw_sou_surface_fifo_commit()
1064 	vmw_cmd_commit(dirty->dev_priv, region_size + sizeof(*cmd));  in vmw_sou_surface_fifo_commit()
1066 	sdirty->left = sdirty->top = S32_MAX;  in vmw_sou_surface_fifo_commit()
1067 	sdirty->right = sdirty->bottom = S32_MIN;  in vmw_sou_surface_fifo_commit()
1071  * vmw_sou_surface_clip - Callback to encode a blit surface to screen cliprect.
1082 	struct vmw_kms_sou_dirty_cmd *cmd = dirty->cmd;  in vmw_sou_surface_clip()
1086 	blit += dirty->num_hits;  in vmw_sou_surface_clip()
1087 	blit->left = dirty->unit_x1;  in vmw_sou_surface_clip()
1088 	blit->top = dirty->unit_y1;  in vmw_sou_surface_clip()
1089 	blit->right = dirty->unit_x2;  in vmw_sou_surface_clip()
1090 	blit->bottom = dirty->unit_y2;  in vmw_sou_surface_clip()
1093 	sdirty->left = min_t(s32, sdirty->left, dirty->unit_x1);  in vmw_sou_surface_clip()
1094 	sdirty->top = min_t(s32, sdirty->top, dirty->unit_y1);  in vmw_sou_surface_clip()
1095 	sdirty->right = max_t(s32, sdirty->right, dirty->unit_x2);  in vmw_sou_surface_clip()
1096 	sdirty->bottom = max_t(s32, sdirty->bottom, dirty->unit_y2);  in vmw_sou_surface_clip()
1098 	dirty->num_hits++;  in vmw_sou_surface_clip()
1102  * vmw_kms_sou_do_surface_dirty - Dirty part of a surface backed framebuffer
1105  * @framebuffer: Pointer to the surface-buffer backed framebuffer.
1115  * @out_fence: If non-NULL, will return a ref-counted pointer to a
1120  * Returns 0 on success, negative error code on failure. -ERESTARTSYS if
1141 		srf = &vfbs->surface->res;  in vmw_kms_sou_do_surface_dirty()
1148 	ret = vmw_validation_prepare(&val_ctx, &dev_priv->cmdbuf_mutex, true);  in vmw_kms_sou_do_surface_dirty()
1159 	sdirty.sid = srf->id;  in vmw_kms_sou_do_surface_dirty()
1160 	sdirty.left = sdirty.top = S32_MAX;  in vmw_kms_sou_do_surface_dirty()
1179  * vmw_sou_bo_fifo_commit - Callback to submit a set of readback clips.
1187 	if (!dirty->num_hits) {  in vmw_sou_bo_fifo_commit()
1188 		vmw_cmd_commit(dirty->dev_priv, 0);  in vmw_sou_bo_fifo_commit()
1192 	vmw_cmd_commit(dirty->dev_priv,  in vmw_sou_bo_fifo_commit()
1194 			dirty->num_hits);  in vmw_sou_bo_fifo_commit()
1198  * vmw_sou_bo_clip - Callback to encode a readback cliprect.
1206 	struct vmw_kms_sou_bo_blit *blit = dirty->cmd;  in vmw_sou_bo_clip()
1208 	blit += dirty->num_hits;  in vmw_sou_bo_clip()
1209 	blit->header = SVGA_CMD_BLIT_GMRFB_TO_SCREEN;  in vmw_sou_bo_clip()
1210 	blit->body.destScreenId = dirty->unit->unit;  in vmw_sou_bo_clip()
1211 	blit->body.srcOrigin.x = dirty->fb_x;  in vmw_sou_bo_clip()
1212 	blit->body.srcOrigin.y = dirty->fb_y;  in vmw_sou_bo_clip()
1213 	blit->body.destRect.left = dirty->unit_x1;  in vmw_sou_bo_clip()
1214 	blit->body.destRect.top = dirty->unit_y1;  in vmw_sou_bo_clip()
1215 	blit->body.destRect.right = dirty->unit_x2;  in vmw_sou_bo_clip()
1216 	blit->body.destRect.bottom = dirty->unit_y2;  in vmw_sou_bo_clip()
1217 	dirty->num_hits++;  in vmw_sou_bo_clip()
1221  * vmw_kms_sou_do_bo_dirty - Dirty part of a buffer-object backed framebuffer
1224  * @framebuffer: Pointer to the buffer-object backed framebuffer.
1231  * @out_fence: If non-NULL, will return a ref-counted pointer to a
1236  * Returns 0 on success, negative error code on failure. -ERESTARTSYS if
1250 			     base)->buffer;  in vmw_kms_sou_do_bo_dirty()
1289  * vmw_sou_readback_fifo_commit - Callback to submit a set of readback clips.
1297 	if (!dirty->num_hits) {  in vmw_sou_readback_fifo_commit()
1298 		vmw_cmd_commit(dirty->dev_priv, 0);  in vmw_sou_readback_fifo_commit()
1302 	vmw_cmd_commit(dirty->dev_priv,  in vmw_sou_readback_fifo_commit()
1304 			dirty->num_hits);  in vmw_sou_readback_fifo_commit()
1308  * vmw_sou_readback_clip - Callback to encode a readback cliprect.
1316 	struct vmw_kms_sou_readback_blit *blit = dirty->cmd;  in vmw_sou_readback_clip()
1318 	blit += dirty->num_hits;  in vmw_sou_readback_clip()
1319 	blit->header = SVGA_CMD_BLIT_SCREEN_TO_GMRFB;  in vmw_sou_readback_clip()
1320 	blit->body.srcScreenId = dirty->unit->unit;  in vmw_sou_readback_clip()
1321 	blit->body.destOrigin.x = dirty->fb_x;  in vmw_sou_readback_clip()
1322 	blit->body.destOrigin.y = dirty->fb_y;  in vmw_sou_readback_clip()
1323 	blit->body.srcRect.left = dirty->unit_x1;  in vmw_sou_readback_clip()
1324 	blit->body.srcRect.top = dirty->unit_y1;  in vmw_sou_readback_clip()
1325 	blit->body.srcRect.right = dirty->unit_x2;  in vmw_sou_readback_clip()
1326 	blit->body.srcRect.bottom = dirty->unit_y2;  in vmw_sou_readback_clip()
1327 	dirty->num_hits++;  in vmw_sou_readback_clip()
1331  * vmw_kms_sou_readback - Perform a readback from the screen object system to
1332  * a buffer-object backed framebuffer.
1337  * @vfb: Pointer to the buffer-object backed framebuffer.
1338  * @user_fence_rep: User-space provided structure for fence information.
1339  * Must be set to non-NULL if @file_priv is non-NULL.
1344  * Returns 0 on success, negative error code on failure. -ERESTARTSYS if
1356 		container_of(vfb, struct vmw_framebuffer_bo, base)->buffer;  in vmw_kms_sou_readback()