[mirror_ubuntu-focal-kernel.git] / drivers / char / drm / drm_stub.c

/**
 * \file drm_stub.h
 * Stub support
 *
 * \author Rickard E. (Rik) Faith <faith@valinux.com>
 */

/*
 * Created: Fri Jan 19 10:48:35 2001 by faith@acm.org
 *
 * Copyright 2001 VA Linux Systems, Inc., Sunnyvale, California.
 * All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */

#include <linux/module.h>
#include <linux/moduleparam.h>
#include "drmP.h"
#include "drm_core.h"

unsigned int drm_cards_limit = 16;	/* Enough for one machine */
unsigned int drm_debug = 0;		/* 1 to enable debug output */
EXPORT_SYMBOL(drm_debug);

MODULE_AUTHOR( CORE_AUTHOR );
MODULE_DESCRIPTION( CORE_DESC );
MODULE_LICENSE("GPL and additional rights");
MODULE_PARM_DESC(cards_limit, "Maximum number of graphics cards");
MODULE_PARM_DESC(debug, "Enable debug output");

module_param_named(cards_limit, drm_cards_limit, int, 0444);
module_param_named(debug, drm_debug, int, 0666);

drm_head_t **drm_heads;
struct drm_sysfs_class *drm_class;
struct proc_dir_entry *drm_proc_root;

static int drm_fill_in_dev(drm_device_t *dev, struct pci_dev *pdev, const struct pci_device_id *ent, struct drm_driver *driver)
{
	int retcode;

	spin_lock_init(&dev->count_lock);
	init_timer( &dev->timer );
	sema_init( &dev->struct_sem, 1 );
	sema_init( &dev->ctxlist_sem, 1 );

	dev->pdev   = pdev;

#ifdef __alpha__
	dev->hose   = pdev->sysdata;
	dev->pci_domain = dev->hose->bus->number;
#else
	dev->pci_domain = 0;
#endif
	dev->pci_bus = pdev->bus->number;
	dev->pci_slot = PCI_SLOT(pdev->devfn);
	dev->pci_func = PCI_FUNC(pdev->devfn);
	dev->irq = pdev->irq;

	dev->maplist = drm_calloc(1, sizeof(*dev->maplist), DRM_MEM_MAPS);
	if (dev->maplist == NULL)
		return -ENOMEM;
	INIT_LIST_HEAD(&dev->maplist->head);

	/* the DRM has 6 basic counters */
	dev->counters = 6;
	dev->types[0]  = _DRM_STAT_LOCK;
	dev->types[1]  = _DRM_STAT_OPENS;
	dev->types[2]  = _DRM_STAT_CLOSES;
	dev->types[3]  = _DRM_STAT_IOCTLS;
	dev->types[4]  = _DRM_STAT_LOCKS;
	dev->types[5]  = _DRM_STAT_UNLOCKS;

	dev->driver = driver;
	
	if (dev->driver->preinit)
		if ((retcode = dev->driver->preinit(dev, ent->driver_data)))
			goto error_out_unreg;

	if (drm_core_has_AGP(dev)) {
		if (drm_device_is_agp(dev))
			dev->agp = drm_agp_init(dev);
		if (drm_core_check_feature(dev, DRIVER_REQUIRE_AGP) && (dev->agp == NULL)) {
			DRM_ERROR( "Cannot initialize the agpgart module.\n" );
			retcode = -EINVAL;
			goto error_out_unreg;
		}
		if (drm_core_has_MTRR(dev)) {
			if (dev->agp)
				dev->agp->agp_mtrr = mtrr_add( dev->agp->agp_info.aper_base,
							       dev->agp->agp_info.aper_size*1024*1024,
							       MTRR_TYPE_WRCOMB,
							       1 );
		}
	}

	retcode = drm_ctxbitmap_init( dev );
	if( retcode ) {
		DRM_ERROR( "Cannot allocate memory for context bitmap.\n" );
		goto error_out_unreg;
	}

	return 0;
	
error_out_unreg:
	drm_takedown(dev);
	return retcode;
}

/**
 * File \c open operation.
 *
 * \param inode device inode.
 * \param filp file pointer.
 *
 * Puts the dev->fops corresponding to the device minor number into
 * \p filp, call the \c open method, and restore the file operations.
 */
