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.
38 #include <sys/types.h>
43 #if defined(__cplusplus)
48 #define DRM_MAX_MINOR 16
51 #if defined(__linux__)
53 #define DRM_IOCTL_NR(n) _IOC_NR(n)
54 #define DRM_IOC_VOID _IOC_NONE
55 #define DRM_IOC_READ _IOC_READ
56 #define DRM_IOC_WRITE _IOC_WRITE
57 #define DRM_IOC_READWRITE _IOC_READ|_IOC_WRITE
58 #define DRM_IOC(dir, group, nr, size) _IOC(dir, group, nr, size)
60 #else /* One of the *BSDs */
62 #include <sys/ioccom.h>
63 #define DRM_IOCTL_NR(n) ((n) & 0xff)
64 #define DRM_IOC_VOID IOC_VOID
65 #define DRM_IOC_READ IOC_OUT
66 #define DRM_IOC_WRITE IOC_IN
67 #define DRM_IOC_READWRITE IOC_INOUT
68 #define DRM_IOC(dir, group, nr, size) _IOC(dir, group, nr, size)
72 /* Defaults, if nothing set in xf86config */
75 /* Default /dev/dri directory permissions 0755 */
76 #define DRM_DEV_DIRMODE \
77 (S_IRUSR|S_IWUSR|S_IXUSR|S_IRGRP|S_IXGRP|S_IROTH|S_IXOTH)
78 #define DRM_DEV_MODE (S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP)
81 #define DRM_DIR_NAME "/dev"
82 #define DRM_DEV_NAME "%s/drm%d"
83 #define DRM_CONTROL_DEV_NAME "%s/drmC%d"
84 #define DRM_RENDER_DEV_NAME "%s/drmR%d"
86 #define DRM_DIR_NAME "/dev/dri"
87 #define DRM_DEV_NAME "%s/card%d"
88 #define DRM_CONTROL_DEV_NAME "%s/controlD%d"
89 #define DRM_RENDER_DEV_NAME "%s/renderD%d"
90 #define DRM_PROC_NAME "/proc/dri/" /* For backward Linux compatibility */
93 #define DRM_ERR_NO_DEVICE (-1001)
94 #define DRM_ERR_NO_ACCESS (-1002)
95 #define DRM_ERR_NOT_ROOT (-1003)
96 #define DRM_ERR_INVALID (-1004)
97 #define DRM_ERR_NO_FD (-1005)
99 #define DRM_AGP_NO_HANDLE 0
101 typedef unsigned int drmSize, *drmSizePtr; /**< For mapped regions */
102 typedef void *drmAddress, **drmAddressPtr; /**< For mapped regions */
105 #define DRM_PRINTFLIKE(f, a) __attribute__ ((format(__printf__, f, a)))
107 #define DRM_PRINTFLIKE(f, a)
110 typedef struct _drmServerInfo {
111 int (*debug_print)(const char *format, va_list ap) DRM_PRINTFLIKE(1,0);
112 int (*load_module)(const char *name);
113 void (*get_perms)(gid_t *, mode_t *);
114 } drmServerInfo, *drmServerInfoPtr;
116 typedef struct drmHashEntry {
118 void (*f)(int, void *, void *);
122 extern int drmIoctl(int fd, unsigned long request, void *arg);
123 extern void *drmGetHashTable(void);
124 extern drmHashEntry *drmGetEntry(int fd);
127 * Driver version information.
129 * \sa drmGetVersion() and drmSetVersion().
131 typedef struct _drmVersion {
132 int version_major; /**< Major version */
133 int version_minor; /**< Minor version */
134 int version_patchlevel; /**< Patch level */
135 int name_len; /**< Length of name buffer */
136 char *name; /**< Name of driver */
137 int date_len; /**< Length of date buffer */
138 char *date; /**< User-space buffer to hold date */
139 int desc_len; /**< Length of desc buffer */
140 char *desc; /**< User-space buffer to hold desc */
141 } drmVersion, *drmVersionPtr;
143 typedef struct _drmStats {
144 unsigned long count; /**< Number of data */
146 unsigned long value; /**< Value from kernel */
147 const char *long_format; /**< Suggested format for long_name */
148 const char *long_name; /**< Long name for value */
149 const char *rate_format; /**< Suggested format for rate_name */
150 const char *rate_name; /**< Short name for value per second */
151 int isvalue; /**< True if value (vs. counter) */
152 const char *mult_names; /**< Multiplier names (e.g., "KGM") */
153 int mult; /**< Multiplier value (e.g., 1024) */
154 int verbose; /**< Suggest only in verbose output */
159 /* All of these enums *MUST* match with the
160 kernel implementation -- so do *NOT*
161 change them! (The drmlib implementation
162 will just copy the flags instead of
163 translating them.) */
165 DRM_FRAME_BUFFER = 0, /**< WC, no caching, no core dump */
166 DRM_REGISTERS = 1, /**< no caching, no core dump */
167 DRM_SHM = 2, /**< shared, cached */
168 DRM_AGP = 3, /**< AGP/GART */
169 DRM_SCATTER_GATHER = 4, /**< PCI scatter/gather */
170 DRM_CONSISTENT = 5 /**< PCI consistent */
174 DRM_RESTRICTED = 0x0001, /**< Cannot be mapped to client-virtual */
175 DRM_READ_ONLY = 0x0002, /**< Read-only in client-virtual */
176 DRM_LOCKED = 0x0004, /**< Physical pages locked */
177 DRM_KERNEL = 0x0008, /**< Kernel requires access */
178 DRM_WRITE_COMBINING = 0x0010, /**< Use write-combining, if available */
179 DRM_CONTAINS_LOCK = 0x0020, /**< SHM page that contains lock */
180 DRM_REMOVABLE = 0x0040 /**< Removable mapping */
184 * \warning These values *MUST* match drm.h
187 /** \name Flags for DMA buffer dispatch */
189 DRM_DMA_BLOCK = 0x01, /**<
190 * Block until buffer dispatched.
192 * \note the buffer may not yet have been
193 * processed by the hardware -- getting a
194 * hardware lock with the hardware quiescent
195 * will ensure that the buffer has been
198 DRM_DMA_WHILE_LOCKED = 0x02, /**< Dispatch while lock held */
199 DRM_DMA_PRIORITY = 0x04, /**< High priority dispatch */
202 /** \name Flags for DMA buffer request */
204 DRM_DMA_WAIT = 0x10, /**< Wait for free buffers */
205 DRM_DMA_SMALLER_OK = 0x20, /**< Smaller-than-requested buffers OK */
206 DRM_DMA_LARGER_OK = 0x40 /**< Larger-than-requested buffers OK */
211 DRM_PAGE_ALIGN = 0x01,
212 DRM_AGP_BUFFER = 0x02,
213 DRM_SG_BUFFER = 0x04,
214 DRM_FB_BUFFER = 0x08,
215 DRM_PCI_BUFFER_RO = 0x10
219 DRM_LOCK_READY = 0x01, /**< Wait until hardware is ready for DMA */
220 DRM_LOCK_QUIESCENT = 0x02, /**< Wait until hardware quiescent */
221 DRM_LOCK_FLUSH = 0x04, /**< Flush this context's DMA queue first */
222 DRM_LOCK_FLUSH_ALL = 0x08, /**< Flush all DMA queues first */
223 /* These *HALT* flags aren't supported yet
224 -- they will be used to support the
225 full-screen DGA-like mode. */
226 DRM_HALT_ALL_QUEUES = 0x10, /**< Halt all current and future queues */
227 DRM_HALT_CUR_QUEUES = 0x20 /**< Halt all current queues */
231 DRM_CONTEXT_PRESERVED = 0x01, /**< This context is preserved and
233 DRM_CONTEXT_2DONLY = 0x02 /**< This context is for 2D rendering only. */
234 } drm_context_tFlags, *drm_context_tFlagsPtr;
236 typedef struct _drmBufDesc {
237 int count; /**< Number of buffers of this size */
238 int size; /**< Size in bytes */
239 int low_mark; /**< Low water mark */
240 int high_mark; /**< High water mark */
241 } drmBufDesc, *drmBufDescPtr;
243 typedef struct _drmBufInfo {
244 int count; /**< Number of buffers described in list */
245 drmBufDescPtr list; /**< List of buffer descriptions */
246 } drmBufInfo, *drmBufInfoPtr;
248 typedef struct _drmBuf {
249 int idx; /**< Index into the master buffer list */
250 int total; /**< Buffer size */
251 int used; /**< Amount of buffer in use (for DMA) */
252 drmAddress address; /**< Address */
253 } drmBuf, *drmBufPtr;
256 * Buffer mapping information.
258 * Used by drmMapBufs() and drmUnmapBufs() to store information about the
261 typedef struct _drmBufMap {
262 int count; /**< Number of buffers mapped */
263 drmBufPtr list; /**< Buffers */
264 } drmBufMap, *drmBufMapPtr;
266 typedef struct _drmLock {
267 volatile unsigned int lock;
269 /* This is big enough for most current (and future?) architectures:
272 Intel P5/PPro/PII/PIII: 32 bytes
273 Intel StrongARM: 32 bytes
274 Intel i386/i486: 16 bytes
276 Motorola 68k: 16 bytes
277 Motorola PowerPC: 32 bytes
280 } drmLock, *drmLockPtr;
283 * Indices here refer to the offset into
286 typedef struct _drmDMAReq {
287 drm_context_t context; /**< Context handle */
288 int send_count; /**< Number of buffers to send */
289 int *send_list; /**< List of handles to buffers */
290 int *send_sizes; /**< Lengths of data to send, in bytes */
291 drmDMAFlags flags; /**< Flags */
292 int request_count; /**< Number of buffers requested */
293 int request_size; /**< Desired size of buffers requested */
294 int *request_list; /**< Buffer information */
295 int *request_sizes; /**< Minimum acceptable sizes */
296 int granted_count; /**< Number of buffers granted at this size */
297 } drmDMAReq, *drmDMAReqPtr;
299 typedef struct _drmRegion {
304 } drmRegion, *drmRegionPtr;
306 typedef struct _drmTextureRegion {
309 unsigned char in_use;
310 unsigned char padding; /**< Explicitly pad this out */
312 } drmTextureRegion, *drmTextureRegionPtr;
316 DRM_VBLANK_ABSOLUTE = 0x0, /**< Wait for specific vblank sequence number */
317 DRM_VBLANK_RELATIVE = 0x1, /**< Wait for given number of vblanks */
318 /* bits 1-6 are reserved for high crtcs */
319 DRM_VBLANK_HIGH_CRTC_MASK = 0x0000003e,
320 DRM_VBLANK_EVENT = 0x4000000, /**< Send event instead of blocking */
321 DRM_VBLANK_FLIP = 0x8000000, /**< Scheduled buffer swap should flip */
322 DRM_VBLANK_NEXTONMISS = 0x10000000, /**< If missed, wait for next vblank */
323 DRM_VBLANK_SECONDARY = 0x20000000, /**< Secondary display controller */
324 DRM_VBLANK_SIGNAL = 0x40000000 /* Send signal instead of blocking */
326 #define DRM_VBLANK_HIGH_CRTC_SHIFT 1
328 typedef struct _drmVBlankReq {
329 drmVBlankSeqType type;
330 unsigned int sequence;
331 unsigned long signal;
332 } drmVBlankReq, *drmVBlankReqPtr;
334 typedef struct _drmVBlankReply {
335 drmVBlankSeqType type;
336 unsigned int sequence;
339 } drmVBlankReply, *drmVBlankReplyPtr;
341 typedef union _drmVBlank {
342 drmVBlankReq request;
343 drmVBlankReply reply;
344 } drmVBlank, *drmVBlankPtr;
346 typedef struct _drmSetVersion {
351 } drmSetVersion, *drmSetVersionPtr;
353 #define __drm_dummy_lock(lock) (*(__volatile__ unsigned int *)lock)
355 #define DRM_LOCK_HELD 0x80000000U /**< Hardware lock is held */
356 #define DRM_LOCK_CONT 0x40000000U /**< Hardware lock is contended */
358 #if defined(__GNUC__) && (__GNUC__ >= 2)
359 # if defined(__i386) || defined(__AMD64__) || defined(__x86_64__) || defined(__amd64__)
360 /* Reflect changes here to drmP.h */
361 #define DRM_CAS(lock,old,new,__ret) \
363 int __dummy; /* Can't mark eax as clobbered */ \
364 __asm__ __volatile__( \
365 "lock ; cmpxchg %4,%1\n\t" \
368 "=m" (__drm_dummy_lock(lock)), \
374 #elif defined(__alpha__)
376 #define DRM_CAS(lock, old, new, ret) \
379 __asm__ __volatile__( \
380 " addl $31, %5, %3\n" \
381 "1: ldl_l %0, %2\n" \
382 " cmpeq %0, %3, %1\n" \
388 "2: cmpeq %1, 0, %1\n" \
392 : "=&r"(tmp), "=&r"(ret), \
393 "=m"(__drm_dummy_lock(lock)), \
395 : "r"(new), "r"(old) \
399 #elif defined(__sparc__)
401 #define DRM_CAS(lock,old,new,__ret) \
402 do { register unsigned int __old __asm("o0"); \
403 register unsigned int __new __asm("o1"); \
404 register volatile unsigned int *__lock __asm("o2"); \
407 __lock = (volatile unsigned int *)lock; \
408 __asm__ __volatile__( \
409 /*"cas [%2], %3, %0"*/ \
410 ".word 0xd3e29008\n\t" \
411 /*"membar #StoreStore | #StoreLoad"*/ \
418 __ret = (__new != __old); \
421 #elif defined(__ia64__)
423 #ifdef __INTEL_COMPILER
424 /* this currently generates bad code (missing stop bits)... */
425 #include <ia64intrin.h>
427 #define DRM_CAS(lock,old,new,__ret) \
429 unsigned long __result, __old = (old) & 0xffffffff; \
431 __result = _InterlockedCompareExchange_acq(&__drm_dummy_lock(lock), (new), __old);\
432 __ret = (__result) != (__old); \
433 /* __ret = (__sync_val_compare_and_swap(&__drm_dummy_lock(lock), \
439 #define DRM_CAS(lock,old,new,__ret) \
441 unsigned int __result, __old = (old); \
442 __asm__ __volatile__( \
446 "cmpxchg4.acq %0=%1,%3,ar.ccv" \
447 : "=r" (__result), "=m" (__drm_dummy_lock(lock)) \
448 : "r" ((unsigned long)__old), "r" (new) \
450 __ret = (__result) != (__old); \
455 #elif defined(__powerpc__)
457 #define DRM_CAS(lock,old,new,__ret) \
459 __asm__ __volatile__( \
461 "0: lwarx %0,0,%1;" \
469 : "r"(lock), "r"(new), "r"(old) \
470 : "cr0", "memory"); \
473 #endif /* architecture */
474 #endif /* __GNUC__ >= 2 */
477 #define DRM_CAS(lock,old,new,ret) do { ret=1; } while (0) /* FAST LOCK FAILS */
480 #if defined(__alpha__)
481 #define DRM_CAS_RESULT(_result) long _result
482 #elif defined(__powerpc__)
483 #define DRM_CAS_RESULT(_result) int _result
485 #define DRM_CAS_RESULT(_result) char _result
488 #define DRM_LIGHT_LOCK(fd,lock,context) \
490 DRM_CAS_RESULT(__ret); \
491 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \
492 if (__ret) drmGetLock(fd,context,0); \
495 /* This one counts fast locks -- for
496 benchmarking only. */
497 #define DRM_LIGHT_LOCK_COUNT(fd,lock,context,count) \
499 DRM_CAS_RESULT(__ret); \
500 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \
501 if (__ret) drmGetLock(fd,context,0); \
505 #define DRM_LOCK(fd,lock,context,flags) \
507 if (flags) drmGetLock(fd,context,flags); \
508 else DRM_LIGHT_LOCK(fd,lock,context); \
511 #define DRM_UNLOCK(fd,lock,context) \
513 DRM_CAS_RESULT(__ret); \
514 DRM_CAS(lock,DRM_LOCK_HELD|context,context,__ret); \
515 if (__ret) drmUnlock(fd,context); \
518 /* Simple spin locks */
519 #define DRM_SPINLOCK(spin,val) \
521 DRM_CAS_RESULT(__ret); \
523 DRM_CAS(spin,0,val,__ret); \
524 if (__ret) while ((spin)->lock); \
528 #define DRM_SPINLOCK_TAKE(spin,val) \
530 DRM_CAS_RESULT(__ret); \
533 cur = (*spin).lock; \
534 DRM_CAS(spin,cur,val,__ret); \
538 #define DRM_SPINLOCK_COUNT(spin,val,count,__ret) \
542 for (__i = 0; __ret && __i < count; __i++) { \
543 DRM_CAS(spin,0,val,__ret); \
544 if (__ret) for (;__i < count && (spin)->lock; __i++); \
548 #define DRM_SPINUNLOCK(spin,val) \
550 DRM_CAS_RESULT(__ret); \
551 if ((*spin).lock == val) { /* else server stole lock */ \
553 DRM_CAS(spin,val,0,__ret); \
560 /* General user-level programmer's API: unprivileged */
561 extern int drmAvailable(void);
562 extern int drmOpen(const char *name, const char *busid);
564 #define DRM_NODE_PRIMARY 0
565 #define DRM_NODE_CONTROL 1
566 #define DRM_NODE_RENDER 2
567 #define DRM_NODE_MAX 3
569 extern int drmOpenWithType(const char *name, const char *busid,
572 extern int drmOpenControl(int minor);
573 extern int drmOpenRender(int minor);
574 extern int drmClose(int fd);
575 extern drmVersionPtr drmGetVersion(int fd);
576 extern drmVersionPtr drmGetLibVersion(int fd);
577 extern int drmGetCap(int fd, uint64_t capability, uint64_t *value);
578 extern void drmFreeVersion(drmVersionPtr);
579 extern int drmGetMagic(int fd, drm_magic_t * magic);
580 extern char *drmGetBusid(int fd);
581 extern int drmGetInterruptFromBusID(int fd, int busnum, int devnum,
583 extern int drmGetMap(int fd, int idx, drm_handle_t *offset,
584 drmSize *size, drmMapType *type,
585 drmMapFlags *flags, drm_handle_t *handle,
587 extern int drmGetClient(int fd, int idx, int *auth, int *pid,
588 int *uid, unsigned long *magic,
589 unsigned long *iocs);
590 extern int drmGetStats(int fd, drmStatsT *stats);
591 extern int drmSetInterfaceVersion(int fd, drmSetVersion *version);
592 extern int drmCommandNone(int fd, unsigned long drmCommandIndex);
593 extern int drmCommandRead(int fd, unsigned long drmCommandIndex,
594 void *data, unsigned long size);
595 extern int drmCommandWrite(int fd, unsigned long drmCommandIndex,
596 void *data, unsigned long size);
597 extern int drmCommandWriteRead(int fd, unsigned long drmCommandIndex,
598 void *data, unsigned long size);
600 /* General user-level programmer's API: X server (root) only */
601 extern void drmFreeBusid(const char *busid);
602 extern int drmSetBusid(int fd, const char *busid);
603 extern int drmAuthMagic(int fd, drm_magic_t magic);
604 extern int drmAddMap(int fd,
609 drm_handle_t * handle);
610 extern int drmRmMap(int fd, drm_handle_t handle);
611 extern int drmAddContextPrivateMapping(int fd, drm_context_t ctx_id,
612 drm_handle_t handle);
614 extern int drmAddBufs(int fd, int count, int size,
615 drmBufDescFlags flags,
617 extern int drmMarkBufs(int fd, double low, double high);
618 extern int drmCreateContext(int fd, drm_context_t * handle);
619 extern int drmSetContextFlags(int fd, drm_context_t context,
620 drm_context_tFlags flags);
621 extern int drmGetContextFlags(int fd, drm_context_t context,
622 drm_context_tFlagsPtr flags);
623 extern int drmAddContextTag(int fd, drm_context_t context, void *tag);
624 extern int drmDelContextTag(int fd, drm_context_t context);
625 extern void *drmGetContextTag(int fd, drm_context_t context);
626 extern drm_context_t * drmGetReservedContextList(int fd, int *count);
627 extern void drmFreeReservedContextList(drm_context_t *);
628 extern int drmSwitchToContext(int fd, drm_context_t context);
629 extern int drmDestroyContext(int fd, drm_context_t handle);
630 extern int drmCreateDrawable(int fd, drm_drawable_t * handle);
631 extern int drmDestroyDrawable(int fd, drm_drawable_t handle);
632 extern int drmUpdateDrawableInfo(int fd, drm_drawable_t handle,
633 drm_drawable_info_type_t type,
634 unsigned int num, void *data);
635 extern int drmCtlInstHandler(int fd, int irq);
636 extern int drmCtlUninstHandler(int fd);
637 extern int drmSetClientCap(int fd, uint64_t capability,
640 extern int drmCrtcGetSequence(int fd, uint32_t crtcId,
641 uint64_t *sequence, uint64_t *ns);
642 extern int drmCrtcQueueSequence(int fd, uint32_t crtcId,
643 uint32_t flags, uint64_t sequence,
644 uint64_t *sequence_queued,
646 /* General user-level programmer's API: authenticated client and/or X */
647 extern int drmMap(int fd,
650 drmAddressPtr address);
651 extern int drmUnmap(drmAddress address, drmSize size);
652 extern drmBufInfoPtr drmGetBufInfo(int fd);
653 extern drmBufMapPtr drmMapBufs(int fd);
654 extern int drmUnmapBufs(drmBufMapPtr bufs);
655 extern int drmDMA(int fd, drmDMAReqPtr request);
656 extern int drmFreeBufs(int fd, int count, int *list);
657 extern int drmGetLock(int fd,
658 drm_context_t context,
660 extern int drmUnlock(int fd, drm_context_t context);
661 extern int drmFinish(int fd, int context, drmLockFlags flags);
662 extern int drmGetContextPrivateMapping(int fd, drm_context_t ctx_id,
663 drm_handle_t * handle);
665 /* AGP/GART support: X server (root) only */
666 extern int drmAgpAcquire(int fd);
667 extern int drmAgpRelease(int fd);
668 extern int drmAgpEnable(int fd, unsigned long mode);
669 extern int drmAgpAlloc(int fd, unsigned long size,
670 unsigned long type, unsigned long *address,
671 drm_handle_t *handle);
672 extern int drmAgpFree(int fd, drm_handle_t handle);
673 extern int drmAgpBind(int fd, drm_handle_t handle,
674 unsigned long offset);
675 extern int drmAgpUnbind(int fd, drm_handle_t handle);
677 /* AGP/GART info: authenticated client and/or X */
678 extern int drmAgpVersionMajor(int fd);
679 extern int drmAgpVersionMinor(int fd);
680 extern unsigned long drmAgpGetMode(int fd);
681 extern unsigned long drmAgpBase(int fd); /* Physical location */
682 extern unsigned long drmAgpSize(int fd); /* Bytes */
683 extern unsigned long drmAgpMemoryUsed(int fd);
684 extern unsigned long drmAgpMemoryAvail(int fd);
685 extern unsigned int drmAgpVendorId(int fd);
686 extern unsigned int drmAgpDeviceId(int fd);
688 /* PCI scatter/gather support: X server (root) only */
689 extern int drmScatterGatherAlloc(int fd, unsigned long size,
690 drm_handle_t *handle);
691 extern int drmScatterGatherFree(int fd, drm_handle_t handle);
693 extern int drmWaitVBlank(int fd, drmVBlankPtr vbl);
695 /* Support routines */
696 extern void drmSetServerInfo(drmServerInfoPtr info);
697 extern int drmError(int err, const char *label);
698 extern void *drmMalloc(int size);
699 extern void drmFree(void *pt);
701 /* Hash table routines */
702 extern void *drmHashCreate(void);
703 extern int drmHashDestroy(void *t);
704 extern int drmHashLookup(void *t, unsigned long key, void **value);
705 extern int drmHashInsert(void *t, unsigned long key, void *value);
706 extern int drmHashDelete(void *t, unsigned long key);
707 extern int drmHashFirst(void *t, unsigned long *key, void **value);
708 extern int drmHashNext(void *t, unsigned long *key, void **value);
711 extern void *drmRandomCreate(unsigned long seed);
712 extern int drmRandomDestroy(void *state);
713 extern unsigned long drmRandom(void *state);
714 extern double drmRandomDouble(void *state);
716 /* Skip list routines */
718 extern void *drmSLCreate(void);
719 extern int drmSLDestroy(void *l);
720 extern int drmSLLookup(void *l, unsigned long key, void **value);
721 extern int drmSLInsert(void *l, unsigned long key, void *value);
722 extern int drmSLDelete(void *l, unsigned long key);
723 extern int drmSLNext(void *l, unsigned long *key, void **value);
724 extern int drmSLFirst(void *l, unsigned long *key, void **value);
725 extern void drmSLDump(void *l);
726 extern int drmSLLookupNeighbors(void *l, unsigned long key,
727 unsigned long *prev_key, void **prev_value,
728 unsigned long *next_key, void **next_value);
730 extern int drmOpenOnce(void *unused, const char *BusID, int *newlyopened);
731 extern int drmOpenOnceWithType(const char *BusID, int *newlyopened, int type);
732 extern void drmCloseOnce(int fd);
733 extern void drmMsg(const char *format, ...) DRM_PRINTFLIKE(1, 2);
735 extern int drmSetMaster(int fd);
736 extern int drmDropMaster(int fd);
737 extern bool drmIsMaster(int fd);
739 #define DRM_EVENT_CONTEXT_VERSION 4
741 typedef struct _drmEventContext {
743 /* This struct is versioned so we can add more pointers if we
744 * add more events. */
747 void (*vblank_handler)(int fd,
748 unsigned int sequence,
750 unsigned int tv_usec,
753 void (*page_flip_handler)(int fd,
754 unsigned int sequence,
756 unsigned int tv_usec,
759 void (*page_flip_handler2)(int fd,
760 unsigned int sequence,
762 unsigned int tv_usec,
763 unsigned int crtc_id,
766 void (*sequence_handler)(int fd,
770 } drmEventContext, *drmEventContextPtr;
772 extern int drmHandleEvent(int fd, drmEventContextPtr evctx);
774 extern char *drmGetDeviceNameFromFd(int fd);
776 /* Improved version of drmGetDeviceNameFromFd which attributes for any type of
777 * device/node - card, control or renderD.
779 extern char *drmGetDeviceNameFromFd2(int fd);
780 extern int drmGetNodeTypeFromFd(int fd);
782 extern int drmPrimeHandleToFD(int fd, uint32_t handle, uint32_t flags, int *prime_fd);
783 extern int drmPrimeFDToHandle(int fd, int prime_fd, uint32_t *handle);
785 extern char *drmGetPrimaryDeviceNameFromFd(int fd);
786 extern char *drmGetRenderDeviceNameFromFd(int fd);
788 #define DRM_BUS_PCI 0
789 #define DRM_BUS_USB 1
790 #define DRM_BUS_PLATFORM 2
791 #define DRM_BUS_HOST1X 3
793 typedef struct _drmPciBusInfo {
798 } drmPciBusInfo, *drmPciBusInfoPtr;
800 typedef struct _drmPciDeviceInfo {
803 uint16_t subvendor_id;
804 uint16_t subdevice_id;
806 } drmPciDeviceInfo, *drmPciDeviceInfoPtr;
808 typedef struct _drmUsbBusInfo {
811 } drmUsbBusInfo, *drmUsbBusInfoPtr;
813 typedef struct _drmUsbDeviceInfo {
816 } drmUsbDeviceInfo, *drmUsbDeviceInfoPtr;
818 #define DRM_PLATFORM_DEVICE_NAME_LEN 512
820 typedef struct _drmPlatformBusInfo {
821 char fullname[DRM_PLATFORM_DEVICE_NAME_LEN];
822 } drmPlatformBusInfo, *drmPlatformBusInfoPtr;
824 typedef struct _drmPlatformDeviceInfo {
825 char **compatible; /* NULL terminated list of compatible strings */
826 } drmPlatformDeviceInfo, *drmPlatformDeviceInfoPtr;
828 #define DRM_HOST1X_DEVICE_NAME_LEN 512
830 typedef struct _drmHost1xBusInfo {
831 char fullname[DRM_HOST1X_DEVICE_NAME_LEN];
832 } drmHost1xBusInfo, *drmHost1xBusInfoPtr;
834 typedef struct _drmHost1xDeviceInfo {
835 char **compatible; /* NULL terminated list of compatible strings */
836 } drmHost1xDeviceInfo, *drmHost1xDeviceInfoPtr;
838 typedef struct _drmDevice {
839 char **nodes; /* DRM_NODE_MAX sized array */
840 int available_nodes; /* DRM_NODE_* bitmask */
843 drmPciBusInfoPtr pci;
844 drmUsbBusInfoPtr usb;
845 drmPlatformBusInfoPtr platform;
846 drmHost1xBusInfoPtr host1x;
849 drmPciDeviceInfoPtr pci;
850 drmUsbDeviceInfoPtr usb;
851 drmPlatformDeviceInfoPtr platform;
852 drmHost1xDeviceInfoPtr host1x;
854 } drmDevice, *drmDevicePtr;
856 extern int drmGetDevice(int fd, drmDevicePtr *device);
857 extern void drmFreeDevice(drmDevicePtr *device);
859 extern int drmGetDevices(drmDevicePtr devices[], int max_devices);
860 extern void drmFreeDevices(drmDevicePtr devices[], int count);
862 #define DRM_DEVICE_GET_PCI_REVISION (1 << 0)
863 extern int drmGetDevice2(int fd, uint32_t flags, drmDevicePtr *device);
864 extern int drmGetDevices2(uint32_t flags, drmDevicePtr devices[], int max_devices);
866 extern int drmDevicesEqual(drmDevicePtr a, drmDevicePtr b);
868 extern int drmSyncobjCreate(int fd, uint32_t flags, uint32_t *handle);
869 extern int drmSyncobjDestroy(int fd, uint32_t handle);
870 extern int drmSyncobjHandleToFD(int fd, uint32_t handle, int *obj_fd);
871 extern int drmSyncobjFDToHandle(int fd, int obj_fd, uint32_t *handle);
873 extern int drmSyncobjImportSyncFile(int fd, uint32_t handle, int sync_file_fd);
874 extern int drmSyncobjExportSyncFile(int fd, uint32_t handle, int *sync_file_fd);
875 extern int drmSyncobjWait(int fd, uint32_t *handles, unsigned num_handles,
876 int64_t timeout_nsec, unsigned flags,
877 uint32_t *first_signaled);
878 extern int drmSyncobjReset(int fd, const uint32_t *handles, uint32_t handle_count);
879 extern int drmSyncobjSignal(int fd, const uint32_t *handles, uint32_t handle_count);
881 #if defined(__cplusplus)