drmP.h 57.6 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1
/**
Dave Airlie's avatar
Dave Airlie committed
2
 * \file drmP.h
Linus Torvalds's avatar
Linus Torvalds committed
3
 * Private header for Direct Rendering Manager
Dave Airlie's avatar
Dave Airlie committed
4
 *
Linus Torvalds's avatar
Linus Torvalds committed
5
6
7
8
9
10
11
 * \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.
12
 * Copyright (c) 2009-2010, Code Aurora Forum.
Linus Torvalds's avatar
Linus Torvalds committed
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
 * 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_

#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>
Dave Airlie's avatar
Dave Airlie committed
44
#endif				/* __alpha__ */
Linus Torvalds's avatar
Linus Torvalds committed
45
46
47
48
49
50
#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>
51
#include <linux/platform_device.h>
Linus Torvalds's avatar
Linus Torvalds committed
52
53
#include <linux/pci.h>
#include <linux/jiffies.h>
54
#include <linux/dma-mapping.h>
Linus Torvalds's avatar
Linus Torvalds committed
55
56
#include <linux/mm.h>
#include <linux/cdev.h>
Dave Airlie's avatar
Dave Airlie committed
57
#include <linux/mutex.h>
58
#include <linux/slab.h>
Linus Torvalds's avatar
Linus Torvalds committed
59
#if defined(__alpha__) || defined(__powerpc__)
Dave Airlie's avatar
Dave Airlie committed
60
#include <asm/pgtable.h>	/* For pte_wrprotect */
Linus Torvalds's avatar
Linus Torvalds committed
61
62
63
64
65
66
67
68
69
70
71
72
73
74
#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>
75
76
#include <drm/drm.h>
#include <drm/drm_sarea.h>
Linus Torvalds's avatar
Linus Torvalds committed
77

78
79
#include <linux/idr.h>

Linus Torvalds's avatar
Linus Torvalds committed
80
81
82
#define __OS_HAS_AGP (defined(CONFIG_AGP) || (defined(CONFIG_AGP_MODULE) && defined(MODULE)))
#define __OS_HAS_MTRR (defined(CONFIG_MTRR))

83
84
struct module;

85
86
87
struct drm_file;
struct drm_device;

Linus Torvalds's avatar
Linus Torvalds committed
88
#include "drm_os_linux.h"
89
#include "drm_hashtab.h"
90
#include "drm_mm.h"
Linus Torvalds's avatar
Linus Torvalds committed
91

92
93
94
#define DRM_UT_CORE 		0x01
#define DRM_UT_DRIVER		0x02
#define DRM_UT_KMS		0x04
95
#define DRM_UT_PRIME		0x08
96
97
98
99
100
/*
 * Three debug levels are defined.
 * drm_core, drm_driver, drm_kms
 * drm_core level can be used in the generic drm code. For example:
 * 	drm_ioctl, drm_mm, drm_memory
Lucas De Marchi's avatar
Lucas De Marchi committed
101
 * The macro definition of DRM_DEBUG is used.
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
 * 	DRM_DEBUG(fmt, args...)
 * 	The debug info by using the DRM_DEBUG can be obtained by adding
 * 	the boot option of "drm.debug=1".
 *
 * drm_driver level can be used in the specific drm driver. It is used
 * to add the debug info related with the drm driver. For example:
 * i915_drv, i915_dma, i915_gem, radeon_drv,
 * 	The macro definition of DRM_DEBUG_DRIVER can be used.
 * 	DRM_DEBUG_DRIVER(fmt, args...)
 * 	The debug info by using the DRM_DEBUG_DRIVER can be obtained by
 * 	adding the boot option of "drm.debug=0x02"
 *
 * drm_kms level can be used in the KMS code related with specific drm driver.
 * It is used to add the debug info related with KMS mode. For example:
 * the connector/crtc ,
 * 	The macro definition of DRM_DEBUG_KMS can be used.
 * 	DRM_DEBUG_KMS(fmt, args...)
 * 	The debug info by using the DRM_DEBUG_KMS can be obtained by
 * 	adding the boot option of "drm.debug=0x04"
 *
 * If we add the boot option of "drm.debug=0x06", we can get the debug info by
 * using the DRM_DEBUG_KMS and DRM_DEBUG_DRIVER.
 * If we add the boot option of "drm.debug=0x05", we can get the debug info by
 * using the DRM_DEBUG_KMS and DRM_DEBUG.
 */
127

128
extern __printf(4, 5)
129
void drm_ut_debug_printk(unsigned int request_level,
130
131
132
133
			 const char *prefix,
			 const char *function_name,
			 const char *format, ...);
extern __printf(2, 3)
Joe Perches's avatar
Joe Perches committed
134
135
int drm_err(const char *func, const char *format, ...);

Linus Torvalds's avatar
Linus Torvalds committed
136
137
138
139
140
141
142
143
144
145
146
147
148
/***********************************************************************/
/** \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
149
#define DRIVER_IRQ_VBL     0x100
Linus Torvalds's avatar
Linus Torvalds committed
150
#define DRIVER_DMA_QUEUE   0x200
Dave Airlie's avatar
Dave Airlie committed
151
#define DRIVER_FB_DMA      0x400
152
#define DRIVER_IRQ_VBL2    0x800
153
#define DRIVER_GEM         0x1000
Dave Airlie's avatar
Dave Airlie committed
154
#define DRIVER_MODESET     0x2000
155
#define DRIVER_PRIME       0x4000
156
157
158
159

#define DRIVER_BUS_PCI 0x1
#define DRIVER_BUS_PLATFORM 0x2
#define DRIVER_BUS_USB 0x3
Linus Torvalds's avatar
Linus Torvalds committed
160
161
162
163
164
165
166
167

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

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

168
#define DRM_MAGIC_HASH_ORDER  4  /**< Size of key hash table. Must be power of 2. */
Linus Torvalds's avatar
Linus Torvalds committed
169
170
171
172
173
174
175
176
177
#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_MAX_CTXBITMAP (PAGE_SIZE * 8)
178
#define DRM_MAP_HASH_OFFSET 0x10000000
Linus Torvalds's avatar
Linus Torvalds committed
179

Dave Airlie's avatar
Dave Airlie committed
180
/*@}*/
Linus Torvalds's avatar
Linus Torvalds committed
181
182
183
184
185
186
187
188
189
190
191

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

