[net-next-2.6.git] / drivers / char / drm / drm_context.c

/**
 * \file drm_context.c
 * IOCTLs for generic contexts
 *
 * \author Rickard E. (Rik) Faith <faith@valinux.com>
 * \author Gareth Hughes <gareth@valinux.com>
 */

/*
 * Created: Fri Nov 24 18:31:37 2000 by gareth@valinux.com
 *
 * Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
 * Copyright 2000 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
 * VA LINUX SYSTEMS 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.
 */

/*
 * ChangeLog:
 *  2001-11-16	Torsten Duwe <duwe@caldera.de>
 *		added context constructor/destructor hooks,
 *		needed by SiS driver's memory management.
 */

#include "drmP.h"

/******************************************************************/
/** \name Context bitmap support */
/*@{*/

/**
 * Free a handle from the context bitmap.
 *
 * \param dev DRM device.
 * \param ctx_handle context handle.
 *
 * Clears the bit specified by \p ctx_handle in drm_device::ctx_bitmap and the entry
 * in drm_device::ctx_idr, while holding the drm_device::struct_mutex
 * lock.
 */
void drm_ctxbitmap_free(struct drm_device * dev, int ctx_handle)
{
	mutex_lock(&dev->struct_mutex);
	idr_remove(&dev->ctx_idr, ctx_handle);
	mutex_unlock(&dev->struct_mutex);
}

/**
 * Context bitmap allocation.
 *
 * \param dev DRM device.
 * \return (non-negative) context handle on success or a negative number on failure.
 *
 * Allocate a new idr from drm_device::ctx_idr while holding the
 * drm_device::struct_mutex lock.
 */
static int drm_ctxbitmap_next(struct drm_device * dev)
{
	int new_id;
	int ret;

again:
	if (idr_pre_get(&dev->ctx_idr, GFP_KERNEL) == 0) {
		DRM_ERROR("Out of memory expanding drawable idr\n");
		return -ENOMEM;
	}
	mutex_lock(&dev->struct_mutex);
	ret = idr_get_new_above(&dev->ctx_idr, NULL,
				DRM_RESERVED_CONTEXTS, &new_id);
	if (ret == -EAGAIN) {
		mutex_unlock(&dev->struct_mutex);
		goto again;
	}
	mutex_unlock(&dev->struct_mutex);
	return new_id;
}

/**
 * Context bitmap initialization.
 *
 * \param dev DRM device.
 *
 * Initialise the drm_device::ctx_idr
 */
int drm_ctxbitmap_init(struct drm_device * dev)
{
	idr_init(&dev->ctx_idr);
	return 0;
}

/**
 * Context bitmap cleanup.
 *
 * \param dev DRM device.
 *
 * Free all idr members using drm_ctx_sarea_free helper function
 * while holding the drm_device::struct_mutex lock.
 */
void drm_ctxbitmap_cleanup(struct drm_device * dev)
{
	mutex_lock(&dev->struct_mutex);
	idr_remove_all(&dev->ctx_idr);
	mutex_unlock(&dev->struct_mutex);
}

/*@}*/

/******************************************************************/
/** \name Per Context SAREA Support */
/*@{*/

/**
 * Get per-context SAREA.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx_priv_map structure.
 * \return zero on success or a negative number on failure.
 *
 * Gets the map from drm_device::ctx_idr with the handle specified and
 * returns its handle.
 */
int drm_getsareactx(struct drm_device *dev, void *data,
		    struct drm_file *file_priv)
{
	struct drm_ctx_priv_map *request = data;
	struct drm_map *map;
	struct drm_map_list *_entry;

	mutex_lock(&dev->struct_mutex);

	map = idr_find(&dev->ctx_idr, request->ctx_id);
	if (!map) {
		mutex_unlock(&dev->struct_mutex);
		return -EINVAL;
	}

	mutex_unlock(&dev->struct_mutex);

	request->handle = NULL;
	list_for_each_entry(_entry, &dev->maplist, head) {
		if (_entry->map == map) {
			request->handle = 
			    (void *)(unsigned long)_entry->user_token;
			break;
		}
	}
	if (request->handle == NULL)
		return -EINVAL;