int drm_stub_open(struct inode *inode, struct file *filp)
{
	drm_device_t *dev = NULL;
	int minor = iminor(inode);
	int err = -ENODEV;
	struct file_operations *old_fops;
	
	DRM_DEBUG("\n");

	if (!((minor >= 0) && (minor < drm_cards_limit)))
		return -ENODEV;

	if (!drm_heads[minor])
		return -ENODEV;
	
	if (!(dev = drm_heads[minor]->dev))
		return -ENODEV;

	old_fops = filp->f_op;
	filp->f_op = fops_get(&dev->driver->fops);
	if (filp->f_op->open && (err = filp->f_op->open(inode, filp))) {
		fops_put(filp->f_op);
		filp->f_op = fops_get(old_fops);
	}
	fops_put(old_fops);

	return err;
}

/**
 * Get a secondary minor number.
 *
 * \param dev device data structure
 * \param sec-minor structure to hold the assigned minor
 * \return negative number on failure.
 *
 * Search an empty entry and initialize it to the given parameters, and
 * create the proc init entry via proc_init(). This routines assigns
 * minor numbers to secondary heads of multi-headed cards
 */
static int drm_get_head(drm_device_t *dev, drm_head_t *head)
{
	drm_head_t **heads = drm_heads;
	int ret;
	int minor;

	DRM_DEBUG("\n");

	for (minor = 0; minor < drm_cards_limit; minor++, heads++) {
		if (!*heads) {
			
			*head = (drm_head_t) {
				.dev = dev,
				.device = MKDEV(DRM_MAJOR, minor),
				.minor = minor,
			};
			
			if ((ret = drm_proc_init(dev, minor, drm_proc_root, &head->dev_root))) {
				printk (KERN_ERR "DRM: Failed to initialize /proc/dri.\n");
				goto err_g1;
			}

			
			head->dev_class = drm_sysfs_device_add(drm_class,
							       MKDEV(DRM_MAJOR,
								     minor),
							       &dev->pdev->dev,
							       "card%d", minor);
			if (IS_ERR(head->dev_class)) {
				printk(KERN_ERR "DRM: Error sysfs_device_add.\n");
				ret = PTR_ERR(head->dev_class);
				goto err_g2;
			}
			*heads = head;

			DRM_DEBUG("new minor assigned %d\n", minor);
			return 0;
		}
	}
	DRM_ERROR("out of minors\n");
	return -ENOMEM;
err_g2:
	drm_proc_cleanup(minor, drm_proc_root, head->dev_root);
err_g1:
	*head = (drm_head_t) {.dev = NULL};
	return ret;
}
		
/**
 * Register.
 *
 * \param pdev - PCI device structure
 * \param ent entry from the PCI ID table with device type flags
 * \return zero on success or a negative number on failure.
 *
 * Attempt to gets inter module "drm" information. If we are first
 * then register the character device and inter module information.
 * Try and register, if we fail to register, backout previous work.
 */
int drm_get_dev(struct pci_dev *pdev, const struct pci_device_id *ent,
	      struct drm_driver *driver)
{
	drm_device_t *dev;
	int ret;

	DRM_DEBUG("\n");

	dev = drm_calloc(1, sizeof(*dev), DRM_MEM_STUB);
	if (!dev)
		return -ENOMEM;

	pci_enable_device(pdev);

	if ((ret = drm_fill_in_dev(dev, pdev, ent, driver))) {
		printk(KERN_ERR "DRM: Fill_in_dev failed.\n");
		goto err_g1;
	}
	if ((ret = drm_get_head(dev, &dev->primary)))
		goto err_g1;

	/* postinit is a required function to display the signon banner */
	/* drivers add secondary heads here if needed */
	if ((ret = dev->driver->postinit(dev, ent->driver_data)))
		goto err_g1;

	return 0;

err_g1:
	drm_free(dev, sizeof(*dev), DRM_MEM_STUB);
	return ret;
}
EXPORT_SYMBOL(drm_get_dev);

/**
 * Put a device minor number.
 *
 * \param dev device data structure
 * \return always zero
 *
 * Cleans up the proc resources. If it is the last minor then release the foreign
 * "drm" data, otherwise unregisters the "drm" data, frees the dev list and
 * unregisters the character device.
 */
