121d70354SDave Airlie /* 221d70354SDave Airlie * Created: Fri Jan 19 10:48:35 2001 by faith@acm.org 321d70354SDave Airlie * 421d70354SDave Airlie * Copyright 2001 VA Linux Systems, Inc., Sunnyvale, California. 521d70354SDave Airlie * All Rights Reserved. 621d70354SDave Airlie * 721d70354SDave Airlie * Author Rickard E. (Rik) Faith <faith@valinux.com> 821d70354SDave Airlie * 921d70354SDave Airlie * Permission is hereby granted, free of charge, to any person obtaining a 1021d70354SDave Airlie * copy of this software and associated documentation files (the "Software"), 1121d70354SDave Airlie * to deal in the Software without restriction, including without limitation 1221d70354SDave Airlie * the rights to use, copy, modify, merge, publish, distribute, sublicense, 1321d70354SDave Airlie * and/or sell copies of the Software, and to permit persons to whom the 1421d70354SDave Airlie * Software is furnished to do so, subject to the following conditions: 1521d70354SDave Airlie * 1621d70354SDave Airlie * The above copyright notice and this permission notice (including the next 1721d70354SDave Airlie * paragraph) shall be included in all copies or substantial portions of the 1821d70354SDave Airlie * Software. 1921d70354SDave Airlie * 2021d70354SDave Airlie * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 2121d70354SDave Airlie * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 2221d70354SDave Airlie * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 2321d70354SDave Airlie * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR 2421d70354SDave Airlie * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 2521d70354SDave Airlie * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 2621d70354SDave Airlie * DEALINGS IN THE SOFTWARE. 2721d70354SDave Airlie */ 2821d70354SDave Airlie 2921d70354SDave Airlie #include <linux/debugfs.h> 3021d70354SDave Airlie #include <linux/fs.h> 3121d70354SDave Airlie #include <linux/module.h> 3221d70354SDave Airlie #include <linux/moduleparam.h> 3321d70354SDave Airlie #include <linux/mount.h> 3421d70354SDave Airlie #include <linux/slab.h> 3521d70354SDave Airlie #include <drm/drmP.h> 3621d70354SDave Airlie #include <drm/drm_core.h> 3721d70354SDave Airlie #include "drm_legacy.h" 3867d0ec4eSDaniel Vetter #include "drm_internal.h" 3921d70354SDave Airlie 406dc3e22eSEzequiel Garcia /* 416dc3e22eSEzequiel Garcia * drm_debug: Enable debug output. 426dc3e22eSEzequiel Garcia * Bitmask of DRM_UT_x. See include/drm/drmP.h for details. 436dc3e22eSEzequiel Garcia */ 446dc3e22eSEzequiel Garcia unsigned int drm_debug = 0; 4521d70354SDave Airlie EXPORT_SYMBOL(drm_debug); 4621d70354SDave Airlie 4721d70354SDave Airlie MODULE_AUTHOR(CORE_AUTHOR); 4821d70354SDave Airlie MODULE_DESCRIPTION(CORE_DESC); 4921d70354SDave Airlie MODULE_LICENSE("GPL and additional rights"); 506dc3e22eSEzequiel Garcia MODULE_PARM_DESC(debug, "Enable debug output, where each bit enables a debug category.\n" 516dc3e22eSEzequiel Garcia "\t\tBit 0 (0x01) will enable CORE messages (drm core code)\n" 526dc3e22eSEzequiel Garcia "\t\tBit 1 (0x02) will enable DRIVER messages (drm controller code)\n" 536dc3e22eSEzequiel Garcia "\t\tBit 2 (0x04) will enable KMS messages (modesetting code)\n" 546dc3e22eSEzequiel Garcia "\t\tBit 3 (0x08) will enable PRIME messages (prime code)\n" 556dc3e22eSEzequiel Garcia "\t\tBit 4 (0x10) will enable ATOMIC messages (atomic code)\n" 566dc3e22eSEzequiel Garcia "\t\tBit 5 (0x20) will enable VBL messages (vblank code)"); 5721d70354SDave Airlie module_param_named(debug, drm_debug, int, 0600); 5821d70354SDave Airlie 5921d70354SDave Airlie static DEFINE_SPINLOCK(drm_minor_lock); 6021d70354SDave Airlie static struct idr drm_minors_idr; 6121d70354SDave Airlie 6221d70354SDave Airlie static struct dentry *drm_debugfs_root; 6321d70354SDave Airlie 64a1f1a79cSJoe Perches void drm_err(const char *format, ...) 6521d70354SDave Airlie { 6621d70354SDave Airlie struct va_format vaf; 6721d70354SDave Airlie va_list args; 6821d70354SDave Airlie 6921d70354SDave Airlie va_start(args, format); 7021d70354SDave Airlie 7121d70354SDave Airlie vaf.fmt = format; 7221d70354SDave Airlie vaf.va = &args; 7321d70354SDave Airlie 742ee762b3SScott Wood printk(KERN_ERR "[" DRM_NAME ":%ps] *ERROR* %pV", 75a1f1a79cSJoe Perches __builtin_return_address(0), &vaf); 7621d70354SDave Airlie 7721d70354SDave Airlie va_end(args); 7821d70354SDave Airlie } 7921d70354SDave Airlie EXPORT_SYMBOL(drm_err); 8021d70354SDave Airlie 8121d70354SDave Airlie void drm_ut_debug_printk(const char *function_name, const char *format, ...) 8221d70354SDave Airlie { 8321d70354SDave Airlie struct va_format vaf; 8421d70354SDave Airlie va_list args; 8521d70354SDave Airlie 8621d70354SDave Airlie va_start(args, format); 8721d70354SDave Airlie vaf.fmt = format; 8821d70354SDave Airlie vaf.va = &args; 8921d70354SDave Airlie 9021d70354SDave Airlie printk(KERN_DEBUG "[" DRM_NAME ":%s] %pV", function_name, &vaf); 9121d70354SDave Airlie 9221d70354SDave Airlie va_end(args); 9321d70354SDave Airlie } 9421d70354SDave Airlie EXPORT_SYMBOL(drm_ut_debug_printk); 9521d70354SDave Airlie 9621d70354SDave Airlie struct drm_master *drm_master_create(struct drm_minor *minor) 9721d70354SDave Airlie { 9821d70354SDave Airlie struct drm_master *master; 9921d70354SDave Airlie 10021d70354SDave Airlie master = kzalloc(sizeof(*master), GFP_KERNEL); 10121d70354SDave Airlie if (!master) 10221d70354SDave Airlie return NULL; 10321d70354SDave Airlie 10421d70354SDave Airlie kref_init(&master->refcount); 10521d70354SDave Airlie spin_lock_init(&master->lock.spinlock); 10621d70354SDave Airlie init_waitqueue_head(&master->lock.lock_queue); 10732e7b94aSDavid Herrmann idr_init(&master->magic_map); 10821d70354SDave Airlie master->minor = minor; 10921d70354SDave Airlie 11021d70354SDave Airlie return master; 11121d70354SDave Airlie } 11221d70354SDave Airlie 11321d70354SDave Airlie struct drm_master *drm_master_get(struct drm_master *master) 11421d70354SDave Airlie { 11521d70354SDave Airlie kref_get(&master->refcount); 11621d70354SDave Airlie return master; 11721d70354SDave Airlie } 11821d70354SDave Airlie EXPORT_SYMBOL(drm_master_get); 11921d70354SDave Airlie 12021d70354SDave Airlie static void drm_master_destroy(struct kref *kref) 12121d70354SDave Airlie { 12221d70354SDave Airlie struct drm_master *master = container_of(kref, struct drm_master, refcount); 12321d70354SDave Airlie struct drm_device *dev = master->minor->dev; 12421d70354SDave Airlie 12521d70354SDave Airlie if (dev->driver->master_destroy) 12621d70354SDave Airlie dev->driver->master_destroy(dev, master); 12721d70354SDave Airlie 12840647e45SDaniel Vetter drm_legacy_master_rmmaps(dev, master); 12932e7b94aSDavid Herrmann 13032e7b94aSDavid Herrmann idr_destroy(&master->magic_map); 1314a324d33SDavid Herrmann kfree(master->unique); 13221d70354SDave Airlie kfree(master); 13321d70354SDave Airlie } 13421d70354SDave Airlie 13521d70354SDave Airlie void drm_master_put(struct drm_master **master) 13621d70354SDave Airlie { 13721d70354SDave Airlie kref_put(&(*master)->refcount, drm_master_destroy); 13821d70354SDave Airlie *master = NULL; 13921d70354SDave Airlie } 14021d70354SDave Airlie EXPORT_SYMBOL(drm_master_put); 14121d70354SDave Airlie 14221d70354SDave Airlie int drm_setmaster_ioctl(struct drm_device *dev, void *data, 14321d70354SDave Airlie struct drm_file *file_priv) 14421d70354SDave Airlie { 14521d70354SDave Airlie int ret = 0; 14621d70354SDave Airlie 14721d70354SDave Airlie mutex_lock(&dev->master_mutex); 1487963e9dbSDave Airlie if (file_priv->is_master) 14921d70354SDave Airlie goto out_unlock; 15021d70354SDave Airlie 15121d70354SDave Airlie if (file_priv->minor->master) { 15221d70354SDave Airlie ret = -EINVAL; 15321d70354SDave Airlie goto out_unlock; 15421d70354SDave Airlie } 15521d70354SDave Airlie 15621d70354SDave Airlie if (!file_priv->master) { 15721d70354SDave Airlie ret = -EINVAL; 15821d70354SDave Airlie goto out_unlock; 15921d70354SDave Airlie } 16021d70354SDave Airlie 161a0af2e53SThomas Hellstrom if (!file_priv->allowed_master) { 162a0af2e53SThomas Hellstrom ret = drm_new_set_master(dev, file_priv); 163a0af2e53SThomas Hellstrom goto out_unlock; 164a0af2e53SThomas Hellstrom } 165a0af2e53SThomas Hellstrom 16621d70354SDave Airlie file_priv->minor->master = drm_master_get(file_priv->master); 1677963e9dbSDave Airlie file_priv->is_master = 1; 16821d70354SDave Airlie if (dev->driver->master_set) { 16921d70354SDave Airlie ret = dev->driver->master_set(dev, file_priv, false); 1707963e9dbSDave Airlie if (unlikely(ret != 0)) { 1717963e9dbSDave Airlie file_priv->is_master = 0; 17221d70354SDave Airlie drm_master_put(&file_priv->minor->master); 17321d70354SDave Airlie } 1747963e9dbSDave Airlie } 17521d70354SDave Airlie 17621d70354SDave Airlie out_unlock: 17721d70354SDave Airlie mutex_unlock(&dev->master_mutex); 17821d70354SDave Airlie return ret; 17921d70354SDave Airlie } 18021d70354SDave Airlie 18121d70354SDave Airlie int drm_dropmaster_ioctl(struct drm_device *dev, void *data, 18221d70354SDave Airlie struct drm_file *file_priv) 18321d70354SDave Airlie { 18421d70354SDave Airlie int ret = -EINVAL; 18521d70354SDave Airlie 18621d70354SDave Airlie mutex_lock(&dev->master_mutex); 1877963e9dbSDave Airlie if (!file_priv->is_master) 18821d70354SDave Airlie goto out_unlock; 18921d70354SDave Airlie 19021d70354SDave Airlie if (!file_priv->minor->master) 19121d70354SDave Airlie goto out_unlock; 19221d70354SDave Airlie 19321d70354SDave Airlie ret = 0; 19421d70354SDave Airlie if (dev->driver->master_drop) 19521d70354SDave Airlie dev->driver->master_drop(dev, file_priv, false); 19621d70354SDave Airlie drm_master_put(&file_priv->minor->master); 1977963e9dbSDave Airlie file_priv->is_master = 0; 19821d70354SDave Airlie 19921d70354SDave Airlie out_unlock: 20021d70354SDave Airlie mutex_unlock(&dev->master_mutex); 20121d70354SDave Airlie return ret; 20221d70354SDave Airlie } 20321d70354SDave Airlie 20421d70354SDave Airlie /* 20521d70354SDave Airlie * DRM Minors 20621d70354SDave Airlie * A DRM device can provide several char-dev interfaces on the DRM-Major. Each 20721d70354SDave Airlie * of them is represented by a drm_minor object. Depending on the capabilities 20821d70354SDave Airlie * of the device-driver, different interfaces are registered. 20921d70354SDave Airlie * 21021d70354SDave Airlie * Minors can be accessed via dev->$minor_name. This pointer is either 21121d70354SDave Airlie * NULL or a valid drm_minor pointer and stays valid as long as the device is 21221d70354SDave Airlie * valid. This means, DRM minors have the same life-time as the underlying 21321d70354SDave Airlie * device. However, this doesn't mean that the minor is active. Minors are 21421d70354SDave Airlie * registered and unregistered dynamically according to device-state. 21521d70354SDave Airlie */ 21621d70354SDave Airlie 21721d70354SDave Airlie static struct drm_minor **drm_minor_get_slot(struct drm_device *dev, 21821d70354SDave Airlie unsigned int type) 21921d70354SDave Airlie { 22021d70354SDave Airlie switch (type) { 22121d70354SDave Airlie case DRM_MINOR_LEGACY: 22221d70354SDave Airlie return &dev->primary; 22321d70354SDave Airlie case DRM_MINOR_RENDER: 22421d70354SDave Airlie return &dev->render; 22521d70354SDave Airlie case DRM_MINOR_CONTROL: 22621d70354SDave Airlie return &dev->control; 22721d70354SDave Airlie default: 22821d70354SDave Airlie return NULL; 22921d70354SDave Airlie } 23021d70354SDave Airlie } 23121d70354SDave Airlie 23221d70354SDave Airlie static int drm_minor_alloc(struct drm_device *dev, unsigned int type) 23321d70354SDave Airlie { 23421d70354SDave Airlie struct drm_minor *minor; 23521d70354SDave Airlie unsigned long flags; 23621d70354SDave Airlie int r; 23721d70354SDave Airlie 23821d70354SDave Airlie minor = kzalloc(sizeof(*minor), GFP_KERNEL); 23921d70354SDave Airlie if (!minor) 24021d70354SDave Airlie return -ENOMEM; 24121d70354SDave Airlie 24221d70354SDave Airlie minor->type = type; 24321d70354SDave Airlie minor->dev = dev; 24421d70354SDave Airlie 24521d70354SDave Airlie idr_preload(GFP_KERNEL); 24621d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 24721d70354SDave Airlie r = idr_alloc(&drm_minors_idr, 24821d70354SDave Airlie NULL, 24921d70354SDave Airlie 64 * type, 25021d70354SDave Airlie 64 * (type + 1), 25121d70354SDave Airlie GFP_NOWAIT); 25221d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 25321d70354SDave Airlie idr_preload_end(); 25421d70354SDave Airlie 25521d70354SDave Airlie if (r < 0) 25621d70354SDave Airlie goto err_free; 25721d70354SDave Airlie 25821d70354SDave Airlie minor->index = r; 25921d70354SDave Airlie 26021d70354SDave Airlie minor->kdev = drm_sysfs_minor_alloc(minor); 26121d70354SDave Airlie if (IS_ERR(minor->kdev)) { 26221d70354SDave Airlie r = PTR_ERR(minor->kdev); 26321d70354SDave Airlie goto err_index; 26421d70354SDave Airlie } 26521d70354SDave Airlie 26621d70354SDave Airlie *drm_minor_get_slot(dev, type) = minor; 26721d70354SDave Airlie return 0; 26821d70354SDave Airlie 26921d70354SDave Airlie err_index: 27021d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 27121d70354SDave Airlie idr_remove(&drm_minors_idr, minor->index); 27221d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 27321d70354SDave Airlie err_free: 27421d70354SDave Airlie kfree(minor); 27521d70354SDave Airlie return r; 27621d70354SDave Airlie } 27721d70354SDave Airlie 27821d70354SDave Airlie static void drm_minor_free(struct drm_device *dev, unsigned int type) 27921d70354SDave Airlie { 28021d70354SDave Airlie struct drm_minor **slot, *minor; 28121d70354SDave Airlie unsigned long flags; 28221d70354SDave Airlie 28321d70354SDave Airlie slot = drm_minor_get_slot(dev, type); 28421d70354SDave Airlie minor = *slot; 28521d70354SDave Airlie if (!minor) 28621d70354SDave Airlie return; 28721d70354SDave Airlie 28821d70354SDave Airlie put_device(minor->kdev); 28921d70354SDave Airlie 29021d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 29121d70354SDave Airlie idr_remove(&drm_minors_idr, minor->index); 29221d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 29321d70354SDave Airlie 29421d70354SDave Airlie kfree(minor); 29521d70354SDave Airlie *slot = NULL; 29621d70354SDave Airlie } 29721d70354SDave Airlie 29821d70354SDave Airlie static int drm_minor_register(struct drm_device *dev, unsigned int type) 29921d70354SDave Airlie { 30021d70354SDave Airlie struct drm_minor *minor; 30121d70354SDave Airlie unsigned long flags; 30221d70354SDave Airlie int ret; 30321d70354SDave Airlie 30421d70354SDave Airlie DRM_DEBUG("\n"); 30521d70354SDave Airlie 30621d70354SDave Airlie minor = *drm_minor_get_slot(dev, type); 30721d70354SDave Airlie if (!minor) 30821d70354SDave Airlie return 0; 30921d70354SDave Airlie 31021d70354SDave Airlie ret = drm_debugfs_init(minor, minor->index, drm_debugfs_root); 31121d70354SDave Airlie if (ret) { 31221d70354SDave Airlie DRM_ERROR("DRM: Failed to initialize /sys/kernel/debug/dri.\n"); 31321d70354SDave Airlie return ret; 31421d70354SDave Airlie } 31521d70354SDave Airlie 31621d70354SDave Airlie ret = device_add(minor->kdev); 31721d70354SDave Airlie if (ret) 31821d70354SDave Airlie goto err_debugfs; 31921d70354SDave Airlie 32021d70354SDave Airlie /* replace NULL with @minor so lookups will succeed from now on */ 32121d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 32221d70354SDave Airlie idr_replace(&drm_minors_idr, minor, minor->index); 32321d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 32421d70354SDave Airlie 32521d70354SDave Airlie DRM_DEBUG("new minor registered %d\n", minor->index); 32621d70354SDave Airlie return 0; 32721d70354SDave Airlie 32821d70354SDave Airlie err_debugfs: 32921d70354SDave Airlie drm_debugfs_cleanup(minor); 33021d70354SDave Airlie return ret; 33121d70354SDave Airlie } 33221d70354SDave Airlie 33321d70354SDave Airlie static void drm_minor_unregister(struct drm_device *dev, unsigned int type) 33421d70354SDave Airlie { 33521d70354SDave Airlie struct drm_minor *minor; 33621d70354SDave Airlie unsigned long flags; 33721d70354SDave Airlie 33821d70354SDave Airlie minor = *drm_minor_get_slot(dev, type); 33921d70354SDave Airlie if (!minor || !device_is_registered(minor->kdev)) 34021d70354SDave Airlie return; 34121d70354SDave Airlie 34221d70354SDave Airlie /* replace @minor with NULL so lookups will fail from now on */ 34321d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 34421d70354SDave Airlie idr_replace(&drm_minors_idr, NULL, minor->index); 34521d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 34621d70354SDave Airlie 34721d70354SDave Airlie device_del(minor->kdev); 34821d70354SDave Airlie dev_set_drvdata(minor->kdev, NULL); /* safety belt */ 34921d70354SDave Airlie drm_debugfs_cleanup(minor); 35021d70354SDave Airlie } 35121d70354SDave Airlie 35221d70354SDave Airlie /** 35321d70354SDave Airlie * drm_minor_acquire - Acquire a DRM minor 35421d70354SDave Airlie * @minor_id: Minor ID of the DRM-minor 35521d70354SDave Airlie * 35621d70354SDave Airlie * Looks up the given minor-ID and returns the respective DRM-minor object. The 35721d70354SDave Airlie * refence-count of the underlying device is increased so you must release this 35821d70354SDave Airlie * object with drm_minor_release(). 35921d70354SDave Airlie * 36021d70354SDave Airlie * As long as you hold this minor, it is guaranteed that the object and the 36121d70354SDave Airlie * minor->dev pointer will stay valid! However, the device may get unplugged and 36221d70354SDave Airlie * unregistered while you hold the minor. 36321d70354SDave Airlie * 36421d70354SDave Airlie * Returns: 36521d70354SDave Airlie * Pointer to minor-object with increased device-refcount, or PTR_ERR on 36621d70354SDave Airlie * failure. 36721d70354SDave Airlie */ 36821d70354SDave Airlie struct drm_minor *drm_minor_acquire(unsigned int minor_id) 36921d70354SDave Airlie { 37021d70354SDave Airlie struct drm_minor *minor; 37121d70354SDave Airlie unsigned long flags; 37221d70354SDave Airlie 37321d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 37421d70354SDave Airlie minor = idr_find(&drm_minors_idr, minor_id); 37521d70354SDave Airlie if (minor) 37621d70354SDave Airlie drm_dev_ref(minor->dev); 37721d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 37821d70354SDave Airlie 37921d70354SDave Airlie if (!minor) { 38021d70354SDave Airlie return ERR_PTR(-ENODEV); 38121d70354SDave Airlie } else if (drm_device_is_unplugged(minor->dev)) { 38221d70354SDave Airlie drm_dev_unref(minor->dev); 38321d70354SDave Airlie return ERR_PTR(-ENODEV); 38421d70354SDave Airlie } 38521d70354SDave Airlie 38621d70354SDave Airlie return minor; 38721d70354SDave Airlie } 38821d70354SDave Airlie 38921d70354SDave Airlie /** 39021d70354SDave Airlie * drm_minor_release - Release DRM minor 39121d70354SDave Airlie * @minor: Pointer to DRM minor object 39221d70354SDave Airlie * 39321d70354SDave Airlie * Release a minor that was previously acquired via drm_minor_acquire(). 39421d70354SDave Airlie */ 39521d70354SDave Airlie void drm_minor_release(struct drm_minor *minor) 39621d70354SDave Airlie { 39721d70354SDave Airlie drm_dev_unref(minor->dev); 39821d70354SDave Airlie } 39921d70354SDave Airlie 40021d70354SDave Airlie /** 4016e3f797cSDaniel Vetter * DOC: driver instance overview 4026e3f797cSDaniel Vetter * 4036e3f797cSDaniel Vetter * A device instance for a drm driver is represented by struct &drm_device. This 4046e3f797cSDaniel Vetter * is allocated with drm_dev_alloc(), usually from bus-specific ->probe() 4056e3f797cSDaniel Vetter * callbacks implemented by the driver. The driver then needs to initialize all 4066e3f797cSDaniel Vetter * the various subsystems for the drm device like memory management, vblank 4076e3f797cSDaniel Vetter * handling, modesetting support and intial output configuration plus obviously 4086e3f797cSDaniel Vetter * initialize all the corresponding hardware bits. An important part of this is 4096e3f797cSDaniel Vetter * also calling drm_dev_set_unique() to set the userspace-visible unique name of 4106e3f797cSDaniel Vetter * this device instance. Finally when everything is up and running and ready for 4116e3f797cSDaniel Vetter * userspace the device instance can be published using drm_dev_register(). 4126e3f797cSDaniel Vetter * 4136e3f797cSDaniel Vetter * There is also deprecated support for initalizing device instances using 4146e3f797cSDaniel Vetter * bus-specific helpers and the ->load() callback. But due to 4156e3f797cSDaniel Vetter * backwards-compatibility needs the device instance have to be published too 4166e3f797cSDaniel Vetter * early, which requires unpretty global locking to make safe and is therefore 4176e3f797cSDaniel Vetter * only support for existing drivers not yet converted to the new scheme. 4186e3f797cSDaniel Vetter * 4196e3f797cSDaniel Vetter * When cleaning up a device instance everything needs to be done in reverse: 4206e3f797cSDaniel Vetter * First unpublish the device instance with drm_dev_unregister(). Then clean up 4216e3f797cSDaniel Vetter * any other resources allocated at device initialization and drop the driver's 4226e3f797cSDaniel Vetter * reference to &drm_device using drm_dev_unref(). 4236e3f797cSDaniel Vetter * 4246e3f797cSDaniel Vetter * Note that the lifetime rules for &drm_device instance has still a lot of 4256e3f797cSDaniel Vetter * historical baggage. Hence use the reference counting provided by 4266e3f797cSDaniel Vetter * drm_dev_ref() and drm_dev_unref() only carefully. 4276e3f797cSDaniel Vetter * 4286e3f797cSDaniel Vetter * Also note that embedding of &drm_device is currently not (yet) supported (but 4296e3f797cSDaniel Vetter * it would be easy to add). Drivers can store driver-private data in the 4306e3f797cSDaniel Vetter * dev_priv field of &drm_device. 4316e3f797cSDaniel Vetter */ 4326e3f797cSDaniel Vetter 4336e3f797cSDaniel Vetter /** 43421d70354SDave Airlie * drm_put_dev - Unregister and release a DRM device 43521d70354SDave Airlie * @dev: DRM device 43621d70354SDave Airlie * 43721d70354SDave Airlie * Called at module unload time or when a PCI device is unplugged. 43821d70354SDave Airlie * 43921d70354SDave Airlie * Cleans up all DRM device, calling drm_lastclose(). 4406e3f797cSDaniel Vetter * 4416e3f797cSDaniel Vetter * Note: Use of this function is deprecated. It will eventually go away 4426e3f797cSDaniel Vetter * completely. Please use drm_dev_unregister() and drm_dev_unref() explicitly 4436e3f797cSDaniel Vetter * instead to make sure that the device isn't userspace accessible any more 4446e3f797cSDaniel Vetter * while teardown is in progress, ensuring that userspace can't access an 4456e3f797cSDaniel Vetter * inconsistent state. 44621d70354SDave Airlie */ 44721d70354SDave Airlie void drm_put_dev(struct drm_device *dev) 44821d70354SDave Airlie { 44921d70354SDave Airlie DRM_DEBUG("\n"); 45021d70354SDave Airlie 45121d70354SDave Airlie if (!dev) { 45221d70354SDave Airlie DRM_ERROR("cleanup called no dev\n"); 45321d70354SDave Airlie return; 45421d70354SDave Airlie } 45521d70354SDave Airlie 45621d70354SDave Airlie drm_dev_unregister(dev); 45721d70354SDave Airlie drm_dev_unref(dev); 45821d70354SDave Airlie } 45921d70354SDave Airlie EXPORT_SYMBOL(drm_put_dev); 46021d70354SDave Airlie 46121d70354SDave Airlie void drm_unplug_dev(struct drm_device *dev) 46221d70354SDave Airlie { 46321d70354SDave Airlie /* for a USB device */ 46421d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_LEGACY); 46521d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_RENDER); 46621d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_CONTROL); 46721d70354SDave Airlie 46821d70354SDave Airlie mutex_lock(&drm_global_mutex); 46921d70354SDave Airlie 47021d70354SDave Airlie drm_device_set_unplugged(dev); 47121d70354SDave Airlie 47221d70354SDave Airlie if (dev->open_count == 0) { 47321d70354SDave Airlie drm_put_dev(dev); 47421d70354SDave Airlie } 47521d70354SDave Airlie mutex_unlock(&drm_global_mutex); 47621d70354SDave Airlie } 47721d70354SDave Airlie EXPORT_SYMBOL(drm_unplug_dev); 47821d70354SDave Airlie 47921d70354SDave Airlie /* 48021d70354SDave Airlie * DRM internal mount 48121d70354SDave Airlie * We want to be able to allocate our own "struct address_space" to control 48221d70354SDave Airlie * memory-mappings in VRAM (or stolen RAM, ...). However, core MM does not allow 48321d70354SDave Airlie * stand-alone address_space objects, so we need an underlying inode. As there 48421d70354SDave Airlie * is no way to allocate an independent inode easily, we need a fake internal 48521d70354SDave Airlie * VFS mount-point. 48621d70354SDave Airlie * 48721d70354SDave Airlie * The drm_fs_inode_new() function allocates a new inode, drm_fs_inode_free() 48821d70354SDave Airlie * frees it again. You are allowed to use iget() and iput() to get references to 48921d70354SDave Airlie * the inode. But each drm_fs_inode_new() call must be paired with exactly one 49021d70354SDave Airlie * drm_fs_inode_free() call (which does not have to be the last iput()). 49121d70354SDave Airlie * We use drm_fs_inode_*() to manage our internal VFS mount-point and share it 49221d70354SDave Airlie * between multiple inode-users. You could, technically, call 49321d70354SDave Airlie * iget() + drm_fs_inode_free() directly after alloc and sometime later do an 49421d70354SDave Airlie * iput(), but this way you'd end up with a new vfsmount for each inode. 49521d70354SDave Airlie */ 49621d70354SDave Airlie 49721d70354SDave Airlie static int drm_fs_cnt; 49821d70354SDave Airlie static struct vfsmount *drm_fs_mnt; 49921d70354SDave Airlie 50021d70354SDave Airlie static const struct dentry_operations drm_fs_dops = { 50121d70354SDave Airlie .d_dname = simple_dname, 50221d70354SDave Airlie }; 50321d70354SDave Airlie 50421d70354SDave Airlie static const struct super_operations drm_fs_sops = { 50521d70354SDave Airlie .statfs = simple_statfs, 50621d70354SDave Airlie }; 50721d70354SDave Airlie 50821d70354SDave Airlie static struct dentry *drm_fs_mount(struct file_system_type *fs_type, int flags, 50921d70354SDave Airlie const char *dev_name, void *data) 51021d70354SDave Airlie { 51121d70354SDave Airlie return mount_pseudo(fs_type, 51221d70354SDave Airlie "drm:", 51321d70354SDave Airlie &drm_fs_sops, 51421d70354SDave Airlie &drm_fs_dops, 51521d70354SDave Airlie 0x010203ff); 51621d70354SDave Airlie } 51721d70354SDave Airlie 51821d70354SDave Airlie static struct file_system_type drm_fs_type = { 51921d70354SDave Airlie .name = "drm", 52021d70354SDave Airlie .owner = THIS_MODULE, 52121d70354SDave Airlie .mount = drm_fs_mount, 52221d70354SDave Airlie .kill_sb = kill_anon_super, 52321d70354SDave Airlie }; 52421d70354SDave Airlie 52521d70354SDave Airlie static struct inode *drm_fs_inode_new(void) 52621d70354SDave Airlie { 52721d70354SDave Airlie struct inode *inode; 52821d70354SDave Airlie int r; 52921d70354SDave Airlie 53021d70354SDave Airlie r = simple_pin_fs(&drm_fs_type, &drm_fs_mnt, &drm_fs_cnt); 53121d70354SDave Airlie if (r < 0) { 53221d70354SDave Airlie DRM_ERROR("Cannot mount pseudo fs: %d\n", r); 53321d70354SDave Airlie return ERR_PTR(r); 53421d70354SDave Airlie } 53521d70354SDave Airlie 53621d70354SDave Airlie inode = alloc_anon_inode(drm_fs_mnt->mnt_sb); 53721d70354SDave Airlie if (IS_ERR(inode)) 53821d70354SDave Airlie simple_release_fs(&drm_fs_mnt, &drm_fs_cnt); 53921d70354SDave Airlie 54021d70354SDave Airlie return inode; 54121d70354SDave Airlie } 54221d70354SDave Airlie 54321d70354SDave Airlie static void drm_fs_inode_free(struct inode *inode) 54421d70354SDave Airlie { 54521d70354SDave Airlie if (inode) { 54621d70354SDave Airlie iput(inode); 54721d70354SDave Airlie simple_release_fs(&drm_fs_mnt, &drm_fs_cnt); 54821d70354SDave Airlie } 54921d70354SDave Airlie } 55021d70354SDave Airlie 55121d70354SDave Airlie /** 55221d70354SDave Airlie * drm_dev_alloc - Allocate new DRM device 55321d70354SDave Airlie * @driver: DRM driver to allocate device for 55421d70354SDave Airlie * @parent: Parent device object 55521d70354SDave Airlie * 55621d70354SDave Airlie * Allocate and initialize a new DRM device. No device registration is done. 55721d70354SDave Airlie * Call drm_dev_register() to advertice the device to user space and register it 5586e3f797cSDaniel Vetter * with other core subsystems. This should be done last in the device 5596e3f797cSDaniel Vetter * initialization sequence to make sure userspace can't access an inconsistent 5606e3f797cSDaniel Vetter * state. 56121d70354SDave Airlie * 56221d70354SDave Airlie * The initial ref-count of the object is 1. Use drm_dev_ref() and 56321d70354SDave Airlie * drm_dev_unref() to take and drop further ref-counts. 56421d70354SDave Airlie * 565b0ff4b93SDaniel Vetter * Note that for purely virtual devices @parent can be NULL. 566b0ff4b93SDaniel Vetter * 56721d70354SDave Airlie * RETURNS: 56821d70354SDave Airlie * Pointer to new DRM device, or NULL if out of memory. 56921d70354SDave Airlie */ 57021d70354SDave Airlie struct drm_device *drm_dev_alloc(struct drm_driver *driver, 57121d70354SDave Airlie struct device *parent) 57221d70354SDave Airlie { 57321d70354SDave Airlie struct drm_device *dev; 57421d70354SDave Airlie int ret; 57521d70354SDave Airlie 57621d70354SDave Airlie dev = kzalloc(sizeof(*dev), GFP_KERNEL); 57721d70354SDave Airlie if (!dev) 57821d70354SDave Airlie return NULL; 57921d70354SDave Airlie 58021d70354SDave Airlie kref_init(&dev->ref); 58121d70354SDave Airlie dev->dev = parent; 58221d70354SDave Airlie dev->driver = driver; 58321d70354SDave Airlie 58421d70354SDave Airlie INIT_LIST_HEAD(&dev->filelist); 58521d70354SDave Airlie INIT_LIST_HEAD(&dev->ctxlist); 58621d70354SDave Airlie INIT_LIST_HEAD(&dev->vmalist); 58721d70354SDave Airlie INIT_LIST_HEAD(&dev->maplist); 58821d70354SDave Airlie INIT_LIST_HEAD(&dev->vblank_event_list); 58921d70354SDave Airlie 59021d70354SDave Airlie spin_lock_init(&dev->buf_lock); 59121d70354SDave Airlie spin_lock_init(&dev->event_lock); 59221d70354SDave Airlie mutex_init(&dev->struct_mutex); 5931d2ac403SDaniel Vetter mutex_init(&dev->filelist_mutex); 59421d70354SDave Airlie mutex_init(&dev->ctxlist_mutex); 59521d70354SDave Airlie mutex_init(&dev->master_mutex); 59621d70354SDave Airlie 59721d70354SDave Airlie dev->anon_inode = drm_fs_inode_new(); 59821d70354SDave Airlie if (IS_ERR(dev->anon_inode)) { 59921d70354SDave Airlie ret = PTR_ERR(dev->anon_inode); 60021d70354SDave Airlie DRM_ERROR("Cannot allocate anonymous inode: %d\n", ret); 60121d70354SDave Airlie goto err_free; 60221d70354SDave Airlie } 60321d70354SDave Airlie 60421d70354SDave Airlie if (drm_core_check_feature(dev, DRIVER_MODESET)) { 60521d70354SDave Airlie ret = drm_minor_alloc(dev, DRM_MINOR_CONTROL); 60621d70354SDave Airlie if (ret) 60721d70354SDave Airlie goto err_minors; 608bcfe0c09SGustavo Padovan 609bcfe0c09SGustavo Padovan WARN_ON(driver->suspend || driver->resume); 61021d70354SDave Airlie } 61121d70354SDave Airlie 61221d70354SDave Airlie if (drm_core_check_feature(dev, DRIVER_RENDER)) { 61321d70354SDave Airlie ret = drm_minor_alloc(dev, DRM_MINOR_RENDER); 61421d70354SDave Airlie if (ret) 61521d70354SDave Airlie goto err_minors; 61621d70354SDave Airlie } 61721d70354SDave Airlie 61821d70354SDave Airlie ret = drm_minor_alloc(dev, DRM_MINOR_LEGACY); 61921d70354SDave Airlie if (ret) 62021d70354SDave Airlie goto err_minors; 62121d70354SDave Airlie 62221d70354SDave Airlie if (drm_ht_create(&dev->map_hash, 12)) 62321d70354SDave Airlie goto err_minors; 62421d70354SDave Airlie 625ba6976c1SDaniel Vetter drm_legacy_ctxbitmap_init(dev); 62621d70354SDave Airlie 6271bcecfacSAndrzej Hajda if (drm_core_check_feature(dev, DRIVER_GEM)) { 62821d70354SDave Airlie ret = drm_gem_init(dev); 62921d70354SDave Airlie if (ret) { 63021d70354SDave Airlie DRM_ERROR("Cannot initialize graphics execution manager (GEM)\n"); 63121d70354SDave Airlie goto err_ctxbitmap; 63221d70354SDave Airlie } 63321d70354SDave Airlie } 63421d70354SDave Airlie 635e112e593SNicolas Iooss if (parent) { 636e112e593SNicolas Iooss ret = drm_dev_set_unique(dev, dev_name(parent)); 637e112e593SNicolas Iooss if (ret) 638e112e593SNicolas Iooss goto err_setunique; 639e112e593SNicolas Iooss } 640e112e593SNicolas Iooss 64121d70354SDave Airlie return dev; 64221d70354SDave Airlie 643e112e593SNicolas Iooss err_setunique: 644e112e593SNicolas Iooss if (drm_core_check_feature(dev, DRIVER_GEM)) 645e112e593SNicolas Iooss drm_gem_destroy(dev); 64621d70354SDave Airlie err_ctxbitmap: 64721d70354SDave Airlie drm_legacy_ctxbitmap_cleanup(dev); 64821d70354SDave Airlie drm_ht_remove(&dev->map_hash); 64921d70354SDave Airlie err_minors: 65021d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_LEGACY); 65121d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_RENDER); 65221d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_CONTROL); 65321d70354SDave Airlie drm_fs_inode_free(dev->anon_inode); 65421d70354SDave Airlie err_free: 65521d70354SDave Airlie mutex_destroy(&dev->master_mutex); 65621d70354SDave Airlie kfree(dev); 65721d70354SDave Airlie return NULL; 65821d70354SDave Airlie } 65921d70354SDave Airlie EXPORT_SYMBOL(drm_dev_alloc); 66021d70354SDave Airlie 66121d70354SDave Airlie static void drm_dev_release(struct kref *ref) 66221d70354SDave Airlie { 66321d70354SDave Airlie struct drm_device *dev = container_of(ref, struct drm_device, ref); 66421d70354SDave Airlie 6651bcecfacSAndrzej Hajda if (drm_core_check_feature(dev, DRIVER_GEM)) 66621d70354SDave Airlie drm_gem_destroy(dev); 66721d70354SDave Airlie 66821d70354SDave Airlie drm_legacy_ctxbitmap_cleanup(dev); 66921d70354SDave Airlie drm_ht_remove(&dev->map_hash); 67021d70354SDave Airlie drm_fs_inode_free(dev->anon_inode); 67121d70354SDave Airlie 67221d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_LEGACY); 67321d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_RENDER); 67421d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_CONTROL); 67521d70354SDave Airlie 67621d70354SDave Airlie mutex_destroy(&dev->master_mutex); 67721d70354SDave Airlie kfree(dev->unique); 67821d70354SDave Airlie kfree(dev); 67921d70354SDave Airlie } 68021d70354SDave Airlie 68121d70354SDave Airlie /** 68221d70354SDave Airlie * drm_dev_ref - Take reference of a DRM device 68321d70354SDave Airlie * @dev: device to take reference of or NULL 68421d70354SDave Airlie * 68521d70354SDave Airlie * This increases the ref-count of @dev by one. You *must* already own a 68621d70354SDave Airlie * reference when calling this. Use drm_dev_unref() to drop this reference 68721d70354SDave Airlie * again. 68821d70354SDave Airlie * 68921d70354SDave Airlie * This function never fails. However, this function does not provide *any* 69021d70354SDave Airlie * guarantee whether the device is alive or running. It only provides a 69121d70354SDave Airlie * reference to the object and the memory associated with it. 69221d70354SDave Airlie */ 69321d70354SDave Airlie void drm_dev_ref(struct drm_device *dev) 69421d70354SDave Airlie { 69521d70354SDave Airlie if (dev) 69621d70354SDave Airlie kref_get(&dev->ref); 69721d70354SDave Airlie } 69821d70354SDave Airlie EXPORT_SYMBOL(drm_dev_ref); 69921d70354SDave Airlie 70021d70354SDave Airlie /** 70121d70354SDave Airlie * drm_dev_unref - Drop reference of a DRM device 70221d70354SDave Airlie * @dev: device to drop reference of or NULL 70321d70354SDave Airlie * 70421d70354SDave Airlie * This decreases the ref-count of @dev by one. The device is destroyed if the 70521d70354SDave Airlie * ref-count drops to zero. 70621d70354SDave Airlie */ 70721d70354SDave Airlie void drm_dev_unref(struct drm_device *dev) 70821d70354SDave Airlie { 70921d70354SDave Airlie if (dev) 71021d70354SDave Airlie kref_put(&dev->ref, drm_dev_release); 71121d70354SDave Airlie } 71221d70354SDave Airlie EXPORT_SYMBOL(drm_dev_unref); 71321d70354SDave Airlie 71421d70354SDave Airlie /** 71521d70354SDave Airlie * drm_dev_register - Register DRM device 71621d70354SDave Airlie * @dev: Device to register 71721d70354SDave Airlie * @flags: Flags passed to the driver's .load() function 71821d70354SDave Airlie * 71921d70354SDave Airlie * Register the DRM device @dev with the system, advertise device to user-space 72021d70354SDave Airlie * and start normal device operation. @dev must be allocated via drm_dev_alloc() 72154d2c2daSAlexey Brodkin * previously. Right after drm_dev_register() the driver should call 72254d2c2daSAlexey Brodkin * drm_connector_register_all() to register all connectors in sysfs. This is 72354d2c2daSAlexey Brodkin * a separate call for backward compatibility with drivers still using 72454d2c2daSAlexey Brodkin * the deprecated ->load() callback, where connectors are registered from within 72554d2c2daSAlexey Brodkin * the ->load() callback. 72621d70354SDave Airlie * 72721d70354SDave Airlie * Never call this twice on any device! 72821d70354SDave Airlie * 7296e3f797cSDaniel Vetter * NOTE: To ensure backward compatibility with existing drivers method this 7306e3f797cSDaniel Vetter * function calls the ->load() method after registering the device nodes, 7316e3f797cSDaniel Vetter * creating race conditions. Usage of the ->load() methods is therefore 7326e3f797cSDaniel Vetter * deprecated, drivers must perform all initialization before calling 7336e3f797cSDaniel Vetter * drm_dev_register(). 7346e3f797cSDaniel Vetter * 73521d70354SDave Airlie * RETURNS: 73621d70354SDave Airlie * 0 on success, negative error code on failure. 73721d70354SDave Airlie */ 73821d70354SDave Airlie int drm_dev_register(struct drm_device *dev, unsigned long flags) 73921d70354SDave Airlie { 74021d70354SDave Airlie int ret; 74121d70354SDave Airlie 74221d70354SDave Airlie mutex_lock(&drm_global_mutex); 74321d70354SDave Airlie 74421d70354SDave Airlie ret = drm_minor_register(dev, DRM_MINOR_CONTROL); 74521d70354SDave Airlie if (ret) 74621d70354SDave Airlie goto err_minors; 74721d70354SDave Airlie 74821d70354SDave Airlie ret = drm_minor_register(dev, DRM_MINOR_RENDER); 74921d70354SDave Airlie if (ret) 75021d70354SDave Airlie goto err_minors; 75121d70354SDave Airlie 75221d70354SDave Airlie ret = drm_minor_register(dev, DRM_MINOR_LEGACY); 75321d70354SDave Airlie if (ret) 75421d70354SDave Airlie goto err_minors; 75521d70354SDave Airlie 75621d70354SDave Airlie if (dev->driver->load) { 75721d70354SDave Airlie ret = dev->driver->load(dev, flags); 75821d70354SDave Airlie if (ret) 75921d70354SDave Airlie goto err_minors; 76021d70354SDave Airlie } 76121d70354SDave Airlie 76221d70354SDave Airlie ret = 0; 76321d70354SDave Airlie goto out_unlock; 76421d70354SDave Airlie 76521d70354SDave Airlie err_minors: 76621d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_LEGACY); 76721d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_RENDER); 76821d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_CONTROL); 76921d70354SDave Airlie out_unlock: 77021d70354SDave Airlie mutex_unlock(&drm_global_mutex); 77121d70354SDave Airlie return ret; 77221d70354SDave Airlie } 77321d70354SDave Airlie EXPORT_SYMBOL(drm_dev_register); 77421d70354SDave Airlie 77521d70354SDave Airlie /** 77621d70354SDave Airlie * drm_dev_unregister - Unregister DRM device 77721d70354SDave Airlie * @dev: Device to unregister 77821d70354SDave Airlie * 77921d70354SDave Airlie * Unregister the DRM device from the system. This does the reverse of 78021d70354SDave Airlie * drm_dev_register() but does not deallocate the device. The caller must call 78121d70354SDave Airlie * drm_dev_unref() to drop their final reference. 7826e3f797cSDaniel Vetter * 7836e3f797cSDaniel Vetter * This should be called first in the device teardown code to make sure 7846e3f797cSDaniel Vetter * userspace can't access the device instance any more. 78521d70354SDave Airlie */ 78621d70354SDave Airlie void drm_dev_unregister(struct drm_device *dev) 78721d70354SDave Airlie { 78821d70354SDave Airlie struct drm_map_list *r_list, *list_temp; 78921d70354SDave Airlie 79021d70354SDave Airlie drm_lastclose(dev); 79121d70354SDave Airlie 79221d70354SDave Airlie if (dev->driver->unload) 79321d70354SDave Airlie dev->driver->unload(dev); 79421d70354SDave Airlie 79521d70354SDave Airlie if (dev->agp) 79621d70354SDave Airlie drm_pci_agp_destroy(dev); 79721d70354SDave Airlie 79821d70354SDave Airlie drm_vblank_cleanup(dev); 79921d70354SDave Airlie 80021d70354SDave Airlie list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head) 8019fc5cde7SDavid Herrmann drm_legacy_rmmap(dev, r_list->map); 80221d70354SDave Airlie 80321d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_LEGACY); 80421d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_RENDER); 80521d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_CONTROL); 80621d70354SDave Airlie } 80721d70354SDave Airlie EXPORT_SYMBOL(drm_dev_unregister); 80821d70354SDave Airlie 80921d70354SDave Airlie /** 81021d70354SDave Airlie * drm_dev_set_unique - Set the unique name of a DRM device 81121d70354SDave Airlie * @dev: device of which to set the unique name 812399368aaSNicolas Iooss * @name: unique name 81321d70354SDave Airlie * 814399368aaSNicolas Iooss * Sets the unique name of a DRM device using the specified string. Drivers 815399368aaSNicolas Iooss * can use this at driver probe time if the unique name of the devices they 816399368aaSNicolas Iooss * drive is static. 81721d70354SDave Airlie * 81821d70354SDave Airlie * Return: 0 on success or a negative error code on failure. 81921d70354SDave Airlie */ 820399368aaSNicolas Iooss int drm_dev_set_unique(struct drm_device *dev, const char *name) 82121d70354SDave Airlie { 82221d70354SDave Airlie kfree(dev->unique); 823399368aaSNicolas Iooss dev->unique = kstrdup(name, GFP_KERNEL); 82421d70354SDave Airlie 82521d70354SDave Airlie return dev->unique ? 0 : -ENOMEM; 82621d70354SDave Airlie } 82721d70354SDave Airlie EXPORT_SYMBOL(drm_dev_set_unique); 82821d70354SDave Airlie 82921d70354SDave Airlie /* 83021d70354SDave Airlie * DRM Core 83121d70354SDave Airlie * The DRM core module initializes all global DRM objects and makes them 83221d70354SDave Airlie * available to drivers. Once setup, drivers can probe their respective 83321d70354SDave Airlie * devices. 83421d70354SDave Airlie * Currently, core management includes: 83521d70354SDave Airlie * - The "DRM-Global" key/value database 83621d70354SDave Airlie * - Global ID management for connectors 83721d70354SDave Airlie * - DRM major number allocation 83821d70354SDave Airlie * - DRM minor management 83921d70354SDave Airlie * - DRM sysfs class 84021d70354SDave Airlie * - DRM debugfs root 84121d70354SDave Airlie * 84221d70354SDave Airlie * Furthermore, the DRM core provides dynamic char-dev lookups. For each 84321d70354SDave Airlie * interface registered on a DRM device, you can request minor numbers from DRM 84421d70354SDave Airlie * core. DRM core takes care of major-number management and char-dev 84521d70354SDave Airlie * registration. A stub ->open() callback forwards any open() requests to the 84621d70354SDave Airlie * registered minor. 84721d70354SDave Airlie */ 84821d70354SDave Airlie 84921d70354SDave Airlie static int drm_stub_open(struct inode *inode, struct file *filp) 85021d70354SDave Airlie { 85121d70354SDave Airlie const struct file_operations *new_fops; 85221d70354SDave Airlie struct drm_minor *minor; 85321d70354SDave Airlie int err; 85421d70354SDave Airlie 85521d70354SDave Airlie DRM_DEBUG("\n"); 85621d70354SDave Airlie 85721d70354SDave Airlie mutex_lock(&drm_global_mutex); 85821d70354SDave Airlie minor = drm_minor_acquire(iminor(inode)); 85921d70354SDave Airlie if (IS_ERR(minor)) { 86021d70354SDave Airlie err = PTR_ERR(minor); 86121d70354SDave Airlie goto out_unlock; 86221d70354SDave Airlie } 86321d70354SDave Airlie 86421d70354SDave Airlie new_fops = fops_get(minor->dev->driver->fops); 86521d70354SDave Airlie if (!new_fops) { 86621d70354SDave Airlie err = -ENODEV; 86721d70354SDave Airlie goto out_release; 86821d70354SDave Airlie } 86921d70354SDave Airlie 87021d70354SDave Airlie replace_fops(filp, new_fops); 87121d70354SDave Airlie if (filp->f_op->open) 87221d70354SDave Airlie err = filp->f_op->open(inode, filp); 87321d70354SDave Airlie else 87421d70354SDave Airlie err = 0; 87521d70354SDave Airlie 87621d70354SDave Airlie out_release: 87721d70354SDave Airlie drm_minor_release(minor); 87821d70354SDave Airlie out_unlock: 87921d70354SDave Airlie mutex_unlock(&drm_global_mutex); 88021d70354SDave Airlie return err; 88121d70354SDave Airlie } 88221d70354SDave Airlie 88321d70354SDave Airlie static const struct file_operations drm_stub_fops = { 88421d70354SDave Airlie .owner = THIS_MODULE, 88521d70354SDave Airlie .open = drm_stub_open, 88621d70354SDave Airlie .llseek = noop_llseek, 88721d70354SDave Airlie }; 88821d70354SDave Airlie 88921d70354SDave Airlie static int __init drm_core_init(void) 89021d70354SDave Airlie { 89121d70354SDave Airlie int ret = -ENOMEM; 89221d70354SDave Airlie 89321d70354SDave Airlie drm_global_init(); 89421d70354SDave Airlie drm_connector_ida_init(); 89521d70354SDave Airlie idr_init(&drm_minors_idr); 89621d70354SDave Airlie 89721d70354SDave Airlie if (register_chrdev(DRM_MAJOR, "drm", &drm_stub_fops)) 89821d70354SDave Airlie goto err_p1; 89921d70354SDave Airlie 900fcc90213SDavid Herrmann ret = drm_sysfs_init(); 901fcc90213SDavid Herrmann if (ret < 0) { 90221d70354SDave Airlie printk(KERN_ERR "DRM: Error creating drm class.\n"); 90321d70354SDave Airlie goto err_p2; 90421d70354SDave Airlie } 90521d70354SDave Airlie 90621d70354SDave Airlie drm_debugfs_root = debugfs_create_dir("dri", NULL); 90721d70354SDave Airlie if (!drm_debugfs_root) { 90821d70354SDave Airlie DRM_ERROR("Cannot create /sys/kernel/debug/dri\n"); 90921d70354SDave Airlie ret = -1; 91021d70354SDave Airlie goto err_p3; 91121d70354SDave Airlie } 91221d70354SDave Airlie 91321d70354SDave Airlie DRM_INFO("Initialized %s %d.%d.%d %s\n", 91421d70354SDave Airlie CORE_NAME, CORE_MAJOR, CORE_MINOR, CORE_PATCHLEVEL, CORE_DATE); 91521d70354SDave Airlie return 0; 91621d70354SDave Airlie err_p3: 91721d70354SDave Airlie drm_sysfs_destroy(); 91821d70354SDave Airlie err_p2: 91921d70354SDave Airlie unregister_chrdev(DRM_MAJOR, "drm"); 92021d70354SDave Airlie 92121d70354SDave Airlie idr_destroy(&drm_minors_idr); 92221d70354SDave Airlie err_p1: 92321d70354SDave Airlie return ret; 92421d70354SDave Airlie } 92521d70354SDave Airlie 92621d70354SDave Airlie static void __exit drm_core_exit(void) 92721d70354SDave Airlie { 92821d70354SDave Airlie debugfs_remove(drm_debugfs_root); 92921d70354SDave Airlie drm_sysfs_destroy(); 93021d70354SDave Airlie 93121d70354SDave Airlie unregister_chrdev(DRM_MAJOR, "drm"); 93221d70354SDave Airlie 93321d70354SDave Airlie drm_connector_ida_destroy(); 93421d70354SDave Airlie idr_destroy(&drm_minors_idr); 93521d70354SDave Airlie } 93621d70354SDave Airlie 93721d70354SDave Airlie module_init(drm_core_init); 93821d70354SDave Airlie module_exit(drm_core_exit); 939