	return 0;
}

/**
 * Set per-context SAREA.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx_priv_map structure.
 * \return zero on success or a negative number on failure.
 *
 * Searches the mapping specified in \p arg and update the entry in
 * drm_device::ctx_idr with it.
 */
int drm_setsareactx(struct drm_device *dev, void *data,
		    struct drm_file *file_priv)
{
	struct drm_ctx_priv_map *request = data;
	struct drm_map *map = NULL;
	struct drm_map_list *r_list = NULL;

	mutex_lock(&dev->struct_mutex);
	list_for_each_entry(r_list, &dev->maplist, head) {
		if (r_list->map
		    && r_list->user_token == (unsigned long) request->handle)
			goto found;
	}
      bad:
	mutex_unlock(&dev->struct_mutex);
	return -EINVAL;

      found:
	map = r_list->map;
	if (!map)
		goto bad;

	if (IS_ERR(idr_replace(&dev->ctx_idr, map, request->ctx_id)))
		goto bad;

	mutex_unlock(&dev->struct_mutex);

	return 0;
}

/*@}*/

/******************************************************************/
/** \name The actual DRM context handling routines */
/*@{*/

/**
 * Switch context.
 *
 * \param dev DRM device.
 * \param old old context handle.
 * \param new new context handle.
 * \return zero on success or a negative number on failure.
 *
 * Attempt to set drm_device::context_flag.
 */
static int drm_context_switch(struct drm_device * dev, int old, int new)
{
	if (test_and_set_bit(0, &dev->context_flag)) {
		DRM_ERROR("Reentering -- FIXME\n");
		return -EBUSY;
	}

	DRM_DEBUG("Context switch from %d to %d\n", old, new);

	if (new == dev->last_context) {
		clear_bit(0, &dev->context_flag);
		return 0;
	}

	return 0;
}

/**
 * Complete context switch.
 *
 * \param dev DRM device.
 * \param new new context handle.
 * \return zero on success or a negative number on failure.
 *
 * Updates drm_device::last_context and drm_device::last_switch. Verifies the
 * hardware lock is held, clears the drm_device::context_flag and wakes up
 * drm_device::context_wait.
 */
static int drm_context_switch_complete(struct drm_device * dev, int new)
{
	dev->last_context = new;	/* PRE/POST: This is the _only_ writer. */
	dev->last_switch = jiffies;

	if (!_DRM_LOCK_IS_HELD(dev->lock.hw_lock->lock)) {
		DRM_ERROR("Lock isn't held after context switch\n");
	}

	/* If a context switch is ever initiated
	   when the kernel holds the lock, release
	   that lock here. */
	clear_bit(0, &dev->context_flag);
	wake_up(&dev->context_wait);

	return 0;
}

/**
 * Reserve contexts.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx_res structure.
 * \return zero on success or a negative number on failure.
 */
int drm_resctx(struct drm_device *dev, void *data,
	       struct drm_file *file_priv)
{
	struct drm_ctx_res *res = data;
	struct drm_ctx ctx;
	int i;

	if (res->count >= DRM_RESERVED_CONTEXTS) {
		memset(&ctx, 0, sizeof(ctx));
		for (i = 0; i < DRM_RESERVED_CONTEXTS; i++) {
			ctx.handle = i;
			if (copy_to_user(&res->contexts[i], &ctx, sizeof(ctx)))
				return -EFAULT;
		}
	}
	res->count = DRM_RESERVED_CONTEXTS;

	return 0;
}

/**
 * Add context.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx structure.
 * \return zero on success or a negative number on failure.
 *
 * Get a new handle for the context and copy to userspace.
 */
int drm_addctx(struct drm_device *dev, void *data,
	       struct drm_file *file_priv)
{
	struct drm_ctx_list *ctx_entry;
	struct drm_ctx *ctx = data;

