/* drm.h -- Header for Direct Rendering Manager -*- linux-c -*- * Created: Mon Jan  4 10:05:05 1999 by faith@precisioninsight.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 * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. * * Authors: *    Rickard E. (Rik) Faith <faith@valinux.com> * * Acknowledgements: * Dec 1999, Richard Henderson <rth@twiddle.net>, move to generic cmpxchg. * */#ifndef _DRM_H_#define _DRM_H_#include <linux/config.h>#if defined(__linux__)#include <asm/ioctl.h>		/* For _IO* macros */#define DRM_IOCTL_NR(n)	     _IOC_NR(n)#elif defined(__FreeBSD__)#include <sys/ioccom.h>#define DRM_IOCTL_NR(n)	     ((n) & 0xff)#endif#define DRM_PROC_DEVICES "/proc/devices"#define DRM_PROC_MISC	 "/proc/misc"#define DRM_PROC_DRM	 "/proc/drm"#define DRM_DEV_DRM	 "/dev/drm"#define DRM_DEV_MODE	 (S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP)#define DRM_DEV_UID	 0#define DRM_DEV_GID	 0#define DRM_NAME	"drm"	  /* Name in kernel, /dev, and /proc	    */#define DRM_MIN_ORDER	5	  /* At least 2^5 bytes = 32 bytes	    */#define DRM_MAX_ORDER	22	  /* Up to 2^22 bytes = 4MB		    */#define DRM_RAM_PERCENT 10	  /* How much system ram can we lock?	    */#define _DRM_LOCK_HELD	0x80000000 /* Hardware lock is held		    */#define _DRM_LOCK_CONT	0x40000000 /* Hardware lock is contended	    */#define _DRM_LOCK_IS_HELD(lock)	   ((lock) & _DRM_LOCK_HELD)#define _DRM_LOCK_IS_CONT(lock)	   ((lock) & _DRM_LOCK_CONT)#define _DRM_LOCKING_CONTEXT(lock) ((lock) & ~(_DRM_LOCK_HELD|_DRM_LOCK_CONT))typedef unsigned long drm_handle_t;typedef unsigned int  drm_context_t;typedef unsigned int  drm_drawable_t;typedef unsigned int  drm_magic_t;/* Warning: If you change this structure, make sure you change * XF86DRIClipRectRec in the server as well */typedef struct drm_clip_rect {           unsigned short x1;           unsigned short y1;           unsigned short x2;           unsigned short y2;} drm_clip_rect_t;/* Seperate include files for the i810/mga/r128 specific structures */#include "mga_drm.h"#include "i810_drm.h"#include "r128_drm.h"#include "radeon_drm.h"#ifdef CONFIG_DRM40_SIS#include "sis_drm.h"#endiftypedef struct drm_version {	int    version_major;	  /* Major version			    */	int    version_minor;	  /* Minor version			    */	int    version_patchlevel;/* Patch level			    */	size_t name_len;	  /* Length of name buffer		    */	char   *name;		  /* Name of driver			    */	size_t date_len;	  /* Length of date buffer		    */	char   *date;		  /* User-space buffer to hold date	    */	size_t desc_len;	  /* Length of desc buffer		    */	char   *desc;		  /* User-space buffer to hold desc	    */} drm_version_t;typedef struct drm_unique {	size_t unique_len;	  /* Length of unique			    */	char   *unique;		  /* Unique name for driver instantiation   */} drm_unique_t;typedef struct drm_list {	int		 count;	  /* Length of user-space structures	    */	drm_version_t	 *version;} drm_list_t;typedef struct drm_block {	int		 unused;} drm_block_t;typedef struct drm_control {	enum {		DRM_ADD_COMMAND,		DRM_RM_COMMAND,		DRM_INST_HANDLER,		DRM_UNINST_HANDLER	}		 func;	int		 irq;} drm_control_t;typedef enum drm_map_type {	_DRM_FRAME_BUFFER = 0,	  /* WC (no caching), no core dump	    */	_DRM_REGISTERS	  = 1,	  /* no caching, no core dump		    */	_DRM_SHM	  = 2,	  /* shared, cached			    */	_DRM_AGP          = 3	  /* AGP/GART                               */} drm_map_type_t;typedef enum drm_map_flags {	_DRM_RESTRICTED	     = 0x01, /* Cannot be mapped to user-virtual    */	_DRM_READ_ONLY	     = 0x02,	_DRM_LOCKED	     = 0x04, /* shared, cached, locked		    */	_DRM_KERNEL	     = 0x08, /* kernel requires access		    */	_DRM_WRITE_COMBINING = 0x10, /* use write-combining if available    */	_DRM_CONTAINS_LOCK   = 0x20  /* SHM page that contains lock	    */} drm_map_flags_t;typedef struct drm_map {	unsigned long	offset;	 /* Requested physical address (0 for SAREA)*/	unsigned long	size;	 /* Requested physical size (bytes)	    */	drm_map_type_t	type;	 /* Type of memory to map		    */	drm_map_flags_t flags;	 /* Flags				    */	void		*handle; /* User-space: "Handle" to pass to mmap    */				 /* Kernel-space: kernel-virtual address    */	int		mtrr;	 /* MTRR slot used			    */				 /* Private data			    */} drm_map_t;typedef enum drm_lock_flags {	_DRM_LOCK_READY	     = 0x01, /* Wait until hardware is ready for DMA */	_DRM_LOCK_QUIESCENT  = 0x02, /* Wait until hardware quiescent	     */	_DRM_LOCK_FLUSH	     = 0x04, /* Flush this context's DMA queue first */	_DRM_LOCK_FLUSH_ALL  = 0x08, /* Flush all DMA queues first	     */				/* These *HALT* flags aren't supported yet				   -- they will be used to support the				   full-screen DGA-like mode. */	_DRM_HALT_ALL_QUEUES = 0x10, /* Halt all current and future queues   */	_DRM_HALT_CUR_QUEUES = 0x20  /* Halt all current queues		     */} drm_lock_flags_t;typedef struct drm_lock {	int		 context;	drm_lock_flags_t flags;} drm_lock_t;typedef enum drm_dma_flags {	      /* These values *MUST* match xf86drm.h */				      /* Flags for DMA buffer dispatch	     */	_DRM_DMA_BLOCK	      = 0x01, /* Block until buffer dispatched.					 Note, the buffer may not yet have					 been processed by the hardware --					 getting a hardware lock with the					 hardware quiescent will ensure					 that the buffer has been					 processed.			     */	_DRM_DMA_WHILE_LOCKED = 0x02, /* Dispatch while lock held	     */	_DRM_DMA_PRIORITY     = 0x04, /* High priority dispatch		     */				      /* Flags for DMA buffer request	     */	_DRM_DMA_WAIT	      = 0x10, /* Wait for free buffers		     */	_DRM_DMA_SMALLER_OK   = 0x20, /* Smaller-than-requested buffers ok   */	_DRM_DMA_LARGER_OK    = 0x40  /* Larger-than-requested buffers ok    */} drm_dma_flags_t;typedef struct drm_buf_desc {	int	      count;	 /* Number of buffers of this size	     */	int	      size;	 /* Size in bytes			     */	int	      low_mark;	 /* Low water mark			     */	int	      high_mark; /* High water mark			     */	enum {		_DRM_PAGE_ALIGN = 0x01, /* Align on page boundaries for DMA  */		_DRM_AGP_BUFFER = 0x02  /* Buffer is in agp space            */	}	      flags;	unsigned long agp_start; /* Start address of where the agp buffers				  * are in the agp aperture */} drm_buf_desc_t;typedef struct drm_buf_info {	int	       count;	/* Entries in list			     */	drm_buf_desc_t *list;} drm_buf_info_t;typedef struct drm_buf_free {	int	       count;