drm/gk104-/disp: infoframe registers moved yet again on kepler
[firefly-linux-kernel-4.4.55.git] / drivers / gpu / drm / drm_crtc.c
1 /*
2  * Copyright (c) 2006-2008 Intel Corporation
3  * Copyright (c) 2007 Dave Airlie <airlied@linux.ie>
4  * Copyright (c) 2008 Red Hat Inc.
5  *
6  * DRM core CRTC related functions
7  *
8  * Permission to use, copy, modify, distribute, and sell this software and its
9  * documentation for any purpose is hereby granted without fee, provided that
10  * the above copyright notice appear in all copies and that both that copyright
11  * notice and this permission notice appear in supporting documentation, and
12  * that the name of the copyright holders not be used in advertising or
13  * publicity pertaining to distribution of the software without specific,
14  * written prior permission.  The copyright holders make no representations
15  * about the suitability of this software for any purpose.  It is provided "as
16  * is" without express or implied warranty.
17  *
18  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
19  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
20  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
21  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
22  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
23  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
24  * OF THIS SOFTWARE.
25  *
26  * Authors:
27  *      Keith Packard
28  *      Eric Anholt <eric@anholt.net>
29  *      Dave Airlie <airlied@linux.ie>
30  *      Jesse Barnes <jesse.barnes@intel.com>
31  */
32 #include <linux/ctype.h>
33 #include <linux/list.h>
34 #include <linux/slab.h>
35 #include <linux/export.h>
36 #include <drm/drmP.h>
37 #include <drm/drm_crtc.h>
38 #include <drm/drm_edid.h>
39 #include <drm/drm_fourcc.h>
40 #include <drm/drm_modeset_lock.h>
41
42 #include "drm_crtc_internal.h"
43 #include "drm_internal.h"
44
45 static struct drm_framebuffer *add_framebuffer_internal(struct drm_device *dev,
46                                                         struct drm_mode_fb_cmd2 *r,
47                                                         struct drm_file *file_priv);
48
49 /* Avoid boilerplate.  I'm tired of typing. */
50 #define DRM_ENUM_NAME_FN(fnname, list)                          \
51         const char *fnname(int val)                             \
52         {                                                       \
53                 int i;                                          \
54                 for (i = 0; i < ARRAY_SIZE(list); i++) {        \
55                         if (list[i].type == val)                \
56                                 return list[i].name;            \
57                 }                                               \
58                 return "(unknown)";                             \
59         }
60
61 /*
62  * Global properties
63  */
64 static const struct drm_prop_enum_list drm_dpms_enum_list[] =
65 {       { DRM_MODE_DPMS_ON, "On" },
66         { DRM_MODE_DPMS_STANDBY, "Standby" },
67         { DRM_MODE_DPMS_SUSPEND, "Suspend" },
68         { DRM_MODE_DPMS_OFF, "Off" }
69 };
70
71 DRM_ENUM_NAME_FN(drm_get_dpms_name, drm_dpms_enum_list)
72
73 static const struct drm_prop_enum_list drm_plane_type_enum_list[] =
74 {
75         { DRM_PLANE_TYPE_OVERLAY, "Overlay" },
76         { DRM_PLANE_TYPE_PRIMARY, "Primary" },
77         { DRM_PLANE_TYPE_CURSOR, "Cursor" },
78 };
79
80 /*
81  * Optional properties
82  */
83 static const struct drm_prop_enum_list drm_scaling_mode_enum_list[] =
84 {
85         { DRM_MODE_SCALE_NONE, "None" },
86         { DRM_MODE_SCALE_FULLSCREEN, "Full" },
87         { DRM_MODE_SCALE_CENTER, "Center" },
88         { DRM_MODE_SCALE_ASPECT, "Full aspect" },
89 };
90
91 static const struct drm_prop_enum_list drm_aspect_ratio_enum_list[] = {
92         { DRM_MODE_PICTURE_ASPECT_NONE, "Automatic" },
93         { DRM_MODE_PICTURE_ASPECT_4_3, "4:3" },
94         { DRM_MODE_PICTURE_ASPECT_16_9, "16:9" },
95 };
96
97 /*
98  * Non-global properties, but "required" for certain connectors.
99  */
100 static const struct drm_prop_enum_list drm_dvi_i_select_enum_list[] =
101 {
102         { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */
103         { DRM_MODE_SUBCONNECTOR_DVID,      "DVI-D"     }, /* DVI-I  */
104         { DRM_MODE_SUBCONNECTOR_DVIA,      "DVI-A"     }, /* DVI-I  */
105 };
106
107 DRM_ENUM_NAME_FN(drm_get_dvi_i_select_name, drm_dvi_i_select_enum_list)
108
109 static const struct drm_prop_enum_list drm_dvi_i_subconnector_enum_list[] =
110 {
111         { DRM_MODE_SUBCONNECTOR_Unknown,   "Unknown"   }, /* DVI-I and TV-out */
112         { DRM_MODE_SUBCONNECTOR_DVID,      "DVI-D"     }, /* DVI-I  */
113         { DRM_MODE_SUBCONNECTOR_DVIA,      "DVI-A"     }, /* DVI-I  */
114 };
115
116 DRM_ENUM_NAME_FN(drm_get_dvi_i_subconnector_name,
117                  drm_dvi_i_subconnector_enum_list)
118
119 static const struct drm_prop_enum_list drm_tv_select_enum_list[] =
120 {
121         { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */
122         { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */
123         { DRM_MODE_SUBCONNECTOR_SVIDEO,    "SVIDEO"    }, /* TV-out */
124         { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */
125         { DRM_MODE_SUBCONNECTOR_SCART,     "SCART"     }, /* TV-out */
126 };
127
128 DRM_ENUM_NAME_FN(drm_get_tv_select_name, drm_tv_select_enum_list)
129
130 static const struct drm_prop_enum_list drm_tv_subconnector_enum_list[] =
131 {
132         { DRM_MODE_SUBCONNECTOR_Unknown,   "Unknown"   }, /* DVI-I and TV-out */
133         { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */
134         { DRM_MODE_SUBCONNECTOR_SVIDEO,    "SVIDEO"    }, /* TV-out */
135         { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */
136         { DRM_MODE_SUBCONNECTOR_SCART,     "SCART"     }, /* TV-out */
137 };
138
139 DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name,
140                  drm_tv_subconnector_enum_list)
141
142 static const struct drm_prop_enum_list drm_dirty_info_enum_list[] = {
143         { DRM_MODE_DIRTY_OFF,      "Off"      },
144         { DRM_MODE_DIRTY_ON,       "On"       },
145         { DRM_MODE_DIRTY_ANNOTATE, "Annotate" },
146 };
147
148 struct drm_conn_prop_enum_list {
149         int type;
150         const char *name;
151         struct ida ida;
152 };
153
154 /*
155  * Connector and encoder types.
156  */
157 static struct drm_conn_prop_enum_list drm_connector_enum_list[] =
158 {       { DRM_MODE_CONNECTOR_Unknown, "Unknown" },
159         { DRM_MODE_CONNECTOR_VGA, "VGA" },
160         { DRM_MODE_CONNECTOR_DVII, "DVI-I" },
161         { DRM_MODE_CONNECTOR_DVID, "DVI-D" },
162         { DRM_MODE_CONNECTOR_DVIA, "DVI-A" },
163         { DRM_MODE_CONNECTOR_Composite, "Composite" },
164         { DRM_MODE_CONNECTOR_SVIDEO, "SVIDEO" },
165         { DRM_MODE_CONNECTOR_LVDS, "LVDS" },
166         { DRM_MODE_CONNECTOR_Component, "Component" },
167         { DRM_MODE_CONNECTOR_9PinDIN, "DIN" },
168         { DRM_MODE_CONNECTOR_DisplayPort, "DP" },
169         { DRM_MODE_CONNECTOR_HDMIA, "HDMI-A" },
170         { DRM_MODE_CONNECTOR_HDMIB, "HDMI-B" },
171         { DRM_MODE_CONNECTOR_TV, "TV" },
172         { DRM_MODE_CONNECTOR_eDP, "eDP" },
173         { DRM_MODE_CONNECTOR_VIRTUAL, "Virtual" },
174         { DRM_MODE_CONNECTOR_DSI, "DSI" },
175 };
176
177 static const struct drm_prop_enum_list drm_encoder_enum_list[] =
178 {       { DRM_MODE_ENCODER_NONE, "None" },
179         { DRM_MODE_ENCODER_DAC, "DAC" },
180         { DRM_MODE_ENCODER_TMDS, "TMDS" },
181         { DRM_MODE_ENCODER_LVDS, "LVDS" },
182         { DRM_MODE_ENCODER_TVDAC, "TV" },
183         { DRM_MODE_ENCODER_VIRTUAL, "Virtual" },
184         { DRM_MODE_ENCODER_DSI, "DSI" },
185         { DRM_MODE_ENCODER_DPMST, "DP MST" },
186 };
187
188 static const struct drm_prop_enum_list drm_subpixel_enum_list[] =
189 {
190         { SubPixelUnknown, "Unknown" },
191         { SubPixelHorizontalRGB, "Horizontal RGB" },
192         { SubPixelHorizontalBGR, "Horizontal BGR" },
193         { SubPixelVerticalRGB, "Vertical RGB" },
194         { SubPixelVerticalBGR, "Vertical BGR" },
195         { SubPixelNone, "None" },
196 };
197
198 void drm_connector_ida_init(void)
199 {
200         int i;
201
202         for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++)
203                 ida_init(&drm_connector_enum_list[i].ida);
204 }
205
206 void drm_connector_ida_destroy(void)
207 {
208         int i;
209
210         for (i = 0; i < ARRAY_SIZE(drm_connector_enum_list); i++)
211                 ida_destroy(&drm_connector_enum_list[i].ida);
212 }
213
214 /**
215  * drm_get_connector_status_name - return a string for connector status
216  * @status: connector status to compute name of
217  *
218  * In contrast to the other drm_get_*_name functions this one here returns a
219  * const pointer and hence is threadsafe.
220  */
221 const char *drm_get_connector_status_name(enum drm_connector_status status)
222 {
223         if (status == connector_status_connected)
224                 return "connected";
225         else if (status == connector_status_disconnected)
226                 return "disconnected";
227         else
228                 return "unknown";
229 }
230 EXPORT_SYMBOL(drm_get_connector_status_name);
231
232 /**
233  * drm_get_subpixel_order_name - return a string for a given subpixel enum
234  * @order: enum of subpixel_order
235  *
236  * Note you could abuse this and return something out of bounds, but that
237  * would be a caller error.  No unscrubbed user data should make it here.
238  */
239 const char *drm_get_subpixel_order_name(enum subpixel_order order)
240 {
241         return drm_subpixel_enum_list[order].name;
242 }
243 EXPORT_SYMBOL(drm_get_subpixel_order_name);
244
245 static char printable_char(int c)
246 {
247         return isascii(c) && isprint(c) ? c : '?';
248 }
249
250 /**
251  * drm_get_format_name - return a string for drm fourcc format
252  * @format: format to compute name of
253  *
254  * Note that the buffer used by this function is globally shared and owned by
255  * the function itself.
256  *
257  * FIXME: This isn't really multithreading safe.
258  */
259 const char *drm_get_format_name(uint32_t format)
260 {
261         static char buf[32];
262
263         snprintf(buf, sizeof(buf),
264                  "%c%c%c%c %s-endian (0x%08x)",
265                  printable_char(format & 0xff),
266                  printable_char((format >> 8) & 0xff),
267                  printable_char((format >> 16) & 0xff),
268                  printable_char((format >> 24) & 0x7f),
269                  format & DRM_FORMAT_BIG_ENDIAN ? "big" : "little",
270                  format);
271
272         return buf;
273 }
274 EXPORT_SYMBOL(drm_get_format_name);
275
276 /*
277  * Internal function to assign a slot in the object idr and optionally
278  * register the object into the idr.
279  */
280 static int drm_mode_object_get_reg(struct drm_device *dev,
281                                    struct drm_mode_object *obj,
282                                    uint32_t obj_type,
283                                    bool register_obj)
284 {
285         int ret;
286
287         mutex_lock(&dev->mode_config.idr_mutex);
288         ret = idr_alloc(&dev->mode_config.crtc_idr, register_obj ? obj : NULL, 1, 0, GFP_KERNEL);
289         if (ret >= 0) {
290                 /*
291                  * Set up the object linking under the protection of the idr
292                  * lock so that other users can't see inconsistent state.
293                  */
294                 obj->id = ret;
295                 obj->type = obj_type;
296         }
297         mutex_unlock(&dev->mode_config.idr_mutex);
298
299         return ret < 0 ? ret : 0;
300 }
301
302 /**
303  * drm_mode_object_get - allocate a new modeset identifier
304  * @dev: DRM device
305  * @obj: object pointer, used to generate unique ID
306  * @obj_type: object type
307  *
308  * Create a unique identifier based on @ptr in @dev's identifier space.  Used
309  * for tracking modes, CRTCs and connectors. Note that despite the _get postfix
310  * modeset identifiers are _not_ reference counted. Hence don't use this for
311  * reference counted modeset objects like framebuffers.
312  *
313  * Returns:
314  * New unique (relative to other objects in @dev) integer identifier for the
315  * object.
316  */
317 int drm_mode_object_get(struct drm_device *dev,
318                         struct drm_mode_object *obj, uint32_t obj_type)
319 {
320         return drm_mode_object_get_reg(dev, obj, obj_type, true);
321 }
322
323 static void drm_mode_object_register(struct drm_device *dev,
324                                      struct drm_mode_object *obj)
325 {
326         mutex_lock(&dev->mode_config.idr_mutex);
327         idr_replace(&dev->mode_config.crtc_idr, obj, obj->id);
328         mutex_unlock(&dev->mode_config.idr_mutex);
329 }
330
331 /**
332  * drm_mode_object_put - free a modeset identifer
333  * @dev: DRM device
334  * @object: object to free
335  *
336  * Free @id from @dev's unique identifier pool. Note that despite the _get
337  * postfix modeset identifiers are _not_ reference counted. Hence don't use this
338  * for reference counted modeset objects like framebuffers.
339  */
340 void drm_mode_object_put(struct drm_device *dev,
341                          struct drm_mode_object *object)
342 {
343         mutex_lock(&dev->mode_config.idr_mutex);
344         idr_remove(&dev->mode_config.crtc_idr, object->id);
345         mutex_unlock(&dev->mode_config.idr_mutex);
346 }
347
348 static struct drm_mode_object *_object_find(struct drm_device *dev,
349                 uint32_t id, uint32_t type)
350 {
351         struct drm_mode_object *obj = NULL;
352
353         mutex_lock(&dev->mode_config.idr_mutex);
354         obj = idr_find(&dev->mode_config.crtc_idr, id);
355         if (obj && type != DRM_MODE_OBJECT_ANY && obj->type != type)
356                 obj = NULL;
357         if (obj && obj->id != id)
358                 obj = NULL;
359         /* don't leak out unref'd fb's */
360         if (obj && (obj->type == DRM_MODE_OBJECT_FB))
361                 obj = NULL;
362         mutex_unlock(&dev->mode_config.idr_mutex);
363
364         return obj;
365 }
366
367 /**
368  * drm_mode_object_find - look up a drm object with static lifetime
369  * @dev: drm device
370  * @id: id of the mode object
371  * @type: type of the mode object
372  *
373  * Note that framebuffers cannot be looked up with this functions - since those
374  * are reference counted, they need special treatment.  Even with
375  * DRM_MODE_OBJECT_ANY (although that will simply return NULL
376  * rather than WARN_ON()).
377  */
378 struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
379                 uint32_t id, uint32_t type)
380 {
381         struct drm_mode_object *obj = NULL;
382
383         /* Framebuffers are reference counted and need their own lookup
384          * function.*/
385         WARN_ON(type == DRM_MODE_OBJECT_FB);
386         obj = _object_find(dev, id, type);
387         return obj;
388 }
389 EXPORT_SYMBOL(drm_mode_object_find);
390
391 /**
392  * drm_framebuffer_init - initialize a framebuffer
393  * @dev: DRM device
394  * @fb: framebuffer to be initialized
395  * @funcs: ... with these functions
396  *
397  * Allocates an ID for the framebuffer's parent mode object, sets its mode
398  * functions & device file and adds it to the master fd list.
399  *
400  * IMPORTANT:
401  * This functions publishes the fb and makes it available for concurrent access
402  * by other users. Which means by this point the fb _must_ be fully set up -
403  * since all the fb attributes are invariant over its lifetime, no further
404  * locking but only correct reference counting is required.
405  *
406  * Returns:
407  * Zero on success, error code on failure.
408  */
409 int drm_framebuffer_init(struct drm_device *dev, struct drm_framebuffer *fb,
410                          const struct drm_framebuffer_funcs *funcs)
411 {
412         int ret;
413
414         mutex_lock(&dev->mode_config.fb_lock);
415         kref_init(&fb->refcount);
416         INIT_LIST_HEAD(&fb->filp_head);
417         fb->dev = dev;
418         fb->funcs = funcs;
419
420         ret = drm_mode_object_get(dev, &fb->base, DRM_MODE_OBJECT_FB);
421         if (ret)
422                 goto out;
423
424         dev->mode_config.num_fb++;
425         list_add(&fb->head, &dev->mode_config.fb_list);
426 out:
427         mutex_unlock(&dev->mode_config.fb_lock);
428
429         return 0;
430 }
431 EXPORT_SYMBOL(drm_framebuffer_init);
432
433 /* dev->mode_config.fb_lock must be held! */
434 static void __drm_framebuffer_unregister(struct drm_device *dev,
435                                          struct drm_framebuffer *fb)
436 {
437         mutex_lock(&dev->mode_config.idr_mutex);
438         idr_remove(&dev->mode_config.crtc_idr, fb->base.id);
439         mutex_unlock(&dev->mode_config.idr_mutex);
440
441         fb->base.id = 0;
442 }
443
444 static void drm_framebuffer_free(struct kref *kref)
445 {
446         struct drm_framebuffer *fb =
447                         container_of(kref, struct drm_framebuffer, refcount);
448         struct drm_device *dev = fb->dev;
449
450         /*
451          * The lookup idr holds a weak reference, which has not necessarily been
452          * removed at this point. Check for that.
453          */
454         mutex_lock(&dev->mode_config.fb_lock);
455         if (fb->base.id) {
456                 /* Mark fb as reaped and drop idr ref. */
457                 __drm_framebuffer_unregister(dev, fb);
458         }
459         mutex_unlock(&dev->mode_config.fb_lock);
460
461         fb->funcs->destroy(fb);
462 }
463
464 static struct drm_framebuffer *__drm_framebuffer_lookup(struct drm_device *dev,
465                                                         uint32_t id)
466 {
467         struct drm_mode_object *obj = NULL;
468         struct drm_framebuffer *fb;
469
470         mutex_lock(&dev->mode_config.idr_mutex);
471         obj = idr_find(&dev->mode_config.crtc_idr, id);
472         if (!obj || (obj->type != DRM_MODE_OBJECT_FB) || (obj->id != id))
473                 fb = NULL;
474         else
475                 fb = obj_to_fb(obj);
476         mutex_unlock(&dev->mode_config.idr_mutex);
477
478         return fb;
479 }
480
481 /**
482  * drm_framebuffer_lookup - look up a drm framebuffer and grab a reference
483  * @dev: drm device
484  * @id: id of the fb object
485  *
486  * If successful, this grabs an additional reference to the framebuffer -
487  * callers need to make sure to eventually unreference the returned framebuffer
488  * again, using @drm_framebuffer_unreference.
489  */
490 struct drm_framebuffer *drm_framebuffer_lookup(struct drm_device *dev,
491                                                uint32_t id)
492 {
493         struct drm_framebuffer *fb;
494
495         mutex_lock(&dev->mode_config.fb_lock);
496         fb = __drm_framebuffer_lookup(dev, id);
497         if (fb) {
498                 if (!kref_get_unless_zero(&fb->refcount))
499                         fb = NULL;
500         }
501         mutex_unlock(&dev->mode_config.fb_lock);
502
503         return fb;
504 }
505 EXPORT_SYMBOL(drm_framebuffer_lookup);
506
507 /**
508  * drm_framebuffer_unreference - unref a framebuffer
509  * @fb: framebuffer to unref
510  *
511  * This functions decrements the fb's refcount and frees it if it drops to zero.
512  */
513 void drm_framebuffer_unreference(struct drm_framebuffer *fb)
514 {
515         DRM_DEBUG("%p: FB ID: %d (%d)\n", fb, fb->base.id, atomic_read(&fb->refcount.refcount));
516         kref_put(&fb->refcount, drm_framebuffer_free);
517 }
518 EXPORT_SYMBOL(drm_framebuffer_unreference);
519
520 /**
521  * drm_framebuffer_reference - incr the fb refcnt
522  * @fb: framebuffer
523  *
524  * This functions increments the fb's refcount.
525  */
526 void drm_framebuffer_reference(struct drm_framebuffer *fb)
527 {
528         DRM_DEBUG("%p: FB ID: %d (%d)\n", fb, fb->base.id, atomic_read(&fb->refcount.refcount));
529         kref_get(&fb->refcount);
530 }
531 EXPORT_SYMBOL(drm_framebuffer_reference);
532
533 static void drm_framebuffer_free_bug(struct kref *kref)
534 {
535         BUG();
536 }
537
538 static void __drm_framebuffer_unreference(struct drm_framebuffer *fb)
539 {
540         DRM_DEBUG("%p: FB ID: %d (%d)\n", fb, fb->base.id, atomic_read(&fb->refcount.refcount));
541         kref_put(&fb->refcount, drm_framebuffer_free_bug);
542 }
543
544 /**
545  * drm_framebuffer_unregister_private - unregister a private fb from the lookup idr
546  * @fb: fb to unregister
547  *
548  * Drivers need to call this when cleaning up driver-private framebuffers, e.g.
549  * those used for fbdev. Note that the caller must hold a reference of it's own,
550  * i.e. the object may not be destroyed through this call (since it'll lead to a
551  * locking inversion).
552  */
553 void drm_framebuffer_unregister_private(struct drm_framebuffer *fb)
554 {
555         struct drm_device *dev = fb->dev;
556
557         mutex_lock(&dev->mode_config.fb_lock);
558         /* Mark fb as reaped and drop idr ref. */
559         __drm_framebuffer_unregister(dev, fb);
560         mutex_unlock(&dev->mode_config.fb_lock);
561 }
562 EXPORT_SYMBOL(drm_framebuffer_unregister_private);
563
564 /**
565  * drm_framebuffer_cleanup - remove a framebuffer object
566  * @fb: framebuffer to remove
567  *
568  * Cleanup framebuffer. This function is intended to be used from the drivers
569  * ->destroy callback. It can also be used to clean up driver private
570  *  framebuffers embedded into a larger structure.
571  *
572  * Note that this function does not remove the fb from active usuage - if it is
573  * still used anywhere, hilarity can ensue since userspace could call getfb on
574  * the id and get back -EINVAL. Obviously no concern at driver unload time.
575  *
576  * Also, the framebuffer will not be removed from the lookup idr - for
577  * user-created framebuffers this will happen in in the rmfb ioctl. For
578  * driver-private objects (e.g. for fbdev) drivers need to explicitly call
579  * drm_framebuffer_unregister_private.
580  */
581 void drm_framebuffer_cleanup(struct drm_framebuffer *fb)
582 {
583         struct drm_device *dev = fb->dev;
584
585         mutex_lock(&dev->mode_config.fb_lock);
586         list_del(&fb->head);
587         dev->mode_config.num_fb--;
588         mutex_unlock(&dev->mode_config.fb_lock);
589 }
590 EXPORT_SYMBOL(drm_framebuffer_cleanup);
591
592 /**
593  * drm_framebuffer_remove - remove and unreference a framebuffer object
594  * @fb: framebuffer to remove
595  *
596  * Scans all the CRTCs and planes in @dev's mode_config.  If they're
597  * using @fb, removes it, setting it to NULL. Then drops the reference to the
598  * passed-in framebuffer. Might take the modeset locks.
599  *
600  * Note that this function optimizes the cleanup away if the caller holds the
601  * last reference to the framebuffer. It is also guaranteed to not take the
602  * modeset locks in this case.
603  */
604 void drm_framebuffer_remove(struct drm_framebuffer *fb)
605 {
606         struct drm_device *dev = fb->dev;
607         struct drm_crtc *crtc;
608         struct drm_plane *plane;
609         struct drm_mode_set set;
610         int ret;
611
612         WARN_ON(!list_empty(&fb->filp_head));
613
614         /*
615          * drm ABI mandates that we remove any deleted framebuffers from active
616          * useage. But since most sane clients only remove framebuffers they no
617          * longer need, try to optimize this away.
618          *
619          * Since we're holding a reference ourselves, observing a refcount of 1
620          * means that we're the last holder and can skip it. Also, the refcount
621          * can never increase from 1 again, so we don't need any barriers or
622          * locks.
623          *
624          * Note that userspace could try to race with use and instate a new
625          * usage _after_ we've cleared all current ones. End result will be an
626          * in-use fb with fb-id == 0. Userspace is allowed to shoot its own foot
627          * in this manner.
628          */
629         if (atomic_read(&fb->refcount.refcount) > 1) {
630                 drm_modeset_lock_all(dev);
631                 /* remove from any CRTC */
632                 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
633                         if (crtc->primary->fb == fb) {
634                                 /* should turn off the crtc */
635                                 memset(&set, 0, sizeof(struct drm_mode_set));
636                                 set.crtc = crtc;
637                                 set.fb = NULL;
638                                 ret = drm_mode_set_config_internal(&set);
639                                 if (ret)
640                                         DRM_ERROR("failed to reset crtc %p when fb was deleted\n", crtc);
641                         }
642                 }
643
644                 list_for_each_entry(plane, &dev->mode_config.plane_list, head) {
645                         if (plane->fb == fb)
646                                 drm_plane_force_disable(plane);
647                 }
648                 drm_modeset_unlock_all(dev);
649         }
650
651         drm_framebuffer_unreference(fb);
652 }
653 EXPORT_SYMBOL(drm_framebuffer_remove);
654
655 DEFINE_WW_CLASS(crtc_ww_class);
656
657 /**
658  * drm_crtc_init_with_planes - Initialise a new CRTC object with
659  *    specified primary and cursor planes.
660  * @dev: DRM device
661  * @crtc: CRTC object to init
662  * @primary: Primary plane for CRTC
663  * @cursor: Cursor plane for CRTC
664  * @funcs: callbacks for the new CRTC
665  *
666  * Inits a new object created as base part of a driver crtc object.
667  *
668  * Returns:
669  * Zero on success, error code on failure.
670  */
671 int drm_crtc_init_with_planes(struct drm_device *dev, struct drm_crtc *crtc,
672                               struct drm_plane *primary,
673                               struct drm_plane *cursor,
674                               const struct drm_crtc_funcs *funcs)
675 {
676         struct drm_mode_config *config = &dev->mode_config;
677         int ret;
678
679         crtc->dev = dev;
680         crtc->funcs = funcs;
681         crtc->invert_dimensions = false;
682
683         drm_modeset_lock_all(dev);
684         drm_modeset_lock_init(&crtc->mutex);
685         /* dropped by _unlock_all(): */
686         drm_modeset_lock(&crtc->mutex, config->acquire_ctx);
687
688         ret = drm_mode_object_get(dev, &crtc->base, DRM_MODE_OBJECT_CRTC);
689         if (ret)
690                 goto out;
691
692         crtc->base.properties = &crtc->properties;
693
694         list_add_tail(&crtc->head, &config->crtc_list);
695         config->num_crtc++;
696
697         crtc->primary = primary;
698         crtc->cursor = cursor;
699         if (primary)
700                 primary->possible_crtcs = 1 << drm_crtc_index(crtc);
701         if (cursor)
702                 cursor->possible_crtcs = 1 << drm_crtc_index(crtc);
703
704  out:
705         drm_modeset_unlock_all(dev);
706
707         return ret;
708 }
709 EXPORT_SYMBOL(drm_crtc_init_with_planes);
710
711 /**
712  * drm_crtc_cleanup - Clean up the core crtc usage
713  * @crtc: CRTC to cleanup
714  *
715  * This function cleans up @crtc and removes it from the DRM mode setting
716  * core. Note that the function does *not* free the crtc structure itself,
717  * this is the responsibility of the caller.
718  */
719 void drm_crtc_cleanup(struct drm_crtc *crtc)
720 {
721         struct drm_device *dev = crtc->dev;
722
723         kfree(crtc->gamma_store);
724         crtc->gamma_store = NULL;
725
726         drm_modeset_lock_fini(&crtc->mutex);
727
728         drm_mode_object_put(dev, &crtc->base);
729         list_del(&crtc->head);
730         dev->mode_config.num_crtc--;
731 }
732 EXPORT_SYMBOL(drm_crtc_cleanup);
733
734 /**
735  * drm_crtc_index - find the index of a registered CRTC
736  * @crtc: CRTC to find index for
737  *
738  * Given a registered CRTC, return the index of that CRTC within a DRM
739  * device's list of CRTCs.
740  */
741 unsigned int drm_crtc_index(struct drm_crtc *crtc)
742 {
743         unsigned int index = 0;
744         struct drm_crtc *tmp;
745
746         list_for_each_entry(tmp, &crtc->dev->mode_config.crtc_list, head) {
747                 if (tmp == crtc)
748                         return index;
749
750                 index++;
751         }
752
753         BUG();
754 }
755 EXPORT_SYMBOL(drm_crtc_index);
756
757 /*
758  * drm_mode_remove - remove and free a mode
759  * @connector: connector list to modify
760  * @mode: mode to remove
761  *
762  * Remove @mode from @connector's mode list, then free it.
763  */
764 static void drm_mode_remove(struct drm_connector *connector,
765                             struct drm_display_mode *mode)
766 {
767         list_del(&mode->head);
768         drm_mode_destroy(connector->dev, mode);
769 }
770
771 /**
772  * drm_connector_get_cmdline_mode - reads the user's cmdline mode
773  * @connector: connector to quwery
774  * @mode: returned mode
775  *
776  * The kernel supports per-connector configration of its consoles through
777  * use of the video= parameter. This function parses that option and
778  * extracts the user's specified mode (or enable/disable status) for a
779  * particular connector. This is typically only used during the early fbdev
780  * setup.
781  */
782 static void drm_connector_get_cmdline_mode(struct drm_connector *connector)
783 {
784         struct drm_cmdline_mode *mode = &connector->cmdline_mode;
785         char *option = NULL;
786
787         if (fb_get_options(connector->name, &option))
788                 return;
789
790         if (!drm_mode_parse_command_line_for_connector(option,
791                                                        connector,
792                                                        mode))
793                 return;
794
795         if (mode->force) {
796                 const char *s;
797
798                 switch (mode->force) {
799                 case DRM_FORCE_OFF:
800                         s = "OFF";
801                         break;
802                 case DRM_FORCE_ON_DIGITAL:
803                         s = "ON - dig";
804                         break;
805                 default:
806                 case DRM_FORCE_ON:
807                         s = "ON";
808                         break;
809                 }
810
811                 DRM_INFO("forcing %s connector %s\n", connector->name, s);
812                 connector->force = mode->force;
813         }
814
815         DRM_DEBUG_KMS("cmdline mode for connector %s %dx%d@%dHz%s%s%s\n",
816                       connector->name,
817                       mode->xres, mode->yres,
818                       mode->refresh_specified ? mode->refresh : 60,
819                       mode->rb ? " reduced blanking" : "",
820                       mode->margins ? " with margins" : "",
821                       mode->interlace ?  " interlaced" : "");
822 }
823
824 /**
825  * drm_connector_init - Init a preallocated connector
826  * @dev: DRM device
827  * @connector: the connector to init
828  * @funcs: callbacks for this connector
829  * @connector_type: user visible type of the connector
830  *
831  * Initialises a preallocated connector. Connectors should be
832  * subclassed as part of driver connector objects.
833  *
834  * Returns:
835  * Zero on success, error code on failure.
836  */
837 int drm_connector_init(struct drm_device *dev,
838                        struct drm_connector *connector,
839                        const struct drm_connector_funcs *funcs,
840                        int connector_type)
841 {
842         int ret;
843         struct ida *connector_ida =
844                 &drm_connector_enum_list[connector_type].ida;
845
846         drm_modeset_lock_all(dev);
847
848         ret = drm_mode_object_get_reg(dev, &connector->base, DRM_MODE_OBJECT_CONNECTOR, false);
849         if (ret)
850                 goto out_unlock;
851
852         connector->base.properties = &connector->properties;
853         connector->dev = dev;
854         connector->funcs = funcs;
855         connector->connector_type = connector_type;
856         connector->connector_type_id =
857                 ida_simple_get(connector_ida, 1, 0, GFP_KERNEL);
858         if (connector->connector_type_id < 0) {
859                 ret = connector->connector_type_id;
860                 goto out_put;
861         }
862         connector->name =
863                 kasprintf(GFP_KERNEL, "%s-%d",
864                           drm_connector_enum_list[connector_type].name,
865                           connector->connector_type_id);
866         if (!connector->name) {
867                 ret = -ENOMEM;
868                 goto out_put;
869         }
870
871         INIT_LIST_HEAD(&connector->probed_modes);
872         INIT_LIST_HEAD(&connector->modes);
873         connector->edid_blob_ptr = NULL;
874         connector->status = connector_status_unknown;
875
876         drm_connector_get_cmdline_mode(connector);
877
878         list_add_tail(&connector->head, &dev->mode_config.connector_list);
879         dev->mode_config.num_connector++;
880
881         if (connector_type != DRM_MODE_CONNECTOR_VIRTUAL)
882                 drm_object_attach_property(&connector->base,
883                                               dev->mode_config.edid_property,
884                                               0);
885
886         drm_object_attach_property(&connector->base,
887                                       dev->mode_config.dpms_property, 0);
888
889         connector->debugfs_entry = NULL;
890
891 out_put:
892         if (ret)
893                 drm_mode_object_put(dev, &connector->base);
894
895 out_unlock:
896         drm_modeset_unlock_all(dev);
897
898         return ret;
899 }
900 EXPORT_SYMBOL(drm_connector_init);
901
902 /**
903  * drm_connector_cleanup - cleans up an initialised connector
904  * @connector: connector to cleanup
905  *
906  * Cleans up the connector but doesn't free the object.
907  */
908 void drm_connector_cleanup(struct drm_connector *connector)
909 {
910         struct drm_device *dev = connector->dev;
911         struct drm_display_mode *mode, *t;
912
913         list_for_each_entry_safe(mode, t, &connector->probed_modes, head)
914                 drm_mode_remove(connector, mode);
915
916         list_for_each_entry_safe(mode, t, &connector->modes, head)
917                 drm_mode_remove(connector, mode);
918
919         ida_remove(&drm_connector_enum_list[connector->connector_type].ida,
920                    connector->connector_type_id);
921
922         drm_mode_object_put(dev, &connector->base);
923         kfree(connector->name);
924         connector->name = NULL;
925         list_del(&connector->head);
926         dev->mode_config.num_connector--;
927 }
928 EXPORT_SYMBOL(drm_connector_cleanup);
929
930 /**
931  * drm_connector_index - find the index of a registered connector
932  * @connector: connector to find index for
933  *
934  * Given a registered connector, return the index of that connector within a DRM
935  * device's list of connectors.
936  */
937 unsigned int drm_connector_index(struct drm_connector *connector)
938 {
939         unsigned int index = 0;
940         struct drm_connector *tmp;
941
942         list_for_each_entry(tmp, &connector->dev->mode_config.connector_list, head) {
943                 if (tmp == connector)
944                         return index;
945
946                 index++;
947         }
948
949         BUG();
950 }
951 EXPORT_SYMBOL(drm_connector_index);
952
953 /**
954  * drm_connector_register - register a connector
955  * @connector: the connector to register
956  *
957  * Register userspace interfaces for a connector
958  *
959  * Returns:
960  * Zero on success, error code on failure.
961  */
962 int drm_connector_register(struct drm_connector *connector)
963 {
964         int ret;
965
966         drm_mode_object_register(connector->dev, &connector->base);
967
968         ret = drm_sysfs_connector_add(connector);
969         if (ret)
970                 return ret;
971
972         ret = drm_debugfs_connector_add(connector);
973         if (ret) {
974                 drm_sysfs_connector_remove(connector);
975                 return ret;
976         }
977
978         return 0;
979 }
980 EXPORT_SYMBOL(drm_connector_register);
981
982 /**
983  * drm_connector_unregister - unregister a connector
984  * @connector: the connector to unregister
985  *
986  * Unregister userspace interfaces for a connector
987  */
988 void drm_connector_unregister(struct drm_connector *connector)
989 {
990         drm_sysfs_connector_remove(connector);
991         drm_debugfs_connector_remove(connector);
992 }
993 EXPORT_SYMBOL(drm_connector_unregister);
994
995
996 /**
997  * drm_connector_unplug_all - unregister connector userspace interfaces
998  * @dev: drm device
999  *
1000  * This function unregisters all connector userspace interfaces in sysfs. Should
1001  * be call when the device is disconnected, e.g. from an usb driver's
1002  * ->disconnect callback.
1003  */
1004 void drm_connector_unplug_all(struct drm_device *dev)
1005 {
1006         struct drm_connector *connector;
1007
1008         /* taking the mode config mutex ends up in a clash with sysfs */
1009         list_for_each_entry(connector, &dev->mode_config.connector_list, head)
1010                 drm_connector_unregister(connector);
1011
1012 }
1013 EXPORT_SYMBOL(drm_connector_unplug_all);
1014
1015 /**
1016  * drm_bridge_init - initialize a drm transcoder/bridge
1017  * @dev: drm device
1018  * @bridge: transcoder/bridge to set up
1019  * @funcs: bridge function table
1020  *
1021  * Initialises a preallocated bridge. Bridges should be
1022  * subclassed as part of driver connector objects.
1023  *
1024  * Returns:
1025  * Zero on success, error code on failure.
1026  */
1027 int drm_bridge_init(struct drm_device *dev, struct drm_bridge *bridge,
1028                 const struct drm_bridge_funcs *funcs)
1029 {
1030         int ret;
1031
1032         drm_modeset_lock_all(dev);
1033
1034         ret = drm_mode_object_get(dev, &bridge->base, DRM_MODE_OBJECT_BRIDGE);
1035         if (ret)
1036                 goto out;
1037
1038         bridge->dev = dev;
1039         bridge->funcs = funcs;
1040
1041         list_add_tail(&bridge->head, &dev->mode_config.bridge_list);
1042         dev->mode_config.num_bridge++;
1043
1044  out:
1045         drm_modeset_unlock_all(dev);
1046         return ret;
1047 }
1048 EXPORT_SYMBOL(drm_bridge_init);
1049
1050 /**
1051  * drm_bridge_cleanup - cleans up an initialised bridge
1052  * @bridge: bridge to cleanup
1053  *
1054  * Cleans up the bridge but doesn't free the object.
1055  */
1056 void drm_bridge_cleanup(struct drm_bridge *bridge)
1057 {
1058         struct drm_device *dev = bridge->dev;
1059
1060         drm_modeset_lock_all(dev);
1061         drm_mode_object_put(dev, &bridge->base);
1062         list_del(&bridge->head);
1063         dev->mode_config.num_bridge--;
1064         drm_modeset_unlock_all(dev);
1065 }
1066 EXPORT_SYMBOL(drm_bridge_cleanup);
1067
1068 /**
1069  * drm_encoder_init - Init a preallocated encoder
1070  * @dev: drm device
1071  * @encoder: the encoder to init
1072  * @funcs: callbacks for this encoder
1073  * @encoder_type: user visible type of the encoder
1074  *
1075  * Initialises a preallocated encoder. Encoder should be
1076  * subclassed as part of driver encoder objects.
1077  *
1078  * Returns:
1079  * Zero on success, error code on failure.
1080  */
1081 int drm_encoder_init(struct drm_device *dev,
1082                       struct drm_encoder *encoder,
1083                       const struct drm_encoder_funcs *funcs,
1084                       int encoder_type)
1085 {
1086         int ret;
1087
1088         drm_modeset_lock_all(dev);
1089
1090         ret = drm_mode_object_get(dev, &encoder->base, DRM_MODE_OBJECT_ENCODER);
1091         if (ret)
1092                 goto out_unlock;
1093
1094         encoder->dev = dev;
1095         encoder->encoder_type = encoder_type;
1096         encoder->funcs = funcs;
1097         encoder->name = kasprintf(GFP_KERNEL, "%s-%d",
1098                                   drm_encoder_enum_list[encoder_type].name,
1099                                   encoder->base.id);
1100         if (!encoder->name) {
1101                 ret = -ENOMEM;
1102                 goto out_put;
1103         }
1104
1105         list_add_tail(&encoder->head, &dev->mode_config.encoder_list);
1106         dev->mode_config.num_encoder++;
1107
1108 out_put:
1109         if (ret)
1110                 drm_mode_object_put(dev, &encoder->base);
1111
1112 out_unlock:
1113         drm_modeset_unlock_all(dev);
1114
1115         return ret;
1116 }
1117 EXPORT_SYMBOL(drm_encoder_init);
1118
1119 /**
1120  * drm_encoder_cleanup - cleans up an initialised encoder
1121  * @encoder: encoder to cleanup
1122  *
1123  * Cleans up the encoder but doesn't free the object.
1124  */
1125 void drm_encoder_cleanup(struct drm_encoder *encoder)
1126 {
1127         struct drm_device *dev = encoder->dev;
1128         drm_modeset_lock_all(dev);
1129         drm_mode_object_put(dev, &encoder->base);
1130         kfree(encoder->name);
1131         encoder->name = NULL;
1132         list_del(&encoder->head);
1133         dev->mode_config.num_encoder--;
1134         drm_modeset_unlock_all(dev);
1135 }
1136 EXPORT_SYMBOL(drm_encoder_cleanup);
1137
1138 /**
1139  * drm_universal_plane_init - Initialize a new universal plane object
1140  * @dev: DRM device
1141  * @plane: plane object to init
1142  * @possible_crtcs: bitmask of possible CRTCs
1143  * @funcs: callbacks for the new plane
1144  * @formats: array of supported formats (%DRM_FORMAT_*)
1145  * @format_count: number of elements in @formats
1146  * @type: type of plane (overlay, primary, cursor)
1147  *
1148  * Initializes a plane object of type @type.
1149  *
1150  * Returns:
1151  * Zero on success, error code on failure.
1152  */
1153 int drm_universal_plane_init(struct drm_device *dev, struct drm_plane *plane,
1154                              unsigned long possible_crtcs,
1155                              const struct drm_plane_funcs *funcs,
1156                              const uint32_t *formats, uint32_t format_count,
1157                              enum drm_plane_type type)
1158 {
1159         int ret;
1160
1161         drm_modeset_lock_all(dev);
1162
1163         ret = drm_mode_object_get(dev, &plane->base, DRM_MODE_OBJECT_PLANE);
1164         if (ret)
1165                 goto out;
1166
1167         plane->base.properties = &plane->properties;
1168         plane->dev = dev;
1169         plane->funcs = funcs;
1170         plane->format_types = kmalloc(sizeof(uint32_t) * format_count,
1171                                       GFP_KERNEL);
1172         if (!plane->format_types) {
1173                 DRM_DEBUG_KMS("out of memory when allocating plane\n");
1174                 drm_mode_object_put(dev, &plane->base);
1175                 ret = -ENOMEM;
1176                 goto out;
1177         }
1178
1179         memcpy(plane->format_types, formats, format_count * sizeof(uint32_t));
1180         plane->format_count = format_count;
1181         plane->possible_crtcs = possible_crtcs;
1182         plane->type = type;
1183
1184         list_add_tail(&plane->head, &dev->mode_config.plane_list);
1185         dev->mode_config.num_total_plane++;
1186         if (plane->type == DRM_PLANE_TYPE_OVERLAY)
1187                 dev->mode_config.num_overlay_plane++;
1188
1189         drm_object_attach_property(&plane->base,
1190                                    dev->mode_config.plane_type_property,
1191                                    plane->type);
1192
1193  out:
1194         drm_modeset_unlock_all(dev);
1195
1196         return ret;
1197 }
1198 EXPORT_SYMBOL(drm_universal_plane_init);
1199
1200 /**
1201  * drm_plane_init - Initialize a legacy plane
1202  * @dev: DRM device
1203  * @plane: plane object to init
1204  * @possible_crtcs: bitmask of possible CRTCs
1205  * @funcs: callbacks for the new plane
1206  * @formats: array of supported formats (%DRM_FORMAT_*)
1207  * @format_count: number of elements in @formats
1208  * @is_primary: plane type (primary vs overlay)
1209  *
1210  * Legacy API to initialize a DRM plane.
1211  *
1212  * New drivers should call drm_universal_plane_init() instead.
1213  *
1214  * Returns:
1215  * Zero on success, error code on failure.
1216  */
1217 int drm_plane_init(struct drm_device *dev, struct drm_plane *plane,
1218                    unsigned long possible_crtcs,
1219                    const struct drm_plane_funcs *funcs,
1220                    const uint32_t *formats, uint32_t format_count,
1221                    bool is_primary)
1222 {
1223         enum drm_plane_type type;
1224
1225         type = is_primary ? DRM_PLANE_TYPE_PRIMARY : DRM_PLANE_TYPE_OVERLAY;
1226         return drm_universal_plane_init(dev, plane, possible_crtcs, funcs,
1227                                         formats, format_count, type);
1228 }
1229 EXPORT_SYMBOL(drm_plane_init);
1230
1231 /**
1232  * drm_plane_cleanup - Clean up the core plane usage
1233  * @plane: plane to cleanup
1234  *
1235  * This function cleans up @plane and removes it from the DRM mode setting
1236  * core. Note that the function does *not* free the plane structure itself,
1237  * this is the responsibility of the caller.
1238  */
1239 void drm_plane_cleanup(struct drm_plane *plane)
1240 {
1241         struct drm_device *dev = plane->dev;
1242
1243         drm_modeset_lock_all(dev);
1244         kfree(plane->format_types);
1245         drm_mode_object_put(dev, &plane->base);
1246
1247         BUG_ON(list_empty(&plane->head));
1248
1249         list_del(&plane->head);
1250         dev->mode_config.num_total_plane--;
1251         if (plane->type == DRM_PLANE_TYPE_OVERLAY)
1252                 dev->mode_config.num_overlay_plane--;
1253         drm_modeset_unlock_all(dev);
1254 }
1255 EXPORT_SYMBOL(drm_plane_cleanup);
1256
1257 /**
1258  * drm_plane_index - find the index of a registered plane
1259  * @plane: plane to find index for
1260  *
1261  * Given a registered plane, return the index of that CRTC within a DRM
1262  * device's list of planes.
1263  */
1264 unsigned int drm_plane_index(struct drm_plane *plane)
1265 {
1266         unsigned int index = 0;
1267         struct drm_plane *tmp;
1268
1269         list_for_each_entry(tmp, &plane->dev->mode_config.plane_list, head) {
1270                 if (tmp == plane)
1271                         return index;
1272
1273                 index++;
1274         }
1275
1276         BUG();
1277 }
1278 EXPORT_SYMBOL(drm_plane_index);
1279
1280 /**
1281  * drm_plane_force_disable - Forcibly disable a plane
1282  * @plane: plane to disable
1283  *
1284  * Forces the plane to be disabled.
1285  *
1286  * Used when the plane's current framebuffer is destroyed,
1287  * and when restoring fbdev mode.
1288  */
1289 void drm_plane_force_disable(struct drm_plane *plane)
1290 {
1291         int ret;
1292
1293         if (!plane->fb)
1294                 return;
1295
1296         plane->old_fb = plane->fb;
1297         ret = plane->funcs->disable_plane(plane);
1298         if (ret) {
1299                 DRM_ERROR("failed to disable plane with busy fb\n");
1300                 plane->old_fb = NULL;
1301                 return;
1302         }
1303         /* disconnect the plane from the fb and crtc: */
1304         __drm_framebuffer_unreference(plane->old_fb);
1305         plane->old_fb = NULL;
1306         plane->fb = NULL;
1307         plane->crtc = NULL;
1308 }
1309 EXPORT_SYMBOL(drm_plane_force_disable);
1310
1311 static int drm_mode_create_standard_connector_properties(struct drm_device *dev)
1312 {
1313         struct drm_property *edid;
1314         struct drm_property *dpms;
1315         struct drm_property *dev_path;
1316
1317         /*
1318          * Standard properties (apply to all connectors)
1319          */
1320         edid = drm_property_create(dev, DRM_MODE_PROP_BLOB |
1321                                    DRM_MODE_PROP_IMMUTABLE,
1322                                    "EDID", 0);
1323         dev->mode_config.edid_property = edid;
1324
1325         dpms = drm_property_create_enum(dev, 0,
1326                                    "DPMS", drm_dpms_enum_list,
1327                                    ARRAY_SIZE(drm_dpms_enum_list));
1328         dev->mode_config.dpms_property = dpms;
1329
1330         dev_path = drm_property_create(dev,
1331                                        DRM_MODE_PROP_BLOB |
1332                                        DRM_MODE_PROP_IMMUTABLE,
1333                                        "PATH", 0);
1334         dev->mode_config.path_property = dev_path;
1335
1336         return 0;
1337 }
1338
1339 static int drm_mode_create_standard_plane_properties(struct drm_device *dev)
1340 {
1341         struct drm_property *type;
1342
1343         /*
1344          * Standard properties (apply to all planes)
1345          */
1346         type = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
1347                                         "type", drm_plane_type_enum_list,
1348                                         ARRAY_SIZE(drm_plane_type_enum_list));
1349         dev->mode_config.plane_type_property = type;
1350
1351         return 0;
1352 }
1353
1354 /**
1355  * drm_mode_create_dvi_i_properties - create DVI-I specific connector properties
1356  * @dev: DRM device
1357  *
1358  * Called by a driver the first time a DVI-I connector is made.
1359  */
1360 int drm_mode_create_dvi_i_properties(struct drm_device *dev)
1361 {
1362         struct drm_property *dvi_i_selector;
1363         struct drm_property *dvi_i_subconnector;
1364
1365         if (dev->mode_config.dvi_i_select_subconnector_property)
1366                 return 0;
1367
1368         dvi_i_selector =
1369                 drm_property_create_enum(dev, 0,
1370                                     "select subconnector",
1371                                     drm_dvi_i_select_enum_list,
1372                                     ARRAY_SIZE(drm_dvi_i_select_enum_list));
1373         dev->mode_config.dvi_i_select_subconnector_property = dvi_i_selector;
1374
1375         dvi_i_subconnector = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
1376                                     "subconnector",
1377                                     drm_dvi_i_subconnector_enum_list,
1378                                     ARRAY_SIZE(drm_dvi_i_subconnector_enum_list));
1379         dev->mode_config.dvi_i_subconnector_property = dvi_i_subconnector;
1380
1381         return 0;
1382 }
1383 EXPORT_SYMBOL(drm_mode_create_dvi_i_properties);
1384
1385 /**
1386  * drm_create_tv_properties - create TV specific connector properties
1387  * @dev: DRM device
1388  * @num_modes: number of different TV formats (modes) supported
1389  * @modes: array of pointers to strings containing name of each format
1390  *
1391  * Called by a driver's TV initialization routine, this function creates
1392  * the TV specific connector properties for a given device.  Caller is
1393  * responsible for allocating a list of format names and passing them to
1394  * this routine.
1395  */
1396 int drm_mode_create_tv_properties(struct drm_device *dev, int num_modes,
1397                                   char *modes[])
1398 {
1399         struct drm_property *tv_selector;
1400         struct drm_property *tv_subconnector;
1401         int i;
1402
1403         if (dev->mode_config.tv_select_subconnector_property)
1404                 return 0;
1405
1406         /*
1407          * Basic connector properties
1408          */
1409         tv_selector = drm_property_create_enum(dev, 0,
1410                                           "select subconnector",
1411                                           drm_tv_select_enum_list,
1412                                           ARRAY_SIZE(drm_tv_select_enum_list));
1413         dev->mode_config.tv_select_subconnector_property = tv_selector;
1414
1415         tv_subconnector =
1416                 drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
1417                                     "subconnector",
1418                                     drm_tv_subconnector_enum_list,
1419                                     ARRAY_SIZE(drm_tv_subconnector_enum_list));
1420         dev->mode_config.tv_subconnector_property = tv_subconnector;
1421
1422         /*
1423          * Other, TV specific properties: margins & TV modes.
1424          */
1425         dev->mode_config.tv_left_margin_property =
1426                 drm_property_create_range(dev, 0, "left margin", 0, 100);
1427
1428         dev->mode_config.tv_right_margin_property =
1429                 drm_property_create_range(dev, 0, "right margin", 0, 100);
1430
1431         dev->mode_config.tv_top_margin_property =
1432                 drm_property_create_range(dev, 0, "top margin", 0, 100);
1433
1434         dev->mode_config.tv_bottom_margin_property =
1435                 drm_property_create_range(dev, 0, "bottom margin", 0, 100);
1436
1437         dev->mode_config.tv_mode_property =
1438                 drm_property_create(dev, DRM_MODE_PROP_ENUM,
1439                                     "mode", num_modes);
1440         for (i = 0; i < num_modes; i++)
1441                 drm_property_add_enum(dev->mode_config.tv_mode_property, i,
1442                                       i, modes[i]);
1443
1444         dev->mode_config.tv_brightness_property =
1445                 drm_property_create_range(dev, 0, "brightness", 0, 100);
1446
1447         dev->mode_config.tv_contrast_property =
1448                 drm_property_create_range(dev, 0, "contrast", 0, 100);
1449
1450         dev->mode_config.tv_flicker_reduction_property =
1451                 drm_property_create_range(dev, 0, "flicker reduction", 0, 100);
1452
1453         dev->mode_config.tv_overscan_property =
1454                 drm_property_create_range(dev, 0, "overscan", 0, 100);
1455
1456         dev->mode_config.tv_saturation_property =
1457                 drm_property_create_range(dev, 0, "saturation", 0, 100);
1458
1459         dev->mode_config.tv_hue_property =
1460                 drm_property_create_range(dev, 0, "hue", 0, 100);
1461
1462         return 0;
1463 }
1464 EXPORT_SYMBOL(drm_mode_create_tv_properties);
1465
1466 /**
1467  * drm_mode_create_scaling_mode_property - create scaling mode property
1468  * @dev: DRM device
1469  *
1470  * Called by a driver the first time it's needed, must be attached to desired
1471  * connectors.
1472  */
1473 int drm_mode_create_scaling_mode_property(struct drm_device *dev)
1474 {
1475         struct drm_property *scaling_mode;
1476
1477         if (dev->mode_config.scaling_mode_property)
1478                 return 0;
1479
1480         scaling_mode =
1481                 drm_property_create_enum(dev, 0, "scaling mode",
1482                                 drm_scaling_mode_enum_list,
1483                                     ARRAY_SIZE(drm_scaling_mode_enum_list));
1484
1485         dev->mode_config.scaling_mode_property = scaling_mode;
1486
1487         return 0;
1488 }
1489 EXPORT_SYMBOL(drm_mode_create_scaling_mode_property);
1490
1491 /**
1492  * drm_mode_create_aspect_ratio_property - create aspect ratio property
1493  * @dev: DRM device
1494  *
1495  * Called by a driver the first time it's needed, must be attached to desired
1496  * connectors.
1497  *
1498  * Returns:
1499  * Zero on success, errno on failure.
1500  */
1501 int drm_mode_create_aspect_ratio_property(struct drm_device *dev)
1502 {
1503         if (dev->mode_config.aspect_ratio_property)
1504                 return 0;
1505
1506         dev->mode_config.aspect_ratio_property =
1507                 drm_property_create_enum(dev, 0, "aspect ratio",
1508                                 drm_aspect_ratio_enum_list,
1509                                 ARRAY_SIZE(drm_aspect_ratio_enum_list));
1510
1511         if (dev->mode_config.aspect_ratio_property == NULL)
1512                 return -ENOMEM;
1513
1514         return 0;
1515 }
1516 EXPORT_SYMBOL(drm_mode_create_aspect_ratio_property);
1517
1518 /**
1519  * drm_mode_create_dirty_property - create dirty property
1520  * @dev: DRM device
1521  *
1522  * Called by a driver the first time it's needed, must be attached to desired
1523  * connectors.
1524  */
1525 int drm_mode_create_dirty_info_property(struct drm_device *dev)
1526 {
1527         struct drm_property *dirty_info;
1528
1529         if (dev->mode_config.dirty_info_property)
1530                 return 0;
1531
1532         dirty_info =
1533                 drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
1534                                     "dirty",
1535                                     drm_dirty_info_enum_list,
1536                                     ARRAY_SIZE(drm_dirty_info_enum_list));
1537         dev->mode_config.dirty_info_property = dirty_info;
1538
1539         return 0;
1540 }
1541 EXPORT_SYMBOL(drm_mode_create_dirty_info_property);
1542
1543 static int drm_mode_group_init(struct drm_device *dev, struct drm_mode_group *group)
1544 {
1545         uint32_t total_objects = 0;
1546
1547         total_objects += dev->mode_config.num_crtc;
1548         total_objects += dev->mode_config.num_connector;
1549         total_objects += dev->mode_config.num_encoder;
1550         total_objects += dev->mode_config.num_bridge;
1551
1552         group->id_list = kzalloc(total_objects * sizeof(uint32_t), GFP_KERNEL);
1553         if (!group->id_list)
1554                 return -ENOMEM;
1555
1556         group->num_crtcs = 0;
1557         group->num_connectors = 0;
1558         group->num_encoders = 0;
1559         group->num_bridges = 0;
1560         return 0;
1561 }
1562
1563 void drm_mode_group_destroy(struct drm_mode_group *group)
1564 {
1565         kfree(group->id_list);
1566         group->id_list = NULL;
1567 }
1568
1569 /*
1570  * NOTE: Driver's shouldn't ever call drm_mode_group_init_legacy_group - it is
1571  * the drm core's responsibility to set up mode control groups.
1572  */
1573 int drm_mode_group_init_legacy_group(struct drm_device *dev,
1574                                      struct drm_mode_group *group)
1575 {
1576         struct drm_crtc *crtc;
1577         struct drm_encoder *encoder;
1578         struct drm_connector *connector;
1579         struct drm_bridge *bridge;
1580         int ret;
1581
1582         if ((ret = drm_mode_group_init(dev, group)))
1583                 return ret;
1584
1585         list_for_each_entry(crtc, &dev->mode_config.crtc_list, head)
1586                 group->id_list[group->num_crtcs++] = crtc->base.id;
1587
1588         list_for_each_entry(encoder, &dev->mode_config.encoder_list, head)
1589                 group->id_list[group->num_crtcs + group->num_encoders++] =
1590                 encoder->base.id;
1591
1592         list_for_each_entry(connector, &dev->mode_config.connector_list, head)
1593                 group->id_list[group->num_crtcs + group->num_encoders +
1594                                group->num_connectors++] = connector->base.id;
1595
1596         list_for_each_entry(bridge, &dev->mode_config.bridge_list, head)
1597                 group->id_list[group->num_crtcs + group->num_encoders +
1598                                group->num_connectors + group->num_bridges++] =
1599                                         bridge->base.id;
1600
1601         return 0;
1602 }
1603 EXPORT_SYMBOL(drm_mode_group_init_legacy_group);
1604
1605 void drm_reinit_primary_mode_group(struct drm_device *dev)
1606 {
1607         drm_modeset_lock_all(dev);
1608         drm_mode_group_destroy(&dev->primary->mode_group);
1609         drm_mode_group_init_legacy_group(dev, &dev->primary->mode_group);
1610         drm_modeset_unlock_all(dev);
1611 }
1612 EXPORT_SYMBOL(drm_reinit_primary_mode_group);
1613
1614 /**
1615  * drm_crtc_convert_to_umode - convert a drm_display_mode into a modeinfo
1616  * @out: drm_mode_modeinfo struct to return to the user
1617  * @in: drm_display_mode to use
1618  *
1619  * Convert a drm_display_mode into a drm_mode_modeinfo structure to return to
1620  * the user.
1621  */
1622 static void drm_crtc_convert_to_umode(struct drm_mode_modeinfo *out,
1623                                       const struct drm_display_mode *in)
1624 {
1625         WARN(in->hdisplay > USHRT_MAX || in->hsync_start > USHRT_MAX ||
1626              in->hsync_end > USHRT_MAX || in->htotal > USHRT_MAX ||
1627              in->hskew > USHRT_MAX || in->vdisplay > USHRT_MAX ||
1628              in->vsync_start > USHRT_MAX || in->vsync_end > USHRT_MAX ||
1629              in->vtotal > USHRT_MAX || in->vscan > USHRT_MAX,
1630              "timing values too large for mode info\n");
1631
1632         out->clock = in->clock;
1633         out->hdisplay = in->hdisplay;
1634         out->hsync_start = in->hsync_start;
1635         out->hsync_end = in->hsync_end;
1636         out->htotal = in->htotal;
1637         out->hskew = in->hskew;
1638         out->vdisplay = in->vdisplay;
1639         out->vsync_start = in->vsync_start;
1640         out->vsync_end = in->vsync_end;
1641         out->vtotal = in->vtotal;
1642         out->vscan = in->vscan;
1643         out->vrefresh = in->vrefresh;
1644         out->flags = in->flags;
1645         out->type = in->type;
1646         strncpy(out->name, in->name, DRM_DISPLAY_MODE_LEN);
1647         out->name[DRM_DISPLAY_MODE_LEN-1] = 0;
1648 }
1649
1650 /**
1651  * drm_crtc_convert_umode - convert a modeinfo into a drm_display_mode
1652  * @out: drm_display_mode to return to the user
1653  * @in: drm_mode_modeinfo to use
1654  *
1655  * Convert a drm_mode_modeinfo into a drm_display_mode structure to return to
1656  * the caller.
1657  *
1658  * Returns:
1659  * Zero on success, errno on failure.
1660  */
1661 static int drm_crtc_convert_umode(struct drm_display_mode *out,
1662                                   const struct drm_mode_modeinfo *in)
1663 {
1664         if (in->clock > INT_MAX || in->vrefresh > INT_MAX)
1665                 return -ERANGE;
1666
1667         if ((in->flags & DRM_MODE_FLAG_3D_MASK) > DRM_MODE_FLAG_3D_MAX)
1668                 return -EINVAL;
1669
1670         out->clock = in->clock;
1671         out->hdisplay = in->hdisplay;
1672         out->hsync_start = in->hsync_start;
1673         out->hsync_end = in->hsync_end;
1674         out->htotal = in->htotal;
1675         out->hskew = in->hskew;
1676         out->vdisplay = in->vdisplay;
1677         out->vsync_start = in->vsync_start;
1678         out->vsync_end = in->vsync_end;
1679         out->vtotal = in->vtotal;
1680         out->vscan = in->vscan;
1681         out->vrefresh = in->vrefresh;
1682         out->flags = in->flags;
1683         out->type = in->type;
1684         strncpy(out->name, in->name, DRM_DISPLAY_MODE_LEN);
1685         out->name[DRM_DISPLAY_MODE_LEN-1] = 0;
1686
1687         return 0;
1688 }
1689
1690 /**
1691  * drm_mode_getresources - get graphics configuration
1692  * @dev: drm device for the ioctl
1693  * @data: data pointer for the ioctl
1694  * @file_priv: drm file for the ioctl call
1695  *
1696  * Construct a set of configuration description structures and return
1697  * them to the user, including CRTC, connector and framebuffer configuration.
1698  *
1699  * Called by the user via ioctl.
1700  *
1701  * Returns:
1702  * Zero on success, errno on failure.
1703  */
1704 int drm_mode_getresources(struct drm_device *dev, void *data,
1705                           struct drm_file *file_priv)
1706 {
1707         struct drm_mode_card_res *card_res = data;
1708         struct list_head *lh;
1709         struct drm_framebuffer *fb;
1710         struct drm_connector *connector;
1711         struct drm_crtc *crtc;
1712         struct drm_encoder *encoder;
1713         int ret = 0;
1714         int connector_count = 0;
1715         int crtc_count = 0;
1716         int fb_count = 0;
1717         int encoder_count = 0;
1718         int copied = 0, i;
1719         uint32_t __user *fb_id;
1720         uint32_t __user *crtc_id;
1721         uint32_t __user *connector_id;
1722         uint32_t __user *encoder_id;
1723         struct drm_mode_group *mode_group;
1724
1725         if (!drm_core_check_feature(dev, DRIVER_MODESET))
1726                 return -EINVAL;
1727
1728
1729         mutex_lock(&file_priv->fbs_lock);
1730         /*
1731          * For the non-control nodes we need to limit the list of resources
1732          * by IDs in the group list for this node
1733          */
1734         list_for_each(lh, &file_priv->fbs)
1735                 fb_count++;
1736
1737         /* handle this in 4 parts */
1738         /* FBs */
1739         if (card_res->count_fbs >= fb_count) {
1740                 copied = 0;
1741                 fb_id = (uint32_t __user *)(unsigned long)card_res->fb_id_ptr;
1742                 list_for_each_entry(fb, &file_priv->fbs, filp_head) {
1743                         if (put_user(fb->base.id, fb_id + copied)) {
1744                                 mutex_unlock(&file_priv->fbs_lock);
1745                                 return -EFAULT;
1746                         }
1747                         copied++;
1748                 }
1749         }
1750         card_res->count_fbs = fb_count;
1751         mutex_unlock(&file_priv->fbs_lock);
1752
1753         drm_modeset_lock_all(dev);
1754         if (!drm_is_primary_client(file_priv)) {
1755
1756                 mode_group = NULL;
1757                 list_for_each(lh, &dev->mode_config.crtc_list)
1758                         crtc_count++;
1759
1760                 list_for_each(lh, &dev->mode_config.connector_list)
1761                         connector_count++;
1762
1763                 list_for_each(lh, &dev->mode_config.encoder_list)
1764                         encoder_count++;
1765         } else {
1766
1767                 mode_group = &file_priv->master->minor->mode_group;
1768                 crtc_count = mode_group->num_crtcs;
1769                 connector_count = mode_group->num_connectors;
1770                 encoder_count = mode_group->num_encoders;
1771         }
1772
1773         card_res->max_height = dev->mode_config.max_height;
1774         card_res->min_height = dev->mode_config.min_height;
1775         card_res->max_width = dev->mode_config.max_width;
1776         card_res->min_width = dev->mode_config.min_width;
1777
1778         /* CRTCs */
1779         if (card_res->count_crtcs >= crtc_count) {
1780                 copied = 0;
1781                 crtc_id = (uint32_t __user *)(unsigned long)card_res->crtc_id_ptr;
1782                 if (!mode_group) {
1783                         list_for_each_entry(crtc, &dev->mode_config.crtc_list,
1784                                             head) {
1785                                 DRM_DEBUG_KMS("[CRTC:%d]\n", crtc->base.id);
1786                                 if (put_user(crtc->base.id, crtc_id + copied)) {
1787                                         ret = -EFAULT;
1788                                         goto out;
1789                                 }
1790                                 copied++;
1791                         }
1792                 } else {
1793                         for (i = 0; i < mode_group->num_crtcs; i++) {
1794                                 if (put_user(mode_group->id_list[i],
1795                                              crtc_id + copied)) {
1796                                         ret = -EFAULT;
1797                                         goto out;
1798                                 }
1799                                 copied++;
1800                         }
1801                 }
1802         }
1803         card_res->count_crtcs = crtc_count;
1804
1805         /* Encoders */
1806         if (card_res->count_encoders >= encoder_count) {
1807                 copied = 0;
1808                 encoder_id = (uint32_t __user *)(unsigned long)card_res->encoder_id_ptr;
1809                 if (!mode_group) {
1810                         list_for_each_entry(encoder,
1811                                             &dev->mode_config.encoder_list,
1812                                             head) {
1813                                 DRM_DEBUG_KMS("[ENCODER:%d:%s]\n", encoder->base.id,
1814                                                 encoder->name);
1815                                 if (put_user(encoder->base.id, encoder_id +
1816                                              copied)) {
1817                                         ret = -EFAULT;
1818                                         goto out;
1819                                 }
1820                                 copied++;
1821                         }
1822                 } else {
1823                         for (i = mode_group->num_crtcs; i < mode_group->num_crtcs + mode_group->num_encoders; i++) {
1824                                 if (put_user(mode_group->id_list[i],
1825                                              encoder_id + copied)) {
1826                                         ret = -EFAULT;
1827                                         goto out;
1828                                 }
1829                                 copied++;
1830                         }
1831
1832                 }
1833         }
1834         card_res->count_encoders = encoder_count;
1835
1836         /* Connectors */
1837         if (card_res->count_connectors >= connector_count) {
1838                 copied = 0;
1839                 connector_id = (uint32_t __user *)(unsigned long)card_res->connector_id_ptr;
1840                 if (!mode_group) {
1841                         list_for_each_entry(connector,
1842                                             &dev->mode_config.connector_list,
1843                                             head) {
1844                                 DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n",
1845                                         connector->base.id,
1846                                         connector->name);
1847                                 if (put_user(connector->base.id,
1848                                              connector_id + copied)) {
1849                                         ret = -EFAULT;
1850                                         goto out;
1851                                 }
1852                                 copied++;
1853                         }
1854                 } else {
1855                         int start = mode_group->num_crtcs +
1856                                 mode_group->num_encoders;
1857                         for (i = start; i < start + mode_group->num_connectors; i++) {
1858                                 if (put_user(mode_group->id_list[i],
1859                                              connector_id + copied)) {
1860                                         ret = -EFAULT;
1861                                         goto out;
1862                                 }
1863                                 copied++;
1864                         }
1865                 }
1866         }
1867         card_res->count_connectors = connector_count;
1868
1869         DRM_DEBUG_KMS("CRTC[%d] CONNECTORS[%d] ENCODERS[%d]\n", card_res->count_crtcs,
1870                   card_res->count_connectors, card_res->count_encoders);
1871
1872 out:
1873         drm_modeset_unlock_all(dev);
1874         return ret;
1875 }
1876
1877 /**
1878  * drm_mode_getcrtc - get CRTC configuration
1879  * @dev: drm device for the ioctl
1880  * @data: data pointer for the ioctl
1881  * @file_priv: drm file for the ioctl call
1882  *
1883  * Construct a CRTC configuration structure to return to the user.
1884  *
1885  * Called by the user via ioctl.
1886  *
1887  * Returns:
1888  * Zero on success, errno on failure.
1889  */
1890 int drm_mode_getcrtc(struct drm_device *dev,
1891                      void *data, struct drm_file *file_priv)
1892 {
1893         struct drm_mode_crtc *crtc_resp = data;
1894         struct drm_crtc *crtc;
1895         int ret = 0;
1896
1897         if (!drm_core_check_feature(dev, DRIVER_MODESET))
1898                 return -EINVAL;
1899
1900         drm_modeset_lock_all(dev);
1901
1902         crtc = drm_crtc_find(dev, crtc_resp->crtc_id);
1903         if (!crtc) {
1904                 ret = -ENOENT;
1905                 goto out;
1906         }
1907
1908         crtc_resp->x = crtc->x;
1909         crtc_resp->y = crtc->y;
1910         crtc_resp->gamma_size = crtc->gamma_size;
1911         if (crtc->primary->fb)
1912                 crtc_resp->fb_id = crtc->primary->fb->base.id;
1913         else
1914                 crtc_resp->fb_id = 0;
1915
1916         if (crtc->enabled) {
1917
1918                 drm_crtc_convert_to_umode(&crtc_resp->mode, &crtc->mode);
1919                 crtc_resp->mode_valid = 1;
1920
1921         } else {
1922                 crtc_resp->mode_valid = 0;
1923         }
1924
1925 out:
1926         drm_modeset_unlock_all(dev);
1927         return ret;
1928 }
1929
1930 static bool drm_mode_expose_to_userspace(const struct drm_display_mode *mode,
1931                                          const struct drm_file *file_priv)
1932 {
1933         /*
1934          * If user-space hasn't configured the driver to expose the stereo 3D
1935          * modes, don't expose them.
1936          */
1937         if (!file_priv->stereo_allowed && drm_mode_is_stereo(mode))
1938                 return false;
1939
1940         return true;
1941 }
1942
1943 /**
1944  * drm_mode_getconnector - get connector configuration
1945  * @dev: drm device for the ioctl
1946  * @data: data pointer for the ioctl
1947  * @file_priv: drm file for the ioctl call
1948  *
1949  * Construct a connector configuration structure to return to the user.
1950  *
1951  * Called by the user via ioctl.
1952  *
1953  * Returns:
1954  * Zero on success, errno on failure.
1955  */
1956 int drm_mode_getconnector(struct drm_device *dev, void *data,
1957                           struct drm_file *file_priv)
1958 {
1959         struct drm_mode_get_connector *out_resp = data;
1960         struct drm_connector *connector;
1961         struct drm_display_mode *mode;
1962         int mode_count = 0;
1963         int props_count = 0;
1964         int encoders_count = 0;
1965         int ret = 0;
1966         int copied = 0;
1967         int i;
1968         struct drm_mode_modeinfo u_mode;
1969         struct drm_mode_modeinfo __user *mode_ptr;
1970         uint32_t __user *prop_ptr;
1971         uint64_t __user *prop_values;
1972         uint32_t __user *encoder_ptr;
1973
1974         if (!drm_core_check_feature(dev, DRIVER_MODESET))
1975                 return -EINVAL;
1976
1977         memset(&u_mode, 0, sizeof(struct drm_mode_modeinfo));
1978
1979         DRM_DEBUG_KMS("[CONNECTOR:%d:?]\n", out_resp->connector_id);
1980
1981         mutex_lock(&dev->mode_config.mutex);
1982
1983         connector = drm_connector_find(dev, out_resp->connector_id);
1984         if (!connector) {
1985                 ret = -ENOENT;
1986                 goto out;
1987         }
1988
1989         props_count = connector->properties.count;
1990
1991         for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
1992                 if (connector->encoder_ids[i] != 0) {
1993                         encoders_count++;
1994                 }
1995         }
1996
1997         if (out_resp->count_modes == 0) {
1998                 connector->funcs->fill_modes(connector,
1999                                              dev->mode_config.max_width,
2000                                              dev->mode_config.max_height);
2001         }
2002
2003         /* delayed so we get modes regardless of pre-fill_modes state */
2004         list_for_each_entry(mode, &connector->modes, head)
2005                 if (drm_mode_expose_to_userspace(mode, file_priv))
2006                         mode_count++;
2007
2008         out_resp->connector_id = connector->base.id;
2009         out_resp->connector_type = connector->connector_type;
2010         out_resp->connector_type_id = connector->connector_type_id;
2011         out_resp->mm_width = connector->display_info.width_mm;
2012         out_resp->mm_height = connector->display_info.height_mm;
2013         out_resp->subpixel = connector->display_info.subpixel_order;
2014         out_resp->connection = connector->status;
2015         drm_modeset_lock(&dev->mode_config.connection_mutex, NULL);
2016         if (connector->encoder)
2017                 out_resp->encoder_id = connector->encoder->base.id;
2018         else
2019                 out_resp->encoder_id = 0;
2020         drm_modeset_unlock(&dev->mode_config.connection_mutex);
2021
2022         /*
2023          * This ioctl is called twice, once to determine how much space is
2024          * needed, and the 2nd time to fill it.
2025          */
2026         if ((out_resp->count_modes >= mode_count) && mode_count) {
2027                 copied = 0;
2028                 mode_ptr = (struct drm_mode_modeinfo __user *)(unsigned long)out_resp->modes_ptr;
2029                 list_for_each_entry(mode, &connector->modes, head) {
2030                         if (!drm_mode_expose_to_userspace(mode, file_priv))
2031                                 continue;
2032
2033                         drm_crtc_convert_to_umode(&u_mode, mode);
2034                         if (copy_to_user(mode_ptr + copied,
2035                                          &u_mode, sizeof(u_mode))) {
2036                                 ret = -EFAULT;
2037                                 goto out;
2038                         }
2039                         copied++;
2040                 }
2041         }
2042         out_resp->count_modes = mode_count;
2043
2044         if ((out_resp->count_props >= props_count) && props_count) {
2045                 copied = 0;
2046                 prop_ptr = (uint32_t __user *)(unsigned long)(out_resp->props_ptr);
2047                 prop_values = (uint64_t __user *)(unsigned long)(out_resp->prop_values_ptr);
2048                 for (i = 0; i < connector->properties.count; i++) {
2049                         if (put_user(connector->properties.ids[i],
2050                                      prop_ptr + copied)) {
2051                                 ret = -EFAULT;
2052                                 goto out;
2053                         }
2054
2055                         if (put_user(connector->properties.values[i],
2056                                      prop_values + copied)) {
2057                                 ret = -EFAULT;
2058                                 goto out;
2059                         }
2060                         copied++;
2061                 }
2062         }
2063         out_resp->count_props = props_count;
2064
2065         if ((out_resp->count_encoders >= encoders_count) && encoders_count) {
2066                 copied = 0;
2067                 encoder_ptr = (uint32_t __user *)(unsigned long)(out_resp->encoders_ptr);
2068                 for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
2069                         if (connector->encoder_ids[i] != 0) {
2070                                 if (put_user(connector->encoder_ids[i],
2071                                              encoder_ptr + copied)) {
2072                                         ret = -EFAULT;
2073                                         goto out;
2074                                 }
2075                                 copied++;
2076                         }
2077                 }
2078         }
2079         out_resp->count_encoders = encoders_count;
2080
2081 out:
2082         mutex_unlock(&dev->mode_config.mutex);
2083
2084         return ret;
2085 }
2086
2087 /**
2088  * drm_mode_getencoder - get encoder configuration
2089  * @dev: drm device for the ioctl
2090  * @data: data pointer for the ioctl
2091  * @file_priv: drm file for the ioctl call
2092  *
2093  * Construct a encoder configuration structure to return to the user.
2094  *
2095  * Called by the user via ioctl.
2096  *
2097  * Returns:
2098  * Zero on success, errno on failure.
2099  */
2100 int drm_mode_getencoder(struct drm_device *dev, void *data,
2101                         struct drm_file *file_priv)
2102 {
2103         struct drm_mode_get_encoder *enc_resp = data;
2104         struct drm_encoder *encoder;
2105         int ret = 0;
2106
2107         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2108                 return -EINVAL;
2109
2110         drm_modeset_lock_all(dev);
2111         encoder = drm_encoder_find(dev, enc_resp->encoder_id);
2112         if (!encoder) {
2113                 ret = -ENOENT;
2114                 goto out;
2115         }
2116
2117         if (encoder->crtc)
2118                 enc_resp->crtc_id = encoder->crtc->base.id;
2119         else
2120                 enc_resp->crtc_id = 0;
2121         enc_resp->encoder_type = encoder->encoder_type;
2122         enc_resp->encoder_id = encoder->base.id;
2123         enc_resp->possible_crtcs = encoder->possible_crtcs;
2124         enc_resp->possible_clones = encoder->possible_clones;
2125
2126 out:
2127         drm_modeset_unlock_all(dev);
2128         return ret;
2129 }
2130
2131 /**
2132  * drm_mode_getplane_res - enumerate all plane resources
2133  * @dev: DRM device
2134  * @data: ioctl data
2135  * @file_priv: DRM file info
2136  *
2137  * Construct a list of plane ids to return to the user.
2138  *
2139  * Called by the user via ioctl.
2140  *
2141  * Returns:
2142  * Zero on success, errno on failure.
2143  */
2144 int drm_mode_getplane_res(struct drm_device *dev, void *data,
2145                           struct drm_file *file_priv)
2146 {
2147         struct drm_mode_get_plane_res *plane_resp = data;
2148         struct drm_mode_config *config;
2149         struct drm_plane *plane;
2150         uint32_t __user *plane_ptr;
2151         int copied = 0, ret = 0;
2152         unsigned num_planes;
2153
2154         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2155                 return -EINVAL;
2156
2157         drm_modeset_lock_all(dev);
2158         config = &dev->mode_config;
2159
2160         if (file_priv->universal_planes)
2161                 num_planes = config->num_total_plane;
2162         else
2163                 num_planes = config->num_overlay_plane;
2164
2165         /*
2166          * This ioctl is called twice, once to determine how much space is
2167          * needed, and the 2nd time to fill it.
2168          */
2169         if (num_planes &&
2170             (plane_resp->count_planes >= num_planes)) {
2171                 plane_ptr = (uint32_t __user *)(unsigned long)plane_resp->plane_id_ptr;
2172
2173                 list_for_each_entry(plane, &config->plane_list, head) {
2174                         /*
2175                          * Unless userspace set the 'universal planes'
2176                          * capability bit, only advertise overlays.
2177                          */
2178                         if (plane->type != DRM_PLANE_TYPE_OVERLAY &&
2179                             !file_priv->universal_planes)
2180                                 continue;
2181
2182                         if (put_user(plane->base.id, plane_ptr + copied)) {
2183                                 ret = -EFAULT;
2184                                 goto out;
2185                         }
2186                         copied++;
2187                 }
2188         }
2189         plane_resp->count_planes = num_planes;
2190
2191 out:
2192         drm_modeset_unlock_all(dev);
2193         return ret;
2194 }
2195
2196 /**
2197  * drm_mode_getplane - get plane configuration
2198  * @dev: DRM device
2199  * @data: ioctl data
2200  * @file_priv: DRM file info
2201  *
2202  * Construct a plane configuration structure to return to the user.
2203  *
2204  * Called by the user via ioctl.
2205  *
2206  * Returns:
2207  * Zero on success, errno on failure.
2208  */
2209 int drm_mode_getplane(struct drm_device *dev, void *data,
2210                       struct drm_file *file_priv)
2211 {
2212         struct drm_mode_get_plane *plane_resp = data;
2213         struct drm_plane *plane;
2214         uint32_t __user *format_ptr;
2215         int ret = 0;
2216
2217         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2218                 return -EINVAL;
2219
2220         drm_modeset_lock_all(dev);
2221         plane = drm_plane_find(dev, plane_resp->plane_id);
2222         if (!plane) {
2223                 ret = -ENOENT;
2224                 goto out;
2225         }
2226
2227         if (plane->crtc)
2228                 plane_resp->crtc_id = plane->crtc->base.id;
2229         else
2230                 plane_resp->crtc_id = 0;
2231
2232         if (plane->fb)
2233                 plane_resp->fb_id = plane->fb->base.id;
2234         else
2235                 plane_resp->fb_id = 0;
2236
2237         plane_resp->plane_id = plane->base.id;
2238         plane_resp->possible_crtcs = plane->possible_crtcs;
2239         plane_resp->gamma_size = 0;
2240
2241         /*
2242          * This ioctl is called twice, once to determine how much space is
2243          * needed, and the 2nd time to fill it.
2244          */
2245         if (plane->format_count &&
2246             (plane_resp->count_format_types >= plane->format_count)) {
2247                 format_ptr = (uint32_t __user *)(unsigned long)plane_resp->format_type_ptr;
2248                 if (copy_to_user(format_ptr,
2249                                  plane->format_types,
2250                                  sizeof(uint32_t) * plane->format_count)) {
2251                         ret = -EFAULT;
2252                         goto out;
2253                 }
2254         }
2255         plane_resp->count_format_types = plane->format_count;
2256
2257 out:
2258         drm_modeset_unlock_all(dev);
2259         return ret;
2260 }
2261
2262 /*
2263  * setplane_internal - setplane handler for internal callers
2264  *
2265  * Note that we assume an extra reference has already been taken on fb.  If the
2266  * update fails, this reference will be dropped before return; if it succeeds,
2267  * the previous framebuffer (if any) will be unreferenced instead.
2268  *
2269  * src_{x,y,w,h} are provided in 16.16 fixed point format
2270  */
2271 static int setplane_internal(struct drm_plane *plane,
2272                              struct drm_crtc *crtc,
2273                              struct drm_framebuffer *fb,
2274                              int32_t crtc_x, int32_t crtc_y,
2275                              uint32_t crtc_w, uint32_t crtc_h,
2276                              /* src_{x,y,w,h} values are 16.16 fixed point */
2277                              uint32_t src_x, uint32_t src_y,
2278                              uint32_t src_w, uint32_t src_h)
2279 {
2280         struct drm_device *dev = plane->dev;
2281         int ret = 0;
2282         unsigned int fb_width, fb_height;
2283         int i;
2284
2285         drm_modeset_lock_all(dev);
2286         /* No fb means shut it down */
2287         if (!fb) {
2288                 plane->old_fb = plane->fb;
2289                 ret = plane->funcs->disable_plane(plane);
2290                 if (!ret) {
2291                         plane->crtc = NULL;
2292                         plane->fb = NULL;
2293                 } else {
2294                         plane->old_fb = NULL;
2295                 }
2296                 goto out;
2297         }
2298
2299         /* Check whether this plane is usable on this CRTC */
2300         if (!(plane->possible_crtcs & drm_crtc_mask(crtc))) {
2301                 DRM_DEBUG_KMS("Invalid crtc for plane\n");
2302                 ret = -EINVAL;
2303                 goto out;
2304         }
2305
2306         /* Check whether this plane supports the fb pixel format. */
2307         for (i = 0; i < plane->format_count; i++)
2308                 if (fb->pixel_format == plane->format_types[i])
2309                         break;
2310         if (i == plane->format_count) {
2311                 DRM_DEBUG_KMS("Invalid pixel format %s\n",
2312                               drm_get_format_name(fb->pixel_format));
2313                 ret = -EINVAL;
2314                 goto out;
2315         }
2316
2317         fb_width = fb->width << 16;
2318         fb_height = fb->height << 16;
2319
2320         /* Make sure source coordinates are inside the fb. */
2321         if (src_w > fb_width ||
2322             src_x > fb_width - src_w ||
2323             src_h > fb_height ||
2324             src_y > fb_height - src_h) {
2325                 DRM_DEBUG_KMS("Invalid source coordinates "
2326                               "%u.%06ux%u.%06u+%u.%06u+%u.%06u\n",
2327                               src_w >> 16, ((src_w & 0xffff) * 15625) >> 10,
2328                               src_h >> 16, ((src_h & 0xffff) * 15625) >> 10,
2329                               src_x >> 16, ((src_x & 0xffff) * 15625) >> 10,
2330                               src_y >> 16, ((src_y & 0xffff) * 15625) >> 10);
2331                 ret = -ENOSPC;
2332                 goto out;
2333         }
2334
2335         plane->old_fb = plane->fb;
2336         ret = plane->funcs->update_plane(plane, crtc, fb,
2337                                          crtc_x, crtc_y, crtc_w, crtc_h,
2338                                          src_x, src_y, src_w, src_h);
2339         if (!ret) {
2340                 plane->crtc = crtc;
2341                 plane->fb = fb;
2342                 fb = NULL;
2343         } else {
2344                 plane->old_fb = NULL;
2345         }
2346
2347 out:
2348         if (fb)
2349                 drm_framebuffer_unreference(fb);
2350         if (plane->old_fb)
2351                 drm_framebuffer_unreference(plane->old_fb);
2352         plane->old_fb = NULL;
2353         drm_modeset_unlock_all(dev);
2354
2355         return ret;
2356
2357 }
2358
2359 /**
2360  * drm_mode_setplane - configure a plane's configuration
2361  * @dev: DRM device
2362  * @data: ioctl data*
2363  * @file_priv: DRM file info
2364  *
2365  * Set plane configuration, including placement, fb, scaling, and other factors.
2366  * Or pass a NULL fb to disable (planes may be disabled without providing a
2367  * valid crtc).
2368  *
2369  * Returns:
2370  * Zero on success, errno on failure.
2371  */
2372 int drm_mode_setplane(struct drm_device *dev, void *data,
2373                       struct drm_file *file_priv)
2374 {
2375         struct drm_mode_set_plane *plane_req = data;
2376         struct drm_mode_object *obj;
2377         struct drm_plane *plane;
2378         struct drm_crtc *crtc = NULL;
2379         struct drm_framebuffer *fb = NULL;
2380
2381         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2382                 return -EINVAL;
2383
2384         /* Give drivers some help against integer overflows */
2385         if (plane_req->crtc_w > INT_MAX ||
2386             plane_req->crtc_x > INT_MAX - (int32_t) plane_req->crtc_w ||
2387             plane_req->crtc_h > INT_MAX ||
2388             plane_req->crtc_y > INT_MAX - (int32_t) plane_req->crtc_h) {
2389                 DRM_DEBUG_KMS("Invalid CRTC coordinates %ux%u+%d+%d\n",
2390                               plane_req->crtc_w, plane_req->crtc_h,
2391                               plane_req->crtc_x, plane_req->crtc_y);
2392                 return -ERANGE;
2393         }
2394
2395         /*
2396          * First, find the plane, crtc, and fb objects.  If not available,
2397          * we don't bother to call the driver.
2398          */
2399         obj = drm_mode_object_find(dev, plane_req->plane_id,
2400                                    DRM_MODE_OBJECT_PLANE);
2401         if (!obj) {
2402                 DRM_DEBUG_KMS("Unknown plane ID %d\n",
2403                               plane_req->plane_id);
2404                 return -ENOENT;
2405         }
2406         plane = obj_to_plane(obj);
2407
2408         if (plane_req->fb_id) {
2409                 fb = drm_framebuffer_lookup(dev, plane_req->fb_id);
2410                 if (!fb) {
2411                         DRM_DEBUG_KMS("Unknown framebuffer ID %d\n",
2412                                       plane_req->fb_id);
2413                         return -ENOENT;
2414                 }
2415
2416                 obj = drm_mode_object_find(dev, plane_req->crtc_id,
2417                                            DRM_MODE_OBJECT_CRTC);
2418                 if (!obj) {
2419                         DRM_DEBUG_KMS("Unknown crtc ID %d\n",
2420                                       plane_req->crtc_id);
2421                         return -ENOENT;
2422                 }
2423                 crtc = obj_to_crtc(obj);
2424         }
2425
2426         /*
2427          * setplane_internal will take care of deref'ing either the old or new
2428          * framebuffer depending on success.
2429          */
2430         return setplane_internal(plane, crtc, fb,
2431                                  plane_req->crtc_x, plane_req->crtc_y,
2432                                  plane_req->crtc_w, plane_req->crtc_h,
2433                                  plane_req->src_x, plane_req->src_y,
2434                                  plane_req->src_w, plane_req->src_h);
2435 }
2436
2437 /**
2438  * drm_mode_set_config_internal - helper to call ->set_config
2439  * @set: modeset config to set
2440  *
2441  * This is a little helper to wrap internal calls to the ->set_config driver
2442  * interface. The only thing it adds is correct refcounting dance.
2443  * 
2444  * Returns:
2445  * Zero on success, errno on failure.
2446  */
2447 int drm_mode_set_config_internal(struct drm_mode_set *set)
2448 {
2449         struct drm_crtc *crtc = set->crtc;
2450         struct drm_framebuffer *fb;
2451         struct drm_crtc *tmp;
2452         int ret;
2453
2454         /*
2455          * NOTE: ->set_config can also disable other crtcs (if we steal all
2456          * connectors from it), hence we need to refcount the fbs across all
2457          * crtcs. Atomic modeset will have saner semantics ...
2458          */
2459         list_for_each_entry(tmp, &crtc->dev->mode_config.crtc_list, head)
2460                 tmp->primary->old_fb = tmp->primary->fb;
2461
2462         fb = set->fb;
2463
2464         ret = crtc->funcs->set_config(set);
2465         if (ret == 0) {
2466                 crtc->primary->crtc = crtc;
2467                 crtc->primary->fb = fb;
2468         }
2469
2470         list_for_each_entry(tmp, &crtc->dev->mode_config.crtc_list, head) {
2471                 if (tmp->primary->fb)
2472                         drm_framebuffer_reference(tmp->primary->fb);
2473                 if (tmp->primary->old_fb)
2474                         drm_framebuffer_unreference(tmp->primary->old_fb);
2475                 tmp->primary->old_fb = NULL;
2476         }
2477
2478         return ret;
2479 }
2480 EXPORT_SYMBOL(drm_mode_set_config_internal);
2481
2482 /**
2483  * drm_crtc_check_viewport - Checks that a framebuffer is big enough for the
2484  *     CRTC viewport
2485  * @crtc: CRTC that framebuffer will be displayed on
2486  * @x: x panning
2487  * @y: y panning
2488  * @mode: mode that framebuffer will be displayed under
2489  * @fb: framebuffer to check size of
2490  */
2491 int drm_crtc_check_viewport(const struct drm_crtc *crtc,
2492                             int x, int y,
2493                             const struct drm_display_mode *mode,
2494                             const struct drm_framebuffer *fb)
2495
2496 {
2497         int hdisplay, vdisplay;
2498
2499         hdisplay = mode->hdisplay;
2500         vdisplay = mode->vdisplay;
2501
2502         if (drm_mode_is_stereo(mode)) {
2503                 struct drm_display_mode adjusted = *mode;
2504
2505                 drm_mode_set_crtcinfo(&adjusted, CRTC_STEREO_DOUBLE);
2506                 hdisplay = adjusted.crtc_hdisplay;
2507                 vdisplay = adjusted.crtc_vdisplay;
2508         }
2509
2510         if (crtc->invert_dimensions)
2511                 swap(hdisplay, vdisplay);
2512
2513         if (hdisplay > fb->width ||
2514             vdisplay > fb->height ||
2515             x > fb->width - hdisplay ||
2516             y > fb->height - vdisplay) {
2517                 DRM_DEBUG_KMS("Invalid fb size %ux%u for CRTC viewport %ux%u+%d+%d%s.\n",
2518                               fb->width, fb->height, hdisplay, vdisplay, x, y,
2519                               crtc->invert_dimensions ? " (inverted)" : "");
2520                 return -ENOSPC;
2521         }
2522
2523         return 0;
2524 }
2525 EXPORT_SYMBOL(drm_crtc_check_viewport);
2526
2527 /**
2528  * drm_mode_setcrtc - set CRTC configuration
2529  * @dev: drm device for the ioctl
2530  * @data: data pointer for the ioctl
2531  * @file_priv: drm file for the ioctl call
2532  *
2533  * Build a new CRTC configuration based on user request.
2534  *
2535  * Called by the user via ioctl.
2536  *
2537  * Returns:
2538  * Zero on success, errno on failure.
2539  */
2540 int drm_mode_setcrtc(struct drm_device *dev, void *data,
2541                      struct drm_file *file_priv)
2542 {
2543         struct drm_mode_config *config = &dev->mode_config;
2544         struct drm_mode_crtc *crtc_req = data;
2545         struct drm_crtc *crtc;
2546         struct drm_connector **connector_set = NULL, *connector;
2547         struct drm_framebuffer *fb = NULL;
2548         struct drm_display_mode *mode = NULL;
2549         struct drm_mode_set set;
2550         uint32_t __user *set_connectors_ptr;
2551         int ret;
2552         int i;
2553
2554         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2555                 return -EINVAL;
2556
2557         /* For some reason crtc x/y offsets are signed internally. */
2558         if (crtc_req->x > INT_MAX || crtc_req->y > INT_MAX)
2559                 return -ERANGE;
2560
2561         drm_modeset_lock_all(dev);
2562         crtc = drm_crtc_find(dev, crtc_req->crtc_id);
2563         if (!crtc) {
2564                 DRM_DEBUG_KMS("Unknown CRTC ID %d\n", crtc_req->crtc_id);
2565                 ret = -ENOENT;
2566                 goto out;
2567         }
2568         DRM_DEBUG_KMS("[CRTC:%d]\n", crtc->base.id);
2569
2570         if (crtc_req->mode_valid) {
2571                 /* If we have a mode we need a framebuffer. */
2572                 /* If we pass -1, set the mode with the currently bound fb */
2573                 if (crtc_req->fb_id == -1) {
2574                         if (!crtc->primary->fb) {
2575                                 DRM_DEBUG_KMS("CRTC doesn't have current FB\n");
2576                                 ret = -EINVAL;
2577                                 goto out;
2578                         }
2579                         fb = crtc->primary->fb;
2580                         /* Make refcounting symmetric with the lookup path. */
2581                         drm_framebuffer_reference(fb);
2582                 } else {
2583                         fb = drm_framebuffer_lookup(dev, crtc_req->fb_id);
2584                         if (!fb) {
2585                                 DRM_DEBUG_KMS("Unknown FB ID%d\n",
2586                                                 crtc_req->fb_id);
2587                                 ret = -ENOENT;
2588                                 goto out;
2589                         }
2590                 }
2591
2592                 mode = drm_mode_create(dev);
2593                 if (!mode) {
2594                         ret = -ENOMEM;
2595                         goto out;
2596                 }
2597
2598                 ret = drm_crtc_convert_umode(mode, &crtc_req->mode);
2599                 if (ret) {
2600                         DRM_DEBUG_KMS("Invalid mode\n");
2601                         goto out;
2602                 }
2603
2604                 drm_mode_set_crtcinfo(mode, CRTC_INTERLACE_HALVE_V);
2605
2606                 ret = drm_crtc_check_viewport(crtc, crtc_req->x, crtc_req->y,
2607                                               mode, fb);
2608                 if (ret)
2609                         goto out;
2610
2611         }
2612
2613         if (crtc_req->count_connectors == 0 && mode) {
2614                 DRM_DEBUG_KMS("Count connectors is 0 but mode set\n");
2615                 ret = -EINVAL;
2616                 goto out;
2617         }
2618
2619         if (crtc_req->count_connectors > 0 && (!mode || !fb)) {
2620                 DRM_DEBUG_KMS("Count connectors is %d but no mode or fb set\n",
2621                           crtc_req->count_connectors);
2622                 ret = -EINVAL;
2623                 goto out;
2624         }
2625
2626         if (crtc_req->count_connectors > 0) {
2627                 u32 out_id;
2628
2629                 /* Avoid unbounded kernel memory allocation */
2630                 if (crtc_req->count_connectors > config->num_connector) {
2631                         ret = -EINVAL;
2632                         goto out;
2633                 }
2634
2635                 connector_set = kmalloc(crtc_req->count_connectors *
2636                                         sizeof(struct drm_connector *),
2637                                         GFP_KERNEL);
2638                 if (!connector_set) {
2639                         ret = -ENOMEM;
2640                         goto out;
2641                 }
2642
2643                 for (i = 0; i < crtc_req->count_connectors; i++) {
2644                         set_connectors_ptr = (uint32_t __user *)(unsigned long)crtc_req->set_connectors_ptr;
2645                         if (get_user(out_id, &set_connectors_ptr[i])) {
2646                                 ret = -EFAULT;
2647                                 goto out;
2648                         }
2649
2650                         connector = drm_connector_find(dev, out_id);
2651                         if (!connector) {
2652                                 DRM_DEBUG_KMS("Connector id %d unknown\n",
2653                                                 out_id);
2654                                 ret = -ENOENT;
2655                                 goto out;
2656                         }
2657                         DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n",
2658                                         connector->base.id,
2659                                         connector->name);
2660
2661                         connector_set[i] = connector;
2662                 }
2663         }
2664
2665         set.crtc = crtc;
2666         set.x = crtc_req->x;
2667         set.y = crtc_req->y;
2668         set.mode = mode;
2669         set.connectors = connector_set;
2670         set.num_connectors = crtc_req->count_connectors;
2671         set.fb = fb;
2672         ret = drm_mode_set_config_internal(&set);
2673
2674 out:
2675         if (fb)
2676                 drm_framebuffer_unreference(fb);
2677
2678         kfree(connector_set);
2679         drm_mode_destroy(dev, mode);
2680         drm_modeset_unlock_all(dev);
2681         return ret;
2682 }
2683
2684 /**
2685  * drm_mode_cursor_universal - translate legacy cursor ioctl call into a
2686  *     universal plane handler call
2687  * @crtc: crtc to update cursor for
2688  * @req: data pointer for the ioctl
2689  * @file_priv: drm file for the ioctl call
2690  *
2691  * Legacy cursor ioctl's work directly with driver buffer handles.  To
2692  * translate legacy ioctl calls into universal plane handler calls, we need to
2693  * wrap the native buffer handle in a drm_framebuffer.
2694  *
2695  * Note that we assume any handle passed to the legacy ioctls was a 32-bit ARGB
2696  * buffer with a pitch of 4*width; the universal plane interface should be used
2697  * directly in cases where the hardware can support other buffer settings and
2698  * userspace wants to make use of these capabilities.
2699  *
2700  * Returns:
2701  * Zero on success, errno on failure.
2702  */
2703 static int drm_mode_cursor_universal(struct drm_crtc *crtc,
2704                                      struct drm_mode_cursor2 *req,
2705                                      struct drm_file *file_priv)
2706 {
2707         struct drm_device *dev = crtc->dev;
2708         struct drm_framebuffer *fb = NULL;
2709         struct drm_mode_fb_cmd2 fbreq = {
2710                 .width = req->width,
2711                 .height = req->height,
2712                 .pixel_format = DRM_FORMAT_ARGB8888,
2713                 .pitches = { req->width * 4 },
2714                 .handles = { req->handle },
2715         };
2716         int32_t crtc_x, crtc_y;
2717         uint32_t crtc_w = 0, crtc_h = 0;
2718         uint32_t src_w = 0, src_h = 0;
2719         int ret = 0;
2720
2721         BUG_ON(!crtc->cursor);
2722
2723         /*
2724          * Obtain fb we'll be using (either new or existing) and take an extra
2725          * reference to it if fb != null.  setplane will take care of dropping
2726          * the reference if the plane update fails.
2727          */
2728         if (req->flags & DRM_MODE_CURSOR_BO) {
2729                 if (req->handle) {
2730                         fb = add_framebuffer_internal(dev, &fbreq, file_priv);
2731                         if (IS_ERR(fb)) {
2732                                 DRM_DEBUG_KMS("failed to wrap cursor buffer in drm framebuffer\n");
2733                                 return PTR_ERR(fb);
2734                         }
2735
2736                         drm_framebuffer_reference(fb);
2737                 } else {
2738                         fb = NULL;
2739                 }
2740         } else {
2741                 mutex_lock(&dev->mode_config.mutex);
2742                 fb = crtc->cursor->fb;
2743                 if (fb)
2744                         drm_framebuffer_reference(fb);
2745                 mutex_unlock(&dev->mode_config.mutex);
2746         }
2747
2748         if (req->flags & DRM_MODE_CURSOR_MOVE) {
2749                 crtc_x = req->x;
2750                 crtc_y = req->y;
2751         } else {
2752                 crtc_x = crtc->cursor_x;
2753                 crtc_y = crtc->cursor_y;
2754         }
2755
2756         if (fb) {
2757                 crtc_w = fb->width;
2758                 crtc_h = fb->height;
2759                 src_w = fb->width << 16;
2760                 src_h = fb->height << 16;
2761         }
2762
2763         /*
2764          * setplane_internal will take care of deref'ing either the old or new
2765          * framebuffer depending on success.
2766          */
2767         ret = setplane_internal(crtc->cursor, crtc, fb,
2768                                 crtc_x, crtc_y, crtc_w, crtc_h,
2769                                 0, 0, src_w, src_h);
2770
2771         /* Update successful; save new cursor position, if necessary */
2772         if (ret == 0 && req->flags & DRM_MODE_CURSOR_MOVE) {
2773                 crtc->cursor_x = req->x;
2774                 crtc->cursor_y = req->y;
2775         }
2776
2777         return ret;
2778 }
2779
2780 static int drm_mode_cursor_common(struct drm_device *dev,
2781                                   struct drm_mode_cursor2 *req,
2782                                   struct drm_file *file_priv)
2783 {
2784         struct drm_crtc *crtc;
2785         int ret = 0;
2786
2787         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2788                 return -EINVAL;
2789
2790         if (!req->flags || (~DRM_MODE_CURSOR_FLAGS & req->flags))
2791                 return -EINVAL;
2792
2793         crtc = drm_crtc_find(dev, req->crtc_id);
2794         if (!crtc) {
2795                 DRM_DEBUG_KMS("Unknown CRTC ID %d\n", req->crtc_id);
2796                 return -ENOENT;
2797         }
2798
2799         /*
2800          * If this crtc has a universal cursor plane, call that plane's update
2801          * handler rather than using legacy cursor handlers.
2802          */
2803         if (crtc->cursor)
2804                 return drm_mode_cursor_universal(crtc, req, file_priv);
2805
2806         drm_modeset_lock_crtc(crtc);
2807         if (req->flags & DRM_MODE_CURSOR_BO) {
2808                 if (!crtc->funcs->cursor_set && !crtc->funcs->cursor_set2) {
2809                         ret = -ENXIO;
2810                         goto out;
2811                 }
2812                 /* Turns off the cursor if handle is 0 */
2813                 if (crtc->funcs->cursor_set2)
2814                         ret = crtc->funcs->cursor_set2(crtc, file_priv, req->handle,
2815                                                       req->width, req->height, req->hot_x, req->hot_y);
2816                 else
2817                         ret = crtc->funcs->cursor_set(crtc, file_priv, req->handle,
2818                                                       req->width, req->height);
2819         }
2820
2821         if (req->flags & DRM_MODE_CURSOR_MOVE) {
2822                 if (crtc->funcs->cursor_move) {
2823                         ret = crtc->funcs->cursor_move(crtc, req->x, req->y);
2824                 } else {
2825                         ret = -EFAULT;
2826                         goto out;
2827                 }
2828         }
2829 out:
2830         drm_modeset_unlock_crtc(crtc);
2831
2832         return ret;
2833
2834 }
2835
2836
2837 /**
2838  * drm_mode_cursor_ioctl - set CRTC's cursor configuration
2839  * @dev: drm device for the ioctl
2840  * @data: data pointer for the ioctl
2841  * @file_priv: drm file for the ioctl call
2842  *
2843  * Set the cursor configuration based on user request.
2844  *
2845  * Called by the user via ioctl.
2846  *
2847  * Returns:
2848  * Zero on success, errno on failure.
2849  */
2850 int drm_mode_cursor_ioctl(struct drm_device *dev,
2851                           void *data, struct drm_file *file_priv)
2852 {
2853         struct drm_mode_cursor *req = data;
2854         struct drm_mode_cursor2 new_req;
2855
2856         memcpy(&new_req, req, sizeof(struct drm_mode_cursor));
2857         new_req.hot_x = new_req.hot_y = 0;
2858
2859         return drm_mode_cursor_common(dev, &new_req, file_priv);
2860 }
2861
2862 /**
2863  * drm_mode_cursor2_ioctl - set CRTC's cursor configuration
2864  * @dev: drm device for the ioctl
2865  * @data: data pointer for the ioctl
2866  * @file_priv: drm file for the ioctl call
2867  *
2868  * Set the cursor configuration based on user request. This implements the 2nd
2869  * version of the cursor ioctl, which allows userspace to additionally specify
2870  * the hotspot of the pointer.
2871  *
2872  * Called by the user via ioctl.
2873  *
2874  * Returns:
2875  * Zero on success, errno on failure.
2876  */
2877 int drm_mode_cursor2_ioctl(struct drm_device *dev,
2878                            void *data, struct drm_file *file_priv)
2879 {
2880         struct drm_mode_cursor2 *req = data;
2881         return drm_mode_cursor_common(dev, req, file_priv);
2882 }
2883
2884 /**
2885  * drm_mode_legacy_fb_format - compute drm fourcc code from legacy description
2886  * @bpp: bits per pixels
2887  * @depth: bit depth per pixel
2888  *
2889  * Computes a drm fourcc pixel format code for the given @bpp/@depth values.
2890  * Useful in fbdev emulation code, since that deals in those values.
2891  */
2892 uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth)
2893 {
2894         uint32_t fmt;
2895
2896         switch (bpp) {
2897         case 8:
2898                 fmt = DRM_FORMAT_C8;
2899                 break;
2900         case 16:
2901                 if (depth == 15)
2902                         fmt = DRM_FORMAT_XRGB1555;
2903                 else
2904                         fmt = DRM_FORMAT_RGB565;
2905                 break;
2906         case 24:
2907                 fmt = DRM_FORMAT_RGB888;
2908                 break;
2909         case 32:
2910                 if (depth == 24)
2911                         fmt = DRM_FORMAT_XRGB8888;
2912                 else if (depth == 30)
2913                         fmt = DRM_FORMAT_XRGB2101010;
2914                 else
2915                         fmt = DRM_FORMAT_ARGB8888;
2916                 break;
2917         default:
2918                 DRM_ERROR("bad bpp, assuming x8r8g8b8 pixel format\n");
2919                 fmt = DRM_FORMAT_XRGB8888;
2920                 break;
2921         }
2922
2923         return fmt;
2924 }
2925 EXPORT_SYMBOL(drm_mode_legacy_fb_format);
2926
2927 /**
2928  * drm_mode_addfb - add an FB to the graphics configuration
2929  * @dev: drm device for the ioctl
2930  * @data: data pointer for the ioctl
2931  * @file_priv: drm file for the ioctl call
2932  *
2933  * Add a new FB to the specified CRTC, given a user request. This is the
2934  * original addfb ioclt which only supported RGB formats.
2935  *
2936  * Called by the user via ioctl.
2937  *
2938  * Returns:
2939  * Zero on success, errno on failure.
2940  */
2941 int drm_mode_addfb(struct drm_device *dev,
2942                    void *data, struct drm_file *file_priv)
2943 {
2944         struct drm_mode_fb_cmd *or = data;
2945         struct drm_mode_fb_cmd2 r = {};
2946         struct drm_mode_config *config = &dev->mode_config;
2947         struct drm_framebuffer *fb;
2948         int ret = 0;
2949
2950         /* Use new struct with format internally */
2951         r.fb_id = or->fb_id;
2952         r.width = or->width;
2953         r.height = or->height;
2954         r.pitches[0] = or->pitch;
2955         r.pixel_format = drm_mode_legacy_fb_format(or->bpp, or->depth);
2956         r.handles[0] = or->handle;
2957
2958         if (!drm_core_check_feature(dev, DRIVER_MODESET))
2959                 return -EINVAL;
2960
2961         if ((config->min_width > r.width) || (r.width > config->max_width))
2962                 return -EINVAL;
2963
2964         if ((config->min_height > r.height) || (r.height > config->max_height))
2965                 return -EINVAL;
2966
2967         fb = dev->mode_config.funcs->fb_create(dev, file_priv, &r);
2968         if (IS_ERR(fb)) {
2969                 DRM_DEBUG_KMS("could not create framebuffer\n");
2970                 return PTR_ERR(fb);
2971         }
2972
2973         mutex_lock(&file_priv->fbs_lock);
2974         or->fb_id = fb->base.id;
2975         list_add(&fb->filp_head, &file_priv->fbs);
2976         DRM_DEBUG_KMS("[FB:%d]\n", fb->base.id);
2977         mutex_unlock(&file_priv->fbs_lock);
2978
2979         return ret;
2980 }
2981
2982 static int format_check(const struct drm_mode_fb_cmd2 *r)
2983 {
2984         uint32_t format = r->pixel_format & ~DRM_FORMAT_BIG_ENDIAN;
2985
2986         switch (format) {
2987         case DRM_FORMAT_C8:
2988         case DRM_FORMAT_RGB332:
2989         case DRM_FORMAT_BGR233:
2990         case DRM_FORMAT_XRGB4444:
2991         case DRM_FORMAT_XBGR4444:
2992         case DRM_FORMAT_RGBX4444:
2993         case DRM_FORMAT_BGRX4444:
2994         case DRM_FORMAT_ARGB4444:
2995         case DRM_FORMAT_ABGR4444:
2996         case DRM_FORMAT_RGBA4444:
2997         case DRM_FORMAT_BGRA4444:
2998         case DRM_FORMAT_XRGB1555:
2999         case DRM_FORMAT_XBGR1555:
3000         case DRM_FORMAT_RGBX5551:
3001         case DRM_FORMAT_BGRX5551:
3002         case DRM_FORMAT_ARGB1555:
3003         case DRM_FORMAT_ABGR1555:
3004         case DRM_FORMAT_RGBA5551:
3005         case DRM_FORMAT_BGRA5551:
3006         case DRM_FORMAT_RGB565:
3007         case DRM_FORMAT_BGR565:
3008         case DRM_FORMAT_RGB888:
3009         case DRM_FORMAT_BGR888:
3010         case DRM_FORMAT_XRGB8888:
3011         case DRM_FORMAT_XBGR8888:
3012         case DRM_FORMAT_RGBX8888:
3013         case DRM_FORMAT_BGRX8888:
3014         case DRM_FORMAT_ARGB8888:
3015         case DRM_FORMAT_ABGR8888:
3016         case DRM_FORMAT_RGBA8888:
3017         case DRM_FORMAT_BGRA8888:
3018         case DRM_FORMAT_XRGB2101010:
3019         case DRM_FORMAT_XBGR2101010:
3020         case DRM_FORMAT_RGBX1010102:
3021         case DRM_FORMAT_BGRX1010102:
3022         case DRM_FORMAT_ARGB2101010:
3023         case DRM_FORMAT_ABGR2101010:
3024         case DRM_FORMAT_RGBA1010102:
3025         case DRM_FORMAT_BGRA1010102:
3026         case DRM_FORMAT_YUYV:
3027         case DRM_FORMAT_YVYU:
3028         case DRM_FORMAT_UYVY:
3029         case DRM_FORMAT_VYUY:
3030         case DRM_FORMAT_AYUV:
3031         case DRM_FORMAT_NV12:
3032         case DRM_FORMAT_NV21:
3033         case DRM_FORMAT_NV16:
3034         case DRM_FORMAT_NV61:
3035         case DRM_FORMAT_NV24:
3036         case DRM_FORMAT_NV42:
3037         case DRM_FORMAT_YUV410:
3038         case DRM_FORMAT_YVU410:
3039         case DRM_FORMAT_YUV411:
3040         case DRM_FORMAT_YVU411:
3041         case DRM_FORMAT_YUV420:
3042         case DRM_FORMAT_YVU420:
3043         case DRM_FORMAT_YUV422:
3044         case DRM_FORMAT_YVU422:
3045         case DRM_FORMAT_YUV444:
3046         case DRM_FORMAT_YVU444:
3047                 return 0;
3048         default:
3049                 DRM_DEBUG_KMS("invalid pixel format %s\n",
3050                               drm_get_format_name(r->pixel_format));
3051                 return -EINVAL;
3052         }
3053 }
3054
3055 static int framebuffer_check(const struct drm_mode_fb_cmd2 *r)
3056 {
3057         int ret, hsub, vsub, num_planes, i;
3058
3059         ret = format_check(r);
3060         if (ret) {
3061                 DRM_DEBUG_KMS("bad framebuffer format %s\n",
3062                               drm_get_format_name(r->pixel_format));
3063                 return ret;
3064         }
3065
3066         hsub = drm_format_horz_chroma_subsampling(r->pixel_format);
3067         vsub = drm_format_vert_chroma_subsampling(r->pixel_format);
3068         num_planes = drm_format_num_planes(r->pixel_format);
3069
3070         if (r->width == 0 || r->width % hsub) {
3071                 DRM_DEBUG_KMS("bad framebuffer width %u\n", r->height);
3072                 return -EINVAL;
3073         }
3074
3075         if (r->height == 0 || r->height % vsub) {
3076                 DRM_DEBUG_KMS("bad framebuffer height %u\n", r->height);
3077                 return -EINVAL;
3078         }
3079
3080         for (i = 0; i < num_planes; i++) {
3081                 unsigned int width = r->width / (i != 0 ? hsub : 1);
3082                 unsigned int height = r->height / (i != 0 ? vsub : 1);
3083                 unsigned int cpp = drm_format_plane_cpp(r->pixel_format, i);
3084
3085                 if (!r->handles[i]) {
3086                         DRM_DEBUG_KMS("no buffer object handle for plane %d\n", i);
3087                         return -EINVAL;
3088                 }
3089
3090                 if ((uint64_t) width * cpp > UINT_MAX)
3091                         return -ERANGE;
3092
3093                 if ((uint64_t) height * r->pitches[i] + r->offsets[i] > UINT_MAX)
3094                         return -ERANGE;
3095
3096                 if (r->pitches[i] < width * cpp) {
3097                         DRM_DEBUG_KMS("bad pitch %u for plane %d\n", r->pitches[i], i);
3098                         return -EINVAL;
3099                 }
3100         }
3101
3102         return 0;
3103 }
3104
3105 static struct drm_framebuffer *add_framebuffer_internal(struct drm_device *dev,
3106                                                         struct drm_mode_fb_cmd2 *r,
3107                                                         struct drm_file *file_priv)
3108 {
3109         struct drm_mode_config *config = &dev->mode_config;
3110         struct drm_framebuffer *fb;
3111         int ret;
3112
3113         if (r->flags & ~DRM_MODE_FB_INTERLACED) {
3114                 DRM_DEBUG_KMS("bad framebuffer flags 0x%08x\n", r->flags);
3115                 return ERR_PTR(-EINVAL);
3116         }
3117
3118         if ((config->min_width > r->width) || (r->width > config->max_width)) {
3119                 DRM_DEBUG_KMS("bad framebuffer width %d, should be >= %d && <= %d\n",
3120                           r->width, config->min_width, config->max_width);
3121                 return ERR_PTR(-EINVAL);
3122         }
3123         if ((config->min_height > r->height) || (r->height > config->max_height)) {
3124                 DRM_DEBUG_KMS("bad framebuffer height %d, should be >= %d && <= %d\n",
3125                           r->height, config->min_height, config->max_height);
3126                 return ERR_PTR(-EINVAL);
3127         }
3128
3129         ret = framebuffer_check(r);
3130         if (ret)
3131                 return ERR_PTR(ret);
3132
3133         fb = dev->mode_config.funcs->fb_create(dev, file_priv, r);
3134         if (IS_ERR(fb)) {
3135                 DRM_DEBUG_KMS("could not create framebuffer\n");
3136                 return fb;
3137         }
3138
3139         mutex_lock(&file_priv->fbs_lock);
3140         r->fb_id = fb->base.id;
3141         list_add(&fb->filp_head, &file_priv->fbs);
3142         DRM_DEBUG_KMS("[FB:%d]\n", fb->base.id);
3143         mutex_unlock(&file_priv->fbs_lock);
3144
3145         return fb;
3146 }
3147
3148 /**
3149  * drm_mode_addfb2 - add an FB to the graphics configuration
3150  * @dev: drm device for the ioctl
3151  * @data: data pointer for the ioctl
3152  * @file_priv: drm file for the ioctl call
3153  *
3154  * Add a new FB to the specified CRTC, given a user request with format. This is
3155  * the 2nd version of the addfb ioctl, which supports multi-planar framebuffers
3156  * and uses fourcc codes as pixel format specifiers.
3157  *
3158  * Called by the user via ioctl.
3159  *
3160  * Returns:
3161  * Zero on success, errno on failure.
3162  */
3163 int drm_mode_addfb2(struct drm_device *dev,
3164                     void *data, struct drm_file *file_priv)
3165 {
3166         struct drm_framebuffer *fb;
3167
3168         if (!drm_core_check_feature(dev, DRIVER_MODESET))
3169                 return -EINVAL;
3170
3171         fb = add_framebuffer_internal(dev, data, file_priv);
3172         if (IS_ERR(fb))
3173                 return PTR_ERR(fb);
3174
3175         return 0;
3176 }
3177
3178 /**
3179  * drm_mode_rmfb - remove an FB from the configuration
3180  * @dev: drm device for the ioctl
3181  * @data: data pointer for the ioctl
3182  * @file_priv: drm file for the ioctl call
3183  *
3184  * Remove the FB specified by the user.
3185  *
3186  * Called by the user via ioctl.
3187  *
3188  * Returns:
3189  * Zero on success, errno on failure.
3190  */
3191 int drm_mode_rmfb(struct drm_device *dev,
3192                    void *data, struct drm_file *file_priv)
3193 {
3194         struct drm_framebuffer *fb = NULL;
3195         struct drm_framebuffer *fbl = NULL;
3196         uint32_t *id = data;
3197         int found = 0;
3198
3199         if (!drm_core_check_feature(dev, DRIVER_MODESET))
3200                 return -EINVAL;
3201
3202         mutex_lock(&file_priv->fbs_lock);
3203         mutex_lock(&dev->mode_config.fb_lock);
3204         fb = __drm_framebuffer_lookup(dev, *id);
3205         if (!fb)
3206                 goto fail_lookup;
3207
3208         list_for_each_entry(fbl, &file_priv->fbs, filp_head)
3209                 if (fb == fbl)
3210                         found = 1;
3211         if (!found)
3212                 goto fail_lookup;
3213
3214         /* Mark fb as reaped, we still have a ref from fpriv->fbs. */
3215         __drm_framebuffer_unregister(dev, fb);
3216
3217         list_del_init(&fb->filp_head);
3218         mutex_unlock(&dev->mode_config.fb_lock);
3219         mutex_unlock(&file_priv->fbs_lock);
3220
3221         drm_framebuffer_remove(fb);
3222
3223         return 0;
3224
3225 fail_lookup:
3226         mutex_unlock(&dev->mode_config.fb_lock);
3227         mutex_unlock(&file_priv->fbs_lock);
3228
3229         return -ENOENT;
3230 }
3231
3232 /**
3233  * drm_mode_getfb - get FB info
3234  * @dev: drm device for the ioctl
3235  * @data: data pointer for the ioctl
3236  * @file_priv: drm file for the ioctl call
3237  *
3238  * Lookup the FB given its ID and return info about it.
3239  *
3240  * Called by the user via ioctl.
3241  *
3242  * Returns:
3243  * Zero on success, errno on failure.
3244  */
3245 int drm_mode_getfb(struct drm_device *dev,
3246                    void *data, struct drm_file *file_priv)
3247 {
3248         struct drm_mode_fb_cmd *r = data;
3249         struct drm_framebuffer *fb;
3250         int ret;
3251
3252         if (!drm_core_check_feature(dev, DRIVER_MODESET))
3253                 return -EINVAL;
3254
3255         fb = drm_framebuffer_lookup(dev, r->fb_id);
3256         if (!fb)
3257                 return -ENOENT;
3258
3259         r->height = fb->height;
3260         r->width = fb->width;
3261         r->depth = fb->depth;
3262         r->bpp = fb->bits_per_pixel;
3263         r->pitch = fb->pitches[0];
3264         if (fb->funcs->create_handle) {
3265                 if (file_priv->is_master || capable(CAP_SYS_ADMIN) ||
3266                     drm_is_control_client(file_priv)) {
3267                         ret = fb->funcs->create_handle(fb, file_priv,
3268                                                        &r->handle);
3269                 } else {
3270                         /* GET_FB() is an unprivileged ioctl so we must not
3271                          * return a buffer-handle to non-master processes! For
3272                          * backwards-compatibility reasons, we cannot make
3273                          * GET_FB() privileged, so just return an invalid handle
3274                          * for non-masters. */
3275                         r->handle = 0;
3276                         ret = 0;
3277                 }
3278         } else {
3279                 ret = -ENODEV;
3280         }
3281
3282         drm_framebuffer_unreference(fb);
3283
3284         return ret;
3285 }
3286
3287 /**
3288  * drm_mode_dirtyfb_ioctl - flush frontbuffer rendering on an FB
3289  * @dev: drm device for the ioctl
3290  * @data: data pointer for the ioctl
3291  * @file_priv: drm file for the ioctl call
3292  *
3293  * Lookup the FB and flush out the damaged area supplied by userspace as a clip
3294  * rectangle list. Generic userspace which does frontbuffer rendering must call
3295  * this ioctl to flush out the changes on manual-update display outputs, e.g.
3296  * usb display-link, mipi manual update panels or edp panel self refresh modes.
3297  *
3298  * Modesetting drivers which always update the frontbuffer do not need to
3299  * implement the corresponding ->dirty framebuffer callback.
3300  *
3301  * Called by the user via ioctl.
3302  *
3303  * Returns:
3304  * Zero on success, errno on failure.
3305  */
3306 int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
3307                            void *data, struct drm_file *file_priv)
3308 {
3309         struct drm_clip_rect __user *clips_ptr;
3310         struct drm_clip_rect *clips = NULL;
3311         struct drm_mode_fb_dirty_cmd *r = data;
3312         struct drm_framebuffer *fb;
3313         unsigned flags;
3314         int num_clips;
3315         int ret;
3316
3317         if (!drm_core_check_feature(dev, DRIVER_MODESET))
3318                 return -EINVAL;
3319
3320         fb = drm_framebuffer_lookup(dev, r->fb_id);
3321         if (!fb)
3322                 return -ENOENT;
3323
3324         num_clips = r->num_clips;
3325         clips_ptr = (struct drm_clip_rect __user *)(unsigned long)r->clips_ptr;
3326
3327         if (!num_clips != !clips_ptr) {
3328                 ret = -EINVAL;
3329                 goto out_err1;
3330         }
3331
3332         flags = DRM_MODE_FB_DIRTY_FLAGS & r->flags;
3333
3334         /* If userspace annotates copy, clips must come in pairs */
3335         if (flags & DRM_MODE_FB_DIRTY_ANNOTATE_COPY && (num_clips % 2)) {
3336                 ret = -EINVAL;
3337                 goto out_err1;
3338         }
3339
3340         if (num_clips && clips_ptr) {
3341                 if (num_clips < 0 || num_clips > DRM_MODE_FB_DIRTY_MAX_CLIPS) {
3342                         ret = -EINVAL;
3343                         goto out_err1;
3344                 }
3345                 clips = kzalloc(num_clips * sizeof(*clips), GFP_KERNEL);
3346                 if (!clips) {
3347                         ret = -ENOMEM;
3348                         goto out_err1;
3349                 }
3350
3351                 ret = copy_from_user(clips, clips_ptr,
3352                                      num_clips * sizeof(*clips));
3353                 if (ret) {
3354                         ret = -EFAULT;
3355                         goto out_err2;
3356                 }
3357         }
3358
3359         if (fb->funcs->dirty) {
3360                 ret = fb->funcs->dirty(fb, file_priv, flags, r->color,
3361                                        clips, num_clips);
3362         } else {
3363                 ret = -ENOSYS;
3364         }
3365
3366 out_err2:
3367         kfree(clips);
3368 out_err1:
3369         drm_framebuffer_unreference(fb);
3370
3371         return ret;
3372 }
3373
3374
3375 /**
3376  * drm_fb_release - remove and free the FBs on this file
3377  * @priv: drm file for the ioctl
3378  *
3379  * Destroy all the FBs associated with @filp.
3380  *
3381  * Called by the user via ioctl.
3382  *
3383  * Returns:
3384  * Zero on success, errno on failure.
3385  */
3386 void drm_fb_release(struct drm_file *priv)
3387 {
3388         struct drm_device *dev = priv->minor->dev;
3389         struct drm_framebuffer *fb, *tfb;
3390
3391         mutex_lock(&priv->fbs_lock);
3392         list_for_each_entry_safe(fb, tfb, &priv->fbs, filp_head) {
3393
3394                 mutex_lock(&dev->mode_config.fb_lock);
3395                 /* Mark fb as reaped, we still have a ref from fpriv->fbs. */
3396                 __drm_framebuffer_unregister(dev, fb);
3397                 mutex_unlock(&dev->mode_config.fb_lock);
3398
3399                 list_del_init(&fb->filp_head);
3400
3401                 /* This will also drop the fpriv->fbs reference. */
3402                 drm_framebuffer_remove(fb);
3403         }
3404         mutex_unlock(&priv->fbs_lock);
3405 }
3406
3407 /**
3408  * drm_property_create - create a new property type
3409  * @dev: drm device
3410  * @flags: flags specifying the property type
3411  * @name: name of the property
3412  * @num_values: number of pre-defined values
3413  *
3414  * This creates a new generic drm property which can then be attached to a drm
3415  * object with drm_object_attach_property. The returned property object must be
3416  * freed with drm_property_destroy.
3417  *
3418  * Returns:
3419  * A pointer to the newly created property on success, NULL on failure.
3420  */
3421 struct drm_property *drm_property_create(struct drm_device *dev, int flags,
3422                                          const char *name, int num_values)
3423 {
3424         struct drm_property *property = NULL;
3425         int ret;
3426
3427         property = kzalloc(sizeof(struct drm_property), GFP_KERNEL);
3428         if (!property)
3429                 return NULL;
3430
3431         property->dev = dev;
3432
3433         if (num_values) {
3434                 property->values = kzalloc(sizeof(uint64_t)*num_values, GFP_KERNEL);
3435                 if (!property->values)
3436                         goto fail;
3437         }
3438
3439         ret = drm_mode_object_get(dev, &property->base, DRM_MODE_OBJECT_PROPERTY);
3440         if (ret)
3441                 goto fail;
3442
3443         property->flags = flags;
3444         property->num_values = num_values;
3445         INIT_LIST_HEAD(&property->enum_blob_list);
3446
3447         if (name) {
3448                 strncpy(property->name, name, DRM_PROP_NAME_LEN);
3449                 property->name[DRM_PROP_NAME_LEN-1] = '\0';
3450         }
3451
3452         list_add_tail(&property->head, &dev->mode_config.property_list);
3453
3454         WARN_ON(!drm_property_type_valid(property));
3455
3456         return property;
3457 fail:
3458         kfree(property->values);
3459         kfree(property);
3460         return NULL;
3461 }
3462 EXPORT_SYMBOL(drm_property_create);
3463
3464 /**
3465  * drm_property_create_enum - create a new enumeration property type
3466  * @dev: drm device
3467  * @flags: flags specifying the property type
3468  * @name: name of the property
3469  * @props: enumeration lists with property values
3470  * @num_values: number of pre-defined values
3471  *
3472  * This creates a new generic drm property which can then be attached to a drm
3473  * object with drm_object_attach_property. The returned property object must be
3474  * freed with drm_property_destroy.
3475  *
3476  * Userspace is only allowed to set one of the predefined values for enumeration
3477  * properties.
3478  *
3479  * Returns:
3480  * A pointer to the newly created property on success, NULL on failure.
3481  */
3482 struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags,
3483                                          const char *name,
3484                                          const struct drm_prop_enum_list *props,
3485                                          int num_values)
3486 {
3487         struct drm_property *property;
3488         int i, ret;
3489
3490         flags |= DRM_MODE_PROP_ENUM;
3491
3492         property = drm_property_create(dev, flags, name, num_values);
3493         if (!property)
3494                 return NULL;
3495
3496         for (i = 0; i < num_values; i++) {
3497                 ret = drm_property_add_enum(property, i,
3498                                       props[i].type,
3499                                       props[i].name);
3500                 if (ret) {
3501                         drm_property_destroy(dev, property);
3502                         return NULL;
3503                 }
3504         }
3505
3506         return property;
3507 }
3508 EXPORT_SYMBOL(drm_property_create_enum);
3509
3510 /**
3511  * drm_property_create_bitmask - create a new bitmask property type
3512  * @dev: drm device
3513  * @flags: flags specifying the property type
3514  * @name: name of the property
3515  * @props: enumeration lists with property bitflags
3516  * @num_props: size of the @props array
3517  * @supported_bits: bitmask of all supported enumeration values
3518  *
3519  * This creates a new bitmask drm property which can then be attached to a drm
3520  * object with drm_object_attach_property. The returned property object must be
3521  * freed with drm_property_destroy.
3522  *
3523  * Compared to plain enumeration properties userspace is allowed to set any
3524  * or'ed together combination of the predefined property bitflag values
3525  *
3526  * Returns:
3527  * A pointer to the newly created property on success, NULL on failure.
3528  */
3529 struct drm_property *drm_property_create_bitmask(struct drm_device *dev,
3530                                          int flags, const char *name,
3531                                          const struct drm_prop_enum_list *props,
3532                                          int num_props,
3533                                          uint64_t supported_bits)
3534 {
3535         struct drm_property *property;
3536         int i, ret, index = 0;
3537         int num_values = hweight64(supported_bits);
3538
3539         flags |= DRM_MODE_PROP_BITMASK;
3540
3541         property = drm_property_create(dev, flags, name, num_values);
3542         if (!property)
3543                 return NULL;
3544         for (i = 0; i < num_props; i++) {
3545                 if (!(supported_bits & (1ULL << props[i].type)))
3546                         continue;
3547
3548                 if (WARN_ON(index >= num_values)) {
3549                         drm_property_destroy(dev, property);
3550                         return NULL;
3551                 }
3552
3553                 ret = drm_property_add_enum(property, index++,
3554                                       props[i].type,
3555                                       props[i].name);
3556                 if (ret) {
3557                         drm_property_destroy(dev, property);
3558                         return NULL;
3559                 }
3560         }
3561
3562         return property;
3563 }
3564 EXPORT_SYMBOL(drm_property_create_bitmask);
3565
3566 static struct drm_property *property_create_range(struct drm_device *dev,
3567                                          int flags, const char *name,
3568                                          uint64_t min, uint64_t max)
3569 {
3570         struct drm_property *property;
3571
3572         property = drm_property_create(dev, flags, name, 2);
3573         if (!property)
3574                 return NULL;
3575
3576         property->values[0] = min;
3577         property->values[1] = max;
3578
3579         return property;
3580 }
3581
3582 /**
3583  * drm_property_create_range - create a new ranged property type
3584  * @dev: drm device
3585  * @flags: flags specifying the property type
3586  * @name: name of the property
3587  * @min: minimum value of the property
3588  * @max: maximum value of the property
3589  *
3590  * This creates a new generic drm property which can then be attached to a drm
3591  * object with drm_object_attach_property. The returned property object must be
3592  * freed with drm_property_destroy.
3593  *
3594  * Userspace is allowed to set any interger value in the (min, max) range
3595  * inclusive.
3596  *
3597  * Returns:
3598  * A pointer to the newly created property on success, NULL on failure.
3599  */
3600 struct drm_property *drm_property_create_range(struct drm_device *dev, int flags,
3601                                          const char *name,
3602                                          uint64_t min, uint64_t max)
3603 {
3604         return property_create_range(dev, DRM_MODE_PROP_RANGE | flags,
3605                         name, min, max);
3606 }
3607 EXPORT_SYMBOL(drm_property_create_range);
3608
3609 struct drm_property *drm_property_create_signed_range(struct drm_device *dev,
3610                                          int flags, const char *name,
3611                                          int64_t min, int64_t max)
3612 {
3613         return property_create_range(dev, DRM_MODE_PROP_SIGNED_RANGE | flags,
3614                         name, I642U64(min), I642U64(max));
3615 }
3616 EXPORT_SYMBOL(drm_property_create_signed_range);
3617
3618 struct drm_property *drm_property_create_object(struct drm_device *dev,
3619                                          int flags, const char *name, uint32_t type)
3620 {
3621         struct drm_property *property;
3622
3623         flags |= DRM_MODE_PROP_OBJECT;
3624
3625         property = drm_property_create(dev, flags, name, 1);
3626         if (!property)
3627                 return NULL;
3628
3629         property->values[0] = type;
3630
3631         return property;
3632 }
3633 EXPORT_SYMBOL(drm_property_create_object);
3634
3635 /**
3636  * drm_property_add_enum - add a possible value to an enumeration property
3637  * @property: enumeration property to change
3638  * @index: index of the new enumeration
3639  * @value: value of the new enumeration
3640  * @name: symbolic name of the new enumeration
3641  *
3642  * This functions adds enumerations to a property.
3643  *
3644  * It's use is deprecated, drivers should use one of the more specific helpers
3645  * to directly create the property with all enumerations already attached.
3646  *
3647  * Returns:
3648  * Zero on success, error code on failure.
3649  */
3650 int drm_property_add_enum(struct drm_property *property, int index,
3651                           uint64_t value, const char *name)
3652 {
3653         struct drm_property_enum *prop_enum;
3654
3655         if (!(drm_property_type_is(property, DRM_MODE_PROP_ENUM) ||
3656                         drm_property_type_is(property, DRM_MODE_PROP_BITMASK)))
3657                 return -EINVAL;
3658
3659         /*
3660          * Bitmask enum properties have the additional constraint of values
3661          * from 0 to 63
3662          */
3663         if (drm_property_type_is(property, DRM_MODE_PROP_BITMASK) &&
3664                         (value > 63))
3665                 return -EINVAL;
3666
3667         if (!list_empty(&property->enum_blob_list)) {
3668                 list_for_each_entry(prop_enum, &property->enum_blob_list, head) {
3669                         if (prop_enum->value == value) {
3670                                 strncpy(prop_enum->name, name, DRM_PROP_NAME_LEN);
3671                                 prop_enum->name[DRM_PROP_NAME_LEN-1] = '\0';
3672                                 return 0;
3673                         }
3674                 }
3675         }
3676
3677         prop_enum = kzalloc(sizeof(struct drm_property_enum), GFP_KERNEL);
3678         if (!prop_enum)
3679                 return -ENOMEM;
3680
3681         strncpy(prop_enum->name, name, DRM_PROP_NAME_LEN);
3682         prop_enum->name[DRM_PROP_NAME_LEN-1] = '\0';
3683         prop_enum->value = value;
3684
3685         property->values[index] = value;
3686         list_add_tail(&prop_enum->head, &property->enum_blob_list);
3687         return 0;
3688 }
3689 EXPORT_SYMBOL(drm_property_add_enum);
3690
3691 /**
3692  * drm_property_destroy - destroy a drm property
3693  * @dev: drm device
3694  * @property: property to destry
3695  *
3696  * This function frees a property including any attached resources like
3697  * enumeration values.
3698  */
3699 void drm_property_destroy(struct drm_device *dev, struct drm_property *property)
3700 {
3701         struct drm_property_enum *prop_enum, *pt;
3702
3703         list_for_each_entry_safe(prop_enum, pt, &property->enum_blob_list, head) {
3704                 list_del(&prop_enum->head);
3705                 kfree(prop_enum);
3706         }
3707
3708         if (property->num_values)
3709                 kfree(property->values);
3710         drm_mode_object_put(dev, &property->base);
3711         list_del(&property->head);
3712         kfree(property);
3713 }
3714 EXPORT_SYMBOL(drm_property_destroy);
3715
3716 /**
3717  * drm_object_attach_property - attach a property to a modeset object
3718  * @obj: drm modeset object
3719  * @property: property to attach
3720  * @init_val: initial value of the property
3721  *
3722  * This attaches the given property to the modeset object with the given initial
3723  * value. Currently this function cannot fail since the properties are stored in
3724  * a statically sized array.
3725  */
3726 void drm_object_attach_property(struct drm_mode_object *obj,
3727                                 struct drm_property *property,
3728                                 uint64_t init_val)
3729 {
3730         int count = obj->properties->count;
3731
3732         if (count == DRM_OBJECT_MAX_PROPERTY) {
3733                 WARN(1, "Failed to attach object property (type: 0x%x). Please "
3734                         "increase DRM_OBJECT_MAX_PROPERTY by 1 for each time "
3735                         "you see this message on the same object type.\n",
3736                         obj->type);
3737                 return;
3738         }
3739
3740         obj->properties->ids[count] = property->base.id;
3741         obj->properties->values[count] = init_val;
3742         obj->properties->count++;
3743 }
3744 EXPORT_SYMBOL(drm_object_attach_property);
3745
3746 /**
3747  * drm_object_property_set_value - set the value of a property
3748  * @obj: drm mode object to set property value for
3749  * @property: property to set
3750  * @val: value the property should be set to
3751  *
3752  * This functions sets a given property on a given object. This function only
3753  * changes the software state of the property, it does not call into the
3754  * driver's ->set_property callback.
3755  *
3756  * Returns:
3757  * Zero on success, error code on failure.
3758  */
3759 int drm_object_property_set_value(struct drm_mode_object *obj,
3760                                   struct drm_property *property, uint64_t val)
3761 {
3762         int i;
3763
3764         for (i = 0; i < obj->properties->count; i++) {
3765                 if (obj->properties->ids[i] == property->base.id) {
3766                         obj->properties->values[i] = val;
3767                         return 0;
3768                 }
3769         }
3770
3771         return -EINVAL;
3772 }
3773 EXPORT_SYMBOL(drm_object_property_set_value);
3774
3775 /**
3776  * drm_object_property_get_value - retrieve the value of a property
3777  * @obj: drm mode object to get property value from
3778  * @property: property to retrieve
3779  * @val: storage for the property value
3780  *
3781  * This function retrieves the softare state of the given property for the given
3782  * property. Since there is no driver callback to retrieve the current property
3783  * value this might be out of sync with the hardware, depending upon the driver
3784  * and property.
3785  *
3786  * Returns:
3787  * Zero on success, error code on failure.
3788  */
3789 int drm_object_property_get_value(struct drm_mode_object *obj,
3790                                   struct drm_property *property, uint64_t *val)
3791 {
3792         int i;
3793
3794         for (i = 0; i < obj->properties->count; i++) {
3795                 if (obj->properties->ids[i] == property->base.id) {
3796                         *val = obj->properties->values[i];
3797                         return 0;
3798                 }
3799         }
3800
3801         return -EINVAL;
3802 }
3803 EXPORT_SYMBOL(drm_object_property_get_value);
3804
3805 /**
3806  * drm_mode_getproperty_ioctl - get the current value of a connector's property
3807  * @dev: DRM device
3808  * @data: ioctl data
3809  * @file_priv: DRM file info
3810  *
3811  * This function retrieves the current value for an connectors's property.
3812  *
3813  * Called by the user via ioctl.
3814  *
3815  * Returns:
3816  * Zero on success, errno on failure.
3817  */
3818 int drm_mode_getproperty_ioctl(struct drm_device *dev,
3819                                void *data, struct drm_file *file_priv)
3820 {
3821         struct drm_mode_get_property *out_resp = data;
3822         struct drm_property *property;
3823         int enum_count = 0;
3824         int blob_count = 0;
3825         int value_count = 0;
3826         int ret = 0, i;
3827         int copied;
3828         struct drm_property_enum *prop_enum;
3829         struct drm_mode_property_enum __user *enum_ptr;
3830         struct drm_property_blob *prop_blob;
3831         uint32_t __user *blob_id_ptr;
3832         uint64_t __user *values_ptr;
3833         uint32_t __user *blob_length_ptr;
3834
3835         if (!drm_core_check_feature(dev, DRIVER_MODESET))
3836                 return -EINVAL;
3837
3838         drm_modeset_lock_all(dev);
3839         property = drm_property_find(dev, out_resp->prop_id);
3840         if (!property) {
3841                 ret = -ENOENT;
3842                 goto done;
3843         }
3844
3845         if (drm_property_type_is(property, DRM_MODE_PROP_ENUM) ||
3846                         drm_property_type_is(property, DRM_MODE_PROP_BITMASK)) {
3847                 list_for_each_entry(prop_enum, &property->enum_blob_list, head)
3848                         enum_count++;
3849         } else if (drm_property_type_is(property, DRM_MODE_PROP_BLOB)) {
3850                 list_for_each_entry(prop_blob, &property->enum_blob_list, head)
3851                         blob_count++;
3852         }
3853
3854         value_count = property->num_values;
3855
3856         strncpy(out_resp->name, property->name, DRM_PROP_NAME_LEN);
3857         out_resp->name[DRM_PROP_NAME_LEN-1] = 0;
3858         out_resp->flags = property->flags;
3859
3860         if ((out_resp->count_values >= value_count) && value_count) {
3861                 values_ptr = (uint64_t __user *)(unsigned long)out_resp->values_ptr;
3862                 for (i = 0; i < value_count; i++) {
3863                         if (copy_to_user(values_ptr + i, &property->values[i], sizeof(uint64_t))) {
3864                                 ret = -EFAULT;
3865                                 goto done;
3866                         }
3867                 }
3868         }
3869         out_resp->count_values = value_count;
3870
3871         if (drm_property_type_is(property, DRM_MODE_PROP_ENUM) ||
3872                         drm_property_type_is(property, DRM_MODE_PROP_BITMASK)) {
3873                 if ((out_resp->count_enum_blobs >= enum_count) && enum_count) {
3874                         copied = 0;
3875                         enum_ptr = (struct drm_mode_property_enum __user *)(unsigned long)out_resp->enum_blob_ptr;
3876                         list_for_each_entry(prop_enum, &property->enum_blob_list, head) {
3877
3878                                 if (copy_to_user(&enum_ptr[copied].value, &prop_enum->value, sizeof(uint64_t))) {
3879                                         ret = -EFAULT;
3880                                         goto done;
3881                                 }
3882
3883                                 if (copy_to_user(&enum_ptr[copied].name,
3884                                                  &prop_enum->name, DRM_PROP_NAME_LEN)) {
3885                                         ret = -EFAULT;
3886                                         goto done;
3887                                 }
3888                                 copied++;
3889                         }
3890                 }
3891                 out_resp->count_enum_blobs = enum_count;
3892         }
3893
3894         if (drm_property_type_is(property, DRM_MODE_PROP_BLOB)) {
3895                 if ((out_resp->count_enum_blobs >= blob_count) && blob_count) {
3896                         copied = 0;
3897                         blob_id_ptr = (uint32_t __user *)(unsigned long)out_resp->enum_blob_ptr;
3898                         blob_length_ptr = (uint32_t __user *)(unsigned long)out_resp->values_ptr;
3899
3900                         list_for_each_entry(prop_blob, &property->enum_blob_list, head) {
3901                                 if (put_user(prop_blob->base.id, blob_id_ptr + copied)) {
3902                                         ret = -EFAULT;
3903                                         goto done;
3904                                 }
3905
3906                                 if (put_user(prop_blob->length, blob_length_ptr + copied)) {
3907                                         ret = -EFAULT;
3908                                         goto done;
3909                                 }
3910
3911                                 copied++;
3912                         }
3913                 }
3914                 out_resp->count_enum_blobs = blob_count;
3915         }
3916 done:
3917         drm_modeset_unlock_all(dev);
3918         return ret;
3919 }
3920
3921 static struct drm_property_blob *drm_property_create_blob(struct drm_device *dev, int length,
3922                                                           void *data)
3923 {
3924         struct drm_property_blob *blob;
3925         int ret;
3926
3927         if (!length || !data)
3928                 return NULL;
3929
3930         blob = kzalloc(sizeof(struct drm_property_blob)+length, GFP_KERNEL);
3931         if (!blob)
3932                 return NULL;
3933
3934         ret = drm_mode_object_get(dev, &blob->base, DRM_MODE_OBJECT_BLOB);
3935         if (ret) {
3936                 kfree(blob);
3937                 return NULL;
3938         }
3939
3940         blob->length = length;
3941
3942         memcpy(blob->data, data, length);
3943
3944         list_add_tail(&blob->head, &dev->mode_config.property_blob_list);
3945         return blob;
3946 }
3947
3948 static void drm_property_destroy_blob(struct drm_device *dev,
3949                                struct drm_property_blob *blob)
3950 {
3951         drm_mode_object_put(dev, &blob->base);
3952         list_del(&blob->head);
3953         kfree(blob);
3954 }
3955
3956 /**
3957  * drm_mode_getblob_ioctl - get the contents of a blob property value
3958  * @dev: DRM device
3959  * @data: ioctl data
3960  * @file_priv: DRM file info
3961  *
3962  * This function retrieves the contents of a blob property. The value stored in
3963  * an object's blob property is just a normal modeset object id.
3964  *
3965  * Called by the user via ioctl.
3966  *
3967  * Returns:
3968  * Zero on success, errno on failure.
3969  */
3970 int drm_mode_getblob_ioctl(struct drm_device *dev,
3971                            void *data, struct drm_file *file_priv)
3972 {
3973         struct drm_mode_get_blob *out_resp = data;
3974         struct drm_property_blob *blob;
3975         int ret = 0;
3976         void __user *blob_ptr;
3977
3978         if (!drm_core_check_feature(dev, DRIVER_MODESET))
3979                 return -EINVAL;
3980
3981         drm_modeset_lock_all(dev);
3982         blob = drm_property_blob_find(dev, out_resp->blob_id);
3983         if (!blob) {
3984                 ret = -ENOENT;
3985                 goto done;
3986         }
3987
3988         if (out_resp->length == blob->length) {
3989                 blob_ptr = (void __user *)(unsigned long)out_resp->data;
3990                 if (copy_to_user(blob_ptr, blob->data, blob->length)){
3991                         ret = -EFAULT;
3992                         goto done;
3993                 }
3994         }
3995         out_resp->length = blob->length;
3996
3997 done:
3998         drm_modeset_unlock_all(dev);
3999         return ret;
4000 }
4001
4002 int drm_mode_connector_set_path_property(struct drm_connector *connector,
4003                                          char *path)
4004 {
4005         struct drm_device *dev = connector->dev;
4006         int ret, size;
4007         size = strlen(path) + 1;
4008
4009         connector->path_blob_ptr = drm_property_create_blob(connector->dev,
4010                                                             size, path);
4011         if (!connector->path_blob_ptr)
4012                 return -EINVAL;
4013
4014         ret = drm_object_property_set_value(&connector->base,
4015                                             dev->mode_config.path_property,
4016                                             connector->path_blob_ptr->base.id);
4017         return ret;
4018 }
4019 EXPORT_SYMBOL(drm_mode_connector_set_path_property);
4020
4021 /**
4022  * drm_mode_connector_update_edid_property - update the edid property of a connector
4023  * @connector: drm connector
4024  * @edid: new value of the edid property
4025  *
4026  * This function creates a new blob modeset object and assigns its id to the
4027  * connector's edid property.
4028  *
4029  * Returns:
4030  * Zero on success, errno on failure.
4031  */
4032 int drm_mode_connector_update_edid_property(struct drm_connector *connector,
4033                                             struct edid *edid)
4034 {
4035         struct drm_device *dev = connector->dev;
4036         int ret, size;
4037
4038         /* ignore requests to set edid when overridden */
4039         if (connector->override_edid)
4040                 return 0;
4041
4042         if (connector->edid_blob_ptr)
4043                 drm_property_destroy_blob(dev, connector->edid_blob_ptr);
4044
4045         /* Delete edid, when there is none. */
4046         if (!edid) {
4047                 connector->edid_blob_ptr = NULL;
4048                 ret = drm_object_property_set_value(&connector->base, dev->mode_config.edid_property, 0);
4049                 return ret;
4050         }
4051
4052         size = EDID_LENGTH * (1 + edid->extensions);
4053         connector->edid_blob_ptr = drm_property_create_blob(connector->dev,
4054                                                             size, edid);
4055         if (!connector->edid_blob_ptr)
4056                 return -EINVAL;
4057
4058         ret = drm_object_property_set_value(&connector->base,
4059                                                dev->mode_config.edid_property,
4060                                                connector->edid_blob_ptr->base.id);
4061
4062         return ret;
4063 }
4064 EXPORT_SYMBOL(drm_mode_connector_update_edid_property);
4065
4066 static bool drm_property_change_is_valid(struct drm_property *property,
4067                                          uint64_t value)
4068 {
4069         if (property->flags & DRM_MODE_PROP_IMMUTABLE)
4070                 return false;
4071
4072         if (drm_property_type_is(property, DRM_MODE_PROP_RANGE)) {
4073                 if (value < property->values[0] || value > property->values[1])
4074                         return false;
4075                 return true;
4076         } else if (drm_property_type_is(property, DRM_MODE_PROP_SIGNED_RANGE)) {
4077                 int64_t svalue = U642I64(value);
4078                 if (svalue < U642I64(property->values[0]) ||
4079                                 svalue > U642I64(property->values[1]))
4080                         return false;
4081                 return true;
4082         } else if (drm_property_type_is(property, DRM_MODE_PROP_BITMASK)) {
4083                 int i;
4084                 uint64_t valid_mask = 0;
4085                 for (i = 0; i < property->num_values; i++)
4086                         valid_mask |= (1ULL << property->values[i]);
4087                 return !(value & ~valid_mask);
4088         } else if (drm_property_type_is(property, DRM_MODE_PROP_BLOB)) {
4089                 /* Only the driver knows */
4090                 return true;
4091         } else if (drm_property_type_is(property, DRM_MODE_PROP_OBJECT)) {
4092                 struct drm_mode_object *obj;
4093                 /* a zero value for an object property translates to null: */
4094                 if (value == 0)
4095                         return true;
4096                 /*
4097                  * NOTE: use _object_find() directly to bypass restriction on
4098                  * looking up refcnt'd objects (ie. fb's).  For a refcnt'd
4099                  * object this could race against object finalization, so it
4100                  * simply tells us that the object *was* valid.  Which is good
4101                  * enough.
4102                  */
4103                 obj = _object_find(property->dev, value, property->values[0]);
4104                 return obj != NULL;
4105         } else {
4106                 int i;
4107                 for (i = 0; i < property->num_values; i++)
4108                         if (property->values[i] == value)
4109                                 return true;
4110                 return false;
4111         }
4112 }
4113
4114 /**
4115  * drm_mode_connector_property_set_ioctl - set the current value of a connector property
4116  * @dev: DRM device
4117  * @data: ioctl data
4118  * @file_priv: DRM file info
4119  *
4120  * This function sets the current value for a connectors's property. It also
4121  * calls into a driver's ->set_property callback to update the hardware state
4122  *
4123  * Called by the user via ioctl.
4124  *
4125  * Returns:
4126  * Zero on success, errno on failure.
4127  */
4128 int drm_mode_connector_property_set_ioctl(struct drm_device *dev,
4129                                        void *data, struct drm_file *file_priv)
4130 {
4131         struct drm_mode_connector_set_property *conn_set_prop = data;
4132         struct drm_mode_obj_set_property obj_set_prop = {
4133                 .value = conn_set_prop->value,
4134                 .prop_id = conn_set_prop->prop_id,
4135                 .obj_id = conn_set_prop->connector_id,
4136                 .obj_type = DRM_MODE_OBJECT_CONNECTOR
4137         };
4138
4139         /* It does all the locking and checking we need */
4140         return drm_mode_obj_set_property_ioctl(dev, &obj_set_prop, file_priv);
4141 }
4142
4143 static int drm_mode_connector_set_obj_prop(struct drm_mode_object *obj,
4144                                            struct drm_property *property,
4145                                            uint64_t value)
4146 {
4147         int ret = -EINVAL;
4148         struct drm_connector *connector = obj_to_connector(obj);
4149
4150         /* Do DPMS ourselves */
4151         if (property == connector->dev->mode_config.dpms_property) {
4152                 if (connector->funcs->dpms)
4153                         (*connector->funcs->dpms)(connector, (int)value);
4154                 ret = 0;
4155         } else if (connector->funcs->set_property)
4156                 ret = connector->funcs->set_property(connector, property, value);
4157
4158         /* store the property value if successful */
4159         if (!ret)
4160                 drm_object_property_set_value(&connector->base, property, value);
4161         return ret;
4162 }
4163
4164 static int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj,
4165                                       struct drm_property *property,
4166                                       uint64_t value)
4167 {
4168         int ret = -EINVAL;
4169         struct drm_crtc *crtc = obj_to_crtc(obj);
4170
4171         if (crtc->funcs->set_property)
4172                 ret = crtc->funcs->set_property(crtc, property, value);
4173         if (!ret)
4174                 drm_object_property_set_value(obj, property, value);
4175
4176         return ret;
4177 }
4178
4179 /**
4180  * drm_mode_plane_set_obj_prop - set the value of a property
4181  * @plane: drm plane object to set property value for
4182  * @property: property to set
4183  * @value: value the property should be set to
4184  *
4185  * This functions sets a given property on a given plane object. This function
4186  * calls the driver's ->set_property callback and changes the software state of
4187  * the property if the callback succeeds.
4188  *
4189  * Returns:
4190  * Zero on success, error code on failure.
4191  */
4192 int drm_mode_plane_set_obj_prop(struct drm_plane *plane,
4193                                 struct drm_property *property,
4194                                 uint64_t value)
4195 {
4196         int ret = -EINVAL;
4197         struct drm_mode_object *obj = &plane->base;
4198
4199         if (plane->funcs->set_property)
4200                 ret = plane->funcs->set_property(plane, property, value);
4201         if (!ret)
4202                 drm_object_property_set_value(obj, property, value);
4203
4204         return ret;
4205 }
4206 EXPORT_SYMBOL(drm_mode_plane_set_obj_prop);
4207
4208 /**
4209  * drm_mode_getproperty_ioctl - get the current value of a object's property
4210  * @dev: DRM device
4211  * @data: ioctl data
4212  * @file_priv: DRM file info
4213  *
4214  * This function retrieves the current value for an object's property. Compared
4215  * to the connector specific ioctl this one is extended to also work on crtc and
4216  * plane objects.
4217  *
4218  * Called by the user via ioctl.
4219  *
4220  * Returns:
4221  * Zero on success, errno on failure.
4222  */
4223 int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
4224                                       struct drm_file *file_priv)
4225 {
4226         struct drm_mode_obj_get_properties *arg = data;
4227         struct drm_mode_object *obj;
4228         int ret = 0;
4229         int i;
4230         int copied = 0;
4231         int props_count = 0;
4232         uint32_t __user *props_ptr;
4233         uint64_t __user *prop_values_ptr;
4234
4235         if (!drm_core_check_feature(dev, DRIVER_MODESET))
4236                 return -EINVAL;
4237
4238         drm_modeset_lock_all(dev);
4239
4240         obj = drm_mode_object_find(dev, arg->obj_id, arg->obj_type);
4241         if (!obj) {
4242                 ret = -ENOENT;
4243                 goto out;
4244         }
4245         if (!obj->properties) {
4246                 ret = -EINVAL;
4247                 goto out;
4248         }
4249
4250         props_count = obj->properties->count;
4251
4252         /* This ioctl is called twice, once to determine how much space is
4253          * needed, and the 2nd time to fill it. */
4254         if ((arg->count_props >= props_count) && props_count) {
4255                 copied = 0;
4256                 props_ptr = (uint32_t __user *)(unsigned long)(arg->props_ptr);
4257                 prop_values_ptr = (uint64_t __user *)(unsigned long)
4258                                   (arg->prop_values_ptr);
4259                 for (i = 0; i < props_count; i++) {
4260                         if (put_user(obj->properties->ids[i],
4261                                      props_ptr + copied)) {
4262                                 ret = -EFAULT;
4263                                 goto out;
4264                         }
4265                         if (put_user(obj->properties->values[i],
4266                                      prop_values_ptr + copied)) {
4267                                 ret = -EFAULT;
4268                                 goto out;
4269                         }
4270                         copied++;
4271                 }
4272         }
4273         arg->count_props = props_count;
4274 out:
4275         drm_modeset_unlock_all(dev);
4276         return ret;
4277 }
4278
4279 /**
4280  * drm_mode_obj_set_property_ioctl - set the current value of an object's property
4281  * @dev: DRM device
4282  * @data: ioctl data
4283  * @file_priv: DRM file info
4284  *
4285  * This function sets the current value for an object's property. It also calls
4286  * into a driver's ->set_property callback to update the hardware state.
4287  * Compared to the connector specific ioctl this one is extended to also work on
4288  * crtc and plane objects.
4289  *
4290  * Called by the user via ioctl.
4291  *
4292  * Returns:
4293  * Zero on success, errno on failure.
4294  */
4295 int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
4296                                     struct drm_file *file_priv)
4297 {
4298         struct drm_mode_obj_set_property *arg = data;
4299         struct drm_mode_object *arg_obj;
4300         struct drm_mode_object *prop_obj;
4301         struct drm_property *property;
4302         int ret = -EINVAL;
4303         int i;
4304
4305         if (!drm_core_check_feature(dev, DRIVER_MODESET))
4306                 return -EINVAL;
4307
4308         drm_modeset_lock_all(dev);
4309
4310         arg_obj = drm_mode_object_find(dev, arg->obj_id, arg->obj_type);
4311         if (!arg_obj) {
4312                 ret = -ENOENT;
4313                 goto out;
4314         }
4315         if (!arg_obj->properties)
4316                 goto out;
4317
4318         for (i = 0; i < arg_obj->properties->count; i++)
4319                 if (arg_obj->properties->ids[i] == arg->prop_id)
4320                         break;
4321
4322         if (i == arg_obj->properties->count)
4323                 goto out;
4324
4325         prop_obj = drm_mode_object_find(dev, arg->prop_id,
4326                                         DRM_MODE_OBJECT_PROPERTY);
4327         if (!prop_obj) {
4328                 ret = -ENOENT;
4329                 goto out;
4330         }
4331         property = obj_to_property(prop_obj);
4332
4333         if (!drm_property_change_is_valid(property, arg->value))
4334                 goto out;
4335
4336         switch (arg_obj->type) {
4337         case DRM_MODE_OBJECT_CONNECTOR:
4338                 ret = drm_mode_connector_set_obj_prop(arg_obj, property,
4339                                                       arg->value);
4340                 break;
4341         case DRM_MODE_OBJECT_CRTC:
4342                 ret = drm_mode_crtc_set_obj_prop(arg_obj, property, arg->value);
4343                 break;
4344         case DRM_MODE_OBJECT_PLANE:
4345                 ret = drm_mode_plane_set_obj_prop(obj_to_plane(arg_obj),
4346                                                   property, arg->value);
4347                 break;
4348         }
4349
4350 out:
4351         drm_modeset_unlock_all(dev);
4352         return ret;
4353 }
4354
4355 /**
4356  * drm_mode_connector_attach_encoder - attach a connector to an encoder
4357  * @connector: connector to attach
4358  * @encoder: encoder to attach @connector to
4359  *
4360  * This function links up a connector to an encoder. Note that the routing
4361  * restrictions between encoders and crtcs are exposed to userspace through the
4362  * possible_clones and possible_crtcs bitmasks.
4363  *
4364  * Returns:
4365  * Zero on success, errno on failure.
4366  */
4367 int drm_mode_connector_attach_encoder(struct drm_connector *connector,
4368                                       struct drm_encoder *encoder)
4369 {
4370         int i;
4371
4372         for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
4373                 if (connector->encoder_ids[i] == 0) {
4374                         connector->encoder_ids[i] = encoder->base.id;
4375                         return 0;
4376                 }
4377         }
4378         return -ENOMEM;
4379 }
4380 EXPORT_SYMBOL(drm_mode_connector_attach_encoder);
4381
4382 /**
4383  * drm_mode_crtc_set_gamma_size - set the gamma table size
4384  * @crtc: CRTC to set the gamma table size for
4385  * @gamma_size: size of the gamma table
4386  *
4387  * Drivers which support gamma tables should set this to the supported gamma
4388  * table size when initializing the CRTC. Currently the drm core only supports a
4389  * fixed gamma table size.
4390  *
4391  * Returns:
4392  * Zero on success, errno on failure.
4393  */
4394 int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
4395                                  int gamma_size)
4396 {
4397         crtc->gamma_size = gamma_size;
4398
4399         crtc->gamma_store = kzalloc(gamma_size * sizeof(uint16_t) * 3, GFP_KERNEL);
4400         if (!crtc->gamma_store) {
4401                 crtc->gamma_size = 0;
4402                 return -ENOMEM;
4403         }
4404
4405         return 0;
4406 }
4407 EXPORT_SYMBOL(drm_mode_crtc_set_gamma_size);
4408
4409 /**
4410  * drm_mode_gamma_set_ioctl - set the gamma table
4411  * @dev: DRM device
4412  * @data: ioctl data
4413  * @file_priv: DRM file info
4414  *
4415  * Set the gamma table of a CRTC to the one passed in by the user. Userspace can
4416  * inquire the required gamma table size through drm_mode_gamma_get_ioctl.
4417  *
4418  * Called by the user via ioctl.
4419  *
4420  * Returns:
4421  * Zero on success, errno on failure.
4422  */
4423 int drm_mode_gamma_set_ioctl(struct drm_device *dev,
4424                              void *data, struct drm_file *file_priv)
4425 {
4426         struct drm_mode_crtc_lut *crtc_lut = data;
4427         struct drm_crtc *crtc;
4428         void *r_base, *g_base, *b_base;
4429         int size;
4430         int ret = 0;
4431
4432         if (!drm_core_check_feature(dev, DRIVER_MODESET))
4433                 return -EINVAL;
4434
4435         drm_modeset_lock_all(dev);
4436         crtc = drm_crtc_find(dev, crtc_lut->crtc_id);
4437         if (!crtc) {
4438                 ret = -ENOENT;
4439                 goto out;
4440         }
4441
4442         if (crtc->funcs->gamma_set == NULL) {
4443                 ret = -ENOSYS;
4444                 goto out;
4445         }
4446
4447         /* memcpy into gamma store */
4448         if (crtc_lut->gamma_size != crtc->gamma_size) {
4449                 ret = -EINVAL;
4450                 goto out;
4451         }
4452
4453         size = crtc_lut->gamma_size * (sizeof(uint16_t));
4454         r_base = crtc->gamma_store;
4455         if (copy_from_user(r_base, (void __user *)(unsigned long)crtc_lut->red, size)) {
4456                 ret = -EFAULT;
4457                 goto out;
4458         }
4459
4460         g_base = r_base + size;
4461         if (copy_from_user(g_base, (void __user *)(unsigned long)crtc_lut->green, size)) {
4462                 ret = -EFAULT;
4463                 goto out;
4464         }
4465
4466         b_base = g_base + size;
4467         if (copy_from_user(b_base, (void __user *)(unsigned long)crtc_lut->blue, size)) {
4468                 ret = -EFAULT;
4469                 goto out;
4470         }
4471
4472         crtc->funcs->gamma_set(crtc, r_base, g_base, b_base, 0, crtc->gamma_size);
4473
4474 out:
4475         drm_modeset_unlock_all(dev);
4476         return ret;
4477
4478 }
4479
4480 /**
4481  * drm_mode_gamma_get_ioctl - get the gamma table
4482  * @dev: DRM device
4483  * @data: ioctl data
4484  * @file_priv: DRM file info
4485  *
4486  * Copy the current gamma table into the storage provided. This also provides
4487  * the gamma table size the driver expects, which can be used to size the
4488  * allocated storage.
4489  *
4490  * Called by the user via ioctl.
4491  *
4492  * Returns:
4493  * Zero on success, errno on failure.
4494  */
4495 int drm_mode_gamma_get_ioctl(struct drm_device *dev,
4496                              void *data, struct drm_file *file_priv)
4497 {
4498         struct drm_mode_crtc_lut *crtc_lut = data;
4499         struct drm_crtc *crtc;
4500         void *r_base, *g_base, *b_base;
4501         int size;
4502         int ret = 0;
4503
4504         if (!drm_core_check_feature(dev, DRIVER_MODESET))
4505                 return -EINVAL;
4506
4507         drm_modeset_lock_all(dev);
4508         crtc = drm_crtc_find(dev, crtc_lut->crtc_id);
4509         if (!crtc) {
4510                 ret = -ENOENT;
4511                 goto out;
4512         }
4513
4514         /* memcpy into gamma store */
4515         if (crtc_lut->gamma_size != crtc->gamma_size) {
4516                 ret = -EINVAL;
4517                 goto out;
4518         }
4519
4520         size = crtc_lut->gamma_size * (sizeof(uint16_t));
4521         r_base = crtc->gamma_store;
4522         if (copy_to_user((void __user *)(unsigned long)crtc_lut->red, r_base, size)) {
4523                 ret = -EFAULT;
4524                 goto out;
4525         }
4526
4527         g_base = r_base + size;
4528         if (copy_to_user((void __user *)(unsigned long)crtc_lut->green, g_base, size)) {
4529                 ret = -EFAULT;
4530                 goto out;
4531         }
4532
4533         b_base = g_base + size;
4534         if (copy_to_user((void __user *)(unsigned long)crtc_lut->blue, b_base, size)) {
4535                 ret = -EFAULT;
4536                 goto out;
4537         }
4538 out:
4539         drm_modeset_unlock_all(dev);
4540         return ret;
4541 }
4542
4543 /**
4544  * drm_mode_page_flip_ioctl - schedule an asynchronous fb update
4545  * @dev: DRM device
4546  * @data: ioctl data
4547  * @file_priv: DRM file info
4548  *
4549  * This schedules an asynchronous update on a given CRTC, called page flip.
4550  * Optionally a drm event is generated to signal the completion of the event.
4551  * Generic drivers cannot assume that a pageflip with changed framebuffer
4552  * properties (including driver specific metadata like tiling layout) will work,
4553  * but some drivers support e.g. pixel format changes through the pageflip
4554  * ioctl.
4555  *
4556  * Called by the user via ioctl.
4557  *
4558  * Returns:
4559  * Zero on success, errno on failure.
4560  */
4561 int drm_mode_page_flip_ioctl(struct drm_device *dev,
4562                              void *data, struct drm_file *file_priv)
4563 {
4564         struct drm_mode_crtc_page_flip *page_flip = data;
4565         struct drm_crtc *crtc;
4566         struct drm_framebuffer *fb = NULL;
4567         struct drm_pending_vblank_event *e = NULL;
4568         unsigned long flags;
4569         int ret = -EINVAL;
4570
4571         if (page_flip->flags & ~DRM_MODE_PAGE_FLIP_FLAGS ||
4572             page_flip->reserved != 0)
4573                 return -EINVAL;
4574
4575         if ((page_flip->flags & DRM_MODE_PAGE_FLIP_ASYNC) && !dev->mode_config.async_page_flip)
4576                 return -EINVAL;
4577
4578         crtc = drm_crtc_find(dev, page_flip->crtc_id);
4579         if (!crtc)
4580                 return -ENOENT;
4581
4582         drm_modeset_lock_crtc(crtc);
4583         if (crtc->primary->fb == NULL) {
4584                 /* The framebuffer is currently unbound, presumably
4585                  * due to a hotplug event, that userspace has not
4586                  * yet discovered.
4587                  */
4588                 ret = -EBUSY;
4589                 goto out;
4590         }
4591
4592         if (crtc->funcs->page_flip == NULL)
4593                 goto out;
4594
4595         fb = drm_framebuffer_lookup(dev, page_flip->fb_id);
4596         if (!fb) {
4597                 ret = -ENOENT;
4598                 goto out;
4599         }
4600
4601         ret = drm_crtc_check_viewport(crtc, crtc->x, crtc->y, &crtc->mode, fb);
4602         if (ret)
4603                 goto out;
4604
4605         if (crtc->primary->fb->pixel_format != fb->pixel_format) {
4606                 DRM_DEBUG_KMS("Page flip is not allowed to change frame buffer format.\n");
4607                 ret = -EINVAL;
4608                 goto out;
4609         }
4610
4611         if (page_flip->flags & DRM_MODE_PAGE_FLIP_EVENT) {
4612                 ret = -ENOMEM;
4613                 spin_lock_irqsave(&dev->event_lock, flags);
4614                 if (file_priv->event_space < sizeof e->event) {
4615                         spin_unlock_irqrestore(&dev->event_lock, flags);
4616                         goto out;
4617                 }
4618                 file_priv->event_space -= sizeof e->event;
4619                 spin_unlock_irqrestore(&dev->event_lock, flags);
4620
4621                 e = kzalloc(sizeof *e, GFP_KERNEL);
4622                 if (e == NULL) {
4623                         spin_lock_irqsave(&dev->event_lock, flags);
4624                         file_priv->event_space += sizeof e->event;
4625                         spin_unlock_irqrestore(&dev->event_lock, flags);
4626                         goto out;
4627                 }
4628
4629                 e->event.base.type = DRM_EVENT_FLIP_COMPLETE;
4630                 e->event.base.length = sizeof e->event;
4631                 e->event.user_data = page_flip->user_data;
4632                 e->base.event = &e->event.base;
4633                 e->base.file_priv = file_priv;
4634                 e->base.destroy =
4635                         (void (*) (struct drm_pending_event *)) kfree;
4636         }
4637
4638         crtc->primary->old_fb = crtc->primary->fb;
4639         ret = crtc->funcs->page_flip(crtc, fb, e, page_flip->flags);
4640         if (ret) {
4641                 if (page_flip->flags & DRM_MODE_PAGE_FLIP_EVENT) {
4642                         spin_lock_irqsave(&dev->event_lock, flags);
4643                         file_priv->event_space += sizeof e->event;
4644                         spin_unlock_irqrestore(&dev->event_lock, flags);
4645                         kfree(e);
4646                 }
4647                 /* Keep the old fb, don't unref it. */
4648                 crtc->primary->old_fb = NULL;
4649         } else {
4650                 /*
4651                  * Warn if the driver hasn't properly updated the crtc->fb
4652                  * field to reflect that the new framebuffer is now used.
4653                  * Failing to do so will screw with the reference counting
4654                  * on framebuffers.
4655                  */
4656                 WARN_ON(crtc->primary->fb != fb);
4657                 /* Unref only the old framebuffer. */
4658                 fb = NULL;
4659         }
4660
4661 out:
4662         if (fb)
4663                 drm_framebuffer_unreference(fb);
4664         if (crtc->primary->old_fb)
4665                 drm_framebuffer_unreference(crtc->primary->old_fb);
4666         crtc->primary->old_fb = NULL;
4667         drm_modeset_unlock_crtc(crtc);
4668
4669         return ret;
4670 }
4671
4672 /**
4673  * drm_mode_config_reset - call ->reset callbacks
4674  * @dev: drm device
4675  *
4676  * This functions calls all the crtc's, encoder's and connector's ->reset
4677  * callback. Drivers can use this in e.g. their driver load or resume code to
4678  * reset hardware and software state.
4679  */
4680 void drm_mode_config_reset(struct drm_device *dev)
4681 {
4682         struct drm_crtc *crtc;
4683         struct drm_plane *plane;
4684         struct drm_encoder *encoder;
4685         struct drm_connector *connector;
4686
4687         list_for_each_entry(plane, &dev->mode_config.plane_list, head)
4688                 if (plane->funcs->reset)
4689                         plane->funcs->reset(plane);
4690
4691         list_for_each_entry(crtc, &dev->mode_config.crtc_list, head)
4692                 if (crtc->funcs->reset)
4693                         crtc->funcs->reset(crtc);
4694
4695         list_for_each_entry(encoder, &dev->mode_config.encoder_list, head)
4696                 if (encoder->funcs->reset)
4697                         encoder->funcs->reset(encoder);
4698
4699         list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
4700                 connector->status = connector_status_unknown;
4701
4702                 if (connector->funcs->reset)
4703                         connector->funcs->reset(connector);
4704         }
4705 }
4706 EXPORT_SYMBOL(drm_mode_config_reset);
4707
4708 /**
4709  * drm_mode_create_dumb_ioctl - create a dumb backing storage buffer
4710  * @dev: DRM device
4711  * @data: ioctl data
4712  * @file_priv: DRM file info
4713  *
4714  * This creates a new dumb buffer in the driver's backing storage manager (GEM,
4715  * TTM or something else entirely) and returns the resulting buffer handle. This
4716  * handle can then be wrapped up into a framebuffer modeset object.
4717  *
4718  * Note that userspace is not allowed to use such objects for render
4719  * acceleration - drivers must create their own private ioctls for such a use
4720  * case.
4721  *
4722  * Called by the user via ioctl.
4723  *
4724  * Returns:
4725  * Zero on success, errno on failure.
4726  */
4727 int drm_mode_create_dumb_ioctl(struct drm_device *dev,
4728                                void *data, struct drm_file *file_priv)
4729 {
4730         struct drm_mode_create_dumb *args = data;
4731         u32 cpp, stride, size;
4732
4733         if (!dev->driver->dumb_create)
4734                 return -ENOSYS;
4735         if (!args->width || !args->height || !args->bpp)
4736                 return -EINVAL;
4737
4738         /* overflow checks for 32bit size calculations */
4739         cpp = DIV_ROUND_UP(args->bpp, 8);
4740         if (cpp > 0xffffffffU / args->width)
4741                 return -EINVAL;
4742         stride = cpp * args->width;
4743         if (args->height > 0xffffffffU / stride)
4744                 return -EINVAL;
4745
4746         /* test for wrap-around */
4747         size = args->height * stride;
4748         if (PAGE_ALIGN(size) == 0)
4749                 return -EINVAL;
4750
4751         return dev->driver->dumb_create(file_priv, dev, args);
4752 }
4753
4754 /**
4755  * drm_mode_mmap_dumb_ioctl - create an mmap offset for a dumb backing storage buffer
4756  * @dev: DRM device
4757  * @data: ioctl data
4758  * @file_priv: DRM file info
4759  *
4760  * Allocate an offset in the drm device node's address space to be able to
4761  * memory map a dumb buffer.
4762  *
4763  * Called by the user via ioctl.
4764  *
4765  * Returns:
4766  * Zero on success, errno on failure.
4767  */
4768 int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
4769                              void *data, struct drm_file *file_priv)
4770 {
4771         struct drm_mode_map_dumb *args = data;
4772
4773         /* call driver ioctl to get mmap offset */
4774         if (!dev->driver->dumb_map_offset)
4775                 return -ENOSYS;
4776
4777         return dev->driver->dumb_map_offset(file_priv, dev, args->handle, &args->offset);
4778 }
4779
4780 /**
4781  * drm_mode_destroy_dumb_ioctl - destroy a dumb backing strage buffer
4782  * @dev: DRM device
4783  * @data: ioctl data
4784  * @file_priv: DRM file info
4785  *
4786  * This destroys the userspace handle for the given dumb backing storage buffer.
4787  * Since buffer objects must be reference counted in the kernel a buffer object
4788  * won't be immediately freed if a framebuffer modeset object still uses it.
4789  *
4790  * Called by the user via ioctl.
4791  *
4792  * Returns:
4793  * Zero on success, errno on failure.
4794  */
4795 int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
4796                                 void *data, struct drm_file *file_priv)
4797 {
4798         struct drm_mode_destroy_dumb *args = data;
4799
4800         if (!dev->driver->dumb_destroy)
4801                 return -ENOSYS;
4802
4803         return dev->driver->dumb_destroy(file_priv, dev, args->handle);
4804 }
4805
4806 /**
4807  * drm_fb_get_bpp_depth - get the bpp/depth values for format
4808  * @format: pixel format (DRM_FORMAT_*)
4809  * @depth: storage for the depth value
4810  * @bpp: storage for the bpp value
4811  *
4812  * This only supports RGB formats here for compat with code that doesn't use
4813  * pixel formats directly yet.
4814  */
4815 void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
4816                           int *bpp)
4817 {
4818         switch (format) {
4819         case DRM_FORMAT_C8:
4820         case DRM_FORMAT_RGB332:
4821         case DRM_FORMAT_BGR233:
4822                 *depth = 8;
4823                 *bpp = 8;
4824                 break;
4825         case DRM_FORMAT_XRGB1555:
4826         case DRM_FORMAT_XBGR1555:
4827         case DRM_FORMAT_RGBX5551:
4828         case DRM_FORMAT_BGRX5551:
4829         case DRM_FORMAT_ARGB1555:
4830         case DRM_FORMAT_ABGR1555:
4831         case DRM_FORMAT_RGBA5551:
4832         case DRM_FORMAT_BGRA5551:
4833                 *depth = 15;
4834                 *bpp = 16;
4835                 break;
4836         case DRM_FORMAT_RGB565:
4837         case DRM_FORMAT_BGR565:
4838                 *depth = 16;
4839                 *bpp = 16;
4840                 break;
4841         case DRM_FORMAT_RGB888:
4842         case DRM_FORMAT_BGR888:
4843                 *depth = 24;
4844                 *bpp = 24;
4845                 break;
4846         case DRM_FORMAT_XRGB8888:
4847         case DRM_FORMAT_XBGR8888:
4848         case DRM_FORMAT_RGBX8888:
4849         case DRM_FORMAT_BGRX8888:
4850                 *depth = 24;
4851                 *bpp = 32;
4852                 break;
4853         case DRM_FORMAT_XRGB2101010:
4854         case DRM_FORMAT_XBGR2101010:
4855         case DRM_FORMAT_RGBX1010102:
4856         case DRM_FORMAT_BGRX1010102:
4857         case DRM_FORMAT_ARGB2101010:
4858         case DRM_FORMAT_ABGR2101010:
4859         case DRM_FORMAT_RGBA1010102:
4860         case DRM_FORMAT_BGRA1010102:
4861                 *depth = 30;
4862                 *bpp = 32;
4863                 break;
4864         case DRM_FORMAT_ARGB8888:
4865         case DRM_FORMAT_ABGR8888:
4866         case DRM_FORMAT_RGBA8888:
4867         case DRM_FORMAT_BGRA8888:
4868                 *depth = 32;
4869                 *bpp = 32;
4870                 break;
4871         default:
4872                 DRM_DEBUG_KMS("unsupported pixel format %s\n",
4873                               drm_get_format_name(format));
4874                 *depth = 0;
4875                 *bpp = 0;
4876                 break;
4877         }
4878 }
4879 EXPORT_SYMBOL(drm_fb_get_bpp_depth);
4880
4881 /**
4882  * drm_format_num_planes - get the number of planes for format
4883  * @format: pixel format (DRM_FORMAT_*)
4884  *
4885  * Returns:
4886  * The number of planes used by the specified pixel format.
4887  */
4888 int drm_format_num_planes(uint32_t format)
4889 {
4890         switch (format) {
4891         case DRM_FORMAT_YUV410:
4892         case DRM_FORMAT_YVU410:
4893         case DRM_FORMAT_YUV411:
4894         case DRM_FORMAT_YVU411:
4895         case DRM_FORMAT_YUV420:
4896         case DRM_FORMAT_YVU420:
4897         case DRM_FORMAT_YUV422:
4898         case DRM_FORMAT_YVU422:
4899         case DRM_FORMAT_YUV444:
4900         case DRM_FORMAT_YVU444:
4901                 return 3;
4902         case DRM_FORMAT_NV12:
4903         case DRM_FORMAT_NV21:
4904         case DRM_FORMAT_NV16:
4905         case DRM_FORMAT_NV61:
4906         case DRM_FORMAT_NV24:
4907         case DRM_FORMAT_NV42:
4908                 return 2;
4909         default:
4910                 return 1;
4911         }
4912 }
4913 EXPORT_SYMBOL(drm_format_num_planes);
4914
4915 /**
4916  * drm_format_plane_cpp - determine the bytes per pixel value
4917  * @format: pixel format (DRM_FORMAT_*)
4918  * @plane: plane index
4919  *
4920  * Returns:
4921  * The bytes per pixel value for the specified plane.
4922  */
4923 int drm_format_plane_cpp(uint32_t format, int plane)
4924 {
4925         unsigned int depth;
4926         int bpp;
4927
4928         if (plane >= drm_format_num_planes(format))
4929                 return 0;
4930
4931         switch (format) {
4932         case DRM_FORMAT_YUYV:
4933         case DRM_FORMAT_YVYU:
4934         case DRM_FORMAT_UYVY:
4935         case DRM_FORMAT_VYUY:
4936                 return 2;
4937         case DRM_FORMAT_NV12:
4938         case DRM_FORMAT_NV21:
4939         case DRM_FORMAT_NV16:
4940         case DRM_FORMAT_NV61:
4941         case DRM_FORMAT_NV24:
4942         case DRM_FORMAT_NV42:
4943                 return plane ? 2 : 1;
4944         case DRM_FORMAT_YUV410:
4945         case DRM_FORMAT_YVU410:
4946         case DRM_FORMAT_YUV411:
4947         case DRM_FORMAT_YVU411:
4948         case DRM_FORMAT_YUV420:
4949         case DRM_FORMAT_YVU420:
4950         case DRM_FORMAT_YUV422:
4951         case DRM_FORMAT_YVU422:
4952         case DRM_FORMAT_YUV444:
4953         case DRM_FORMAT_YVU444:
4954                 return 1;
4955         default:
4956                 drm_fb_get_bpp_depth(format, &depth, &bpp);
4957                 return bpp >> 3;
4958         }
4959 }
4960 EXPORT_SYMBOL(drm_format_plane_cpp);
4961
4962 /**
4963  * drm_format_horz_chroma_subsampling - get the horizontal chroma subsampling factor
4964  * @format: pixel format (DRM_FORMAT_*)
4965  *
4966  * Returns:
4967  * The horizontal chroma subsampling factor for the
4968  * specified pixel format.
4969  */
4970 int drm_format_horz_chroma_subsampling(uint32_t format)
4971 {
4972         switch (format) {
4973         case DRM_FORMAT_YUV411:
4974         case DRM_FORMAT_YVU411:
4975         case DRM_FORMAT_YUV410:
4976         case DRM_FORMAT_YVU410:
4977                 return 4;
4978         case DRM_FORMAT_YUYV:
4979         case DRM_FORMAT_YVYU:
4980         case DRM_FORMAT_UYVY:
4981         case DRM_FORMAT_VYUY:
4982         case DRM_FORMAT_NV12:
4983         case DRM_FORMAT_NV21:
4984         case DRM_FORMAT_NV16:
4985         case DRM_FORMAT_NV61:
4986         case DRM_FORMAT_YUV422:
4987         case DRM_FORMAT_YVU422:
4988         case DRM_FORMAT_YUV420:
4989         case DRM_FORMAT_YVU420:
4990                 return 2;
4991         default:
4992                 return 1;
4993         }
4994 }
4995 EXPORT_SYMBOL(drm_format_horz_chroma_subsampling);
4996
4997 /**
4998  * drm_format_vert_chroma_subsampling - get the vertical chroma subsampling factor
4999  * @format: pixel format (DRM_FORMAT_*)
5000  *
5001  * Returns:
5002  * The vertical chroma subsampling factor for the
5003  * specified pixel format.
5004  */
5005 int drm_format_vert_chroma_subsampling(uint32_t format)
5006 {
5007         switch (format) {
5008         case DRM_FORMAT_YUV410:
5009         case DRM_FORMAT_YVU410:
5010                 return 4;
5011         case DRM_FORMAT_YUV420:
5012         case DRM_FORMAT_YVU420:
5013         case DRM_FORMAT_NV12:
5014         case DRM_FORMAT_NV21:
5015                 return 2;
5016         default:
5017                 return 1;
5018         }
5019 }
5020 EXPORT_SYMBOL(drm_format_vert_chroma_subsampling);
5021
5022 /**
5023  * drm_rotation_simplify() - Try to simplify the rotation
5024  * @rotation: Rotation to be simplified
5025  * @supported_rotations: Supported rotations
5026  *
5027  * Attempt to simplify the rotation to a form that is supported.
5028  * Eg. if the hardware supports everything except DRM_REFLECT_X
5029  * one could call this function like this:
5030  *
5031  * drm_rotation_simplify(rotation, BIT(DRM_ROTATE_0) |
5032  *                       BIT(DRM_ROTATE_90) | BIT(DRM_ROTATE_180) |
5033  *                       BIT(DRM_ROTATE_270) | BIT(DRM_REFLECT_Y));
5034  *
5035  * to eliminate the DRM_ROTATE_X flag. Depending on what kind of
5036  * transforms the hardware supports, this function may not
5037  * be able to produce a supported transform, so the caller should
5038  * check the result afterwards.
5039  */
5040 unsigned int drm_rotation_simplify(unsigned int rotation,
5041                                    unsigned int supported_rotations)
5042 {
5043         if (rotation & ~supported_rotations) {
5044                 rotation ^= BIT(DRM_REFLECT_X) | BIT(DRM_REFLECT_Y);
5045                 rotation = (rotation & ~0xf) | BIT((ffs(rotation & 0xf) + 1) % 4);
5046         }
5047
5048         return rotation;
5049 }
5050 EXPORT_SYMBOL(drm_rotation_simplify);
5051
5052 /**
5053  * drm_mode_config_init - initialize DRM mode_configuration structure
5054  * @dev: DRM device
5055  *
5056  * Initialize @dev's mode_config structure, used for tracking the graphics
5057  * configuration of @dev.
5058  *
5059  * Since this initializes the modeset locks, no locking is possible. Which is no
5060  * problem, since this should happen single threaded at init time. It is the
5061  * driver's problem to ensure this guarantee.
5062  *
5063  */
5064 void drm_mode_config_init(struct drm_device *dev)
5065 {
5066         mutex_init(&dev->mode_config.mutex);
5067         drm_modeset_lock_init(&dev->mode_config.connection_mutex);
5068         mutex_init(&dev->mode_config.idr_mutex);
5069         mutex_init(&dev->mode_config.fb_lock);
5070         INIT_LIST_HEAD(&dev->mode_config.fb_list);
5071         INIT_LIST_HEAD(&dev->mode_config.crtc_list);
5072         INIT_LIST_HEAD(&dev->mode_config.connector_list);
5073         INIT_LIST_HEAD(&dev->mode_config.bridge_list);
5074         INIT_LIST_HEAD(&dev->mode_config.encoder_list);
5075         INIT_LIST_HEAD(&dev->mode_config.property_list);
5076         INIT_LIST_HEAD(&dev->mode_config.property_blob_list);
5077         INIT_LIST_HEAD(&dev->mode_config.plane_list);
5078         idr_init(&dev->mode_config.crtc_idr);
5079
5080         drm_modeset_lock_all(dev);
5081         drm_mode_create_standard_connector_properties(dev);
5082         drm_mode_create_standard_plane_properties(dev);
5083         drm_modeset_unlock_all(dev);
5084
5085         /* Just to be sure */
5086         dev->mode_config.num_fb = 0;
5087         dev->mode_config.num_connector = 0;
5088         dev->mode_config.num_crtc = 0;
5089         dev->mode_config.num_encoder = 0;
5090         dev->mode_config.num_overlay_plane = 0;
5091         dev->mode_config.num_total_plane = 0;
5092 }
5093 EXPORT_SYMBOL(drm_mode_config_init);
5094
5095 /**
5096  * drm_mode_config_cleanup - free up DRM mode_config info
5097  * @dev: DRM device
5098  *
5099  * Free up all the connectors and CRTCs associated with this DRM device, then
5100  * free up the framebuffers and associated buffer objects.
5101  *
5102  * Note that since this /should/ happen single-threaded at driver/device
5103  * teardown time, no locking is required. It's the driver's job to ensure that
5104  * this guarantee actually holds true.
5105  *
5106  * FIXME: cleanup any dangling user buffer objects too
5107  */
5108 void drm_mode_config_cleanup(struct drm_device *dev)
5109 {
5110         struct drm_connector *connector, *ot;
5111         struct drm_crtc *crtc, *ct;
5112         struct drm_encoder *encoder, *enct;
5113         struct drm_bridge *bridge, *brt;
5114         struct drm_framebuffer *fb, *fbt;
5115         struct drm_property *property, *pt;
5116         struct drm_property_blob *blob, *bt;
5117         struct drm_plane *plane, *plt;
5118
5119         list_for_each_entry_safe(encoder, enct, &dev->mode_config.encoder_list,
5120                                  head) {
5121                 encoder->funcs->destroy(encoder);
5122         }
5123
5124         list_for_each_entry_safe(bridge, brt,
5125                                  &dev->mode_config.bridge_list, head) {
5126                 bridge->funcs->destroy(bridge);
5127         }
5128
5129         list_for_each_entry_safe(connector, ot,
5130                                  &dev->mode_config.connector_list, head) {
5131                 connector->funcs->destroy(connector);
5132         }
5133
5134         list_for_each_entry_safe(property, pt, &dev->mode_config.property_list,
5135                                  head) {
5136                 drm_property_destroy(dev, property);
5137         }
5138
5139         list_for_each_entry_safe(blob, bt, &dev->mode_config.property_blob_list,
5140                                  head) {
5141                 drm_property_destroy_blob(dev, blob);
5142         }
5143
5144         /*
5145          * Single-threaded teardown context, so it's not required to grab the
5146          * fb_lock to protect against concurrent fb_list access. Contrary, it
5147          * would actually deadlock with the drm_framebuffer_cleanup function.
5148          *
5149          * Also, if there are any framebuffers left, that's a driver leak now,
5150          * so politely WARN about this.
5151          */
5152         WARN_ON(!list_empty(&dev->mode_config.fb_list));
5153         list_for_each_entry_safe(fb, fbt, &dev->mode_config.fb_list, head) {
5154                 drm_framebuffer_remove(fb);
5155         }
5156
5157         list_for_each_entry_safe(plane, plt, &dev->mode_config.plane_list,
5158                                  head) {
5159                 plane->funcs->destroy(plane);
5160         }
5161
5162         list_for_each_entry_safe(crtc, ct, &dev->mode_config.crtc_list, head) {
5163                 crtc->funcs->destroy(crtc);
5164         }
5165
5166         idr_destroy(&dev->mode_config.crtc_idr);
5167         drm_modeset_lock_fini(&dev->mode_config.connection_mutex);
5168 }
5169 EXPORT_SYMBOL(drm_mode_config_cleanup);
5170
5171 struct drm_property *drm_mode_create_rotation_property(struct drm_device *dev,
5172                                                        unsigned int supported_rotations)
5173 {
5174         static const struct drm_prop_enum_list props[] = {
5175                 { DRM_ROTATE_0,   "rotate-0" },
5176                 { DRM_ROTATE_90,  "rotate-90" },
5177                 { DRM_ROTATE_180, "rotate-180" },
5178                 { DRM_ROTATE_270, "rotate-270" },
5179                 { DRM_REFLECT_X,  "reflect-x" },
5180                 { DRM_REFLECT_Y,  "reflect-y" },
5181         };
5182
5183         return drm_property_create_bitmask(dev, 0, "rotation",
5184                                            props, ARRAY_SIZE(props),
5185                                            supported_rotations);
5186 }
5187 EXPORT_SYMBOL(drm_mode_create_rotation_property);