blob: 07bf70121e9ac3af7ebdf1c5784580be278d9c41 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * Created: Fri Jan 19 10:48:35 2001 by faith@acm.org
3 *
4 * Copyright 2001 VA Linux Systems, Inc., Sunnyvale, California.
5 * All Rights Reserved.
6 *
Thierry Redingc6a1af8a2014-05-19 13:39:07 +02007 * Author Rickard E. (Rik) Faith <faith@valinux.com>
8 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
15 *
16 * The above copyright notice and this permission notice (including the next
17 * paragraph) shall be included in all copies or substantial portions of the
18 * Software.
19 *
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
24 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
25 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
26 * DEALINGS IN THE SOFTWARE.
27 */
28
David Herrmann31bbe162014-01-03 14:09:47 +010029#include <linux/fs.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070030#include <linux/module.h>
31#include <linux/moduleparam.h>
David Herrmann31bbe162014-01-03 14:09:47 +010032#include <linux/mount.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090033#include <linux/slab.h>
David Howells760285e2012-10-02 18:01:07 +010034#include <drm/drmP.h>
35#include <drm/drm_core.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070036
Dave Airlieb5e89ed2005-09-25 14:28:13 +100037unsigned int drm_debug = 0; /* 1 to enable debug output */
Linus Torvalds1da177e2005-04-16 15:20:36 -070038EXPORT_SYMBOL(drm_debug);
39
Matt Roper681e7ec2014-04-01 15:22:42 -070040/* 1 to allow user space to request universal planes (experimental) */
41unsigned int drm_universal_planes = 0;
42EXPORT_SYMBOL(drm_universal_planes);
43
Mario Kleiner27641c32010-10-23 04:20:23 +020044unsigned int drm_vblank_offdelay = 5000; /* Default to 5000 msecs. */
45EXPORT_SYMBOL(drm_vblank_offdelay);
46
47unsigned int drm_timestamp_precision = 20; /* Default to 20 usecs. */
48EXPORT_SYMBOL(drm_timestamp_precision);
49
Imre Deakc61eef72012-10-23 18:53:26 +000050/*
51 * Default to use monotonic timestamps for wait-for-vblank and page-flip
52 * complete events.
53 */
54unsigned int drm_timestamp_monotonic = 1;
55
Dave Airlieb5e89ed2005-09-25 14:28:13 +100056MODULE_AUTHOR(CORE_AUTHOR);
57MODULE_DESCRIPTION(CORE_DESC);
Linus Torvalds1da177e2005-04-16 15:20:36 -070058MODULE_LICENSE("GPL and additional rights");
Linus Torvalds1da177e2005-04-16 15:20:36 -070059MODULE_PARM_DESC(debug, "Enable debug output");
Mario Kleiner27641c32010-10-23 04:20:23 +020060MODULE_PARM_DESC(vblankoffdelay, "Delay until vblank irq auto-disable [msecs]");
61MODULE_PARM_DESC(timestamp_precision_usec, "Max. error on timestamps [usecs]");
Imre Deakc61eef72012-10-23 18:53:26 +000062MODULE_PARM_DESC(timestamp_monotonic, "Use monotonic timestamps");
Linus Torvalds1da177e2005-04-16 15:20:36 -070063
Dave Jonesc0758142005-10-03 15:02:20 -040064module_param_named(debug, drm_debug, int, 0600);
Matt Roper681e7ec2014-04-01 15:22:42 -070065module_param_named(universal_planes, drm_universal_planes, int, 0600);
Mario Kleiner27641c32010-10-23 04:20:23 +020066module_param_named(vblankoffdelay, drm_vblank_offdelay, int, 0600);
67module_param_named(timestamp_precision_usec, drm_timestamp_precision, int, 0600);
Imre Deakc61eef72012-10-23 18:53:26 +000068module_param_named(timestamp_monotonic, drm_timestamp_monotonic, int, 0600);
Linus Torvalds1da177e2005-04-16 15:20:36 -070069
David Herrmann0d639882014-02-24 15:53:25 +010070static DEFINE_SPINLOCK(drm_minor_lock);
Dave Airlie2c14f282008-04-21 16:47:32 +100071struct idr drm_minors_idr;
72
Greg Kroah-Hartman0650fd52006-01-20 14:08:59 -080073struct class *drm_class;
Ben Gamari955b12d2009-02-17 20:08:49 -050074struct dentry *drm_debugfs_root;
Joe Perches5ad3d882011-04-17 20:35:51 -070075
76int drm_err(const char *func, const char *format, ...)
77{
78 struct va_format vaf;
79 va_list args;
80 int r;
81
82 va_start(args, format);
83
84 vaf.fmt = format;
85 vaf.va = &args;
86
87 r = printk(KERN_ERR "[" DRM_NAME ":%s] *ERROR* %pV", func, &vaf);
88
89 va_end(args);
90
91 return r;
92}
93EXPORT_SYMBOL(drm_err);
94
Lespiau, Damien1287aa92014-03-24 15:53:17 +000095void drm_ut_debug_printk(const char *function_name, const char *format, ...)
yakui_zhao4fefcb22009-06-02 14:09:47 +080096{
Daniel Vetterfffb9062013-11-17 22:25:02 +010097 struct va_format vaf;
yakui_zhao4fefcb22009-06-02 14:09:47 +080098 va_list args;
Linus Torvalds1da177e2005-04-16 15:20:36 -070099
Lespiau, Damiena73d4e92014-03-24 15:53:15 +0000100 va_start(args, format);
101 vaf.fmt = format;
102 vaf.va = &args;
Daniel Vetterfffb9062013-11-17 22:25:02 +0100103
Lespiau, Damien0ed02982014-03-24 15:53:18 +0000104 printk(KERN_DEBUG "[" DRM_NAME ":%s] %pV", function_name, &vaf);
Lespiau, Damiena73d4e92014-03-24 15:53:15 +0000105
106 va_end(args);
yakui_zhao4fefcb22009-06-02 14:09:47 +0800107}
108EXPORT_SYMBOL(drm_ut_debug_printk);
Joe Perches5ad3d882011-04-17 20:35:51 -0700109
Dave Airlie7c1c2872008-11-28 14:22:24 +1000110struct drm_master *drm_master_create(struct drm_minor *minor)
111{
112 struct drm_master *master;
113
Eric Anholt9a298b22009-03-24 12:23:04 -0700114 master = kzalloc(sizeof(*master), GFP_KERNEL);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000115 if (!master)
116 return NULL;
117
118 kref_init(&master->refcount);
119 spin_lock_init(&master->lock.spinlock);
120 init_waitqueue_head(&master->lock.lock_queue);
Daniel Vetter10e68562014-04-05 11:12:04 +0200121 if (drm_ht_create(&master->magiclist, DRM_MAGIC_HASH_ORDER)) {
122 kfree(master);
123 return NULL;
124 }
Dave Airlie7c1c2872008-11-28 14:22:24 +1000125 INIT_LIST_HEAD(&master->magicfree);
126 master->minor = minor;
127
Dave Airlie7c1c2872008-11-28 14:22:24 +1000128 return master;
129}
130
131struct drm_master *drm_master_get(struct drm_master *master)
132{
133 kref_get(&master->refcount);
134 return master;
135}
Thomas Hellstrom85bb0c32009-12-06 21:46:28 +0100136EXPORT_SYMBOL(drm_master_get);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000137
138static void drm_master_destroy(struct kref *kref)
139{
140 struct drm_master *master = container_of(kref, struct drm_master, refcount);
141 struct drm_magic_entry *pt, *next;
142 struct drm_device *dev = master->minor->dev;
Dave Airliec1ff85d2009-01-19 17:17:58 +1000143 struct drm_map_list *r_list, *list_temp;
Dave Airlie7c1c2872008-11-28 14:22:24 +1000144
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100145 mutex_lock(&dev->struct_mutex);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000146 if (dev->driver->master_destroy)
147 dev->driver->master_destroy(dev, master);
148
Dave Airliec1ff85d2009-01-19 17:17:58 +1000149 list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head) {
150 if (r_list->master == master) {
151 drm_rmmap_locked(dev, r_list->map);
152 r_list = NULL;
153 }
154 }
155
Dave Airlie7c1c2872008-11-28 14:22:24 +1000156 if (master->unique) {
Eric Anholt9a298b22009-03-24 12:23:04 -0700157 kfree(master->unique);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000158 master->unique = NULL;
159 master->unique_len = 0;
160 }
161
162 list_for_each_entry_safe(pt, next, &master->magicfree, head) {
163 list_del(&pt->head);
164 drm_ht_remove_item(&master->magiclist, &pt->hash_item);
Eric Anholt9a298b22009-03-24 12:23:04 -0700165 kfree(pt);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000166 }
167
168 drm_ht_remove(&master->magiclist);
169
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100170 mutex_unlock(&dev->struct_mutex);
Eric Anholt9a298b22009-03-24 12:23:04 -0700171 kfree(master);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000172}
173
174void drm_master_put(struct drm_master **master)
175{
176 kref_put(&(*master)->refcount, drm_master_destroy);
177 *master = NULL;
178}
Thomas Hellstrom85bb0c32009-12-06 21:46:28 +0100179EXPORT_SYMBOL(drm_master_put);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000180
181int drm_setmaster_ioctl(struct drm_device *dev, void *data,
182 struct drm_file *file_priv)
183{
Benjamin Gaignard53ef1602013-06-26 17:58:59 +0200184 int ret = 0;
Thomas Hellstrom862302f2009-12-02 18:15:25 +0000185
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100186 mutex_lock(&dev->master_mutex);
Jonas Bonn6b008422009-04-16 09:00:02 +0200187 if (file_priv->is_master)
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100188 goto out_unlock;
Jonas Bonn6b008422009-04-16 09:00:02 +0200189
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100190 if (file_priv->minor->master) {
191 ret = -EINVAL;
192 goto out_unlock;
193 }
Dave Airlie7c1c2872008-11-28 14:22:24 +1000194
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100195 if (!file_priv->master) {
196 ret = -EINVAL;
197 goto out_unlock;
198 }
Dave Airlie7c1c2872008-11-28 14:22:24 +1000199
David Herrmann08bec5b2012-11-15 13:04:37 +0000200 file_priv->minor->master = drm_master_get(file_priv->master);
201 file_priv->is_master = 1;
202 if (dev->driver->master_set) {
203 ret = dev->driver->master_set(dev, file_priv, false);
204 if (unlikely(ret != 0)) {
205 file_priv->is_master = 0;
206 drm_master_put(&file_priv->minor->master);
Thomas Hellstrom862302f2009-12-02 18:15:25 +0000207 }
Dave Airlie7c1c2872008-11-28 14:22:24 +1000208 }
209
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100210out_unlock:
211 mutex_unlock(&dev->master_mutex);
Benjamin Gaignard53ef1602013-06-26 17:58:59 +0200212 return ret;
Dave Airlie7c1c2872008-11-28 14:22:24 +1000213}
214
215int drm_dropmaster_ioctl(struct drm_device *dev, void *data,
216 struct drm_file *file_priv)
217{
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100218 int ret = -EINVAL;
219
220 mutex_lock(&dev->master_mutex);
Jonas Bonn6b008422009-04-16 09:00:02 +0200221 if (!file_priv->is_master)
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100222 goto out_unlock;
Jonas Bonn6b008422009-04-16 09:00:02 +0200223
Dave Airlie07f1c7a2009-04-20 09:32:50 +1000224 if (!file_priv->minor->master)
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100225 goto out_unlock;
Dave Airlie07f1c7a2009-04-20 09:32:50 +1000226
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100227 ret = 0;
Thomas Hellstrom862302f2009-12-02 18:15:25 +0000228 if (dev->driver->master_drop)
229 dev->driver->master_drop(dev, file_priv, false);
Dave Airlie7c1c2872008-11-28 14:22:24 +1000230 drm_master_put(&file_priv->minor->master);
Jonas Bonn6b008422009-04-16 09:00:02 +0200231 file_priv->is_master = 0;
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100232
233out_unlock:
234 mutex_unlock(&dev->master_mutex);
235 return ret;
Dave Airlie7c1c2872008-11-28 14:22:24 +1000236}
237
David Herrmann0d639882014-02-24 15:53:25 +0100238/*
239 * DRM Minors
240 * A DRM device can provide several char-dev interfaces on the DRM-Major. Each
241 * of them is represented by a drm_minor object. Depending on the capabilities
242 * of the device-driver, different interfaces are registered.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700243 *
David Herrmann0d639882014-02-24 15:53:25 +0100244 * Minors can be accessed via dev->$minor_name. This pointer is either
245 * NULL or a valid drm_minor pointer and stays valid as long as the device is
246 * valid. This means, DRM minors have the same life-time as the underlying
247 * device. However, this doesn't mean that the minor is active. Minors are
248 * registered and unregistered dynamically according to device-state.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700249 */
David Herrmann0d639882014-02-24 15:53:25 +0100250
David Herrmann05b701f2014-01-29 12:43:56 +0100251static struct drm_minor **drm_minor_get_slot(struct drm_device *dev,
252 unsigned int type)
253{
254 switch (type) {
255 case DRM_MINOR_LEGACY:
256 return &dev->primary;
257 case DRM_MINOR_RENDER:
258 return &dev->render;
259 case DRM_MINOR_CONTROL:
260 return &dev->control;
261 default:
262 return NULL;
263 }
264}
265
266static int drm_minor_alloc(struct drm_device *dev, unsigned int type)
267{
268 struct drm_minor *minor;
269
270 minor = kzalloc(sizeof(*minor), GFP_KERNEL);
271 if (!minor)
272 return -ENOMEM;
273
274 minor->type = type;
275 minor->dev = dev;
David Herrmann05b701f2014-01-29 12:43:56 +0100276
277 *drm_minor_get_slot(dev, type) = minor;
278 return 0;
279}
280
David Herrmannbd9dfa92014-01-29 12:55:48 +0100281static void drm_minor_free(struct drm_device *dev, unsigned int type)
282{
283 struct drm_minor **slot;
284
285 slot = drm_minor_get_slot(dev, type);
286 if (*slot) {
Dave Airliead222792014-05-02 13:22:19 +1000287 drm_mode_group_destroy(&(*slot)->mode_group);
David Herrmannbd9dfa92014-01-29 12:55:48 +0100288 kfree(*slot);
289 *slot = NULL;
290 }
291}
292
David Herrmannafcdbc82014-01-29 12:57:05 +0100293static int drm_minor_register(struct drm_device *dev, unsigned int type)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700294{
Dave Airlie2c14f282008-04-21 16:47:32 +1000295 struct drm_minor *new_minor;
David Herrmann0d639882014-02-24 15:53:25 +0100296 unsigned long flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700297 int ret;
Dave Airlie2c14f282008-04-21 16:47:32 +1000298 int minor_id;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700299
300 DRM_DEBUG("\n");
301
David Herrmann05b701f2014-01-29 12:43:56 +0100302 new_minor = *drm_minor_get_slot(dev, type);
303 if (!new_minor)
304 return 0;
305
David Herrmann0d639882014-02-24 15:53:25 +0100306 idr_preload(GFP_KERNEL);
307 spin_lock_irqsave(&drm_minor_lock, flags);
David Herrmann7d86cf12014-02-24 15:35:09 +0100308 minor_id = idr_alloc(&drm_minors_idr,
309 NULL,
310 64 * type,
311 64 * (type + 1),
David Herrmann0d639882014-02-24 15:53:25 +0100312 GFP_NOWAIT);
313 spin_unlock_irqrestore(&drm_minor_lock, flags);
314 idr_preload_end();
David Herrmann7d86cf12014-02-24 15:35:09 +0100315
Dave Airlie2c14f282008-04-21 16:47:32 +1000316 if (minor_id < 0)
317 return minor_id;
Dave Airlieb5e89ed2005-09-25 14:28:13 +1000318
Dave Airlie2c14f282008-04-21 16:47:32 +1000319 new_minor->index = minor_id;
320
Ben Gamari955b12d2009-02-17 20:08:49 -0500321 ret = drm_debugfs_init(new_minor, minor_id, drm_debugfs_root);
322 if (ret) {
GeunSik Lim156f5a72009-06-02 15:01:37 +0900323 DRM_ERROR("DRM: Failed to initialize /sys/kernel/debug/dri.\n");
David Herrmann1abbc432014-02-24 15:32:00 +0100324 goto err_id;
Ben Gamari955b12d2009-02-17 20:08:49 -0500325 }
Dave Airlie2c14f282008-04-21 16:47:32 +1000326
327 ret = drm_sysfs_device_add(new_minor);
328 if (ret) {
David Herrmann1abbc432014-02-24 15:32:00 +0100329 DRM_ERROR("DRM: Error sysfs_device_add.\n");
Daniel Vettercb6458f2013-08-08 15:41:34 +0200330 goto err_debugfs;
Dave Airlie2c14f282008-04-21 16:47:32 +1000331 }
Dave Airlie2c14f282008-04-21 16:47:32 +1000332
David Herrmann0d639882014-02-24 15:53:25 +0100333 /* replace NULL with @minor so lookups will succeed from now on */
334 spin_lock_irqsave(&drm_minor_lock, flags);
335 idr_replace(&drm_minors_idr, new_minor, new_minor->index);
336 spin_unlock_irqrestore(&drm_minor_lock, flags);
Dave Airlie2c14f282008-04-21 16:47:32 +1000337
338 DRM_DEBUG("new minor assigned %d\n", minor_id);
339 return 0;
340
Daniel Vettercb6458f2013-08-08 15:41:34 +0200341err_debugfs:
Daniel Vettercb6458f2013-08-08 15:41:34 +0200342 drm_debugfs_cleanup(new_minor);
David Herrmann1abbc432014-02-24 15:32:00 +0100343err_id:
David Herrmann0d639882014-02-24 15:53:25 +0100344 spin_lock_irqsave(&drm_minor_lock, flags);
Dave Airlie2c14f282008-04-21 16:47:32 +1000345 idr_remove(&drm_minors_idr, minor_id);
David Herrmann0d639882014-02-24 15:53:25 +0100346 spin_unlock_irqrestore(&drm_minor_lock, flags);
347 new_minor->index = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700348 return ret;
349}
Dave Airlieb5e89ed2005-09-25 14:28:13 +1000350
David Herrmannafcdbc82014-01-29 12:57:05 +0100351static void drm_minor_unregister(struct drm_device *dev, unsigned int type)
David Herrmannf73aca52013-10-20 18:55:40 +0200352{
David Herrmannafcdbc82014-01-29 12:57:05 +0100353 struct drm_minor *minor;
David Herrmann0d639882014-02-24 15:53:25 +0100354 unsigned long flags;
David Herrmannafcdbc82014-01-29 12:57:05 +0100355
356 minor = *drm_minor_get_slot(dev, type);
David Herrmanna3483352013-11-13 11:42:26 +0100357 if (!minor || !minor->kdev)
David Herrmannf73aca52013-10-20 18:55:40 +0200358 return;
359
David Herrmann0d639882014-02-24 15:53:25 +0100360 spin_lock_irqsave(&drm_minor_lock, flags);
David Herrmannf67e9462013-10-20 18:55:44 +0200361 idr_remove(&drm_minors_idr, minor->index);
David Herrmann0d639882014-02-24 15:53:25 +0100362 spin_unlock_irqrestore(&drm_minor_lock, flags);
363 minor->index = 0;
364
David Herrmann865fb472013-10-20 18:55:43 +0200365 drm_debugfs_cleanup(minor);
David Herrmann865fb472013-10-20 18:55:43 +0200366 drm_sysfs_device_remove(minor);
David Herrmannf73aca52013-10-20 18:55:40 +0200367}
368
369/**
David Herrmann1616c522014-01-29 10:49:19 +0100370 * drm_minor_acquire - Acquire a DRM minor
371 * @minor_id: Minor ID of the DRM-minor
David Herrmannf73aca52013-10-20 18:55:40 +0200372 *
David Herrmann1616c522014-01-29 10:49:19 +0100373 * Looks up the given minor-ID and returns the respective DRM-minor object. The
374 * refence-count of the underlying device is increased so you must release this
375 * object with drm_minor_release().
376 *
377 * As long as you hold this minor, it is guaranteed that the object and the
378 * minor->dev pointer will stay valid! However, the device may get unplugged and
379 * unregistered while you hold the minor.
380 *
381 * Returns:
382 * Pointer to minor-object with increased device-refcount, or PTR_ERR on
383 * failure.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700384 */
David Herrmann1616c522014-01-29 10:49:19 +0100385struct drm_minor *drm_minor_acquire(unsigned int minor_id)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700386{
David Herrmann1616c522014-01-29 10:49:19 +0100387 struct drm_minor *minor;
David Herrmann0d639882014-02-24 15:53:25 +0100388 unsigned long flags;
Eric Anholt673a3942008-07-30 12:06:12 -0700389
David Herrmann0d639882014-02-24 15:53:25 +0100390 spin_lock_irqsave(&drm_minor_lock, flags);
David Herrmann1616c522014-01-29 10:49:19 +0100391 minor = idr_find(&drm_minors_idr, minor_id);
David Herrmann0d639882014-02-24 15:53:25 +0100392 if (minor)
393 drm_dev_ref(minor->dev);
394 spin_unlock_irqrestore(&drm_minor_lock, flags);
Dave Airlieb5e89ed2005-09-25 14:28:13 +1000395
David Herrmann0d639882014-02-24 15:53:25 +0100396 if (!minor) {
397 return ERR_PTR(-ENODEV);
398 } else if (drm_device_is_unplugged(minor->dev)) {
399 drm_dev_unref(minor->dev);
400 return ERR_PTR(-ENODEV);
401 }
402
David Herrmann1616c522014-01-29 10:49:19 +0100403 return minor;
404}
405
406/**
407 * drm_minor_release - Release DRM minor
408 * @minor: Pointer to DRM minor object
409 *
410 * Release a minor that was previously acquired via drm_minor_acquire().
411 */
412void drm_minor_release(struct drm_minor *minor)
413{
414 drm_dev_unref(minor->dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700415}
Kristian Høgsberg112b7152009-01-04 16:55:33 -0500416
417/**
Thierry Redingc6a1af8a2014-05-19 13:39:07 +0200418 * drm_put_dev - Unregister and release a DRM device
419 * @dev: DRM device
420 *
421 * Called at module unload time or when a PCI device is unplugged.
422 *
423 * Use of this function is discouraged. It will eventually go away completely.
424 * Please use drm_dev_unregister() and drm_dev_unref() explicitly instead.
Kristian Høgsberg112b7152009-01-04 16:55:33 -0500425 *
426 * Cleans up all DRM device, calling drm_lastclose().
Kristian Høgsberg112b7152009-01-04 16:55:33 -0500427 */
428void drm_put_dev(struct drm_device *dev)
429{
Kristian Høgsberg112b7152009-01-04 16:55:33 -0500430 DRM_DEBUG("\n");
431
432 if (!dev) {
433 DRM_ERROR("cleanup called no dev\n");
434 return;
435 }
436
David Herrmannc3a49732013-10-02 11:23:38 +0200437 drm_dev_unregister(dev);
David Herrmann099d1c22014-01-29 10:21:36 +0100438 drm_dev_unref(dev);
Kristian Høgsberg112b7152009-01-04 16:55:33 -0500439}
440EXPORT_SYMBOL(drm_put_dev);
Dave Airlie2c07a212012-02-20 14:18:07 +0000441
442void drm_unplug_dev(struct drm_device *dev)
443{
444 /* for a USB device */
David Herrmannafcdbc82014-01-29 12:57:05 +0100445 drm_minor_unregister(dev, DRM_MINOR_LEGACY);
446 drm_minor_unregister(dev, DRM_MINOR_RENDER);
447 drm_minor_unregister(dev, DRM_MINOR_CONTROL);
Dave Airlie2c07a212012-02-20 14:18:07 +0000448
449 mutex_lock(&drm_global_mutex);
450
451 drm_device_set_unplugged(dev);
452
453 if (dev->open_count == 0) {
454 drm_put_dev(dev);
455 }
456 mutex_unlock(&drm_global_mutex);
457}
458EXPORT_SYMBOL(drm_unplug_dev);
David Herrmann1bb72532013-10-02 11:23:34 +0200459
David Herrmann31bbe162014-01-03 14:09:47 +0100460/*
461 * DRM internal mount
462 * We want to be able to allocate our own "struct address_space" to control
463 * memory-mappings in VRAM (or stolen RAM, ...). However, core MM does not allow
464 * stand-alone address_space objects, so we need an underlying inode. As there
465 * is no way to allocate an independent inode easily, we need a fake internal
466 * VFS mount-point.
467 *
468 * The drm_fs_inode_new() function allocates a new inode, drm_fs_inode_free()
469 * frees it again. You are allowed to use iget() and iput() to get references to
470 * the inode. But each drm_fs_inode_new() call must be paired with exactly one
471 * drm_fs_inode_free() call (which does not have to be the last iput()).
472 * We use drm_fs_inode_*() to manage our internal VFS mount-point and share it
473 * between multiple inode-users. You could, technically, call
474 * iget() + drm_fs_inode_free() directly after alloc and sometime later do an
475 * iput(), but this way you'd end up with a new vfsmount for each inode.
476 */
477
478static int drm_fs_cnt;
479static struct vfsmount *drm_fs_mnt;
480
481static const struct dentry_operations drm_fs_dops = {
482 .d_dname = simple_dname,
483};
484
485static const struct super_operations drm_fs_sops = {
486 .statfs = simple_statfs,
487};
488
489static struct dentry *drm_fs_mount(struct file_system_type *fs_type, int flags,
490 const char *dev_name, void *data)
491{
492 return mount_pseudo(fs_type,
493 "drm:",
494 &drm_fs_sops,
495 &drm_fs_dops,
496 0x010203ff);
497}
498
499static struct file_system_type drm_fs_type = {
500 .name = "drm",
501 .owner = THIS_MODULE,
502 .mount = drm_fs_mount,
503 .kill_sb = kill_anon_super,
504};
505
506static struct inode *drm_fs_inode_new(void)
507{
508 struct inode *inode;
509 int r;
510
511 r = simple_pin_fs(&drm_fs_type, &drm_fs_mnt, &drm_fs_cnt);
512 if (r < 0) {
513 DRM_ERROR("Cannot mount pseudo fs: %d\n", r);
514 return ERR_PTR(r);
515 }
516
517 inode = alloc_anon_inode(drm_fs_mnt->mnt_sb);
518 if (IS_ERR(inode))
519 simple_release_fs(&drm_fs_mnt, &drm_fs_cnt);
520
521 return inode;
522}
523
524static void drm_fs_inode_free(struct inode *inode)
525{
526 if (inode) {
527 iput(inode);
528 simple_release_fs(&drm_fs_mnt, &drm_fs_cnt);
529 }
530}
531
David Herrmann1bb72532013-10-02 11:23:34 +0200532/**
Thierry Redingc6a1af8a2014-05-19 13:39:07 +0200533 * drm_dev_alloc - Allocate new DRM device
David Herrmann1bb72532013-10-02 11:23:34 +0200534 * @driver: DRM driver to allocate device for
535 * @parent: Parent device object
536 *
537 * Allocate and initialize a new DRM device. No device registration is done.
David Herrmannc22f0ac2013-10-02 11:23:35 +0200538 * Call drm_dev_register() to advertice the device to user space and register it
539 * with other core subsystems.
David Herrmann1bb72532013-10-02 11:23:34 +0200540 *
David Herrmann099d1c22014-01-29 10:21:36 +0100541 * The initial ref-count of the object is 1. Use drm_dev_ref() and
542 * drm_dev_unref() to take and drop further ref-counts.
543 *
David Herrmann1bb72532013-10-02 11:23:34 +0200544 * RETURNS:
545 * Pointer to new DRM device, or NULL if out of memory.
546 */
547struct drm_device *drm_dev_alloc(struct drm_driver *driver,
548 struct device *parent)
549{
550 struct drm_device *dev;
551 int ret;
552
553 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
554 if (!dev)
555 return NULL;
556
David Herrmann099d1c22014-01-29 10:21:36 +0100557 kref_init(&dev->ref);
David Herrmann1bb72532013-10-02 11:23:34 +0200558 dev->dev = parent;
559 dev->driver = driver;
560
561 INIT_LIST_HEAD(&dev->filelist);
562 INIT_LIST_HEAD(&dev->ctxlist);
563 INIT_LIST_HEAD(&dev->vmalist);
564 INIT_LIST_HEAD(&dev->maplist);
565 INIT_LIST_HEAD(&dev->vblank_event_list);
566
Daniel Vetter2177a212013-12-16 11:21:06 +0100567 spin_lock_init(&dev->buf_lock);
David Herrmann1bb72532013-10-02 11:23:34 +0200568 spin_lock_init(&dev->event_lock);
569 mutex_init(&dev->struct_mutex);
570 mutex_init(&dev->ctxlist_mutex);
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100571 mutex_init(&dev->master_mutex);
David Herrmann1bb72532013-10-02 11:23:34 +0200572
David Herrmann6796cb12014-01-03 14:24:19 +0100573 dev->anon_inode = drm_fs_inode_new();
574 if (IS_ERR(dev->anon_inode)) {
575 ret = PTR_ERR(dev->anon_inode);
576 DRM_ERROR("Cannot allocate anonymous inode: %d\n", ret);
David Herrmann1bb72532013-10-02 11:23:34 +0200577 goto err_free;
David Herrmann6796cb12014-01-03 14:24:19 +0100578 }
579
David Herrmann05b701f2014-01-29 12:43:56 +0100580 if (drm_core_check_feature(dev, DRIVER_MODESET)) {
581 ret = drm_minor_alloc(dev, DRM_MINOR_CONTROL);
582 if (ret)
583 goto err_minors;
584 }
585
David Herrmann6d6dfcf2014-03-16 14:38:40 +0100586 if (drm_core_check_feature(dev, DRIVER_RENDER)) {
David Herrmann05b701f2014-01-29 12:43:56 +0100587 ret = drm_minor_alloc(dev, DRM_MINOR_RENDER);
588 if (ret)
589 goto err_minors;
590 }
591
592 ret = drm_minor_alloc(dev, DRM_MINOR_LEGACY);
593 if (ret)
594 goto err_minors;
595
David Herrmann6796cb12014-01-03 14:24:19 +0100596 if (drm_ht_create(&dev->map_hash, 12))
David Herrmann05b701f2014-01-29 12:43:56 +0100597 goto err_minors;
David Herrmann1bb72532013-10-02 11:23:34 +0200598
599 ret = drm_ctxbitmap_init(dev);
600 if (ret) {
601 DRM_ERROR("Cannot allocate memory for context bitmap.\n");
602 goto err_ht;
603 }
604
605 if (driver->driver_features & DRIVER_GEM) {
606 ret = drm_gem_init(dev);
607 if (ret) {
608 DRM_ERROR("Cannot initialize graphics execution manager (GEM)\n");
609 goto err_ctxbitmap;
610 }
611 }
612
613 return dev;
614
615err_ctxbitmap:
616 drm_ctxbitmap_cleanup(dev);
617err_ht:
618 drm_ht_remove(&dev->map_hash);
David Herrmann05b701f2014-01-29 12:43:56 +0100619err_minors:
David Herrmannbd9dfa92014-01-29 12:55:48 +0100620 drm_minor_free(dev, DRM_MINOR_LEGACY);
621 drm_minor_free(dev, DRM_MINOR_RENDER);
622 drm_minor_free(dev, DRM_MINOR_CONTROL);
David Herrmann6796cb12014-01-03 14:24:19 +0100623 drm_fs_inode_free(dev->anon_inode);
David Herrmann1bb72532013-10-02 11:23:34 +0200624err_free:
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100625 mutex_destroy(&dev->master_mutex);
David Herrmann1bb72532013-10-02 11:23:34 +0200626 kfree(dev);
627 return NULL;
628}
629EXPORT_SYMBOL(drm_dev_alloc);
David Herrmannc22f0ac2013-10-02 11:23:35 +0200630
David Herrmann099d1c22014-01-29 10:21:36 +0100631static void drm_dev_release(struct kref *ref)
David Herrmann0dc8fe52013-10-02 11:23:37 +0200632{
David Herrmann099d1c22014-01-29 10:21:36 +0100633 struct drm_device *dev = container_of(ref, struct drm_device, ref);
David Herrmann8f6599d2013-10-20 18:55:45 +0200634
David Herrmann0dc8fe52013-10-02 11:23:37 +0200635 if (dev->driver->driver_features & DRIVER_GEM)
636 drm_gem_destroy(dev);
637
638 drm_ctxbitmap_cleanup(dev);
639 drm_ht_remove(&dev->map_hash);
David Herrmann6796cb12014-01-03 14:24:19 +0100640 drm_fs_inode_free(dev->anon_inode);
David Herrmann0dc8fe52013-10-02 11:23:37 +0200641
David Herrmannbd9dfa92014-01-29 12:55:48 +0100642 drm_minor_free(dev, DRM_MINOR_LEGACY);
643 drm_minor_free(dev, DRM_MINOR_RENDER);
644 drm_minor_free(dev, DRM_MINOR_CONTROL);
645
Thomas Hellstromc996fd02014-02-25 19:57:44 +0100646 mutex_destroy(&dev->master_mutex);
Thierry Redingca8e2ad2014-04-11 15:23:00 +0200647 kfree(dev->unique);
David Herrmann0dc8fe52013-10-02 11:23:37 +0200648 kfree(dev);
649}
David Herrmann099d1c22014-01-29 10:21:36 +0100650
651/**
652 * drm_dev_ref - Take reference of a DRM device
653 * @dev: device to take reference of or NULL
654 *
655 * This increases the ref-count of @dev by one. You *must* already own a
656 * reference when calling this. Use drm_dev_unref() to drop this reference
657 * again.
658 *
659 * This function never fails. However, this function does not provide *any*
660 * guarantee whether the device is alive or running. It only provides a
661 * reference to the object and the memory associated with it.
662 */
663void drm_dev_ref(struct drm_device *dev)
664{
665 if (dev)
666 kref_get(&dev->ref);
667}
668EXPORT_SYMBOL(drm_dev_ref);
669
670/**
671 * drm_dev_unref - Drop reference of a DRM device
672 * @dev: device to drop reference of or NULL
673 *
674 * This decreases the ref-count of @dev by one. The device is destroyed if the
675 * ref-count drops to zero.
676 */
677void drm_dev_unref(struct drm_device *dev)
678{
679 if (dev)
680 kref_put(&dev->ref, drm_dev_release);
681}
682EXPORT_SYMBOL(drm_dev_unref);
David Herrmann0dc8fe52013-10-02 11:23:37 +0200683
684/**
David Herrmannc22f0ac2013-10-02 11:23:35 +0200685 * drm_dev_register - Register DRM device
686 * @dev: Device to register
Thierry Redingc6a1af8a2014-05-19 13:39:07 +0200687 * @flags: Flags passed to the driver's .load() function
David Herrmannc22f0ac2013-10-02 11:23:35 +0200688 *
689 * Register the DRM device @dev with the system, advertise device to user-space
690 * and start normal device operation. @dev must be allocated via drm_dev_alloc()
691 * previously.
692 *
693 * Never call this twice on any device!
694 *
695 * RETURNS:
696 * 0 on success, negative error code on failure.
697 */
698int drm_dev_register(struct drm_device *dev, unsigned long flags)
699{
700 int ret;
701
702 mutex_lock(&drm_global_mutex);
703
David Herrmannafcdbc82014-01-29 12:57:05 +0100704 ret = drm_minor_register(dev, DRM_MINOR_CONTROL);
David Herrmannc22f0ac2013-10-02 11:23:35 +0200705 if (ret)
David Herrmann05b701f2014-01-29 12:43:56 +0100706 goto err_minors;
707
David Herrmannafcdbc82014-01-29 12:57:05 +0100708 ret = drm_minor_register(dev, DRM_MINOR_RENDER);
David Herrmann05b701f2014-01-29 12:43:56 +0100709 if (ret)
710 goto err_minors;
711
David Herrmannafcdbc82014-01-29 12:57:05 +0100712 ret = drm_minor_register(dev, DRM_MINOR_LEGACY);
David Herrmann05b701f2014-01-29 12:43:56 +0100713 if (ret)
714 goto err_minors;
David Herrmannc22f0ac2013-10-02 11:23:35 +0200715
716 if (dev->driver->load) {
717 ret = dev->driver->load(dev, flags);
718 if (ret)
David Herrmann05b701f2014-01-29 12:43:56 +0100719 goto err_minors;
David Herrmannc22f0ac2013-10-02 11:23:35 +0200720 }
721
722 /* setup grouping for legacy outputs */
723 if (drm_core_check_feature(dev, DRIVER_MODESET)) {
724 ret = drm_mode_group_init_legacy_group(dev,
725 &dev->primary->mode_group);
726 if (ret)
727 goto err_unload;
728 }
729
David Herrmannc22f0ac2013-10-02 11:23:35 +0200730 ret = 0;
731 goto out_unlock;
732
733err_unload:
734 if (dev->driver->unload)
735 dev->driver->unload(dev);
David Herrmann05b701f2014-01-29 12:43:56 +0100736err_minors:
David Herrmannafcdbc82014-01-29 12:57:05 +0100737 drm_minor_unregister(dev, DRM_MINOR_LEGACY);
738 drm_minor_unregister(dev, DRM_MINOR_RENDER);
739 drm_minor_unregister(dev, DRM_MINOR_CONTROL);
David Herrmannc22f0ac2013-10-02 11:23:35 +0200740out_unlock:
741 mutex_unlock(&drm_global_mutex);
742 return ret;
743}
744EXPORT_SYMBOL(drm_dev_register);
David Herrmannc3a49732013-10-02 11:23:38 +0200745
746/**
747 * drm_dev_unregister - Unregister DRM device
748 * @dev: Device to unregister
749 *
750 * Unregister the DRM device from the system. This does the reverse of
751 * drm_dev_register() but does not deallocate the device. The caller must call
David Herrmann099d1c22014-01-29 10:21:36 +0100752 * drm_dev_unref() to drop their final reference.
David Herrmannc3a49732013-10-02 11:23:38 +0200753 */
754void drm_dev_unregister(struct drm_device *dev)
755{
756 struct drm_map_list *r_list, *list_temp;
757
758 drm_lastclose(dev);
759
760 if (dev->driver->unload)
761 dev->driver->unload(dev);
762
Daniel Vetter4efafeb2013-12-11 11:34:38 +0100763 if (dev->agp)
764 drm_pci_agp_destroy(dev);
David Herrmannc3a49732013-10-02 11:23:38 +0200765
766 drm_vblank_cleanup(dev);
767
768 list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head)
769 drm_rmmap(dev, r_list->map);
770
David Herrmannafcdbc82014-01-29 12:57:05 +0100771 drm_minor_unregister(dev, DRM_MINOR_LEGACY);
772 drm_minor_unregister(dev, DRM_MINOR_RENDER);
773 drm_minor_unregister(dev, DRM_MINOR_CONTROL);
David Herrmannc3a49732013-10-02 11:23:38 +0200774}
775EXPORT_SYMBOL(drm_dev_unregister);
Thierry Redingca8e2ad2014-04-11 15:23:00 +0200776
777/**
778 * drm_dev_set_unique - Set the unique name of a DRM device
779 * @dev: device of which to set the unique name
780 * @fmt: format string for unique name
781 *
782 * Sets the unique name of a DRM device using the specified format string and
783 * a variable list of arguments. Drivers can use this at driver probe time if
784 * the unique name of the devices they drive is static.
785 *
786 * Return: 0 on success or a negative error code on failure.
787 */
788int drm_dev_set_unique(struct drm_device *dev, const char *fmt, ...)
789{
790 va_list ap;
791
792 kfree(dev->unique);
793
794 va_start(ap, fmt);
795 dev->unique = kvasprintf(GFP_KERNEL, fmt, ap);
796 va_end(ap);
797
798 return dev->unique ? 0 : -ENOMEM;
799}
800EXPORT_SYMBOL(drm_dev_set_unique);