xref: /titanic_50/usr/src/uts/common/io/drm/drmP.h (revision c242ec1b4cd260e90178d81575297bb3b3648766)
1 /*
2  * drmP.h -- Private header for Direct Rendering Manager -*- linux-c -*-
3  * Created: Mon Jan  4 10:05:05 1999 by faith@precisioninsight.com
4  */
5 /*
6  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
7  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
8  * All rights reserved.
9  *
10  * Permission is hereby granted, free of charge, to any person obtaining a
11  * copy of this software and associated documentation files (the "Software"),
12  * to deal in the Software without restriction, including without limitation
13  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
14  * and/or sell copies of the Software, and to permit persons to whom the
15  * Software is furnished to do so, subject to the following conditions:
16  *
17  * The above copyright notice and this permission notice (including the next
18  * paragraph) shall be included in all copies or substantial portions of the
19  * Software.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
24  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
25  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
27  * OTHER DEALINGS IN THE SOFTWARE.
28  *
29  * Authors:
30  *    Rickard E. (Rik) Faith <faith@valinux.com>
31  *    Gareth Hughes <gareth@valinux.com>
32  *
33  */
34 
35 /*
36  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
37  * Use is subject to license terms.
38  */
39 
40 #ifndef	_DRMP_H
41 #define	_DRMP_H
42 
43 #include <sys/types.h>
44 #include <sys/conf.h>
45 #include <sys/modctl.h>
46 #include <sys/stat.h>
47 #include <sys/file.h>
48 #include <sys/cmn_err.h>
49 #include <sys/varargs.h>
50 #include <sys/pci.h>
51 #include <sys/ddi.h>
52 #include <sys/sunddi.h>
53 #include <sys/sunldi.h>
54 #include <sys/pmem.h>
55 #include <sys/agpgart.h>
56 #include <sys/time.h>
57 #include "drm_atomic.h"
58 #include "drm.h"
59 #include "queue.h"
60 #include "drm_linux_list.h"
61 
62 #ifndef __inline__
63 #define	__inline__	inline
64 #endif
65 
66 #if !defined(__FUNCTION__)
67 #if defined(C99)
68 #define	__FUNCTION__ __func__
69 #else
70 #define	__FUNCTION__	" "
71 #endif
72 #endif
73 
74 /* DRM space units */
75 #define	DRM_PAGE_SHIFT			PAGESHIFT
76 #define	DRM_PAGE_SIZE			(1 << DRM_PAGE_SHIFT)
77 #define	DRM_PAGE_OFFSET			(DRM_PAGE_SIZE - 1)
78 #define	DRM_PAGE_MASK			~(DRM_PAGE_SIZE - 1)
79 #define	DRM_MB2PAGES(x)			((x) << 8)
80 #define	DRM_PAGES2BYTES(x)		((x) << DRM_PAGE_SHIFT)
81 #define	DRM_BYTES2PAGES(x)		((x) >> DRM_PAGE_SHIFT)
82 #define	DRM_PAGES2KB(x)			((x) << 2)
83 #define	DRM_ALIGNED(offset)		(((offset) & DRM_PAGE_OFFSET) == 0)
84 
85 #define	PAGE_SHIFT			DRM_PAGE_SHIFT
86 #define	PAGE_SIZE			DRM_PAGE_SIZE
87 
88 #define	DRM_MAX_INSTANCES	8
89 #define	DRM_DEVNODE		"drm"
90 #define	DRM_UNOPENED		0
91 #define	DRM_OPENED		1
92 
93 #define	DRM_HASH_SIZE		16 /* Size of key hash table */
94 #define	DRM_KERNEL_CONTEXT	0  /* Change drm_resctx if changed */
95 #define	DRM_RESERVED_CONTEXTS	1  /* Change drm_resctx if changed */
96 
97 #define	DRM_MEM_DMA	   0
98 #define	DRM_MEM_SAREA	   1
99 #define	DRM_MEM_DRIVER	   2
100 #define	DRM_MEM_MAGIC	   3
101 #define	DRM_MEM_IOCTLS	   4
102 #define	DRM_MEM_MAPS	   5
103 #define	DRM_MEM_BUFS	   6
104 #define	DRM_MEM_SEGS	   7
105 #define	DRM_MEM_PAGES	   8
106 #define	DRM_MEM_FILES	  9
107 #define	DRM_MEM_QUEUES	  10
108 #define	DRM_MEM_CMDS	  11
109 #define	DRM_MEM_MAPPINGS  12
110 #define	DRM_MEM_BUFLISTS  13
111 #define	DRM_MEM_DRMLISTS  14
112 #define	DRM_MEM_TOTALDRM  15
113 #define	DRM_MEM_BOUNDDRM  16
114 #define	DRM_MEM_CTXBITMAP 17
115 #define	DRM_MEM_STUB	  18
116 #define	DRM_MEM_SGLISTS	  19
117 #define	DRM_MEM_AGPLISTS  20
118 #define	DRM_MEM_CTXLIST   21
119 #define	DRM_MEM_MM		22
120 #define	DRM_MEM_HASHTAB		23
121 #define	DRM_MEM_OBJECTS		24
122 
123 #define	DRM_MAX_CTXBITMAP (PAGE_SIZE * 8)
124 #define	DRM_MAP_HASH_OFFSET 0x10000000
125 #define	DRM_MAP_HASH_ORDER 12
126 #define	DRM_OBJECT_HASH_ORDER 12
127 #define	DRM_FILE_PAGE_OFFSET_START ((0xFFFFFFFFUL >> PAGE_SHIFT) + 1)
128 #define	DRM_FILE_PAGE_OFFSET_SIZE ((0xFFFFFFFFUL >> PAGE_SHIFT) * 16)
129 #define	DRM_MM_INIT_MAX_PAGES 256
130 
131 
132 /* Internal types and structures */
133 #define	DRM_ARRAY_SIZE(x) (sizeof (x) / sizeof (x[0]))
134 #define	DRM_MIN(a, b) ((a) < (b) ? (a) : (b))
135 #define	DRM_MAX(a, b) ((a) > (b) ? (a) : (b))
136 
137 #define	DRM_IF_VERSION(maj, min) (maj << 16 | min)
138 
139 #define	__OS_HAS_AGP	1
140 
141 #define	DRM_DEV_MOD	(S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP)
142 #define	DRM_DEV_UID	0
143 #define	DRM_DEV_GID	0
144 
145 #define	DRM_CURRENTPID		ddi_get_pid()
146 #define	DRM_SPINLOCK(l)		mutex_enter(l)
147 #define	DRM_SPINUNLOCK(u)	mutex_exit(u)
148 #define	DRM_SPINLOCK_ASSERT(l)
149 #define	DRM_LOCK()	mutex_enter(&dev->dev_lock)
150 #define	DRM_UNLOCK()	mutex_exit(&dev->dev_lock)
151 #define	DRM_LOCK_OWNED()	ASSERT(mutex_owned(&dev->dev_lock))
152 #define	spin_lock_irqsave(l, flag)		mutex_enter(l)
153 #define	spin_unlock_irqrestore(u, flag) mutex_exit(u)
154 #define	spin_lock(l)		mutex_enter(l)
155 #define	spin_unlock(u)		mutex_exit(u)
156 
157 #define	DRM_UDELAY(sec)  delay(drv_usectohz(sec *1000))
158 #define	DRM_MEMORYBARRIER()
159 
160 typedef	struct drm_file		drm_file_t;
161 typedef struct drm_device	drm_device_t;
162 typedef struct drm_driver_info drm_driver_t;
163 
164 #define	DRM_DEVICE	drm_device_t *dev = dev1
165 #define	DRM_IOCTL_ARGS	\
166 	drm_device_t *dev1, intptr_t data, drm_file_t *fpriv, int mode
167 
168 #define	DRM_COPYFROM_WITH_RETURN(dest, src, size)	\
169 	if (ddi_copyin(src, dest, size, 0)) \
170 		return (EFAULT)
171 
172 #define	DRM_COPYTO_WITH_RETURN(dest, src, size)	\
173 	if (ddi_copyout((src), (dest), (size), 0)) \
174 		return (EFAULT)
175 
176 #define	DRM_COPY_FROM_USER(dest, src, size) \
177 	ddi_copyin((src), (dest), (size), 0) /* flag for src */
178 
179 #define	DRM_COPY_TO_USER(dest, src, size) \
180 	ddi_copyout((src), (dest), (size), 0) /* flags for dest */
181 
182 #define	DRM_COPY_FROM_USER_UNCHECKED(arg1, arg2, arg3)  \
183 	ddi_copyin((arg2), (arg1), (arg3), 0)
184 
185 #define	DRM_COPY_TO_USER_UNCHECKED(arg1, arg2, arg3)        \
186 	ddi_copyout((arg2), arg1, arg3, 0)
187 
188 #define	DRM_READ8(map, offset) \
189 	*(uint8_t *)((uintptr_t)((map)->dev_addr) + (offset))
190 #define	DRM_READ16(map, offset) \
191 	*(uint16_t *)((uintptr_t)((map)->dev_addr) + (offset))
192 #define	DRM_READ32(map, offset) \
193 	*(uint32_t *)((uintptr_t)((map)->dev_addr) + (offset))
194 #define	DRM_WRITE8(map, offset, val) \
195 	*(uint8_t *)((uintptr_t)((map)->dev_addr) + (offset)) = (val)
196 #define	DRM_WRITE16(map, offset, val) \
197 	*(uint16_t *)((uintptr_t)((map)->dev_addr) + (offset)) = (val)
198 #define	DRM_WRITE32(map, offset, val) \
199 	*(uint32_t *)((uintptr_t)((map)->dev_addr) + (offset)) = (val)
200 
201 typedef struct drm_wait_queue {
202 	kcondvar_t	cv;
203 	kmutex_t	lock;
204 }wait_queue_head_t;
205 
206 #define	DRM_INIT_WAITQUEUE(q, pri)	\
207 { \
208 	mutex_init(&(q)->lock, NULL, MUTEX_DRIVER, pri); \
209 	cv_init(&(q)->cv, NULL, CV_DRIVER, NULL);	\
210 }
211 
212 #define	DRM_FINI_WAITQUEUE(q)	\
213 { \
214 	mutex_destroy(&(q)->lock);	\
215 	cv_destroy(&(q)->cv);	\
216 }
217 
218 #define	DRM_WAKEUP(q)	\
219 { \
220 	mutex_enter(&(q)->lock); \
221 	cv_broadcast(&(q)->cv);	\
222 	mutex_exit(&(q)->lock);	\
223 }
224 
225 #define	jiffies			ddi_get_lbolt()
226 #define	DRM_WAIT_ON(ret, q, timeout, condition)  \
227 mutex_enter(&(q)->lock);	\
228 while (!(condition)) {	\
229 	ret = cv_timedwait_sig(&(q)->cv, &(q)->lock, jiffies + timeout); \
230 	if (ret == -1) {					\
231 		ret = EBUSY;				\
232 		break;					\
233 	} else if (ret == 0) {				\
234 		ret = EINTR;  \
235 		break; \
236 	} else { \
237 		ret = 0; \
238 	} \
239 } \
240 mutex_exit(&(q)->lock);
241 
242 #define	DRM_GETSAREA()  					\
243 {                                				\
244 	drm_local_map_t *map;					\
245 	DRM_SPINLOCK_ASSERT(&dev->dev_lock);			\
246 	TAILQ_FOREACH(map, &dev->maplist, link) {		\
247 		if (map->type == _DRM_SHM &&			\
248 			map->flags & _DRM_CONTAINS_LOCK) {	\
249 			dev_priv->sarea = map;			\
250 			break;					\
251 		}						\
252 	}							\
253 }
254 
255 #define	LOCK_TEST_WITH_RETURN(dev, fpriv)				\
256 	if (!_DRM_LOCK_IS_HELD(dev->lock.hw_lock->lock) ||		\
257 	    dev->lock.filp != fpriv) {					\
258 		DRM_ERROR("called without lock held");	\
259 		return (EINVAL);					\
260 	}
261 
262 #define	DRM_IRQ_ARGS	caddr_t arg
263 #define	IRQ_HANDLED		DDI_INTR_CLAIMED
264 #define	IRQ_NONE		DDI_INTR_UNCLAIMED
265 
266 enum {
267 	DRM_IS_NOT_AGP,
268 	DRM_IS_AGP,
269 	DRM_MIGHT_BE_AGP
270 };
271 
272 /* Capabilities taken from src/sys/dev/pci/pcireg.h. */
273 #ifndef PCIY_AGP
274 #define	PCIY_AGP		0x02
275 #endif
276 
277 #ifndef PCIY_EXPRESS
278 #define	PCIY_EXPRESS		0x10
279 #endif
280 
281 #define	PAGE_ALIGN(addr)	(((addr) + DRM_PAGE_SIZE - 1) & DRM_PAGE_MASK)
282 #define	DRM_SUSER(p)		(crgetsgid(p) == 0 || crgetsuid(p) == 0)
283 
284 /*
285  * wait for 400 milliseconds
286  */
287 #define	DRM_HZ			drv_usectohz(400000)
288 
289 typedef unsigned long dma_addr_t;
290 typedef uint64_t	u64;
291 typedef uint32_t	u32;
292 typedef uint16_t	u16;
293 typedef uint8_t		u8;
294 typedef uint_t		irqreturn_t;
295 
296 #define	DRM_SUPPORT	1
297 #define	DRM_UNSUPPORT	0
298 
299 #define	__OS_HAS_AGP	1
300 
301 #define	__offsetof(type, field) ((size_t)(&((type *)0)->field))
302 #define	offsetof(type, field)   __offsetof(type, field)
303 
304 typedef struct drm_pci_id_list
305 {
306 	int vendor;
307 	int device;
308 	long driver_private;
309 	char *name;
310 } drm_pci_id_list_t;
311 
312 #define	DRM_AUTH	0x1
313 #define	DRM_MASTER	0x2
314 #define	DRM_ROOT_ONLY	0x4
315 typedef int drm_ioctl_t(DRM_IOCTL_ARGS);
316 typedef struct drm_ioctl_desc {
317 	int	(*func)(DRM_IOCTL_ARGS);
318 	int	flags;
319 } drm_ioctl_desc_t;
320 
321 typedef struct drm_magic_entry {
322 	drm_magic_t		magic;
323 	struct drm_file		*priv;
324 	struct drm_magic_entry	*next;
325 } drm_magic_entry_t;
326 
327 typedef struct drm_magic_head {
328 	struct drm_magic_entry *head;
329 	struct drm_magic_entry *tail;
330 } drm_magic_head_t;
331 
332 typedef struct drm_buf {
333 	int		idx;		/* Index into master buflist */
334 	int		total;		/* Buffer size */
335 	int		order;		/* log-base-2(total) */
336 	int		used;		/* Amount of buffer in use (for DMA) */
337 	unsigned long	offset;		/* Byte offset (used internally) */
338 	void		*address;	/* Address of buffer */
339 	unsigned long	bus_address;	/* Bus address of buffer */
340 	struct drm_buf	*next;		/* Kernel-only: used for free list */
341 	volatile int	pending;	/* On hardware DMA queue */
342 	drm_file_t		*filp;
343 				/* Uniq. identifier of holding process */
344 	int		context;	/* Kernel queue for this buffer */
345 	enum {
346 		DRM_LIST_NONE	 = 0,
347 		DRM_LIST_FREE	 = 1,
348 		DRM_LIST_WAIT	 = 2,
349 		DRM_LIST_PEND	 = 3,
350 		DRM_LIST_PRIO	 = 4,
351 		DRM_LIST_RECLAIM = 5
352 	}		list;		/* Which list we're on */
353 
354 	int		dev_priv_size;	/* Size of buffer private stoarge */
355 	void		*dev_private;	/* Per-buffer private storage */
356 } drm_buf_t;
357 
358 typedef struct drm_freelist {
359 	int		  initialized;	/* Freelist in use		*/
360 	uint32_t	  count;	/* Number of free buffers	*/
361 	drm_buf_t	  *next;	/* End pointer			*/
362 
363 	int		  low_mark;	/* Low water mark		*/
364 	int		  high_mark;	/* High water mark		*/
365 } drm_freelist_t;
366 
367 typedef struct drm_buf_entry {
368 	int		  buf_size;
369 	int		  buf_count;
370 	drm_buf_t	  *buflist;
371 	int		  seg_count;
372 	int		  page_order;
373 
374 	uint32_t	  *seglist;
375 	unsigned long	  *seglist_bus;
376 
377 	drm_freelist_t	  freelist;
378 } drm_buf_entry_t;
379 
380 typedef TAILQ_HEAD(drm_file_list, drm_file) drm_file_list_t;
381 struct drm_file {
382 	TAILQ_ENTRY(drm_file) link;
383 	int		  authenticated;
384 	int		  master;
385 	int		  minor;
386 	pid_t		  pid;
387 	uid_t		  uid;
388 	int		  refs;
389 	drm_magic_t	  magic;
390 	unsigned long	  ioctl_count;
391 	void		 *driver_priv;
392 };
393 
394 typedef struct drm_lock_data {
395 	drm_hw_lock_t	*hw_lock;	/* Hardware lock		*/
396 	drm_file_t	*filp;
397 	/* Uniq. identifier of holding process */
398 	kcondvar_t	lock_cv;	/* lock queue - SOLARIS Specific */
399 	kmutex_t	lock_mutex;	/* lock - SOLARIS Specific */
400 	unsigned long	lock_time;	/* Time of last lock in jiffies */
401 } drm_lock_data_t;
402 
403 /*
404  * This structure, in drm_device_t, is always initialized while the device
405  * is open.  dev->dma_lock protects the incrementing of dev->buf_use, which
406  * when set marks that no further bufs may be allocated until device teardown
407  * occurs (when the last open of the device has closed).  The high/low
408  * watermarks of bufs are only touched by the X Server, and thus not
409  * concurrently accessed, so no locking is needed.
410  */
411 typedef struct drm_device_dma {
412 	drm_buf_entry_t	bufs[DRM_MAX_ORDER+1];
413 	int		buf_count;
414 	drm_buf_t	**buflist;	/* Vector of pointers info bufs	   */
415 	int		seg_count;
416 	int		page_count;
417 	unsigned long	*pagelist;
418 	unsigned long	byte_count;
419 	enum {
420 		_DRM_DMA_USE_AGP = 0x01,
421 		_DRM_DMA_USE_SG  = 0x02
422 	} flags;
423 } drm_device_dma_t;
424 
425 typedef struct drm_agp_mem {
426 	void		*handle;
427 	unsigned long	bound; /* address */
428 	int		pages;
429 	caddr_t		phys_addr;
430 	struct drm_agp_mem *prev;
431 	struct drm_agp_mem *next;
432 } drm_agp_mem_t;
433 
434 typedef struct drm_agp_head {
435 	agp_info_t	agp_info;
436 	const char	*chipset;
437 	drm_agp_mem_t	*memory;
438 	unsigned long	mode;
439 	int		enabled;
440 	int		acquired;
441 	unsigned long	base;
442 	int		mtrr;
443 	int		cant_use_aperture;
444 	unsigned long	page_mask;
445 	ldi_ident_t	agpgart_li;
446 	ldi_handle_t	agpgart_lh;
447 } drm_agp_head_t;
448 
449 
450 typedef struct drm_dma_handle {
451 	ddi_dma_handle_t	dma_hdl;
452 	ddi_acc_handle_t	acc_hdl;
453 	ddi_dma_cookie_t	cookie;
454 	uint_t		cookie_num;
455 	uintptr_t		vaddr;   /* virtual addr */
456 	uintptr_t		paddr;   /* physical addr */
457 	size_t		real_sz; /* real size of memory */
458 } drm_dma_handle_t;
459 
460 typedef struct drm_sg_mem {
461 	unsigned long	handle;
462 	void		*virtual;
463 	int		pages;
464 	dma_addr_t  	*busaddr;
465 	ddi_umem_cookie_t	*umem_cookie;
466 	drm_dma_handle_t	*dmah_sg;
467 	drm_dma_handle_t	*dmah_gart; /* Handle to PCI memory */
468 } drm_sg_mem_t;
469 
470 typedef TAILQ_HEAD(drm_map_list, drm_local_map) drm_map_list_t;
471 
472 /* BEGIN CSTYLED */
473 typedef struct drm_local_map {
474 	unsigned long	offset;  /*  Physical address (0 for SAREA)	*/
475 	unsigned long	size;	 /* Physical size (bytes)		*/
476 	drm_map_type_t	type;	 /* Type of memory mapped		*/
477 	drm_map_flags_t flags;	 /* Flags				*/
478 	void		*handle; /* User-space: "Handle" to pass to mmap */
479 				 /* Kernel-space: kernel-virtual address */
480 	int		mtrr;	 /* Boolean: MTRR used 			*/
481 				 /* Private data			*/
482 	int		rid;	 /* PCI resource ID for bus_space 	*/
483 	int		kernel_owned; /* Boolean: 1= initmapped, 0= addmapped */
484 	caddr_t		dev_addr;	  /* base device address 	*/
485 	ddi_acc_handle_t  dev_handle;	  /* The data access handle 	*/
486 	ddi_umem_cookie_t drm_umem_cookie; /* For SAREA alloc and free  */
487 	TAILQ_ENTRY(drm_local_map) link;
488 } drm_local_map_t;
489 /* END CSTYLED */
490 
491 typedef TAILQ_HEAD(drm_vbl_sig_list, drm_vbl_sig) drm_vbl_sig_list_t;
492 typedef struct drm_vbl_sig {
493 	TAILQ_ENTRY(drm_vbl_sig) link;
494 	unsigned int	sequence;
495 	int		signo;
496 	int		pid;
497 } drm_vbl_sig_t;
498 
499 
500 /* used for clone device */
501 typedef TAILQ_HEAD(drm_cminor_list, drm_cminor) drm_cminor_list_t;
502 typedef struct drm_cminor {
503 	TAILQ_ENTRY(drm_cminor) link;
504 	drm_file_t		*fpriv;
505 	int			minor;
506 } drm_cminor_t;
507 
508 /* location of GART table */
509 #define	DRM_ATI_GART_MAIN	1
510 #define	DRM_ATI_GART_FB		2
511 
512 typedef struct ati_pcigart_info {
513 	int gart_table_location;
514 	int is_pcie;
515 	void *addr;
516 	dma_addr_t bus_addr;
517 	drm_local_map_t mapping;
518 } drm_ati_pcigart_info;
519 
520 /* DRM device structure */
521 struct drm_device;
522 struct drm_driver_info {
523 	int (*load)(struct drm_device *, unsigned long);
524 	int (*firstopen)(struct drm_device *);
525 	int (*open)(struct drm_device *, drm_file_t *);
526 	void (*preclose)(struct drm_device *, drm_file_t *);
527 	void (*postclose)(struct drm_device *, drm_file_t *);
528 	void (*lastclose)(struct drm_device *);
529 	int (*unload)(struct drm_device *);
530 	void (*reclaim_buffers_locked)(struct drm_device *, drm_file_t *);
531 	int (*presetup)(struct drm_device *);
532 	int (*postsetup)(struct drm_device *);
533 	int (*open_helper)(struct drm_device *, drm_file_t *);
534 	void (*free_filp_priv)(struct drm_device *, drm_file_t *);
535 	void (*release)(struct drm_device *, void *);
536 	int (*dma_ioctl)(DRM_IOCTL_ARGS);
537 	void (*dma_ready)(struct drm_device *);
538 	int (*dma_quiescent)(struct drm_device *);
539 	int (*dma_flush_block_and_flush)(struct drm_device *,
540 			int, drm_lock_flags_t);
541 	int (*dma_flush_unblock)(struct drm_device *, int,
542 					drm_lock_flags_t);
543 	int (*context_ctor)(struct drm_device *, int);
544 	int (*context_dtor)(struct drm_device *, int);
545 	int (*kernel_context_switch)(struct drm_device *, int, int);
546 	int (*kernel_context_switch_unlock)(struct drm_device *);
547 	int (*device_is_agp) (struct drm_device *);
548 	int (*irq_preinstall)(struct drm_device *);
549 	void (*irq_postinstall)(struct drm_device *);
550 	void (*irq_uninstall)(struct drm_device *dev);
551 	uint_t (*irq_handler)(DRM_IRQ_ARGS);
552 	int (*vblank_wait)(struct drm_device *, unsigned int *);
553 	int (*vblank_wait2)(struct drm_device *, unsigned int *);
554 	/* added for intel minimized vblank */
555 	u32 (*get_vblank_counter)(struct drm_device *dev, int crtc);
556 	int (*enable_vblank)(struct drm_device *dev, int crtc);
557 	void (*disable_vblank)(struct drm_device *dev, int crtc);
558 
559 	drm_ioctl_desc_t *driver_ioctls;
560 	int	max_driver_ioctl;
561 
562 	int	buf_priv_size;
563 	int	driver_major;
564 	int	driver_minor;
565 	int	driver_patchlevel;
566 	const char *driver_name;	/* Simple driver name		   */
567 	const char *driver_desc;	/* Longer driver name		   */
568 	const char *driver_date;	/* Date of last major changes.	   */
569 
570 	unsigned use_agp :1;
571 	unsigned require_agp :1;
572 	unsigned use_sg :1;
573 	unsigned use_dma :1;
574 	unsigned use_pci_dma :1;
575 	unsigned use_dma_queue :1;
576 	unsigned use_irq :1;
577 	unsigned use_vbl_irq :1;
578 	unsigned use_vbl_irq2 :1;
579 	unsigned use_mtrr :1;
580 };
581 
582 /*
583  * hardware-specific code needs to initialize mutexes which
584  * can be used in interrupt context, so they need to know
585  * the interrupt priority. Interrupt cookie in drm_device
586  * structure is the intr_block field.
587  */
588 #define	DRM_INTR_PRI(dev) \
589 	DDI_INTR_PRI((dev)->intr_block)
590 
591 struct drm_device {
592 	drm_driver_t	*driver;
593 	drm_cminor_list_t	minordevs;
594 	dev_info_t *dip;
595 	void	*drm_handle;
596 	int drm_supported;
597 	const char *desc; /* current driver description */
598 	kmutex_t *irq_mutex;
599 	kcondvar_t *irq_cv;
600 
601 	ddi_iblock_cookie_t intr_block;
602 	uint32_t	pci_device;	/* PCI device id */
603 	uint32_t	pci_vendor;
604 	char		*unique;	/* Unique identifier: e.g., busid  */
605 	int		unique_len;	/* Length of unique field	   */
606 	int		if_version;	/* Highest interface version set */
607 	int		flags;	/* Flags to open(2)		   */
608 
609 	/* Locks */
610 	kmutex_t	  vbl_lock;	/* protects vblank operations */
611 	kmutex_t	  dma_lock;	/* protects dev->dma */
612 	kmutex_t	  irq_lock;	/* protects irq condition checks */
613 	kmutex_t	  dev_lock;	/* protects everything else */
614 	drm_lock_data_t   lock;		/* Information on hardware lock    */
615 
616 	/* Usage Counters */
617 	int		  open_count;	/* Outstanding files open	   */
618 	int		  buf_use;	/* Buffers in use -- cannot alloc  */
619 
620 	/* Performance counters */
621 	unsigned long	  counters;
622 	drm_stat_type_t	  types[15];
623 	uint32_t	  counts[15];
624 
625 	/* Authentication */
626 	drm_file_list_t   files;
627 	drm_magic_head_t  magiclist[DRM_HASH_SIZE];
628 
629 	/* Linked list of mappable regions. Protected by dev_lock */
630 	drm_map_list_t	  maplist;
631 
632 	drm_local_map_t	  **context_sareas;
633 	int		  max_context;
634 
635 	/* DMA queues (contexts) */
636 	drm_device_dma_t  *dma;		/* Optional pointer for DMA support */
637 
638 	/* Context support */
639 	int		  irq;		/* Interrupt used by board	   */
640 	int		  irq_enabled;	/* True if the irq handler is enabled */
641 	int		  pci_domain;
642 	int		  pci_bus;
643 	int		  pci_slot;
644 	int		  pci_func;
645 	atomic_t	  context_flag;	/* Context swapping flag	   */
646 	int		  last_context;	/* Last current context		   */
647 
648 	/* Only used for Radeon */
649 	atomic_t	vbl_received;
650 	atomic_t	vbl_received2;
651 
652 	drm_vbl_sig_list_t vbl_sig_list;
653 	drm_vbl_sig_list_t vbl_sig_list2;
654 
655 	int vblank_disable_allowed;
656 
657 	wait_queue_head_t	vbl_queue;	/* vbl wait channel */
658 	/* vbl wait channel array */
659 	wait_queue_head_t	*vbl_queues;
660 
661 	/* number of VBLANK interrupts */
662 	/* (driver must alloc the right number of counters) */
663 	atomic_t	  *_vblank_count;
664 	/* signal list to send on VBLANK */
665 	struct drm_vbl_sig_list *vbl_sigs;
666 
667 	/* number of signals pending on all crtcs */
668 	atomic_t	  vbl_signal_pending;
669 	/* number of users of vblank interrupts per crtc */
670 	atomic_t	  *vblank_refcount;
671 	/* protected by dev->vbl_lock, used for wraparound handling */
672 	u32		  *last_vblank;
673 	/* so we don't call enable more than */
674 	atomic_t	  *vblank_enabled;
675 	/* for compensation of spurious wraparounds */
676 	u32		  *vblank_premodeset;
677 	/* Don't wait while crtc is likely disabled */
678 	int		  *vblank_suspend;
679 	/* size of vblank counter register */
680 	u32		  max_vblank_count;
681 	int		  num_crtcs;
682 	kmutex_t	tasklet_lock;
683 	void (*locked_tasklet_func)(struct drm_device *dev);
684 
685 	pid_t		  buf_pgid;
686 	drm_agp_head_t    *agp;
687 	drm_sg_mem_t	  *sg;  /* Scatter gather memory */
688 	uint32_t	  *ctx_bitmap;
689 	void		  *dev_private;
690 	unsigned int	  agp_buffer_token;
691 	drm_local_map_t   *agp_buffer_map;
692 
693 	kstat_t		  *asoft_ksp; /* kstat support */
694 
695 	/* name Drawable information */
696 	kmutex_t	drw_lock;
697 	unsigned int drw_bitfield_length;
698 	u32 *drw_bitfield;
699 	unsigned int drw_info_length;
700 	drm_drawable_info_t **drw_info;
701 	/*
702 	 * Saving S3 context
703 	 */
704 	void		  *s3_private;
705 };
706 
707 /* Memory management support (drm_memory.c) */
708 void	drm_mem_init(void);
709 void	drm_mem_uninit(void);
710 void	*drm_alloc(size_t, int);
711 void	*drm_calloc(size_t, size_t, int);
712 void	*drm_realloc(void *, size_t, size_t, int);
713 void	drm_free(void *, size_t, int);
714 int 	drm_ioremap(drm_device_t *, drm_local_map_t *);
715 void	drm_ioremapfree(drm_local_map_t *);
716 
717 void drm_core_ioremap(struct drm_local_map *, struct drm_device *);
718 void drm_core_ioremapfree(struct drm_local_map *, struct drm_device *);
719 
720 void drm_pci_free(drm_device_t *, drm_dma_handle_t *);
721 void *drm_pci_alloc(drm_device_t *, size_t, size_t, dma_addr_t, int);
722 
723 struct drm_local_map *drm_core_findmap(struct drm_device *, unsigned long);
724 
725 int	drm_context_switch(drm_device_t *, int, int);
726 int	drm_context_switch_complete(drm_device_t *, int);
727 int	drm_ctxbitmap_init(drm_device_t *);
728 void	drm_ctxbitmap_cleanup(drm_device_t *);
729 void	drm_ctxbitmap_free(drm_device_t *, int);
730 int	drm_ctxbitmap_next(drm_device_t *);
731 
732 /* Locking IOCTL support (drm_lock.c) */
733 int	drm_lock_take(drm_lock_data_t *, unsigned int);
734 int	drm_lock_transfer(drm_device_t *,
735 			drm_lock_data_t *, unsigned int);
736 int	drm_lock_free(drm_device_t *,
737 		    volatile unsigned int *, unsigned int);
738 
739 /* Buffer management support (drm_bufs.c) */
740 unsigned long drm_get_resource_start(drm_device_t *, unsigned int);
741 unsigned long drm_get_resource_len(drm_device_t *, unsigned int);
742 int	drm_initmap(drm_device_t *, unsigned long, unsigned long,
743     unsigned int, int, int);
744 void	drm_rmmap(drm_device_t *, drm_local_map_t *);
745 int	drm_addmap(drm_device_t *, unsigned long, unsigned long,
746     drm_map_type_t, drm_map_flags_t, drm_local_map_t **);
747 int	drm_order(unsigned long);
748 
749 /* DMA support (drm_dma.c) */
750 int	drm_dma_setup(drm_device_t *);
751 void	drm_dma_takedown(drm_device_t *);
752 void	drm_free_buffer(drm_device_t *, drm_buf_t *);
753 void	drm_reclaim_buffers(drm_device_t *, drm_file_t *);
754 #define	drm_core_reclaim_buffers	drm_reclaim_buffers
755 
756 /* IRQ support (drm_irq.c) */
757 int	drm_irq_install(drm_device_t *);
758 int	drm_irq_uninstall(drm_device_t *);
759 uint_t	drm_irq_handler(DRM_IRQ_ARGS);
760 void	drm_driver_irq_preinstall(drm_device_t *);
761 void	drm_driver_irq_postinstall(drm_device_t *);
762 void	drm_driver_irq_uninstall(drm_device_t *);
763 int	drm_vblank_wait(drm_device_t *, unsigned int *);
764 void	drm_vbl_send_signals(drm_device_t *);
765 void    drm_handle_vblank(struct drm_device *dev, int crtc);
766 u32	drm_vblank_count(struct drm_device *dev, int crtc);
767 int	drm_vblank_get(struct drm_device *dev, int crtc);
768 void	drm_vblank_put(struct drm_device *dev, int crtc);
769 int	drm_vblank_init(struct drm_device *dev, int num_crtcs);
770 void    drm_locked_tasklet(drm_device_t *, void(*func)(drm_device_t *));
771 void	drm_vblank_cleanup(struct drm_device *dev);
772 
773 /* AGP/GART support (drm_agpsupport.c) */
774 int	drm_device_is_agp(drm_device_t *);
775 int 	drm_device_is_pcie(drm_device_t *);
776 drm_agp_head_t *drm_agp_init(drm_device_t *);
777 void	drm_agp_fini(drm_device_t *);
778 int 	drm_agp_do_release(drm_device_t *);
779 void	*drm_agp_allocate_memory(size_t, uint32_t);
780 int	drm_agp_free_memory(void *);
781 int	drm_agp_bind_memory(unsigned int, uint32_t, drm_device_t *);
782 int	drm_agp_unbind_memory(unsigned long, drm_device_t *);
783 
784 /* kstat support (drm_kstats.c) */
785 int	drm_init_kstats(drm_device_t *);
786 void	drm_fini_kstats(drm_device_t *);
787 
788 /* Scatter Gather Support (drm_scatter.c) */
789 void	drm_sg_cleanup(drm_device_t *, drm_sg_mem_t *);
790 
791 /* ATI PCIGART support (ati_pcigart.c) */
792 int	drm_ati_pcigart_init(drm_device_t *, drm_ati_pcigart_info *);
793 int	drm_ati_pcigart_cleanup(drm_device_t *, drm_ati_pcigart_info *);
794 
795 /* Locking IOCTL support (drm_drv.c) */
796 int	drm_lock(DRM_IOCTL_ARGS);
797 int	drm_unlock(DRM_IOCTL_ARGS);
798 int	drm_version(DRM_IOCTL_ARGS);
799 int	drm_setversion(DRM_IOCTL_ARGS);
800 
801 /* Misc. IOCTL support (drm_ioctl.c) */
802 int	drm_irq_by_busid(DRM_IOCTL_ARGS);
803 int	drm_getunique(DRM_IOCTL_ARGS);
804 int	drm_setunique(DRM_IOCTL_ARGS);
805 int	drm_getmap(DRM_IOCTL_ARGS);
806 int	drm_getclient(DRM_IOCTL_ARGS);
807 int	drm_getstats(DRM_IOCTL_ARGS);
808 int	drm_noop(DRM_IOCTL_ARGS);
809 
810 /* Context IOCTL support (drm_context.c) */
811 int	drm_resctx(DRM_IOCTL_ARGS);
812 int	drm_addctx(DRM_IOCTL_ARGS);
813 int	drm_modctx(DRM_IOCTL_ARGS);
814 int	drm_getctx(DRM_IOCTL_ARGS);
815 int	drm_switchctx(DRM_IOCTL_ARGS);
816 int	drm_newctx(DRM_IOCTL_ARGS);
817 int	drm_rmctx(DRM_IOCTL_ARGS);
818 int	drm_setsareactx(DRM_IOCTL_ARGS);
819 int	drm_getsareactx(DRM_IOCTL_ARGS);
820 
821 /* Drawable IOCTL support (drm_drawable.c) */
822 int	drm_adddraw(DRM_IOCTL_ARGS);
823 int	drm_rmdraw(DRM_IOCTL_ARGS);
824 int	drm_update_draw(DRM_IOCTL_ARGS);
825 
826 /* Authentication IOCTL support (drm_auth.c) */
827 int	drm_getmagic(DRM_IOCTL_ARGS);
828 int	drm_authmagic(DRM_IOCTL_ARGS);
829 int	drm_remove_magic(drm_device_t *, drm_magic_t);
830 drm_file_t	*drm_find_file(drm_device_t *, drm_magic_t);
831 /* Buffer management support (drm_bufs.c) */
832 int	drm_addmap_ioctl(DRM_IOCTL_ARGS);
833 int	drm_rmmap_ioctl(DRM_IOCTL_ARGS);
834 int	drm_addbufs_ioctl(DRM_IOCTL_ARGS);
835 int	drm_infobufs(DRM_IOCTL_ARGS);
836 int	drm_markbufs(DRM_IOCTL_ARGS);
837 int	drm_freebufs(DRM_IOCTL_ARGS);
838 int	drm_mapbufs(DRM_IOCTL_ARGS);
839 
840 /* DMA support (drm_dma.c) */
841 int	drm_dma(DRM_IOCTL_ARGS);
842 
843 /* IRQ support (drm_irq.c) */
844 int	drm_control(DRM_IOCTL_ARGS);
845 int	drm_wait_vblank(DRM_IOCTL_ARGS);
846 
847 /* AGP/GART support (drm_agpsupport.c) */
848 int	drm_agp_acquire(DRM_IOCTL_ARGS);
849 int	drm_agp_release(DRM_IOCTL_ARGS);
850 int	drm_agp_enable(DRM_IOCTL_ARGS);
851 int	drm_agp_info(DRM_IOCTL_ARGS);
852 int	drm_agp_alloc(DRM_IOCTL_ARGS);
853 int	drm_agp_free(DRM_IOCTL_ARGS);
854 int	drm_agp_unbind(DRM_IOCTL_ARGS);
855 int	drm_agp_bind(DRM_IOCTL_ARGS);
856 
857 /* Scatter Gather Support (drm_scatter.c) */
858 int	drm_sg_alloc(DRM_IOCTL_ARGS);
859 int	drm_sg_free(DRM_IOCTL_ARGS);
860 
861 extern int drm_debug_flag;
862 
863 
864 /* We add function to support DRM_DEBUG,DRM_ERROR,DRM_INFO */
865 extern void drm_debug(const char *fmt, ...);
866 extern void drm_error(const char *fmt, ...);
867 extern void drm_info(const char *fmt, ...);
868 
869 #ifdef DEBUG
870 #define	DRM_DEBUG		if (drm_debug_flag >= 2) drm_debug
871 #define	DRM_INFO		if (drm_debug_flag >= 1) drm_info
872 #else
873 #define	DRM_DEBUG(...)
874 #define	DRM_INFO(...)
875 #endif
876 
877 #define	DRM_ERROR		drm_error
878 
879 
880 #define	MAX_INSTNUMS 16
881 
882 extern int drm_dev_to_instance(dev_t);
883 extern int drm_dev_to_minor(dev_t);
884 extern void *drm_supp_register(dev_info_t *, drm_device_t *);
885 extern int drm_supp_unregister(void *);
886 
887 extern int drm_open(drm_device_t *, drm_cminor_t *, int, int, cred_t *);
888 extern int drm_close(drm_device_t *, int, int, int, cred_t *);
889 extern int drm_attach(drm_device_t *);
890 extern int drm_detach(drm_device_t *);
891 extern int drm_probe(drm_device_t *, drm_pci_id_list_t *);
892 
893 extern int drm_pci_init(drm_device_t *);
894 extern void drm_pci_end(drm_device_t *);
895 extern int pci_get_info(drm_device_t *, int *, int *, int *);
896 extern int pci_get_irq(drm_device_t *);
897 extern int pci_get_vendor(drm_device_t *);
898 extern int pci_get_device(drm_device_t *);
899 
900 extern struct drm_drawable_info *drm_get_drawable_info(drm_device_t *,
901 							drm_drawable_t);
902 /* File Operations helpers (drm_fops.c) */
903 extern drm_file_t *drm_find_file_by_proc(drm_device_t *, cred_t *);
904 extern drm_cminor_t *drm_find_file_by_minor(drm_device_t *, int);
905 extern int drm_open_helper(drm_device_t *, drm_cminor_t *, int, int,
906     cred_t *);
907 
908 #endif	/* _DRMP_H */
909