int drm_put_dev(drm_device_t * dev)
{
	DRM_DEBUG("release primary %s\n", dev->driver->pci_driver.name);

	if (dev->unique) {
		drm_free(dev->unique, strlen(dev->unique) + 1, DRM_MEM_DRIVER);
		dev->unique = NULL;
		dev->unique_len = 0;
	}
	if (dev->devname) {
		drm_free(dev->devname, strlen(dev->devname) + 1,
			 DRM_MEM_DRIVER);
		dev->devname = NULL;
	}
	drm_free(dev, sizeof(*dev), DRM_MEM_STUB);
	return 0;
}

/**
 * Put a secondary minor number.
 *
 * \param sec_minor - structure to be released
 * \return always zero
 *
 * Cleans up the proc resources. Not legal for this to be the
 * last minor released.
 *
 */
int drm_put_head(drm_head_t *head)
{
	int minor = head->minor;
	
	DRM_DEBUG("release secondary minor %d\n", minor);
	
	drm_proc_cleanup(minor, drm_proc_root, head->dev_root);
	drm_sysfs_device_remove(MKDEV(DRM_MAJOR, head->minor));
	
	*head = (drm_head_t){.dev = NULL};

	drm_heads[minor] = NULL;
	
	return 0;
}
Commit	Line	Data
1da177e4 LT	1	/**
	2	* \file drm_stub.h
	3	* Stub support
	4	*
	5	* \author Rickard E. (Rik) Faith <faith@valinux.com>
	6	*/
	7
	8	/*
	9	* Created: Fri Jan 19 10:48:35 2001 by faith@acm.org
	10	*
	11	* Copyright 2001 VA Linux Systems, Inc., Sunnyvale, California.
	12	* All Rights Reserved.
	13	*
	14	* Permission is hereby granted, free of charge, to any person obtaining a
	15	* copy of this software and associated documentation files (the "Software"),
	16	* to deal in the Software without restriction, including without limitation
	17	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
	18	* and/or sell copies of the Software, and to permit persons to whom the
	19	* Software is furnished to do so, subject to the following conditions:
	20	*
	21	* The above copyright notice and this permission notice (including the next
	22	* paragraph) shall be included in all copies or substantial portions of the
	23	* Software.
	24	*
	25	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	26	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	27	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	28	* PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
	29	* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
	30	* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
	31	* DEALINGS IN THE SOFTWARE.
	32	*/
	33
	34	#include <linux/module.h>
	35	#include <linux/moduleparam.h>
	36	#include "drmP.h"
	37	#include "drm_core.h"
	38
	39	unsigned int drm_cards_limit = 16; /* Enough for one machine */
	40	unsigned int drm_debug = 0; /* 1 to enable debug output */
	41	EXPORT_SYMBOL(drm_debug);
	42
	43	MODULE_AUTHOR( CORE_AUTHOR );
	44	MODULE_DESCRIPTION( CORE_DESC );
	45	MODULE_LICENSE("GPL and additional rights");
	46	MODULE_PARM_DESC(cards_limit, "Maximum number of graphics cards");
	47	MODULE_PARM_DESC(debug, "Enable debug output");
	48
	49	module_param_named(cards_limit, drm_cards_limit, int, 0444);
	50	module_param_named(debug, drm_debug, int, 0666);
	51
	52	drm_head_t **drm_heads;
	53	struct drm_sysfs_class *drm_class;
	54	struct proc_dir_entry *drm_proc_root;
	55
	56	static int drm_fill_in_dev(drm_device_t dev, struct pci_dev pdev, const struct pci_device_id ent, struct drm_driver driver)
	57	{
	58	int retcode;
	59
	60	spin_lock_init(&dev->count_lock);
	61	init_timer( &dev->timer );
	62	sema_init( &dev->struct_sem, 1 );
	63	sema_init( &dev->ctxlist_sem, 1 );
	64
65	dev->pdev = pdev;
66
67	#ifdef __alpha__
68	dev->hose = pdev->sysdata;
69	dev->pci_domain = dev->hose->bus->number;
70	#else
71	dev->pci_domain = 0;
72	#endif
73	dev->pci_bus = pdev->bus->number;
74	dev->pci_slot = PCI_SLOT(pdev->devfn);
75	dev->pci_func = PCI_FUNC(pdev->devfn);
76	dev->irq = pdev->irq;
77
836cf046 DA	78	dev->maplist = drm_calloc(1, sizeof(*dev->maplist), DRM_MEM_MAPS);
	79	if (dev->maplist == NULL)
	80	return -ENOMEM;
	81	INIT_LIST_HEAD(&dev->maplist->head);
	82
1da177e4 LT	83	/* the DRM has 6 basic counters */
	84	dev->counters = 6;
	85	dev->types[0] = _DRM_STAT_LOCK;
	86	dev->types[1] = _DRM_STAT_OPENS;
	87	dev->types[2] = _DRM_STAT_CLOSES;
	88	dev->types[3] = _DRM_STAT_IOCTLS;
	89	dev->types[4] = _DRM_STAT_LOCKS;
	90	dev->types[5] = _DRM_STAT_UNLOCKS;
	91
	92	dev->driver = driver;
	93
	94	if (dev->driver->preinit)
	95	if ((retcode = dev->driver->preinit(dev, ent->driver_data)))
	96	goto error_out_unreg;
	97
	98	if (drm_core_has_AGP(dev)) {
cda17380 DA	99	if (drm_device_is_agp(dev))
cda17380 DA	100	dev->agp = drm_agp_init(dev);
1da177e4 LT	101	if (drm_core_check_feature(dev, DRIVER_REQUIRE_AGP) && (dev->agp == NULL)) {
	102	DRM_ERROR( "Cannot initialize the agpgart module.\n" );
	103	retcode = -EINVAL;
	104	goto error_out_unreg;
	105	}
	106	if (drm_core_has_MTRR(dev)) {
	107	if (dev->agp)
	108	dev->agp->agp_mtrr = mtrr_add( dev->agp->agp_info.aper_base,
	109	dev->agp->agp_info.aper_size10241024,
	110	MTRR_TYPE_WRCOMB,
	111	1 );
	112	}
	113	}
	114
	115	retcode = drm_ctxbitmap_init( dev );
	116	if( retcode ) {
	117	DRM_ERROR( "Cannot allocate memory for context bitmap.\n" );
	118	goto error_out_unreg;
	119	}
	120
	121	return 0;
	122
	123	error_out_unreg:
	124	drm_takedown(dev);
	125	return retcode;
	126	}
	127
	128	/**
	129	* File \c open operation.
	130	*
	131	* \param inode device inode.
	132	* \param filp file pointer.
	133	*
	134	* Puts the dev->fops corresponding to the device minor number into
	135	* \p filp, call the \c open method, and restore the file operations.
	136	*/
	137	int drm_stub_open(struct inode inode, struct file filp)
	138	{
	139	drm_device_t *dev = NULL;
	140	int minor = iminor(inode);
	141	int err = -ENODEV;
	142	struct file_operations *old_fops;
	143
	144	DRM_DEBUG("\n");
	145
	146	if (!((minor >= 0) && (minor < drm_cards_limit)))
	147	return -ENODEV;
	148
	149	if (!drm_heads[minor])
	150	return -ENODEV;
	151
	152	if (!(dev = drm_heads[minor]->dev))
	153	return -ENODEV;
	154
	155	old_fops = filp->f_op;
	156	filp->f_op = fops_get(&dev->driver->fops);
	157	if (filp->f_op->open && (err = filp->f_op->open(inode, filp))) {
	158	fops_put(filp->f_op);
	159	filp->f_op = fops_get(old_fops);
	160	}
	161	fops_put(old_fops);
	162
	163	return err;
	164	}
