drm: Make drm_mode_attachmode() void
[deliverable/linux.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/list.h>
33 #include <linux/slab.h>
34 #include <linux/export.h>
35 #include "drm.h"
36 #include "drmP.h"
37 #include "drm_crtc.h"
38 #include "drm_edid.h"
39 #include "drm_fourcc.h"
40
41 /* Avoid boilerplate. I'm tired of typing. */
42 #define DRM_ENUM_NAME_FN(fnname, list) \
43 char *fnname(int val) \
44 { \
45 int i; \
46 for (i = 0; i < ARRAY_SIZE(list); i++) { \
47 if (list[i].type == val) \
48 return list[i].name; \
49 } \
50 return "(unknown)"; \
51 }
52
53 /*
54 * Global properties
55 */
56 static struct drm_prop_enum_list drm_dpms_enum_list[] =
57 { { DRM_MODE_DPMS_ON, "On" },
58 { DRM_MODE_DPMS_STANDBY, "Standby" },
59 { DRM_MODE_DPMS_SUSPEND, "Suspend" },
60 { DRM_MODE_DPMS_OFF, "Off" }
61 };
62
63 DRM_ENUM_NAME_FN(drm_get_dpms_name, drm_dpms_enum_list)
64
65 /*
66 * Optional properties
67 */
68 static struct drm_prop_enum_list drm_scaling_mode_enum_list[] =
69 {
70 { DRM_MODE_SCALE_NONE, "None" },
71 { DRM_MODE_SCALE_FULLSCREEN, "Full" },
72 { DRM_MODE_SCALE_CENTER, "Center" },
73 { DRM_MODE_SCALE_ASPECT, "Full aspect" },
74 };
75
76 static struct drm_prop_enum_list drm_dithering_mode_enum_list[] =
77 {
78 { DRM_MODE_DITHERING_OFF, "Off" },
79 { DRM_MODE_DITHERING_ON, "On" },
80 { DRM_MODE_DITHERING_AUTO, "Automatic" },
81 };
82
83 /*
84 * Non-global properties, but "required" for certain connectors.
85 */
86 static struct drm_prop_enum_list drm_dvi_i_select_enum_list[] =
87 {
88 { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */
89 { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */
90 { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */
91 };
92
93 DRM_ENUM_NAME_FN(drm_get_dvi_i_select_name, drm_dvi_i_select_enum_list)
94
95 static struct drm_prop_enum_list drm_dvi_i_subconnector_enum_list[] =
96 {
97 { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I and TV-out */
98 { DRM_MODE_SUBCONNECTOR_DVID, "DVI-D" }, /* DVI-I */
99 { DRM_MODE_SUBCONNECTOR_DVIA, "DVI-A" }, /* DVI-I */
100 };
101
102 DRM_ENUM_NAME_FN(drm_get_dvi_i_subconnector_name,
103 drm_dvi_i_subconnector_enum_list)
104
105 static struct drm_prop_enum_list drm_tv_select_enum_list[] =
106 {
107 { DRM_MODE_SUBCONNECTOR_Automatic, "Automatic" }, /* DVI-I and TV-out */
108 { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */
109 { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */
110 { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */
111 { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */
112 };
113
114 DRM_ENUM_NAME_FN(drm_get_tv_select_name, drm_tv_select_enum_list)
115
116 static struct drm_prop_enum_list drm_tv_subconnector_enum_list[] =
117 {
118 { DRM_MODE_SUBCONNECTOR_Unknown, "Unknown" }, /* DVI-I and TV-out */
119 { DRM_MODE_SUBCONNECTOR_Composite, "Composite" }, /* TV-out */
120 { DRM_MODE_SUBCONNECTOR_SVIDEO, "SVIDEO" }, /* TV-out */
121 { DRM_MODE_SUBCONNECTOR_Component, "Component" }, /* TV-out */
122 { DRM_MODE_SUBCONNECTOR_SCART, "SCART" }, /* TV-out */
123 };
124
125 DRM_ENUM_NAME_FN(drm_get_tv_subconnector_name,
126 drm_tv_subconnector_enum_list)
127
128 static struct drm_prop_enum_list drm_dirty_info_enum_list[] = {
129 { DRM_MODE_DIRTY_OFF, "Off" },
130 { DRM_MODE_DIRTY_ON, "On" },
131 { DRM_MODE_DIRTY_ANNOTATE, "Annotate" },
132 };
133
134 DRM_ENUM_NAME_FN(drm_get_dirty_info_name,
135 drm_dirty_info_enum_list)
136
137 struct drm_conn_prop_enum_list {
138 int type;
139 char *name;
140 int count;
141 };
142
143 /*
144 * Connector and encoder types.
145 */
146 static struct drm_conn_prop_enum_list drm_connector_enum_list[] =
147 { { DRM_MODE_CONNECTOR_Unknown, "Unknown", 0 },
148 { DRM_MODE_CONNECTOR_VGA, "VGA", 0 },
149 { DRM_MODE_CONNECTOR_DVII, "DVI-I", 0 },
150 { DRM_MODE_CONNECTOR_DVID, "DVI-D", 0 },
151 { DRM_MODE_CONNECTOR_DVIA, "DVI-A", 0 },
152 { DRM_MODE_CONNECTOR_Composite, "Composite", 0 },
153 { DRM_MODE_CONNECTOR_SVIDEO, "SVIDEO", 0 },
154 { DRM_MODE_CONNECTOR_LVDS, "LVDS", 0 },
155 { DRM_MODE_CONNECTOR_Component, "Component", 0 },
156 { DRM_MODE_CONNECTOR_9PinDIN, "DIN", 0 },
157 { DRM_MODE_CONNECTOR_DisplayPort, "DP", 0 },
158 { DRM_MODE_CONNECTOR_HDMIA, "HDMI-A", 0 },
159 { DRM_MODE_CONNECTOR_HDMIB, "HDMI-B", 0 },
160 { DRM_MODE_CONNECTOR_TV, "TV", 0 },
161 { DRM_MODE_CONNECTOR_eDP, "eDP", 0 },
162 { DRM_MODE_CONNECTOR_VIRTUAL, "Virtual", 0},
163 };
164
165 static struct drm_prop_enum_list drm_encoder_enum_list[] =
166 { { DRM_MODE_ENCODER_NONE, "None" },
167 { DRM_MODE_ENCODER_DAC, "DAC" },
168 { DRM_MODE_ENCODER_TMDS, "TMDS" },
169 { DRM_MODE_ENCODER_LVDS, "LVDS" },
170 { DRM_MODE_ENCODER_TVDAC, "TV" },
171 { DRM_MODE_ENCODER_VIRTUAL, "Virtual" },
172 };
173
174 char *drm_get_encoder_name(struct drm_encoder *encoder)
175 {
176 static char buf[32];
177
178 snprintf(buf, 32, "%s-%d",
179 drm_encoder_enum_list[encoder->encoder_type].name,
180 encoder->base.id);
181 return buf;
182 }
183 EXPORT_SYMBOL(drm_get_encoder_name);
184
185 char *drm_get_connector_name(struct drm_connector *connector)
186 {
187 static char buf[32];
188
189 snprintf(buf, 32, "%s-%d",
190 drm_connector_enum_list[connector->connector_type].name,
191 connector->connector_type_id);
192 return buf;
193 }
194 EXPORT_SYMBOL(drm_get_connector_name);
195
196 char *drm_get_connector_status_name(enum drm_connector_status status)
197 {
198 if (status == connector_status_connected)
199 return "connected";
200 else if (status == connector_status_disconnected)
201 return "disconnected";
202 else
203 return "unknown";
204 }
205
206 /**
207 * drm_mode_object_get - allocate a new identifier
208 * @dev: DRM device
209 * @ptr: object pointer, used to generate unique ID
210 * @type: object type
211 *
212 * LOCKING:
213 *
214 * Create a unique identifier based on @ptr in @dev's identifier space. Used
215 * for tracking modes, CRTCs and connectors.
216 *
217 * RETURNS:
218 * New unique (relative to other objects in @dev) integer identifier for the
219 * object.
220 */
221 static int drm_mode_object_get(struct drm_device *dev,
222 struct drm_mode_object *obj, uint32_t obj_type)
223 {
224 int new_id = 0;
225 int ret;
226
227 again:
228 if (idr_pre_get(&dev->mode_config.crtc_idr, GFP_KERNEL) == 0) {
229 DRM_ERROR("Ran out memory getting a mode number\n");
230 return -EINVAL;
231 }
232
233 mutex_lock(&dev->mode_config.idr_mutex);
234 ret = idr_get_new_above(&dev->mode_config.crtc_idr, obj, 1, &new_id);
235 mutex_unlock(&dev->mode_config.idr_mutex);
236 if (ret == -EAGAIN)
237 goto again;
238
239 obj->id = new_id;
240 obj->type = obj_type;
241 return 0;
242 }
243
244 /**
245 * drm_mode_object_put - free an identifer
246 * @dev: DRM device
247 * @id: ID to free
248 *
249 * LOCKING:
250 * Caller must hold DRM mode_config lock.
251 *
252 * Free @id from @dev's unique identifier pool.
253 */
254 static void drm_mode_object_put(struct drm_device *dev,
255 struct drm_mode_object *object)
256 {
257 mutex_lock(&dev->mode_config.idr_mutex);
258 idr_remove(&dev->mode_config.crtc_idr, object->id);
259 mutex_unlock(&dev->mode_config.idr_mutex);
260 }
261
262 struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
263 uint32_t id, uint32_t type)
264 {
265 struct drm_mode_object *obj = NULL;
266
267 mutex_lock(&dev->mode_config.idr_mutex);
268 obj = idr_find(&dev->mode_config.crtc_idr, id);
269 if (!obj || (obj->type != type) || (obj->id != id))
270 obj = NULL;
271 mutex_unlock(&dev->mode_config.idr_mutex);
272
273 return obj;
274 }
275 EXPORT_SYMBOL(drm_mode_object_find);
276
277 /**
278 * drm_framebuffer_init - initialize a framebuffer
279 * @dev: DRM device
280 *
281 * LOCKING:
282 * Caller must hold mode config lock.
283 *
284 * Allocates an ID for the framebuffer's parent mode object, sets its mode
285 * functions & device file and adds it to the master fd list.
286 *
287 * RETURNS:
288 * Zero on success, error code on failure.
289 */
290 int drm_framebuffer_init(struct drm_device *dev, struct drm_framebuffer *fb,
291 const struct drm_framebuffer_funcs *funcs)
292 {
293 int ret;
294
295 ret = drm_mode_object_get(dev, &fb->base, DRM_MODE_OBJECT_FB);
296 if (ret) {
297 return ret;
298 }
299
300 fb->dev = dev;
301 fb->funcs = funcs;
302 dev->mode_config.num_fb++;
303 list_add(&fb->head, &dev->mode_config.fb_list);
304
305 return 0;
306 }
307 EXPORT_SYMBOL(drm_framebuffer_init);
308
309 /**
310 * drm_framebuffer_cleanup - remove a framebuffer object
311 * @fb: framebuffer to remove
312 *
313 * LOCKING:
314 * Caller must hold mode config lock.
315 *
316 * Scans all the CRTCs in @dev's mode_config. If they're using @fb, removes
317 * it, setting it to NULL.
318 */
319 void drm_framebuffer_cleanup(struct drm_framebuffer *fb)
320 {
321 struct drm_device *dev = fb->dev;
322 struct drm_crtc *crtc;
323 struct drm_plane *plane;
324 struct drm_mode_set set;
325 int ret;
326
327 /* remove from any CRTC */
328 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head) {
329 if (crtc->fb == fb) {
330 /* should turn off the crtc */
331 memset(&set, 0, sizeof(struct drm_mode_set));
332 set.crtc = crtc;
333 set.fb = NULL;
334 ret = crtc->funcs->set_config(&set);
335 if (ret)
336 DRM_ERROR("failed to reset crtc %p when fb was deleted\n", crtc);
337 }
338 }
339
340 list_for_each_entry(plane, &dev->mode_config.plane_list, head) {
341 if (plane->fb == fb) {
342 /* should turn off the crtc */
343 ret = plane->funcs->disable_plane(plane);
344 if (ret)
345 DRM_ERROR("failed to disable plane with busy fb\n");
346 /* disconnect the plane from the fb and crtc: */
347 plane->fb = NULL;
348 plane->crtc = NULL;
349 }
350 }
351
352 drm_mode_object_put(dev, &fb->base);
353 list_del(&fb->head);
354 dev->mode_config.num_fb--;
355 }
356 EXPORT_SYMBOL(drm_framebuffer_cleanup);
357
358 /**
359 * drm_crtc_init - Initialise a new CRTC object
360 * @dev: DRM device
361 * @crtc: CRTC object to init
362 * @funcs: callbacks for the new CRTC
363 *
364 * LOCKING:
365 * Caller must hold mode config lock.
366 *
367 * Inits a new object created as base part of an driver crtc object.
368 */
369 void drm_crtc_init(struct drm_device *dev, struct drm_crtc *crtc,
370 const struct drm_crtc_funcs *funcs)
371 {
372 crtc->dev = dev;
373 crtc->funcs = funcs;
374
375 mutex_lock(&dev->mode_config.mutex);
376 drm_mode_object_get(dev, &crtc->base, DRM_MODE_OBJECT_CRTC);
377
378 list_add_tail(&crtc->head, &dev->mode_config.crtc_list);
379 dev->mode_config.num_crtc++;
380 mutex_unlock(&dev->mode_config.mutex);
381 }
382 EXPORT_SYMBOL(drm_crtc_init);
383
384 /**
385 * drm_crtc_cleanup - Cleans up the core crtc usage.
386 * @crtc: CRTC to cleanup
387 *
388 * LOCKING:
389 * Caller must hold mode config lock.
390 *
391 * Cleanup @crtc. Removes from drm modesetting space
392 * does NOT free object, caller does that.
393 */
394 void drm_crtc_cleanup(struct drm_crtc *crtc)
395 {
396 struct drm_device *dev = crtc->dev;
397
398 if (crtc->gamma_store) {
399 kfree(crtc->gamma_store);
400 crtc->gamma_store = NULL;
401 }
402
403 drm_mode_object_put(dev, &crtc->base);
404 list_del(&crtc->head);
405 dev->mode_config.num_crtc--;
406 }
407 EXPORT_SYMBOL(drm_crtc_cleanup);
408
409 /**
410 * drm_mode_probed_add - add a mode to a connector's probed mode list
411 * @connector: connector the new mode
412 * @mode: mode data
413 *
414 * LOCKING:
415 * Caller must hold mode config lock.
416 *
417 * Add @mode to @connector's mode list for later use.
418 */
419 void drm_mode_probed_add(struct drm_connector *connector,
420 struct drm_display_mode *mode)
421 {
422 list_add(&mode->head, &connector->probed_modes);
423 }
424 EXPORT_SYMBOL(drm_mode_probed_add);
425
426 /**
427 * drm_mode_remove - remove and free a mode
428 * @connector: connector list to modify
429 * @mode: mode to remove
430 *
431 * LOCKING:
432 * Caller must hold mode config lock.
433 *
434 * Remove @mode from @connector's mode list, then free it.
435 */
436 void drm_mode_remove(struct drm_connector *connector,
437 struct drm_display_mode *mode)
438 {
439 list_del(&mode->head);
440 drm_mode_destroy(connector->dev, mode);
441 }
442 EXPORT_SYMBOL(drm_mode_remove);
443
444 /**
445 * drm_connector_init - Init a preallocated connector
446 * @dev: DRM device
447 * @connector: the connector to init
448 * @funcs: callbacks for this connector
449 * @name: user visible name of the connector
450 *
451 * LOCKING:
452 * Takes mode config lock.
453 *
454 * Initialises a preallocated connector. Connectors should be
455 * subclassed as part of driver connector objects.
456 */
457 void drm_connector_init(struct drm_device *dev,
458 struct drm_connector *connector,
459 const struct drm_connector_funcs *funcs,
460 int connector_type)
461 {
462 mutex_lock(&dev->mode_config.mutex);
463
464 connector->dev = dev;
465 connector->funcs = funcs;
466 drm_mode_object_get(dev, &connector->base, DRM_MODE_OBJECT_CONNECTOR);
467 connector->connector_type = connector_type;
468 connector->connector_type_id =
469 ++drm_connector_enum_list[connector_type].count; /* TODO */
470 INIT_LIST_HEAD(&connector->user_modes);
471 INIT_LIST_HEAD(&connector->probed_modes);
472 INIT_LIST_HEAD(&connector->modes);
473 connector->edid_blob_ptr = NULL;
474
475 list_add_tail(&connector->head, &dev->mode_config.connector_list);
476 dev->mode_config.num_connector++;
477
478 if (connector_type != DRM_MODE_CONNECTOR_VIRTUAL)
479 drm_connector_attach_property(connector,
480 dev->mode_config.edid_property,
481 0);
482
483 drm_connector_attach_property(connector,
484 dev->mode_config.dpms_property, 0);
485
486 mutex_unlock(&dev->mode_config.mutex);
487 }
488 EXPORT_SYMBOL(drm_connector_init);
489
490 /**
491 * drm_connector_cleanup - cleans up an initialised connector
492 * @connector: connector to cleanup
493 *
494 * LOCKING:
495 * Takes mode config lock.
496 *
497 * Cleans up the connector but doesn't free the object.
498 */
499 void drm_connector_cleanup(struct drm_connector *connector)
500 {
501 struct drm_device *dev = connector->dev;
502 struct drm_display_mode *mode, *t;
503
504 list_for_each_entry_safe(mode, t, &connector->probed_modes, head)
505 drm_mode_remove(connector, mode);
506
507 list_for_each_entry_safe(mode, t, &connector->modes, head)
508 drm_mode_remove(connector, mode);
509
510 list_for_each_entry_safe(mode, t, &connector->user_modes, head)
511 drm_mode_remove(connector, mode);
512
513 mutex_lock(&dev->mode_config.mutex);
514 drm_mode_object_put(dev, &connector->base);
515 list_del(&connector->head);
516 dev->mode_config.num_connector--;
517 mutex_unlock(&dev->mode_config.mutex);
518 }
519 EXPORT_SYMBOL(drm_connector_cleanup);
520
521 void drm_encoder_init(struct drm_device *dev,
522 struct drm_encoder *encoder,
523 const struct drm_encoder_funcs *funcs,
524 int encoder_type)
525 {
526 mutex_lock(&dev->mode_config.mutex);
527
528 encoder->dev = dev;
529
530 drm_mode_object_get(dev, &encoder->base, DRM_MODE_OBJECT_ENCODER);
531 encoder->encoder_type = encoder_type;
532 encoder->funcs = funcs;
533
534 list_add_tail(&encoder->head, &dev->mode_config.encoder_list);
535 dev->mode_config.num_encoder++;
536
537 mutex_unlock(&dev->mode_config.mutex);
538 }
539 EXPORT_SYMBOL(drm_encoder_init);
540
541 void drm_encoder_cleanup(struct drm_encoder *encoder)
542 {
543 struct drm_device *dev = encoder->dev;
544 mutex_lock(&dev->mode_config.mutex);
545 drm_mode_object_put(dev, &encoder->base);
546 list_del(&encoder->head);
547 dev->mode_config.num_encoder--;
548 mutex_unlock(&dev->mode_config.mutex);
549 }
550 EXPORT_SYMBOL(drm_encoder_cleanup);
551
552 int drm_plane_init(struct drm_device *dev, struct drm_plane *plane,
553 unsigned long possible_crtcs,
554 const struct drm_plane_funcs *funcs,
555 const uint32_t *formats, uint32_t format_count,
556 bool priv)
557 {
558 mutex_lock(&dev->mode_config.mutex);
559
560 plane->dev = dev;
561 drm_mode_object_get(dev, &plane->base, DRM_MODE_OBJECT_PLANE);
562 plane->funcs = funcs;
563 plane->format_types = kmalloc(sizeof(uint32_t) * format_count,
564 GFP_KERNEL);
565 if (!plane->format_types) {
566 DRM_DEBUG_KMS("out of memory when allocating plane\n");
567 drm_mode_object_put(dev, &plane->base);
568 mutex_unlock(&dev->mode_config.mutex);
569 return -ENOMEM;
570 }
571
572 memcpy(plane->format_types, formats, format_count * sizeof(uint32_t));
573 plane->format_count = format_count;
574 plane->possible_crtcs = possible_crtcs;
575
576 /* private planes are not exposed to userspace, but depending on
577 * display hardware, might be convenient to allow sharing programming
578 * for the scanout engine with the crtc implementation.
579 */
580 if (!priv) {
581 list_add_tail(&plane->head, &dev->mode_config.plane_list);
582 dev->mode_config.num_plane++;
583 } else {
584 INIT_LIST_HEAD(&plane->head);
585 }
586
587 mutex_unlock(&dev->mode_config.mutex);
588
589 return 0;
590 }
591 EXPORT_SYMBOL(drm_plane_init);
592
593 void drm_plane_cleanup(struct drm_plane *plane)
594 {
595 struct drm_device *dev = plane->dev;
596
597 mutex_lock(&dev->mode_config.mutex);
598 kfree(plane->format_types);
599 drm_mode_object_put(dev, &plane->base);
600 /* if not added to a list, it must be a private plane */
601 if (!list_empty(&plane->head)) {
602 list_del(&plane->head);
603 dev->mode_config.num_plane--;
604 }
605 mutex_unlock(&dev->mode_config.mutex);
606 }
607 EXPORT_SYMBOL(drm_plane_cleanup);
608
609 /**
610 * drm_mode_create - create a new display mode
611 * @dev: DRM device
612 *
613 * LOCKING:
614 * Caller must hold DRM mode_config lock.
615 *
616 * Create a new drm_display_mode, give it an ID, and return it.
617 *
618 * RETURNS:
619 * Pointer to new mode on success, NULL on error.
620 */
621 struct drm_display_mode *drm_mode_create(struct drm_device *dev)
622 {
623 struct drm_display_mode *nmode;
624
625 nmode = kzalloc(sizeof(struct drm_display_mode), GFP_KERNEL);
626 if (!nmode)
627 return NULL;
628
629 drm_mode_object_get(dev, &nmode->base, DRM_MODE_OBJECT_MODE);
630 return nmode;
631 }
632 EXPORT_SYMBOL(drm_mode_create);
633
634 /**
635 * drm_mode_destroy - remove a mode
636 * @dev: DRM device
637 * @mode: mode to remove
638 *
639 * LOCKING:
640 * Caller must hold mode config lock.
641 *
642 * Free @mode's unique identifier, then free it.
643 */
644 void drm_mode_destroy(struct drm_device *dev, struct drm_display_mode *mode)
645 {
646 drm_mode_object_put(dev, &mode->base);
647
648 kfree(mode);
649 }
650 EXPORT_SYMBOL(drm_mode_destroy);
651
652 static int drm_mode_create_standard_connector_properties(struct drm_device *dev)
653 {
654 struct drm_property *edid;
655 struct drm_property *dpms;
656
657 /*
658 * Standard properties (apply to all connectors)
659 */
660 edid = drm_property_create(dev, DRM_MODE_PROP_BLOB |
661 DRM_MODE_PROP_IMMUTABLE,
662 "EDID", 0);
663 dev->mode_config.edid_property = edid;
664
665 dpms = drm_property_create_enum(dev, 0,
666 "DPMS", drm_dpms_enum_list,
667 ARRAY_SIZE(drm_dpms_enum_list));
668 dev->mode_config.dpms_property = dpms;
669
670 return 0;
671 }
672
673 /**
674 * drm_mode_create_dvi_i_properties - create DVI-I specific connector properties
675 * @dev: DRM device
676 *
677 * Called by a driver the first time a DVI-I connector is made.
678 */
679 int drm_mode_create_dvi_i_properties(struct drm_device *dev)
680 {
681 struct drm_property *dvi_i_selector;
682 struct drm_property *dvi_i_subconnector;
683
684 if (dev->mode_config.dvi_i_select_subconnector_property)
685 return 0;
686
687 dvi_i_selector =
688 drm_property_create_enum(dev, 0,
689 "select subconnector",
690 drm_dvi_i_select_enum_list,
691 ARRAY_SIZE(drm_dvi_i_select_enum_list));
692 dev->mode_config.dvi_i_select_subconnector_property = dvi_i_selector;
693
694 dvi_i_subconnector = drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
695 "subconnector",
696 drm_dvi_i_subconnector_enum_list,
697 ARRAY_SIZE(drm_dvi_i_subconnector_enum_list));
698 dev->mode_config.dvi_i_subconnector_property = dvi_i_subconnector;
699
700 return 0;
701 }
702 EXPORT_SYMBOL(drm_mode_create_dvi_i_properties);
703
704 /**
705 * drm_create_tv_properties - create TV specific connector properties
706 * @dev: DRM device
707 * @num_modes: number of different TV formats (modes) supported
708 * @modes: array of pointers to strings containing name of each format
709 *
710 * Called by a driver's TV initialization routine, this function creates
711 * the TV specific connector properties for a given device. Caller is
712 * responsible for allocating a list of format names and passing them to
713 * this routine.
714 */
715 int drm_mode_create_tv_properties(struct drm_device *dev, int num_modes,
716 char *modes[])
717 {
718 struct drm_property *tv_selector;
719 struct drm_property *tv_subconnector;
720 int i;
721
722 if (dev->mode_config.tv_select_subconnector_property)
723 return 0;
724
725 /*
726 * Basic connector properties
727 */
728 tv_selector = drm_property_create_enum(dev, 0,
729 "select subconnector",
730 drm_tv_select_enum_list,
731 ARRAY_SIZE(drm_tv_select_enum_list));
732 dev->mode_config.tv_select_subconnector_property = tv_selector;
733
734 tv_subconnector =
735 drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
736 "subconnector",
737 drm_tv_subconnector_enum_list,
738 ARRAY_SIZE(drm_tv_subconnector_enum_list));
739 dev->mode_config.tv_subconnector_property = tv_subconnector;
740
741 /*
742 * Other, TV specific properties: margins & TV modes.
743 */
744 dev->mode_config.tv_left_margin_property =
745 drm_property_create_range(dev, 0, "left margin", 0, 100);
746
747 dev->mode_config.tv_right_margin_property =
748 drm_property_create_range(dev, 0, "right margin", 0, 100);
749
750 dev->mode_config.tv_top_margin_property =
751 drm_property_create_range(dev, 0, "top margin", 0, 100);
752
753 dev->mode_config.tv_bottom_margin_property =
754 drm_property_create_range(dev, 0, "bottom margin", 0, 100);
755
756 dev->mode_config.tv_mode_property =
757 drm_property_create(dev, DRM_MODE_PROP_ENUM,
758 "mode", num_modes);
759 for (i = 0; i < num_modes; i++)
760 drm_property_add_enum(dev->mode_config.tv_mode_property, i,
761 i, modes[i]);
762
763 dev->mode_config.tv_brightness_property =
764 drm_property_create_range(dev, 0, "brightness", 0, 100);
765
766 dev->mode_config.tv_contrast_property =
767 drm_property_create_range(dev, 0, "contrast", 0, 100);
768
769 dev->mode_config.tv_flicker_reduction_property =
770 drm_property_create_range(dev, 0, "flicker reduction", 0, 100);
771
772 dev->mode_config.tv_overscan_property =
773 drm_property_create_range(dev, 0, "overscan", 0, 100);
774
775 dev->mode_config.tv_saturation_property =
776 drm_property_create_range(dev, 0, "saturation", 0, 100);
777
778 dev->mode_config.tv_hue_property =
779 drm_property_create_range(dev, 0, "hue", 0, 100);
780
781 return 0;
782 }
783 EXPORT_SYMBOL(drm_mode_create_tv_properties);
784
785 /**
786 * drm_mode_create_scaling_mode_property - create scaling mode property
787 * @dev: DRM device
788 *
789 * Called by a driver the first time it's needed, must be attached to desired
790 * connectors.
791 */
792 int drm_mode_create_scaling_mode_property(struct drm_device *dev)
793 {
794 struct drm_property *scaling_mode;
795
796 if (dev->mode_config.scaling_mode_property)
797 return 0;
798
799 scaling_mode =
800 drm_property_create_enum(dev, 0, "scaling mode",
801 drm_scaling_mode_enum_list,
802 ARRAY_SIZE(drm_scaling_mode_enum_list));
803
804 dev->mode_config.scaling_mode_property = scaling_mode;
805
806 return 0;
807 }
808 EXPORT_SYMBOL(drm_mode_create_scaling_mode_property);
809
810 /**
811 * drm_mode_create_dithering_property - create dithering property
812 * @dev: DRM device
813 *
814 * Called by a driver the first time it's needed, must be attached to desired
815 * connectors.
816 */
817 int drm_mode_create_dithering_property(struct drm_device *dev)
818 {
819 struct drm_property *dithering_mode;
820
821 if (dev->mode_config.dithering_mode_property)
822 return 0;
823
824 dithering_mode =
825 drm_property_create_enum(dev, 0, "dithering",
826 drm_dithering_mode_enum_list,
827 ARRAY_SIZE(drm_dithering_mode_enum_list));
828 dev->mode_config.dithering_mode_property = dithering_mode;
829
830 return 0;
831 }
832 EXPORT_SYMBOL(drm_mode_create_dithering_property);
833
834 /**
835 * drm_mode_create_dirty_property - create dirty property
836 * @dev: DRM device
837 *
838 * Called by a driver the first time it's needed, must be attached to desired
839 * connectors.
840 */
841 int drm_mode_create_dirty_info_property(struct drm_device *dev)
842 {
843 struct drm_property *dirty_info;
844
845 if (dev->mode_config.dirty_info_property)
846 return 0;
847
848 dirty_info =
849 drm_property_create_enum(dev, DRM_MODE_PROP_IMMUTABLE,
850 "dirty",
851 drm_dirty_info_enum_list,
852 ARRAY_SIZE(drm_dirty_info_enum_list));
853 dev->mode_config.dirty_info_property = dirty_info;
854
855 return 0;
856 }
857 EXPORT_SYMBOL(drm_mode_create_dirty_info_property);
858
859 /**
860 * drm_mode_config_init - initialize DRM mode_configuration structure
861 * @dev: DRM device
862 *
863 * LOCKING:
864 * None, should happen single threaded at init time.
865 *
866 * Initialize @dev's mode_config structure, used for tracking the graphics
867 * configuration of @dev.
868 */
869 void drm_mode_config_init(struct drm_device *dev)
870 {
871 mutex_init(&dev->mode_config.mutex);
872 mutex_init(&dev->mode_config.idr_mutex);
873 INIT_LIST_HEAD(&dev->mode_config.fb_list);
874 INIT_LIST_HEAD(&dev->mode_config.crtc_list);
875 INIT_LIST_HEAD(&dev->mode_config.connector_list);
876 INIT_LIST_HEAD(&dev->mode_config.encoder_list);
877 INIT_LIST_HEAD(&dev->mode_config.property_list);
878 INIT_LIST_HEAD(&dev->mode_config.property_blob_list);
879 INIT_LIST_HEAD(&dev->mode_config.plane_list);
880 idr_init(&dev->mode_config.crtc_idr);
881
882 mutex_lock(&dev->mode_config.mutex);
883 drm_mode_create_standard_connector_properties(dev);
884 mutex_unlock(&dev->mode_config.mutex);
885
886 /* Just to be sure */
887 dev->mode_config.num_fb = 0;
888 dev->mode_config.num_connector = 0;
889 dev->mode_config.num_crtc = 0;
890 dev->mode_config.num_encoder = 0;
891 }
892 EXPORT_SYMBOL(drm_mode_config_init);
893
894 int drm_mode_group_init(struct drm_device *dev, struct drm_mode_group *group)
895 {
896 uint32_t total_objects = 0;
897
898 total_objects += dev->mode_config.num_crtc;
899 total_objects += dev->mode_config.num_connector;
900 total_objects += dev->mode_config.num_encoder;
901
902 group->id_list = kzalloc(total_objects * sizeof(uint32_t), GFP_KERNEL);
903 if (!group->id_list)
904 return -ENOMEM;
905
906 group->num_crtcs = 0;
907 group->num_connectors = 0;
908 group->num_encoders = 0;
909 return 0;
910 }
911
912 int drm_mode_group_init_legacy_group(struct drm_device *dev,
913 struct drm_mode_group *group)
914 {
915 struct drm_crtc *crtc;
916 struct drm_encoder *encoder;
917 struct drm_connector *connector;
918 int ret;
919
920 if ((ret = drm_mode_group_init(dev, group)))
921 return ret;
922
923 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head)
924 group->id_list[group->num_crtcs++] = crtc->base.id;
925
926 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head)
927 group->id_list[group->num_crtcs + group->num_encoders++] =
928 encoder->base.id;
929
930 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
931 group->id_list[group->num_crtcs + group->num_encoders +
932 group->num_connectors++] = connector->base.id;
933
934 return 0;
935 }
936
937 /**
938 * drm_mode_config_cleanup - free up DRM mode_config info
939 * @dev: DRM device
940 *
941 * LOCKING:
942 * Caller must hold mode config lock.
943 *
944 * Free up all the connectors and CRTCs associated with this DRM device, then
945 * free up the framebuffers and associated buffer objects.
946 *
947 * FIXME: cleanup any dangling user buffer objects too
948 */
949 void drm_mode_config_cleanup(struct drm_device *dev)
950 {
951 struct drm_connector *connector, *ot;
952 struct drm_crtc *crtc, *ct;
953 struct drm_encoder *encoder, *enct;
954 struct drm_framebuffer *fb, *fbt;
955 struct drm_property *property, *pt;
956 struct drm_plane *plane, *plt;
957
958 list_for_each_entry_safe(encoder, enct, &dev->mode_config.encoder_list,
959 head) {
960 encoder->funcs->destroy(encoder);
961 }
962
963 list_for_each_entry_safe(connector, ot,
964 &dev->mode_config.connector_list, head) {
965 connector->funcs->destroy(connector);
966 }
967
968 list_for_each_entry_safe(property, pt, &dev->mode_config.property_list,
969 head) {
970 drm_property_destroy(dev, property);
971 }
972
973 list_for_each_entry_safe(fb, fbt, &dev->mode_config.fb_list, head) {
974 fb->funcs->destroy(fb);
975 }
976
977 list_for_each_entry_safe(crtc, ct, &dev->mode_config.crtc_list, head) {
978 crtc->funcs->destroy(crtc);
979 }
980
981 list_for_each_entry_safe(plane, plt, &dev->mode_config.plane_list,
982 head) {
983 plane->funcs->destroy(plane);
984 }
985
986 idr_remove_all(&dev->mode_config.crtc_idr);
987 idr_destroy(&dev->mode_config.crtc_idr);
988 }
989 EXPORT_SYMBOL(drm_mode_config_cleanup);
990
991 /**
992 * drm_crtc_convert_to_umode - convert a drm_display_mode into a modeinfo
993 * @out: drm_mode_modeinfo struct to return to the user
994 * @in: drm_display_mode to use
995 *
996 * LOCKING:
997 * None.
998 *
999 * Convert a drm_display_mode into a drm_mode_modeinfo structure to return to
1000 * the user.
1001 */
1002 void drm_crtc_convert_to_umode(struct drm_mode_modeinfo *out,
1003 struct drm_display_mode *in)
1004 {
1005 WARN(in->hdisplay > USHRT_MAX || in->hsync_start > USHRT_MAX ||
1006 in->hsync_end > USHRT_MAX || in->htotal > USHRT_MAX ||
1007 in->hskew > USHRT_MAX || in->vdisplay > USHRT_MAX ||
1008 in->vsync_start > USHRT_MAX || in->vsync_end > USHRT_MAX ||
1009 in->vtotal > USHRT_MAX || in->vscan > USHRT_MAX,
1010 "timing values too large for mode info\n");
1011
1012 out->clock = in->clock;
1013 out->hdisplay = in->hdisplay;
1014 out->hsync_start = in->hsync_start;
1015 out->hsync_end = in->hsync_end;
1016 out->htotal = in->htotal;
1017 out->hskew = in->hskew;
1018 out->vdisplay = in->vdisplay;
1019 out->vsync_start = in->vsync_start;
1020 out->vsync_end = in->vsync_end;
1021 out->vtotal = in->vtotal;
1022 out->vscan = in->vscan;
1023 out->vrefresh = in->vrefresh;
1024 out->flags = in->flags;
1025 out->type = in->type;
1026 strncpy(out->name, in->name, DRM_DISPLAY_MODE_LEN);
1027 out->name[DRM_DISPLAY_MODE_LEN-1] = 0;
1028 }
1029
1030 /**
1031 * drm_crtc_convert_to_umode - convert a modeinfo into a drm_display_mode
1032 * @out: drm_display_mode to return to the user
1033 * @in: drm_mode_modeinfo to use
1034 *
1035 * LOCKING:
1036 * None.
1037 *
1038 * Convert a drm_mode_modeinfo into a drm_display_mode structure to return to
1039 * the caller.
1040 */
1041 void drm_crtc_convert_umode(struct drm_display_mode *out,
1042 struct drm_mode_modeinfo *in)
1043 {
1044 out->clock = in->clock;
1045 out->hdisplay = in->hdisplay;
1046 out->hsync_start = in->hsync_start;
1047 out->hsync_end = in->hsync_end;
1048 out->htotal = in->htotal;
1049 out->hskew = in->hskew;
1050 out->vdisplay = in->vdisplay;
1051 out->vsync_start = in->vsync_start;
1052 out->vsync_end = in->vsync_end;
1053 out->vtotal = in->vtotal;
1054 out->vscan = in->vscan;
1055 out->vrefresh = in->vrefresh;
1056 out->flags = in->flags;
1057 out->type = in->type;
1058 strncpy(out->name, in->name, DRM_DISPLAY_MODE_LEN);
1059 out->name[DRM_DISPLAY_MODE_LEN-1] = 0;
1060 }
1061
1062 /**
1063 * drm_mode_getresources - get graphics configuration
1064 * @inode: inode from the ioctl
1065 * @filp: file * from the ioctl
1066 * @cmd: cmd from ioctl
1067 * @arg: arg from ioctl
1068 *
1069 * LOCKING:
1070 * Takes mode config lock.
1071 *
1072 * Construct a set of configuration description structures and return
1073 * them to the user, including CRTC, connector and framebuffer configuration.
1074 *
1075 * Called by the user via ioctl.
1076 *
1077 * RETURNS:
1078 * Zero on success, errno on failure.
1079 */
1080 int drm_mode_getresources(struct drm_device *dev, void *data,
1081 struct drm_file *file_priv)
1082 {
1083 struct drm_mode_card_res *card_res = data;
1084 struct list_head *lh;
1085 struct drm_framebuffer *fb;
1086 struct drm_connector *connector;
1087 struct drm_crtc *crtc;
1088 struct drm_encoder *encoder;
1089 int ret = 0;
1090 int connector_count = 0;
1091 int crtc_count = 0;
1092 int fb_count = 0;
1093 int encoder_count = 0;
1094 int copied = 0, i;
1095 uint32_t __user *fb_id;
1096 uint32_t __user *crtc_id;
1097 uint32_t __user *connector_id;
1098 uint32_t __user *encoder_id;
1099 struct drm_mode_group *mode_group;
1100
1101 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1102 return -EINVAL;
1103
1104 mutex_lock(&dev->mode_config.mutex);
1105
1106 /*
1107 * For the non-control nodes we need to limit the list of resources
1108 * by IDs in the group list for this node
1109 */
1110 list_for_each(lh, &file_priv->fbs)
1111 fb_count++;
1112
1113 mode_group = &file_priv->master->minor->mode_group;
1114 if (file_priv->master->minor->type == DRM_MINOR_CONTROL) {
1115
1116 list_for_each(lh, &dev->mode_config.crtc_list)
1117 crtc_count++;
1118
1119 list_for_each(lh, &dev->mode_config.connector_list)
1120 connector_count++;
1121
1122 list_for_each(lh, &dev->mode_config.encoder_list)
1123 encoder_count++;
1124 } else {
1125
1126 crtc_count = mode_group->num_crtcs;
1127 connector_count = mode_group->num_connectors;
1128 encoder_count = mode_group->num_encoders;
1129 }
1130
1131 card_res->max_height = dev->mode_config.max_height;
1132 card_res->min_height = dev->mode_config.min_height;
1133 card_res->max_width = dev->mode_config.max_width;
1134 card_res->min_width = dev->mode_config.min_width;
1135
1136 /* handle this in 4 parts */
1137 /* FBs */
1138 if (card_res->count_fbs >= fb_count) {
1139 copied = 0;
1140 fb_id = (uint32_t __user *)(unsigned long)card_res->fb_id_ptr;
1141 list_for_each_entry(fb, &file_priv->fbs, filp_head) {
1142 if (put_user(fb->base.id, fb_id + copied)) {
1143 ret = -EFAULT;
1144 goto out;
1145 }
1146 copied++;
1147 }
1148 }
1149 card_res->count_fbs = fb_count;
1150
1151 /* CRTCs */
1152 if (card_res->count_crtcs >= crtc_count) {
1153 copied = 0;
1154 crtc_id = (uint32_t __user *)(unsigned long)card_res->crtc_id_ptr;
1155 if (file_priv->master->minor->type == DRM_MINOR_CONTROL) {
1156 list_for_each_entry(crtc, &dev->mode_config.crtc_list,
1157 head) {
1158 DRM_DEBUG_KMS("[CRTC:%d]\n", crtc->base.id);
1159 if (put_user(crtc->base.id, crtc_id + copied)) {
1160 ret = -EFAULT;
1161 goto out;
1162 }
1163 copied++;
1164 }
1165 } else {
1166 for (i = 0; i < mode_group->num_crtcs; i++) {
1167 if (put_user(mode_group->id_list[i],
1168 crtc_id + copied)) {
1169 ret = -EFAULT;
1170 goto out;
1171 }
1172 copied++;
1173 }
1174 }
1175 }
1176 card_res->count_crtcs = crtc_count;
1177
1178 /* Encoders */
1179 if (card_res->count_encoders >= encoder_count) {
1180 copied = 0;
1181 encoder_id = (uint32_t __user *)(unsigned long)card_res->encoder_id_ptr;
1182 if (file_priv->master->minor->type == DRM_MINOR_CONTROL) {
1183 list_for_each_entry(encoder,
1184 &dev->mode_config.encoder_list,
1185 head) {
1186 DRM_DEBUG_KMS("[ENCODER:%d:%s]\n", encoder->base.id,
1187 drm_get_encoder_name(encoder));
1188 if (put_user(encoder->base.id, encoder_id +
1189 copied)) {
1190 ret = -EFAULT;
1191 goto out;
1192 }
1193 copied++;
1194 }
1195 } else {
1196 for (i = mode_group->num_crtcs; i < mode_group->num_crtcs + mode_group->num_encoders; i++) {
1197 if (put_user(mode_group->id_list[i],
1198 encoder_id + copied)) {
1199 ret = -EFAULT;
1200 goto out;
1201 }
1202 copied++;
1203 }
1204
1205 }
1206 }
1207 card_res->count_encoders = encoder_count;
1208
1209 /* Connectors */
1210 if (card_res->count_connectors >= connector_count) {
1211 copied = 0;
1212 connector_id = (uint32_t __user *)(unsigned long)card_res->connector_id_ptr;
1213 if (file_priv->master->minor->type == DRM_MINOR_CONTROL) {
1214 list_for_each_entry(connector,
1215 &dev->mode_config.connector_list,
1216 head) {
1217 DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n",
1218 connector->base.id,
1219 drm_get_connector_name(connector));
1220 if (put_user(connector->base.id,
1221 connector_id + copied)) {
1222 ret = -EFAULT;
1223 goto out;
1224 }
1225 copied++;
1226 }
1227 } else {
1228 int start = mode_group->num_crtcs +
1229 mode_group->num_encoders;
1230 for (i = start; i < start + mode_group->num_connectors; i++) {
1231 if (put_user(mode_group->id_list[i],
1232 connector_id + copied)) {
1233 ret = -EFAULT;
1234 goto out;
1235 }
1236 copied++;
1237 }
1238 }
1239 }
1240 card_res->count_connectors = connector_count;
1241
1242 DRM_DEBUG_KMS("CRTC[%d] CONNECTORS[%d] ENCODERS[%d]\n", card_res->count_crtcs,
1243 card_res->count_connectors, card_res->count_encoders);
1244
1245 out:
1246 mutex_unlock(&dev->mode_config.mutex);
1247 return ret;
1248 }
1249
1250 /**
1251 * drm_mode_getcrtc - get CRTC configuration
1252 * @inode: inode from the ioctl
1253 * @filp: file * from the ioctl
1254 * @cmd: cmd from ioctl
1255 * @arg: arg from ioctl
1256 *
1257 * LOCKING:
1258 * Takes mode config lock.
1259 *
1260 * Construct a CRTC configuration structure to return to the user.
1261 *
1262 * Called by the user via ioctl.
1263 *
1264 * RETURNS:
1265 * Zero on success, errno on failure.
1266 */
1267 int drm_mode_getcrtc(struct drm_device *dev,
1268 void *data, struct drm_file *file_priv)
1269 {
1270 struct drm_mode_crtc *crtc_resp = data;
1271 struct drm_crtc *crtc;
1272 struct drm_mode_object *obj;
1273 int ret = 0;
1274
1275 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1276 return -EINVAL;
1277
1278 mutex_lock(&dev->mode_config.mutex);
1279
1280 obj = drm_mode_object_find(dev, crtc_resp->crtc_id,
1281 DRM_MODE_OBJECT_CRTC);
1282 if (!obj) {
1283 ret = -EINVAL;
1284 goto out;
1285 }
1286 crtc = obj_to_crtc(obj);
1287
1288 crtc_resp->x = crtc->x;
1289 crtc_resp->y = crtc->y;
1290 crtc_resp->gamma_size = crtc->gamma_size;
1291 if (crtc->fb)
1292 crtc_resp->fb_id = crtc->fb->base.id;
1293 else
1294 crtc_resp->fb_id = 0;
1295
1296 if (crtc->enabled) {
1297
1298 drm_crtc_convert_to_umode(&crtc_resp->mode, &crtc->mode);
1299 crtc_resp->mode_valid = 1;
1300
1301 } else {
1302 crtc_resp->mode_valid = 0;
1303 }
1304
1305 out:
1306 mutex_unlock(&dev->mode_config.mutex);
1307 return ret;
1308 }
1309
1310 /**
1311 * drm_mode_getconnector - get connector configuration
1312 * @inode: inode from the ioctl
1313 * @filp: file * from the ioctl
1314 * @cmd: cmd from ioctl
1315 * @arg: arg from ioctl
1316 *
1317 * LOCKING:
1318 * Takes mode config lock.
1319 *
1320 * Construct a connector configuration structure to return to the user.
1321 *
1322 * Called by the user via ioctl.
1323 *
1324 * RETURNS:
1325 * Zero on success, errno on failure.
1326 */
1327 int drm_mode_getconnector(struct drm_device *dev, void *data,
1328 struct drm_file *file_priv)
1329 {
1330 struct drm_mode_get_connector *out_resp = data;
1331 struct drm_mode_object *obj;
1332 struct drm_connector *connector;
1333 struct drm_display_mode *mode;
1334 int mode_count = 0;
1335 int props_count = 0;
1336 int encoders_count = 0;
1337 int ret = 0;
1338 int copied = 0;
1339 int i;
1340 struct drm_mode_modeinfo u_mode;
1341 struct drm_mode_modeinfo __user *mode_ptr;
1342 uint32_t __user *prop_ptr;
1343 uint64_t __user *prop_values;
1344 uint32_t __user *encoder_ptr;
1345
1346 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1347 return -EINVAL;
1348
1349 memset(&u_mode, 0, sizeof(struct drm_mode_modeinfo));
1350
1351 DRM_DEBUG_KMS("[CONNECTOR:%d:?]\n", out_resp->connector_id);
1352
1353 mutex_lock(&dev->mode_config.mutex);
1354
1355 obj = drm_mode_object_find(dev, out_resp->connector_id,
1356 DRM_MODE_OBJECT_CONNECTOR);
1357 if (!obj) {
1358 ret = -EINVAL;
1359 goto out;
1360 }
1361 connector = obj_to_connector(obj);
1362
1363 for (i = 0; i < DRM_CONNECTOR_MAX_PROPERTY; i++) {
1364 if (connector->property_ids[i] != 0) {
1365 props_count++;
1366 }
1367 }
1368
1369 for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
1370 if (connector->encoder_ids[i] != 0) {
1371 encoders_count++;
1372 }
1373 }
1374
1375 if (out_resp->count_modes == 0) {
1376 connector->funcs->fill_modes(connector,
1377 dev->mode_config.max_width,
1378 dev->mode_config.max_height);
1379 }
1380
1381 /* delayed so we get modes regardless of pre-fill_modes state */
1382 list_for_each_entry(mode, &connector->modes, head)
1383 mode_count++;
1384
1385 out_resp->connector_id = connector->base.id;
1386 out_resp->connector_type = connector->connector_type;
1387 out_resp->connector_type_id = connector->connector_type_id;
1388 out_resp->mm_width = connector->display_info.width_mm;
1389 out_resp->mm_height = connector->display_info.height_mm;
1390 out_resp->subpixel = connector->display_info.subpixel_order;
1391 out_resp->connection = connector->status;
1392 if (connector->encoder)
1393 out_resp->encoder_id = connector->encoder->base.id;
1394 else
1395 out_resp->encoder_id = 0;
1396
1397 /*
1398 * This ioctl is called twice, once to determine how much space is
1399 * needed, and the 2nd time to fill it.
1400 */
1401 if ((out_resp->count_modes >= mode_count) && mode_count) {
1402 copied = 0;
1403 mode_ptr = (struct drm_mode_modeinfo __user *)(unsigned long)out_resp->modes_ptr;
1404 list_for_each_entry(mode, &connector->modes, head) {
1405 drm_crtc_convert_to_umode(&u_mode, mode);
1406 if (copy_to_user(mode_ptr + copied,
1407 &u_mode, sizeof(u_mode))) {
1408 ret = -EFAULT;
1409 goto out;
1410 }
1411 copied++;
1412 }
1413 }
1414 out_resp->count_modes = mode_count;
1415
1416 if ((out_resp->count_props >= props_count) && props_count) {
1417 copied = 0;
1418 prop_ptr = (uint32_t __user *)(unsigned long)(out_resp->props_ptr);
1419 prop_values = (uint64_t __user *)(unsigned long)(out_resp->prop_values_ptr);
1420 for (i = 0; i < DRM_CONNECTOR_MAX_PROPERTY; i++) {
1421 if (connector->property_ids[i] != 0) {
1422 if (put_user(connector->property_ids[i],
1423 prop_ptr + copied)) {
1424 ret = -EFAULT;
1425 goto out;
1426 }
1427
1428 if (put_user(connector->property_values[i],
1429 prop_values + copied)) {
1430 ret = -EFAULT;
1431 goto out;
1432 }
1433 copied++;
1434 }
1435 }
1436 }
1437 out_resp->count_props = props_count;
1438
1439 if ((out_resp->count_encoders >= encoders_count) && encoders_count) {
1440 copied = 0;
1441 encoder_ptr = (uint32_t __user *)(unsigned long)(out_resp->encoders_ptr);
1442 for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
1443 if (connector->encoder_ids[i] != 0) {
1444 if (put_user(connector->encoder_ids[i],
1445 encoder_ptr + copied)) {
1446 ret = -EFAULT;
1447 goto out;
1448 }
1449 copied++;
1450 }
1451 }
1452 }
1453 out_resp->count_encoders = encoders_count;
1454
1455 out:
1456 mutex_unlock(&dev->mode_config.mutex);
1457 return ret;
1458 }
1459
1460 int drm_mode_getencoder(struct drm_device *dev, void *data,
1461 struct drm_file *file_priv)
1462 {
1463 struct drm_mode_get_encoder *enc_resp = data;
1464 struct drm_mode_object *obj;
1465 struct drm_encoder *encoder;
1466 int ret = 0;
1467
1468 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1469 return -EINVAL;
1470
1471 mutex_lock(&dev->mode_config.mutex);
1472 obj = drm_mode_object_find(dev, enc_resp->encoder_id,
1473 DRM_MODE_OBJECT_ENCODER);
1474 if (!obj) {
1475 ret = -EINVAL;
1476 goto out;
1477 }
1478 encoder = obj_to_encoder(obj);
1479
1480 if (encoder->crtc)
1481 enc_resp->crtc_id = encoder->crtc->base.id;
1482 else
1483 enc_resp->crtc_id = 0;
1484 enc_resp->encoder_type = encoder->encoder_type;
1485 enc_resp->encoder_id = encoder->base.id;
1486 enc_resp->possible_crtcs = encoder->possible_crtcs;
1487 enc_resp->possible_clones = encoder->possible_clones;
1488
1489 out:
1490 mutex_unlock(&dev->mode_config.mutex);
1491 return ret;
1492 }
1493
1494 /**
1495 * drm_mode_getplane_res - get plane info
1496 * @dev: DRM device
1497 * @data: ioctl data
1498 * @file_priv: DRM file info
1499 *
1500 * LOCKING:
1501 * Takes mode config lock.
1502 *
1503 * Return an plane count and set of IDs.
1504 */
1505 int drm_mode_getplane_res(struct drm_device *dev, void *data,
1506 struct drm_file *file_priv)
1507 {
1508 struct drm_mode_get_plane_res *plane_resp = data;
1509 struct drm_mode_config *config;
1510 struct drm_plane *plane;
1511 uint32_t __user *plane_ptr;
1512 int copied = 0, ret = 0;
1513
1514 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1515 return -EINVAL;
1516
1517 mutex_lock(&dev->mode_config.mutex);
1518 config = &dev->mode_config;
1519
1520 /*
1521 * This ioctl is called twice, once to determine how much space is
1522 * needed, and the 2nd time to fill it.
1523 */
1524 if (config->num_plane &&
1525 (plane_resp->count_planes >= config->num_plane)) {
1526 plane_ptr = (uint32_t __user *)(unsigned long)plane_resp->plane_id_ptr;
1527
1528 list_for_each_entry(plane, &config->plane_list, head) {
1529 if (put_user(plane->base.id, plane_ptr + copied)) {
1530 ret = -EFAULT;
1531 goto out;
1532 }
1533 copied++;
1534 }
1535 }
1536 plane_resp->count_planes = config->num_plane;
1537
1538 out:
1539 mutex_unlock(&dev->mode_config.mutex);
1540 return ret;
1541 }
1542
1543 /**
1544 * drm_mode_getplane - get plane info
1545 * @dev: DRM device
1546 * @data: ioctl data
1547 * @file_priv: DRM file info
1548 *
1549 * LOCKING:
1550 * Takes mode config lock.
1551 *
1552 * Return plane info, including formats supported, gamma size, any
1553 * current fb, etc.
1554 */
1555 int drm_mode_getplane(struct drm_device *dev, void *data,
1556 struct drm_file *file_priv)
1557 {
1558 struct drm_mode_get_plane *plane_resp = data;
1559 struct drm_mode_object *obj;
1560 struct drm_plane *plane;
1561 uint32_t __user *format_ptr;
1562 int ret = 0;
1563
1564 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1565 return -EINVAL;
1566
1567 mutex_lock(&dev->mode_config.mutex);
1568 obj = drm_mode_object_find(dev, plane_resp->plane_id,
1569 DRM_MODE_OBJECT_PLANE);
1570 if (!obj) {
1571 ret = -ENOENT;
1572 goto out;
1573 }
1574 plane = obj_to_plane(obj);
1575
1576 if (plane->crtc)
1577 plane_resp->crtc_id = plane->crtc->base.id;
1578 else
1579 plane_resp->crtc_id = 0;
1580
1581 if (plane->fb)
1582 plane_resp->fb_id = plane->fb->base.id;
1583 else
1584 plane_resp->fb_id = 0;
1585
1586 plane_resp->plane_id = plane->base.id;
1587 plane_resp->possible_crtcs = plane->possible_crtcs;
1588 plane_resp->gamma_size = plane->gamma_size;
1589
1590 /*
1591 * This ioctl is called twice, once to determine how much space is
1592 * needed, and the 2nd time to fill it.
1593 */
1594 if (plane->format_count &&
1595 (plane_resp->count_format_types >= plane->format_count)) {
1596 format_ptr = (uint32_t __user *)(unsigned long)plane_resp->format_type_ptr;
1597 if (copy_to_user(format_ptr,
1598 plane->format_types,
1599 sizeof(uint32_t) * plane->format_count)) {
1600 ret = -EFAULT;
1601 goto out;
1602 }
1603 }
1604 plane_resp->count_format_types = plane->format_count;
1605
1606 out:
1607 mutex_unlock(&dev->mode_config.mutex);
1608 return ret;
1609 }
1610
1611 /**
1612 * drm_mode_setplane - set up or tear down an plane
1613 * @dev: DRM device
1614 * @data: ioctl data*
1615 * @file_prive: DRM file info
1616 *
1617 * LOCKING:
1618 * Takes mode config lock.
1619 *
1620 * Set plane info, including placement, fb, scaling, and other factors.
1621 * Or pass a NULL fb to disable.
1622 */
1623 int drm_mode_setplane(struct drm_device *dev, void *data,
1624 struct drm_file *file_priv)
1625 {
1626 struct drm_mode_set_plane *plane_req = data;
1627 struct drm_mode_object *obj;
1628 struct drm_plane *plane;
1629 struct drm_crtc *crtc;
1630 struct drm_framebuffer *fb;
1631 int ret = 0;
1632 unsigned int fb_width, fb_height;
1633 int i;
1634
1635 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1636 return -EINVAL;
1637
1638 mutex_lock(&dev->mode_config.mutex);
1639
1640 /*
1641 * First, find the plane, crtc, and fb objects. If not available,
1642 * we don't bother to call the driver.
1643 */
1644 obj = drm_mode_object_find(dev, plane_req->plane_id,
1645 DRM_MODE_OBJECT_PLANE);
1646 if (!obj) {
1647 DRM_DEBUG_KMS("Unknown plane ID %d\n",
1648 plane_req->plane_id);
1649 ret = -ENOENT;
1650 goto out;
1651 }
1652 plane = obj_to_plane(obj);
1653
1654 /* No fb means shut it down */
1655 if (!plane_req->fb_id) {
1656 plane->funcs->disable_plane(plane);
1657 plane->crtc = NULL;
1658 plane->fb = NULL;
1659 goto out;
1660 }
1661
1662 obj = drm_mode_object_find(dev, plane_req->crtc_id,
1663 DRM_MODE_OBJECT_CRTC);
1664 if (!obj) {
1665 DRM_DEBUG_KMS("Unknown crtc ID %d\n",
1666 plane_req->crtc_id);
1667 ret = -ENOENT;
1668 goto out;
1669 }
1670 crtc = obj_to_crtc(obj);
1671
1672 obj = drm_mode_object_find(dev, plane_req->fb_id,
1673 DRM_MODE_OBJECT_FB);
1674 if (!obj) {
1675 DRM_DEBUG_KMS("Unknown framebuffer ID %d\n",
1676 plane_req->fb_id);
1677 ret = -ENOENT;
1678 goto out;
1679 }
1680 fb = obj_to_fb(obj);
1681
1682 /* Check whether this plane supports the fb pixel format. */
1683 for (i = 0; i < plane->format_count; i++)
1684 if (fb->pixel_format == plane->format_types[i])
1685 break;
1686 if (i == plane->format_count) {
1687 DRM_DEBUG_KMS("Invalid pixel format 0x%08x\n", fb->pixel_format);
1688 ret = -EINVAL;
1689 goto out;
1690 }
1691
1692 fb_width = fb->width << 16;
1693 fb_height = fb->height << 16;
1694
1695 /* Make sure source coordinates are inside the fb. */
1696 if (plane_req->src_w > fb_width ||
1697 plane_req->src_x > fb_width - plane_req->src_w ||
1698 plane_req->src_h > fb_height ||
1699 plane_req->src_y > fb_height - plane_req->src_h) {
1700 DRM_DEBUG_KMS("Invalid source coordinates "
1701 "%u.%06ux%u.%06u+%u.%06u+%u.%06u\n",
1702 plane_req->src_w >> 16,
1703 ((plane_req->src_w & 0xffff) * 15625) >> 10,
1704 plane_req->src_h >> 16,
1705 ((plane_req->src_h & 0xffff) * 15625) >> 10,
1706 plane_req->src_x >> 16,
1707 ((plane_req->src_x & 0xffff) * 15625) >> 10,
1708 plane_req->src_y >> 16,
1709 ((plane_req->src_y & 0xffff) * 15625) >> 10);
1710 ret = -ENOSPC;
1711 goto out;
1712 }
1713
1714 /* Give drivers some help against integer overflows */
1715 if (plane_req->crtc_w > INT_MAX ||
1716 plane_req->crtc_x > INT_MAX - (int32_t) plane_req->crtc_w ||
1717 plane_req->crtc_h > INT_MAX ||
1718 plane_req->crtc_y > INT_MAX - (int32_t) plane_req->crtc_h) {
1719 DRM_DEBUG_KMS("Invalid CRTC coordinates %ux%u+%d+%d\n",
1720 plane_req->crtc_w, plane_req->crtc_h,
1721 plane_req->crtc_x, plane_req->crtc_y);
1722 ret = -ERANGE;
1723 goto out;
1724 }
1725
1726 ret = plane->funcs->update_plane(plane, crtc, fb,
1727 plane_req->crtc_x, plane_req->crtc_y,
1728 plane_req->crtc_w, plane_req->crtc_h,
1729 plane_req->src_x, plane_req->src_y,
1730 plane_req->src_w, plane_req->src_h);
1731 if (!ret) {
1732 plane->crtc = crtc;
1733 plane->fb = fb;
1734 }
1735
1736 out:
1737 mutex_unlock(&dev->mode_config.mutex);
1738
1739 return ret;
1740 }
1741
1742 /**
1743 * drm_mode_setcrtc - set CRTC configuration
1744 * @inode: inode from the ioctl
1745 * @filp: file * from the ioctl
1746 * @cmd: cmd from ioctl
1747 * @arg: arg from ioctl
1748 *
1749 * LOCKING:
1750 * Takes mode config lock.
1751 *
1752 * Build a new CRTC configuration based on user request.
1753 *
1754 * Called by the user via ioctl.
1755 *
1756 * RETURNS:
1757 * Zero on success, errno on failure.
1758 */
1759 int drm_mode_setcrtc(struct drm_device *dev, void *data,
1760 struct drm_file *file_priv)
1761 {
1762 struct drm_mode_config *config = &dev->mode_config;
1763 struct drm_mode_crtc *crtc_req = data;
1764 struct drm_mode_object *obj;
1765 struct drm_crtc *crtc;
1766 struct drm_connector **connector_set = NULL, *connector;
1767 struct drm_framebuffer *fb = NULL;
1768 struct drm_display_mode *mode = NULL;
1769 struct drm_mode_set set;
1770 uint32_t __user *set_connectors_ptr;
1771 int ret = 0;
1772 int i;
1773
1774 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1775 return -EINVAL;
1776
1777 /* For some reason crtc x/y offsets are signed internally. */
1778 if (crtc_req->x > INT_MAX || crtc_req->y > INT_MAX)
1779 return -ERANGE;
1780
1781 mutex_lock(&dev->mode_config.mutex);
1782 obj = drm_mode_object_find(dev, crtc_req->crtc_id,
1783 DRM_MODE_OBJECT_CRTC);
1784 if (!obj) {
1785 DRM_DEBUG_KMS("Unknown CRTC ID %d\n", crtc_req->crtc_id);
1786 ret = -EINVAL;
1787 goto out;
1788 }
1789 crtc = obj_to_crtc(obj);
1790 DRM_DEBUG_KMS("[CRTC:%d]\n", crtc->base.id);
1791
1792 if (crtc_req->mode_valid) {
1793 /* If we have a mode we need a framebuffer. */
1794 /* If we pass -1, set the mode with the currently bound fb */
1795 if (crtc_req->fb_id == -1) {
1796 if (!crtc->fb) {
1797 DRM_DEBUG_KMS("CRTC doesn't have current FB\n");
1798 ret = -EINVAL;
1799 goto out;
1800 }
1801 fb = crtc->fb;
1802 } else {
1803 obj = drm_mode_object_find(dev, crtc_req->fb_id,
1804 DRM_MODE_OBJECT_FB);
1805 if (!obj) {
1806 DRM_DEBUG_KMS("Unknown FB ID%d\n",
1807 crtc_req->fb_id);
1808 ret = -EINVAL;
1809 goto out;
1810 }
1811 fb = obj_to_fb(obj);
1812 }
1813
1814 mode = drm_mode_create(dev);
1815 drm_crtc_convert_umode(mode, &crtc_req->mode);
1816 drm_mode_set_crtcinfo(mode, CRTC_INTERLACE_HALVE_V);
1817 }
1818
1819 if (crtc_req->count_connectors == 0 && mode) {
1820 DRM_DEBUG_KMS("Count connectors is 0 but mode set\n");
1821 ret = -EINVAL;
1822 goto out;
1823 }
1824
1825 if (crtc_req->count_connectors > 0 && (!mode || !fb)) {
1826 DRM_DEBUG_KMS("Count connectors is %d but no mode or fb set\n",
1827 crtc_req->count_connectors);
1828 ret = -EINVAL;
1829 goto out;
1830 }
1831
1832 if (crtc_req->count_connectors > 0) {
1833 u32 out_id;
1834
1835 /* Avoid unbounded kernel memory allocation */
1836 if (crtc_req->count_connectors > config->num_connector) {
1837 ret = -EINVAL;
1838 goto out;
1839 }
1840
1841 connector_set = kmalloc(crtc_req->count_connectors *
1842 sizeof(struct drm_connector *),
1843 GFP_KERNEL);
1844 if (!connector_set) {
1845 ret = -ENOMEM;
1846 goto out;
1847 }
1848
1849 for (i = 0; i < crtc_req->count_connectors; i++) {
1850 set_connectors_ptr = (uint32_t __user *)(unsigned long)crtc_req->set_connectors_ptr;
1851 if (get_user(out_id, &set_connectors_ptr[i])) {
1852 ret = -EFAULT;
1853 goto out;
1854 }
1855
1856 obj = drm_mode_object_find(dev, out_id,
1857 DRM_MODE_OBJECT_CONNECTOR);
1858 if (!obj) {
1859 DRM_DEBUG_KMS("Connector id %d unknown\n",
1860 out_id);
1861 ret = -EINVAL;
1862 goto out;
1863 }
1864 connector = obj_to_connector(obj);
1865 DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n",
1866 connector->base.id,
1867 drm_get_connector_name(connector));
1868
1869 connector_set[i] = connector;
1870 }
1871 }
1872
1873 set.crtc = crtc;
1874 set.x = crtc_req->x;
1875 set.y = crtc_req->y;
1876 set.mode = mode;
1877 set.connectors = connector_set;
1878 set.num_connectors = crtc_req->count_connectors;
1879 set.fb = fb;
1880 ret = crtc->funcs->set_config(&set);
1881
1882 out:
1883 kfree(connector_set);
1884 mutex_unlock(&dev->mode_config.mutex);
1885 return ret;
1886 }
1887
1888 int drm_mode_cursor_ioctl(struct drm_device *dev,
1889 void *data, struct drm_file *file_priv)
1890 {
1891 struct drm_mode_cursor *req = data;
1892 struct drm_mode_object *obj;
1893 struct drm_crtc *crtc;
1894 int ret = 0;
1895
1896 if (!drm_core_check_feature(dev, DRIVER_MODESET))
1897 return -EINVAL;
1898
1899 if (!req->flags)
1900 return -EINVAL;
1901
1902 mutex_lock(&dev->mode_config.mutex);
1903 obj = drm_mode_object_find(dev, req->crtc_id, DRM_MODE_OBJECT_CRTC);
1904 if (!obj) {
1905 DRM_DEBUG_KMS("Unknown CRTC ID %d\n", req->crtc_id);
1906 ret = -EINVAL;
1907 goto out;
1908 }
1909 crtc = obj_to_crtc(obj);
1910
1911 if (req->flags & DRM_MODE_CURSOR_BO) {
1912 if (!crtc->funcs->cursor_set) {
1913 ret = -ENXIO;
1914 goto out;
1915 }
1916 /* Turns off the cursor if handle is 0 */
1917 ret = crtc->funcs->cursor_set(crtc, file_priv, req->handle,
1918 req->width, req->height);
1919 }
1920
1921 if (req->flags & DRM_MODE_CURSOR_MOVE) {
1922 if (crtc->funcs->cursor_move) {
1923 ret = crtc->funcs->cursor_move(crtc, req->x, req->y);
1924 } else {
1925 ret = -EFAULT;
1926 goto out;
1927 }
1928 }
1929 out:
1930 mutex_unlock(&dev->mode_config.mutex);
1931 return ret;
1932 }
1933
1934 /* Original addfb only supported RGB formats, so figure out which one */
1935 uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth)
1936 {
1937 uint32_t fmt;
1938
1939 switch (bpp) {
1940 case 8:
1941 fmt = DRM_FORMAT_RGB332;
1942 break;
1943 case 16:
1944 if (depth == 15)
1945 fmt = DRM_FORMAT_XRGB1555;
1946 else
1947 fmt = DRM_FORMAT_RGB565;
1948 break;
1949 case 24:
1950 fmt = DRM_FORMAT_RGB888;
1951 break;
1952 case 32:
1953 if (depth == 24)
1954 fmt = DRM_FORMAT_XRGB8888;
1955 else if (depth == 30)
1956 fmt = DRM_FORMAT_XRGB2101010;
1957 else
1958 fmt = DRM_FORMAT_ARGB8888;
1959 break;
1960 default:
1961 DRM_ERROR("bad bpp, assuming x8r8g8b8 pixel format\n");
1962 fmt = DRM_FORMAT_XRGB8888;
1963 break;
1964 }
1965
1966 return fmt;
1967 }
1968 EXPORT_SYMBOL(drm_mode_legacy_fb_format);
1969
1970 /**
1971 * drm_mode_addfb - add an FB to the graphics configuration
1972 * @inode: inode from the ioctl
1973 * @filp: file * from the ioctl
1974 * @cmd: cmd from ioctl
1975 * @arg: arg from ioctl
1976 *
1977 * LOCKING:
1978 * Takes mode config lock.
1979 *
1980 * Add a new FB to the specified CRTC, given a user request.
1981 *
1982 * Called by the user via ioctl.
1983 *
1984 * RETURNS:
1985 * Zero on success, errno on failure.
1986 */
1987 int drm_mode_addfb(struct drm_device *dev,
1988 void *data, struct drm_file *file_priv)
1989 {
1990 struct drm_mode_fb_cmd *or = data;
1991 struct drm_mode_fb_cmd2 r = {};
1992 struct drm_mode_config *config = &dev->mode_config;
1993 struct drm_framebuffer *fb;
1994 int ret = 0;
1995
1996 /* Use new struct with format internally */
1997 r.fb_id = or->fb_id;
1998 r.width = or->width;
1999 r.height = or->height;
2000 r.pitches[0] = or->pitch;
2001 r.pixel_format = drm_mode_legacy_fb_format(or->bpp, or->depth);
2002 r.handles[0] = or->handle;
2003
2004 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2005 return -EINVAL;
2006
2007 if ((config->min_width > r.width) || (r.width > config->max_width))
2008 return -EINVAL;
2009
2010 if ((config->min_height > r.height) || (r.height > config->max_height))
2011 return -EINVAL;
2012
2013 mutex_lock(&dev->mode_config.mutex);
2014
2015 /* TODO check buffer is sufficiently large */
2016 /* TODO setup destructor callback */
2017
2018 fb = dev->mode_config.funcs->fb_create(dev, file_priv, &r);
2019 if (IS_ERR(fb)) {
2020 DRM_ERROR("could not create framebuffer\n");
2021 ret = PTR_ERR(fb);
2022 goto out;
2023 }
2024
2025 or->fb_id = fb->base.id;
2026 list_add(&fb->filp_head, &file_priv->fbs);
2027 DRM_DEBUG_KMS("[FB:%d]\n", fb->base.id);
2028
2029 out:
2030 mutex_unlock(&dev->mode_config.mutex);
2031 return ret;
2032 }
2033
2034 static int format_check(struct drm_mode_fb_cmd2 *r)
2035 {
2036 uint32_t format = r->pixel_format & ~DRM_FORMAT_BIG_ENDIAN;
2037
2038 switch (format) {
2039 case DRM_FORMAT_C8:
2040 case DRM_FORMAT_RGB332:
2041 case DRM_FORMAT_BGR233:
2042 case DRM_FORMAT_XRGB4444:
2043 case DRM_FORMAT_XBGR4444:
2044 case DRM_FORMAT_RGBX4444:
2045 case DRM_FORMAT_BGRX4444:
2046 case DRM_FORMAT_ARGB4444:
2047 case DRM_FORMAT_ABGR4444:
2048 case DRM_FORMAT_RGBA4444:
2049 case DRM_FORMAT_BGRA4444:
2050 case DRM_FORMAT_XRGB1555:
2051 case DRM_FORMAT_XBGR1555:
2052 case DRM_FORMAT_RGBX5551:
2053 case DRM_FORMAT_BGRX5551:
2054 case DRM_FORMAT_ARGB1555:
2055 case DRM_FORMAT_ABGR1555:
2056 case DRM_FORMAT_RGBA5551:
2057 case DRM_FORMAT_BGRA5551:
2058 case DRM_FORMAT_RGB565:
2059 case DRM_FORMAT_BGR565:
2060 case DRM_FORMAT_RGB888:
2061 case DRM_FORMAT_BGR888:
2062 case DRM_FORMAT_XRGB8888:
2063 case DRM_FORMAT_XBGR8888:
2064 case DRM_FORMAT_RGBX8888:
2065 case DRM_FORMAT_BGRX8888:
2066 case DRM_FORMAT_ARGB8888:
2067 case DRM_FORMAT_ABGR8888:
2068 case DRM_FORMAT_RGBA8888:
2069 case DRM_FORMAT_BGRA8888:
2070 case DRM_FORMAT_XRGB2101010:
2071 case DRM_FORMAT_XBGR2101010:
2072 case DRM_FORMAT_RGBX1010102:
2073 case DRM_FORMAT_BGRX1010102:
2074 case DRM_FORMAT_ARGB2101010:
2075 case DRM_FORMAT_ABGR2101010:
2076 case DRM_FORMAT_RGBA1010102:
2077 case DRM_FORMAT_BGRA1010102:
2078 case DRM_FORMAT_YUYV:
2079 case DRM_FORMAT_YVYU:
2080 case DRM_FORMAT_UYVY:
2081 case DRM_FORMAT_VYUY:
2082 case DRM_FORMAT_AYUV:
2083 case DRM_FORMAT_NV12:
2084 case DRM_FORMAT_NV21:
2085 case DRM_FORMAT_NV16:
2086 case DRM_FORMAT_NV61:
2087 case DRM_FORMAT_YUV410:
2088 case DRM_FORMAT_YVU410:
2089 case DRM_FORMAT_YUV411:
2090 case DRM_FORMAT_YVU411:
2091 case DRM_FORMAT_YUV420:
2092 case DRM_FORMAT_YVU420:
2093 case DRM_FORMAT_YUV422:
2094 case DRM_FORMAT_YVU422:
2095 case DRM_FORMAT_YUV444:
2096 case DRM_FORMAT_YVU444:
2097 return 0;
2098 default:
2099 return -EINVAL;
2100 }
2101 }
2102
2103 /**
2104 * drm_mode_addfb2 - add an FB to the graphics configuration
2105 * @inode: inode from the ioctl
2106 * @filp: file * from the ioctl
2107 * @cmd: cmd from ioctl
2108 * @arg: arg from ioctl
2109 *
2110 * LOCKING:
2111 * Takes mode config lock.
2112 *
2113 * Add a new FB to the specified CRTC, given a user request with format.
2114 *
2115 * Called by the user via ioctl.
2116 *
2117 * RETURNS:
2118 * Zero on success, errno on failure.
2119 */
2120 int drm_mode_addfb2(struct drm_device *dev,
2121 void *data, struct drm_file *file_priv)
2122 {
2123 struct drm_mode_fb_cmd2 *r = data;
2124 struct drm_mode_config *config = &dev->mode_config;
2125 struct drm_framebuffer *fb;
2126 int ret = 0;
2127
2128 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2129 return -EINVAL;
2130
2131 if ((config->min_width > r->width) || (r->width > config->max_width)) {
2132 DRM_ERROR("bad framebuffer width %d, should be >= %d && <= %d\n",
2133 r->width, config->min_width, config->max_width);
2134 return -EINVAL;
2135 }
2136 if ((config->min_height > r->height) || (r->height > config->max_height)) {
2137 DRM_ERROR("bad framebuffer height %d, should be >= %d && <= %d\n",
2138 r->height, config->min_height, config->max_height);
2139 return -EINVAL;
2140 }
2141
2142 ret = format_check(r);
2143 if (ret) {
2144 DRM_ERROR("bad framebuffer format 0x%08x\n", r->pixel_format);
2145 return ret;
2146 }
2147
2148 mutex_lock(&dev->mode_config.mutex);
2149
2150 fb = dev->mode_config.funcs->fb_create(dev, file_priv, r);
2151 if (IS_ERR(fb)) {
2152 DRM_ERROR("could not create framebuffer\n");
2153 ret = PTR_ERR(fb);
2154 goto out;
2155 }
2156
2157 r->fb_id = fb->base.id;
2158 list_add(&fb->filp_head, &file_priv->fbs);
2159 DRM_DEBUG_KMS("[FB:%d]\n", fb->base.id);
2160
2161 out:
2162 mutex_unlock(&dev->mode_config.mutex);
2163 return ret;
2164 }
2165
2166 /**
2167 * drm_mode_rmfb - remove an FB from the configuration
2168 * @inode: inode from the ioctl
2169 * @filp: file * from the ioctl
2170 * @cmd: cmd from ioctl
2171 * @arg: arg from ioctl
2172 *
2173 * LOCKING:
2174 * Takes mode config lock.
2175 *
2176 * Remove the FB specified by the user.
2177 *
2178 * Called by the user via ioctl.
2179 *
2180 * RETURNS:
2181 * Zero on success, errno on failure.
2182 */
2183 int drm_mode_rmfb(struct drm_device *dev,
2184 void *data, struct drm_file *file_priv)
2185 {
2186 struct drm_mode_object *obj;
2187 struct drm_framebuffer *fb = NULL;
2188 struct drm_framebuffer *fbl = NULL;
2189 uint32_t *id = data;
2190 int ret = 0;
2191 int found = 0;
2192
2193 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2194 return -EINVAL;
2195
2196 mutex_lock(&dev->mode_config.mutex);
2197 obj = drm_mode_object_find(dev, *id, DRM_MODE_OBJECT_FB);
2198 /* TODO check that we really get a framebuffer back. */
2199 if (!obj) {
2200 ret = -EINVAL;
2201 goto out;
2202 }
2203 fb = obj_to_fb(obj);
2204
2205 list_for_each_entry(fbl, &file_priv->fbs, filp_head)
2206 if (fb == fbl)
2207 found = 1;
2208
2209 if (!found) {
2210 ret = -EINVAL;
2211 goto out;
2212 }
2213
2214 /* TODO release all crtc connected to the framebuffer */
2215 /* TODO unhock the destructor from the buffer object */
2216
2217 list_del(&fb->filp_head);
2218 fb->funcs->destroy(fb);
2219
2220 out:
2221 mutex_unlock(&dev->mode_config.mutex);
2222 return ret;
2223 }
2224
2225 /**
2226 * drm_mode_getfb - get FB info
2227 * @inode: inode from the ioctl
2228 * @filp: file * from the ioctl
2229 * @cmd: cmd from ioctl
2230 * @arg: arg from ioctl
2231 *
2232 * LOCKING:
2233 * Takes mode config lock.
2234 *
2235 * Lookup the FB given its ID and return info about it.
2236 *
2237 * Called by the user via ioctl.
2238 *
2239 * RETURNS:
2240 * Zero on success, errno on failure.
2241 */
2242 int drm_mode_getfb(struct drm_device *dev,
2243 void *data, struct drm_file *file_priv)
2244 {
2245 struct drm_mode_fb_cmd *r = data;
2246 struct drm_mode_object *obj;
2247 struct drm_framebuffer *fb;
2248 int ret = 0;
2249
2250 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2251 return -EINVAL;
2252
2253 mutex_lock(&dev->mode_config.mutex);
2254 obj = drm_mode_object_find(dev, r->fb_id, DRM_MODE_OBJECT_FB);
2255 if (!obj) {
2256 ret = -EINVAL;
2257 goto out;
2258 }
2259 fb = obj_to_fb(obj);
2260
2261 r->height = fb->height;
2262 r->width = fb->width;
2263 r->depth = fb->depth;
2264 r->bpp = fb->bits_per_pixel;
2265 r->pitch = fb->pitches[0];
2266 fb->funcs->create_handle(fb, file_priv, &r->handle);
2267
2268 out:
2269 mutex_unlock(&dev->mode_config.mutex);
2270 return ret;
2271 }
2272
2273 int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
2274 void *data, struct drm_file *file_priv)
2275 {
2276 struct drm_clip_rect __user *clips_ptr;
2277 struct drm_clip_rect *clips = NULL;
2278 struct drm_mode_fb_dirty_cmd *r = data;
2279 struct drm_mode_object *obj;
2280 struct drm_framebuffer *fb;
2281 unsigned flags;
2282 int num_clips;
2283 int ret = 0;
2284
2285 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2286 return -EINVAL;
2287
2288 mutex_lock(&dev->mode_config.mutex);
2289 obj = drm_mode_object_find(dev, r->fb_id, DRM_MODE_OBJECT_FB);
2290 if (!obj) {
2291 ret = -EINVAL;
2292 goto out_err1;
2293 }
2294 fb = obj_to_fb(obj);
2295
2296 num_clips = r->num_clips;
2297 clips_ptr = (struct drm_clip_rect __user *)(unsigned long)r->clips_ptr;
2298
2299 if (!num_clips != !clips_ptr) {
2300 ret = -EINVAL;
2301 goto out_err1;
2302 }
2303
2304 flags = DRM_MODE_FB_DIRTY_FLAGS & r->flags;
2305
2306 /* If userspace annotates copy, clips must come in pairs */
2307 if (flags & DRM_MODE_FB_DIRTY_ANNOTATE_COPY && (num_clips % 2)) {
2308 ret = -EINVAL;
2309 goto out_err1;
2310 }
2311
2312 if (num_clips && clips_ptr) {
2313 if (num_clips < 0 || num_clips > DRM_MODE_FB_DIRTY_MAX_CLIPS) {
2314 ret = -EINVAL;
2315 goto out_err1;
2316 }
2317 clips = kzalloc(num_clips * sizeof(*clips), GFP_KERNEL);
2318 if (!clips) {
2319 ret = -ENOMEM;
2320 goto out_err1;
2321 }
2322
2323 ret = copy_from_user(clips, clips_ptr,
2324 num_clips * sizeof(*clips));
2325 if (ret) {
2326 ret = -EFAULT;
2327 goto out_err2;
2328 }
2329 }
2330
2331 if (fb->funcs->dirty) {
2332 ret = fb->funcs->dirty(fb, file_priv, flags, r->color,
2333 clips, num_clips);
2334 } else {
2335 ret = -ENOSYS;
2336 goto out_err2;
2337 }
2338
2339 out_err2:
2340 kfree(clips);
2341 out_err1:
2342 mutex_unlock(&dev->mode_config.mutex);
2343 return ret;
2344 }
2345
2346
2347 /**
2348 * drm_fb_release - remove and free the FBs on this file
2349 * @filp: file * from the ioctl
2350 *
2351 * LOCKING:
2352 * Takes mode config lock.
2353 *
2354 * Destroy all the FBs associated with @filp.
2355 *
2356 * Called by the user via ioctl.
2357 *
2358 * RETURNS:
2359 * Zero on success, errno on failure.
2360 */
2361 void drm_fb_release(struct drm_file *priv)
2362 {
2363 struct drm_device *dev = priv->minor->dev;
2364 struct drm_framebuffer *fb, *tfb;
2365
2366 mutex_lock(&dev->mode_config.mutex);
2367 list_for_each_entry_safe(fb, tfb, &priv->fbs, filp_head) {
2368 list_del(&fb->filp_head);
2369 fb->funcs->destroy(fb);
2370 }
2371 mutex_unlock(&dev->mode_config.mutex);
2372 }
2373
2374 /**
2375 * drm_mode_attachmode - add a mode to the user mode list
2376 * @dev: DRM device
2377 * @connector: connector to add the mode to
2378 * @mode: mode to add
2379 *
2380 * Add @mode to @connector's user mode list.
2381 */
2382 static void drm_mode_attachmode(struct drm_device *dev,
2383 struct drm_connector *connector,
2384 struct drm_display_mode *mode)
2385 {
2386 list_add_tail(&mode->head, &connector->user_modes);
2387 }
2388
2389 int drm_mode_attachmode_crtc(struct drm_device *dev, struct drm_crtc *crtc,
2390 struct drm_display_mode *mode)
2391 {
2392 struct drm_connector *connector;
2393 struct drm_display_mode *dup_mode;
2394 int need_dup = 0;
2395 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
2396 if (!connector->encoder)
2397 break;
2398 if (connector->encoder->crtc == crtc) {
2399 if (need_dup)
2400 dup_mode = drm_mode_duplicate(dev, mode);
2401 else
2402 dup_mode = mode;
2403 drm_mode_attachmode(dev, connector, dup_mode);
2404 need_dup = 1;
2405 }
2406 }
2407 return 0;
2408 }
2409 EXPORT_SYMBOL(drm_mode_attachmode_crtc);
2410
2411 static int drm_mode_detachmode(struct drm_device *dev,
2412 struct drm_connector *connector,
2413 struct drm_display_mode *mode)
2414 {
2415 int found = 0;
2416 int ret = 0;
2417 struct drm_display_mode *match_mode, *t;
2418
2419 list_for_each_entry_safe(match_mode, t, &connector->user_modes, head) {
2420 if (drm_mode_equal(match_mode, mode)) {
2421 list_del(&match_mode->head);
2422 drm_mode_destroy(dev, match_mode);
2423 found = 1;
2424 break;
2425 }
2426 }
2427
2428 if (!found)
2429 ret = -EINVAL;
2430
2431 return ret;
2432 }
2433
2434 int drm_mode_detachmode_crtc(struct drm_device *dev, struct drm_display_mode *mode)
2435 {
2436 struct drm_connector *connector;
2437
2438 list_for_each_entry(connector, &dev->mode_config.connector_list, head) {
2439 drm_mode_detachmode(dev, connector, mode);
2440 }
2441 return 0;
2442 }
2443 EXPORT_SYMBOL(drm_mode_detachmode_crtc);
2444
2445 /**
2446 * drm_fb_attachmode - Attach a user mode to an connector
2447 * @inode: inode from the ioctl
2448 * @filp: file * from the ioctl
2449 * @cmd: cmd from ioctl
2450 * @arg: arg from ioctl
2451 *
2452 * This attaches a user specified mode to an connector.
2453 * Called by the user via ioctl.
2454 *
2455 * RETURNS:
2456 * Zero on success, errno on failure.
2457 */
2458 int drm_mode_attachmode_ioctl(struct drm_device *dev,
2459 void *data, struct drm_file *file_priv)
2460 {
2461 struct drm_mode_mode_cmd *mode_cmd = data;
2462 struct drm_connector *connector;
2463 struct drm_display_mode *mode;
2464 struct drm_mode_object *obj;
2465 struct drm_mode_modeinfo *umode = &mode_cmd->mode;
2466 int ret = 0;
2467
2468 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2469 return -EINVAL;
2470
2471 mutex_lock(&dev->mode_config.mutex);
2472
2473 obj = drm_mode_object_find(dev, mode_cmd->connector_id, DRM_MODE_OBJECT_CONNECTOR);
2474 if (!obj) {
2475 ret = -EINVAL;
2476 goto out;
2477 }
2478 connector = obj_to_connector(obj);
2479
2480 mode = drm_mode_create(dev);
2481 if (!mode) {
2482 ret = -ENOMEM;
2483 goto out;
2484 }
2485
2486 drm_crtc_convert_umode(mode, umode);
2487
2488 drm_mode_attachmode(dev, connector, mode);
2489 out:
2490 mutex_unlock(&dev->mode_config.mutex);
2491 return ret;
2492 }
2493
2494
2495 /**
2496 * drm_fb_detachmode - Detach a user specified mode from an connector
2497 * @inode: inode from the ioctl
2498 * @filp: file * from the ioctl
2499 * @cmd: cmd from ioctl
2500 * @arg: arg from ioctl
2501 *
2502 * Called by the user via ioctl.
2503 *
2504 * RETURNS:
2505 * Zero on success, errno on failure.
2506 */
2507 int drm_mode_detachmode_ioctl(struct drm_device *dev,
2508 void *data, struct drm_file *file_priv)
2509 {
2510 struct drm_mode_object *obj;
2511 struct drm_mode_mode_cmd *mode_cmd = data;
2512 struct drm_connector *connector;
2513 struct drm_display_mode mode;
2514 struct drm_mode_modeinfo *umode = &mode_cmd->mode;
2515 int ret = 0;
2516
2517 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2518 return -EINVAL;
2519
2520 mutex_lock(&dev->mode_config.mutex);
2521
2522 obj = drm_mode_object_find(dev, mode_cmd->connector_id, DRM_MODE_OBJECT_CONNECTOR);
2523 if (!obj) {
2524 ret = -EINVAL;
2525 goto out;
2526 }
2527 connector = obj_to_connector(obj);
2528
2529 drm_crtc_convert_umode(&mode, umode);
2530 ret = drm_mode_detachmode(dev, connector, &mode);
2531 out:
2532 mutex_unlock(&dev->mode_config.mutex);
2533 return ret;
2534 }
2535
2536 struct drm_property *drm_property_create(struct drm_device *dev, int flags,
2537 const char *name, int num_values)
2538 {
2539 struct drm_property *property = NULL;
2540
2541 property = kzalloc(sizeof(struct drm_property), GFP_KERNEL);
2542 if (!property)
2543 return NULL;
2544
2545 if (num_values) {
2546 property->values = kzalloc(sizeof(uint64_t)*num_values, GFP_KERNEL);
2547 if (!property->values)
2548 goto fail;
2549 }
2550
2551 drm_mode_object_get(dev, &property->base, DRM_MODE_OBJECT_PROPERTY);
2552 property->flags = flags;
2553 property->num_values = num_values;
2554 INIT_LIST_HEAD(&property->enum_blob_list);
2555
2556 if (name) {
2557 strncpy(property->name, name, DRM_PROP_NAME_LEN);
2558 property->name[DRM_PROP_NAME_LEN-1] = '\0';
2559 }
2560
2561 list_add_tail(&property->head, &dev->mode_config.property_list);
2562 return property;
2563 fail:
2564 kfree(property);
2565 return NULL;
2566 }
2567 EXPORT_SYMBOL(drm_property_create);
2568
2569 struct drm_property *drm_property_create_enum(struct drm_device *dev, int flags,
2570 const char *name,
2571 const struct drm_prop_enum_list *props,
2572 int num_values)
2573 {
2574 struct drm_property *property;
2575 int i, ret;
2576
2577 flags |= DRM_MODE_PROP_ENUM;
2578
2579 property = drm_property_create(dev, flags, name, num_values);
2580 if (!property)
2581 return NULL;
2582
2583 for (i = 0; i < num_values; i++) {
2584 ret = drm_property_add_enum(property, i,
2585 props[i].type,
2586 props[i].name);
2587 if (ret) {
2588 drm_property_destroy(dev, property);
2589 return NULL;
2590 }
2591 }
2592
2593 return property;
2594 }
2595 EXPORT_SYMBOL(drm_property_create_enum);
2596
2597 struct drm_property *drm_property_create_range(struct drm_device *dev, int flags,
2598 const char *name,
2599 uint64_t min, uint64_t max)
2600 {
2601 struct drm_property *property;
2602
2603 flags |= DRM_MODE_PROP_RANGE;
2604
2605 property = drm_property_create(dev, flags, name, 2);
2606 if (!property)
2607 return NULL;
2608
2609 property->values[0] = min;
2610 property->values[1] = max;
2611
2612 return property;
2613 }
2614 EXPORT_SYMBOL(drm_property_create_range);
2615
2616 int drm_property_add_enum(struct drm_property *property, int index,
2617 uint64_t value, const char *name)
2618 {
2619 struct drm_property_enum *prop_enum;
2620
2621 if (!(property->flags & DRM_MODE_PROP_ENUM))
2622 return -EINVAL;
2623
2624 if (!list_empty(&property->enum_blob_list)) {
2625 list_for_each_entry(prop_enum, &property->enum_blob_list, head) {
2626 if (prop_enum->value == value) {
2627 strncpy(prop_enum->name, name, DRM_PROP_NAME_LEN);
2628 prop_enum->name[DRM_PROP_NAME_LEN-1] = '\0';
2629 return 0;
2630 }
2631 }
2632 }
2633
2634 prop_enum = kzalloc(sizeof(struct drm_property_enum), GFP_KERNEL);
2635 if (!prop_enum)
2636 return -ENOMEM;
2637
2638 strncpy(prop_enum->name, name, DRM_PROP_NAME_LEN);
2639 prop_enum->name[DRM_PROP_NAME_LEN-1] = '\0';
2640 prop_enum->value = value;
2641
2642 property->values[index] = value;
2643 list_add_tail(&prop_enum->head, &property->enum_blob_list);
2644 return 0;
2645 }
2646 EXPORT_SYMBOL(drm_property_add_enum);
2647
2648 void drm_property_destroy(struct drm_device *dev, struct drm_property *property)
2649 {
2650 struct drm_property_enum *prop_enum, *pt;
2651
2652 list_for_each_entry_safe(prop_enum, pt, &property->enum_blob_list, head) {
2653 list_del(&prop_enum->head);
2654 kfree(prop_enum);
2655 }
2656
2657 if (property->num_values)
2658 kfree(property->values);
2659 drm_mode_object_put(dev, &property->base);
2660 list_del(&property->head);
2661 kfree(property);
2662 }
2663 EXPORT_SYMBOL(drm_property_destroy);
2664
2665 int drm_connector_attach_property(struct drm_connector *connector,
2666 struct drm_property *property, uint64_t init_val)
2667 {
2668 int i;
2669
2670 for (i = 0; i < DRM_CONNECTOR_MAX_PROPERTY; i++) {
2671 if (connector->property_ids[i] == 0) {
2672 connector->property_ids[i] = property->base.id;
2673 connector->property_values[i] = init_val;
2674 break;
2675 }
2676 }
2677
2678 if (i == DRM_CONNECTOR_MAX_PROPERTY)
2679 return -EINVAL;
2680 return 0;
2681 }
2682 EXPORT_SYMBOL(drm_connector_attach_property);
2683
2684 int drm_connector_property_set_value(struct drm_connector *connector,
2685 struct drm_property *property, uint64_t value)
2686 {
2687 int i;
2688
2689 for (i = 0; i < DRM_CONNECTOR_MAX_PROPERTY; i++) {
2690 if (connector->property_ids[i] == property->base.id) {
2691 connector->property_values[i] = value;
2692 break;
2693 }
2694 }
2695
2696 if (i == DRM_CONNECTOR_MAX_PROPERTY)
2697 return -EINVAL;
2698 return 0;
2699 }
2700 EXPORT_SYMBOL(drm_connector_property_set_value);
2701
2702 int drm_connector_property_get_value(struct drm_connector *connector,
2703 struct drm_property *property, uint64_t *val)
2704 {
2705 int i;
2706
2707 for (i = 0; i < DRM_CONNECTOR_MAX_PROPERTY; i++) {
2708 if (connector->property_ids[i] == property->base.id) {
2709 *val = connector->property_values[i];
2710 break;
2711 }
2712 }
2713
2714 if (i == DRM_CONNECTOR_MAX_PROPERTY)
2715 return -EINVAL;
2716 return 0;
2717 }
2718 EXPORT_SYMBOL(drm_connector_property_get_value);
2719
2720 int drm_mode_getproperty_ioctl(struct drm_device *dev,
2721 void *data, struct drm_file *file_priv)
2722 {
2723 struct drm_mode_object *obj;
2724 struct drm_mode_get_property *out_resp = data;
2725 struct drm_property *property;
2726 int enum_count = 0;
2727 int blob_count = 0;
2728 int value_count = 0;
2729 int ret = 0, i;
2730 int copied;
2731 struct drm_property_enum *prop_enum;
2732 struct drm_mode_property_enum __user *enum_ptr;
2733 struct drm_property_blob *prop_blob;
2734 uint32_t __user *blob_id_ptr;
2735 uint64_t __user *values_ptr;
2736 uint32_t __user *blob_length_ptr;
2737
2738 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2739 return -EINVAL;
2740
2741 mutex_lock(&dev->mode_config.mutex);
2742 obj = drm_mode_object_find(dev, out_resp->prop_id, DRM_MODE_OBJECT_PROPERTY);
2743 if (!obj) {
2744 ret = -EINVAL;
2745 goto done;
2746 }
2747 property = obj_to_property(obj);
2748
2749 if (property->flags & DRM_MODE_PROP_ENUM) {
2750 list_for_each_entry(prop_enum, &property->enum_blob_list, head)
2751 enum_count++;
2752 } else if (property->flags & DRM_MODE_PROP_BLOB) {
2753 list_for_each_entry(prop_blob, &property->enum_blob_list, head)
2754 blob_count++;
2755 }
2756
2757 value_count = property->num_values;
2758
2759 strncpy(out_resp->name, property->name, DRM_PROP_NAME_LEN);
2760 out_resp->name[DRM_PROP_NAME_LEN-1] = 0;
2761 out_resp->flags = property->flags;
2762
2763 if ((out_resp->count_values >= value_count) && value_count) {
2764 values_ptr = (uint64_t __user *)(unsigned long)out_resp->values_ptr;
2765 for (i = 0; i < value_count; i++) {
2766 if (copy_to_user(values_ptr + i, &property->values[i], sizeof(uint64_t))) {
2767 ret = -EFAULT;
2768 goto done;
2769 }
2770 }
2771 }
2772 out_resp->count_values = value_count;
2773
2774 if (property->flags & DRM_MODE_PROP_ENUM) {
2775 if ((out_resp->count_enum_blobs >= enum_count) && enum_count) {
2776 copied = 0;
2777 enum_ptr = (struct drm_mode_property_enum __user *)(unsigned long)out_resp->enum_blob_ptr;
2778 list_for_each_entry(prop_enum, &property->enum_blob_list, head) {
2779
2780 if (copy_to_user(&enum_ptr[copied].value, &prop_enum->value, sizeof(uint64_t))) {
2781 ret = -EFAULT;
2782 goto done;
2783 }
2784
2785 if (copy_to_user(&enum_ptr[copied].name,
2786 &prop_enum->name, DRM_PROP_NAME_LEN)) {
2787 ret = -EFAULT;
2788 goto done;
2789 }
2790 copied++;
2791 }
2792 }
2793 out_resp->count_enum_blobs = enum_count;
2794 }
2795
2796 if (property->flags & DRM_MODE_PROP_BLOB) {
2797 if ((out_resp->count_enum_blobs >= blob_count) && blob_count) {
2798 copied = 0;
2799 blob_id_ptr = (uint32_t __user *)(unsigned long)out_resp->enum_blob_ptr;
2800 blob_length_ptr = (uint32_t __user *)(unsigned long)out_resp->values_ptr;
2801
2802 list_for_each_entry(prop_blob, &property->enum_blob_list, head) {
2803 if (put_user(prop_blob->base.id, blob_id_ptr + copied)) {
2804 ret = -EFAULT;
2805 goto done;
2806 }
2807
2808 if (put_user(prop_blob->length, blob_length_ptr + copied)) {
2809 ret = -EFAULT;
2810 goto done;
2811 }
2812
2813 copied++;
2814 }
2815 }
2816 out_resp->count_enum_blobs = blob_count;
2817 }
2818 done:
2819 mutex_unlock(&dev->mode_config.mutex);
2820 return ret;
2821 }
2822
2823 static struct drm_property_blob *drm_property_create_blob(struct drm_device *dev, int length,
2824 void *data)
2825 {
2826 struct drm_property_blob *blob;
2827
2828 if (!length || !data)
2829 return NULL;
2830
2831 blob = kzalloc(sizeof(struct drm_property_blob)+length, GFP_KERNEL);
2832 if (!blob)
2833 return NULL;
2834
2835 blob->data = (void *)((char *)blob + sizeof(struct drm_property_blob));
2836 blob->length = length;
2837
2838 memcpy(blob->data, data, length);
2839
2840 drm_mode_object_get(dev, &blob->base, DRM_MODE_OBJECT_BLOB);
2841
2842 list_add_tail(&blob->head, &dev->mode_config.property_blob_list);
2843 return blob;
2844 }
2845
2846 static void drm_property_destroy_blob(struct drm_device *dev,
2847 struct drm_property_blob *blob)
2848 {
2849 drm_mode_object_put(dev, &blob->base);
2850 list_del(&blob->head);
2851 kfree(blob);
2852 }
2853
2854 int drm_mode_getblob_ioctl(struct drm_device *dev,
2855 void *data, struct drm_file *file_priv)
2856 {
2857 struct drm_mode_object *obj;
2858 struct drm_mode_get_blob *out_resp = data;
2859 struct drm_property_blob *blob;
2860 int ret = 0;
2861 void __user *blob_ptr;
2862
2863 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2864 return -EINVAL;
2865
2866 mutex_lock(&dev->mode_config.mutex);
2867 obj = drm_mode_object_find(dev, out_resp->blob_id, DRM_MODE_OBJECT_BLOB);
2868 if (!obj) {
2869 ret = -EINVAL;
2870 goto done;
2871 }
2872 blob = obj_to_blob(obj);
2873
2874 if (out_resp->length == blob->length) {
2875 blob_ptr = (void __user *)(unsigned long)out_resp->data;
2876 if (copy_to_user(blob_ptr, blob->data, blob->length)){
2877 ret = -EFAULT;
2878 goto done;
2879 }
2880 }
2881 out_resp->length = blob->length;
2882
2883 done:
2884 mutex_unlock(&dev->mode_config.mutex);
2885 return ret;
2886 }
2887
2888 int drm_mode_connector_update_edid_property(struct drm_connector *connector,
2889 struct edid *edid)
2890 {
2891 struct drm_device *dev = connector->dev;
2892 int ret = 0, size;
2893
2894 if (connector->edid_blob_ptr)
2895 drm_property_destroy_blob(dev, connector->edid_blob_ptr);
2896
2897 /* Delete edid, when there is none. */
2898 if (!edid) {
2899 connector->edid_blob_ptr = NULL;
2900 ret = drm_connector_property_set_value(connector, dev->mode_config.edid_property, 0);
2901 return ret;
2902 }
2903
2904 size = EDID_LENGTH * (1 + edid->extensions);
2905 connector->edid_blob_ptr = drm_property_create_blob(connector->dev,
2906 size, edid);
2907
2908 ret = drm_connector_property_set_value(connector,
2909 dev->mode_config.edid_property,
2910 connector->edid_blob_ptr->base.id);
2911
2912 return ret;
2913 }
2914 EXPORT_SYMBOL(drm_mode_connector_update_edid_property);
2915
2916 int drm_mode_connector_property_set_ioctl(struct drm_device *dev,
2917 void *data, struct drm_file *file_priv)
2918 {
2919 struct drm_mode_connector_set_property *out_resp = data;
2920 struct drm_mode_object *obj;
2921 struct drm_property *property;
2922 struct drm_connector *connector;
2923 int ret = -EINVAL;
2924 int i;
2925
2926 if (!drm_core_check_feature(dev, DRIVER_MODESET))
2927 return -EINVAL;
2928
2929 mutex_lock(&dev->mode_config.mutex);
2930
2931 obj = drm_mode_object_find(dev, out_resp->connector_id, DRM_MODE_OBJECT_CONNECTOR);
2932 if (!obj) {
2933 goto out;
2934 }
2935 connector = obj_to_connector(obj);
2936
2937 for (i = 0; i < DRM_CONNECTOR_MAX_PROPERTY; i++) {
2938 if (connector->property_ids[i] == out_resp->prop_id)
2939 break;
2940 }
2941
2942 if (i == DRM_CONNECTOR_MAX_PROPERTY) {
2943 goto out;
2944 }
2945
2946 obj = drm_mode_object_find(dev, out_resp->prop_id, DRM_MODE_OBJECT_PROPERTY);
2947 if (!obj) {
2948 goto out;
2949 }
2950 property = obj_to_property(obj);
2951
2952 if (property->flags & DRM_MODE_PROP_IMMUTABLE)
2953 goto out;
2954
2955 if (property->flags & DRM_MODE_PROP_RANGE) {
2956 if (out_resp->value < property->values[0])
2957 goto out;
2958
2959 if (out_resp->value > property->values[1])
2960 goto out;
2961 } else {
2962 int found = 0;
2963 for (i = 0; i < property->num_values; i++) {
2964 if (property->values[i] == out_resp->value) {
2965 found = 1;
2966 break;
2967 }
2968 }
2969 if (!found) {
2970 goto out;
2971 }
2972 }
2973
2974 /* Do DPMS ourselves */
2975 if (property == connector->dev->mode_config.dpms_property) {
2976 if (connector->funcs->dpms)
2977 (*connector->funcs->dpms)(connector, (int) out_resp->value);
2978 ret = 0;
2979 } else if (connector->funcs->set_property)
2980 ret = connector->funcs->set_property(connector, property, out_resp->value);
2981
2982 /* store the property value if successful */
2983 if (!ret)
2984 drm_connector_property_set_value(connector, property, out_resp->value);
2985 out:
2986 mutex_unlock(&dev->mode_config.mutex);
2987 return ret;
2988 }
2989
2990 int drm_mode_connector_attach_encoder(struct drm_connector *connector,
2991 struct drm_encoder *encoder)
2992 {
2993 int i;
2994
2995 for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
2996 if (connector->encoder_ids[i] == 0) {
2997 connector->encoder_ids[i] = encoder->base.id;
2998 return 0;
2999 }
3000 }
3001 return -ENOMEM;
3002 }
3003 EXPORT_SYMBOL(drm_mode_connector_attach_encoder);
3004
3005 void drm_mode_connector_detach_encoder(struct drm_connector *connector,
3006 struct drm_encoder *encoder)
3007 {
3008 int i;
3009 for (i = 0; i < DRM_CONNECTOR_MAX_ENCODER; i++) {
3010 if (connector->encoder_ids[i] == encoder->base.id) {
3011 connector->encoder_ids[i] = 0;
3012 if (connector->encoder == encoder)
3013 connector->encoder = NULL;
3014 break;
3015 }
3016 }
3017 }
3018 EXPORT_SYMBOL(drm_mode_connector_detach_encoder);
3019
3020 int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
3021 int gamma_size)
3022 {
3023 crtc->gamma_size = gamma_size;
3024
3025 crtc->gamma_store = kzalloc(gamma_size * sizeof(uint16_t) * 3, GFP_KERNEL);
3026 if (!crtc->gamma_store) {
3027 crtc->gamma_size = 0;
3028 return -ENOMEM;
3029 }
3030
3031 return 0;
3032 }
3033 EXPORT_SYMBOL(drm_mode_crtc_set_gamma_size);
3034
3035 int drm_mode_gamma_set_ioctl(struct drm_device *dev,
3036 void *data, struct drm_file *file_priv)
3037 {
3038 struct drm_mode_crtc_lut *crtc_lut = data;
3039 struct drm_mode_object *obj;
3040 struct drm_crtc *crtc;
3041 void *r_base, *g_base, *b_base;
3042 int size;
3043 int ret = 0;
3044
3045 if (!drm_core_check_feature(dev, DRIVER_MODESET))
3046 return -EINVAL;
3047
3048 mutex_lock(&dev->mode_config.mutex);
3049 obj = drm_mode_object_find(dev, crtc_lut->crtc_id, DRM_MODE_OBJECT_CRTC);
3050 if (!obj) {
3051 ret = -EINVAL;
3052 goto out;
3053 }
3054 crtc = obj_to_crtc(obj);
3055
3056 /* memcpy into gamma store */
3057 if (crtc_lut->gamma_size != crtc->gamma_size) {
3058 ret = -EINVAL;
3059 goto out;
3060 }
3061
3062 size = crtc_lut->gamma_size * (sizeof(uint16_t));
3063 r_base = crtc->gamma_store;
3064 if (copy_from_user(r_base, (void __user *)(unsigned long)crtc_lut->red, size)) {
3065 ret = -EFAULT;
3066 goto out;
3067 }
3068
3069 g_base = r_base + size;
3070 if (copy_from_user(g_base, (void __user *)(unsigned long)crtc_lut->green, size)) {
3071 ret = -EFAULT;
3072 goto out;
3073 }
3074
3075 b_base = g_base + size;
3076 if (copy_from_user(b_base, (void __user *)(unsigned long)crtc_lut->blue, size)) {
3077 ret = -EFAULT;
3078 goto out;
3079 }
3080
3081 crtc->funcs->gamma_set(crtc, r_base, g_base, b_base, 0, crtc->gamma_size);
3082
3083 out:
3084 mutex_unlock(&dev->mode_config.mutex);
3085 return ret;
3086
3087 }
3088
3089 int drm_mode_gamma_get_ioctl(struct drm_device *dev,
3090 void *data, struct drm_file *file_priv)
3091 {
3092 struct drm_mode_crtc_lut *crtc_lut = data;
3093 struct drm_mode_object *obj;
3094 struct drm_crtc *crtc;
3095 void *r_base, *g_base, *b_base;
3096 int size;
3097 int ret = 0;
3098
3099 if (!drm_core_check_feature(dev, DRIVER_MODESET))
3100 return -EINVAL;
3101
3102 mutex_lock(&dev->mode_config.mutex);
3103 obj = drm_mode_object_find(dev, crtc_lut->crtc_id, DRM_MODE_OBJECT_CRTC);
3104 if (!obj) {
3105 ret = -EINVAL;
3106 goto out;
3107 }
3108 crtc = obj_to_crtc(obj);
3109
3110 /* memcpy into gamma store */
3111 if (crtc_lut->gamma_size != crtc->gamma_size) {
3112 ret = -EINVAL;
3113 goto out;
3114 }
3115
3116 size = crtc_lut->gamma_size * (sizeof(uint16_t));
3117 r_base = crtc->gamma_store;
3118 if (copy_to_user((void __user *)(unsigned long)crtc_lut->red, r_base, size)) {
3119 ret = -EFAULT;
3120 goto out;
3121 }
3122
3123 g_base = r_base + size;
3124 if (copy_to_user((void __user *)(unsigned long)crtc_lut->green, g_base, size)) {
3125 ret = -EFAULT;
3126 goto out;
3127 }
3128
3129 b_base = g_base + size;
3130 if (copy_to_user((void __user *)(unsigned long)crtc_lut->blue, b_base, size)) {
3131 ret = -EFAULT;
3132 goto out;
3133 }
3134 out:
3135 mutex_unlock(&dev->mode_config.mutex);
3136 return ret;
3137 }
3138
3139 int drm_mode_page_flip_ioctl(struct drm_device *dev,
3140 void *data, struct drm_file *file_priv)
3141 {
3142 struct drm_mode_crtc_page_flip *page_flip = data;
3143 struct drm_mode_object *obj;
3144 struct drm_crtc *crtc;
3145 struct drm_framebuffer *fb;
3146 struct drm_pending_vblank_event *e = NULL;
3147 unsigned long flags;
3148 int ret = -EINVAL;
3149
3150 if (page_flip->flags & ~DRM_MODE_PAGE_FLIP_FLAGS ||
3151 page_flip->reserved != 0)
3152 return -EINVAL;
3153
3154 mutex_lock(&dev->mode_config.mutex);
3155 obj = drm_mode_object_find(dev, page_flip->crtc_id, DRM_MODE_OBJECT_CRTC);
3156 if (!obj)
3157 goto out;
3158 crtc = obj_to_crtc(obj);
3159
3160 if (crtc->fb == NULL) {
3161 /* The framebuffer is currently unbound, presumably
3162 * due to a hotplug event, that userspace has not
3163 * yet discovered.
3164 */
3165 ret = -EBUSY;
3166 goto out;
3167 }
3168
3169 if (crtc->funcs->page_flip == NULL)
3170 goto out;
3171
3172 obj = drm_mode_object_find(dev, page_flip->fb_id, DRM_MODE_OBJECT_FB);
3173 if (!obj)
3174 goto out;
3175 fb = obj_to_fb(obj);
3176
3177 if (page_flip->flags & DRM_MODE_PAGE_FLIP_EVENT) {
3178 ret = -ENOMEM;
3179 spin_lock_irqsave(&dev->event_lock, flags);
3180 if (file_priv->event_space < sizeof e->event) {
3181 spin_unlock_irqrestore(&dev->event_lock, flags);
3182 goto out;
3183 }
3184 file_priv->event_space -= sizeof e->event;
3185 spin_unlock_irqrestore(&dev->event_lock, flags);
3186
3187 e = kzalloc(sizeof *e, GFP_KERNEL);
3188 if (e == NULL) {
3189 spin_lock_irqsave(&dev->event_lock, flags);
3190 file_priv->event_space += sizeof e->event;
3191 spin_unlock_irqrestore(&dev->event_lock, flags);
3192 goto out;
3193 }
3194
3195 e->event.base.type = DRM_EVENT_FLIP_COMPLETE;
3196 e->event.base.length = sizeof e->event;
3197 e->event.user_data = page_flip->user_data;
3198 e->base.event = &e->event.base;
3199 e->base.file_priv = file_priv;
3200 e->base.destroy =
3201 (void (*) (struct drm_pending_event *)) kfree;
3202 }
3203
3204 ret = crtc->funcs->page_flip(crtc, fb, e);
3205 if (ret) {
3206 spin_lock_irqsave(&dev->event_lock, flags);
3207 file_priv->event_space += sizeof e->event;
3208 spin_unlock_irqrestore(&dev->event_lock, flags);
3209 kfree(e);
3210 }
3211
3212 out:
3213 mutex_unlock(&dev->mode_config.mutex);
3214 return ret;
3215 }
3216
3217 void drm_mode_config_reset(struct drm_device *dev)
3218 {
3219 struct drm_crtc *crtc;
3220 struct drm_encoder *encoder;
3221 struct drm_connector *connector;
3222
3223 list_for_each_entry(crtc, &dev->mode_config.crtc_list, head)
3224 if (crtc->funcs->reset)
3225 crtc->funcs->reset(crtc);
3226
3227 list_for_each_entry(encoder, &dev->mode_config.encoder_list, head)
3228 if (encoder->funcs->reset)
3229 encoder->funcs->reset(encoder);
3230
3231 list_for_each_entry(connector, &dev->mode_config.connector_list, head)
3232 if (connector->funcs->reset)
3233 connector->funcs->reset(connector);
3234 }
3235 EXPORT_SYMBOL(drm_mode_config_reset);
3236
3237 int drm_mode_create_dumb_ioctl(struct drm_device *dev,
3238 void *data, struct drm_file *file_priv)
3239 {
3240 struct drm_mode_create_dumb *args = data;
3241
3242 if (!dev->driver->dumb_create)
3243 return -ENOSYS;
3244 return dev->driver->dumb_create(file_priv, dev, args);
3245 }
3246
3247 int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
3248 void *data, struct drm_file *file_priv)
3249 {
3250 struct drm_mode_map_dumb *args = data;
3251
3252 /* call driver ioctl to get mmap offset */
3253 if (!dev->driver->dumb_map_offset)
3254 return -ENOSYS;
3255
3256 return dev->driver->dumb_map_offset(file_priv, dev, args->handle, &args->offset);
3257 }
3258
3259 int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
3260 void *data, struct drm_file *file_priv)
3261 {
3262 struct drm_mode_destroy_dumb *args = data;
3263
3264 if (!dev->driver->dumb_destroy)
3265 return -ENOSYS;
3266
3267 return dev->driver->dumb_destroy(file_priv, dev, args->handle);
3268 }
3269
3270 /*
3271 * Just need to support RGB formats here for compat with code that doesn't
3272 * use pixel formats directly yet.
3273 */
3274 void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
3275 int *bpp)
3276 {
3277 switch (format) {
3278 case DRM_FORMAT_RGB332:
3279 case DRM_FORMAT_BGR233:
3280 *depth = 8;
3281 *bpp = 8;
3282 break;
3283 case DRM_FORMAT_XRGB1555:
3284 case DRM_FORMAT_XBGR1555:
3285 case DRM_FORMAT_RGBX5551:
3286 case DRM_FORMAT_BGRX5551:
3287 case DRM_FORMAT_ARGB1555:
3288 case DRM_FORMAT_ABGR1555:
3289 case DRM_FORMAT_RGBA5551:
3290 case DRM_FORMAT_BGRA5551:
3291 *depth = 15;
3292 *bpp = 16;
3293 break;
3294 case DRM_FORMAT_RGB565:
3295 case DRM_FORMAT_BGR565:
3296 *depth = 16;
3297 *bpp = 16;
3298 break;
3299 case DRM_FORMAT_RGB888:
3300 case DRM_FORMAT_BGR888:
3301 *depth = 24;
3302 *bpp = 24;
3303 break;
3304 case DRM_FORMAT_XRGB8888:
3305 case DRM_FORMAT_XBGR8888:
3306 case DRM_FORMAT_RGBX8888:
3307 case DRM_FORMAT_BGRX8888:
3308 *depth = 24;
3309 *bpp = 32;
3310 break;
3311 case DRM_FORMAT_XRGB2101010:
3312 case DRM_FORMAT_XBGR2101010:
3313 case DRM_FORMAT_RGBX1010102:
3314 case DRM_FORMAT_BGRX1010102:
3315 case DRM_FORMAT_ARGB2101010:
3316 case DRM_FORMAT_ABGR2101010:
3317 case DRM_FORMAT_RGBA1010102:
3318 case DRM_FORMAT_BGRA1010102:
3319 *depth = 30;
3320 *bpp = 32;
3321 break;
3322 case DRM_FORMAT_ARGB8888:
3323 case DRM_FORMAT_ABGR8888:
3324 case DRM_FORMAT_RGBA8888:
3325 case DRM_FORMAT_BGRA8888:
3326 *depth = 32;
3327 *bpp = 32;
3328 break;
3329 default:
3330 DRM_DEBUG_KMS("unsupported pixel format\n");
3331 *depth = 0;
3332 *bpp = 0;
3333 break;
3334 }
3335 }
3336 EXPORT_SYMBOL(drm_fb_get_bpp_depth);
This page took 0.107519 seconds and 5 git commands to generate.