3 * OS-independent header for DRM user-level library interface.
5 * \author Rickard E. (Rik) Faith <faith@valinux.com>
9 * Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
10 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
11 * All Rights Reserved.
13 * Permission is hereby granted, free of charge, to any person obtaining a
14 * copy of this software and associated documentation files (the "Software"),
15 * to deal in the Software without restriction, including without limitation
16 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
17 * and/or sell copies of the Software, and to permit persons to whom the
18 * Software is furnished to do so, subject to the following conditions:
20 * The above copyright notice and this permission notice (including the next
21 * paragraph) shall be included in all copies or substantial portions of the
24 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
25 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
27 * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
28 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
29 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
30 * DEALINGS IN THE SOFTWARE.
34 /* $XFree86: xc/programs/Xserver/hw/xfree86/os-support/xf86drm.h,v 1.26 2003/08/16 19:26:37 dawes Exp $ */
41 /* Defaults, if nothing set in xf86config */
44 /* Default /dev/dri directory permissions 0755 */
45 #define DRM_DEV_DIRMODE \
46 (S_IRUSR|S_IWUSR|S_IXUSR|S_IRGRP|S_IXGRP|S_IROTH|S_IXOTH)
47 #define DRM_DEV_MODE (S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP)
49 #define DRM_DIR_NAME "/dev/dri"
50 #define DRM_DEV_NAME "%s/card%d"
51 #define DRM_PROC_NAME "/proc/dri/" /* For backward Linux compatibility */
53 #define DRM_ERR_NO_DEVICE (-1001)
54 #define DRM_ERR_NO_ACCESS (-1002)
55 #define DRM_ERR_NOT_ROOT (-1003)
56 #define DRM_ERR_INVALID (-1004)
57 #define DRM_ERR_NO_FD (-1005)
59 #define DRM_AGP_NO_HANDLE 0
61 typedef unsigned int drmSize, *drmSizePtr; /**< For mapped regions */
62 typedef void *drmAddress, **drmAddressPtr; /**< For mapped regions */
65 * Driver version information.
67 * \sa drmGetVersion() and drmSetVersion().
69 typedef struct _drmVersion {
70 int version_major; /**< Major version */
71 int version_minor; /**< Minor version */
72 int version_patchlevel; /**< Patch level */
73 int name_len; /**< Length of name buffer */
74 char *name; /**< Name of driver */
75 int date_len; /**< Length of date buffer */
76 char *date; /**< User-space buffer to hold date */
77 int desc_len; /**< Length of desc buffer */
78 char *desc; /**< User-space buffer to hold desc */
79 } drmVersion, *drmVersionPtr;
81 typedef struct _drmStats {
82 unsigned long count; /**< Number of data */
84 unsigned long value; /**< Value from kernel */
85 const char *long_format; /**< Suggested format for long_name */
86 const char *long_name; /**< Long name for value */
87 const char *rate_format; /**< Suggested format for rate_name */
88 const char *rate_name; /**< Short name for value per second */
89 int isvalue; /**< True if value (vs. counter) */
90 const char *mult_names; /**< Multiplier names (e.g., "KGM") */
91 int mult; /**< Multiplier value (e.g., 1024) */
92 int verbose; /**< Suggest only in verbose output */
97 /* All of these enums *MUST* match with the
98 kernel implementation -- so do *NOT*
99 change them! (The drmlib implementation
100 will just copy the flags instead of
101 translating them.) */
103 DRM_FRAME_BUFFER = 0, /**< WC, no caching, no core dump */
104 DRM_REGISTERS = 1, /**< no caching, no core dump */
105 DRM_SHM = 2, /**< shared, cached */
106 DRM_AGP = 3, /**< AGP/GART */
107 DRM_SCATTER_GATHER = 4, /**< PCI scatter/gather */
108 DRM_CONSISTENT = 5 /**< PCI consistent */
112 DRM_RESTRICTED = 0x0001, /**< Cannot be mapped to client-virtual */
113 DRM_READ_ONLY = 0x0002, /**< Read-only in client-virtual */
114 DRM_LOCKED = 0x0004, /**< Physical pages locked */
115 DRM_KERNEL = 0x0008, /**< Kernel requires access */
116 DRM_WRITE_COMBINING = 0x0010, /**< Use write-combining, if available */
117 DRM_CONTAINS_LOCK = 0x0020, /**< SHM page that contains lock */
118 DRM_REMOVABLE = 0x0040 /**< Removable mapping */
122 * \warning These values *MUST* match drm.h
125 /** \name Flags for DMA buffer dispatch */
127 DRM_DMA_BLOCK = 0x01, /**<
128 * Block until buffer dispatched.
130 * \note the buffer may not yet have been
131 * processed by the hardware -- getting a
132 * hardware lock with the hardware quiescent
133 * will ensure that the buffer has been
136 DRM_DMA_WHILE_LOCKED = 0x02, /**< Dispatch while lock held */
137 DRM_DMA_PRIORITY = 0x04, /**< High priority dispatch */
140 /** \name Flags for DMA buffer request */
142 DRM_DMA_WAIT = 0x10, /**< Wait for free buffers */
143 DRM_DMA_SMALLER_OK = 0x20, /**< Smaller-than-requested buffers OK */
144 DRM_DMA_LARGER_OK = 0x40 /**< Larger-than-requested buffers OK */
149 DRM_PAGE_ALIGN = 0x01,
150 DRM_AGP_BUFFER = 0x02,
151 DRM_SG_BUFFER = 0x04,
156 DRM_LOCK_READY = 0x01, /**< Wait until hardware is ready for DMA */
157 DRM_LOCK_QUIESCENT = 0x02, /**< Wait until hardware quiescent */
158 DRM_LOCK_FLUSH = 0x04, /**< Flush this context's DMA queue first */
159 DRM_LOCK_FLUSH_ALL = 0x08, /**< Flush all DMA queues first */
160 /* These *HALT* flags aren't supported yet
161 -- they will be used to support the
162 full-screen DGA-like mode. */
163 DRM_HALT_ALL_QUEUES = 0x10, /**< Halt all current and future queues */
164 DRM_HALT_CUR_QUEUES = 0x20 /**< Halt all current queues */
168 DRM_CONTEXT_PRESERVED = 0x01, /**< This context is preserved and
170 DRM_CONTEXT_2DONLY = 0x02 /**< This context is for 2D rendering only. */
171 } drm_context_tFlags, *drm_context_tFlagsPtr;
173 typedef struct _drmBufDesc {
174 int count; /**< Number of buffers of this size */
175 int size; /**< Size in bytes */
176 int low_mark; /**< Low water mark */
177 int high_mark; /**< High water mark */
178 } drmBufDesc, *drmBufDescPtr;
180 typedef struct _drmBufInfo {
181 int count; /**< Number of buffers described in list */
182 drmBufDescPtr list; /**< List of buffer descriptions */
183 } drmBufInfo, *drmBufInfoPtr;
185 typedef struct _drmBuf {
186 int idx; /**< Index into the master buffer list */
187 int total; /**< Buffer size */
188 int used; /**< Amount of buffer in use (for DMA) */
189 drmAddress address; /**< Address */
190 } drmBuf, *drmBufPtr;
193 * Buffer mapping information.
195 * Used by drmMapBufs() and drmUnmapBufs() to store information about the
198 typedef struct _drmBufMap {
199 int count; /**< Number of buffers mapped */
200 drmBufPtr list; /**< Buffers */
201 } drmBufMap, *drmBufMapPtr;
203 typedef struct _drmLock {
204 volatile unsigned int lock;
206 /* This is big enough for most current (and future?) architectures:
209 Intel P5/PPro/PII/PIII: 32 bytes
210 Intel StrongARM: 32 bytes
211 Intel i386/i486: 16 bytes
213 Motorola 68k: 16 bytes
214 Motorola PowerPC: 32 bytes
217 } drmLock, *drmLockPtr;
220 * Indices here refer to the offset into
223 typedef struct _drmDMAReq {
224 drm_context_t context; /**< Context handle */
225 int send_count; /**< Number of buffers to send */
226 int *send_list; /**< List of handles to buffers */
227 int *send_sizes; /**< Lengths of data to send, in bytes */
228 drmDMAFlags flags; /**< Flags */
229 int request_count; /**< Number of buffers requested */
230 int request_size; /**< Desired size of buffers requested */
231 int *request_list; /**< Buffer information */
232 int *request_sizes; /**< Minimum acceptable sizes */
233 int granted_count; /**< Number of buffers granted at this size */
234 } drmDMAReq, *drmDMAReqPtr;
236 typedef struct _drmRegion {
241 } drmRegion, *drmRegionPtr;
243 typedef struct _drmTextureRegion {
246 unsigned char in_use;
247 unsigned char padding; /**< Explicitly pad this out */
249 } drmTextureRegion, *drmTextureRegionPtr;
253 DRM_VBLANK_ABSOLUTE = 0x0, /**< Wait for specific vblank sequence number */
254 DRM_VBLANK_RELATIVE = 0x1, /**< Wait for given number of vblanks */
255 DRM_VBLANK_SIGNAL = 0x40000000 /* Send signal instead of blocking */
258 typedef struct _drmVBlankReq {
259 drmVBlankSeqType type;
260 unsigned int sequence;
261 unsigned long signal;
262 } drmVBlankReq, *drmVBlankReqPtr;
264 typedef struct _drmVBlankReply {
265 drmVBlankSeqType type;
266 unsigned int sequence;
269 } drmVBlankReply, *drmVBlankReplyPtr;
271 typedef union _drmVBlank {
272 drmVBlankReq request;
273 drmVBlankReply reply;
274 } drmVBlank, *drmVBlankPtr;
276 typedef struct _drmSetVersion {
281 } drmSetVersion, *drmSetVersionPtr;
283 typedef struct _drmFence{
291 typedef struct _drmTTM{
293 drm_handle_t user_token;
300 #define __drm_dummy_lock(lock) (*(__volatile__ unsigned int *)lock)
302 #define DRM_LOCK_HELD 0x80000000U /**< Hardware lock is held */
303 #define DRM_LOCK_CONT 0x40000000U /**< Hardware lock is contended */
305 #if defined(__GNUC__) && (__GNUC__ >= 2)
306 # if defined(__i386) || defined(__AMD64__) || defined(__x86_64__) || defined(__amd64__)
307 /* Reflect changes here to drmP.h */
308 #define DRM_CAS(lock,old,new,__ret) \
310 int __dummy; /* Can't mark eax as clobbered */ \
311 __asm__ __volatile__( \
312 "lock ; cmpxchg %4,%1\n\t" \
315 "=m" (__drm_dummy_lock(lock)), \
321 #elif defined(__alpha__)
323 #define DRM_CAS(lock, old, new, ret) \
327 __asm__ __volatile__( \
329 " zap %4, 0xF0, %0\n" \
331 " zap %1, 0xF0, %1\n" \
332 " cmpeq %0, %1, %1\n" \
334 " bis %5, %5, %1\n" \
336 "1: xor %1, 1, %1\n" \
340 "=m" (__drm_dummy_lock(lock)),\
346 #elif defined(__sparc__)
348 #define DRM_CAS(lock,old,new,__ret) \
349 do { register unsigned int __old __asm("o0"); \
350 register unsigned int __new __asm("o1"); \
351 register volatile unsigned int *__lock __asm("o2"); \
354 __lock = (volatile unsigned int *)lock; \
355 __asm__ __volatile__( \
356 /*"cas [%2], %3, %0"*/ \
357 ".word 0xd3e29008\n\t" \
358 /*"membar #StoreStore | #StoreLoad"*/ \
365 __ret = (__new != __old); \
368 #elif defined(__ia64__)
370 #ifdef __INTEL_COMPILER
371 /* this currently generates bad code (missing stop bits)... */
372 #include <ia64intrin.h>
374 #define DRM_CAS(lock,old,new,__ret) \
376 unsigned long __result, __old = (old) & 0xffffffff; \
378 __result = _InterlockedCompareExchange_acq(&__drm_dummy_lock(lock), (new), __old);\
379 __ret = (__result) != (__old); \
380 /* __ret = (__sync_val_compare_and_swap(&__drm_dummy_lock(lock), \
386 #define DRM_CAS(lock,old,new,__ret) \
388 unsigned int __result, __old = (old); \
389 __asm__ __volatile__( \
393 "cmpxchg4.acq %0=%1,%3,ar.ccv" \
394 : "=r" (__result), "=m" (__drm_dummy_lock(lock)) \
395 : "r" ((unsigned long)__old), "r" (new) \
397 __ret = (__result) != (__old); \
402 #elif defined(__powerpc__)
404 #define DRM_CAS(lock,old,new,__ret) \
406 __asm__ __volatile__( \
408 "0: lwarx %0,0,%1;" \
416 : "r"(lock), "r"(new), "r"(old) \
417 : "cr0", "memory"); \
420 #endif /* architecture */
421 #endif /* __GNUC__ >= 2 */
424 #define DRM_CAS(lock,old,new,ret) do { ret=1; } while (0) /* FAST LOCK FAILS */
427 #if defined(__alpha__) || defined(__powerpc__)
428 #define DRM_CAS_RESULT(_result) int _result
430 #define DRM_CAS_RESULT(_result) char _result
433 #define DRM_LIGHT_LOCK(fd,lock,context) \
435 DRM_CAS_RESULT(__ret); \
436 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \
437 if (__ret) drmGetLock(fd,context,0); \
440 /* This one counts fast locks -- for
441 benchmarking only. */
442 #define DRM_LIGHT_LOCK_COUNT(fd,lock,context,count) \
444 DRM_CAS_RESULT(__ret); \
445 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \
446 if (__ret) drmGetLock(fd,context,0); \
450 #define DRM_LOCK(fd,lock,context,flags) \
452 if (flags) drmGetLock(fd,context,flags); \
453 else DRM_LIGHT_LOCK(fd,lock,context); \
456 #define DRM_UNLOCK(fd,lock,context) \
458 DRM_CAS_RESULT(__ret); \
459 DRM_CAS(lock,DRM_LOCK_HELD|context,context,__ret); \
460 if (__ret) drmUnlock(fd,context); \
463 /* Simple spin locks */
464 #define DRM_SPINLOCK(spin,val) \
466 DRM_CAS_RESULT(__ret); \
468 DRM_CAS(spin,0,val,__ret); \
469 if (__ret) while ((spin)->lock); \
473 #define DRM_SPINLOCK_TAKE(spin,val) \
475 DRM_CAS_RESULT(__ret); \
478 cur = (*spin).lock; \
479 DRM_CAS(spin,cur,val,__ret); \
483 #define DRM_SPINLOCK_COUNT(spin,val,count,__ret) \
487 for (__i = 0; __ret && __i < count; __i++) { \
488 DRM_CAS(spin,0,val,__ret); \
489 if (__ret) for (;__i < count && (spin)->lock; __i++); \
493 #define DRM_SPINUNLOCK(spin,val) \
495 DRM_CAS_RESULT(__ret); \
496 if ((*spin).lock == val) { /* else server stole lock */ \
498 DRM_CAS(spin,val,0,__ret); \
505 /* General user-level programmer's API: unprivileged */
506 extern int drmAvailable(void);
507 extern int drmOpen(const char *name, const char *busid);
508 extern int drmClose(int fd);
509 extern drmVersionPtr drmGetVersion(int fd);
510 extern drmVersionPtr drmGetLibVersion(int fd);
511 extern void drmFreeVersion(drmVersionPtr);
512 extern int drmGetMagic(int fd, drm_magic_t * magic);
513 extern char *drmGetBusid(int fd);
514 extern int drmGetInterruptFromBusID(int fd, int busnum, int devnum,
516 extern int drmGetMap(int fd, int idx, drm_handle_t *offset,
517 drmSize *size, drmMapType *type,
518 drmMapFlags *flags, drm_handle_t *handle,
520 extern int drmGetClient(int fd, int idx, int *auth, int *pid,
521 int *uid, unsigned long *magic,
522 unsigned long *iocs);
523 extern int drmGetStats(int fd, drmStatsT *stats);
524 extern int drmSetInterfaceVersion(int fd, drmSetVersion *version);
525 extern int drmCommandNone(int fd, unsigned long drmCommandIndex);
526 extern int drmCommandRead(int fd, unsigned long drmCommandIndex,
527 void *data, unsigned long size);
528 extern int drmCommandWrite(int fd, unsigned long drmCommandIndex,
529 void *data, unsigned long size);
530 extern int drmCommandWriteRead(int fd, unsigned long drmCommandIndex,
531 void *data, unsigned long size);
533 /* General user-level programmer's API: X server (root) only */
534 extern void drmFreeBusid(const char *busid);
535 extern int drmSetBusid(int fd, const char *busid);
536 extern int drmAuthMagic(int fd, drm_magic_t magic);
537 extern int drmAddMap(int fd,
542 drm_handle_t * handle);
543 extern int drmRmMap(int fd, drm_handle_t handle);
544 extern int drmAddContextPrivateMapping(int fd, drm_context_t ctx_id,
545 drm_handle_t handle);
547 extern int drmAddBufs(int fd, int count, int size,
548 drmBufDescFlags flags,
550 extern int drmMarkBufs(int fd, double low, double high);
551 extern int drmCreateContext(int fd, drm_context_t * handle);
552 extern int drmSetContextFlags(int fd, drm_context_t context,
553 drm_context_tFlags flags);
554 extern int drmGetContextFlags(int fd, drm_context_t context,
555 drm_context_tFlagsPtr flags);
556 extern int drmAddContextTag(int fd, drm_context_t context, void *tag);
557 extern int drmDelContextTag(int fd, drm_context_t context);
558 extern void *drmGetContextTag(int fd, drm_context_t context);
559 extern drm_context_t * drmGetReservedContextList(int fd, int *count);
560 extern void drmFreeReservedContextList(drm_context_t *);
561 extern int drmSwitchToContext(int fd, drm_context_t context);
562 extern int drmDestroyContext(int fd, drm_context_t handle);
563 extern int drmCreateDrawable(int fd, drm_drawable_t * handle);
564 extern int drmDestroyDrawable(int fd, drm_drawable_t handle);
565 extern int drmCtlInstHandler(int fd, int irq);
566 extern int drmCtlUninstHandler(int fd);
568 /* General user-level programmer's API: authenticated client and/or X */
569 extern int drmMap(int fd,
572 drmAddressPtr address);
573 extern int drmUnmap(drmAddress address, drmSize size);
574 extern drmBufInfoPtr drmGetBufInfo(int fd);
575 extern drmBufMapPtr drmMapBufs(int fd);
576 extern int drmUnmapBufs(drmBufMapPtr bufs);
577 extern int drmDMA(int fd, drmDMAReqPtr request);
578 extern int drmFreeBufs(int fd, int count, int *list);
579 extern int drmGetLock(int fd,
580 drm_context_t context,
582 extern int drmUnlock(int fd, drm_context_t context);
583 extern int drmFinish(int fd, int context, drmLockFlags flags);
584 extern int drmGetContextPrivateMapping(int fd, drm_context_t ctx_id,
585 drm_handle_t * handle);
587 /* AGP/GART support: X server (root) only */
588 extern int drmAgpAcquire(int fd);
589 extern int drmAgpRelease(int fd);
590 extern int drmAgpEnable(int fd, unsigned long mode);
591 extern int drmAgpAlloc(int fd, unsigned long size,
592 unsigned long type, unsigned long *address,
593 drm_handle_t *handle);
594 extern int drmAgpFree(int fd, drm_handle_t handle);
595 extern int drmAgpBind(int fd, drm_handle_t handle,
596 unsigned long offset);
597 extern int drmAgpUnbind(int fd, drm_handle_t handle);
599 /* AGP/GART info: authenticated client and/or X */
600 extern int drmAgpVersionMajor(int fd);
601 extern int drmAgpVersionMinor(int fd);
602 extern unsigned long drmAgpGetMode(int fd);
603 extern unsigned long drmAgpBase(int fd); /* Physical location */
604 extern unsigned long drmAgpSize(int fd); /* Bytes */
605 extern unsigned long drmAgpMemoryUsed(int fd);
606 extern unsigned long drmAgpMemoryAvail(int fd);
607 extern unsigned int drmAgpVendorId(int fd);
608 extern unsigned int drmAgpDeviceId(int fd);
610 /* PCI scatter/gather support: X server (root) only */
611 extern int drmScatterGatherAlloc(int fd, unsigned long size,
612 drm_handle_t *handle);
613 extern int drmScatterGatherFree(int fd, drm_handle_t handle);
615 extern int drmWaitVBlank(int fd, drmVBlankPtr vbl);
619 extern int drmFenceCreate(int fd, int shareable, int class,
620 unsigned type, int emit,
622 extern int drmFenceDestroy(int fd, const drmFence *fence);
623 extern int drmFenceReference(int fd, unsigned handle, drmFence *fence);
624 extern int drmFenceUnreference(int fd, const drmFence *fence);
625 extern int drmFenceFlush(int fd, drmFence *fence, unsigned flush_type);
626 extern int drmFenceSignaled(int fd, drmFence *fence,
627 unsigned fenceType, int *signaled);
628 extern int drmFenceWait(int fd, drmFence *fence, unsigned flush_type,
629 int lazy, int ignore_signals);
630 extern int drmFenceEmit(int fd, drmFence *fence, unsigned emit_type);
631 extern int drmFenceBuffers(int fd, int shareable, drmFence *fence);
634 extern int drmTTMCreate(int fd, drmTTM *ttm, unsigned long size,
636 extern int drmTTMDestroy(int fd, const drmTTM *ttm);
637 extern int drmTTMReference(int fd, unsigned handle, drmTTM *ttm);
638 extern int drmTTMUnreference(int fd, const drmTTM *ttm);
639 extern drm_handle_t drmTTMMapHandle(int fd, const drmTTM *ttm);
642 /* Support routines */
643 extern int drmError(int err, const char *label);
644 extern void *drmMalloc(int size);
645 extern void drmFree(void *pt);
647 /* Hash table routines */
648 extern void *drmHashCreate(void);
649 extern int drmHashDestroy(void *t);
650 extern int drmHashLookup(void *t, unsigned long key, void **value);
651 extern int drmHashInsert(void *t, unsigned long key, void *value);
652 extern int drmHashDelete(void *t, unsigned long key);
653 extern int drmHashFirst(void *t, unsigned long *key, void **value);
654 extern int drmHashNext(void *t, unsigned long *key, void **value);
657 extern void *drmRandomCreate(unsigned long seed);
658 extern int drmRandomDestroy(void *state);
659 extern unsigned long drmRandom(void *state);
660 extern double drmRandomDouble(void *state);
662 /* Skip list routines */
664 extern void *drmSLCreate(void);
665 extern int drmSLDestroy(void *l);
666 extern int drmSLLookup(void *l, unsigned long key, void **value);
667 extern int drmSLInsert(void *l, unsigned long key, void *value);
668 extern int drmSLDelete(void *l, unsigned long key);
669 extern int drmSLNext(void *l, unsigned long *key, void **value);
670 extern int drmSLFirst(void *l, unsigned long *key, void **value);
671 extern void drmSLDump(void *l);
672 extern int drmSLLookupNeighbors(void *l, unsigned long key,
673 unsigned long *prev_key, void **prev_value,
674 unsigned long *next_key, void **next_value);