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 4002d0a493SRob Clark unsigned int drm_debug = 0; /* bitmask of DRM_UT_x */ 4121d70354SDave Airlie EXPORT_SYMBOL(drm_debug); 4221d70354SDave Airlie 4321d70354SDave Airlie MODULE_AUTHOR(CORE_AUTHOR); 4421d70354SDave Airlie MODULE_DESCRIPTION(CORE_DESC); 4521d70354SDave Airlie MODULE_LICENSE("GPL and additional rights"); 4621d70354SDave Airlie MODULE_PARM_DESC(debug, "Enable debug output"); 474ed0ce3dSVille Syrjälä MODULE_PARM_DESC(vblankoffdelay, "Delay until vblank irq auto-disable [msecs] (0: never disable, <0: disable immediately)"); 4821d70354SDave Airlie MODULE_PARM_DESC(timestamp_precision_usec, "Max. error on timestamps [usecs]"); 4921d70354SDave Airlie MODULE_PARM_DESC(timestamp_monotonic, "Use monotonic timestamps"); 5021d70354SDave Airlie 5121d70354SDave Airlie module_param_named(debug, drm_debug, int, 0600); 5221d70354SDave Airlie 5321d70354SDave Airlie static DEFINE_SPINLOCK(drm_minor_lock); 5421d70354SDave Airlie static struct idr drm_minors_idr; 5521d70354SDave Airlie 5621d70354SDave Airlie static struct dentry *drm_debugfs_root; 5721d70354SDave Airlie 58a1f1a79cSJoe Perches void drm_err(const char *format, ...) 5921d70354SDave Airlie { 6021d70354SDave Airlie struct va_format vaf; 6121d70354SDave Airlie va_list args; 6221d70354SDave Airlie 6321d70354SDave Airlie va_start(args, format); 6421d70354SDave Airlie 6521d70354SDave Airlie vaf.fmt = format; 6621d70354SDave Airlie vaf.va = &args; 6721d70354SDave Airlie 682ee762b3SScott Wood printk(KERN_ERR "[" DRM_NAME ":%ps] *ERROR* %pV", 69a1f1a79cSJoe Perches __builtin_return_address(0), &vaf); 7021d70354SDave Airlie 7121d70354SDave Airlie va_end(args); 7221d70354SDave Airlie } 7321d70354SDave Airlie EXPORT_SYMBOL(drm_err); 7421d70354SDave Airlie 7521d70354SDave Airlie void drm_ut_debug_printk(const char *function_name, const char *format, ...) 7621d70354SDave Airlie { 7721d70354SDave Airlie struct va_format vaf; 7821d70354SDave Airlie va_list args; 7921d70354SDave Airlie 8021d70354SDave Airlie va_start(args, format); 8121d70354SDave Airlie vaf.fmt = format; 8221d70354SDave Airlie vaf.va = &args; 8321d70354SDave Airlie 8421d70354SDave Airlie printk(KERN_DEBUG "[" DRM_NAME ":%s] %pV", function_name, &vaf); 8521d70354SDave Airlie 8621d70354SDave Airlie va_end(args); 8721d70354SDave Airlie } 8821d70354SDave Airlie EXPORT_SYMBOL(drm_ut_debug_printk); 8921d70354SDave Airlie 9021d70354SDave Airlie struct drm_master *drm_master_create(struct drm_minor *minor) 9121d70354SDave Airlie { 9221d70354SDave Airlie struct drm_master *master; 9321d70354SDave Airlie 9421d70354SDave Airlie master = kzalloc(sizeof(*master), GFP_KERNEL); 9521d70354SDave Airlie if (!master) 9621d70354SDave Airlie return NULL; 9721d70354SDave Airlie 9821d70354SDave Airlie kref_init(&master->refcount); 9921d70354SDave Airlie spin_lock_init(&master->lock.spinlock); 10021d70354SDave Airlie init_waitqueue_head(&master->lock.lock_queue); 10132e7b94aSDavid Herrmann idr_init(&master->magic_map); 10221d70354SDave Airlie master->minor = minor; 10321d70354SDave Airlie 10421d70354SDave Airlie return master; 10521d70354SDave Airlie } 10621d70354SDave Airlie 10721d70354SDave Airlie struct drm_master *drm_master_get(struct drm_master *master) 10821d70354SDave Airlie { 10921d70354SDave Airlie kref_get(&master->refcount); 11021d70354SDave Airlie return master; 11121d70354SDave Airlie } 11221d70354SDave Airlie EXPORT_SYMBOL(drm_master_get); 11321d70354SDave Airlie 11421d70354SDave Airlie static void drm_master_destroy(struct kref *kref) 11521d70354SDave Airlie { 11621d70354SDave Airlie struct drm_master *master = container_of(kref, struct drm_master, refcount); 11721d70354SDave Airlie struct drm_device *dev = master->minor->dev; 11821d70354SDave Airlie struct drm_map_list *r_list, *list_temp; 11921d70354SDave Airlie 12021d70354SDave Airlie mutex_lock(&dev->struct_mutex); 12121d70354SDave Airlie if (dev->driver->master_destroy) 12221d70354SDave Airlie dev->driver->master_destroy(dev, master); 12321d70354SDave Airlie 12421d70354SDave Airlie list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head) { 12521d70354SDave Airlie if (r_list->master == master) { 1269fc5cde7SDavid Herrmann drm_legacy_rmmap_locked(dev, r_list->map); 12721d70354SDave Airlie r_list = NULL; 12821d70354SDave Airlie } 12921d70354SDave Airlie } 13021d70354SDave Airlie mutex_unlock(&dev->struct_mutex); 13132e7b94aSDavid Herrmann 13232e7b94aSDavid Herrmann idr_destroy(&master->magic_map); 1334a324d33SDavid Herrmann kfree(master->unique); 13421d70354SDave Airlie kfree(master); 13521d70354SDave Airlie } 13621d70354SDave Airlie 13721d70354SDave Airlie void drm_master_put(struct drm_master **master) 13821d70354SDave Airlie { 13921d70354SDave Airlie kref_put(&(*master)->refcount, drm_master_destroy); 14021d70354SDave Airlie *master = NULL; 14121d70354SDave Airlie } 14221d70354SDave Airlie EXPORT_SYMBOL(drm_master_put); 14321d70354SDave Airlie 14421d70354SDave Airlie int drm_setmaster_ioctl(struct drm_device *dev, void *data, 14521d70354SDave Airlie struct drm_file *file_priv) 14621d70354SDave Airlie { 14721d70354SDave Airlie int ret = 0; 14821d70354SDave Airlie 14921d70354SDave Airlie mutex_lock(&dev->master_mutex); 1507963e9dbSDave Airlie if (file_priv->is_master) 15121d70354SDave Airlie goto out_unlock; 15221d70354SDave Airlie 15321d70354SDave Airlie if (file_priv->minor->master) { 15421d70354SDave Airlie ret = -EINVAL; 15521d70354SDave Airlie goto out_unlock; 15621d70354SDave Airlie } 15721d70354SDave Airlie 15821d70354SDave Airlie if (!file_priv->master) { 15921d70354SDave Airlie ret = -EINVAL; 16021d70354SDave Airlie goto out_unlock; 16121d70354SDave Airlie } 16221d70354SDave Airlie 16321d70354SDave Airlie file_priv->minor->master = drm_master_get(file_priv->master); 1647963e9dbSDave Airlie file_priv->is_master = 1; 16521d70354SDave Airlie if (dev->driver->master_set) { 16621d70354SDave Airlie ret = dev->driver->master_set(dev, file_priv, false); 1677963e9dbSDave Airlie if (unlikely(ret != 0)) { 1687963e9dbSDave Airlie file_priv->is_master = 0; 16921d70354SDave Airlie drm_master_put(&file_priv->minor->master); 17021d70354SDave Airlie } 1717963e9dbSDave Airlie } 17221d70354SDave Airlie 17321d70354SDave Airlie out_unlock: 17421d70354SDave Airlie mutex_unlock(&dev->master_mutex); 17521d70354SDave Airlie return ret; 17621d70354SDave Airlie } 17721d70354SDave Airlie 17821d70354SDave Airlie int drm_dropmaster_ioctl(struct drm_device *dev, void *data, 17921d70354SDave Airlie struct drm_file *file_priv) 18021d70354SDave Airlie { 18121d70354SDave Airlie int ret = -EINVAL; 18221d70354SDave Airlie 18321d70354SDave Airlie mutex_lock(&dev->master_mutex); 1847963e9dbSDave Airlie if (!file_priv->is_master) 18521d70354SDave Airlie goto out_unlock; 18621d70354SDave Airlie 18721d70354SDave Airlie if (!file_priv->minor->master) 18821d70354SDave Airlie goto out_unlock; 18921d70354SDave Airlie 19021d70354SDave Airlie ret = 0; 19121d70354SDave Airlie if (dev->driver->master_drop) 19221d70354SDave Airlie dev->driver->master_drop(dev, file_priv, false); 19321d70354SDave Airlie drm_master_put(&file_priv->minor->master); 1947963e9dbSDave Airlie file_priv->is_master = 0; 19521d70354SDave Airlie 19621d70354SDave Airlie out_unlock: 19721d70354SDave Airlie mutex_unlock(&dev->master_mutex); 19821d70354SDave Airlie return ret; 19921d70354SDave Airlie } 20021d70354SDave Airlie 20121d70354SDave Airlie /* 20221d70354SDave Airlie * DRM Minors 20321d70354SDave Airlie * A DRM device can provide several char-dev interfaces on the DRM-Major. Each 20421d70354SDave Airlie * of them is represented by a drm_minor object. Depending on the capabilities 20521d70354SDave Airlie * of the device-driver, different interfaces are registered. 20621d70354SDave Airlie * 20721d70354SDave Airlie * Minors can be accessed via dev->$minor_name. This pointer is either 20821d70354SDave Airlie * NULL or a valid drm_minor pointer and stays valid as long as the device is 20921d70354SDave Airlie * valid. This means, DRM minors have the same life-time as the underlying 21021d70354SDave Airlie * device. However, this doesn't mean that the minor is active. Minors are 21121d70354SDave Airlie * registered and unregistered dynamically according to device-state. 21221d70354SDave Airlie */ 21321d70354SDave Airlie 21421d70354SDave Airlie static struct drm_minor **drm_minor_get_slot(struct drm_device *dev, 21521d70354SDave Airlie unsigned int type) 21621d70354SDave Airlie { 21721d70354SDave Airlie switch (type) { 21821d70354SDave Airlie case DRM_MINOR_LEGACY: 21921d70354SDave Airlie return &dev->primary; 22021d70354SDave Airlie case DRM_MINOR_RENDER: 22121d70354SDave Airlie return &dev->render; 22221d70354SDave Airlie case DRM_MINOR_CONTROL: 22321d70354SDave Airlie return &dev->control; 22421d70354SDave Airlie default: 22521d70354SDave Airlie return NULL; 22621d70354SDave Airlie } 22721d70354SDave Airlie } 22821d70354SDave Airlie 22921d70354SDave Airlie static int drm_minor_alloc(struct drm_device *dev, unsigned int type) 23021d70354SDave Airlie { 23121d70354SDave Airlie struct drm_minor *minor; 23221d70354SDave Airlie unsigned long flags; 23321d70354SDave Airlie int r; 23421d70354SDave Airlie 23521d70354SDave Airlie minor = kzalloc(sizeof(*minor), GFP_KERNEL); 23621d70354SDave Airlie if (!minor) 23721d70354SDave Airlie return -ENOMEM; 23821d70354SDave Airlie 23921d70354SDave Airlie minor->type = type; 24021d70354SDave Airlie minor->dev = dev; 24121d70354SDave Airlie 24221d70354SDave Airlie idr_preload(GFP_KERNEL); 24321d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 24421d70354SDave Airlie r = idr_alloc(&drm_minors_idr, 24521d70354SDave Airlie NULL, 24621d70354SDave Airlie 64 * type, 24721d70354SDave Airlie 64 * (type + 1), 24821d70354SDave Airlie GFP_NOWAIT); 24921d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 25021d70354SDave Airlie idr_preload_end(); 25121d70354SDave Airlie 25221d70354SDave Airlie if (r < 0) 25321d70354SDave Airlie goto err_free; 25421d70354SDave Airlie 25521d70354SDave Airlie minor->index = r; 25621d70354SDave Airlie 25721d70354SDave Airlie minor->kdev = drm_sysfs_minor_alloc(minor); 25821d70354SDave Airlie if (IS_ERR(minor->kdev)) { 25921d70354SDave Airlie r = PTR_ERR(minor->kdev); 26021d70354SDave Airlie goto err_index; 26121d70354SDave Airlie } 26221d70354SDave Airlie 26321d70354SDave Airlie *drm_minor_get_slot(dev, type) = minor; 26421d70354SDave Airlie return 0; 26521d70354SDave Airlie 26621d70354SDave Airlie err_index: 26721d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 26821d70354SDave Airlie idr_remove(&drm_minors_idr, minor->index); 26921d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 27021d70354SDave Airlie err_free: 27121d70354SDave Airlie kfree(minor); 27221d70354SDave Airlie return r; 27321d70354SDave Airlie } 27421d70354SDave Airlie 27521d70354SDave Airlie static void drm_minor_free(struct drm_device *dev, unsigned int type) 27621d70354SDave Airlie { 27721d70354SDave Airlie struct drm_minor **slot, *minor; 27821d70354SDave Airlie unsigned long flags; 27921d70354SDave Airlie 28021d70354SDave Airlie slot = drm_minor_get_slot(dev, type); 28121d70354SDave Airlie minor = *slot; 28221d70354SDave Airlie if (!minor) 28321d70354SDave Airlie return; 28421d70354SDave Airlie 28521d70354SDave Airlie put_device(minor->kdev); 28621d70354SDave Airlie 28721d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 28821d70354SDave Airlie idr_remove(&drm_minors_idr, minor->index); 28921d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 29021d70354SDave Airlie 29121d70354SDave Airlie kfree(minor); 29221d70354SDave Airlie *slot = NULL; 29321d70354SDave Airlie } 29421d70354SDave Airlie 29521d70354SDave Airlie static int drm_minor_register(struct drm_device *dev, unsigned int type) 29621d70354SDave Airlie { 29721d70354SDave Airlie struct drm_minor *minor; 29821d70354SDave Airlie unsigned long flags; 29921d70354SDave Airlie int ret; 30021d70354SDave Airlie 30121d70354SDave Airlie DRM_DEBUG("\n"); 30221d70354SDave Airlie 30321d70354SDave Airlie minor = *drm_minor_get_slot(dev, type); 30421d70354SDave Airlie if (!minor) 30521d70354SDave Airlie return 0; 30621d70354SDave Airlie 30721d70354SDave Airlie ret = drm_debugfs_init(minor, minor->index, drm_debugfs_root); 30821d70354SDave Airlie if (ret) { 30921d70354SDave Airlie DRM_ERROR("DRM: Failed to initialize /sys/kernel/debug/dri.\n"); 31021d70354SDave Airlie return ret; 31121d70354SDave Airlie } 31221d70354SDave Airlie 31321d70354SDave Airlie ret = device_add(minor->kdev); 31421d70354SDave Airlie if (ret) 31521d70354SDave Airlie goto err_debugfs; 31621d70354SDave Airlie 31721d70354SDave Airlie /* replace NULL with @minor so lookups will succeed from now on */ 31821d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 31921d70354SDave Airlie idr_replace(&drm_minors_idr, minor, minor->index); 32021d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 32121d70354SDave Airlie 32221d70354SDave Airlie DRM_DEBUG("new minor registered %d\n", minor->index); 32321d70354SDave Airlie return 0; 32421d70354SDave Airlie 32521d70354SDave Airlie err_debugfs: 32621d70354SDave Airlie drm_debugfs_cleanup(minor); 32721d70354SDave Airlie return ret; 32821d70354SDave Airlie } 32921d70354SDave Airlie 33021d70354SDave Airlie static void drm_minor_unregister(struct drm_device *dev, unsigned int type) 33121d70354SDave Airlie { 33221d70354SDave Airlie struct drm_minor *minor; 33321d70354SDave Airlie unsigned long flags; 33421d70354SDave Airlie 33521d70354SDave Airlie minor = *drm_minor_get_slot(dev, type); 33621d70354SDave Airlie if (!minor || !device_is_registered(minor->kdev)) 33721d70354SDave Airlie return; 33821d70354SDave Airlie 33921d70354SDave Airlie /* replace @minor with NULL so lookups will fail from now on */ 34021d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 34121d70354SDave Airlie idr_replace(&drm_minors_idr, NULL, minor->index); 34221d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 34321d70354SDave Airlie 34421d70354SDave Airlie device_del(minor->kdev); 34521d70354SDave Airlie dev_set_drvdata(minor->kdev, NULL); /* safety belt */ 34621d70354SDave Airlie drm_debugfs_cleanup(minor); 34721d70354SDave Airlie } 34821d70354SDave Airlie 34921d70354SDave Airlie /** 35021d70354SDave Airlie * drm_minor_acquire - Acquire a DRM minor 35121d70354SDave Airlie * @minor_id: Minor ID of the DRM-minor 35221d70354SDave Airlie * 35321d70354SDave Airlie * Looks up the given minor-ID and returns the respective DRM-minor object. The 35421d70354SDave Airlie * refence-count of the underlying device is increased so you must release this 35521d70354SDave Airlie * object with drm_minor_release(). 35621d70354SDave Airlie * 35721d70354SDave Airlie * As long as you hold this minor, it is guaranteed that the object and the 35821d70354SDave Airlie * minor->dev pointer will stay valid! However, the device may get unplugged and 35921d70354SDave Airlie * unregistered while you hold the minor. 36021d70354SDave Airlie * 36121d70354SDave Airlie * Returns: 36221d70354SDave Airlie * Pointer to minor-object with increased device-refcount, or PTR_ERR on 36321d70354SDave Airlie * failure. 36421d70354SDave Airlie */ 36521d70354SDave Airlie struct drm_minor *drm_minor_acquire(unsigned int minor_id) 36621d70354SDave Airlie { 36721d70354SDave Airlie struct drm_minor *minor; 36821d70354SDave Airlie unsigned long flags; 36921d70354SDave Airlie 37021d70354SDave Airlie spin_lock_irqsave(&drm_minor_lock, flags); 37121d70354SDave Airlie minor = idr_find(&drm_minors_idr, minor_id); 37221d70354SDave Airlie if (minor) 37321d70354SDave Airlie drm_dev_ref(minor->dev); 37421d70354SDave Airlie spin_unlock_irqrestore(&drm_minor_lock, flags); 37521d70354SDave Airlie 37621d70354SDave Airlie if (!minor) { 37721d70354SDave Airlie return ERR_PTR(-ENODEV); 37821d70354SDave Airlie } else if (drm_device_is_unplugged(minor->dev)) { 37921d70354SDave Airlie drm_dev_unref(minor->dev); 38021d70354SDave Airlie return ERR_PTR(-ENODEV); 38121d70354SDave Airlie } 38221d70354SDave Airlie 38321d70354SDave Airlie return minor; 38421d70354SDave Airlie } 38521d70354SDave Airlie 38621d70354SDave Airlie /** 38721d70354SDave Airlie * drm_minor_release - Release DRM minor 38821d70354SDave Airlie * @minor: Pointer to DRM minor object 38921d70354SDave Airlie * 39021d70354SDave Airlie * Release a minor that was previously acquired via drm_minor_acquire(). 39121d70354SDave Airlie */ 39221d70354SDave Airlie void drm_minor_release(struct drm_minor *minor) 39321d70354SDave Airlie { 39421d70354SDave Airlie drm_dev_unref(minor->dev); 39521d70354SDave Airlie } 39621d70354SDave Airlie 39721d70354SDave Airlie /** 3986e3f797cSDaniel Vetter * DOC: driver instance overview 3996e3f797cSDaniel Vetter * 4006e3f797cSDaniel Vetter * A device instance for a drm driver is represented by struct &drm_device. This 4016e3f797cSDaniel Vetter * is allocated with drm_dev_alloc(), usually from bus-specific ->probe() 4026e3f797cSDaniel Vetter * callbacks implemented by the driver. The driver then needs to initialize all 4036e3f797cSDaniel Vetter * the various subsystems for the drm device like memory management, vblank 4046e3f797cSDaniel Vetter * handling, modesetting support and intial output configuration plus obviously 4056e3f797cSDaniel Vetter * initialize all the corresponding hardware bits. An important part of this is 4066e3f797cSDaniel Vetter * also calling drm_dev_set_unique() to set the userspace-visible unique name of 4076e3f797cSDaniel Vetter * this device instance. Finally when everything is up and running and ready for 4086e3f797cSDaniel Vetter * userspace the device instance can be published using drm_dev_register(). 4096e3f797cSDaniel Vetter * 4106e3f797cSDaniel Vetter * There is also deprecated support for initalizing device instances using 4116e3f797cSDaniel Vetter * bus-specific helpers and the ->load() callback. But due to 4126e3f797cSDaniel Vetter * backwards-compatibility needs the device instance have to be published too 4136e3f797cSDaniel Vetter * early, which requires unpretty global locking to make safe and is therefore 4146e3f797cSDaniel Vetter * only support for existing drivers not yet converted to the new scheme. 4156e3f797cSDaniel Vetter * 4166e3f797cSDaniel Vetter * When cleaning up a device instance everything needs to be done in reverse: 4176e3f797cSDaniel Vetter * First unpublish the device instance with drm_dev_unregister(). Then clean up 4186e3f797cSDaniel Vetter * any other resources allocated at device initialization and drop the driver's 4196e3f797cSDaniel Vetter * reference to &drm_device using drm_dev_unref(). 4206e3f797cSDaniel Vetter * 4216e3f797cSDaniel Vetter * Note that the lifetime rules for &drm_device instance has still a lot of 4226e3f797cSDaniel Vetter * historical baggage. Hence use the reference counting provided by 4236e3f797cSDaniel Vetter * drm_dev_ref() and drm_dev_unref() only carefully. 4246e3f797cSDaniel Vetter * 4256e3f797cSDaniel Vetter * Also note that embedding of &drm_device is currently not (yet) supported (but 4266e3f797cSDaniel Vetter * it would be easy to add). Drivers can store driver-private data in the 4276e3f797cSDaniel Vetter * dev_priv field of &drm_device. 4286e3f797cSDaniel Vetter */ 4296e3f797cSDaniel Vetter 4306e3f797cSDaniel Vetter /** 43121d70354SDave Airlie * drm_put_dev - Unregister and release a DRM device 43221d70354SDave Airlie * @dev: DRM device 43321d70354SDave Airlie * 43421d70354SDave Airlie * Called at module unload time or when a PCI device is unplugged. 43521d70354SDave Airlie * 43621d70354SDave Airlie * Cleans up all DRM device, calling drm_lastclose(). 4376e3f797cSDaniel Vetter * 4386e3f797cSDaniel Vetter * Note: Use of this function is deprecated. It will eventually go away 4396e3f797cSDaniel Vetter * completely. Please use drm_dev_unregister() and drm_dev_unref() explicitly 4406e3f797cSDaniel Vetter * instead to make sure that the device isn't userspace accessible any more 4416e3f797cSDaniel Vetter * while teardown is in progress, ensuring that userspace can't access an 4426e3f797cSDaniel Vetter * inconsistent state. 44321d70354SDave Airlie */ 44421d70354SDave Airlie void drm_put_dev(struct drm_device *dev) 44521d70354SDave Airlie { 44621d70354SDave Airlie DRM_DEBUG("\n"); 44721d70354SDave Airlie 44821d70354SDave Airlie if (!dev) { 44921d70354SDave Airlie DRM_ERROR("cleanup called no dev\n"); 45021d70354SDave Airlie return; 45121d70354SDave Airlie } 45221d70354SDave Airlie 45321d70354SDave Airlie drm_dev_unregister(dev); 45421d70354SDave Airlie drm_dev_unref(dev); 45521d70354SDave Airlie } 45621d70354SDave Airlie EXPORT_SYMBOL(drm_put_dev); 45721d70354SDave Airlie 45821d70354SDave Airlie void drm_unplug_dev(struct drm_device *dev) 45921d70354SDave Airlie { 46021d70354SDave Airlie /* for a USB device */ 46121d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_LEGACY); 46221d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_RENDER); 46321d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_CONTROL); 46421d70354SDave Airlie 46521d70354SDave Airlie mutex_lock(&drm_global_mutex); 46621d70354SDave Airlie 46721d70354SDave Airlie drm_device_set_unplugged(dev); 46821d70354SDave Airlie 46921d70354SDave Airlie if (dev->open_count == 0) { 47021d70354SDave Airlie drm_put_dev(dev); 47121d70354SDave Airlie } 47221d70354SDave Airlie mutex_unlock(&drm_global_mutex); 47321d70354SDave Airlie } 47421d70354SDave Airlie EXPORT_SYMBOL(drm_unplug_dev); 47521d70354SDave Airlie 47621d70354SDave Airlie /* 47721d70354SDave Airlie * DRM internal mount 47821d70354SDave Airlie * We want to be able to allocate our own "struct address_space" to control 47921d70354SDave Airlie * memory-mappings in VRAM (or stolen RAM, ...). However, core MM does not allow 48021d70354SDave Airlie * stand-alone address_space objects, so we need an underlying inode. As there 48121d70354SDave Airlie * is no way to allocate an independent inode easily, we need a fake internal 48221d70354SDave Airlie * VFS mount-point. 48321d70354SDave Airlie * 48421d70354SDave Airlie * The drm_fs_inode_new() function allocates a new inode, drm_fs_inode_free() 48521d70354SDave Airlie * frees it again. You are allowed to use iget() and iput() to get references to 48621d70354SDave Airlie * the inode. But each drm_fs_inode_new() call must be paired with exactly one 48721d70354SDave Airlie * drm_fs_inode_free() call (which does not have to be the last iput()). 48821d70354SDave Airlie * We use drm_fs_inode_*() to manage our internal VFS mount-point and share it 48921d70354SDave Airlie * between multiple inode-users. You could, technically, call 49021d70354SDave Airlie * iget() + drm_fs_inode_free() directly after alloc and sometime later do an 49121d70354SDave Airlie * iput(), but this way you'd end up with a new vfsmount for each inode. 49221d70354SDave Airlie */ 49321d70354SDave Airlie 49421d70354SDave Airlie static int drm_fs_cnt; 49521d70354SDave Airlie static struct vfsmount *drm_fs_mnt; 49621d70354SDave Airlie 49721d70354SDave Airlie static const struct dentry_operations drm_fs_dops = { 49821d70354SDave Airlie .d_dname = simple_dname, 49921d70354SDave Airlie }; 50021d70354SDave Airlie 50121d70354SDave Airlie static const struct super_operations drm_fs_sops = { 50221d70354SDave Airlie .statfs = simple_statfs, 50321d70354SDave Airlie }; 50421d70354SDave Airlie 50521d70354SDave Airlie static struct dentry *drm_fs_mount(struct file_system_type *fs_type, int flags, 50621d70354SDave Airlie const char *dev_name, void *data) 50721d70354SDave Airlie { 50821d70354SDave Airlie return mount_pseudo(fs_type, 50921d70354SDave Airlie "drm:", 51021d70354SDave Airlie &drm_fs_sops, 51121d70354SDave Airlie &drm_fs_dops, 51221d70354SDave Airlie 0x010203ff); 51321d70354SDave Airlie } 51421d70354SDave Airlie 51521d70354SDave Airlie static struct file_system_type drm_fs_type = { 51621d70354SDave Airlie .name = "drm", 51721d70354SDave Airlie .owner = THIS_MODULE, 51821d70354SDave Airlie .mount = drm_fs_mount, 51921d70354SDave Airlie .kill_sb = kill_anon_super, 52021d70354SDave Airlie }; 52121d70354SDave Airlie 52221d70354SDave Airlie static struct inode *drm_fs_inode_new(void) 52321d70354SDave Airlie { 52421d70354SDave Airlie struct inode *inode; 52521d70354SDave Airlie int r; 52621d70354SDave Airlie 52721d70354SDave Airlie r = simple_pin_fs(&drm_fs_type, &drm_fs_mnt, &drm_fs_cnt); 52821d70354SDave Airlie if (r < 0) { 52921d70354SDave Airlie DRM_ERROR("Cannot mount pseudo fs: %d\n", r); 53021d70354SDave Airlie return ERR_PTR(r); 53121d70354SDave Airlie } 53221d70354SDave Airlie 53321d70354SDave Airlie inode = alloc_anon_inode(drm_fs_mnt->mnt_sb); 53421d70354SDave Airlie if (IS_ERR(inode)) 53521d70354SDave Airlie simple_release_fs(&drm_fs_mnt, &drm_fs_cnt); 53621d70354SDave Airlie 53721d70354SDave Airlie return inode; 53821d70354SDave Airlie } 53921d70354SDave Airlie 54021d70354SDave Airlie static void drm_fs_inode_free(struct inode *inode) 54121d70354SDave Airlie { 54221d70354SDave Airlie if (inode) { 54321d70354SDave Airlie iput(inode); 54421d70354SDave Airlie simple_release_fs(&drm_fs_mnt, &drm_fs_cnt); 54521d70354SDave Airlie } 54621d70354SDave Airlie } 54721d70354SDave Airlie 54821d70354SDave Airlie /** 54921d70354SDave Airlie * drm_dev_alloc - Allocate new DRM device 55021d70354SDave Airlie * @driver: DRM driver to allocate device for 55121d70354SDave Airlie * @parent: Parent device object 55221d70354SDave Airlie * 55321d70354SDave Airlie * Allocate and initialize a new DRM device. No device registration is done. 55421d70354SDave Airlie * Call drm_dev_register() to advertice the device to user space and register it 5556e3f797cSDaniel Vetter * with other core subsystems. This should be done last in the device 5566e3f797cSDaniel Vetter * initialization sequence to make sure userspace can't access an inconsistent 5576e3f797cSDaniel Vetter * state. 55821d70354SDave Airlie * 55921d70354SDave Airlie * The initial ref-count of the object is 1. Use drm_dev_ref() and 56021d70354SDave Airlie * drm_dev_unref() to take and drop further ref-counts. 56121d70354SDave Airlie * 562b0ff4b93SDaniel Vetter * Note that for purely virtual devices @parent can be NULL. 563b0ff4b93SDaniel Vetter * 56421d70354SDave Airlie * RETURNS: 56521d70354SDave Airlie * Pointer to new DRM device, or NULL if out of memory. 56621d70354SDave Airlie */ 56721d70354SDave Airlie struct drm_device *drm_dev_alloc(struct drm_driver *driver, 56821d70354SDave Airlie struct device *parent) 56921d70354SDave Airlie { 57021d70354SDave Airlie struct drm_device *dev; 57121d70354SDave Airlie int ret; 57221d70354SDave Airlie 57321d70354SDave Airlie dev = kzalloc(sizeof(*dev), GFP_KERNEL); 57421d70354SDave Airlie if (!dev) 57521d70354SDave Airlie return NULL; 57621d70354SDave Airlie 57721d70354SDave Airlie kref_init(&dev->ref); 57821d70354SDave Airlie dev->dev = parent; 57921d70354SDave Airlie dev->driver = driver; 58021d70354SDave Airlie 58121d70354SDave Airlie INIT_LIST_HEAD(&dev->filelist); 58221d70354SDave Airlie INIT_LIST_HEAD(&dev->ctxlist); 58321d70354SDave Airlie INIT_LIST_HEAD(&dev->vmalist); 58421d70354SDave Airlie INIT_LIST_HEAD(&dev->maplist); 58521d70354SDave Airlie INIT_LIST_HEAD(&dev->vblank_event_list); 58621d70354SDave Airlie 58721d70354SDave Airlie spin_lock_init(&dev->buf_lock); 58821d70354SDave Airlie spin_lock_init(&dev->event_lock); 58921d70354SDave Airlie mutex_init(&dev->struct_mutex); 59021d70354SDave Airlie mutex_init(&dev->ctxlist_mutex); 59121d70354SDave Airlie mutex_init(&dev->master_mutex); 59221d70354SDave Airlie 59321d70354SDave Airlie dev->anon_inode = drm_fs_inode_new(); 59421d70354SDave Airlie if (IS_ERR(dev->anon_inode)) { 59521d70354SDave Airlie ret = PTR_ERR(dev->anon_inode); 59621d70354SDave Airlie DRM_ERROR("Cannot allocate anonymous inode: %d\n", ret); 59721d70354SDave Airlie goto err_free; 59821d70354SDave Airlie } 59921d70354SDave Airlie 60021d70354SDave Airlie if (drm_core_check_feature(dev, DRIVER_MODESET)) { 60121d70354SDave Airlie ret = drm_minor_alloc(dev, DRM_MINOR_CONTROL); 60221d70354SDave Airlie if (ret) 60321d70354SDave Airlie goto err_minors; 604bcfe0c09SGustavo Padovan 605bcfe0c09SGustavo Padovan WARN_ON(driver->suspend || driver->resume); 60621d70354SDave Airlie } 60721d70354SDave Airlie 60821d70354SDave Airlie if (drm_core_check_feature(dev, DRIVER_RENDER)) { 60921d70354SDave Airlie ret = drm_minor_alloc(dev, DRM_MINOR_RENDER); 61021d70354SDave Airlie if (ret) 61121d70354SDave Airlie goto err_minors; 61221d70354SDave Airlie } 61321d70354SDave Airlie 61421d70354SDave Airlie ret = drm_minor_alloc(dev, DRM_MINOR_LEGACY); 61521d70354SDave Airlie if (ret) 61621d70354SDave Airlie goto err_minors; 61721d70354SDave Airlie 61821d70354SDave Airlie if (drm_ht_create(&dev->map_hash, 12)) 61921d70354SDave Airlie goto err_minors; 62021d70354SDave Airlie 621ba6976c1SDaniel Vetter drm_legacy_ctxbitmap_init(dev); 62221d70354SDave Airlie 6231bcecfacSAndrzej Hajda if (drm_core_check_feature(dev, DRIVER_GEM)) { 62421d70354SDave Airlie ret = drm_gem_init(dev); 62521d70354SDave Airlie if (ret) { 62621d70354SDave Airlie DRM_ERROR("Cannot initialize graphics execution manager (GEM)\n"); 62721d70354SDave Airlie goto err_ctxbitmap; 62821d70354SDave Airlie } 62921d70354SDave Airlie } 63021d70354SDave Airlie 63121d70354SDave Airlie return dev; 63221d70354SDave Airlie 63321d70354SDave Airlie err_ctxbitmap: 63421d70354SDave Airlie drm_legacy_ctxbitmap_cleanup(dev); 63521d70354SDave Airlie drm_ht_remove(&dev->map_hash); 63621d70354SDave Airlie err_minors: 63721d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_LEGACY); 63821d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_RENDER); 63921d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_CONTROL); 64021d70354SDave Airlie drm_fs_inode_free(dev->anon_inode); 64121d70354SDave Airlie err_free: 64221d70354SDave Airlie mutex_destroy(&dev->master_mutex); 64321d70354SDave Airlie kfree(dev); 64421d70354SDave Airlie return NULL; 64521d70354SDave Airlie } 64621d70354SDave Airlie EXPORT_SYMBOL(drm_dev_alloc); 64721d70354SDave Airlie 64821d70354SDave Airlie static void drm_dev_release(struct kref *ref) 64921d70354SDave Airlie { 65021d70354SDave Airlie struct drm_device *dev = container_of(ref, struct drm_device, ref); 65121d70354SDave Airlie 6521bcecfacSAndrzej Hajda if (drm_core_check_feature(dev, DRIVER_GEM)) 65321d70354SDave Airlie drm_gem_destroy(dev); 65421d70354SDave Airlie 65521d70354SDave Airlie drm_legacy_ctxbitmap_cleanup(dev); 65621d70354SDave Airlie drm_ht_remove(&dev->map_hash); 65721d70354SDave Airlie drm_fs_inode_free(dev->anon_inode); 65821d70354SDave Airlie 65921d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_LEGACY); 66021d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_RENDER); 66121d70354SDave Airlie drm_minor_free(dev, DRM_MINOR_CONTROL); 66221d70354SDave Airlie 66321d70354SDave Airlie mutex_destroy(&dev->master_mutex); 66421d70354SDave Airlie kfree(dev->unique); 66521d70354SDave Airlie kfree(dev); 66621d70354SDave Airlie } 66721d70354SDave Airlie 66821d70354SDave Airlie /** 66921d70354SDave Airlie * drm_dev_ref - Take reference of a DRM device 67021d70354SDave Airlie * @dev: device to take reference of or NULL 67121d70354SDave Airlie * 67221d70354SDave Airlie * This increases the ref-count of @dev by one. You *must* already own a 67321d70354SDave Airlie * reference when calling this. Use drm_dev_unref() to drop this reference 67421d70354SDave Airlie * again. 67521d70354SDave Airlie * 67621d70354SDave Airlie * This function never fails. However, this function does not provide *any* 67721d70354SDave Airlie * guarantee whether the device is alive or running. It only provides a 67821d70354SDave Airlie * reference to the object and the memory associated with it. 67921d70354SDave Airlie */ 68021d70354SDave Airlie void drm_dev_ref(struct drm_device *dev) 68121d70354SDave Airlie { 68221d70354SDave Airlie if (dev) 68321d70354SDave Airlie kref_get(&dev->ref); 68421d70354SDave Airlie } 68521d70354SDave Airlie EXPORT_SYMBOL(drm_dev_ref); 68621d70354SDave Airlie 68721d70354SDave Airlie /** 68821d70354SDave Airlie * drm_dev_unref - Drop reference of a DRM device 68921d70354SDave Airlie * @dev: device to drop reference of or NULL 69021d70354SDave Airlie * 69121d70354SDave Airlie * This decreases the ref-count of @dev by one. The device is destroyed if the 69221d70354SDave Airlie * ref-count drops to zero. 69321d70354SDave Airlie */ 69421d70354SDave Airlie void drm_dev_unref(struct drm_device *dev) 69521d70354SDave Airlie { 69621d70354SDave Airlie if (dev) 69721d70354SDave Airlie kref_put(&dev->ref, drm_dev_release); 69821d70354SDave Airlie } 69921d70354SDave Airlie EXPORT_SYMBOL(drm_dev_unref); 70021d70354SDave Airlie 70121d70354SDave Airlie /** 70221d70354SDave Airlie * drm_dev_register - Register DRM device 70321d70354SDave Airlie * @dev: Device to register 70421d70354SDave Airlie * @flags: Flags passed to the driver's .load() function 70521d70354SDave Airlie * 70621d70354SDave Airlie * Register the DRM device @dev with the system, advertise device to user-space 70721d70354SDave Airlie * and start normal device operation. @dev must be allocated via drm_dev_alloc() 70821d70354SDave Airlie * previously. 70921d70354SDave Airlie * 71021d70354SDave Airlie * Never call this twice on any device! 71121d70354SDave Airlie * 7126e3f797cSDaniel Vetter * NOTE: To ensure backward compatibility with existing drivers method this 7136e3f797cSDaniel Vetter * function calls the ->load() method after registering the device nodes, 7146e3f797cSDaniel Vetter * creating race conditions. Usage of the ->load() methods is therefore 7156e3f797cSDaniel Vetter * deprecated, drivers must perform all initialization before calling 7166e3f797cSDaniel Vetter * drm_dev_register(). 7176e3f797cSDaniel Vetter * 71821d70354SDave Airlie * RETURNS: 71921d70354SDave Airlie * 0 on success, negative error code on failure. 72021d70354SDave Airlie */ 72121d70354SDave Airlie int drm_dev_register(struct drm_device *dev, unsigned long flags) 72221d70354SDave Airlie { 72321d70354SDave Airlie int ret; 72421d70354SDave Airlie 72521d70354SDave Airlie mutex_lock(&drm_global_mutex); 72621d70354SDave Airlie 72721d70354SDave Airlie ret = drm_minor_register(dev, DRM_MINOR_CONTROL); 72821d70354SDave Airlie if (ret) 72921d70354SDave Airlie goto err_minors; 73021d70354SDave Airlie 73121d70354SDave Airlie ret = drm_minor_register(dev, DRM_MINOR_RENDER); 73221d70354SDave Airlie if (ret) 73321d70354SDave Airlie goto err_minors; 73421d70354SDave Airlie 73521d70354SDave Airlie ret = drm_minor_register(dev, DRM_MINOR_LEGACY); 73621d70354SDave Airlie if (ret) 73721d70354SDave Airlie goto err_minors; 73821d70354SDave Airlie 73921d70354SDave Airlie if (dev->driver->load) { 74021d70354SDave Airlie ret = dev->driver->load(dev, flags); 74121d70354SDave Airlie if (ret) 74221d70354SDave Airlie goto err_minors; 74321d70354SDave Airlie } 74421d70354SDave Airlie 74521d70354SDave Airlie ret = 0; 74621d70354SDave Airlie goto out_unlock; 74721d70354SDave Airlie 74821d70354SDave Airlie err_minors: 74921d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_LEGACY); 75021d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_RENDER); 75121d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_CONTROL); 75221d70354SDave Airlie out_unlock: 75321d70354SDave Airlie mutex_unlock(&drm_global_mutex); 75421d70354SDave Airlie return ret; 75521d70354SDave Airlie } 75621d70354SDave Airlie EXPORT_SYMBOL(drm_dev_register); 75721d70354SDave Airlie 75821d70354SDave Airlie /** 75921d70354SDave Airlie * drm_dev_unregister - Unregister DRM device 76021d70354SDave Airlie * @dev: Device to unregister 76121d70354SDave Airlie * 76221d70354SDave Airlie * Unregister the DRM device from the system. This does the reverse of 76321d70354SDave Airlie * drm_dev_register() but does not deallocate the device. The caller must call 76421d70354SDave Airlie * drm_dev_unref() to drop their final reference. 7656e3f797cSDaniel Vetter * 7666e3f797cSDaniel Vetter * This should be called first in the device teardown code to make sure 7676e3f797cSDaniel Vetter * userspace can't access the device instance any more. 76821d70354SDave Airlie */ 76921d70354SDave Airlie void drm_dev_unregister(struct drm_device *dev) 77021d70354SDave Airlie { 77121d70354SDave Airlie struct drm_map_list *r_list, *list_temp; 77221d70354SDave Airlie 77321d70354SDave Airlie drm_lastclose(dev); 77421d70354SDave Airlie 77521d70354SDave Airlie if (dev->driver->unload) 77621d70354SDave Airlie dev->driver->unload(dev); 77721d70354SDave Airlie 77821d70354SDave Airlie if (dev->agp) 77921d70354SDave Airlie drm_pci_agp_destroy(dev); 78021d70354SDave Airlie 78121d70354SDave Airlie drm_vblank_cleanup(dev); 78221d70354SDave Airlie 78321d70354SDave Airlie list_for_each_entry_safe(r_list, list_temp, &dev->maplist, head) 7849fc5cde7SDavid Herrmann drm_legacy_rmmap(dev, r_list->map); 78521d70354SDave Airlie 78621d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_LEGACY); 78721d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_RENDER); 78821d70354SDave Airlie drm_minor_unregister(dev, DRM_MINOR_CONTROL); 78921d70354SDave Airlie } 79021d70354SDave Airlie EXPORT_SYMBOL(drm_dev_unregister); 79121d70354SDave Airlie 79221d70354SDave Airlie /** 79321d70354SDave Airlie * drm_dev_set_unique - Set the unique name of a DRM device 79421d70354SDave Airlie * @dev: device of which to set the unique name 79521d70354SDave Airlie * @fmt: format string for unique name 79621d70354SDave Airlie * 79721d70354SDave Airlie * Sets the unique name of a DRM device using the specified format string and 79821d70354SDave Airlie * a variable list of arguments. Drivers can use this at driver probe time if 79921d70354SDave Airlie * the unique name of the devices they drive is static. 80021d70354SDave Airlie * 80121d70354SDave Airlie * Return: 0 on success or a negative error code on failure. 80221d70354SDave Airlie */ 80321d70354SDave Airlie int drm_dev_set_unique(struct drm_device *dev, const char *fmt, ...) 80421d70354SDave Airlie { 80521d70354SDave Airlie va_list ap; 80621d70354SDave Airlie 80721d70354SDave Airlie kfree(dev->unique); 80821d70354SDave Airlie 80921d70354SDave Airlie va_start(ap, fmt); 81021d70354SDave Airlie dev->unique = kvasprintf(GFP_KERNEL, fmt, ap); 81121d70354SDave Airlie va_end(ap); 81221d70354SDave Airlie 81321d70354SDave Airlie return dev->unique ? 0 : -ENOMEM; 81421d70354SDave Airlie } 81521d70354SDave Airlie EXPORT_SYMBOL(drm_dev_set_unique); 81621d70354SDave Airlie 81721d70354SDave Airlie /* 81821d70354SDave Airlie * DRM Core 81921d70354SDave Airlie * The DRM core module initializes all global DRM objects and makes them 82021d70354SDave Airlie * available to drivers. Once setup, drivers can probe their respective 82121d70354SDave Airlie * devices. 82221d70354SDave Airlie * Currently, core management includes: 82321d70354SDave Airlie * - The "DRM-Global" key/value database 82421d70354SDave Airlie * - Global ID management for connectors 82521d70354SDave Airlie * - DRM major number allocation 82621d70354SDave Airlie * - DRM minor management 82721d70354SDave Airlie * - DRM sysfs class 82821d70354SDave Airlie * - DRM debugfs root 82921d70354SDave Airlie * 83021d70354SDave Airlie * Furthermore, the DRM core provides dynamic char-dev lookups. For each 83121d70354SDave Airlie * interface registered on a DRM device, you can request minor numbers from DRM 83221d70354SDave Airlie * core. DRM core takes care of major-number management and char-dev 83321d70354SDave Airlie * registration. A stub ->open() callback forwards any open() requests to the 83421d70354SDave Airlie * registered minor. 83521d70354SDave Airlie */ 83621d70354SDave Airlie 83721d70354SDave Airlie static int drm_stub_open(struct inode *inode, struct file *filp) 83821d70354SDave Airlie { 83921d70354SDave Airlie const struct file_operations *new_fops; 84021d70354SDave Airlie struct drm_minor *minor; 84121d70354SDave Airlie int err; 84221d70354SDave Airlie 84321d70354SDave Airlie DRM_DEBUG("\n"); 84421d70354SDave Airlie 84521d70354SDave Airlie mutex_lock(&drm_global_mutex); 84621d70354SDave Airlie minor = drm_minor_acquire(iminor(inode)); 84721d70354SDave Airlie if (IS_ERR(minor)) { 84821d70354SDave Airlie err = PTR_ERR(minor); 84921d70354SDave Airlie goto out_unlock; 85021d70354SDave Airlie } 85121d70354SDave Airlie 85221d70354SDave Airlie new_fops = fops_get(minor->dev->driver->fops); 85321d70354SDave Airlie if (!new_fops) { 85421d70354SDave Airlie err = -ENODEV; 85521d70354SDave Airlie goto out_release; 85621d70354SDave Airlie } 85721d70354SDave Airlie 85821d70354SDave Airlie replace_fops(filp, new_fops); 85921d70354SDave Airlie if (filp->f_op->open) 86021d70354SDave Airlie err = filp->f_op->open(inode, filp); 86121d70354SDave Airlie else 86221d70354SDave Airlie err = 0; 86321d70354SDave Airlie 86421d70354SDave Airlie out_release: 86521d70354SDave Airlie drm_minor_release(minor); 86621d70354SDave Airlie out_unlock: 86721d70354SDave Airlie mutex_unlock(&drm_global_mutex); 86821d70354SDave Airlie return err; 86921d70354SDave Airlie } 87021d70354SDave Airlie 87121d70354SDave Airlie static const struct file_operations drm_stub_fops = { 87221d70354SDave Airlie .owner = THIS_MODULE, 87321d70354SDave Airlie .open = drm_stub_open, 87421d70354SDave Airlie .llseek = noop_llseek, 87521d70354SDave Airlie }; 87621d70354SDave Airlie 87721d70354SDave Airlie static int __init drm_core_init(void) 87821d70354SDave Airlie { 87921d70354SDave Airlie int ret = -ENOMEM; 88021d70354SDave Airlie 88121d70354SDave Airlie drm_global_init(); 88221d70354SDave Airlie drm_connector_ida_init(); 88321d70354SDave Airlie idr_init(&drm_minors_idr); 88421d70354SDave Airlie 88521d70354SDave Airlie if (register_chrdev(DRM_MAJOR, "drm", &drm_stub_fops)) 88621d70354SDave Airlie goto err_p1; 88721d70354SDave Airlie 888fcc90213SDavid Herrmann ret = drm_sysfs_init(); 889fcc90213SDavid Herrmann if (ret < 0) { 89021d70354SDave Airlie printk(KERN_ERR "DRM: Error creating drm class.\n"); 89121d70354SDave Airlie goto err_p2; 89221d70354SDave Airlie } 89321d70354SDave Airlie 89421d70354SDave Airlie drm_debugfs_root = debugfs_create_dir("dri", NULL); 89521d70354SDave Airlie if (!drm_debugfs_root) { 89621d70354SDave Airlie DRM_ERROR("Cannot create /sys/kernel/debug/dri\n"); 89721d70354SDave Airlie ret = -1; 89821d70354SDave Airlie goto err_p3; 89921d70354SDave Airlie } 90021d70354SDave Airlie 90121d70354SDave Airlie DRM_INFO("Initialized %s %d.%d.%d %s\n", 90221d70354SDave Airlie CORE_NAME, CORE_MAJOR, CORE_MINOR, CORE_PATCHLEVEL, CORE_DATE); 90321d70354SDave Airlie return 0; 90421d70354SDave Airlie err_p3: 90521d70354SDave Airlie drm_sysfs_destroy(); 90621d70354SDave Airlie err_p2: 90721d70354SDave Airlie unregister_chrdev(DRM_MAJOR, "drm"); 90821d70354SDave Airlie 90921d70354SDave Airlie idr_destroy(&drm_minors_idr); 91021d70354SDave Airlie err_p1: 91121d70354SDave Airlie return ret; 91221d70354SDave Airlie } 91321d70354SDave Airlie 91421d70354SDave Airlie static void __exit drm_core_exit(void) 91521d70354SDave Airlie { 91621d70354SDave Airlie debugfs_remove(drm_debugfs_root); 91721d70354SDave Airlie drm_sysfs_destroy(); 91821d70354SDave Airlie 91921d70354SDave Airlie unregister_chrdev(DRM_MAJOR, "drm"); 92021d70354SDave Airlie 92121d70354SDave Airlie drm_connector_ida_destroy(); 92221d70354SDave Airlie idr_destroy(&drm_minors_idr); 92321d70354SDave Airlie } 92421d70354SDave Airlie 92521d70354SDave Airlie module_init(drm_core_init); 92621d70354SDave Airlie module_exit(drm_core_exit); 927