drmP.h 43.5 KB
Newer Older
L
Linus Torvalds 已提交
1
/**
D
Dave Airlie 已提交
2
 * \file drmP.h
L
Linus Torvalds 已提交
3
 * Private header for Direct Rendering Manager
D
Dave Airlie 已提交
4
 *
L
Linus Torvalds 已提交
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
 * \author Rickard E. (Rik) Faith <faith@valinux.com>
 * \author Gareth Hughes <gareth@valinux.com>
 */

/*
 * Copyright 1999 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.
 */

#ifndef _DRM_P_H_
#define _DRM_P_H_

/* If you want the memory alloc debug functionality, change define below */
/* #define DEBUG_MEMORY */

#ifdef __KERNEL__
#ifdef __alpha__
/* add include of current.h so that "current" is defined
 * before static inline funcs in wait.h. Doing this so we
 * can build the DRM (part of PI DRI). 4/21/2000 S + B */
#include <asm/current.h>
D
Dave Airlie 已提交
46
#endif				/* __alpha__ */
L
Linus Torvalds 已提交
47 48 49 50 51 52 53 54 55 56
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/miscdevice.h>
#include <linux/fs.h>
#include <linux/proc_fs.h>
#include <linux/init.h>
#include <linux/file.h>
#include <linux/pci.h>
#include <linux/jiffies.h>
#include <linux/smp_lock.h>	/* For (un)lock_kernel */
57
#include <linux/dma-mapping.h>
L
Linus Torvalds 已提交
58 59
#include <linux/mm.h>
#include <linux/cdev.h>
D
Dave Airlie 已提交
60
#include <linux/mutex.h>
L
Linus Torvalds 已提交
61
#if defined(__alpha__) || defined(__powerpc__)
D
Dave Airlie 已提交
62
#include <asm/pgtable.h>	/* For pte_wrprotect */
L
Linus Torvalds 已提交
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
#endif
#include <asm/io.h>
#include <asm/mman.h>
#include <asm/uaccess.h>
#ifdef CONFIG_MTRR
#include <asm/mtrr.h>
#endif
#if defined(CONFIG_AGP) || defined(CONFIG_AGP_MODULE)
#include <linux/types.h>
#include <linux/agp_backend.h>
#endif
#include <linux/workqueue.h>
#include <linux/poll.h>
#include <asm/pgalloc.h>
#include "drm.h"

79 80
#include <linux/idr.h>

L
Linus Torvalds 已提交
81 82 83
#define __OS_HAS_AGP (defined(CONFIG_AGP) || (defined(CONFIG_AGP_MODULE) && defined(MODULE)))
#define __OS_HAS_MTRR (defined(CONFIG_MTRR))

84 85 86
struct drm_file;
struct drm_device;

L
Linus Torvalds 已提交
87
#include "drm_os_linux.h"
88
#include "drm_hashtab.h"
L
Linus Torvalds 已提交
89 90 91 92 93 94 95 96 97 98 99 100 101 102

/***********************************************************************/
/** \name DRM template customization defaults */
/*@{*/

/* driver capabilities and requirements mask */
#define DRIVER_USE_AGP     0x1
#define DRIVER_REQUIRE_AGP 0x2
#define DRIVER_USE_MTRR    0x4
#define DRIVER_PCI_DMA     0x8
#define DRIVER_SG          0x10
#define DRIVER_HAVE_DMA    0x20
#define DRIVER_HAVE_IRQ    0x40
#define DRIVER_IRQ_SHARED  0x80
103
#define DRIVER_IRQ_VBL     0x100
L
Linus Torvalds 已提交
104
#define DRIVER_DMA_QUEUE   0x200
D
Dave Airlie 已提交
105
#define DRIVER_FB_DMA      0x400
106
#define DRIVER_IRQ_VBL2    0x800
107
#define DRIVER_GEM         0x1000
L
Linus Torvalds 已提交
108 109 110 111 112 113 114 115

/***********************************************************************/
/** \name Begin the DRM... */
/*@{*/

#define DRM_DEBUG_CODE 2	  /**< Include debugging code if > 1, then
				     also include looping detection. */

116
#define DRM_MAGIC_HASH_ORDER  4  /**< Size of key hash table. Must be power of 2. */
L
Linus Torvalds 已提交
117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145
#define DRM_KERNEL_CONTEXT    0	 /**< Change drm_resctx if changed */
#define DRM_RESERVED_CONTEXTS 1	 /**< Change drm_resctx if changed */
#define DRM_LOOPING_LIMIT     5000000
#define DRM_TIME_SLICE	      (HZ/20)  /**< Time slice for GLXContexts */
#define DRM_LOCK_SLICE	      1	/**< Time slice for lock, in jiffies */

#define DRM_FLAG_DEBUG	  0x01

#define DRM_MEM_DMA	   0
#define DRM_MEM_SAREA	   1
#define DRM_MEM_DRIVER	   2
#define DRM_MEM_MAGIC	   3
#define DRM_MEM_IOCTLS	   4
#define DRM_MEM_MAPS	   5
#define DRM_MEM_VMAS	   6
#define DRM_MEM_BUFS	   7
#define DRM_MEM_SEGS	   8
#define DRM_MEM_PAGES	   9
#define DRM_MEM_FILES	  10
#define DRM_MEM_QUEUES	  11
#define DRM_MEM_CMDS	  12
#define DRM_MEM_MAPPINGS  13
#define DRM_MEM_BUFLISTS  14
#define DRM_MEM_AGPLISTS  15
#define DRM_MEM_TOTALAGP  16
#define DRM_MEM_BOUNDAGP  17
#define DRM_MEM_CTXBITMAP 18
#define DRM_MEM_STUB      19
#define DRM_MEM_SGLISTS   20
146 147 148
#define DRM_MEM_CTXLIST   21
#define DRM_MEM_MM        22
#define DRM_MEM_HASHTAB   23
L
Linus Torvalds 已提交
149 150

#define DRM_MAX_CTXBITMAP (PAGE_SIZE * 8)
151
#define DRM_MAP_HASH_OFFSET 0x10000000
L
Linus Torvalds 已提交
152

D
Dave Airlie 已提交
153
/*@}*/
L
Linus Torvalds 已提交
154 155 156 157 158 159 160 161 162 163 164 165

/***********************************************************************/
/** \name Macros to make printk easier */
/*@{*/

/**
 * Error output.
 *
 * \param fmt printf() like format string.
 * \param arg arguments
 */