	ctx->handle = drm_ctxbitmap_next(dev);
	if (ctx->handle == DRM_KERNEL_CONTEXT) {
		/* Skip kernel's context and get a new one. */
		ctx->handle = drm_ctxbitmap_next(dev);
	}
	DRM_DEBUG("%d\n", ctx->handle);
	if (ctx->handle == -1) {
		DRM_DEBUG("Not enough free contexts.\n");
		/* Should this return -EBUSY instead? */
		return -ENOMEM;
	}

	if (ctx->handle != DRM_KERNEL_CONTEXT) {
		if (dev->driver->context_ctor)
			if (!dev->driver->context_ctor(dev, ctx->handle)) {
				DRM_DEBUG("Running out of ctxs or memory.\n");
				return -ENOMEM;
			}
	}

	ctx_entry = drm_alloc(sizeof(*ctx_entry), DRM_MEM_CTXLIST);
	if (!ctx_entry) {
		DRM_DEBUG("out of memory\n");
		return -ENOMEM;
	}

	INIT_LIST_HEAD(&ctx_entry->head);
	ctx_entry->handle = ctx->handle;
	ctx_entry->tag = file_priv;

	mutex_lock(&dev->ctxlist_mutex);
	list_add(&ctx_entry->head, &dev->ctxlist);
	++dev->ctx_count;
	mutex_unlock(&dev->ctxlist_mutex);

	return 0;
}

int drm_modctx(struct drm_device *dev, void *data, struct drm_file *file_priv)
{
	/* This does nothing */
	return 0;
}

/**
 * Get context.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx structure.
 * \return zero on success or a negative number on failure.
 */
int drm_getctx(struct drm_device *dev, void *data, struct drm_file *file_priv)
{
	struct drm_ctx *ctx = data;

	/* This is 0, because we don't handle any context flags */
	ctx->flags = 0;

	return 0;
}

/**
 * Switch context.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx structure.
 * \return zero on success or a negative number on failure.
 *
 * Calls context_switch().
 */
int drm_switchctx(struct drm_device *dev, void *data,
		  struct drm_file *file_priv)
{
	struct drm_ctx *ctx = data;

	DRM_DEBUG("%d\n", ctx->handle);
	return drm_context_switch(dev, dev->last_context, ctx->handle);
}

/**
 * New context.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx structure.
 * \return zero on success or a negative number on failure.
 *
 * Calls context_switch_complete().
 */
int drm_newctx(struct drm_device *dev, void *data,
	       struct drm_file *file_priv)
{
	struct drm_ctx *ctx = data;

	DRM_DEBUG("%d\n", ctx->handle);
	drm_context_switch_complete(dev, ctx->handle);

	return 0;
}

/**
 * Remove context.
 *
 * \param inode device inode.
 * \param file_priv DRM file private.
 * \param cmd command.
 * \param arg user argument pointing to a drm_ctx structure.
 * \return zero on success or a negative number on failure.
 *
 * If not the special kernel context, calls ctxbitmap_free() to free the specified context.
 */
int drm_rmctx(struct drm_device *dev, void *data,
	      struct drm_file *file_priv)
{
	struct drm_ctx *ctx = data;

	DRM_DEBUG("%d\n", ctx->handle);
	if (ctx->handle == DRM_KERNEL_CONTEXT + 1) {
		file_priv->remove_auth_on_close = 1;
	}
	if (ctx->handle != DRM_KERNEL_CONTEXT) {
		if (dev->driver->context_dtor)
			dev->driver->context_dtor(dev, ctx->handle);
		drm_ctxbitmap_free(dev, ctx->handle);
	}

	mutex_lock(&dev->ctxlist_mutex);
	if (!list_empty(&dev->ctxlist)) {
		struct drm_ctx_list *pos, *n;

		list_for_each_entry_safe(pos, n, &dev->ctxlist, head) {
			if (pos->handle == ctx->handle) {
				list_del(&pos->head);
				drm_free(pos, sizeof(*pos), DRM_MEM_CTXLIST);
				--dev->ctx_count;
			}
		}
	}
	mutex_unlock(&dev->ctxlist_mutex);

	return 0;
}

