xref: /openbsd-src/sys/dev/pci/drm/drm_atomic.c (revision ae3cb403620ab940fbaabb3055fac045a63d56b7)
1 /*
2  * Copyright (C) 2014 Red Hat
3  * Copyright (C) 2014 Intel Corp.
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be included in
13  * all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21  * OTHER DEALINGS IN THE SOFTWARE.
22  *
23  * Authors:
24  * Rob Clark <robdclark@gmail.com>
25  * Daniel Vetter <daniel.vetter@ffwll.ch>
26  */
27 
28 
29 #include <dev/pci/drm/drmP.h>
30 #include <dev/pci/drm/drm_atomic.h>
31 #include <dev/pci/drm/drm_plane_helper.h>
32 
33 /**
34  * drm_atomic_state_default_release -
35  * release memory initialized by drm_atomic_state_init
36  * @state: atomic state
37  *
38  * Free all the memory allocated by drm_atomic_state_init.
39  * This is useful for drivers that subclass the atomic state.
40  */
41 void drm_atomic_state_default_release(struct drm_atomic_state *state)
42 {
43 	kfree(state->connectors);
44 	kfree(state->connector_states);
45 	kfree(state->crtcs);
46 	kfree(state->crtc_states);
47 	kfree(state->planes);
48 	kfree(state->plane_states);
49 }
50 EXPORT_SYMBOL(drm_atomic_state_default_release);
51 
52 /**
53  * drm_atomic_state_init - init new atomic state
54  * @dev: DRM device
55  * @state: atomic state
56  *
57  * Default implementation for filling in a new atomic state.
58  * This is useful for drivers that subclass the atomic state.
59  */
60 int
61 drm_atomic_state_init(struct drm_device *dev, struct drm_atomic_state *state)
62 {
63 	/* TODO legacy paths should maybe do a better job about
64 	 * setting this appropriately?
65 	 */
66 	state->allow_modeset = true;
67 
68 	state->num_connector = ACCESS_ONCE(dev->mode_config.num_connector);
69 
70 	state->crtcs = kcalloc(dev->mode_config.num_crtc,
71 			       sizeof(*state->crtcs), GFP_KERNEL);
72 	if (!state->crtcs)
73 		goto fail;
74 	state->crtc_states = kcalloc(dev->mode_config.num_crtc,
75 				     sizeof(*state->crtc_states), GFP_KERNEL);
76 	if (!state->crtc_states)
77 		goto fail;
78 	state->planes = kcalloc(dev->mode_config.num_total_plane,
79 				sizeof(*state->planes), GFP_KERNEL);
80 	if (!state->planes)
81 		goto fail;
82 	state->plane_states = kcalloc(dev->mode_config.num_total_plane,
83 				      sizeof(*state->plane_states), GFP_KERNEL);
84 	if (!state->plane_states)
85 		goto fail;
86 	state->connectors = kcalloc(state->num_connector,
87 				    sizeof(*state->connectors),
88 				    GFP_KERNEL);
89 	if (!state->connectors)
90 		goto fail;
91 	state->connector_states = kcalloc(state->num_connector,
92 					  sizeof(*state->connector_states),
93 					  GFP_KERNEL);
94 	if (!state->connector_states)
95 		goto fail;
96 
97 	state->dev = dev;
98 
99 	DRM_DEBUG_ATOMIC("Allocated atomic state %p\n", state);
100 
101 	return 0;
102 fail:
103 	drm_atomic_state_default_release(state);
104 	return -ENOMEM;
105 }
106 EXPORT_SYMBOL(drm_atomic_state_init);
107 
108 /**
109  * drm_atomic_state_alloc - allocate atomic state
110  * @dev: DRM device
111  *
112  * This allocates an empty atomic state to track updates.
113  */
114 struct drm_atomic_state *
115 drm_atomic_state_alloc(struct drm_device *dev)
116 {
117 	struct drm_mode_config *config = &dev->mode_config;
118 	struct drm_atomic_state *state;
119 
120 	if (!config->funcs->atomic_state_alloc) {
121 		state = kzalloc(sizeof(*state), GFP_KERNEL);
122 		if (!state)
123 			return NULL;
124 		if (drm_atomic_state_init(dev, state) < 0) {
125 			kfree(state);
126 			return NULL;
127 		}
128 		return state;
129 	}
130 
131 	return config->funcs->atomic_state_alloc(dev);
132 }
133 EXPORT_SYMBOL(drm_atomic_state_alloc);
134 
135 /**
136  * drm_atomic_state_default_clear - clear base atomic state
137  * @state: atomic state
138  *
139  * Default implementation for clearing atomic state.
140  * This is useful for drivers that subclass the atomic state.
141  */
142 void drm_atomic_state_default_clear(struct drm_atomic_state *state)
143 {
144 	struct drm_device *dev = state->dev;
145 	struct drm_mode_config *config = &dev->mode_config;
146 	int i;
147 
148 	DRM_DEBUG_ATOMIC("Clearing atomic state %p\n", state);
149 
150 	for (i = 0; i < state->num_connector; i++) {
151 		struct drm_connector *connector = state->connectors[i];
152 
153 		if (!connector || !connector->funcs)
154 			continue;
155 
156 		/*
157 		 * FIXME: Async commits can race with connector unplugging and
158 		 * there's currently nothing that prevents cleanup up state for
159 		 * deleted connectors. As long as the callback doesn't look at
160 		 * the connector we'll be fine though, so make sure that's the
161 		 * case by setting all connector pointers to NULL.
162 		 */
163 		state->connector_states[i]->connector = NULL;
164 		connector->funcs->atomic_destroy_state(NULL,
165 						       state->connector_states[i]);
166 		state->connectors[i] = NULL;
167 		state->connector_states[i] = NULL;
168 	}
169 
170 	for (i = 0; i < config->num_crtc; i++) {
171 		struct drm_crtc *crtc = state->crtcs[i];
172 
173 		if (!crtc)
174 			continue;
175 
176 		crtc->funcs->atomic_destroy_state(crtc,
177 						  state->crtc_states[i]);
178 		state->crtcs[i] = NULL;
179 		state->crtc_states[i] = NULL;
180 	}
181 
182 	for (i = 0; i < config->num_total_plane; i++) {
183 		struct drm_plane *plane = state->planes[i];
184 
185 		if (!plane)
186 			continue;
187 
188 		plane->funcs->atomic_destroy_state(plane,
189 						   state->plane_states[i]);
190 		state->planes[i] = NULL;
191 		state->plane_states[i] = NULL;
192 	}
193 }
194 EXPORT_SYMBOL(drm_atomic_state_default_clear);
195 
196 /**
197  * drm_atomic_state_clear - clear state object
198  * @state: atomic state
199  *
200  * When the w/w mutex algorithm detects a deadlock we need to back off and drop
201  * all locks. So someone else could sneak in and change the current modeset
202  * configuration. Which means that all the state assembled in @state is no
203  * longer an atomic update to the current state, but to some arbitrary earlier
204  * state. Which could break assumptions the driver's ->atomic_check likely
205  * relies on.
206  *
207  * Hence we must clear all cached state and completely start over, using this
208  * function.
209  */
210 void drm_atomic_state_clear(struct drm_atomic_state *state)
211 {
212 	struct drm_device *dev = state->dev;
213 	struct drm_mode_config *config = &dev->mode_config;
214 
215 	if (config->funcs->atomic_state_clear)
216 		config->funcs->atomic_state_clear(state);
217 	else
218 		drm_atomic_state_default_clear(state);
219 }
220 EXPORT_SYMBOL(drm_atomic_state_clear);
221 
222 /**
223  * drm_atomic_state_free - free all memory for an atomic state
224  * @state: atomic state to deallocate
225  *
226  * This frees all memory associated with an atomic state, including all the
227  * per-object state for planes, crtcs and connectors.
228  */
229 void drm_atomic_state_free(struct drm_atomic_state *state)
230 {
231 	struct drm_device *dev;
232 	struct drm_mode_config *config;
233 
234 	if (!state)
235 		return;
236 
237 	dev = state->dev;
238 	config = &dev->mode_config;
239 
240 	drm_atomic_state_clear(state);
241 
242 	DRM_DEBUG_ATOMIC("Freeing atomic state %p\n", state);
243 
244 	if (config->funcs->atomic_state_free) {
245 		config->funcs->atomic_state_free(state);
246 	} else {
247 		drm_atomic_state_default_release(state);
248 		kfree(state);
249 	}
250 }
251 EXPORT_SYMBOL(drm_atomic_state_free);
252 
253 /**
254  * drm_atomic_get_crtc_state - get crtc state
255  * @state: global atomic state object
256  * @crtc: crtc to get state object for
257  *
258  * This function returns the crtc state for the given crtc, allocating it if
259  * needed. It will also grab the relevant crtc lock to make sure that the state
260  * is consistent.
261  *
262  * Returns:
263  *
264  * Either the allocated state or the error code encoded into the pointer. When
265  * the error is EDEADLK then the w/w mutex code has detected a deadlock and the
266  * entire atomic sequence must be restarted. All other errors are fatal.
267  */
268 struct drm_crtc_state *
269 drm_atomic_get_crtc_state(struct drm_atomic_state *state,
270 			  struct drm_crtc *crtc)
271 {
272 	int ret, index = drm_crtc_index(crtc);
273 	struct drm_crtc_state *crtc_state;
274 
275 	crtc_state = drm_atomic_get_existing_crtc_state(state, crtc);
276 	if (crtc_state)
277 		return crtc_state;
278 
279 	ret = drm_modeset_lock(&crtc->mutex, state->acquire_ctx);
280 	if (ret)
281 		return ERR_PTR(ret);
282 
283 	crtc_state = crtc->funcs->atomic_duplicate_state(crtc);
284 	if (!crtc_state)
285 		return ERR_PTR(-ENOMEM);
286 
287 	state->crtc_states[index] = crtc_state;
288 	state->crtcs[index] = crtc;
289 	crtc_state->state = state;
290 
291 	DRM_DEBUG_ATOMIC("Added [CRTC:%d] %p state to %p\n",
292 			 crtc->base.id, crtc_state, state);
293 
294 	return crtc_state;
295 }
296 EXPORT_SYMBOL(drm_atomic_get_crtc_state);
297 
298 /**
299  * drm_atomic_set_mode_for_crtc - set mode for CRTC
300  * @state: the CRTC whose incoming state to update
301  * @mode: kernel-internal mode to use for the CRTC, or NULL to disable
302  *
303  * Set a mode (originating from the kernel) on the desired CRTC state. Does
304  * not change any other state properties, including enable, active, or
305  * mode_changed.
306  *
307  * RETURNS:
308  * Zero on success, error code on failure. Cannot return -EDEADLK.
309  */
310 int drm_atomic_set_mode_for_crtc(struct drm_crtc_state *state,
311 				 struct drm_display_mode *mode)
312 {
313 	struct drm_mode_modeinfo umode;
314 
315 	/* Early return for no change. */
316 	if (mode && memcmp(&state->mode, mode, sizeof(*mode)) == 0)
317 		return 0;
318 
319 	if (state->mode_blob)
320 		drm_property_unreference_blob(state->mode_blob);
321 	state->mode_blob = NULL;
322 
323 	if (mode) {
324 		drm_mode_convert_to_umode(&umode, mode);
325 		state->mode_blob =
326 			drm_property_create_blob(state->crtc->dev,
327 		                                 sizeof(umode),
328 		                                 &umode);
329 		if (IS_ERR(state->mode_blob))
330 			return PTR_ERR(state->mode_blob);
331 
332 		drm_mode_copy(&state->mode, mode);
333 		state->enable = true;
334 		DRM_DEBUG_ATOMIC("Set [MODE:%s] for CRTC state %p\n",
335 				 mode->name, state);
336 	} else {
337 		memset(&state->mode, 0, sizeof(state->mode));
338 		state->enable = false;
339 		DRM_DEBUG_ATOMIC("Set [NOMODE] for CRTC state %p\n",
340 				 state);
341 	}
342 
343 	return 0;
344 }
345 EXPORT_SYMBOL(drm_atomic_set_mode_for_crtc);
346 
347 /**
348  * drm_atomic_set_mode_prop_for_crtc - set mode for CRTC
349  * @state: the CRTC whose incoming state to update
350  * @blob: pointer to blob property to use for mode
351  *
352  * Set a mode (originating from a blob property) on the desired CRTC state.
353  * This function will take a reference on the blob property for the CRTC state,
354  * and release the reference held on the state's existing mode property, if any
355  * was set.
356  *
357  * RETURNS:
358  * Zero on success, error code on failure. Cannot return -EDEADLK.
359  */
360 int drm_atomic_set_mode_prop_for_crtc(struct drm_crtc_state *state,
361                                       struct drm_property_blob *blob)
362 {
363 	if (blob == state->mode_blob)
364 		return 0;
365 
366 	if (state->mode_blob)
367 		drm_property_unreference_blob(state->mode_blob);
368 	state->mode_blob = NULL;
369 
370 	memset(&state->mode, 0, sizeof(state->mode));
371 
372 	if (blob) {
373 		if (blob->length != sizeof(struct drm_mode_modeinfo) ||
374 		    drm_mode_convert_umode(&state->mode,
375 		                           (const struct drm_mode_modeinfo *)
376 		                            blob->data))
377 			return -EINVAL;
378 
379 		state->mode_blob = drm_property_reference_blob(blob);
380 		state->enable = true;
381 		DRM_DEBUG_ATOMIC("Set [MODE:%s] for CRTC state %p\n",
382 				 state->mode.name, state);
383 	} else {
384 		state->enable = false;
385 		DRM_DEBUG_ATOMIC("Set [NOMODE] for CRTC state %p\n",
386 				 state);
387 	}
388 
389 	return 0;
390 }
391 EXPORT_SYMBOL(drm_atomic_set_mode_prop_for_crtc);
392 
393 /**
394  * drm_atomic_crtc_set_property - set property on CRTC
395  * @crtc: the drm CRTC to set a property on
396  * @state: the state object to update with the new property value
397  * @property: the property to set
398  * @val: the new property value
399  *
400  * Use this instead of calling crtc->atomic_set_property directly.
401  * This function handles generic/core properties and calls out to
402  * driver's ->atomic_set_property() for driver properties.  To ensure
403  * consistent behavior you must call this function rather than the
404  * driver hook directly.
405  *
406  * RETURNS:
407  * Zero on success, error code on failure
408  */
409 int drm_atomic_crtc_set_property(struct drm_crtc *crtc,
410 		struct drm_crtc_state *state, struct drm_property *property,
411 		uint64_t val)
412 {
413 	struct drm_device *dev = crtc->dev;
414 	struct drm_mode_config *config = &dev->mode_config;
415 	int ret;
416 
417 	if (property == config->prop_active)
418 		state->active = val;
419 	else if (property == config->prop_mode_id) {
420 		struct drm_property_blob *mode =
421 			drm_property_lookup_blob(dev, val);
422 		ret = drm_atomic_set_mode_prop_for_crtc(state, mode);
423 		if (mode)
424 			drm_property_unreference_blob(mode);
425 		return ret;
426 	}
427 	else if (crtc->funcs->atomic_set_property)
428 		return crtc->funcs->atomic_set_property(crtc, state, property, val);
429 	else
430 		return -EINVAL;
431 
432 	return 0;
433 }
434 EXPORT_SYMBOL(drm_atomic_crtc_set_property);
435 
436 /*
437  * This function handles generic/core properties and calls out to
438  * driver's ->atomic_get_property() for driver properties.  To ensure
439  * consistent behavior you must call this function rather than the
440  * driver hook directly.
441  */
442 static int
443 drm_atomic_crtc_get_property(struct drm_crtc *crtc,
444 		const struct drm_crtc_state *state,
445 		struct drm_property *property, uint64_t *val)
446 {
447 	struct drm_device *dev = crtc->dev;
448 	struct drm_mode_config *config = &dev->mode_config;
449 
450 	if (property == config->prop_active)
451 		*val = state->active;
452 	else if (property == config->prop_mode_id)
453 		*val = (state->mode_blob) ? state->mode_blob->base.id : 0;
454 	else if (crtc->funcs->atomic_get_property)
455 		return crtc->funcs->atomic_get_property(crtc, state, property, val);
456 	else
457 		return -EINVAL;
458 
459 	return 0;
460 }
461 
462 /**
463  * drm_atomic_crtc_check - check crtc state
464  * @crtc: crtc to check
465  * @state: crtc state to check
466  *
467  * Provides core sanity checks for crtc state.
468  *
469  * RETURNS:
470  * Zero on success, error code on failure
471  */
472 static int drm_atomic_crtc_check(struct drm_crtc *crtc,
473 		struct drm_crtc_state *state)
474 {
475 	/* NOTE: we explicitly don't enforce constraints such as primary
476 	 * layer covering entire screen, since that is something we want
477 	 * to allow (on hw that supports it).  For hw that does not, it
478 	 * should be checked in driver's crtc->atomic_check() vfunc.
479 	 *
480 	 * TODO: Add generic modeset state checks once we support those.
481 	 */
482 
483 	if (state->active && !state->enable) {
484 		DRM_DEBUG_ATOMIC("[CRTC:%d] active without enabled\n",
485 				 crtc->base.id);
486 		return -EINVAL;
487 	}
488 
489 	/* The state->enable vs. state->mode_blob checks can be WARN_ON,
490 	 * as this is a kernel-internal detail that userspace should never
491 	 * be able to trigger. */
492 	if (drm_core_check_feature(crtc->dev, DRIVER_ATOMIC) &&
493 	    WARN_ON(state->enable && !state->mode_blob)) {
494 		DRM_DEBUG_ATOMIC("[CRTC:%d] enabled without mode blob\n",
495 				 crtc->base.id);
496 		return -EINVAL;
497 	}
498 
499 	if (drm_core_check_feature(crtc->dev, DRIVER_ATOMIC) &&
500 	    WARN_ON(!state->enable && state->mode_blob)) {
501 		DRM_DEBUG_ATOMIC("[CRTC:%d] disabled with mode blob\n",
502 				 crtc->base.id);
503 		return -EINVAL;
504 	}
505 
506 	return 0;
507 }
508 
509 /**
510  * drm_atomic_get_plane_state - get plane state
511  * @state: global atomic state object
512  * @plane: plane to get state object for
513  *
514  * This function returns the plane state for the given plane, allocating it if
515  * needed. It will also grab the relevant plane lock to make sure that the state
516  * is consistent.
517  *
518  * Returns:
519  *
520  * Either the allocated state or the error code encoded into the pointer. When
521  * the error is EDEADLK then the w/w mutex code has detected a deadlock and the
522  * entire atomic sequence must be restarted. All other errors are fatal.
523  */
524 struct drm_plane_state *
525 drm_atomic_get_plane_state(struct drm_atomic_state *state,
526 			  struct drm_plane *plane)
527 {
528 	int ret, index = drm_plane_index(plane);
529 	struct drm_plane_state *plane_state;
530 
531 	plane_state = drm_atomic_get_existing_plane_state(state, plane);
532 	if (plane_state)
533 		return plane_state;
534 
535 	ret = drm_modeset_lock(&plane->mutex, state->acquire_ctx);
536 	if (ret)
537 		return ERR_PTR(ret);
538 
539 	plane_state = plane->funcs->atomic_duplicate_state(plane);
540 	if (!plane_state)
541 		return ERR_PTR(-ENOMEM);
542 
543 	state->plane_states[index] = plane_state;
544 	state->planes[index] = plane;
545 	plane_state->state = state;
546 
547 	DRM_DEBUG_ATOMIC("Added [PLANE:%d] %p state to %p\n",
548 			 plane->base.id, plane_state, state);
549 
550 	if (plane_state->crtc) {
551 		struct drm_crtc_state *crtc_state;
552 
553 		crtc_state = drm_atomic_get_crtc_state(state,
554 						       plane_state->crtc);
555 		if (IS_ERR(crtc_state))
556 			return ERR_CAST(crtc_state);
557 	}
558 
559 	return plane_state;
560 }
561 EXPORT_SYMBOL(drm_atomic_get_plane_state);
562 
563 /**
564  * drm_atomic_plane_set_property - set property on plane
565  * @plane: the drm plane to set a property on
566  * @state: the state object to update with the new property value
567  * @property: the property to set
568  * @val: the new property value
569  *
570  * Use this instead of calling plane->atomic_set_property directly.
571  * This function handles generic/core properties and calls out to
572  * driver's ->atomic_set_property() for driver properties.  To ensure
573  * consistent behavior you must call this function rather than the
574  * driver hook directly.
575  *
576  * RETURNS:
577  * Zero on success, error code on failure
578  */
579 int drm_atomic_plane_set_property(struct drm_plane *plane,
580 		struct drm_plane_state *state, struct drm_property *property,
581 		uint64_t val)
582 {
583 	struct drm_device *dev = plane->dev;
584 	struct drm_mode_config *config = &dev->mode_config;
585 
586 	if (property == config->prop_fb_id) {
587 		struct drm_framebuffer *fb = drm_framebuffer_lookup(dev, val);
588 		drm_atomic_set_fb_for_plane(state, fb);
589 		if (fb)
590 			drm_framebuffer_unreference(fb);
591 	} else if (property == config->prop_crtc_id) {
592 		struct drm_crtc *crtc = drm_crtc_find(dev, val);
593 		return drm_atomic_set_crtc_for_plane(state, crtc);
594 	} else if (property == config->prop_crtc_x) {
595 		state->crtc_x = U642I64(val);
596 	} else if (property == config->prop_crtc_y) {
597 		state->crtc_y = U642I64(val);
598 	} else if (property == config->prop_crtc_w) {
599 		state->crtc_w = val;
600 	} else if (property == config->prop_crtc_h) {
601 		state->crtc_h = val;
602 	} else if (property == config->prop_src_x) {
603 		state->src_x = val;
604 	} else if (property == config->prop_src_y) {
605 		state->src_y = val;
606 	} else if (property == config->prop_src_w) {
607 		state->src_w = val;
608 	} else if (property == config->prop_src_h) {
609 		state->src_h = val;
610 	} else if (property == config->rotation_property) {
611 		state->rotation = val;
612 	} else if (plane->funcs->atomic_set_property) {
613 		return plane->funcs->atomic_set_property(plane, state,
614 				property, val);
615 	} else {
616 		return -EINVAL;
617 	}
618 
619 	return 0;
620 }
621 EXPORT_SYMBOL(drm_atomic_plane_set_property);
622 
623 /*
624  * This function handles generic/core properties and calls out to
625  * driver's ->atomic_get_property() for driver properties.  To ensure
626  * consistent behavior you must call this function rather than the
627  * driver hook directly.
628  */
629 static int
630 drm_atomic_plane_get_property(struct drm_plane *plane,
631 		const struct drm_plane_state *state,
632 		struct drm_property *property, uint64_t *val)
633 {
634 	struct drm_device *dev = plane->dev;
635 	struct drm_mode_config *config = &dev->mode_config;
636 
637 	if (property == config->prop_fb_id) {
638 		*val = (state->fb) ? state->fb->base.id : 0;
639 	} else if (property == config->prop_crtc_id) {
640 		*val = (state->crtc) ? state->crtc->base.id : 0;
641 	} else if (property == config->prop_crtc_x) {
642 		*val = I642U64(state->crtc_x);
643 	} else if (property == config->prop_crtc_y) {
644 		*val = I642U64(state->crtc_y);
645 	} else if (property == config->prop_crtc_w) {
646 		*val = state->crtc_w;
647 	} else if (property == config->prop_crtc_h) {
648 		*val = state->crtc_h;
649 	} else if (property == config->prop_src_x) {
650 		*val = state->src_x;
651 	} else if (property == config->prop_src_y) {
652 		*val = state->src_y;
653 	} else if (property == config->prop_src_w) {
654 		*val = state->src_w;
655 	} else if (property == config->prop_src_h) {
656 		*val = state->src_h;
657 	} else if (property == config->rotation_property) {
658 		*val = state->rotation;
659 	} else if (plane->funcs->atomic_get_property) {
660 		return plane->funcs->atomic_get_property(plane, state, property, val);
661 	} else {
662 		return -EINVAL;
663 	}
664 
665 	return 0;
666 }
667 
668 static bool
669 plane_switching_crtc(struct drm_atomic_state *state,
670 		     struct drm_plane *plane,
671 		     struct drm_plane_state *plane_state)
672 {
673 	if (!plane->state->crtc || !plane_state->crtc)
674 		return false;
675 
676 	if (plane->state->crtc == plane_state->crtc)
677 		return false;
678 
679 	/* This could be refined, but currently there's no helper or driver code
680 	 * to implement direct switching of active planes nor userspace to take
681 	 * advantage of more direct plane switching without the intermediate
682 	 * full OFF state.
683 	 */
684 	return true;
685 }
686 
687 /**
688  * drm_atomic_plane_check - check plane state
689  * @plane: plane to check
690  * @state: plane state to check
691  *
692  * Provides core sanity checks for plane state.
693  *
694  * RETURNS:
695  * Zero on success, error code on failure
696  */
697 static int drm_atomic_plane_check(struct drm_plane *plane,
698 		struct drm_plane_state *state)
699 {
700 	unsigned int fb_width, fb_height;
701 	int ret;
702 
703 	/* either *both* CRTC and FB must be set, or neither */
704 	if (WARN_ON(state->crtc && !state->fb)) {
705 		DRM_DEBUG_ATOMIC("CRTC set but no FB\n");
706 		return -EINVAL;
707 	} else if (WARN_ON(state->fb && !state->crtc)) {
708 		DRM_DEBUG_ATOMIC("FB set but no CRTC\n");
709 		return -EINVAL;
710 	}
711 
712 	/* if disabled, we don't care about the rest of the state: */
713 	if (!state->crtc)
714 		return 0;
715 
716 	/* Check whether this plane is usable on this CRTC */
717 	if (!(plane->possible_crtcs & drm_crtc_mask(state->crtc))) {
718 		DRM_DEBUG_ATOMIC("Invalid crtc for plane\n");
719 		return -EINVAL;
720 	}
721 
722 	/* Check whether this plane supports the fb pixel format. */
723 	ret = drm_plane_check_pixel_format(plane, state->fb->pixel_format);
724 	if (ret) {
725 		DRM_DEBUG_ATOMIC("Invalid pixel format %s\n",
726 				 drm_get_format_name(state->fb->pixel_format));
727 		return ret;
728 	}
729 
730 	/* Give drivers some help against integer overflows */
731 	if (state->crtc_w > INT_MAX ||
732 	    state->crtc_x > INT_MAX - (int32_t) state->crtc_w ||
733 	    state->crtc_h > INT_MAX ||
734 	    state->crtc_y > INT_MAX - (int32_t) state->crtc_h) {
735 		DRM_DEBUG_ATOMIC("Invalid CRTC coordinates %ux%u+%d+%d\n",
736 				 state->crtc_w, state->crtc_h,
737 				 state->crtc_x, state->crtc_y);
738 		return -ERANGE;
739 	}
740 
741 	fb_width = state->fb->width << 16;
742 	fb_height = state->fb->height << 16;
743 
744 	/* Make sure source coordinates are inside the fb. */
745 	if (state->src_w > fb_width ||
746 	    state->src_x > fb_width - state->src_w ||
747 	    state->src_h > fb_height ||
748 	    state->src_y > fb_height - state->src_h) {
749 		DRM_DEBUG_ATOMIC("Invalid source coordinates "
750 				 "%u.%06ux%u.%06u+%u.%06u+%u.%06u\n",
751 				 state->src_w >> 16, ((state->src_w & 0xffff) * 15625) >> 10,
752 				 state->src_h >> 16, ((state->src_h & 0xffff) * 15625) >> 10,
753 				 state->src_x >> 16, ((state->src_x & 0xffff) * 15625) >> 10,
754 				 state->src_y >> 16, ((state->src_y & 0xffff) * 15625) >> 10);
755 		return -ENOSPC;
756 	}
757 
758 	if (plane_switching_crtc(state->state, plane, state)) {
759 		DRM_DEBUG_ATOMIC("[PLANE:%d] switching CRTC directly\n",
760 				 plane->base.id);
761 		return -EINVAL;
762 	}
763 
764 	return 0;
765 }
766 
767 /**
768  * drm_atomic_get_connector_state - get connector state
769  * @state: global atomic state object
770  * @connector: connector to get state object for
771  *
772  * This function returns the connector state for the given connector,
773  * allocating it if needed. It will also grab the relevant connector lock to
774  * make sure that the state is consistent.
775  *
776  * Returns:
777  *
778  * Either the allocated state or the error code encoded into the pointer. When
779  * the error is EDEADLK then the w/w mutex code has detected a deadlock and the
780  * entire atomic sequence must be restarted. All other errors are fatal.
781  */
782 struct drm_connector_state *
783 drm_atomic_get_connector_state(struct drm_atomic_state *state,
784 			  struct drm_connector *connector)
785 {
786 	int ret, index;
787 	struct drm_mode_config *config = &connector->dev->mode_config;
788 	struct drm_connector_state *connector_state;
789 
790 	ret = drm_modeset_lock(&config->connection_mutex, state->acquire_ctx);
791 	if (ret)
792 		return ERR_PTR(ret);
793 
794 	index = drm_connector_index(connector);
795 
796 	/*
797 	 * Construction of atomic state updates can race with a connector
798 	 * hot-add which might overflow. In this case flip the table and just
799 	 * restart the entire ioctl - no one is fast enough to livelock a cpu
800 	 * with physical hotplug events anyway.
801 	 *
802 	 * Note that we only grab the indexes once we have the right lock to
803 	 * prevent hotplug/unplugging of connectors. So removal is no problem,
804 	 * at most the array is a bit too large.
805 	 */
806 	if (index >= state->num_connector) {
807 		DRM_DEBUG_ATOMIC("Hot-added connector would overflow state array, restarting\n");
808 		return ERR_PTR(-EAGAIN);
809 	}
810 
811 	if (state->connector_states[index])
812 		return state->connector_states[index];
813 
814 	connector_state = connector->funcs->atomic_duplicate_state(connector);
815 	if (!connector_state)
816 		return ERR_PTR(-ENOMEM);
817 
818 	state->connector_states[index] = connector_state;
819 	state->connectors[index] = connector;
820 	connector_state->state = state;
821 
822 	DRM_DEBUG_ATOMIC("Added [CONNECTOR:%d] %p state to %p\n",
823 			 connector->base.id, connector_state, state);
824 
825 	if (connector_state->crtc) {
826 		struct drm_crtc_state *crtc_state;
827 
828 		crtc_state = drm_atomic_get_crtc_state(state,
829 						       connector_state->crtc);
830 		if (IS_ERR(crtc_state))
831 			return ERR_CAST(crtc_state);
832 	}
833 
834 	return connector_state;
835 }
836 EXPORT_SYMBOL(drm_atomic_get_connector_state);
837 
838 /**
839  * drm_atomic_connector_set_property - set property on connector.
840  * @connector: the drm connector to set a property on
841  * @state: the state object to update with the new property value
842  * @property: the property to set
843  * @val: the new property value
844  *
845  * Use this instead of calling connector->atomic_set_property directly.
846  * This function handles generic/core properties and calls out to
847  * driver's ->atomic_set_property() for driver properties.  To ensure
848  * consistent behavior you must call this function rather than the
849  * driver hook directly.
850  *
851  * RETURNS:
852  * Zero on success, error code on failure
853  */
854 int drm_atomic_connector_set_property(struct drm_connector *connector,
855 		struct drm_connector_state *state, struct drm_property *property,
856 		uint64_t val)
857 {
858 	struct drm_device *dev = connector->dev;
859 	struct drm_mode_config *config = &dev->mode_config;
860 
861 	if (property == config->prop_crtc_id) {
862 		struct drm_crtc *crtc = drm_crtc_find(dev, val);
863 		return drm_atomic_set_crtc_for_connector(state, crtc);
864 	} else if (property == config->dpms_property) {
865 		/* setting DPMS property requires special handling, which
866 		 * is done in legacy setprop path for us.  Disallow (for
867 		 * now?) atomic writes to DPMS property:
868 		 */
869 		return -EINVAL;
870 	} else if (connector->funcs->atomic_set_property) {
871 		return connector->funcs->atomic_set_property(connector,
872 				state, property, val);
873 	} else {
874 		return -EINVAL;
875 	}
876 }
877 EXPORT_SYMBOL(drm_atomic_connector_set_property);
878 
879 /*
880  * This function handles generic/core properties and calls out to
881  * driver's ->atomic_get_property() for driver properties.  To ensure
882  * consistent behavior you must call this function rather than the
883  * driver hook directly.
884  */
885 static int
886 drm_atomic_connector_get_property(struct drm_connector *connector,
887 		const struct drm_connector_state *state,
888 		struct drm_property *property, uint64_t *val)
889 {
890 	struct drm_device *dev = connector->dev;
891 	struct drm_mode_config *config = &dev->mode_config;
892 
893 	if (property == config->prop_crtc_id) {
894 		*val = (state->crtc) ? state->crtc->base.id : 0;
895 	} else if (property == config->dpms_property) {
896 		*val = connector->dpms;
897 	} else if (connector->funcs->atomic_get_property) {
898 		return connector->funcs->atomic_get_property(connector,
899 				state, property, val);
900 	} else {
901 		return -EINVAL;
902 	}
903 
904 	return 0;
905 }
906 
907 int drm_atomic_get_property(struct drm_mode_object *obj,
908 		struct drm_property *property, uint64_t *val)
909 {
910 	struct drm_device *dev = property->dev;
911 	int ret;
912 
913 	switch (obj->type) {
914 	case DRM_MODE_OBJECT_CONNECTOR: {
915 		struct drm_connector *connector = obj_to_connector(obj);
916 		WARN_ON(!drm_modeset_is_locked(&dev->mode_config.connection_mutex));
917 		ret = drm_atomic_connector_get_property(connector,
918 				connector->state, property, val);
919 		break;
920 	}
921 	case DRM_MODE_OBJECT_CRTC: {
922 		struct drm_crtc *crtc = obj_to_crtc(obj);
923 		WARN_ON(!drm_modeset_is_locked(&crtc->mutex));
924 		ret = drm_atomic_crtc_get_property(crtc,
925 				crtc->state, property, val);
926 		break;
927 	}
928 	case DRM_MODE_OBJECT_PLANE: {
929 		struct drm_plane *plane = obj_to_plane(obj);
930 		WARN_ON(!drm_modeset_is_locked(&plane->mutex));
931 		ret = drm_atomic_plane_get_property(plane,
932 				plane->state, property, val);
933 		break;
934 	}
935 	default:
936 		ret = -EINVAL;
937 		break;
938 	}
939 
940 	return ret;
941 }
942 
943 /**
944  * drm_atomic_set_crtc_for_plane - set crtc for plane
945  * @plane_state: the plane whose incoming state to update
946  * @crtc: crtc to use for the plane
947  *
948  * Changing the assigned crtc for a plane requires us to grab the lock and state
949  * for the new crtc, as needed. This function takes care of all these details
950  * besides updating the pointer in the state object itself.
951  *
952  * Returns:
953  * 0 on success or can fail with -EDEADLK or -ENOMEM. When the error is EDEADLK
954  * then the w/w mutex code has detected a deadlock and the entire atomic
955  * sequence must be restarted. All other errors are fatal.
956  */
957 int
958 drm_atomic_set_crtc_for_plane(struct drm_plane_state *plane_state,
959 			      struct drm_crtc *crtc)
960 {
961 	struct drm_plane *plane = plane_state->plane;
962 	struct drm_crtc_state *crtc_state;
963 
964 	if (plane_state->crtc) {
965 		crtc_state = drm_atomic_get_crtc_state(plane_state->state,
966 						       plane_state->crtc);
967 		if (WARN_ON(IS_ERR(crtc_state)))
968 			return PTR_ERR(crtc_state);
969 
970 		crtc_state->plane_mask &= ~(1 << drm_plane_index(plane));
971 	}
972 
973 	plane_state->crtc = crtc;
974 
975 	if (crtc) {
976 		crtc_state = drm_atomic_get_crtc_state(plane_state->state,
977 						       crtc);
978 		if (IS_ERR(crtc_state))
979 			return PTR_ERR(crtc_state);
980 		crtc_state->plane_mask |= (1 << drm_plane_index(plane));
981 	}
982 
983 	if (crtc)
984 		DRM_DEBUG_ATOMIC("Link plane state %p to [CRTC:%d]\n",
985 				 plane_state, crtc->base.id);
986 	else
987 		DRM_DEBUG_ATOMIC("Link plane state %p to [NOCRTC]\n",
988 				 plane_state);
989 
990 	return 0;
991 }
992 EXPORT_SYMBOL(drm_atomic_set_crtc_for_plane);
993 
994 /**
995  * drm_atomic_set_fb_for_plane - set framebuffer for plane
996  * @plane_state: atomic state object for the plane
997  * @fb: fb to use for the plane
998  *
999  * Changing the assigned framebuffer for a plane requires us to grab a reference
1000  * to the new fb and drop the reference to the old fb, if there is one. This
1001  * function takes care of all these details besides updating the pointer in the
1002  * state object itself.
1003  */
1004 void
1005 drm_atomic_set_fb_for_plane(struct drm_plane_state *plane_state,
1006 			    struct drm_framebuffer *fb)
1007 {
1008 	if (plane_state->fb)
1009 		drm_framebuffer_unreference(plane_state->fb);
1010 	if (fb)
1011 		drm_framebuffer_reference(fb);
1012 	plane_state->fb = fb;
1013 
1014 	if (fb)
1015 		DRM_DEBUG_ATOMIC("Set [FB:%d] for plane state %p\n",
1016 				 fb->base.id, plane_state);
1017 	else
1018 		DRM_DEBUG_ATOMIC("Set [NOFB] for plane state %p\n",
1019 				 plane_state);
1020 }
1021 EXPORT_SYMBOL(drm_atomic_set_fb_for_plane);
1022 
1023 /**
1024  * drm_atomic_set_crtc_for_connector - set crtc for connector
1025  * @conn_state: atomic state object for the connector
1026  * @crtc: crtc to use for the connector
1027  *
1028  * Changing the assigned crtc for a connector requires us to grab the lock and
1029  * state for the new crtc, as needed. This function takes care of all these
1030  * details besides updating the pointer in the state object itself.
1031  *
1032  * Returns:
1033  * 0 on success or can fail with -EDEADLK or -ENOMEM. When the error is EDEADLK
1034  * then the w/w mutex code has detected a deadlock and the entire atomic
1035  * sequence must be restarted. All other errors are fatal.
1036  */
1037 int
1038 drm_atomic_set_crtc_for_connector(struct drm_connector_state *conn_state,
1039 				  struct drm_crtc *crtc)
1040 {
1041 	struct drm_crtc_state *crtc_state;
1042 
1043 	if (crtc) {
1044 		crtc_state = drm_atomic_get_crtc_state(conn_state->state, crtc);
1045 		if (IS_ERR(crtc_state))
1046 			return PTR_ERR(crtc_state);
1047 	}
1048 
1049 	conn_state->crtc = crtc;
1050 
1051 	if (crtc)
1052 		DRM_DEBUG_ATOMIC("Link connector state %p to [CRTC:%d]\n",
1053 				 conn_state, crtc->base.id);
1054 	else
1055 		DRM_DEBUG_ATOMIC("Link connector state %p to [NOCRTC]\n",
1056 				 conn_state);
1057 
1058 	return 0;
1059 }
1060 EXPORT_SYMBOL(drm_atomic_set_crtc_for_connector);
1061 
1062 /**
1063  * drm_atomic_add_affected_connectors - add connectors for crtc
1064  * @state: atomic state
1065  * @crtc: DRM crtc
1066  *
1067  * This function walks the current configuration and adds all connectors
1068  * currently using @crtc to the atomic configuration @state. Note that this
1069  * function must acquire the connection mutex. This can potentially cause
1070  * unneeded seralization if the update is just for the planes on one crtc. Hence
1071  * drivers and helpers should only call this when really needed (e.g. when a
1072  * full modeset needs to happen due to some change).
1073  *
1074  * Returns:
1075  * 0 on success or can fail with -EDEADLK or -ENOMEM. When the error is EDEADLK
1076  * then the w/w mutex code has detected a deadlock and the entire atomic
1077  * sequence must be restarted. All other errors are fatal.
1078  */
1079 int
1080 drm_atomic_add_affected_connectors(struct drm_atomic_state *state,
1081 				   struct drm_crtc *crtc)
1082 {
1083 	struct drm_mode_config *config = &state->dev->mode_config;
1084 	struct drm_connector *connector;
1085 	struct drm_connector_state *conn_state;
1086 	int ret;
1087 
1088 	ret = drm_modeset_lock(&config->connection_mutex, state->acquire_ctx);
1089 	if (ret)
1090 		return ret;
1091 
1092 	DRM_DEBUG_ATOMIC("Adding all current connectors for [CRTC:%d] to %p\n",
1093 			 crtc->base.id, state);
1094 
1095 	/*
1096 	 * Changed connectors are already in @state, so only need to look at the
1097 	 * current configuration.
1098 	 */
1099 	drm_for_each_connector(connector, state->dev) {
1100 		if (connector->state->crtc != crtc)
1101 			continue;
1102 
1103 		conn_state = drm_atomic_get_connector_state(state, connector);
1104 		if (IS_ERR(conn_state))
1105 			return PTR_ERR(conn_state);
1106 	}
1107 
1108 	return 0;
1109 }
1110 EXPORT_SYMBOL(drm_atomic_add_affected_connectors);
1111 
1112 /**
1113  * drm_atomic_add_affected_planes - add planes for crtc
1114  * @state: atomic state
1115  * @crtc: DRM crtc
1116  *
1117  * This function walks the current configuration and adds all planes
1118  * currently used by @crtc to the atomic configuration @state. This is useful
1119  * when an atomic commit also needs to check all currently enabled plane on
1120  * @crtc, e.g. when changing the mode. It's also useful when re-enabling a CRTC
1121  * to avoid special code to force-enable all planes.
1122  *
1123  * Since acquiring a plane state will always also acquire the w/w mutex of the
1124  * current CRTC for that plane (if there is any) adding all the plane states for
1125  * a CRTC will not reduce parallism of atomic updates.
1126  *
1127  * Returns:
1128  * 0 on success or can fail with -EDEADLK or -ENOMEM. When the error is EDEADLK
1129  * then the w/w mutex code has detected a deadlock and the entire atomic
1130  * sequence must be restarted. All other errors are fatal.
1131  */
1132 int
1133 drm_atomic_add_affected_planes(struct drm_atomic_state *state,
1134 			       struct drm_crtc *crtc)
1135 {
1136 	struct drm_plane *plane;
1137 
1138 	WARN_ON(!drm_atomic_get_existing_crtc_state(state, crtc));
1139 
1140 	drm_for_each_plane_mask(plane, state->dev, crtc->state->plane_mask) {
1141 		struct drm_plane_state *plane_state =
1142 			drm_atomic_get_plane_state(state, plane);
1143 
1144 		if (IS_ERR(plane_state))
1145 			return PTR_ERR(plane_state);
1146 	}
1147 	return 0;
1148 }
1149 EXPORT_SYMBOL(drm_atomic_add_affected_planes);
1150 
1151 /**
1152  * drm_atomic_connectors_for_crtc - count number of connected outputs
1153  * @state: atomic state
1154  * @crtc: DRM crtc
1155  *
1156  * This function counts all connectors which will be connected to @crtc
1157  * according to @state. Useful to recompute the enable state for @crtc.
1158  */
1159 int
1160 drm_atomic_connectors_for_crtc(struct drm_atomic_state *state,
1161 			       struct drm_crtc *crtc)
1162 {
1163 	struct drm_connector *connector;
1164 	struct drm_connector_state *conn_state;
1165 
1166 	int i, num_connected_connectors = 0;
1167 
1168 	for_each_connector_in_state(state, connector, conn_state, i) {
1169 		if (conn_state->crtc == crtc)
1170 			num_connected_connectors++;
1171 	}
1172 
1173 	DRM_DEBUG_ATOMIC("State %p has %i connectors for [CRTC:%d]\n",
1174 			 state, num_connected_connectors, crtc->base.id);
1175 
1176 	return num_connected_connectors;
1177 }
1178 EXPORT_SYMBOL(drm_atomic_connectors_for_crtc);
1179 
1180 /**
1181  * drm_atomic_legacy_backoff - locking backoff for legacy ioctls
1182  * @state: atomic state
1183  *
1184  * This function should be used by legacy entry points which don't understand
1185  * -EDEADLK semantics. For simplicity this one will grab all modeset locks after
1186  * the slowpath completed.
1187  */
1188 void drm_atomic_legacy_backoff(struct drm_atomic_state *state)
1189 {
1190 	int ret;
1191 
1192 retry:
1193 	drm_modeset_backoff(state->acquire_ctx);
1194 
1195 	ret = drm_modeset_lock(&state->dev->mode_config.connection_mutex,
1196 			       state->acquire_ctx);
1197 	if (ret)
1198 		goto retry;
1199 	ret = drm_modeset_lock_all_crtcs(state->dev,
1200 					 state->acquire_ctx);
1201 	if (ret)
1202 		goto retry;
1203 }
1204 EXPORT_SYMBOL(drm_atomic_legacy_backoff);
1205 
1206 /**
1207  * drm_atomic_check_only - check whether a given config would work
1208  * @state: atomic configuration to check
1209  *
1210  * Note that this function can return -EDEADLK if the driver needed to acquire
1211  * more locks but encountered a deadlock. The caller must then do the usual w/w
1212  * backoff dance and restart. All other errors are fatal.
1213  *
1214  * Returns:
1215  * 0 on success, negative error code on failure.
1216  */
1217 int drm_atomic_check_only(struct drm_atomic_state *state)
1218 {
1219 	struct drm_device *dev = state->dev;
1220 	struct drm_mode_config *config = &dev->mode_config;
1221 	struct drm_plane *plane;
1222 	struct drm_plane_state *plane_state;
1223 	struct drm_crtc *crtc;
1224 	struct drm_crtc_state *crtc_state;
1225 	int i, ret = 0;
1226 
1227 	DRM_DEBUG_ATOMIC("checking %p\n", state);
1228 
1229 	for_each_plane_in_state(state, plane, plane_state, i) {
1230 		ret = drm_atomic_plane_check(plane, plane_state);
1231 		if (ret) {
1232 			DRM_DEBUG_ATOMIC("[PLANE:%d] atomic core check failed\n",
1233 					 plane->base.id);
1234 			return ret;
1235 		}
1236 	}
1237 
1238 	for_each_crtc_in_state(state, crtc, crtc_state, i) {
1239 		ret = drm_atomic_crtc_check(crtc, crtc_state);
1240 		if (ret) {
1241 			DRM_DEBUG_ATOMIC("[CRTC:%d] atomic core check failed\n",
1242 					 crtc->base.id);
1243 			return ret;
1244 		}
1245 	}
1246 
1247 	if (config->funcs->atomic_check)
1248 		ret = config->funcs->atomic_check(state->dev, state);
1249 
1250 	if (ret)
1251 		return ret;
1252 
1253 	if (!state->allow_modeset) {
1254 		for_each_crtc_in_state(state, crtc, crtc_state, i) {
1255 			if (drm_atomic_crtc_needs_modeset(crtc_state)) {
1256 				DRM_DEBUG_ATOMIC("[CRTC:%d] requires full modeset\n",
1257 						 crtc->base.id);
1258 				return -EINVAL;
1259 			}
1260 		}
1261 	}
1262 
1263 	return 0;
1264 }
1265 EXPORT_SYMBOL(drm_atomic_check_only);
1266 
1267 /**
1268  * drm_atomic_commit - commit configuration atomically
1269  * @state: atomic configuration to check
1270  *
1271  * Note that this function can return -EDEADLK if the driver needed to acquire
1272  * more locks but encountered a deadlock. The caller must then do the usual w/w
1273  * backoff dance and restart. All other errors are fatal.
1274  *
1275  * Also note that on successful execution ownership of @state is transferred
1276  * from the caller of this function to the function itself. The caller must not
1277  * free or in any other way access @state. If the function fails then the caller
1278  * must clean up @state itself.
1279  *
1280  * Returns:
1281  * 0 on success, negative error code on failure.
1282  */
1283 int drm_atomic_commit(struct drm_atomic_state *state)
1284 {
1285 	struct drm_mode_config *config = &state->dev->mode_config;
1286 	int ret;
1287 
1288 	ret = drm_atomic_check_only(state);
1289 	if (ret)
1290 		return ret;
1291 
1292 	DRM_DEBUG_ATOMIC("commiting %p\n", state);
1293 
1294 	return config->funcs->atomic_commit(state->dev, state, false);
1295 }
1296 EXPORT_SYMBOL(drm_atomic_commit);
1297 
1298 /**
1299  * drm_atomic_async_commit - atomic&async configuration commit
1300  * @state: atomic configuration to check
1301  *
1302  * Note that this function can return -EDEADLK if the driver needed to acquire
1303  * more locks but encountered a deadlock. The caller must then do the usual w/w
1304  * backoff dance and restart. All other errors are fatal.
1305  *
1306  * Also note that on successful execution ownership of @state is transferred
1307  * from the caller of this function to the function itself. The caller must not
1308  * free or in any other way access @state. If the function fails then the caller
1309  * must clean up @state itself.
1310  *
1311  * Returns:
1312  * 0 on success, negative error code on failure.
1313  */
1314 int drm_atomic_async_commit(struct drm_atomic_state *state)
1315 {
1316 	struct drm_mode_config *config = &state->dev->mode_config;
1317 	int ret;
1318 
1319 	ret = drm_atomic_check_only(state);
1320 	if (ret)
1321 		return ret;
1322 
1323 	DRM_DEBUG_ATOMIC("commiting %p asynchronously\n", state);
1324 
1325 	return config->funcs->atomic_commit(state->dev, state, true);
1326 }
1327 EXPORT_SYMBOL(drm_atomic_async_commit);
1328 
1329 /*
1330  * The big monstor ioctl
1331  */
1332 
1333 static struct drm_pending_vblank_event *create_vblank_event(
1334 		struct drm_device *dev, struct drm_file *file_priv, uint64_t user_data)
1335 {
1336 	struct drm_pending_vblank_event *e = NULL;
1337 	unsigned long flags;
1338 
1339 	spin_lock_irqsave(&dev->event_lock, flags);
1340 	if (file_priv->event_space < sizeof e->event) {
1341 		spin_unlock_irqrestore(&dev->event_lock, flags);
1342 		goto out;
1343 	}
1344 	file_priv->event_space -= sizeof e->event;
1345 	spin_unlock_irqrestore(&dev->event_lock, flags);
1346 
1347 	e = kzalloc(sizeof *e, GFP_KERNEL);
1348 	if (e == NULL) {
1349 		spin_lock_irqsave(&dev->event_lock, flags);
1350 		file_priv->event_space += sizeof e->event;
1351 		spin_unlock_irqrestore(&dev->event_lock, flags);
1352 		goto out;
1353 	}
1354 
1355 	e->event.base.type = DRM_EVENT_FLIP_COMPLETE;
1356 	e->event.base.length = sizeof e->event;
1357 	e->event.user_data = user_data;
1358 	e->base.event = &e->event.base;
1359 	e->base.file_priv = file_priv;
1360 	e->base.destroy = (void (*) (struct drm_pending_event *)) kfree;
1361 
1362 out:
1363 	return e;
1364 }
1365 
1366 static void destroy_vblank_event(struct drm_device *dev,
1367 		struct drm_file *file_priv, struct drm_pending_vblank_event *e)
1368 {
1369 	unsigned long flags;
1370 
1371 	spin_lock_irqsave(&dev->event_lock, flags);
1372 	file_priv->event_space += sizeof e->event;
1373 	spin_unlock_irqrestore(&dev->event_lock, flags);
1374 	kfree(e);
1375 }
1376 
1377 static int atomic_set_prop(struct drm_atomic_state *state,
1378 		struct drm_mode_object *obj, struct drm_property *prop,
1379 		uint64_t prop_value)
1380 {
1381 	struct drm_mode_object *ref;
1382 	int ret;
1383 
1384 	if (!drm_property_change_valid_get(prop, prop_value, &ref))
1385 		return -EINVAL;
1386 
1387 	switch (obj->type) {
1388 	case DRM_MODE_OBJECT_CONNECTOR: {
1389 		struct drm_connector *connector = obj_to_connector(obj);
1390 		struct drm_connector_state *connector_state;
1391 
1392 		connector_state = drm_atomic_get_connector_state(state, connector);
1393 		if (IS_ERR(connector_state)) {
1394 			ret = PTR_ERR(connector_state);
1395 			break;
1396 		}
1397 
1398 		ret = drm_atomic_connector_set_property(connector,
1399 				connector_state, prop, prop_value);
1400 		break;
1401 	}
1402 	case DRM_MODE_OBJECT_CRTC: {
1403 		struct drm_crtc *crtc = obj_to_crtc(obj);
1404 		struct drm_crtc_state *crtc_state;
1405 
1406 		crtc_state = drm_atomic_get_crtc_state(state, crtc);
1407 		if (IS_ERR(crtc_state)) {
1408 			ret = PTR_ERR(crtc_state);
1409 			break;
1410 		}
1411 
1412 		ret = drm_atomic_crtc_set_property(crtc,
1413 				crtc_state, prop, prop_value);
1414 		break;
1415 	}
1416 	case DRM_MODE_OBJECT_PLANE: {
1417 		struct drm_plane *plane = obj_to_plane(obj);
1418 		struct drm_plane_state *plane_state;
1419 
1420 		plane_state = drm_atomic_get_plane_state(state, plane);
1421 		if (IS_ERR(plane_state)) {
1422 			ret = PTR_ERR(plane_state);
1423 			break;
1424 		}
1425 
1426 		ret = drm_atomic_plane_set_property(plane,
1427 				plane_state, prop, prop_value);
1428 		break;
1429 	}
1430 	default:
1431 		ret = -EINVAL;
1432 		break;
1433 	}
1434 
1435 	drm_property_change_valid_put(prop, ref);
1436 	return ret;
1437 }
1438 
1439 /**
1440  * drm_atomic_update_old_fb -- Unset old_fb pointers and set plane->fb pointers.
1441  *
1442  * @dev: drm device to check.
1443  * @plane_mask: plane mask for planes that were updated.
1444  * @ret: return value, can be -EDEADLK for a retry.
1445  *
1446  * Before doing an update plane->old_fb is set to plane->fb,
1447  * but before dropping the locks old_fb needs to be set to NULL
1448  * and plane->fb updated. This is a common operation for each
1449  * atomic update, so this call is split off as a helper.
1450  */
1451 void drm_atomic_clean_old_fb(struct drm_device *dev,
1452 			     unsigned plane_mask,
1453 			     int ret)
1454 {
1455 	struct drm_plane *plane;
1456 
1457 	/* if succeeded, fixup legacy plane crtc/fb ptrs before dropping
1458 	 * locks (ie. while it is still safe to deref plane->state).  We
1459 	 * need to do this here because the driver entry points cannot
1460 	 * distinguish between legacy and atomic ioctls.
1461 	 */
1462 	drm_for_each_plane_mask(plane, dev, plane_mask) {
1463 		if (ret == 0) {
1464 			struct drm_framebuffer *new_fb = plane->state->fb;
1465 			if (new_fb)
1466 				drm_framebuffer_reference(new_fb);
1467 			plane->fb = new_fb;
1468 			plane->crtc = plane->state->crtc;
1469 
1470 			if (plane->old_fb)
1471 				drm_framebuffer_unreference(plane->old_fb);
1472 		}
1473 		plane->old_fb = NULL;
1474 	}
1475 }
1476 EXPORT_SYMBOL(drm_atomic_clean_old_fb);
1477 
1478 int drm_mode_atomic_ioctl(struct drm_device *dev,
1479 			  void *data, struct drm_file *file_priv)
1480 {
1481 	struct drm_mode_atomic *arg = data;
1482 	uint32_t __user *objs_ptr = (uint32_t __user *)(unsigned long)(arg->objs_ptr);
1483 	uint32_t __user *count_props_ptr = (uint32_t __user *)(unsigned long)(arg->count_props_ptr);
1484 	uint32_t __user *props_ptr = (uint32_t __user *)(unsigned long)(arg->props_ptr);
1485 	uint64_t __user *prop_values_ptr = (uint64_t __user *)(unsigned long)(arg->prop_values_ptr);
1486 	unsigned int copied_objs, copied_props;
1487 	struct drm_atomic_state *state;
1488 	struct drm_modeset_acquire_ctx ctx;
1489 	struct drm_plane *plane;
1490 	struct drm_crtc *crtc;
1491 	struct drm_crtc_state *crtc_state;
1492 	unsigned plane_mask;
1493 	int ret = 0;
1494 	unsigned int i, j;
1495 
1496 	/* disallow for drivers not supporting atomic: */
1497 	if (!drm_core_check_feature(dev, DRIVER_ATOMIC))
1498 		return -EINVAL;
1499 
1500 	/* disallow for userspace that has not enabled atomic cap (even
1501 	 * though this may be a bit overkill, since legacy userspace
1502 	 * wouldn't know how to call this ioctl)
1503 	 */
1504 	if (!file_priv->atomic)
1505 		return -EINVAL;
1506 
1507 	if (arg->flags & ~DRM_MODE_ATOMIC_FLAGS)
1508 		return -EINVAL;
1509 
1510 	if (arg->reserved)
1511 		return -EINVAL;
1512 
1513 	if ((arg->flags & DRM_MODE_PAGE_FLIP_ASYNC) &&
1514 			!dev->mode_config.async_page_flip)
1515 		return -EINVAL;
1516 
1517 	/* can't test and expect an event at the same time. */
1518 	if ((arg->flags & DRM_MODE_ATOMIC_TEST_ONLY) &&
1519 			(arg->flags & DRM_MODE_PAGE_FLIP_EVENT))
1520 		return -EINVAL;
1521 
1522 	drm_modeset_acquire_init(&ctx, 0);
1523 
1524 	state = drm_atomic_state_alloc(dev);
1525 	if (!state)
1526 		return -ENOMEM;
1527 
1528 	state->acquire_ctx = &ctx;
1529 	state->allow_modeset = !!(arg->flags & DRM_MODE_ATOMIC_ALLOW_MODESET);
1530 
1531 retry:
1532 	plane_mask = 0;
1533 	copied_objs = 0;
1534 	copied_props = 0;
1535 
1536 	for (i = 0; i < arg->count_objs; i++) {
1537 		uint32_t obj_id, count_props;
1538 		struct drm_mode_object *obj;
1539 
1540 		if (get_user(obj_id, objs_ptr + copied_objs)) {
1541 			ret = -EFAULT;
1542 			goto out;
1543 		}
1544 
1545 		obj = drm_mode_object_find(dev, obj_id, DRM_MODE_OBJECT_ANY);
1546 		if (!obj || !obj->properties) {
1547 			ret = -ENOENT;
1548 			goto out;
1549 		}
1550 
1551 		if (get_user(count_props, count_props_ptr + copied_objs)) {
1552 			ret = -EFAULT;
1553 			goto out;
1554 		}
1555 
1556 		copied_objs++;
1557 
1558 		for (j = 0; j < count_props; j++) {
1559 			uint32_t prop_id;
1560 			uint64_t prop_value;
1561 			struct drm_property *prop;
1562 
1563 			if (get_user(prop_id, props_ptr + copied_props)) {
1564 				ret = -EFAULT;
1565 				goto out;
1566 			}
1567 
1568 			prop = drm_property_find(dev, prop_id);
1569 			if (!prop) {
1570 				ret = -ENOENT;
1571 				goto out;
1572 			}
1573 
1574 			if (copy_from_user(&prop_value,
1575 					   prop_values_ptr + copied_props,
1576 					   sizeof(prop_value))) {
1577 				ret = -EFAULT;
1578 				goto out;
1579 			}
1580 
1581 			ret = atomic_set_prop(state, obj, prop, prop_value);
1582 			if (ret)
1583 				goto out;
1584 
1585 			copied_props++;
1586 		}
1587 
1588 		if (obj->type == DRM_MODE_OBJECT_PLANE && count_props &&
1589 		    !(arg->flags & DRM_MODE_ATOMIC_TEST_ONLY)) {
1590 			plane = obj_to_plane(obj);
1591 			plane_mask |= (1 << drm_plane_index(plane));
1592 			plane->old_fb = plane->fb;
1593 		}
1594 	}
1595 
1596 	if (arg->flags & DRM_MODE_PAGE_FLIP_EVENT) {
1597 		for_each_crtc_in_state(state, crtc, crtc_state, i) {
1598 			struct drm_pending_vblank_event *e;
1599 
1600 			e = create_vblank_event(dev, file_priv, arg->user_data);
1601 			if (!e) {
1602 				ret = -ENOMEM;
1603 				goto out;
1604 			}
1605 
1606 			crtc_state->event = e;
1607 		}
1608 	}
1609 
1610 	if (arg->flags & DRM_MODE_ATOMIC_TEST_ONLY) {
1611 		/*
1612 		 * Unlike commit, check_only does not clean up state.
1613 		 * Below we call drm_atomic_state_free for it.
1614 		 */
1615 		ret = drm_atomic_check_only(state);
1616 	} else if (arg->flags & DRM_MODE_ATOMIC_NONBLOCK) {
1617 		ret = drm_atomic_async_commit(state);
1618 	} else {
1619 		ret = drm_atomic_commit(state);
1620 	}
1621 
1622 out:
1623 	drm_atomic_clean_old_fb(dev, plane_mask, ret);
1624 
1625 	if (ret && arg->flags & DRM_MODE_PAGE_FLIP_EVENT) {
1626 		/*
1627 		 * TEST_ONLY and PAGE_FLIP_EVENT are mutually exclusive,
1628 		 * if they weren't, this code should be called on success
1629 		 * for TEST_ONLY too.
1630 		 */
1631 
1632 		for_each_crtc_in_state(state, crtc, crtc_state, i) {
1633 			if (!crtc_state->event)
1634 				continue;
1635 
1636 			destroy_vblank_event(dev, file_priv,
1637 					     crtc_state->event);
1638 		}
1639 	}
1640 
1641 	if (ret == -EDEADLK) {
1642 		drm_atomic_state_clear(state);
1643 		drm_modeset_backoff(&ctx);
1644 		goto retry;
1645 	}
1646 
1647 	if (ret || arg->flags & DRM_MODE_ATOMIC_TEST_ONLY)
1648 		drm_atomic_state_free(state);
1649 
1650 	drm_modeset_drop_locks(&ctx);
1651 	drm_modeset_acquire_fini(&ctx);
1652 
1653 	return ret;
1654 }
1655