#define DRM_ERROR(fmt, arg...) \
166
	printk(KERN_ERR "[" DRM_NAME ":%s] *ERROR* " fmt , __func__ , ##arg)
L
Linus Torvalds 已提交
167 168 169 170 171 172 173 174 175

/**
 * Memory error output.
 *
 * \param area memory area where the error occurred.
 * \param fmt printf() like format string.
 * \param arg arguments
 */
#define DRM_MEM_ERROR(area, fmt, arg...) \
176
	printk(KERN_ERR "[" DRM_NAME ":%s:%s] *ERROR* " fmt , __func__, \
L
Linus Torvalds 已提交
177 178 179 180 181 182
	       drm_mem_stats[area].name , ##arg)

#define DRM_INFO(fmt, arg...)  printk(KERN_INFO "[" DRM_NAME "] " fmt , ##arg)

/**
 * Debug output.
D
Dave Airlie 已提交
183
 *
L
Linus Torvalds 已提交
184 185 186 187 188 189 190 191 192
 * \param fmt printf() like format string.
 * \param arg arguments
 */
#if DRM_DEBUG_CODE
#define DRM_DEBUG(fmt, arg...)						\
	do {								\
		if ( drm_debug )			\
			printk(KERN_DEBUG				\
			       "[" DRM_NAME ":%s] " fmt ,	\
193
			       __func__ , ##arg);			\
L
Linus Torvalds 已提交
194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214
	} while (0)
#else
#define DRM_DEBUG(fmt, arg...)		 do { } while (0)
#endif

#define DRM_PROC_LIMIT (PAGE_SIZE-80)

#define DRM_PROC_PRINT(fmt, arg...)					\
   len += sprintf(&buf[len], fmt , ##arg);				\
   if (len > DRM_PROC_LIMIT) { *eof = 1; return len - offset; }

#define DRM_PROC_PRINT_RET(ret, fmt, arg...)				\
   len += sprintf(&buf[len], fmt , ##arg);				\
   if (len > DRM_PROC_LIMIT) { ret; *eof = 1; return len - offset; }

/*@}*/

/***********************************************************************/
/** \name Internal types and structures */
/*@{*/

D
Dave Airlie 已提交
215
#define DRM_ARRAY_SIZE(x) ARRAY_SIZE(x)
L
Linus Torvalds 已提交
216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238

#define DRM_LEFTCOUNT(x) (((x)->rp + (x)->count - (x)->wp) % ((x)->count + 1))
#define DRM_BUFCOUNT(x) ((x)->count - DRM_LEFTCOUNT(x))
#define DRM_WAITCOUNT(dev,idx) DRM_BUFCOUNT(&dev->queuelist[idx]->waitlist)

#define DRM_IF_VERSION(maj, min) (maj << 16 | min)
/**
 * Get the private SAREA mapping.
 *
 * \param _dev DRM device.
 * \param _ctx context number.
 * \param _map output mapping.
 */
#define DRM_GET_PRIV_SAREA(_dev, _ctx, _map) do {	\
	(_map) = (_dev)->context_sareas[_ctx];		\
} while(0)

/**
 * Test that the hardware lock is held by the caller, returning otherwise.
 *
 * \param dev DRM device.
 * \param filp file pointer of the caller.
 */
239
#define LOCK_TEST_WITH_RETURN( dev, file_priv )				\
L
Linus Torvalds 已提交
240 241
do {									\
	if ( !_DRM_LOCK_IS_HELD( dev->lock.hw_lock->lock ) ||		\
242 243
	     dev->lock.file_priv != file_priv )	{			\
		DRM_ERROR( "%s called without lock held, held  %d owner %p %p\n",\
244
			   __func__, _DRM_LOCK_IS_HELD( dev->lock.hw_lock->lock ),\
245
			   dev->lock.file_priv, file_priv );		\
L
Linus Torvalds 已提交
246 247 248 249 250 251 252 253 254 255 256 257 258 259 260
		return -EINVAL;						\
	}								\
} while (0)

/**
 * Copy and IOCTL return string to user space
 */
#define DRM_COPY( name, value )						\
	len = strlen( value );						\
	if ( len > name##_len ) len = name##_len;			\
	name##_len = strlen( value );					\
	if ( len && name ) {						\
		if ( copy_to_user( name, value, len ) )			\
			return -EFAULT;					\
	}
D
Dave Airlie 已提交
261

L
Linus Torvalds 已提交
262 263 264 265
/**
 * Ioctl function type.
 *
 * \param inode device inode.
266
 * \param file_priv DRM file private pointer.
L
Linus Torvalds 已提交
267 268 269
 * \param cmd command.
 * \param arg argument.
 */
270 271
typedef int drm_ioctl_t(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
L
Linus Torvalds 已提交
272

273 274 275
typedef int drm_ioctl_compat_t(struct file *filp, unsigned int cmd,
			       unsigned long arg);

276 277 278 279
#define DRM_AUTH	0x1
#define	DRM_MASTER	0x2
#define DRM_ROOT_ONLY	0x4

280 281
struct drm_ioctl_desc {
	unsigned int cmd;
D
Dave Airlie 已提交
282
	drm_ioctl_t *func;
283
	int flags;
284 285 286 287 288 289 290 291
};

/**
 * Creates a driver or general drm_ioctl_desc array entry for the given
 * ioctl, for use by drm_ioctl().
 */
#define DRM_IOCTL_DEF(ioctl, func, flags) \
	[DRM_IOCTL_NR(ioctl)] = {ioctl, func, flags}
L
Linus Torvalds 已提交
292

293
struct drm_magic_entry {
294
	struct list_head head;
295
	struct drm_hash_item hash_item;
D
Dave Airlie 已提交
296
	struct drm_file *priv;
297
};
L
Linus Torvalds 已提交
298

299
struct drm_vma_entry {
300
	struct list_head head;
L
Linus Torvalds 已提交
301
	struct vm_area_struct *vma;
D
Dave Airlie 已提交
302
	pid_t pid;
303
};
L
Linus Torvalds 已提交
304 305 306 307

/**
 * DMA buffer.
 */
D
Dave Airlie 已提交
308
struct drm_buf {
D
Dave Airlie 已提交
309 310 311 312 313 314 315 316 317 318
	int idx;		       /**< Index into master buflist */
	int total;		       /**< Buffer size */
	int order;		       /**< log-base-2(total) */
	int used;		       /**< Amount of buffer in use (for DMA) */
	unsigned long offset;	       /**< Byte offset (used internally) */
	void *address;		       /**< Address of buffer */
	unsigned long bus_address;     /**< Bus address of buffer */
	struct drm_buf *next;	       /**< Kernel-only: used for free list */
	__volatile__ int waiting;      /**< On kernel DMA queue */
	__volatile__ int pending;      /**< On hardware DMA queue */
L
Linus Torvalds 已提交
319
	wait_queue_head_t dma_wait;    /**< Processes waiting */
320
	struct drm_file *file_priv;    /**< Private of holding file descr */
D
Dave Airlie 已提交
321 322
	int context;		       /**< Kernel queue for this buffer */
	int while_locked;	       /**< Dispatch this buffer while locked */
L
Linus Torvalds 已提交
323
	enum {
D
Dave Airlie 已提交
324 325 326 327 328
		DRM_LIST_NONE = 0,
		DRM_LIST_FREE = 1,
		DRM_LIST_WAIT = 2,
		DRM_LIST_PEND = 3,
		DRM_LIST_PRIO = 4,
L
Linus Torvalds 已提交
329
		DRM_LIST_RECLAIM = 5
D
Dave Airlie 已提交
330
	} list;			       /**< Which list we're on */
L
Linus Torvalds 已提交
331

D
Dave Airlie 已提交
332 333
	int dev_priv_size;		 /**< Size of buffer private storage */
	void *dev_private;		 /**< Per-buffer private storage */
D
Dave Airlie 已提交
334
};
L
Linus Torvalds 已提交
335 336

/** bufs is one longer than it has to be */
337
struct drm_waitlist {
D
Dave Airlie 已提交
338
	int count;			/**< Number of possible buffers */
D
Dave Airlie 已提交
339 340 341 342
	struct drm_buf **bufs;		/**< List of pointers to buffers */
	struct drm_buf **rp;			/**< Read pointer */
	struct drm_buf **wp;			/**< Write pointer */
	struct drm_buf **end;		/**< End pointer */
D
Dave Airlie 已提交
343 344
	spinlock_t read_lock;
	spinlock_t write_lock;
345
};
L
Linus Torvalds 已提交
346

347
struct drm_freelist {
D
Dave Airlie 已提交
348 349
	int initialized;	       /**< Freelist in use */
	atomic_t count;		       /**< Number of free buffers */
D
Dave Airlie 已提交
350
	struct drm_buf *next;	       /**< End pointer */
L
Linus Torvalds 已提交
351 352

	wait_queue_head_t waiting;     /**< Processes waiting on free bufs */
D
Dave Airlie 已提交
353 354 355 356
	int low_mark;		       /**< Low water mark */
	int high_mark;		       /**< High water mark */
	atomic_t wfh;		       /**< If waiting for high mark */
	spinlock_t lock;
357
};
L
Linus Torvalds 已提交
358

D
Dave Airlie 已提交
359 360 361 362 363 364
typedef struct drm_dma_handle {
	dma_addr_t busaddr;
	void *vaddr;
	size_t size;
} drm_dma_handle_t;

L
Linus Torvalds 已提交
365 366 367
/**
 * Buffer entry.  There is one of this for each buffer size order.
 */
368
struct drm_buf_entry {
D
Dave Airlie 已提交
369 370
	int buf_size;			/**< size */
	int buf_count;			/**< number of buffers */
D
Dave Airlie 已提交
371
	struct drm_buf *buflist;		/**< buffer list */
D
Dave Airlie 已提交
372 373
	int seg_count;
	int page_order;
374
	struct drm_dma_handle **seglist;
D
Dave Airlie 已提交
375

376 377
	struct drm_freelist freelist;
};
L
Linus Torvalds 已提交
378 379

/** File private data */
380
struct drm_file {
D
Dave Airlie 已提交
381
	int authenticated;
382
	int master;
D
Dave Airlie 已提交
383 384 385 386
	pid_t pid;
	uid_t uid;
	drm_magic_t magic;
	unsigned long ioctl_count;
387
	struct list_head lhead;
388
	struct drm_minor *minor;
D
Dave Airlie 已提交
389 390
	int remove_auth_on_close;
	unsigned long lock_count;
391 392 393 394
	/** Mapping of mm object handles to object pointers. */
	struct idr object_idr;
	/** Lock for synchronization of access to object_idr. */
	spinlock_t table_lock;
395
	struct file *filp;
396
	void *driver_priv;
397
};
L
Linus Torvalds 已提交
398 399

/** Wait queue */
400
struct drm_queue {
D
Dave Airlie 已提交
401 402 403 404
	atomic_t use_count;		/**< Outstanding uses (+1) */
	atomic_t finalization;		/**< Finalization in progress */
	atomic_t block_count;		/**< Count of processes waiting */
	atomic_t block_read;		/**< Queue blocked for reads */
L
Linus Torvalds 已提交
405
	wait_queue_head_t read_queue;	/**< Processes waiting on block_read */
D
Dave Airlie 已提交
406
	atomic_t block_write;		/**< Queue blocked for writes */
L
Linus Torvalds 已提交
407
	wait_queue_head_t write_queue;	/**< Processes waiting on block_write */
D
Dave Airlie 已提交
408 409 410
	atomic_t total_queued;		/**< Total queued statistic */
	atomic_t total_flushed;		/**< Total flushes statistic */
	atomic_t total_locks;		/**< Total locks statistics */
411
	enum drm_ctx_flags flags;	/**< Context preserving and 2D-only */
412
	struct drm_waitlist waitlist;	/**< Pending buffers */
L
Linus Torvalds 已提交
413
	wait_queue_head_t flush_queue;	/**< Processes waiting until flush */
414
};
L
Linus Torvalds 已提交
415 416 417 418

/**
 * Lock data.
 */
D
Dave Airlie 已提交
419
struct drm_lock_data {
420
	struct drm_hw_lock *hw_lock;	/**< Hardware lock */
421 422
	/** Private of lock holder's file (NULL=kernel) */
	struct drm_file *file_priv;
L
Linus Torvalds 已提交
423
	wait_queue_head_t lock_queue;	/**< Queue of blocked processes */
D
Dave Airlie 已提交
424
	unsigned long lock_time;	/**< Time of last lock in jiffies */
425 426 427 428
	spinlock_t spinlock;
	uint32_t kernel_waiters;
	uint32_t user_waiters;
	int idle_has_lock;
D
Dave Airlie 已提交
429
};
L
Linus Torvalds 已提交
430 431 432 433

/**
 * DMA data.
 */
434
struct drm_device_dma {
L
Linus Torvalds 已提交
435

436
	struct drm_buf_entry bufs[DRM_MAX_ORDER + 1];	/**< buffers, grouped by their size order */
D
Dave Airlie 已提交
437
	int buf_count;			/**< total number of buffers */
D
Dave Airlie 已提交
438
	struct drm_buf **buflist;		/**< Vector of pointers into drm_device_dma::bufs */
D
Dave Airlie 已提交
439 440 441 442
	int seg_count;
	int page_count;			/**< number of pages */
	unsigned long *pagelist;	/**< page list */
	unsigned long byte_count;
L
Linus Torvalds 已提交
443 444
	enum {
		_DRM_DMA_USE_AGP = 0x01,
D
Dave Airlie 已提交
445
		_DRM_DMA_USE_SG = 0x02,
446 447
		_DRM_DMA_USE_FB = 0x04,
		_DRM_DMA_USE_PCI_RO = 0x08
L
Linus Torvalds 已提交
448 449
	} flags;

450
};
L
Linus Torvalds 已提交
451

D
Dave Airlie 已提交
452
/**
L
Linus Torvalds 已提交
453 454
 * AGP memory entry.  Stored as a doubly linked list.
 */
D
Dave Airlie 已提交
455
struct drm_agp_mem {
D
Dave Airlie 已提交
456 457 458 459
	unsigned long handle;		/**< handle */
	DRM_AGP_MEM *memory;
	unsigned long bound;		/**< address */
	int pages;
460
	struct list_head head;
D
Dave Airlie 已提交
461
};
L
Linus Torvalds 已提交
462 463 464 465 466 467

/**
 * AGP data.
 *
 * \sa drm_agp_init() and drm_device::agp.
 */
D
Dave Airlie 已提交
468
struct drm_agp_head {
D
Dave Airlie 已提交
469
	DRM_AGP_KERN agp_info;		/**< AGP device information */
470
	struct list_head memory;
D
Dave Airlie 已提交
471 472 473 474 475 476 477 478
	unsigned long mode;		/**< AGP mode */
	struct agp_bridge_data *bridge;
	int enabled;			/**< whether the AGP bus as been enabled */
	int acquired;			/**< whether the AGP device has been acquired */
	unsigned long base;
	int agp_mtrr;
	int cant_use_aperture;
	unsigned long page_mask;
D
Dave Airlie 已提交
479
};
L
Linus Torvalds 已提交
480 481 482 483

/**
 * Scatter-gather memory.
 */
D
Dave Airlie 已提交
484
struct drm_sg_mem {
D
Dave Airlie 已提交
485 486 487 488 489
	unsigned long handle;
	void *virtual;
	int pages;
	struct page **pagelist;
	dma_addr_t *busaddr;
D
Dave Airlie 已提交
490
};
L
Linus Torvalds 已提交
491

D
Dave Airlie 已提交
492
struct drm_sigdata {
D
Dave Airlie 已提交
493
	int context;
494
	struct drm_hw_lock *lock;
D
Dave Airlie 已提交
495
};
L
Linus Torvalds 已提交
496

497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517

/*
 * Generic memory manager structs
 */

struct drm_mm_node {
	struct list_head fl_entry;
	struct list_head ml_entry;
	int free;
	unsigned long start;
	unsigned long size;
	struct drm_mm *mm;
	void *private;
};

struct drm_mm {
	struct list_head fl_entry;
	struct list_head ml_entry;
};


L
Linus Torvalds 已提交
518 519 520
/**
 * Mappings list
 */
D
Dave Airlie 已提交
521
struct drm_map_list {
D
Dave Airlie 已提交
522
	struct list_head head;		/**< list head */
523
	struct drm_hash_item hash;
524
	struct drm_map *map;			/**< mapping */
525
	uint64_t user_token;
D
Dave Airlie 已提交
526
};
L
Linus Torvalds 已提交
527

528
typedef struct drm_map drm_local_map_t;
L
Linus Torvalds 已提交
529 530 531 532

/**
 * Context handle list
 */
D
Dave Airlie 已提交
533
struct drm_ctx_list {
D
Dave Airlie 已提交
534 535
	struct list_head head;		/**< list head */
	drm_context_t handle;		/**< context handle */
536
	struct drm_file *tag;		/**< associated fd private data */
D
Dave Airlie 已提交
537
};
L
Linus Torvalds 已提交
538

D
Dave Airlie 已提交
539
struct drm_vbl_sig {
D
Dave Airlie 已提交
540 541 542 543
	struct list_head head;
	unsigned int sequence;
	struct siginfo info;
	struct task_struct *task;
D
Dave Airlie 已提交
544
};
L
Linus Torvalds 已提交
545

546 547 548 549
/* location of GART table */
#define DRM_ATI_GART_MAIN 1
#define DRM_ATI_GART_FB   2

550 551 552 553
#define DRM_ATI_GART_PCI 1
#define DRM_ATI_GART_PCIE 2
#define DRM_ATI_GART_IGP 3

D
Dave Airlie 已提交
554
struct drm_ati_pcigart_info {
555
	int gart_table_location;
556
	int gart_reg_if;
557
	void *addr;
558
	dma_addr_t bus_addr;
559 560
	dma_addr_t table_mask;
	struct drm_dma_handle *table_handle;
561
	drm_local_map_t mapping;
562
	int table_size;
D
Dave Airlie 已提交
563
};
564

565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614
/**
 * This structure defines the drm_mm memory object, which will be used by the
 * DRM for its buffer objects.
 */
struct drm_gem_object {
	/** Reference count of this object */
	struct kref refcount;

	/** Handle count of this object. Each handle also holds a reference */
	struct kref handlecount;

	/** Related drm device */
	struct drm_device *dev;

	/** File representing the shmem storage */
	struct file *filp;

	/**
	 * Size of the object, in bytes.  Immutable over the object's
	 * lifetime.
	 */
	size_t size;

	/**
	 * Global name for this object, starts at 1. 0 means unnamed.
	 * Access is covered by the object_name_lock in the related drm_device
	 */
	int name;

	/**
	 * Memory domains. These monitor which caches contain read/write data
	 * related to the object. When transitioning from one set of domains
	 * to another, the driver is called to ensure that caches are suitably
	 * flushed and invalidated
	 */
	uint32_t read_domains;
	uint32_t write_domain;

	/**
	 * While validating an exec operation, the
	 * new read/write domain values are computed here.
	 * They will be transferred to the above values
	 * at the point that any cache flushing occurs
	 */
	uint32_t pending_read_domains;
	uint32_t pending_write_domain;

	void *driver_private;
};

L
Linus Torvalds 已提交
615 616 617 618 619 620
/**
 * DRM driver structure. This structure represent the common code for
 * a family of cards. There will one drm_device for each card present
 * in this family
 */
struct drm_driver {
621 622
	int (*load) (struct drm_device *, unsigned long flags);
	int (*firstopen) (struct drm_device *);
623
	int (*open) (struct drm_device *, struct drm_file *);
624
	void (*preclose) (struct drm_device *, struct drm_file *file_priv);
625
	void (*postclose) (struct drm_device *, struct drm_file *);
626 627
	void (*lastclose) (struct drm_device *);
	int (*unload) (struct drm_device *);
628
	int (*suspend) (struct drm_device *, pm_message_t state);
J
Jesse Barnes 已提交
629
	int (*resume) (struct drm_device *);
630
	int (*dma_ioctl) (struct drm_device *dev, void *data, struct drm_file *file_priv);
D
Dave Airlie 已提交
631 632
	void (*dma_ready) (struct drm_device *);
	int (*dma_quiescent) (struct drm_device *);
633 634 635
	int (*context_ctor) (struct drm_device *dev, int context);
	int (*context_dtor) (struct drm_device *dev, int context);
	int (*kernel_context_switch) (struct drm_device *dev, int old,
D
Dave Airlie 已提交
636
				      int new);
637 638
	void (*kernel_context_switch_unlock) (struct drm_device *dev);
	int (*dri_library_name) (struct drm_device *dev, char *buf);
D
Dave Airlie 已提交
639

640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684
	/**
	 * get_vblank_counter - get raw hardware vblank counter
	 * @dev: DRM device
	 * @crtc: counter to fetch
	 *
	 * Driver callback for fetching a raw hardware vblank counter
	 * for @crtc.  If a device doesn't have a hardware counter, the
	 * driver can simply return the value of drm_vblank_count and
	 * make the enable_vblank() and disable_vblank() hooks into no-ops,
	 * leaving interrupts enabled at all times.
	 *
	 * Wraparound handling and loss of events due to modesetting is dealt
	 * with in the DRM core code.
	 *
	 * RETURNS
	 * Raw vblank counter value.
	 */
	u32 (*get_vblank_counter) (struct drm_device *dev, int crtc);

	/**
	 * enable_vblank - enable vblank interrupt events
	 * @dev: DRM device
	 * @crtc: which irq to enable
	 *
	 * Enable vblank interrupts for @crtc.  If the device doesn't have
	 * a hardware vblank counter, this routine should be a no-op, since
	 * interrupts will have to stay on to keep the count accurate.
	 *
	 * RETURNS
	 * Zero on success, appropriate errno if the given @crtc's vblank
	 * interrupt cannot be enabled.
	 */
	int (*enable_vblank) (struct drm_device *dev, int crtc);

	/**
	 * disable_vblank - disable vblank interrupt events
	 * @dev: DRM device
	 * @crtc: which irq to enable
	 *
	 * Disable vblank interrupts for @crtc.  If the device doesn't have
	 * a hardware vblank counter, this routine should be a no-op, since
	 * interrupts will have to stay on to keep the count accurate.
	 */
	void (*disable_vblank) (struct drm_device *dev, int crtc);

685 686 687 688 689 690 691 692 693 694 695
	/**
	 * Called by \c drm_device_is_agp.  Typically used to determine if a
	 * card is really attached to AGP or not.
	 *
	 * \param dev  DRM device handle
	 *
	 * \returns
	 * One of three values is returned depending on whether or not the
	 * card is absolutely \b not AGP (return of 0), absolutely \b is AGP
	 * (return of 1), or may or may not be AGP (return of 2).
	 */
696
	int (*device_is_agp) (struct drm_device *dev);
697

L
Linus Torvalds 已提交
698
	/* these have to be filled in */
D
Dave Airlie 已提交
699

700
	irqreturn_t(*irq_handler) (DRM_IRQ_ARGS);
701
	void (*irq_preinstall) (struct drm_device *dev);
702
	int (*irq_postinstall) (struct drm_device *dev);
703
	void (*irq_uninstall) (struct drm_device *dev);
704 705
	void (*reclaim_buffers) (struct drm_device *dev,
				 struct drm_file * file_priv);
706
	void (*reclaim_buffers_locked) (struct drm_device *dev,
707
					struct drm_file *file_priv);
708
	void (*reclaim_buffers_idlelocked) (struct drm_device *dev,
709
					    struct drm_file *file_priv);
710
	unsigned long (*get_map_ofs) (struct drm_map * map);
711 712
	unsigned long (*get_reg_ofs) (struct drm_device *dev);
	void (*set_version) (struct drm_device *dev,
713
			     struct drm_set_version *sv);
714

715 716 717 718 719 720 721 722 723 724 725 726
	int (*proc_init)(struct drm_minor *minor);
	void (*proc_cleanup)(struct drm_minor *minor);

	/**
	 * Driver-specific constructor for drm_gem_objects, to set up
	 * obj->driver_private.
	 *
	 * Returns 0 on success.
	 */
	int (*gem_init_object) (struct drm_gem_object *obj);
	void (*gem_free_object) (struct drm_gem_object *obj);

727 728 729 730 731 732 733
	int major;
	int minor;
	int patchlevel;
	char *name;
	char *desc;
	char *date;

L
Linus Torvalds 已提交
734 735
	u32 driver_features;
	int dev_priv_size;
736
	struct drm_ioctl_desc *ioctls;
L
Linus Torvalds 已提交
737 738 739 740 741
	int num_ioctls;
	struct file_operations fops;
	struct pci_driver pci_driver;
};

742 743 744
#define DRM_MINOR_UNASSIGNED 0
#define DRM_MINOR_LEGACY 1

L
Linus Torvalds 已提交
745
/**
746
 * DRM minor structure. This structure represents a drm minor number.
L
Linus Torvalds 已提交
747
 */
748 749 750 751 752
struct drm_minor {
	int index;			/**< Minor device number */
	int type;                       /**< Control or render */
	dev_t device;			/**< Device number for mknod */
	struct device kdev;		/**< Linux device */
L
Linus Torvalds 已提交
753 754
	struct drm_device *dev;
	struct proc_dir_entry *dev_root;  /**< proc directory entry */
755
};
L
Linus Torvalds 已提交
756 757 758 759 760

/**
 * DRM device structure. This structure represent a complete card that
 * may contain multiple heads.
 */
761
struct drm_device {
D
Dave Airlie 已提交
762 763 764 765
	char *unique;			/**< Unique identifier: e.g., busid */
	int unique_len;			/**< Length of unique field */
	char *devname;			/**< For /proc/interrupts */
	int if_version;			/**< Highest interface version set */
L
Linus Torvalds 已提交
766

D
Dave Airlie 已提交
767
	int blocked;			/**< Blocked due to VC switch? */
L
Linus Torvalds 已提交
768 769

	/** \name Locks */
D
Dave Airlie 已提交
770 771
	/*@{ */
	spinlock_t count_lock;		/**< For inuse, drm_device::open_count, drm_device::buf_use */
D
Dave Airlie 已提交
772
	struct mutex struct_mutex;	/**< For others */
D
Dave Airlie 已提交
773
	/*@} */
L
Linus Torvalds 已提交
774 775

	/** \name Usage Counters */
D
Dave Airlie 已提交
776 777 778 779 780 781 782
	/*@{ */
	int open_count;			/**< Outstanding files open */
	atomic_t ioctl_count;		/**< Outstanding IOCTLs pending */
	atomic_t vma_count;		/**< Outstanding vma areas open */
	int buf_use;			/**< Buffers in use -- cannot alloc */
	atomic_t buf_alloc;		/**< Buffer allocation in progress */
	/*@} */
L
Linus Torvalds 已提交
783 784

	/** \name Performance counters */
D
Dave Airlie 已提交
785 786
	/*@{ */
	unsigned long counters;
787
	enum drm_stat_type types[15];
D
Dave Airlie 已提交
788 789
	atomic_t counts[15];
	/*@} */
L
Linus Torvalds 已提交
790 791

	/** \name Authentication */
D
Dave Airlie 已提交
792
	/*@{ */
793
	struct list_head filelist;
794
	struct drm_open_hash magiclist;	/**< magic hash table */
795
	struct list_head magicfree;
D
Dave Airlie 已提交
796
	/*@} */
L
Linus Torvalds 已提交
797 798

	/** \name Memory management */
D
Dave Airlie 已提交
799
	/*@{ */
800
	struct list_head maplist;	/**< Linked list of regions */
D
Dave Airlie 已提交
801
	int map_count;			/**< Number of mappable regions */
802
	struct drm_open_hash map_hash;	/**< User token hash table for maps */
L
Linus Torvalds 已提交
803 804

	/** \name Context handle management */
D
Dave Airlie 已提交
805
	/*@{ */
806
	struct list_head ctxlist;	/**< Linked list of context handles */
D
Dave Airlie 已提交
807
	int ctx_count;			/**< Number of context handles */
D
Dave Airlie 已提交
808
	struct mutex ctxlist_mutex;	/**< For ctxlist */
L
Linus Torvalds 已提交
809

810
	struct idr ctx_idr;
L
Linus Torvalds 已提交
811

812
	struct list_head vmalist;	/**< List of vmas (for debugging) */
D
Dave Airlie 已提交
813
	struct drm_lock_data lock;	/**< Information on hardware lock */
D
Dave Airlie 已提交
814
	/*@} */
L
Linus Torvalds 已提交
815 816

	/** \name DMA queues (contexts) */
D
Dave Airlie 已提交
817 818 819 820
	/*@{ */
	int queue_count;		/**< Number of active DMA queues */
	int queue_reserved;		  /**< Number of reserved DMA queues */
	int queue_slots;		/**< Actual length of queuelist */
821 822
	struct drm_queue **queuelist;	/**< Vector of pointers to DMA queues */
	struct drm_device_dma *dma;		/**< Optional pointer for DMA support */
D
Dave Airlie 已提交
823
	/*@} */
L
Linus Torvalds 已提交
824 825

	/** \name Context support */
D
Dave Airlie 已提交
826 827 828
	/*@{ */
	int irq;			/**< Interrupt used by board */
	int irq_enabled;		/**< True if irq handler is enabled */
L
Linus Torvalds 已提交
829 830 831 832
	__volatile__ long context_flag;	/**< Context swapping flag */
	__volatile__ long interrupt_flag; /**< Interruption handler flag */
	__volatile__ long dma_flag;	/**< DMA dispatch flag */
	struct timer_list timer;	/**< Timer for delaying ctx switch */
D
Dave Airlie 已提交
833 834 835 836 837 838 839
	wait_queue_head_t context_wait;	/**< Processes waiting on ctx switch */
	int last_checked;		/**< Last context checked for DMA */
	int last_context;		/**< Last current context */
	unsigned long last_switch;	/**< jiffies at last context switch */
	/*@} */

	struct work_struct work;
L
Linus Torvalds 已提交
840
	/** \name VBLANK IRQ support */
D
Dave Airlie 已提交
841 842
	/*@{ */

843 844 845 846 847 848 849 850 851 852
	/*
	 * At load time, disabling the vblank interrupt won't be allowed since
	 * old clients may not call the modeset ioctl and therefore misbehave.
	 * Once the modeset ioctl *has* been called though, we can safely
	 * disable them when unused.
	 */
	int vblank_disable_allowed;

	wait_queue_head_t *vbl_queue;   /**< VBLANK wait queue */
	atomic_t *_vblank_count;        /**< number of VBLANK interrupts (driver must alloc the right number of counters) */
D
Dave Airlie 已提交
853
	spinlock_t vbl_lock;
854 855 856 857 858 859 860 861 862 863 864
	struct list_head *vbl_sigs;	/**< signal list to send on VBLANK */
	atomic_t vbl_signal_pending;    /* number of signals pending on all crtcs*/
	atomic_t *vblank_refcount;      /* number of users of vblank interruptsper crtc */
	u32 *last_vblank;               /* protected by dev->vbl_lock, used */
					/* for wraparound handling */
	int *vblank_enabled;            /* so we don't call enable more than
					   once per disable */
	int *vblank_inmodeset;          /* Display driver is setting mode */
	struct timer_list vblank_disable_timer;

	u32 max_vblank_count;           /**< size of vblank counter register */
865 866
	spinlock_t tasklet_lock;	/**< For drm_locked_tasklet */
	void (*locked_tasklet_func)(struct drm_device *dev);
D
Dave Airlie 已提交
867 868 869 870 871

	/*@} */
	cycles_t ctx_start;
	cycles_t lck_start;

L
Linus Torvalds 已提交
872 873 874 875
	struct fasync_struct *buf_async;/**< Processes waiting for SIGIO */
	wait_queue_head_t buf_readers;	/**< Processes waiting to read */
	wait_queue_head_t buf_writers;	/**< Processes waiting to ctx switch */

D
Dave Airlie 已提交
876
	struct drm_agp_head *agp;	/**< AGP data */
L
Linus Torvalds 已提交
877

D
Dave Airlie 已提交
878
	struct pci_dev *pdev;		/**< PCI device structure */
879 880
	int pci_vendor;			/**< PCI vendor id */
	int pci_device;			/**< PCI device id */
L
Linus Torvalds 已提交
881 882 883
#ifdef __alpha__
	struct pci_controller *hose;
#endif
D
Dave Airlie 已提交
884
	struct drm_sg_mem *sg;	/**< Scatter gather memory */
885
	int num_crtcs;                  /**< Number of CRTCs on this device */
D
Dave Airlie 已提交
886
	void *dev_private;		/**< device private data */
D
Dave Airlie 已提交
887
	struct drm_sigdata sigdata;	   /**< For block_all_signals */
D
Dave Airlie 已提交
888 889 890 891
	sigset_t sigmask;

	struct drm_driver *driver;
	drm_local_map_t *agp_buffer_map;
892
	unsigned int agp_buffer_token;
893
	struct drm_minor *primary;		/**< render type primary screen head */
894 895 896 897

	/** \name Drawable information */
	/*@{ */
	spinlock_t drw_lock;
898
	struct idr drw_idr;
899
	/*@} */
900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915

	/** \name GEM information */
	/*@{ */
	spinlock_t object_name_lock;
	struct idr object_name_idr;
	atomic_t object_count;
	atomic_t object_memory;
	atomic_t pin_count;
	atomic_t pin_memory;
	atomic_t gtt_count;
	atomic_t gtt_memory;
	uint32_t gtt_total;
	uint32_t invalidate_domains;    /* domains pending invalidation */
	uint32_t flush_domains;         /* domains pending flush */
	/*@} */

916
};
L
Linus Torvalds 已提交
917

D
Dave Airlie 已提交
918 919
static __inline__ int drm_core_check_feature(struct drm_device *dev,
					     int feature)
L
Linus Torvalds 已提交
920 921 922 923
{
	return ((dev->driver->driver_features & feature) ? 1 : 0);
}

D
Dave Airlie 已提交
924
#ifdef __alpha__
J
Jay Estabrook 已提交
925
#define drm_get_pci_domain(dev) dev->hose->index
D
Dave Airlie 已提交
926
#else
D
Dave Airlie 已提交
927
#define drm_get_pci_domain(dev) 0
D
Dave Airlie 已提交
928 929
#endif

L
Linus Torvalds 已提交
930 931 932
#if __OS_HAS_AGP
static inline int drm_core_has_AGP(struct drm_device *dev)
{
D
Dave Airlie 已提交
933
	return drm_core_check_feature(dev, DRIVER_USE_AGP);
L
Linus Torvalds 已提交
934 935 936 937 938 939 940 941
}
#else
#define drm_core_has_AGP(dev) (0)
#endif

#if __OS_HAS_MTRR
static inline int drm_core_has_MTRR(struct drm_device *dev)
{
D
Dave Airlie 已提交
942
	return drm_core_check_feature(dev, DRIVER_USE_MTRR);
L
Linus Torvalds 已提交
943
}
944 945 946 947 948 949 950 951 952 953 954 955 956 957 958

#define DRM_MTRR_WC		MTRR_TYPE_WRCOMB

static inline int drm_mtrr_add(unsigned long offset, unsigned long size,
			       unsigned int flags)
{
	return mtrr_add(offset, size, flags, 1);
}

static inline int drm_mtrr_del(int handle, unsigned long offset,
			       unsigned long size, unsigned int flags)
{
	return mtrr_del(handle, offset, size);
}

L
Linus Torvalds 已提交
959 960
#else
#define drm_core_has_MTRR(dev) (0)
961 962 963 964 965 966 967 968 969 970 971 972 973 974

#define DRM_MTRR_WC		0

static inline int drm_mtrr_add(unsigned long offset, unsigned long size,
			       unsigned int flags)
{
	return 0;
}

static inline int drm_mtrr_del(int handle, unsigned long offset,
			       unsigned long size, unsigned int flags)
{
	return 0;
}
L
Linus Torvalds 已提交
975 976 977 978 979 980 981
#endif

/******************************************************************/
/** \name Internal function definitions */
/*@{*/

				/* Driver support (drm_drv.h) */
D
Dave Airlie 已提交
982 983 984 985 986 987
extern int drm_init(struct drm_driver *driver);
extern void drm_exit(struct drm_driver *driver);
extern int drm_ioctl(struct inode *inode, struct file *filp,
		     unsigned int cmd, unsigned long arg);
extern long drm_compat_ioctl(struct file *filp,
			     unsigned int cmd, unsigned long arg);
988
extern int drm_lastclose(struct drm_device *dev);
L
Linus Torvalds 已提交
989 990

				/* Device support (drm_fops.h) */
D
Dave Airlie 已提交
991 992 993 994
extern int drm_open(struct inode *inode, struct file *filp);
extern int drm_stub_open(struct inode *inode, struct file *filp);
extern int drm_fasync(int fd, struct file *filp, int on);
extern int drm_release(struct inode *inode, struct file *filp);
L
Linus Torvalds 已提交
995 996

				/* Mapping support (drm_vm.h) */
D
Dave Airlie 已提交
997
extern int drm_mmap(struct file *filp, struct vm_area_struct *vma);
998 999
extern unsigned long drm_core_get_map_ofs(struct drm_map * map);
extern unsigned long drm_core_get_reg_ofs(struct drm_device *dev);
D
Dave Airlie 已提交
1000
extern unsigned int drm_poll(struct file *filp, struct poll_table_struct *wait);
L
Linus Torvalds 已提交
1001 1002 1003

				/* Memory management support (drm_memory.h) */
#include "drm_memory.h"
D
Dave Airlie 已提交
1004 1005 1006 1007 1008
extern void drm_mem_init(void);
extern int drm_mem_info(char *buf, char **start, off_t offset,
			int request, int *eof, void *data);
extern void *drm_realloc(void *oldpt, size_t oldsize, size_t size, int area);

1009
extern DRM_AGP_MEM *drm_alloc_agp(struct drm_device *dev, int pages, u32 type);
D
Dave Airlie 已提交
1010 1011
extern int drm_free_agp(DRM_AGP_MEM * handle, int pages);
extern int drm_bind_agp(DRM_AGP_MEM * handle, unsigned int start);
1012 1013 1014 1015
extern DRM_AGP_MEM *drm_agp_bind_pages(struct drm_device *dev,
				       struct page **pages,
				       unsigned long num_pages,
				       uint32_t gtt_offset);
D
Dave Airlie 已提交
1016
extern int drm_unbind_agp(DRM_AGP_MEM * handle);
L
Linus Torvalds 已提交
1017 1018

				/* Misc. IOCTL support (drm_ioctl.h) */
1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034
extern int drm_irq_by_busid(struct drm_device *dev, void *data,
			    struct drm_file *file_priv);
extern int drm_getunique(struct drm_device *dev, void *data,
			 struct drm_file *file_priv);
extern int drm_setunique(struct drm_device *dev, void *data,
			 struct drm_file *file_priv);
extern int drm_getmap(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_getclient(struct drm_device *dev, void *data,
			 struct drm_file *file_priv);
extern int drm_getstats(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern int drm_setversion(struct drm_device *dev, void *data,
			  struct drm_file *file_priv);
extern int drm_noop(struct drm_device *dev, void *data,
		    struct drm_file *file_priv);
L
Linus Torvalds 已提交
1035 1036

				/* Context IOCTL support (drm_context.h) */
1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050
extern int drm_resctx(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_addctx(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_modctx(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_getctx(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_switchctx(struct drm_device *dev, void *data,
			 struct drm_file *file_priv);
extern int drm_newctx(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_rmctx(struct drm_device *dev, void *data,
		     struct drm_file *file_priv);
D
Dave Airlie 已提交
1051

1052 1053 1054
extern int drm_ctxbitmap_init(struct drm_device *dev);
extern void drm_ctxbitmap_cleanup(struct drm_device *dev);
extern void drm_ctxbitmap_free(struct drm_device *dev, int ctx_handle);
D
Dave Airlie 已提交
1055

1056 1057 1058 1059
extern int drm_setsareactx(struct drm_device *dev, void *data,
			   struct drm_file *file_priv);
extern int drm_getsareactx(struct drm_device *dev, void *data,
			   struct drm_file *file_priv);
L
Linus Torvalds 已提交
1060 1061

				/* Drawable IOCTL support (drm_drawable.h) */
1062 1063 1064 1065 1066 1067
extern int drm_adddraw(struct drm_device *dev, void *data,
		       struct drm_file *file_priv);
extern int drm_rmdraw(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
extern int drm_update_drawable_info(struct drm_device *dev, void *data,
				    struct drm_file *file_priv);
1068
extern struct drm_drawable_info *drm_get_drawable_info(struct drm_device *dev,
1069
						  drm_drawable_t id);
1070
extern void drm_drawable_free_all(struct drm_device *dev);
L
Linus Torvalds 已提交
1071 1072

				/* Authentication IOCTL support (drm_auth.h) */
1073 1074 1075 1076
extern int drm_getmagic(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern int drm_authmagic(struct drm_device *dev, void *data,
			 struct drm_file *file_priv);
L
Linus Torvalds 已提交
1077

1078 1079 1080
/* Cache management (drm_cache.c) */
void drm_clflush_pages(struct page *pages[], unsigned long num_pages);

L
Linus Torvalds 已提交
1081
				/* Locking IOCTL support (drm_lock.h) */
1082 1083 1084 1085
extern int drm_lock(struct drm_device *dev, void *data,
		    struct drm_file *file_priv);
extern int drm_unlock(struct drm_device *dev, void *data,
		      struct drm_file *file_priv);
D
Dave Airlie 已提交
1086 1087 1088 1089
extern int drm_lock_take(struct drm_lock_data *lock_data, unsigned int context);
extern int drm_lock_free(struct drm_lock_data *lock_data, unsigned int context);
extern void drm_idlelock_take(struct drm_lock_data *lock_data);
extern void drm_idlelock_release(struct drm_lock_data *lock_data);
1090 1091 1092 1093 1094 1095

/*
 * These are exported to drivers so that they can implement fencing using
 * DMA quiscent + idle. DMA quiescent usually requires the hardware lock.
 */

1096
extern int drm_i_have_hw_lock(struct drm_device *dev, struct drm_file *file_priv);
L
Linus Torvalds 已提交
1097 1098

				/* Buffer management support (drm_bufs.h) */
1099 1100 1101
extern int drm_addbufs_agp(struct drm_device *dev, struct drm_buf_desc * request);
extern int drm_addbufs_pci(struct drm_device *dev, struct drm_buf_desc * request);
extern int drm_addmap(struct drm_device *dev, unsigned int offset,
1102 1103
		      unsigned int size, enum drm_map_type type,
		      enum drm_map_flags flags, drm_local_map_t ** map_ptr);
1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119
extern int drm_addmap_ioctl(struct drm_device *dev, void *data,
			    struct drm_file *file_priv);
extern int drm_rmmap(struct drm_device *dev, drm_local_map_t *map);
extern int drm_rmmap_locked(struct drm_device *dev, drm_local_map_t *map);
extern int drm_rmmap_ioctl(struct drm_device *dev, void *data,
			   struct drm_file *file_priv);
extern int drm_addbufs(struct drm_device *dev, void *data,
		       struct drm_file *file_priv);
extern int drm_infobufs(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern int drm_markbufs(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern int drm_freebufs(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern int drm_mapbufs(struct drm_device *dev, void *data,
		       struct drm_file *file_priv);
D
Dave Airlie 已提交
1120
extern int drm_order(unsigned long size);
1121
extern unsigned long drm_get_resource_start(struct drm_device *dev,
D
Dave Airlie 已提交
1122
					    unsigned int resource);
1123
extern unsigned long drm_get_resource_len(struct drm_device *dev,
D
Dave Airlie 已提交
1124
					  unsigned int resource);
L
Linus Torvalds 已提交
1125 1126

				/* DMA support (drm_dma.h) */
1127 1128
extern int drm_dma_setup(struct drm_device *dev);
extern void drm_dma_takedown(struct drm_device *dev);
D
Dave Airlie 已提交
1129
extern void drm_free_buffer(struct drm_device *dev, struct drm_buf * buf);
1130 1131
extern void drm_core_reclaim_buffers(struct drm_device *dev,
				     struct drm_file *filp);
L
Linus Torvalds 已提交
1132 1133

				/* IRQ support (drm_irq.h) */
1134 1135
extern int drm_control(struct drm_device *dev, void *data,
		       struct drm_file *file_priv);
D
Dave Airlie 已提交
1136
extern irqreturn_t drm_irq_handler(DRM_IRQ_ARGS);
1137
extern int drm_irq_install(struct drm_device *dev);
1138 1139 1140 1141
extern int drm_irq_uninstall(struct drm_device *dev);
extern void drm_driver_irq_preinstall(struct drm_device *dev);
extern void drm_driver_irq_postinstall(struct drm_device *dev);
extern void drm_driver_irq_uninstall(struct drm_device *dev);
D
Dave Airlie 已提交
1142

1143
extern int drm_vblank_init(struct drm_device *dev, int num_crtcs);
1144
extern int drm_wait_vblank(struct drm_device *dev, void *data,
1145
			   struct drm_file *filp);
1146
extern int drm_vblank_wait(struct drm_device *dev, unsigned int *vbl_seq);
1147 1148 1149 1150 1151 1152 1153 1154 1155
extern void drm_locked_tasklet(struct drm_device *dev,
			       void(*func)(struct drm_device *));
extern u32 drm_vblank_count(struct drm_device *dev, int crtc);
extern void drm_handle_vblank(struct drm_device *dev, int crtc);
extern int drm_vblank_get(struct drm_device *dev, int crtc);
extern void drm_vblank_put(struct drm_device *dev, int crtc);
/* Modesetting support */
extern int drm_modeset_ctl(struct drm_device *dev, void *data,
			   struct drm_file *file_priv);
1156
extern void drm_locked_tasklet(struct drm_device *dev, void(*func)(struct drm_device*));
L
Linus Torvalds 已提交
1157 1158

				/* AGP/GART support (drm_agpsupport.h) */
D
Dave Airlie 已提交
1159
extern struct drm_agp_head *drm_agp_init(struct drm_device *dev);
1160
extern int drm_agp_acquire(struct drm_device *dev);
1161 1162
extern int drm_agp_acquire_ioctl(struct drm_device *dev, void *data,
				 struct drm_file *file_priv);
1163
extern int drm_agp_release(struct drm_device *dev);
1164 1165
extern int drm_agp_release_ioctl(struct drm_device *dev, void *data,
				 struct drm_file *file_priv);
1166
extern int drm_agp_enable(struct drm_device *dev, struct drm_agp_mode mode);
1167 1168 1169 1170 1171
extern int drm_agp_enable_ioctl(struct drm_device *dev, void *data,
				struct drm_file *file_priv);
extern int drm_agp_info(struct drm_device *dev, struct drm_agp_info *info);
extern int drm_agp_info_ioctl(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
1172
extern int drm_agp_alloc(struct drm_device *dev, struct drm_agp_buffer *request);
1173 1174
extern int drm_agp_alloc_ioctl(struct drm_device *dev, void *data,
			 struct drm_file *file_priv);
1175
extern int drm_agp_free(struct drm_device *dev, struct drm_agp_buffer *request);
1176 1177
extern int drm_agp_free_ioctl(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
1178
extern int drm_agp_unbind(struct drm_device *dev, struct drm_agp_binding *request);
1179 1180
extern int drm_agp_unbind_ioctl(struct drm_device *dev, void *data,
			  struct drm_file *file_priv);
1181
extern int drm_agp_bind(struct drm_device *dev, struct drm_agp_binding *request);
1182 1183 1184
extern int drm_agp_bind_ioctl(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern DRM_AGP_MEM *drm_agp_allocate_memory(struct agp_bridge_data *bridge, size_t pages, u32 type);
D
Dave Airlie 已提交
1185 1186 1187
extern int drm_agp_free_memory(DRM_AGP_MEM * handle);
extern int drm_agp_bind_memory(DRM_AGP_MEM * handle, off_t start);
extern int drm_agp_unbind_memory(DRM_AGP_MEM * handle);
1188
extern void drm_agp_chipset_flush(struct drm_device *dev);
L
Linus Torvalds 已提交
1189 1190 1191

				/* Stub support (drm_stub.h) */
extern int drm_get_dev(struct pci_dev *pdev, const struct pci_device_id *ent,
D
Dave Airlie 已提交
1192
		       struct drm_driver *driver);
1193
extern int drm_put_dev(struct drm_device *dev);
1194
extern int drm_put_minor(struct drm_minor **minor);
D
Dave Airlie 已提交
1195
extern unsigned int drm_debug;
1196

1197
extern struct class *drm_class;
L
Linus Torvalds 已提交
1198 1199
extern struct proc_dir_entry *drm_proc_root;

1200 1201
extern struct idr drm_minors_idr;

1202 1203
extern drm_local_map_t *drm_getsarea(struct drm_device *dev);

L
Linus Torvalds 已提交
1204
				/* Proc support (drm_proc.h) */
1205 1206 1207
extern int drm_proc_init(struct drm_minor *minor, int minor_id,
			 struct proc_dir_entry *root);
extern int drm_proc_cleanup(struct drm_minor *minor, struct proc_dir_entry *root);
L
Linus Torvalds 已提交
1208 1209

				/* Scatter Gather Support (drm_scatter.h) */
D
Dave Airlie 已提交
1210
extern void drm_sg_cleanup(struct drm_sg_mem * entry);
1211 1212 1213 1214 1215
extern int drm_sg_alloc_ioctl(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
extern int drm_sg_alloc(struct drm_device *dev, struct drm_scatter_gather * request);
extern int drm_sg_free(struct drm_device *dev, void *data,
		       struct drm_file *file_priv);
L
Linus Torvalds 已提交
1216

D
Dave Airlie 已提交
1217
			       /* ATI PCIGART support (ati_pcigart.h) */
1218
extern int drm_ati_pcigart_init(struct drm_device *dev,
D
Dave Airlie 已提交
1219
				struct drm_ati_pcigart_info * gart_info);
1220
extern int drm_ati_pcigart_cleanup(struct drm_device *dev,
D
Dave Airlie 已提交
1221
				   struct drm_ati_pcigart_info * gart_info);
L
Linus Torvalds 已提交
1222

1223
extern drm_dma_handle_t *drm_pci_alloc(struct drm_device *dev, size_t size,
1224
				       size_t align, dma_addr_t maxaddr);
1225 1226
extern void __drm_pci_free(struct drm_device *dev, drm_dma_handle_t * dmah);
extern void drm_pci_free(struct drm_device *dev, drm_dma_handle_t * dmah);
L
Linus Torvalds 已提交
1227 1228

			       /* sysfs support (drm_sysfs.c) */
J
Jesse Barnes 已提交
1229
struct drm_sysfs_class;
1230
extern struct class *drm_sysfs_create(struct module *owner, char *name);
J
Jesse Barnes 已提交
1231
extern void drm_sysfs_destroy(void);
1232 1233
extern int drm_sysfs_device_add(struct drm_minor *minor);
extern void drm_sysfs_device_remove(struct drm_minor *minor);
L
Linus Torvalds 已提交
1234

1235 1236 1237
/*
 * Basic memory manager support (drm_mm.c)
 */
D
Dave Airlie 已提交
1238
extern struct drm_mm_node *drm_mm_get_block(struct drm_mm_node * parent,
1239 1240
				       unsigned long size,
				       unsigned alignment);
1241
extern void drm_mm_put_block(struct drm_mm_node * cur);
D
Dave Airlie 已提交
1242
extern struct drm_mm_node *drm_mm_search_free(const struct drm_mm *mm, unsigned long size,
1243
					 unsigned alignment, int best_match);
D
Dave Airlie 已提交
1244 1245 1246 1247 1248 1249
extern int drm_mm_init(struct drm_mm *mm, unsigned long start, unsigned long size);
extern void drm_mm_takedown(struct drm_mm *mm);
extern int drm_mm_clean(struct drm_mm *mm);
extern unsigned long drm_mm_tail_space(struct drm_mm *mm);
extern int drm_mm_remove_space_from_tail(struct drm_mm *mm, unsigned long size);
extern int drm_mm_add_space_to_tail(struct drm_mm *mm, unsigned long size);
1250

1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310
/* Graphics Execution Manager library functions (drm_gem.c) */
int drm_gem_init(struct drm_device *dev);
void drm_gem_object_free(struct kref *kref);
struct drm_gem_object *drm_gem_object_alloc(struct drm_device *dev,
					    size_t size);
void drm_gem_object_handle_free(struct kref *kref);

static inline void
drm_gem_object_reference(struct drm_gem_object *obj)
{
	kref_get(&obj->refcount);
}

static inline void
drm_gem_object_unreference(struct drm_gem_object *obj)
{
	if (obj == NULL)
		return;

	kref_put(&obj->refcount, drm_gem_object_free);
}

int drm_gem_handle_create(struct drm_file *file_priv,
			  struct drm_gem_object *obj,
			  int *handlep);

static inline void
drm_gem_object_handle_reference(struct drm_gem_object *obj)
{
	drm_gem_object_reference(obj);
	kref_get(&obj->handlecount);
}

static inline void
drm_gem_object_handle_unreference(struct drm_gem_object *obj)
{
	if (obj == NULL)
		return;

	/*
	 * Must bump handle count first as this may be the last
	 * ref, in which case the object would disappear before we
	 * checked for a name
	 */
	kref_put(&obj->handlecount, drm_gem_object_handle_free);
	drm_gem_object_unreference(obj);
}

struct drm_gem_object *drm_gem_object_lookup(struct drm_device *dev,
					     struct drm_file *filp,
					     int handle);
int drm_gem_close_ioctl(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
int drm_gem_flink_ioctl(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
int drm_gem_open_ioctl(struct drm_device *dev, void *data,
		       struct drm_file *file_priv);
void drm_gem_open(struct drm_device *dev, struct drm_file *file_private);
void drm_gem_release(struct drm_device *dev, struct drm_file *file_private);

1311
extern void drm_core_ioremap(struct drm_map *map, struct drm_device *dev);
1312
extern void drm_core_ioremap_wc(struct drm_map *map, struct drm_device *dev);
1313
extern void drm_core_ioremapfree(struct drm_map *map, struct drm_device *dev);
L
Linus Torvalds 已提交
1314

D
Dave Airlie 已提交
1315 1316
static __inline__ struct drm_map *drm_core_findmap(struct drm_device *dev,
						   unsigned int token)
L
Linus Torvalds 已提交
1317
{
D
Dave Airlie 已提交
1318
	struct drm_map_list *_entry;
1319
	list_for_each_entry(_entry, &dev->maplist, head)
D
Dave Airlie 已提交
1320 1321
	    if (_entry->user_token == token)
		return _entry->map;
L
Linus Torvalds 已提交
1322 1323 1324
	return NULL;
}

1325
static __inline__ int drm_device_is_agp(struct drm_device *dev)
1326
{
D
Dave Airlie 已提交
1327 1328 1329
	if (dev->driver->device_is_agp != NULL) {
		int err = (*dev->driver->device_is_agp) (dev);

1330 1331 1332 1333 1334 1335 1336 1337
		if (err != 2) {
			return err;
		}
	}

	return pci_find_capability(dev->pdev, PCI_CAP_ID_AGP);
}

1338
static __inline__ int drm_device_is_pcie(struct drm_device *dev)
1339 1340 1341 1342
{
	return pci_find_capability(dev->pdev, PCI_CAP_ID_EXP);
}

L
Linus Torvalds 已提交
1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358
static __inline__ void drm_core_dropmap(struct drm_map *map)
{
}

#ifndef DEBUG_MEMORY
/** Wrapper around kmalloc() */
static __inline__ void *drm_alloc(size_t size, int area)
{
	return kmalloc(size, GFP_KERNEL);
}

/** Wrapper around kfree() */
static __inline__ void drm_free(void *pt, size_t size, int area)
{
	kfree(pt);
}
1359 1360 1361 1362 1363 1364

/** Wrapper around kcalloc() */
static __inline__ void *drm_calloc(size_t nmemb, size_t size, int area)
{
	return kcalloc(nmemb, size, GFP_KERNEL);
}
L
Linus Torvalds 已提交
1365 1366 1367
#else
extern void *drm_alloc(size_t size, int area);
extern void drm_free(void *pt, size_t size, int area);
1368
extern void *drm_calloc(size_t nmemb, size_t size, int area);
L
Linus Torvalds 已提交
1369 1370 1371 1372
#endif

/*@}*/

D
Dave Airlie 已提交
1373
#endif				/* __KERNEL__ */
L
Linus Torvalds 已提交
1374
#endif