/*@}*/
Commit	Line	Data
1da177e4	1	/**
b5e89ed5	2	* \file drm_context.c
1da177e4	3	* IOCTLs for generic contexts
b5e89ed5	4	*
1da177e4 LT	5	* \author Rickard E. (Rik) Faith <faith@valinux.com>
	6	* \author Gareth Hughes <gareth@valinux.com>
	7	*/
	8
	9	/*
	10	* Created: Fri Nov 24 18:31:37 2000 by gareth@valinux.com
	11	*
	12	* Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
	13	* Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
	14	* All Rights Reserved.
	15	*
	16	* Permission is hereby granted, free of charge, to any person obtaining a
	17	* copy of this software and associated documentation files (the "Software"),
	18	* to deal in the Software without restriction, including without limitation
	19	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
	20	* and/or sell copies of the Software, and to permit persons to whom the
	21	* Software is furnished to do so, subject to the following conditions:
	22	*
	23	* The above copyright notice and this permission notice (including the next
	24	* paragraph) shall be included in all copies or substantial portions of the
	25	* Software.
	26	*
	27	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	28	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	29	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	30	* VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
	31	* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
	32	* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
	33	* OTHER DEALINGS IN THE SOFTWARE.
	34	*/
	35
	36	/*
	37	* ChangeLog:
	38	* 2001-11-16 Torsten Duwe <duwe@caldera.de>
	39	* added context constructor/destructor hooks,
	40	* needed by SiS driver's memory management.
	41	*/
	42
	43	#include "drmP.h"
	44
	45	/******************************************************************/
	46	/** \name Context bitmap support */
	47	/@{/
	48
	49	/**
	50	* Free a handle from the context bitmap.
	51	*
	52	* \param dev DRM device.
	53	* \param ctx_handle context handle.
	54	*
	55	* Clears the bit specified by \p ctx_handle in drm_device::ctx_bitmap and the entry
62968144	56	* in drm_device::ctx_idr, while holding the drm_device::struct_mutex
1da177e4 LT	57	* lock.
1da177e4 LT	58	*/
84b1fd10	59	void drm_ctxbitmap_free(struct drm_device * dev, int ctx_handle)
1da177e4	60	{
62968144 DA	61	mutex_lock(&dev->struct_mutex);
	62	idr_remove(&dev->ctx_idr, ctx_handle);
	63	mutex_unlock(&dev->struct_mutex);
1da177e4 LT	64	}
1da177e4 LT	65
b5e89ed5	66	/**
1da177e4 LT	67	* Context bitmap allocation.
	68	*
	69	* \param dev DRM device.
	70	* \return (non-negative) context handle on success or a negative number on failure.
	71	*
62968144	72	* Allocate a new idr from drm_device::ctx_idr while holding the
30e2fb18	73	* drm_device::struct_mutex lock.
1da177e4	74	*/
84b1fd10	75	static int drm_ctxbitmap_next(struct drm_device * dev)
1da177e4	76	{
62968144 DA	77	int new_id;
62968144 DA	78	int ret;
1da177e4	79
62968144 DA	80	again:
	81	if (idr_pre_get(&dev->ctx_idr, GFP_KERNEL) == 0) {
	82	DRM_ERROR("Out of memory expanding drawable idr\n");
	83	return -ENOMEM;
	84	}
30e2fb18	85	mutex_lock(&dev->struct_mutex);
62968144 DA	86	ret = idr_get_new_above(&dev->ctx_idr, NULL,
	87	DRM_RESERVED_CONTEXTS, &new_id);
	88	if (ret == -EAGAIN) {
30e2fb18	89	mutex_unlock(&dev->struct_mutex);
62968144	90	goto again;
1da177e4	91	}
30e2fb18	92	mutex_unlock(&dev->struct_mutex);
62968144	93	return new_id;
1da177e4 LT	94	}
	95
	96	/**
	97	* Context bitmap initialization.
	98	*
	99	* \param dev DRM device.
	100	*
62968144	101	* Initialise the drm_device::ctx_idr
1da177e4	102	*/
84b1fd10	103	int drm_ctxbitmap_init(struct drm_device * dev)
1da177e4	104	{
62968144	105	idr_init(&dev->ctx_idr);
1da177e4 LT	106	return 0;
	107	}
	108
	109	/**
	110	* Context bitmap cleanup.
	111	*
	112	* \param dev DRM device.
	113	*
62968144 DA	114	* Free all idr members using drm_ctx_sarea_free helper function
62968144 DA	115	* while holding the drm_device::struct_mutex lock.
1da177e4	116	*/
84b1fd10	117	void drm_ctxbitmap_cleanup(struct drm_device * dev)
1da177e4	118	{
30e2fb18	119	mutex_lock(&dev->struct_mutex);
62968144	120	idr_remove_all(&dev->ctx_idr);
30e2fb18	121	mutex_unlock(&dev->struct_mutex);
1da177e4 LT	122	}
	123
	124	/@}/
	125
	126	/******************************************************************/
	127	/** \name Per Context SAREA Support */
	128	/@{/
	129
	130	/**
	131	* Get per-context SAREA.
b5e89ed5	132	*
1da177e4	133	* \param inode device inode.
6c340eac	134	* \param file_priv DRM file private.
1da177e4 LT	135	* \param cmd command.
	136	* \param arg user argument pointing to a drm_ctx_priv_map structure.
	137	* \return zero on success or a negative number on failure.
	138	*
62968144	139	* Gets the map from drm_device::ctx_idr with the handle specified and
1da177e4 LT	140	* returns its handle.
1da177e4 LT	141	*/
c153f45f EA	142	int drm_getsareactx(struct drm_device dev, void data,
c153f45f EA	143	struct drm_file *file_priv)
1da177e4	144	{
c153f45f	145	struct drm_ctx_priv_map *request = data;
c60ce623	146	struct drm_map *map;
55910517	147	struct drm_map_list *_entry;
1da177e4	148
30e2fb18	149	mutex_lock(&dev->struct_mutex);
62968144	150
c153f45f	151	map = idr_find(&dev->ctx_idr, request->ctx_id);
62968144	152	if (!map) {
30e2fb18	153	mutex_unlock(&dev->struct_mutex);
1da177e4 LT	154	return -EINVAL;
	155	}
	156
30e2fb18	157	mutex_unlock(&dev->struct_mutex);
1da177e4	158
c153f45f	159	request->handle = NULL;
bd1b331f	160	list_for_each_entry(_entry, &dev->maplist, head) {
d1f2b55a	161	if (_entry->map == map) {
c153f45f	162	request->handle =
b5e89ed5	163	(void *)(unsigned long)_entry->user_token;
d1f2b55a DA	164	break;
	165	}
	166	}
c153f45f	167	if (request->handle == NULL)
d1f2b55a DA	168	return -EINVAL;
d1f2b55a DA	169
1da177e4 LT	170	return 0;
	171	}
	172
	173	/**
	174	* Set per-context SAREA.
b5e89ed5	175	*
1da177e4	176	* \param inode device inode.
6c340eac	177	* \param file_priv DRM file private.
1da177e4 LT	178	* \param cmd command.
	179	* \param arg user argument pointing to a drm_ctx_priv_map structure.
	180	* \return zero on success or a negative number on failure.
	181	*
	182	* Searches the mapping specified in \p arg and update the entry in
62968144	183	* drm_device::ctx_idr with it.
1da177e4	184	*/
c153f45f EA	185	int drm_setsareactx(struct drm_device dev, void data,
c153f45f EA	186	struct drm_file *file_priv)
1da177e4	187	{
c153f45f	188	struct drm_ctx_priv_map *request = data;
c60ce623	189	struct drm_map *map = NULL;
55910517	190	struct drm_map_list *r_list = NULL;
1da177e4	191
30e2fb18	192	mutex_lock(&dev->struct_mutex);
bd1b331f	193	list_for_each_entry(r_list, &dev->maplist, head) {
9a186645	194	if (r_list->map
c153f45f	195	&& r_list->user_token == (unsigned long) request->handle)
1da177e4 LT	196	goto found;
1da177e4 LT	197	}
b5e89ed5	198	bad:
30e2fb18	199	mutex_unlock(&dev->struct_mutex);
1da177e4 LT	200	return -EINVAL;
1da177e4 LT	201
b5e89ed5	202	found:
1da177e4	203	map = r_list->map;
b5e89ed5 DA	204	if (!map)
b5e89ed5 DA	205	goto bad;
62968144	206
c153f45f	207	if (IS_ERR(idr_replace(&dev->ctx_idr, map, request->ctx_id)))
1da177e4	208	goto bad;
62968144	209
30e2fb18	210	mutex_unlock(&dev->struct_mutex);
c153f45f	211
1da177e4 LT	212	return 0;
	213	}
	214
	215	/@}/
	216
	217	/******************************************************************/
	218	/** \name The actual DRM context handling routines */
	219	/@{/
	220
	221	/**
	222	* Switch context.
	223	*
	224	* \param dev DRM device.
	225	* \param old old context handle.
	226	* \param new new context handle.
	227	* \return zero on success or a negative number on failure.
	228	*
	229	* Attempt to set drm_device::context_flag.
	230	*/
84b1fd10	231	static int drm_context_switch(struct drm_device * dev, int old, int new)
1da177e4	232	{
b5e89ed5 DA	233	if (test_and_set_bit(0, &dev->context_flag)) {
	234	DRM_ERROR("Reentering -- FIXME\n");
	235	return -EBUSY;
	236	}
1da177e4	237
b5e89ed5	238	DRM_DEBUG("Context switch from %d to %d\n", old, new);
1da177e4	239
b5e89ed5 DA	240	if (new == dev->last_context) {
	241	clear_bit(0, &dev->context_flag);
	242	return 0;
	243	}
1da177e4	244
b5e89ed5	245	return 0;
1da177e4 LT	246	}
	247
	248	/**
	249	* Complete context switch.
	250	*
	251	* \param dev DRM device.
	252	* \param new new context handle.
	253	* \return zero on success or a negative number on failure.
	254	*
	255	* Updates drm_device::last_context and drm_device::last_switch. Verifies the
	256	* hardware lock is held, clears the drm_device::context_flag and wakes up
	257	* drm_device::context_wait.
	258	*/
84b1fd10	259	static int drm_context_switch_complete(struct drm_device * dev, int new)
1da177e4	260	{
b5e89ed5 DA	261	dev->last_context = new; /* PRE/POST: This is the _only_ writer. */
b5e89ed5 DA	262	dev->last_switch = jiffies;
1da177e4	263
b5e89ed5 DA	264	if (!_DRM_LOCK_IS_HELD(dev->lock.hw_lock->lock)) {
	265	DRM_ERROR("Lock isn't held after context switch\n");
	266	}
1da177e4	267
b5e89ed5 DA	268	/* If a context switch is ever initiated
	269	when the kernel holds the lock, release
	270	that lock here. */
	271	clear_bit(0, &dev->context_flag);
	272	wake_up(&dev->context_wait);
1da177e4	273
b5e89ed5	274	return 0;
1da177e4 LT	275	}
	276
	277	/**
	278	* Reserve contexts.
	279	*
	280	* \param inode device inode.
6c340eac	281	* \param file_priv DRM file private.
1da177e4 LT	282	* \param cmd command.
	283	* \param arg user argument pointing to a drm_ctx_res structure.
	284	* \return zero on success or a negative number on failure.
	285	*/
c153f45f EA	286	int drm_resctx(struct drm_device dev, void data,
c153f45f EA	287	struct drm_file *file_priv)
1da177e4	288	{
c153f45f	289	struct drm_ctx_res *res = data;
c60ce623	290	struct drm_ctx ctx;
1da177e4 LT	291	int i;
1da177e4 LT	292
c153f45f	293	if (res->count >= DRM_RESERVED_CONTEXTS) {
b5e89ed5 DA	294	memset(&ctx, 0, sizeof(ctx));
b5e89ed5 DA	295	for (i = 0; i < DRM_RESERVED_CONTEXTS; i++) {
1da177e4	296	ctx.handle = i;
c153f45f	297	if (copy_to_user(&res->contexts[i], &ctx, sizeof(ctx)))
1da177e4 LT	298	return -EFAULT;
	299	}
	300	}
c153f45f	301	res->count = DRM_RESERVED_CONTEXTS;
1da177e4	302
1da177e4 LT	303	return 0;
	304	}
	305
	306	/**
	307	* Add context.
	308	*
	309	* \param inode device inode.
6c340eac	310	* \param file_priv DRM file private.
1da177e4 LT	311	* \param cmd command.
	312	* \param arg user argument pointing to a drm_ctx structure.
	313	* \return zero on success or a negative number on failure.
	314	*
	315	* Get a new handle for the context and copy to userspace.
	316	*/
c153f45f EA	317	int drm_addctx(struct drm_device dev, void data,
c153f45f EA	318	struct drm_file *file_priv)
1da177e4	319	{
55910517	320	struct drm_ctx_list *ctx_entry;
c153f45f	321	struct drm_ctx *ctx = data;
1da177e4	322
c153f45f EA	323	ctx->handle = drm_ctxbitmap_next(dev);
c153f45f EA	324	if (ctx->handle == DRM_KERNEL_CONTEXT) {
b5e89ed5	325	/* Skip kernel's context and get a new one. */
c153f45f	326	ctx->handle = drm_ctxbitmap_next(dev);
1da177e4	327	}
c153f45f EA	328	DRM_DEBUG("%d\n", ctx->handle);
c153f45f EA	329	if (ctx->handle == -1) {
b5e89ed5 DA	330	DRM_DEBUG("Not enough free contexts.\n");
b5e89ed5 DA	331	/* Should this return -EBUSY instead? */
1da177e4 LT	332	return -ENOMEM;
	333	}
	334
c153f45f	335	if (ctx->handle != DRM_KERNEL_CONTEXT) {
1da177e4	336	if (dev->driver->context_ctor)
c153f45f	337	if (!dev->driver->context_ctor(dev, ctx->handle)) {
b5e9fc13 DA	338	DRM_DEBUG("Running out of ctxs or memory.\n");
	339	return -ENOMEM;
	340	}
1da177e4 LT	341	}
1da177e4 LT	342
b5e89ed5 DA	343	ctx_entry = drm_alloc(sizeof(*ctx_entry), DRM_MEM_CTXLIST);
b5e89ed5 DA	344	if (!ctx_entry) {
1da177e4 LT	345	DRM_DEBUG("out of memory\n");
	346	return -ENOMEM;
	347	}
	348
b5e89ed5	349	INIT_LIST_HEAD(&ctx_entry->head);
c153f45f	350	ctx_entry->handle = ctx->handle;
6c340eac	351	ctx_entry->tag = file_priv;
1da177e4	352
30e2fb18	353	mutex_lock(&dev->ctxlist_mutex);
bd1b331f	354	list_add(&ctx_entry->head, &dev->ctxlist);
1da177e4	355	++dev->ctx_count;
30e2fb18	356	mutex_unlock(&dev->ctxlist_mutex);
1da177e4	357
1da177e4 LT	358	return 0;
	359	}
	360
c153f45f	361	int drm_modctx(struct drm_device dev, void data, struct drm_file *file_priv)
1da177e4 LT	362	{
	363	/* This does nothing */
	364	return 0;
	365	}
	366
	367	/**
	368	* Get context.
	369	*
	370	* \param inode device inode.
6c340eac	371	* \param file_priv DRM file private.
1da177e4 LT	372	* \param cmd command.
	373	* \param arg user argument pointing to a drm_ctx structure.
	374	* \return zero on success or a negative number on failure.
	375	*/
c153f45f	376	int drm_getctx(struct drm_device dev, void data, struct drm_file *file_priv)
1da177e4	377	{
c153f45f	378	struct drm_ctx *ctx = data;
1da177e4 LT	379
1da177e4 LT	380	/* This is 0, because we don't handle any context flags */
c153f45f	381	ctx->flags = 0;
1da177e4	382
1da177e4 LT	383	return 0;
	384	}
	385
	386	/**
	387	* Switch context.
	388	*
	389	* \param inode device inode.
6c340eac	390	* \param file_priv DRM file private.
1da177e4 LT	391	* \param cmd command.
	392	* \param arg user argument pointing to a drm_ctx structure.
	393	* \return zero on success or a negative number on failure.
	394	*
	395	* Calls context_switch().
	396	*/
c153f45f EA	397	int drm_switchctx(struct drm_device dev, void data,
c153f45f EA	398	struct drm_file *file_priv)
1da177e4	399	{
c153f45f	400	struct drm_ctx *ctx = data;
1da177e4	401
c153f45f EA	402	DRM_DEBUG("%d\n", ctx->handle);
c153f45f EA	403	return drm_context_switch(dev, dev->last_context, ctx->handle);
1da177e4 LT	404	}
	405
	406	/**
	407	* New context.
	408	*
	409	* \param inode device inode.
6c340eac	410	* \param file_priv DRM file private.
1da177e4 LT	411	* \param cmd command.
	412	* \param arg user argument pointing to a drm_ctx structure.
	413	* \return zero on success or a negative number on failure.
	414	*
	415	* Calls context_switch_complete().
	416	*/
c153f45f EA	417	int drm_newctx(struct drm_device dev, void data,
c153f45f EA	418	struct drm_file *file_priv)
1da177e4	419	{
c153f45f	420	struct drm_ctx *ctx = data;
1da177e4	421
c153f45f EA	422	DRM_DEBUG("%d\n", ctx->handle);
c153f45f EA	423	drm_context_switch_complete(dev, ctx->handle);
1da177e4 LT	424
	425	return 0;
	426	}
	427
	428	/**
	429	* Remove context.
	430	*
	431	* \param inode device inode.
6c340eac	432	* \param file_priv DRM file private.
1da177e4 LT	433	* \param cmd command.
	434	* \param arg user argument pointing to a drm_ctx structure.
	435	* \return zero on success or a negative number on failure.
	436	*
	437	* If not the special kernel context, calls ctxbitmap_free() to free the specified context.
	438	*/
c153f45f EA	439	int drm_rmctx(struct drm_device dev, void data,
c153f45f EA	440	struct drm_file *file_priv)
1da177e4	441	{
c153f45f	442	struct drm_ctx *ctx = data;
1da177e4	443
c153f45f EA	444	DRM_DEBUG("%d\n", ctx->handle);
c153f45f EA	445	if (ctx->handle == DRM_KERNEL_CONTEXT + 1) {
6c340eac	446	file_priv->remove_auth_on_close = 1;
1da177e4	447	}
c153f45f	448	if (ctx->handle != DRM_KERNEL_CONTEXT) {
1da177e4	449	if (dev->driver->context_dtor)
c153f45f EA	450	dev->driver->context_dtor(dev, ctx->handle);
c153f45f EA	451	drm_ctxbitmap_free(dev, ctx->handle);
1da177e4 LT	452	}
1da177e4 LT	453
30e2fb18	454	mutex_lock(&dev->ctxlist_mutex);
bd1b331f	455	if (!list_empty(&dev->ctxlist)) {
55910517	456	struct drm_ctx_list pos, n;
1da177e4	457
bd1b331f	458	list_for_each_entry_safe(pos, n, &dev->ctxlist, head) {
c153f45f	459	if (pos->handle == ctx->handle) {
b5e89ed5 DA	460	list_del(&pos->head);
b5e89ed5 DA	461	drm_free(pos, sizeof(*pos), DRM_MEM_CTXLIST);
1da177e4 LT	462	--dev->ctx_count;
	463	}
	464	}
	465	}
30e2fb18	466	mutex_unlock(&dev->ctxlist_mutex);
1da177e4 LT	467
	468	return 0;
	469	}
	470
	471	/@}/