165
1da177e4 LT	166	/**
	167	* Get a secondary minor number.
	168	*
	169	* \param dev device data structure
	170	* \param sec-minor structure to hold the assigned minor
	171	* \return negative number on failure.
	172	*
	173	* Search an empty entry and initialize it to the given parameters, and
	174	* create the proc init entry via proc_init(). This routines assigns
	175	* minor numbers to secondary heads of multi-headed cards
	176	*/
c94f7029	177	static int drm_get_head(drm_device_t dev, drm_head_t head)
1da177e4 LT	178	{
	179	drm_head_t **heads = drm_heads;
	180	int ret;
	181	int minor;
	182
	183	DRM_DEBUG("\n");
	184
	185	for (minor = 0; minor < drm_cards_limit; minor++, heads++) {
	186	if (!*heads) {
	187
	188	*head = (drm_head_t) {
	189	.dev = dev,
	190	.device = MKDEV(DRM_MAJOR, minor),
	191	.minor = minor,
	192	};
	193
	194	if ((ret = drm_proc_init(dev, minor, drm_proc_root, &head->dev_root))) {
	195	printk (KERN_ERR "DRM: Failed to initialize /proc/dri.\n");
	196	goto err_g1;
	197	}
	198
	199
	200	head->dev_class = drm_sysfs_device_add(drm_class,
	201	MKDEV(DRM_MAJOR,
	202	minor),
	203	&dev->pdev->dev,
	204	"card%d", minor);
	205	if (IS_ERR(head->dev_class)) {
	206	printk(KERN_ERR "DRM: Error sysfs_device_add.\n");
	207	ret = PTR_ERR(head->dev_class);
	208	goto err_g2;
	209	}
	210	*heads = head;
	211
	212	DRM_DEBUG("new minor assigned %d\n", minor);
	213	return 0;
	214	}
	215	}
	216	DRM_ERROR("out of minors\n");
	217	return -ENOMEM;
	218	err_g2:
	219	drm_proc_cleanup(minor, drm_proc_root, head->dev_root);
	220	err_g1:
	221	*head = (drm_head_t) {.dev = NULL};
	222	return ret;
	223	}
	224