/**
 * Error output.
 *
 * \param fmt printf() like format string.
 * \param arg arguments
 */
Joe Perches's avatar
Joe Perches committed
192
193
#define DRM_ERROR(fmt, ...)				\
	drm_err(__func__, fmt, ##__VA_ARGS__)
Linus Torvalds's avatar
Linus Torvalds committed
194

Joe Perches's avatar
Joe Perches committed
195
196
#define DRM_INFO(fmt, ...)				\
	printk(KERN_INFO "[" DRM_NAME "] " fmt, ##__VA_ARGS__)
Linus Torvalds's avatar
Linus Torvalds committed
197
198
199

/**
 * Debug output.
Dave Airlie's avatar
Dave Airlie committed
200
 *
Linus Torvalds's avatar
Linus Torvalds committed
201
202
203
204
 * \param fmt printf() like format string.
 * \param arg arguments
 */
#if DRM_DEBUG_CODE
205
#define DRM_DEBUG(fmt, args...)						\
Linus Torvalds's avatar
Linus Torvalds committed
206
	do {								\
207
208
209
210
		drm_ut_debug_printk(DRM_UT_CORE, DRM_NAME, 		\
					__func__, fmt, ##args);		\
	} while (0)

211
#define DRM_DEBUG_DRIVER(fmt, args...)					\
212
	do {								\
213
		drm_ut_debug_printk(DRM_UT_DRIVER, DRM_NAME,		\
214
215
					__func__, fmt, ##args);		\
	} while (0)
216
#define DRM_DEBUG_KMS(fmt, args...)				\
217
	do {								\
218
		drm_ut_debug_printk(DRM_UT_KMS, DRM_NAME, 		\
219
220
					 __func__, fmt, ##args);	\
	} while (0)
221
222
223
224
225
#define DRM_DEBUG_PRIME(fmt, args...)					\
	do {								\
		drm_ut_debug_printk(DRM_UT_PRIME, DRM_NAME,		\
					__func__, fmt, ##args);		\
	} while (0)
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
#define DRM_LOG(fmt, args...)						\
	do {								\
		drm_ut_debug_printk(DRM_UT_CORE, NULL,			\
					NULL, fmt, ##args);		\
	} while (0)
#define DRM_LOG_KMS(fmt, args...)					\
	do {								\
		drm_ut_debug_printk(DRM_UT_KMS, NULL,			\
					NULL, fmt, ##args);		\
	} while (0)
#define DRM_LOG_MODE(fmt, args...)					\
	do {								\
		drm_ut_debug_printk(DRM_UT_MODE, NULL,			\
					NULL, fmt, ##args);		\
	} while (0)
#define DRM_LOG_DRIVER(fmt, args...)					\
	do {								\
		drm_ut_debug_printk(DRM_UT_DRIVER, NULL,		\
					NULL, fmt, ##args);		\
Linus Torvalds's avatar
Linus Torvalds committed
245
246
	} while (0)
#else
247
248
#define DRM_DEBUG_DRIVER(fmt, args...) do { } while (0)
#define DRM_DEBUG_KMS(fmt, args...)	do { } while (0)
249
#define DRM_DEBUG_PRIME(fmt, args...)	do { } while (0)
Linus Torvalds's avatar
Linus Torvalds committed
250
#define DRM_DEBUG(fmt, arg...)		 do { } while (0)
251
252
253
254
255
#define DRM_LOG(fmt, arg...)		do { } while (0)
#define DRM_LOG_KMS(fmt, args...) do { } while (0)
#define DRM_LOG_MODE(fmt, arg...) do { } while (0)
#define DRM_LOG_DRIVER(fmt, arg...) do { } while (0)

Linus Torvalds's avatar
Linus Torvalds committed
256
257
258
259
260
261
262
263
#endif

/*@}*/

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

Dave Airlie's avatar
Dave Airlie committed
264
#define DRM_ARRAY_SIZE(x) ARRAY_SIZE(x)
Linus Torvalds's avatar
Linus Torvalds committed
265
266
267
268
269
270
271
272
273
274
275
276

#define DRM_LEFTCOUNT(x) (((x)->rp + (x)->count - (x)->wp) % ((x)->count + 1))
#define DRM_BUFCOUNT(x) ((x)->count - DRM_LEFTCOUNT(x))

#define DRM_IF_VERSION(maj, min) (maj << 16 | min)

/**
 * Test that the hardware lock is held by the caller, returning otherwise.
 *
 * \param dev DRM device.
 * \param filp file pointer of the caller.
 */
277
278
279
280
#define LOCK_TEST_WITH_RETURN( dev, _file_priv )				\
do {										\
	if (!_DRM_LOCK_IS_HELD(_file_priv->master->lock.hw_lock->lock) ||	\
	    _file_priv->master->lock.file_priv != _file_priv)	{		\
281
		DRM_ERROR( "%s called without lock held, held  %d owner %p %p\n",\
282
283
284
285
			   __func__, _DRM_LOCK_IS_HELD(_file_priv->master->lock.hw_lock->lock),\
			   _file_priv->master->lock.file_priv, _file_priv);	\
		return -EINVAL;							\
	}									\
Linus Torvalds's avatar
Linus Torvalds committed
286
287
288
289
290
291
} while (0)

/**
 * Ioctl function type.
 *
 * \param inode device inode.
292
 * \param file_priv DRM file private pointer.
Linus Torvalds's avatar
Linus Torvalds committed
293
294
295
 * \param cmd command.
 * \param arg argument.
 */
296
297
typedef int drm_ioctl_t(struct drm_device *dev, void *data,
			struct drm_file *file_priv);
Linus Torvalds's avatar
Linus Torvalds committed
298

299
300
301
typedef int drm_ioctl_compat_t(struct file *filp, unsigned int cmd,
			       unsigned long arg);

302
303
304
#define DRM_IOCTL_NR(n)                _IOC_NR(n)
#define DRM_MAJOR       226

305
306
307
#define DRM_AUTH	0x1
#define	DRM_MASTER	0x2
#define DRM_ROOT_ONLY	0x4
Dave Airlie's avatar
Dave Airlie committed
308
#define DRM_CONTROL_ALLOW 0x8
309
#define DRM_UNLOCKED	0x10
310

311
312
struct drm_ioctl_desc {
	unsigned int cmd;
313
	int flags;
314
	drm_ioctl_t *func;
315
	unsigned int cmd_drv;
316
317
318
319
320
321
};

/**
 * Creates a driver or general drm_ioctl_desc array entry for the given
 * ioctl, for use by drm_ioctl().
 */
322
323
324

#define DRM_IOCTL_DEF_DRV(ioctl, _func, _flags)			\
	[DRM_IOCTL_NR(DRM_##ioctl)] = {.cmd = DRM_##ioctl, .func = _func, .flags = _flags, .cmd_drv = DRM_IOCTL_##ioctl}
Linus Torvalds's avatar
Linus Torvalds committed
325

326
struct drm_magic_entry {
327
	struct list_head head;
328
	struct drm_hash_item hash_item;
Dave Airlie's avatar
Dave Airlie committed
329
	struct drm_file *priv;
330
};
Linus Torvalds's avatar
Linus Torvalds committed
331

332
struct drm_vma_entry {
333
	struct list_head head;
Linus Torvalds's avatar
Linus Torvalds committed
334
	struct vm_area_struct *vma;
Dave Airlie's avatar
Dave Airlie committed
335
	pid_t pid;
336
};
Linus Torvalds's avatar
Linus Torvalds committed
337
338
339
340

/**
 * DMA buffer.
 */
Dave Airlie's avatar
Dave Airlie committed
341
struct drm_buf {
Dave Airlie's avatar
Dave Airlie committed
342
343
344
345
346
347
348
349
350
351
	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 */
352
	struct drm_file *file_priv;    /**< Private of holding file descr */
Dave Airlie's avatar
Dave Airlie committed
353
354
	int context;		       /**< Kernel queue for this buffer */
	int while_locked;	       /**< Dispatch this buffer while locked */
Linus Torvalds's avatar
Linus Torvalds committed
355
	enum {
Dave Airlie's avatar
Dave Airlie committed
356
357
358
359
360
		DRM_LIST_NONE = 0,
		DRM_LIST_FREE = 1,
		DRM_LIST_WAIT = 2,
		DRM_LIST_PEND = 3,
		DRM_LIST_PRIO = 4,
Linus Torvalds's avatar
Linus Torvalds committed
361
		DRM_LIST_RECLAIM = 5
Dave Airlie's avatar
Dave Airlie committed
362
	} list;			       /**< Which list we're on */
Linus Torvalds's avatar
Linus Torvalds committed
363

Dave Airlie's avatar
Dave Airlie committed
364
365
	int dev_priv_size;		 /**< Size of buffer private storage */
	void *dev_private;		 /**< Per-buffer private storage */
Dave Airlie's avatar
Dave Airlie committed
366
};
Linus Torvalds's avatar
Linus Torvalds committed
367
368

/** bufs is one longer than it has to be */
369
struct drm_waitlist {
Dave Airlie's avatar
Dave Airlie committed
370
	int count;			/**< Number of possible buffers */
Dave Airlie's avatar
Dave Airlie committed
371
372
373
374
	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 */
Dave Airlie's avatar
Dave Airlie committed
375
376
	spinlock_t read_lock;
	spinlock_t write_lock;
377
};
Linus Torvalds's avatar
Linus Torvalds committed
378

379
struct drm_freelist {
Dave Airlie's avatar
Dave Airlie committed
380
381
	int initialized;	       /**< Freelist in use */
	atomic_t count;		       /**< Number of free buffers */
Dave Airlie's avatar
Dave Airlie committed
382
	struct drm_buf *next;	       /**< End pointer */
Linus Torvalds's avatar
Linus Torvalds committed
383
384

	wait_queue_head_t waiting;     /**< Processes waiting on free bufs */
Dave Airlie's avatar
Dave Airlie committed
385
386
387
388
	int low_mark;		       /**< Low water mark */
	int high_mark;		       /**< High water mark */
	atomic_t wfh;		       /**< If waiting for high mark */
	spinlock_t lock;
389
};
Linus Torvalds's avatar
Linus Torvalds committed
390

Dave Airlie's avatar
Dave Airlie committed
391
392
393
394
395
396
typedef struct drm_dma_handle {
	dma_addr_t busaddr;
	void *vaddr;
	size_t size;
} drm_dma_handle_t;

Linus Torvalds's avatar
Linus Torvalds committed
397
398
399
/**
 * Buffer entry.  There is one of this for each buffer size order.
 */
400
struct drm_buf_entry {
Dave Airlie's avatar
Dave Airlie committed
401
402
	int buf_size;			/**< size */
	int buf_count;			/**< number of buffers */
Dave Airlie's avatar
Dave Airlie committed
403
	struct drm_buf *buflist;		/**< buffer list */
Dave Airlie's avatar
Dave Airlie committed
404
405
	int seg_count;
	int page_order;
406
	struct drm_dma_handle **seglist;
Dave Airlie's avatar
Dave Airlie committed
407

408
409
	struct drm_freelist freelist;
};
Linus Torvalds's avatar
Linus Torvalds committed
410

411
412
413
414
415
/* Event queued up for userspace to read */
struct drm_pending_event {
	struct drm_event *event;
	struct list_head link;
	struct drm_file *file_priv;
416
417
	pid_t pid; /* pid of requester, no guarantee it's valid by the time
		      we deliver the event, for tracing only */
418
419
420
	void (*destroy)(struct drm_pending_event *event);
};

421
422
423
424
425
426
/* initial implementaton using a linked list - todo hashtab */
struct drm_prime_file_private {
	struct list_head head;
	struct mutex lock;
};

Linus Torvalds's avatar
Linus Torvalds committed
427
/** File private data */
428
struct drm_file {
Dave Airlie's avatar
Dave Airlie committed
429
430
431
432
433
	int authenticated;
	pid_t pid;
	uid_t uid;
	drm_magic_t magic;
	unsigned long ioctl_count;
434
	struct list_head lhead;
435
	struct drm_minor *minor;
Dave Airlie's avatar
Dave Airlie committed
436
	unsigned long lock_count;
437

438
439
440
441
	/** Mapping of mm object handles to object pointers. */
	struct idr object_idr;
	/** Lock for synchronization of access to object_idr. */
	spinlock_t table_lock;
442

443
	struct file *filp;
444
	void *driver_priv;
445
446
447
448

	int is_master; /* this file private is a master for a minor */
	struct drm_master *master; /* master this node is currently associated with
				      N.B. not always minor->master */
Dave Airlie's avatar
Dave Airlie committed
449
	struct list_head fbs;
450
451
452
453

	wait_queue_head_t event_wait;
	struct list_head event_list;
	int event_space;
454
455

	struct drm_prime_file_private prime;
456
};
Linus Torvalds's avatar
Linus Torvalds committed
457
458

/** Wait queue */
459
struct drm_queue {
Dave Airlie's avatar
Dave Airlie committed
460
461
462
463
	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 */
Linus Torvalds's avatar
Linus Torvalds committed
464
	wait_queue_head_t read_queue;	/**< Processes waiting on block_read */
Dave Airlie's avatar
Dave Airlie committed
465
	atomic_t block_write;		/**< Queue blocked for writes */
Linus Torvalds's avatar
Linus Torvalds committed
466
	wait_queue_head_t write_queue;	/**< Processes waiting on block_write */
Dave Airlie's avatar
Dave Airlie committed
467
468
469
	atomic_t total_queued;		/**< Total queued statistic */
	atomic_t total_flushed;		/**< Total flushes statistic */
	atomic_t total_locks;		/**< Total locks statistics */
470
	enum drm_ctx_flags flags;	/**< Context preserving and 2D-only */
471
	struct drm_waitlist waitlist;	/**< Pending buffers */
Linus Torvalds's avatar
Linus Torvalds committed
472
	wait_queue_head_t flush_queue;	/**< Processes waiting until flush */
473
};
Linus Torvalds's avatar
Linus Torvalds committed
474
475
476
477

/**
 * Lock data.
 */
Dave Airlie's avatar
Dave Airlie committed
478
struct drm_lock_data {
479
	struct drm_hw_lock *hw_lock;	/**< Hardware lock */
480
481
	/** Private of lock holder's file (NULL=kernel) */
	struct drm_file *file_priv;
Linus Torvalds's avatar
Linus Torvalds committed
482
	wait_queue_head_t lock_queue;	/**< Queue of blocked processes */
Dave Airlie's avatar
Dave Airlie committed
483
	unsigned long lock_time;	/**< Time of last lock in jiffies */
484
485
486
487
	spinlock_t spinlock;
	uint32_t kernel_waiters;
	uint32_t user_waiters;
	int idle_has_lock;
Dave Airlie's avatar
Dave Airlie committed
488
};
Linus Torvalds's avatar
Linus Torvalds committed
489
490
491
492

/**
 * DMA data.
 */
493
struct drm_device_dma {
Linus Torvalds's avatar
Linus Torvalds committed
494

495
	struct drm_buf_entry bufs[DRM_MAX_ORDER + 1];	/**< buffers, grouped by their size order */
Dave Airlie's avatar
Dave Airlie committed
496
	int buf_count;			/**< total number of buffers */
Dave Airlie's avatar
Dave Airlie committed
497
	struct drm_buf **buflist;		/**< Vector of pointers into drm_device_dma::bufs */
Dave Airlie's avatar
Dave Airlie committed
498
499
500
501
	int seg_count;
	int page_count;			/**< number of pages */
	unsigned long *pagelist;	/**< page list */
	unsigned long byte_count;
Linus Torvalds's avatar
Linus Torvalds committed
502
503
	enum {
		_DRM_DMA_USE_AGP = 0x01,
Dave Airlie's avatar
Dave Airlie committed
504
		_DRM_DMA_USE_SG = 0x02,
505
506
		_DRM_DMA_USE_FB = 0x04,
		_DRM_DMA_USE_PCI_RO = 0x08
Linus Torvalds's avatar
Linus Torvalds committed
507
508
	} flags;

509
};
Linus Torvalds's avatar
Linus Torvalds committed
510

Dave Airlie's avatar
Dave Airlie committed
511
/**
Linus Torvalds's avatar
Linus Torvalds committed
512
513
 * AGP memory entry.  Stored as a doubly linked list.
 */
Dave Airlie's avatar
Dave Airlie committed
514
struct drm_agp_mem {
Dave Airlie's avatar
Dave Airlie committed
515
516
517
518
	unsigned long handle;		/**< handle */
	DRM_AGP_MEM *memory;
	unsigned long bound;		/**< address */
	int pages;
519
	struct list_head head;
Dave Airlie's avatar
Dave Airlie committed
520
};
Linus Torvalds's avatar
Linus Torvalds committed
521
522
523
524
525
526

/**
 * AGP data.
 *
 * \sa drm_agp_init() and drm_device::agp.
 */
Dave Airlie's avatar
Dave Airlie committed
527
struct drm_agp_head {
Dave Airlie's avatar
Dave Airlie committed
528
	DRM_AGP_KERN agp_info;		/**< AGP device information */
529
	struct list_head memory;
Dave Airlie's avatar
Dave Airlie committed
530
531
532
533
534
535
536
537
	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;
Dave Airlie's avatar
Dave Airlie committed
538
};
Linus Torvalds's avatar
Linus Torvalds committed
539
540
541
542

/**
 * Scatter-gather memory.
 */
Dave Airlie's avatar
Dave Airlie committed
543
struct drm_sg_mem {
Dave Airlie's avatar
Dave Airlie committed
544
545
546
547
548
	unsigned long handle;
	void *virtual;
	int pages;
	struct page **pagelist;
	dma_addr_t *busaddr;
Dave Airlie's avatar
Dave Airlie committed
549
};
Linus Torvalds's avatar
Linus Torvalds committed
550

Dave Airlie's avatar
Dave Airlie committed
551
struct drm_sigdata {
Dave Airlie's avatar
Dave Airlie committed
552
	int context;
553
	struct drm_hw_lock *lock;
Dave Airlie's avatar
Dave Airlie committed
554
};
Linus Torvalds's avatar
Linus Torvalds committed
555

556

557
558
559
560
/**
 * Kernel side of a mapping
 */
struct drm_local_map {
561
	resource_size_t offset;	 /**< Requested physical address (0 for SAREA)*/
562
563
564
565
566
567
568
569
570
571
	unsigned long size;	 /**< Requested physical size (bytes) */
	enum drm_map_type type;	 /**< Type of memory to map */
	enum drm_map_flags flags;	 /**< Flags */
	void *handle;		 /**< User-space: "Handle" to pass to mmap() */
				 /**< Kernel-space: kernel-virtual address */
	int mtrr;		 /**< MTRR slot used */
};

typedef struct drm_local_map drm_local_map_t;

Linus Torvalds's avatar
Linus Torvalds committed
572
573
574
/**
 * Mappings list
 */
Dave Airlie's avatar
Dave Airlie committed
575
struct drm_map_list {
Dave Airlie's avatar
Dave Airlie committed
576
	struct list_head head;		/**< list head */
577
	struct drm_hash_item hash;
578
	struct drm_local_map *map;	/**< mapping */
579
	uint64_t user_token;
580
	struct drm_master *master;
Jesse Barnes's avatar
Jesse Barnes committed
581
	struct drm_mm_node *file_offset_node;	/**< fake offset */
Dave Airlie's avatar
Dave Airlie committed
582
};
Linus Torvalds's avatar
Linus Torvalds committed
583
584
585
586

/**
 * Context handle list
 */
Dave Airlie's avatar
Dave Airlie committed
587
struct drm_ctx_list {
Dave Airlie's avatar
Dave Airlie committed
588
589
	struct list_head head;		/**< list head */
	drm_context_t handle;		/**< context handle */
590
	struct drm_file *tag;		/**< associated fd private data */
Dave Airlie's avatar
Dave Airlie committed
591
};
Linus Torvalds's avatar
Linus Torvalds committed
592

593
594
595
596
/* location of GART table */
#define DRM_ATI_GART_MAIN 1
#define DRM_ATI_GART_FB   2

597
598
599
600
#define DRM_ATI_GART_PCI 1
#define DRM_ATI_GART_PCIE 2
#define DRM_ATI_GART_IGP 3

Dave Airlie's avatar
Dave Airlie committed
601
struct drm_ati_pcigart_info {
602
	int gart_table_location;
603
	int gart_reg_if;
604
	void *addr;
605
	dma_addr_t bus_addr;
606
607
	dma_addr_t table_mask;
	struct drm_dma_handle *table_handle;
608
	struct drm_local_map mapping;
609
	int table_size;
Dave Airlie's avatar
Dave Airlie committed
610
};
611

Jesse Barnes's avatar
Jesse Barnes committed
612
613
614
615
616
617
618
619
/**
 * GEM specific mm private for tracking GEM objects
 */
struct drm_gem_mm {
	struct drm_mm offset_manager;	/**< Offset mgmt for buffer objects */
	struct drm_open_hash offset_hash; /**< User token hash table for maps */
};

620
621
622
623
624
625
626
627
628
/**
 * 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 */
629
	atomic_t handle_count; /* number of handles on this object */
630
631
632
633
634
635
636

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

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

Jesse Barnes's avatar
Jesse Barnes committed
637
638
639
	/* Mapping info for this object */
	struct drm_map_list map_list;

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
	/**
	 * 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;
671
672
673
674
675
676

	/* dma buf exported from this GEM object */
	struct dma_buf *export_dma_buf;

	/* dma buf attachment backing this object */
	struct dma_buf_attachment *import_attach;
677
678
};

Dave Airlie's avatar
Dave Airlie committed
679
680
#include "drm_crtc.h"

681
682
683
684
685
686
687
688
689
690
/* per-master structure */
struct drm_master {

	struct kref refcount; /* refcount for this master */

	struct list_head head; /**< each minor contains a list of masters */
	struct drm_minor *minor; /**< link back to minor we are a master for */

	char *unique;			/**< Unique identifier: e.g., busid */
	int unique_len;			/**< Length of unique field */
691
	int unique_size;		/**< amount allocated */
692
693
694
695
696
697
698
699
700
701
702
703
704
705

	int blocked;			/**< Blocked due to VC switch? */

	/** \name Authentication */
	/*@{ */
	struct drm_open_hash magiclist;
	struct list_head magicfree;
	/*@} */

	struct drm_lock_data lock;	/**< Information on hardware lock */

	void *driver_priv; /**< Private structure for driver to use */
};

706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
/* Size of ringbuffer for vblank timestamps. Just double-buffer
 * in initial implementation.
 */
#define DRM_VBLANKTIME_RBSIZE 2

/* Flags and return codes for get_vblank_timestamp() driver function. */
#define DRM_CALLED_FROM_VBLIRQ 1
#define DRM_VBLANKTIME_SCANOUTPOS_METHOD (1 << 0)
#define DRM_VBLANKTIME_INVBL             (1 << 1)

/* get_scanout_position() return flags */
#define DRM_SCANOUTPOS_VALID        (1 << 0)
#define DRM_SCANOUTPOS_INVBL        (1 << 1)
#define DRM_SCANOUTPOS_ACCURATE     (1 << 2)

721
722
723
724
725
726
727
728
729
730
731
732
733
struct drm_bus {
	int bus_type;
	int (*get_irq)(struct drm_device *dev);
	const char *(*get_name)(struct drm_device *dev);
	int (*set_busid)(struct drm_device *dev, struct drm_master *master);
	int (*set_unique)(struct drm_device *dev, struct drm_master *master,
			  struct drm_unique *unique);
	int (*irq_by_busid)(struct drm_device *dev, struct drm_irq_busid *p);
	/* hooks that are for PCI */
	int (*agp_init)(struct drm_device *dev);

};

Linus Torvalds's avatar
Linus Torvalds committed
734
735
736
737
738
739
/**
 * 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 {
740
741
	int (*load) (struct drm_device *, unsigned long flags);
	int (*firstopen) (struct drm_device *);
742
	int (*open) (struct drm_device *, struct drm_file *);
743
	void (*preclose) (struct drm_device *, struct drm_file *file_priv);
744
	void (*postclose) (struct drm_device *, struct drm_file *);
745
746
	void (*lastclose) (struct drm_device *);
	int (*unload) (struct drm_device *);
747
	int (*suspend) (struct drm_device *, pm_message_t state);
Jesse Barnes's avatar
Jesse Barnes committed
748
	int (*resume) (struct drm_device *);
749
	int (*dma_ioctl) (struct drm_device *dev, void *data, struct drm_file *file_priv);
Dave Airlie's avatar
Dave Airlie committed
750
	int (*dma_quiescent) (struct drm_device *);
751
	int (*context_dtor) (struct drm_device *dev, int context);
Dave Airlie's avatar
Dave Airlie committed
752

753
754
755
756
757
	/**
	 * get_vblank_counter - get raw hardware vblank counter
	 * @dev: DRM device
	 * @crtc: counter to fetch
	 *
758
759
760
761
762
	 * 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. The DRM core will account for
	 * missed vblank events while interrupts where disabled based on system
	 * timestamps.
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
	 *
	 * 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);

798
799
800
801
802
803
804
805
806
807
808
	/**
	 * 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).
	 */
809
	int (*device_is_agp) (struct drm_device *dev);
810

811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
	/**
	 * Called by vblank timestamping code.
	 *
	 * Return the current display scanout position from a crtc.
	 *
	 * \param dev  DRM device.
	 * \param crtc Id of the crtc to query.
	 * \param *vpos Target location for current vertical scanout position.
	 * \param *hpos Target location for current horizontal scanout position.
	 *
	 * Returns vpos as a positive number while in active scanout area.
	 * Returns vpos as a negative number inside vblank, counting the number
	 * of scanlines to go until end of vblank, e.g., -1 means "one scanline
	 * until start of active scanout / end of vblank."
	 *
	 * \return Flags, or'ed together as follows:
	 *
Lucas De Marchi's avatar
Lucas De Marchi committed
828
	 * DRM_SCANOUTPOS_VALID = Query successful.
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
	 * DRM_SCANOUTPOS_INVBL = Inside vblank.
	 * DRM_SCANOUTPOS_ACCURATE = Returned position is accurate. A lack of
	 * this flag means that returned position may be offset by a constant
	 * but unknown small number of scanlines wrt. real scanout position.
	 *
	 */
	int (*get_scanout_position) (struct drm_device *dev, int crtc,
				     int *vpos, int *hpos);

	/**
	 * Called by \c drm_get_last_vbltimestamp. Should return a precise
	 * timestamp when the most recent VBLANK interval ended or will end.
	 *
	 * Specifically, the timestamp in @vblank_time should correspond as
	 * closely as possible to the time when the first video scanline of
	 * the video frame after the end of VBLANK will start scanning out,
845
	 * the time immediately after end of the VBLANK interval. If the
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
	 * @crtc is currently inside VBLANK, this will be a time in the future.
	 * If the @crtc is currently scanning out a frame, this will be the
	 * past start time of the current scanout. This is meant to adhere
	 * to the OpenML OML_sync_control extension specification.
	 *
	 * \param dev dev DRM device handle.
	 * \param crtc crtc for which timestamp should be returned.
	 * \param *max_error Maximum allowable timestamp error in nanoseconds.
	 *                   Implementation should strive to provide timestamp
	 *                   with an error of at most *max_error nanoseconds.
	 *                   Returns true upper bound on error for timestamp.
	 * \param *vblank_time Target location for returned vblank timestamp.
	 * \param flags 0 = Defaults, no special treatment needed.
	 * \param       DRM_CALLED_FROM_VBLIRQ = Function is called from vblank
	 *	        irq handler. Some drivers need to apply some workarounds
	 *              for gpu-specific vblank irq quirks if flag is set.
	 *
	 * \returns
	 * Zero if timestamping isn't supported in current display mode or a
	 * negative number on failure. A positive status code on success,
	 * which describes how the vblank_time timestamp was computed.
	 */
	int (*get_vblank_timestamp) (struct drm_device *dev, int crtc,
				     int *max_error,
				     struct timeval *vblank_time,
				     unsigned flags);

Linus Torvalds's avatar
Linus Torvalds committed
873
	/* these have to be filled in */
Dave Airlie's avatar
Dave Airlie committed
874

875
	irqreturn_t(*irq_handler) (DRM_IRQ_ARGS);
876
	void (*irq_preinstall) (struct drm_device *dev);
877
	int (*irq_postinstall) (struct drm_device *dev);
878
879
	void (*irq_uninstall) (struct drm_device *dev);
	void (*set_version) (struct drm_device *dev,
880
			     struct drm_set_version *sv);
881

882
883
884
	/* Master routines */
	int (*master_create)(struct drm_device *dev, struct drm_master *master);
	void (*master_destroy)(struct drm_device *dev, struct drm_master *master);
885
886
887
888
889
890
891
892
893
	/**
	 * master_set is called whenever the minor master is set.
	 * master_drop is called whenever the minor master is dropped.
	 */

	int (*master_set)(struct drm_device *dev, struct drm_file *file_priv,
			  bool from_open);
	void (*master_drop)(struct drm_device *dev, struct drm_file *file_priv,
			    bool from_release);
894

895
896
	int (*debugfs_init)(struct drm_minor *minor);
	void (*debugfs_cleanup)(struct drm_minor *minor);
897
898
899
900
901
902
903
904
905

	/**
	 * 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);
906
907
	int (*gem_open_object) (struct drm_gem_object *, struct drm_file *);
	void (*gem_close_object) (struct drm_gem_object *, struct drm_file *);
908

909
910
911
912
913
914
915
916
917
918
919
920
921
922
	/* prime: */
	/* export handle -> fd (see drm_gem_prime_handle_to_fd() helper) */
	int (*prime_handle_to_fd)(struct drm_device *dev, struct drm_file *file_priv,
				uint32_t handle, uint32_t flags, int *prime_fd);
	/* import fd -> handle (see drm_gem_prime_fd_to_handle() helper) */
	int (*prime_fd_to_handle)(struct drm_device *dev, struct drm_file *file_priv,
				int prime_fd, uint32_t *handle);
	/* export GEM -> dmabuf */
	struct dma_buf * (*gem_prime_export)(struct drm_device *dev,
				struct drm_gem_object *obj, int flags);
	/* import dmabuf -> GEM */
	struct drm_gem_object * (*gem_prime_import)(struct drm_device *dev,
				struct dma_buf *dma_buf);

923
924
925
	/* vga arb irq handler */
	void (*vgaarb_irq)(struct drm_device *dev, bool state);

926
927
928
929
930
931
932
933
934
935
936
	/* dumb alloc support */
	int (*dumb_create)(struct drm_file *file_priv,
			   struct drm_device *dev,
			   struct drm_mode_create_dumb *args);
	int (*dumb_map_offset)(struct drm_file *file_priv,
			       struct drm_device *dev, uint32_t handle,
			       uint64_t *offset);
	int (*dumb_destroy)(struct drm_file *file_priv,
			    struct drm_device *dev,
			    uint32_t handle);

Jesse Barnes's avatar
Jesse Barnes committed
937
	/* Driver private ops for this object */
938
	const struct vm_operations_struct *gem_vm_ops;
Jesse Barnes's avatar
Jesse Barnes committed
939

940
941
942
943
944
945
946
	int major;
	int minor;
	int patchlevel;
	char *name;
	char *desc;
	char *date;

Linus Torvalds's avatar
Linus Torvalds committed
947
948
	u32 driver_features;
	int dev_priv_size;
949
	struct drm_ioctl_desc *ioctls;
Linus Torvalds's avatar
Linus Torvalds committed
950
	int num_ioctls;
951
	const struct file_operations *fops;
952
953
954
	union {
		struct pci_driver *pci;
		struct platform_device *platform_device;
Dave Airlie's avatar
Dave Airlie committed
955
		struct usb_driver *usb;
956
957
958
	} kdriver;
	struct drm_bus *bus;

959
960
	/* List of devices hanging off this driver */
	struct list_head device_list;
Linus Torvalds's avatar
Linus Torvalds committed
961
962
};

963
964
#define DRM_MINOR_UNASSIGNED 0
#define DRM_MINOR_LEGACY 1
Dave Airlie's avatar
Dave Airlie committed
965
966
#define DRM_MINOR_CONTROL 2
#define DRM_MINOR_RENDER 3
967

968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009

/**
 * debugfs node list. This structure represents a debugfs file to
 * be created by the drm core
 */
struct drm_debugfs_list {
	const char *name; /** file name */
	int (*show)(struct seq_file*, void*); /** show callback */
	u32 driver_features; /**< Required driver features for this entry */
};

/**
 * debugfs node structure. This structure represents a debugfs file.
 */
struct drm_debugfs_node {
	struct list_head list;
	struct drm_minor *minor;
	struct drm_debugfs_list *debugfs_ent;
	struct dentry *dent;
};

/**
 * Info file list entry. This structure represents a debugfs or proc file to
 * be created by the drm core
 */
struct drm_info_list {
	const char *name; /** file name */
	int (*show)(struct seq_file*, void*); /** show callback */
	u32 driver_features; /**< Required driver features for this entry */
	void *data;
};

/**
 * debugfs node structure. This structure represents a debugfs file.
 */
struct drm_info_node {
	struct list_head list;
	struct drm_minor *minor;
	struct drm_info_list *info_ent;
	struct dentry *dent;
};

Linus Torvalds's avatar
Linus Torvalds committed
1010
/**
1011
 * DRM minor structure. This structure represents a drm minor number.
Linus Torvalds's avatar
Linus Torvalds committed
1012
 */
1013
1014
1015
1016
1017
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 */
Linus Torvalds's avatar
Linus Torvalds committed
1018
	struct drm_device *dev;
1019
1020
1021
1022

	struct proc_dir_entry *proc_root;  /**< proc directory entry */
	struct drm_info_node proc_nodes;
	struct dentry *debugfs_root;
1023
1024
1025

	struct list_head debugfs_list;
	struct mutex debugfs_lock; /* Protects debugfs_list. */
1026

1027
1028
	struct drm_master *master; /* currently active master for this node */
	struct list_head master_list;
Dave Airlie's avatar
Dave Airlie committed
1029
	struct drm_mode_group mode_group;
1030
};
Linus Torvalds's avatar
Linus Torvalds committed
1031

1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
/* mode specified on the command line */
struct drm_cmdline_mode {
	bool specified;
	bool refresh_specified;
	bool bpp_specified;
	int xres, yres;
	int bpp;
	int refresh;
	bool rb;
	bool interlace;
	bool cvt;
	bool margins;
	enum drm_connector_force force;
};


1048
1049
1050
1051
1052
1053
struct drm_pending_vblank_event {
	struct drm_pending_event base;
	int pipe;
	struct drm_event_vblank event;
};

Linus Torvalds's avatar
Linus Torvalds committed
1054
1055
1056
1057
/**
 * DRM device structure. This structure represent a complete card that
 * may contain multiple heads.
 */
1058
struct drm_device {
1059
	struct list_head driver_item;	/**< list of devices per driver */
Dave Airlie's avatar
Dave Airlie committed
1060
1061
	char *devname;			/**< For /proc/interrupts */
	int if_version;			/**< Highest interface version set */
Linus Torvalds's avatar
Linus Torvalds committed
1062
1063

	/** \name Locks */
Dave Airlie's avatar
Dave Airlie committed
1064
1065
	/*@{ */
	spinlock_t count_lock;		/**< For inuse, drm_device::open_count, drm_device::buf_use */
Dave Airlie's avatar
Dave Airlie committed
1066
	struct mutex struct_mutex;	/**< For others */
Dave Airlie's avatar
Dave Airlie committed
1067
	/*@} */
Linus Torvalds's avatar
Linus Torvalds committed
1068
1069

	/** \name Usage Counters */
Dave Airlie's avatar
Dave Airlie committed
1070
1071
1072
1073
1074
1075
1076
	/*@{ */
	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 */
	/*@} */
Linus Torvalds's avatar
Linus Torvalds committed
1077
1078

	/** \name Performance counters */
Dave Airlie's avatar
Dave Airlie committed
1079
1080
	/*@{ */
	unsigned long counters;
1081
	enum drm_stat_type types[15];
Dave Airlie's avatar
Dave Airlie committed
1082
1083
	atomic_t counts[15];
	/*@} */
Linus Torvalds's avatar
Linus Torvalds committed
1084

1085
	struct list_head filelist;
Linus Torvalds's avatar
Linus Torvalds committed
1086
1087

	/** \name Memory management */
Dave Airlie's avatar
Dave Airlie committed
1088
	/*@{ */
1089
	struct list_head maplist;	/**< Linked list of regions */
Dave Airlie's avatar
Dave Airlie committed
1090
	int map_count;			/**< Number of mappable regions */
1091
	struct drm_open_hash map_hash;	/**< User token hash table for maps */
Linus Torvalds's avatar
Linus Torvalds committed
1092
1093

	/** \name Context handle management */
Dave Airlie's avatar
Dave Airlie committed
1094
	/*@{ */
1095
	struct list_head ctxlist;	/**< Linked list of context handles */
Dave Airlie's avatar
Dave Airlie committed
1096
	int ctx_count;			/**< Number of context handles */
Dave Airlie's avatar
Dave Airlie committed
1097
	struct mutex ctxlist_mutex;	/**< For ctxlist */
Linus Torvalds's avatar
Linus Torvalds committed
1098

1099
	struct idr ctx_idr;
Linus Torvalds's avatar
Linus Torvalds committed
1100

1101
	struct list_head vmalist;	/**< List of vmas (for debugging) */
Dave Airlie's avatar
Dave Airlie committed
1102

Dave Airlie's avatar
Dave Airlie committed
1103
	/*@} */
Linus Torvalds's avatar
Linus Torvalds committed
1104

Daniel Vetter's avatar
Daniel Vetter committed
1105
	/** \name DMA support */
Dave Airlie's avatar
Dave Airlie committed
1106
	/*@{ */
1107
	struct drm_device_dma *dma;		/**< Optional pointer for DMA support */
Dave Airlie's avatar
Dave Airlie committed
1108
	/*@} */
Linus Torvalds's avatar
Linus Torvalds committed
1109
1110

	/** \name Context support */
Dave Airlie's avatar
Dave Airlie committed
1111
1112
	/*@{ */
	int irq_enabled;		/**< True if irq handler is enabled */
Linus Torvalds's avatar
Linus Torvalds committed
1113
1114
1115
	__volatile__ long context_flag;	/**< Context swapping flag */
	__volatile__ long interrupt_flag; /**< Interruption handler flag */
	__volatile__ long dma_flag;	/**< DMA dispatch flag */
Dave Airlie's avatar
Dave Airlie committed
1116
1117
1118
1119
1120
1121
1122
	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;
Linus Torvalds's avatar
Linus Torvalds committed
1123
	/** \name VBLANK IRQ support */
Dave Airlie's avatar
Dave Airlie committed
1124
1125
	/*@{ */

1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
	/*
	 * 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) */
1136
1137
	struct timeval *_vblank_time;   /**< timestamp of current vblank_count (drivers must alloc right number of fields) */
	spinlock_t vblank_time_lock;    /**< Protects vblank count and time updates during vblank enable/disable */
Dave Airlie's avatar
Dave Airlie committed
1138
	spinlock_t vbl_lock;
1139
1140
1141
1142
1143
1144
	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 */
1145
	u32 *last_vblank_wait;		/* Last vblank seqno waited per CRTC */
1146
1147
1148
	struct timer_list vblank_disable_timer;

	u32 max_vblank_count;           /**< size of vblank counter register */
Dave Airlie's avatar
Dave Airlie committed
1149

1150
1151
1152
1153
1154
1155
	/**
	 * List of events
	 */
	struct list_head vblank_event_list;
	spinlock_t event_lock;

Dave Airlie's avatar
Dave Airlie committed
1156
1157
1158
1159
	/*@} */
	cycles_t ctx_start;
	cycles_t lck_start;

Linus Torvalds's avatar
Linus Torvalds committed
1160
1161
1162
1163
	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 */

Dave Airlie's avatar
Dave Airlie committed
1164
	struct drm_agp_head *agp;	/**< AGP data */
Linus Torvalds's avatar
Linus Torvalds committed
1165

1166
	struct device *dev;             /**< Device structure */
Dave Airlie's avatar
Dave Airlie committed
1167
	struct pci_dev *pdev;		/**< PCI device structure */
1168
1169
	int pci_vendor;			/**< PCI vendor id */
	int pci_device;			/**< PCI device id */
Linus Torvalds's avatar
Linus Torvalds committed
1170
1171
1172
#ifdef __alpha__
	struct pci_controller *hose;
#endif
1173
1174

	struct platform_device *platformdev; /**< Platform device struture */
Dave Airlie's avatar
Dave Airlie committed
1175
	struct usb_device *usbdev;
1176

Dave Airlie's avatar
Dave Airlie committed
1177
	struct drm_sg_mem *sg;	/**< Scatter gather memory */
1178
	unsigned int num_crtcs;                  /**< Number of CRTCs on this device */
Dave Airlie's avatar
Dave Airlie committed
1179
	void *dev_private;		/**< device private data */
Jesse Barnes's avatar
Jesse Barnes committed
1180
1181
	void *mm_private;
	struct address_space *dev_mapping;
Dave Airlie's avatar
Dave Airlie committed
1182
	struct drm_sigdata sigdata;	   /**< For block_all_signals */
Dave Airlie's avatar
Dave Airlie committed
1183
1184
1185
	sigset_t sigmask;

	struct drm_driver *driver;
1186
	struct drm_local_map *agp_buffer_map;
1187
	unsigned int agp_buffer_token;
Dave Airlie's avatar
Dave Airlie committed
1188
	struct drm_minor *control;		/**< Control node for card */
1189
	struct drm_minor *primary;		/**< render type primary screen head */
1190

Dave Airlie's avatar
Dave Airlie committed
1191
1192
        struct drm_mode_config mode_config;	/**< Current mode config */

1193
1194
1195
1196
1197
	/** \name GEM information */
	/*@{ */
	spinlock_t object_name_lock;
	struct idr object_name_idr;
	/*@} */
1198
	int switch_power_state;
1199
1200

	atomic_t unplugged; /* device has been unplugged or gone away */
1201
};
Linus Torvalds's avatar
Linus Torvalds committed
1202

1203
1204
1205
1206
#define DRM_SWITCH_POWER_ON 0
#define DRM_SWITCH_POWER_OFF 1
#define DRM_SWITCH_POWER_CHANGING 2

Dave Airlie's avatar
Dave Airlie committed
1207
1208
static __inline__ int drm_core_check_feature(struct drm_device *dev,
					     int feature)
Linus Torvalds's avatar
Linus Torvalds committed
1209
1210
1211
1212
{
	return ((dev->driver->driver_features & feature) ? 1 : 0);
}

1213
1214
static inline int drm_dev_to_irq(struct drm_device *dev)
{
1215
	return dev->driver->bus->get_irq(dev);
1216
1217
}

Dave Airlie's avatar
Dave Airlie committed
1218

Linus Torvalds's avatar
Linus Torvalds committed
1219
1220
1221
#if __OS_HAS_AGP
static inline int drm_core_has_AGP(struct drm_device *dev)
{
Dave Airlie's avatar
Dave Airlie committed
1222