1/*
2 * Copyright (c) 2016 Intel Corporation
3 *
4 * Permission to use, copy, modify, distribute, and sell this software and its
5 * documentation for any purpose is hereby granted without fee, provided that
6 * the above copyright notice appear in all copies and that both that copyright
7 * notice and this permission notice appear in supporting documentation, and
8 * that the name of the copyright holders not be used in advertising or
9 * publicity pertaining to distribution of the software without specific,
10 * written prior permission. The copyright holders make no representations
11 * about the suitability of this software for any purpose. It is provided "as
12 * is" without express or implied warranty.
13 *
14 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
15 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
16 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
17 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
18 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
19 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
20 * OF THIS SOFTWARE.
21 */
22
23#include <linux/export.h>
24#include <linux/uaccess.h>
25
26#include <drm/drm_atomic.h>
27#include <drm/drm_drv.h>
28#include <drm/drm_device.h>
29#include <drm/drm_file.h>
30#include <drm/drm_mode_object.h>
31#include <drm/drm_print.h>
32
33#include "drm_crtc_internal.h"
34
35/*
36 * Internal function to assign a slot in the object idr and optionally
37 * register the object into the idr.
38 */
39int __drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj,
40 uint32_t obj_type, bool register_obj,
41 void (*obj_free_cb)(struct kref *kref))
42{
43 int ret;
44
45 WARN_ON(!dev->driver->load && dev->registered && !obj_free_cb);
46
47 mutex_lock(&dev->mode_config.idr_mutex);
48 ret = idr_alloc(&dev->mode_config.object_idr, ptr: register_obj ? obj : NULL,
49 start: 1, end: 0, GFP_KERNEL);
50 if (ret >= 0) {
51 /*
52 * Set up the object linking under the protection of the idr
53 * lock so that other users can't see inconsistent state.
54 */
55 obj->id = ret;
56 obj->type = obj_type;
57 if (obj_free_cb) {
58 obj->free_cb = obj_free_cb;
59 kref_init(kref: &obj->refcount);
60 }
61 }
62 mutex_unlock(lock: &dev->mode_config.idr_mutex);
63
64 return ret < 0 ? ret : 0;
65}
66
67/**
68 * drm_mode_object_add - allocate a new modeset identifier
69 * @dev: DRM device
70 * @obj: object pointer, used to generate unique ID
71 * @obj_type: object type
72 *
73 * Create a unique identifier based on @ptr in @dev's identifier space. Used
74 * for tracking modes, CRTCs and connectors.
75 *
76 * Returns:
77 * Zero on success, error code on failure.
78 */
79int drm_mode_object_add(struct drm_device *dev,
80 struct drm_mode_object *obj, uint32_t obj_type)
81{
82 return __drm_mode_object_add(dev, obj, obj_type, register_obj: true, NULL);
83}
84EXPORT_SYMBOL_FOR_TESTS_ONLY(drm_mode_object_add);
85
86void drm_mode_object_register(struct drm_device *dev,
87 struct drm_mode_object *obj)
88{
89 mutex_lock(&dev->mode_config.idr_mutex);
90 idr_replace(&dev->mode_config.object_idr, obj, id: obj->id);
91 mutex_unlock(lock: &dev->mode_config.idr_mutex);
92}
93
94/**
95 * drm_mode_object_unregister - free a modeset identifier
96 * @dev: DRM device
97 * @object: object to free
98 *
99 * Free @id from @dev's unique identifier pool.
100 * This function can be called multiple times, and guards against
101 * multiple removals.
102 * These modeset identifiers are _not_ reference counted. Hence don't use this
103 * for reference counted modeset objects like framebuffers.
104 */
105void drm_mode_object_unregister(struct drm_device *dev,
106 struct drm_mode_object *object)
107{
108 WARN_ON(!dev->driver->load && dev->registered && !object->free_cb);
109
110 mutex_lock(&dev->mode_config.idr_mutex);
111 if (object->id) {
112 idr_remove(&dev->mode_config.object_idr, id: object->id);
113 object->id = 0;
114 }
115 mutex_unlock(lock: &dev->mode_config.idr_mutex);
116}
117
118/**
119 * drm_mode_object_lease_required - check types which must be leased to be used
120 * @type: type of object
121 *
122 * Returns whether the provided type of drm_mode_object must
123 * be owned or leased to be used by a process.
124 */
125bool drm_mode_object_lease_required(uint32_t type)
126{
127 switch(type) {
128 case DRM_MODE_OBJECT_CRTC:
129 case DRM_MODE_OBJECT_CONNECTOR:
130 case DRM_MODE_OBJECT_PLANE:
131 return true;
132 default:
133 return false;
134 }
135}
136
137struct drm_mode_object *__drm_mode_object_find(struct drm_device *dev,
138 struct drm_file *file_priv,
139 uint32_t id, uint32_t type)
140{
141 struct drm_mode_object *obj = NULL;
142
143 mutex_lock(&dev->mode_config.idr_mutex);
144 obj = idr_find(&dev->mode_config.object_idr, id);
145 if (obj && type != DRM_MODE_OBJECT_ANY && obj->type != type)
146 obj = NULL;
147 if (obj && obj->id != id)
148 obj = NULL;
149
150 if (obj && drm_mode_object_lease_required(type: obj->type) &&
151 !_drm_lease_held(file_priv, id: obj->id)) {
152 drm_dbg_kms(dev, "[OBJECT:%d] not included in lease", id);
153 obj = NULL;
154 }
155
156 if (obj && obj->free_cb) {
157 if (!kref_get_unless_zero(kref: &obj->refcount))
158 obj = NULL;
159 }
160 mutex_unlock(lock: &dev->mode_config.idr_mutex);
161
162 return obj;
163}
164
165/**
166 * drm_mode_object_find - look up a drm object with static lifetime
167 * @dev: drm device
168 * @file_priv: drm file
169 * @id: id of the mode object
170 * @type: type of the mode object
171 *
172 * This function is used to look up a modeset object. It will acquire a
173 * reference for reference counted objects. This reference must be dropped again
174 * by callind drm_mode_object_put().
175 */
176struct drm_mode_object *drm_mode_object_find(struct drm_device *dev,
177 struct drm_file *file_priv,
178 uint32_t id, uint32_t type)
179{
180 struct drm_mode_object *obj = NULL;
181
182 obj = __drm_mode_object_find(dev, file_priv, id, type);
183 return obj;
184}
185EXPORT_SYMBOL(drm_mode_object_find);
186
187/**
188 * drm_mode_object_put - release a mode object reference
189 * @obj: DRM mode object
190 *
191 * This function decrements the object's refcount if it is a refcounted modeset
192 * object. It is a no-op on any other object. This is used to drop references
193 * acquired with drm_mode_object_get().
194 */
195void drm_mode_object_put(struct drm_mode_object *obj)
196{
197 if (obj->free_cb) {
198 DRM_DEBUG("OBJ ID: %d (%d)\n", obj->id, kref_read(&obj->refcount));
199 kref_put(kref: &obj->refcount, release: obj->free_cb);
200 }
201}
202EXPORT_SYMBOL(drm_mode_object_put);
203
204/**
205 * drm_mode_object_get - acquire a mode object reference
206 * @obj: DRM mode object
207 *
208 * This function increments the object's refcount if it is a refcounted modeset
209 * object. It is a no-op on any other object. References should be dropped again
210 * by calling drm_mode_object_put().
211 */
212void drm_mode_object_get(struct drm_mode_object *obj)
213{
214 if (obj->free_cb) {
215 DRM_DEBUG("OBJ ID: %d (%d)\n", obj->id, kref_read(&obj->refcount));
216 kref_get(kref: &obj->refcount);
217 }
218}
219EXPORT_SYMBOL(drm_mode_object_get);
220
221/**
222 * drm_object_attach_property - attach a property to a modeset object
223 * @obj: drm modeset object
224 * @property: property to attach
225 * @init_val: initial value of the property
226 *
227 * This attaches the given property to the modeset object with the given initial
228 * value. Currently this function cannot fail since the properties are stored in
229 * a statically sized array.
230 *
231 * Note that all properties must be attached before the object itself is
232 * registered and accessible from userspace.
233 */
234void drm_object_attach_property(struct drm_mode_object *obj,
235 struct drm_property *property,
236 uint64_t init_val)
237{
238 int count = obj->properties->count;
239 struct drm_device *dev = property->dev;
240
241
242 if (obj->type == DRM_MODE_OBJECT_CONNECTOR) {
243 struct drm_connector *connector = obj_to_connector(obj);
244
245 WARN_ON(!dev->driver->load &&
246 connector->registration_state == DRM_CONNECTOR_REGISTERED);
247 } else {
248 WARN_ON(!dev->driver->load && dev->registered);
249 }
250
251 if (count == DRM_OBJECT_MAX_PROPERTY) {
252 WARN(1, "Failed to attach object property (type: 0x%x). Please "
253 "increase DRM_OBJECT_MAX_PROPERTY by 1 for each time "
254 "you see this message on the same object type.\n",
255 obj->type);
256 return;
257 }
258
259 obj->properties->properties[count] = property;
260 obj->properties->values[count] = init_val;
261 obj->properties->count++;
262}
263EXPORT_SYMBOL(drm_object_attach_property);
264
265/**
266 * drm_object_property_set_value - set the value of a property
267 * @obj: drm mode object to set property value for
268 * @property: property to set
269 * @val: value the property should be set to
270 *
271 * This function sets a given property on a given object. This function only
272 * changes the software state of the property, it does not call into the
273 * driver's ->set_property callback.
274 *
275 * Note that atomic drivers should not have any need to call this, the core will
276 * ensure consistency of values reported back to userspace through the
277 * appropriate ->atomic_get_property callback. Only legacy drivers should call
278 * this function to update the tracked value (after clamping and other
279 * restrictions have been applied).
280 *
281 * Returns:
282 * Zero on success, error code on failure.
283 */
284int drm_object_property_set_value(struct drm_mode_object *obj,
285 struct drm_property *property, uint64_t val)
286{
287 int i;
288
289 WARN_ON(drm_drv_uses_atomic_modeset(property->dev) &&
290 !(property->flags & DRM_MODE_PROP_IMMUTABLE));
291
292 for (i = 0; i < obj->properties->count; i++) {
293 if (obj->properties->properties[i] == property) {
294 obj->properties->values[i] = val;
295 return 0;
296 }
297 }
298
299 return -EINVAL;
300}
301EXPORT_SYMBOL(drm_object_property_set_value);
302
303static int __drm_object_property_get_prop_value(struct drm_mode_object *obj,
304 struct drm_property *property,
305 uint64_t *val)
306{
307 int i;
308
309 for (i = 0; i < obj->properties->count; i++) {
310 if (obj->properties->properties[i] == property) {
311 *val = obj->properties->values[i];
312 return 0;
313 }
314 }
315
316 return -EINVAL;
317}
318
319static int __drm_object_property_get_value(struct drm_mode_object *obj,
320 struct drm_property *property,
321 uint64_t *val)
322{
323
324 /* read-only properties bypass atomic mechanism and still store
325 * their value in obj->properties->values[].. mostly to avoid
326 * having to deal w/ EDID and similar props in atomic paths:
327 */
328 if (drm_drv_uses_atomic_modeset(dev: property->dev) &&
329 !(property->flags & DRM_MODE_PROP_IMMUTABLE))
330 return drm_atomic_get_property(obj, property, val);
331
332 return __drm_object_property_get_prop_value(obj, property, val);
333}
334
335/**
336 * drm_object_property_get_value - retrieve the value of a property
337 * @obj: drm mode object to get property value from
338 * @property: property to retrieve
339 * @val: storage for the property value
340 *
341 * This function retrieves the softare state of the given property for the given
342 * property. Since there is no driver callback to retrieve the current property
343 * value this might be out of sync with the hardware, depending upon the driver
344 * and property.
345 *
346 * Atomic drivers should never call this function directly, the core will read
347 * out property values through the various ->atomic_get_property callbacks.
348 *
349 * Returns:
350 * Zero on success, error code on failure.
351 */
352int drm_object_property_get_value(struct drm_mode_object *obj,
353 struct drm_property *property, uint64_t *val)
354{
355 WARN_ON(drm_drv_uses_atomic_modeset(property->dev));
356
357 return __drm_object_property_get_value(obj, property, val);
358}
359EXPORT_SYMBOL(drm_object_property_get_value);
360
361/**
362 * drm_object_property_get_default_value - retrieve the default value of a
363 * property when in atomic mode.
364 * @obj: drm mode object to get property value from
365 * @property: property to retrieve
366 * @val: storage for the property value
367 *
368 * This function retrieves the default state of the given property as passed in
369 * to drm_object_attach_property
370 *
371 * Only atomic drivers should call this function directly, as for non-atomic
372 * drivers it will return the current value.
373 *
374 * Returns:
375 * Zero on success, error code on failure.
376 */
377int drm_object_property_get_default_value(struct drm_mode_object *obj,
378 struct drm_property *property,
379 uint64_t *val)
380{
381 WARN_ON(!drm_drv_uses_atomic_modeset(property->dev));
382
383 return __drm_object_property_get_prop_value(obj, property, val);
384}
385EXPORT_SYMBOL(drm_object_property_get_default_value);
386
387/* helper for getconnector and getproperties ioctls */
388int drm_mode_object_get_properties(struct drm_mode_object *obj, bool atomic,
389 uint32_t __user *prop_ptr,
390 uint64_t __user *prop_values,
391 uint32_t *arg_count_props)
392{
393 int i, ret, count;
394
395 for (i = 0, count = 0; i < obj->properties->count; i++) {
396 struct drm_property *prop = obj->properties->properties[i];
397 uint64_t val;
398
399 if ((prop->flags & DRM_MODE_PROP_ATOMIC) && !atomic)
400 continue;
401
402 if (*arg_count_props > count) {
403 ret = __drm_object_property_get_value(obj, property: prop, val: &val);
404 if (ret)
405 return ret;
406
407 if (put_user(prop->base.id, prop_ptr + count))
408 return -EFAULT;
409
410 if (put_user(val, prop_values + count))
411 return -EFAULT;
412 }
413
414 count++;
415 }
416 *arg_count_props = count;
417
418 return 0;
419}
420
421/**
422 * drm_mode_obj_get_properties_ioctl - get the current value of a object's property
423 * @dev: DRM device
424 * @data: ioctl data
425 * @file_priv: DRM file info
426 *
427 * This function retrieves the current value for an object's property. Compared
428 * to the connector specific ioctl this one is extended to also work on crtc and
429 * plane objects.
430 *
431 * Called by the user via ioctl.
432 *
433 * Returns:
434 * Zero on success, negative errno on failure.
435 */
436int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
437 struct drm_file *file_priv)
438{
439 struct drm_mode_obj_get_properties *arg = data;
440 struct drm_mode_object *obj;
441 struct drm_modeset_acquire_ctx ctx;
442 int ret = 0;
443
444 if (!drm_core_check_feature(dev, feature: DRIVER_MODESET))
445 return -EOPNOTSUPP;
446
447 DRM_MODESET_LOCK_ALL_BEGIN(dev, ctx, 0, ret);
448
449 obj = drm_mode_object_find(dev, file_priv, arg->obj_id, arg->obj_type);
450 if (!obj) {
451 ret = -ENOENT;
452 goto out;
453 }
454 if (!obj->properties) {
455 ret = -EINVAL;
456 goto out_unref;
457 }
458
459 ret = drm_mode_object_get_properties(obj, atomic: file_priv->atomic,
460 prop_ptr: (uint32_t __user *)(unsigned long)(arg->props_ptr),
461 prop_values: (uint64_t __user *)(unsigned long)(arg->prop_values_ptr),
462 arg_count_props: &arg->count_props);
463
464out_unref:
465 drm_mode_object_put(obj);
466out:
467 DRM_MODESET_LOCK_ALL_END(dev, ctx, ret);
468 return ret;
469}
470
471struct drm_property *drm_mode_obj_find_prop_id(struct drm_mode_object *obj,
472 uint32_t prop_id)
473{
474 int i;
475
476 for (i = 0; i < obj->properties->count; i++)
477 if (obj->properties->properties[i]->base.id == prop_id)
478 return obj->properties->properties[i];
479
480 return NULL;
481}
482EXPORT_SYMBOL_FOR_TESTS_ONLY(drm_mode_obj_find_prop_id);
483
484static int set_property_legacy(struct drm_mode_object *obj,
485 struct drm_property *prop,
486 uint64_t prop_value)
487{
488 struct drm_device *dev = prop->dev;
489 struct drm_mode_object *ref;
490 struct drm_modeset_acquire_ctx ctx;
491 int ret = -EINVAL;
492
493 if (!drm_property_change_valid_get(property: prop, value: prop_value, ref: &ref))
494 return -EINVAL;
495
496 DRM_MODESET_LOCK_ALL_BEGIN(dev, ctx, 0, ret);
497 switch (obj->type) {
498 case DRM_MODE_OBJECT_CONNECTOR:
499 ret = drm_connector_set_obj_prop(obj, property: prop, value: prop_value);
500 break;
501 case DRM_MODE_OBJECT_CRTC:
502 ret = drm_mode_crtc_set_obj_prop(obj, property: prop, value: prop_value);
503 break;
504 case DRM_MODE_OBJECT_PLANE:
505 ret = drm_mode_plane_set_obj_prop(obj_to_plane(obj),
506 property: prop, value: prop_value);
507 break;
508 }
509 drm_property_change_valid_put(property: prop, ref);
510 DRM_MODESET_LOCK_ALL_END(dev, ctx, ret);
511
512 return ret;
513}
514
515static int set_property_atomic(struct drm_mode_object *obj,
516 struct drm_file *file_priv,
517 struct drm_property *prop,
518 uint64_t prop_value)
519{
520 struct drm_device *dev = prop->dev;
521 struct drm_atomic_state *state;
522 struct drm_modeset_acquire_ctx ctx;
523 int ret;
524
525 state = drm_atomic_state_alloc(dev);
526 if (!state)
527 return -ENOMEM;
528
529 drm_modeset_acquire_init(ctx: &ctx, flags: 0);
530 state->acquire_ctx = &ctx;
531
532retry:
533 if (prop == state->dev->mode_config.dpms_property) {
534 if (obj->type != DRM_MODE_OBJECT_CONNECTOR) {
535 ret = -EINVAL;
536 goto out;
537 }
538
539 ret = drm_atomic_connector_commit_dpms(state,
540 obj_to_connector(obj),
541 mode: prop_value);
542 } else {
543 ret = drm_atomic_set_property(state, file_priv, obj, prop, prop_value, async_flip: false);
544 if (ret)
545 goto out;
546 ret = drm_atomic_commit(state);
547 }
548out:
549 if (ret == -EDEADLK) {
550 drm_atomic_state_clear(state);
551 drm_modeset_backoff(ctx: &ctx);
552 goto retry;
553 }
554
555 drm_atomic_state_put(state);
556
557 drm_modeset_drop_locks(ctx: &ctx);
558 drm_modeset_acquire_fini(ctx: &ctx);
559
560 return ret;
561}
562
563int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
564 struct drm_file *file_priv)
565{
566 struct drm_mode_obj_set_property *arg = data;
567 struct drm_mode_object *arg_obj;
568 struct drm_property *property;
569 int ret = -EINVAL;
570
571 if (!drm_core_check_feature(dev, feature: DRIVER_MODESET))
572 return -EOPNOTSUPP;
573
574 arg_obj = drm_mode_object_find(dev, file_priv, arg->obj_id, arg->obj_type);
575 if (!arg_obj)
576 return -ENOENT;
577
578 if (!arg_obj->properties)
579 goto out_unref;
580
581 property = drm_mode_obj_find_prop_id(arg_obj, arg->prop_id);
582 if (!property)
583 goto out_unref;
584
585 if (drm_drv_uses_atomic_modeset(dev: property->dev))
586 ret = set_property_atomic(obj: arg_obj, file_priv, prop: property, prop_value: arg->value);
587 else
588 ret = set_property_legacy(obj: arg_obj, prop: property, prop_value: arg->value);
589
590out_unref:
591 drm_mode_object_put(arg_obj);
592 return ret;
593}
594

Provided by KDAB

Privacy Policy
Improve your Profiling and Debugging skills
Find out more

source code of linux/drivers/gpu/drm/drm_mode_object.c