c94f7029 DA	225	/**
	226	* Register.
	227	*
	228	* \param pdev - PCI device structure
	229	* \param ent entry from the PCI ID table with device type flags
	230	* \return zero on success or a negative number on failure.
	231	*
	232	* Attempt to gets inter module "drm" information. If we are first
	233	* then register the character device and inter module information.
	234	* Try and register, if we fail to register, backout previous work.
	235	*/
	236	int drm_get_dev(struct pci_dev pdev, const struct pci_device_id ent,
	237	struct drm_driver *driver)
	238	{
	239	drm_device_t *dev;
	240	int ret;
	241
	242	DRM_DEBUG("\n");
	243
	244	dev = drm_calloc(1, sizeof(*dev), DRM_MEM_STUB);
	245	if (!dev)
	246	return -ENOMEM;
	247
	248	pci_enable_device(pdev);
	249
	250	if ((ret = drm_fill_in_dev(dev, pdev, ent, driver))) {
	251	printk(KERN_ERR "DRM: Fill_in_dev failed.\n");
	252	goto err_g1;
	253	}
	254	if ((ret = drm_get_head(dev, &dev->primary)))
	255	goto err_g1;
	256
	257	/* postinit is a required function to display the signon banner */
	258	/* drivers add secondary heads here if needed */
	259	if ((ret = dev->driver->postinit(dev, ent->driver_data)))
	260	goto err_g1;
	261
	262	return 0;
	263
	264	err_g1:
	265	drm_free(dev, sizeof(*dev), DRM_MEM_STUB);
	266	return ret;
	267	}
	268	EXPORT_SYMBOL(drm_get_dev);
1da177e4 LT	269
	270	/**
	271	* Put a device minor number.
	272	*
	273	* \param dev device data structure
	274	* \return always zero
	275	*
	276	* Cleans up the proc resources. If it is the last minor then release the foreign
	277	* "drm" data, otherwise unregisters the "drm" data, frees the dev list and
	278	* unregisters the character device.
	279	*/
	280	int drm_put_dev(drm_device_t * dev)
	281	{
	282	DRM_DEBUG("release primary %s\n", dev->driver->pci_driver.name);
	283
	284	if (dev->unique) {
	285	drm_free(dev->unique, strlen(dev->unique) + 1, DRM_MEM_DRIVER);
	286	dev->unique = NULL;
	287	dev->unique_len = 0;
	288	}
	289	if (dev->devname) {
	290	drm_free(dev->devname, strlen(dev->devname) + 1,
	291	DRM_MEM_DRIVER);
	292	dev->devname = NULL;
	293	}
	294	drm_free(dev, sizeof(*dev), DRM_MEM_STUB);
	295	return 0;
	296	}
	297
	298	/**
	299	* Put a secondary minor number.
	300	*
	301	* \param sec_minor - structure to be released
	302	* \return always zero
	303	*
	304	* Cleans up the proc resources. Not legal for this to be the
	305	* last minor released.
	306	*
	307	*/
	308	int drm_put_head(drm_head_t *head)
	309	{
	310	int minor = head->minor;
	311
	312	DRM_DEBUG("release secondary minor %d\n", minor);
	313
	314	drm_proc_cleanup(minor, drm_proc_root, head->dev_root);
	315	drm_sysfs_device_remove(MKDEV(DRM_MAJOR, head->minor));
	316
	317	*head = (drm_head_t){.dev = NULL};
	318
	319	drm_heads[minor] = NULL;
	320
	321	return 0;
	322	}
	323