drmP.h revision de710d24d2fae4468e64da999e1d952a247f142c
/*
* drmP.h -- Private 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.
* Copyright (c) 2009, Intel Corporation.
* 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,
* 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
* 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>
* Gareth Hughes <gareth@valinux.com>
*
*/
/*
* Copyright 2010 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _DRMP_H
#define _DRMP_H
#include <sys/sysmacros.h>
#include "drm_atomic.h"
#include "drm.h"
#include "queue.h"
#include "drm_linux_list.h"
#ifndef __inline__
#define __inline__ inline
#endif
#if !defined(__FUNCTION__)
#if defined(C99)
#define __FUNCTION__ __func__
#else
#define __FUNCTION__ " "
#endif
#endif
/* DRM space units */
#define DRM_PAGE_SHIFT PAGESHIFT
#define DRM_MB2PAGES(x) ((x) << 8)
#define DRM_PAGES2BYTES(x) ((x) << DRM_PAGE_SHIFT)
#define DRM_BYTES2PAGES(x) ((x) >> DRM_PAGE_SHIFT)
#define DRM_PAGES2KB(x) ((x) << 2)
#define PAGE_SHIFT DRM_PAGE_SHIFT
#define PAGE_SIZE DRM_PAGE_SIZE
#define DRM_MAX_INSTANCES 8
#define DRM_DEVNODE "drm"
#define DRM_UNOPENED 0
#define DRM_OPENED 1
#define DRM_KERNEL_CONTEXT 0 /* Change drm_resctx if changed */
#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_BUFS 6
#define DRM_MEM_SEGS 7
#define DRM_MEM_PAGES 8
#define DRM_MEM_FILES 9
#define DRM_MEM_QUEUES 10
#define DRM_MEM_CMDS 11
#define DRM_MEM_MAPPINGS 12
#define DRM_MEM_BUFLISTS 13
#define DRM_MEM_DRMLISTS 14
#define DRM_MEM_TOTALDRM 15
#define DRM_MEM_BOUNDDRM 16
#define DRM_MEM_CTXBITMAP 17
#define DRM_MEM_STUB 18
#define DRM_MEM_SGLISTS 19
#define DRM_MEM_AGPLISTS 20
#define DRM_MEM_CTXLIST 21
#define DRM_MEM_MM 22
#define DRM_MEM_HASHTAB 23
#define DRM_MEM_OBJECTS 24
#define DRM_MAP_HASH_OFFSET 0x10000000
#define DRM_MAP_HASH_ORDER 12
#define DRM_OBJECT_HASH_ORDER 12
#define DRM_MM_INIT_MAX_PAGES 256
/* Internal types and structures */
#define DRM_ARRAY_SIZE(x) (sizeof (x) / sizeof (x[0]))
#define DRM_MIN(a, b) ((a) < (b) ? (a) : (b))
#define DRM_MAX(a, b) ((a) > (b) ? (a) : (b))
#define __OS_HAS_AGP 1
#define DRM_DEV_UID 0
#define DRM_DEV_GID 0
#define DRM_CURRENTPID ddi_get_pid()
#define DRM_SPINLOCK(l) mutex_enter(l)
#define DRM_SPINUNLOCK(u) mutex_exit(u)
#define DRM_SPINLOCK_ASSERT(l)
#define spin_lock(l) mutex_enter(l)
#define spin_unlock(u) mutex_exit(u)
#define DRM_MEMORYBARRIER()
typedef struct drm_file drm_file_t;
typedef struct drm_device drm_device_t;
typedef struct drm_driver_info drm_driver_t;
#define DRM_IOCTL_ARGS \
return (EFAULT); \
}
return (EFAULT); \
}
typedef struct drm_wait_queue {
#define DRM_INIT_WAITQUEUE(q, pri) \
{ \
}
#define DRM_FINI_WAITQUEUE(q) \
{ \
mutex_destroy(&(q)->lock); \
cv_destroy(&(q)->cv); \
}
#define DRM_WAKEUP(q) \
{ \
mutex_enter(&(q)->lock); \
cv_broadcast(&(q)->cv); \
mutex_exit(&(q)->lock); \
}
#define jiffies ddi_get_lbolt()
mutex_enter(&(q)->lock); \
while (!(condition)) { \
TR_CLOCK_TICK); \
if (ret == -1) { \
break; \
} else if (ret == 0) { \
break; \
} else { \
ret = 0; \
} \
} \
mutex_exit(&(q)->lock);
mutex_enter(&(q)->lock); \
if (!(condition)) { \
if (ret == -1) { \
/* gfx maybe hang */ \
if (!(condition)) \
ret = -2; \
} else { \
ret = 0; \
} \
} \
mutex_exit(&(q)->lock);
#define DRM_GETSAREA() \
{ \
drm_local_map_t *map; \
break; \
} \
} \
}
return (EINVAL); \
}
#define IRQ_HANDLED DDI_INTR_CLAIMED
#define IRQ_NONE DDI_INTR_UNCLAIMED
enum {
};
#ifndef PCIY_AGP
#define PCIY_AGP 0x02
#endif
#ifndef PCIY_EXPRESS
#define PCIY_EXPRESS 0x10
#endif
#define DRM_GEM_OBJIDR_HASHNODE 1024
/*
* wait for 400 milliseconds
*/
typedef unsigned long dma_addr_t;
typedef uint_t irqreturn_t;
#define DRM_SUPPORT 1
#define DRM_UNSUPPORT 0
#define __OS_HAS_AGP 1
typedef struct drm_pci_id_list
{
int vendor;
int device;
long driver_private;
char *name;
#define DRM_AUTH 0x1
#define DRM_MASTER 0x2
#define DRM_ROOT_ONLY 0x4
typedef int drm_ioctl_t(DRM_IOCTL_ARGS);
typedef struct drm_ioctl_desc {
int (*func)(DRM_IOCTL_ARGS);
int flags;
typedef struct drm_magic_entry {
struct drm_magic_entry *next;
typedef struct drm_magic_head {
struct drm_magic_entry *head;
struct drm_magic_entry *tail;
typedef struct drm_buf {
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 */
volatile int pending; /* On hardware DMA queue */
/* Uniq. identifier of holding process */
int context; /* Kernel queue for this buffer */
enum {
DRM_LIST_NONE = 0,
DRM_LIST_FREE = 1,
DRM_LIST_WAIT = 2,
DRM_LIST_PEND = 3,
DRM_LIST_PRIO = 4,
DRM_LIST_RECLAIM = 5
} list; /* Which list we're on */
int dev_priv_size; /* Size of buffer private stoarge */
void *dev_private; /* Per-buffer private storage */
} drm_buf_t;
typedef struct drm_freelist {
int initialized; /* Freelist in use */
int low_mark; /* Low water mark */
int high_mark; /* High water mark */
typedef struct drm_buf_entry {
int buf_size;
int buf_count;
int seg_count;
int page_order;
unsigned long *seglist_bus;
/* BEGIN CSTYLED */
typedef struct drm_local_map {
unsigned long offset; /* Physical address (0 for SAREA) */
unsigned long size; /* Physical size (bytes) */
void *handle; /* User-space: "Handle" to pass to mmap */
/* Kernel-space: kernel-virtual address */
int mtrr; /* Boolean: MTRR used */
/* Private data */
int rid; /* PCI resource ID for bus_space */
int kernel_owned; /* Boolean: 1= initmapped, 0= addmapped */
/* END CSTYLED */
/*
* 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 */
/* Handle count of this object. Each handle also holds a reference */
/* Related drm device */
struct drm_device *dev;
int flink;
/*
* Size of the object, in bytes. Immutable over the object's
* lifetime.
*/
/*
* 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;
/*
* 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
*/
/*
* While validating an exec operation, the
* They will be transferred to the above values
* at the point that any cache flushing occurs
*/
void *driver_private;
};
struct idr_list {
struct drm_gem_object *obj;
};
struct drm_file {
int authenticated;
int master;
int minor;
int refs;
unsigned long ioctl_count;
void *driver_priv;
/* Mapping of mm object handles to object pointers. */
struct idr_list object_idr;
/* Lock for synchronization of access to object_idr. */
};
typedef struct drm_lock_data {
/* Uniq. identifier of holding process */
unsigned long lock_time; /* Time of last lock in clock ticks */
/*
* This structure, in drm_device_t, is always initialized while the device
* is open. dev->dma_lock protects the incrementing of dev->buf_use, which
* when set marks that no further bufs may be allocated until device teardown
* watermarks of bufs are only touched by the X Server, and thus not
* concurrently accessed, so no locking is needed.
*/
typedef struct drm_device_dma {
int buf_count;
int seg_count;
int page_count;
unsigned long *pagelist;
unsigned long byte_count;
enum {
_DRM_DMA_USE_AGP = 0x01,
_DRM_DMA_USE_SG = 0x02
} flags;
typedef struct drm_agp_mem {
void *handle;
unsigned long bound; /* address */
int pages;
struct drm_agp_mem *prev;
struct drm_agp_mem *next;
typedef struct drm_agp_head {
const char *chipset;
unsigned long mode;
int enabled;
int acquired;
unsigned long base;
int mtrr;
int cant_use_aperture;
unsigned long page_mask;
typedef struct drm_dma_handle {
typedef struct drm_sg_mem {
unsigned long handle;
void *virtual;
int pages;
} drm_sg_mem_t;
/*
* Generic memory manager structs
*/
struct drm_mm_node {
int free;
unsigned long start;
unsigned long size;
void *private;
};
struct drm_mm {
};
typedef struct drm_vbl_sig {
unsigned int sequence;
int signo;
int pid;
/* used for clone device */
typedef struct drm_cminor {
int minor;
} drm_cminor_t;
/* location of GART table */
#define DRM_ATI_GART_MAIN 1
#define DRM_ATI_GART_FB 2
typedef struct ati_pcigart_info {
int gart_table_location;
int is_pcie;
void *addr;
/* DRM device structure */
struct drm_device;
struct drm_driver_info {
int (*load)(struct drm_device *, unsigned long);
int (*firstopen)(struct drm_device *);
void (*lastclose)(struct drm_device *);
int (*unload)(struct drm_device *);
int (*presetup)(struct drm_device *);
int (*postsetup)(struct drm_device *);
void (*release)(struct drm_device *, void *);
int (*dma_ioctl)(DRM_IOCTL_ARGS);
void (*dma_ready)(struct drm_device *);
int (*dma_quiescent)(struct drm_device *);
int (*dma_flush_block_and_flush)(struct drm_device *,
int, drm_lock_flags_t);
int (*dma_flush_unblock)(struct drm_device *, int,
int (*context_ctor)(struct drm_device *, int);
int (*context_dtor)(struct drm_device *, int);
int (*kernel_context_switch)(struct drm_device *, int, int);
int (*kernel_context_switch_unlock)(struct drm_device *);
int (*device_is_agp) (struct drm_device *);
int (*irq_preinstall)(struct drm_device *);
void (*irq_postinstall)(struct drm_device *);
int (*vblank_wait)(struct drm_device *, unsigned int *);
int (*vblank_wait2)(struct drm_device *, unsigned int *);
/* added for intel minimized vblank */
/*
* Driver-specific constructor for drm_gem_objects, to set up
* obj->driver_private.
*
* Returns 0 on success.
*/
int max_driver_ioctl;
int buf_priv_size;
int driver_major;
int driver_minor;
int driver_patchlevel;
const char *driver_name; /* Simple driver name */
const char *driver_desc; /* Longer driver name */
const char *driver_date; /* Date of last major changes. */
unsigned use_agp :1;
unsigned require_agp :1;
unsigned use_sg :1;
unsigned use_dma :1;
unsigned use_pci_dma :1;
unsigned use_dma_queue :1;
unsigned use_irq :1;
unsigned use_vbl_irq :1;
unsigned use_vbl_irq2 :1;
unsigned use_mtrr :1;
unsigned use_gem;
};
/*
* hardware-specific code needs to initialize mutexes which
* can be used in interrupt context, so they need to know
* the interrupt priority. Interrupt cookie in drm_device
* structure is the intr_block field.
*/
#define DRM_INTR_PRI(dev) \
struct drm_device {
void *drm_handle;
int drm_supported;
const char *desc; /* current driver description */
char *unique; /* Unique identifier: e.g., busid */
int unique_len; /* Length of unique field */
int if_version; /* Highest interface version set */
int flags; /* Flags to open(2) */
/* Locks */
/* Usage Counters */
int open_count; /* Outstanding files open */
int buf_use; /* Buffers in use -- cannot alloc */
/* Performance counters */
unsigned long counters;
/* Authentication */
/* Linked list of mappable regions. Protected by dev_lock */
int max_context;
/* DMA queues (contexts) */
/* Context support */
int irq; /* Interrupt used by board */
int irq_enabled; /* True if the irq handler is enabled */
int pci_domain;
int pci_bus;
int pci_slot;
int pci_func;
int last_context; /* Last current context */
/* Only used for Radeon */
/*
* 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.
*/
/* vbl wait channel array */
/* number of VBLANK interrupts */
/* (driver must alloc the right number of counters) */
/* signal list to send on VBLANK */
struct drm_vbl_sig_list *vbl_sigs;
/* number of signals pending on all crtcs */
/* number of users of vblank interrupts per crtc */
/* protected by dev->vbl_lock, used for wraparound handling */
/* so we don't call enable more than */
/* Display driver is setting mode */
int *vblank_inmodeset;
/* Don't wait while crtc is likely disabled */
int *vblank_suspend;
/* size of vblank counter register */
int num_crtcs;
void *dev_private;
unsigned int agp_buffer_token;
/* name Drawable information */
unsigned int drw_bitfield_length;
unsigned int drw_info_length;
/* \name GEM information */
/* @{ */
struct idr_list object_name_idr;
/* @} */
/*
* Saving S3 context
*/
void *s3_private;
};
/* Memory management support (drm_memory.c) */
void drm_mem_init(void);
void drm_mem_uninit(void);
void drm_ioremapfree(drm_local_map_t *);
int drm_context_switch(drm_device_t *, int, int);
int drm_context_switch_complete(drm_device_t *, int);
int drm_ctxbitmap_init(drm_device_t *);
void drm_ctxbitmap_cleanup(drm_device_t *);
void drm_ctxbitmap_free(drm_device_t *, int);
int drm_ctxbitmap_next(drm_device_t *);
/* Locking IOCTL support (drm_lock.c) */
int drm_lock_take(drm_lock_data_t *, unsigned int);
int drm_lock_transfer(drm_device_t *,
drm_lock_data_t *, unsigned int);
int drm_lock_free(drm_device_t *,
volatile unsigned int *, unsigned int);
/* Buffer management support (drm_bufs.c) */
unsigned long drm_get_resource_start(drm_device_t *, unsigned int);
unsigned long drm_get_resource_len(drm_device_t *, unsigned int);
int drm_initmap(drm_device_t *, unsigned long, unsigned long,
unsigned int, int, int);
int drm_addmap(drm_device_t *, unsigned long, unsigned long,
int drm_order(unsigned long);
/* DMA support (drm_dma.c) */
int drm_dma_setup(drm_device_t *);
void drm_dma_takedown(drm_device_t *);
/* IRQ support (drm_irq.c) */
int drm_irq_install(drm_device_t *);
int drm_irq_uninstall(drm_device_t *);
void drm_driver_irq_preinstall(drm_device_t *);
void drm_driver_irq_postinstall(drm_device_t *);
void drm_driver_irq_uninstall(drm_device_t *);
int drm_vblank_wait(drm_device_t *, unsigned int *);
void drm_vbl_send_signals(drm_device_t *);
/* AGP/GART support (drm_agpsupport.c) */
int drm_device_is_agp(drm_device_t *);
int drm_device_is_pcie(drm_device_t *);
void drm_agp_fini(drm_device_t *);
int drm_agp_do_release(drm_device_t *);
int drm_agp_unbind_memory(unsigned long, drm_device_t *);
unsigned long num_pages,
unsigned long num_pages,
/* kstat support (drm_kstats.c) */
int drm_init_kstats(drm_device_t *);
void drm_fini_kstats(drm_device_t *);
/* Scatter Gather Support (drm_scatter.c) */
/* ATI PCIGART support (ati_pcigart.c) */
/* Locking IOCTL support (drm_drv.c) */
int drm_lock(DRM_IOCTL_ARGS);
int drm_unlock(DRM_IOCTL_ARGS);
int drm_version(DRM_IOCTL_ARGS);
int drm_setversion(DRM_IOCTL_ARGS);
/* Cache management (drm_cache.c) */
/* Misc. IOCTL support (drm_ioctl.c) */
int drm_getunique(DRM_IOCTL_ARGS);
int drm_setunique(DRM_IOCTL_ARGS);
int drm_getmap(DRM_IOCTL_ARGS);
int drm_getclient(DRM_IOCTL_ARGS);
int drm_getstats(DRM_IOCTL_ARGS);
int drm_noop(DRM_IOCTL_ARGS);
/* Context IOCTL support (drm_context.c) */
int drm_resctx(DRM_IOCTL_ARGS);
int drm_addctx(DRM_IOCTL_ARGS);
int drm_modctx(DRM_IOCTL_ARGS);
int drm_getctx(DRM_IOCTL_ARGS);
int drm_switchctx(DRM_IOCTL_ARGS);
int drm_newctx(DRM_IOCTL_ARGS);
int drm_rmctx(DRM_IOCTL_ARGS);
/* Drawable IOCTL support (drm_drawable.c) */
int drm_adddraw(DRM_IOCTL_ARGS);
int drm_rmdraw(DRM_IOCTL_ARGS);
/* Authentication IOCTL support (drm_auth.c) */
int drm_getmagic(DRM_IOCTL_ARGS);
int drm_authmagic(DRM_IOCTL_ARGS);
/* Buffer management support (drm_bufs.c) */
int drm_infobufs(DRM_IOCTL_ARGS);
int drm_markbufs(DRM_IOCTL_ARGS);
int drm_freebufs(DRM_IOCTL_ARGS);
int drm_mapbufs(DRM_IOCTL_ARGS);
/* DMA support (drm_dma.c) */
int drm_dma(DRM_IOCTL_ARGS);
/* IRQ support (drm_irq.c) */
int drm_control(DRM_IOCTL_ARGS);
/* AGP/GART support (drm_agpsupport.c) */
int drm_agp_enable(DRM_IOCTL_ARGS);
int drm_agp_info(DRM_IOCTL_ARGS);
int drm_agp_alloc(DRM_IOCTL_ARGS);
int drm_agp_free(DRM_IOCTL_ARGS);
int drm_agp_unbind(DRM_IOCTL_ARGS);
int drm_agp_bind(DRM_IOCTL_ARGS);
/* Scatter Gather Support (drm_scatter.c) */
int drm_sg_alloc(DRM_IOCTL_ARGS);
int drm_sg_free(DRM_IOCTL_ARGS);
/* drm_mm.c */
unsigned long size,
unsigned alignment, int best_match);
extern int drm_debug_flag;
/* We add function to support DRM_DEBUG,DRM_ERROR,DRM_INFO */
#ifdef DEBUG
#else
#define DRM_DEBUG(...)
#define DRM_INFO(...)
#endif
#define MAX_INSTNUMS 16
extern int drm_dev_to_instance(dev_t);
extern int drm_dev_to_minor(dev_t);
extern int drm_supp_unregister(void *);
extern int drm_attach(drm_device_t *);
extern int drm_detach(drm_device_t *);
extern int drm_pci_init(drm_device_t *);
extern void drm_pci_end(drm_device_t *);
extern int pci_get_info(drm_device_t *, int *, int *, int *);
extern int pci_get_irq(drm_device_t *);
extern int pci_get_vendor(drm_device_t *);
extern int pci_get_device(drm_device_t *);
/* File Operations helpers (drm_fops.c) */
cred_t *);
/* Graphics Execution Manager library functions (drm_gem.c) */
struct drm_gem_object *obj,
int *handlep);
int handle);
#endif /* _DRMP_H */