1 /**
2 * \file xf86drm.h
3 * OS-independent header for DRM user-level library interface.
4 *
5 * \author Rickard E. (Rik) Faith <faith@valinux.com>
6 */
8 /*
9 * Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
10 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
11 * All Rights Reserved.
12 *
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:
19 *
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
22 * Software.
23 *
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.
31 *
32 */
34 #ifndef _XF86DRM_H_
35 #define _XF86DRM_H_
37 #include <stdarg.h>
38 #include <sys/types.h>
39 #include <stdint.h>
40 #include <drm.h>
42 /* Defaults, if nothing set in xf86config */
43 #define DRM_DEV_UID 0
44 #define DRM_DEV_GID 0
45 /* Default /dev/dri directory permissions 0755 */
46 #define DRM_DEV_DIRMODE \
47 (S_IRUSR|S_IWUSR|S_IXUSR|S_IRGRP|S_IXGRP|S_IROTH|S_IXOTH)
48 #define DRM_DEV_MODE (S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP)
50 #define DRM_DIR_NAME "/dev/dri"
51 #define DRM_DEV_NAME "%s/card%d"
52 #define DRM_CONTROL_DEV_NAME "%s/controlD%d"
53 #define DRM_PROC_NAME "/proc/dri/" /* For backward Linux compatibility */
55 #define DRM_ERR_NO_DEVICE (-1001)
56 #define DRM_ERR_NO_ACCESS (-1002)
57 #define DRM_ERR_NOT_ROOT (-1003)
58 #define DRM_ERR_INVALID (-1004)
59 #define DRM_ERR_NO_FD (-1005)
61 #define DRM_AGP_NO_HANDLE 0
63 typedef unsigned int drmSize, *drmSizePtr; /**< For mapped regions */
64 typedef void *drmAddress, **drmAddressPtr; /**< For mapped regions */
66 typedef struct _drmServerInfo {
67 int (*debug_print)(const char *format, va_list ap);
68 int (*load_module)(const char *name);
69 void (*get_perms)(gid_t *, mode_t *);
70 } drmServerInfo, *drmServerInfoPtr;
72 typedef struct drmHashEntry {
73 int fd;
74 void (*f)(int, void *, void *);
75 void *tagTable;
76 } drmHashEntry;
78 extern int drmIoctl(int fd, unsigned long request, void *arg);
79 extern void *drmGetHashTable(void);
80 extern drmHashEntry *drmGetEntry(int fd);
82 /**
83 * Driver version information.
84 *
85 * \sa drmGetVersion() and drmSetVersion().
86 */
87 typedef struct _drmVersion {
88 int version_major; /**< Major version */
89 int version_minor; /**< Minor version */
90 int version_patchlevel; /**< Patch level */
91 int name_len; /**< Length of name buffer */
92 char *name; /**< Name of driver */
93 int date_len; /**< Length of date buffer */
94 char *date; /**< User-space buffer to hold date */
95 int desc_len; /**< Length of desc buffer */
96 char *desc; /**< User-space buffer to hold desc */
97 } drmVersion, *drmVersionPtr;
99 typedef struct _drmStats {
100 unsigned long count; /**< Number of data */
101 struct {
102 unsigned long value; /**< Value from kernel */
103 const char *long_format; /**< Suggested format for long_name */
104 const char *long_name; /**< Long name for value */
105 const char *rate_format; /**< Suggested format for rate_name */
106 const char *rate_name; /**< Short name for value per second */
107 int isvalue; /**< True if value (vs. counter) */
108 const char *mult_names; /**< Multiplier names (e.g., "KGM") */
109 int mult; /**< Multiplier value (e.g., 1024) */
110 int verbose; /**< Suggest only in verbose output */
111 } data[15];
112 } drmStatsT;
115 /* All of these enums *MUST* match with the
116 kernel implementation -- so do *NOT*
117 change them! (The drmlib implementation
118 will just copy the flags instead of
119 translating them.) */
120 typedef enum {
121 DRM_FRAME_BUFFER = 0, /**< WC, no caching, no core dump */
122 DRM_REGISTERS = 1, /**< no caching, no core dump */
123 DRM_SHM = 2, /**< shared, cached */
124 DRM_AGP = 3, /**< AGP/GART */
125 DRM_SCATTER_GATHER = 4, /**< PCI scatter/gather */
126 DRM_CONSISTENT = 5 /**< PCI consistent */
127 } drmMapType;
129 typedef enum {
130 DRM_RESTRICTED = 0x0001, /**< Cannot be mapped to client-virtual */
131 DRM_READ_ONLY = 0x0002, /**< Read-only in client-virtual */
132 DRM_LOCKED = 0x0004, /**< Physical pages locked */
133 DRM_KERNEL = 0x0008, /**< Kernel requires access */
134 DRM_WRITE_COMBINING = 0x0010, /**< Use write-combining, if available */
135 DRM_CONTAINS_LOCK = 0x0020, /**< SHM page that contains lock */
136 DRM_REMOVABLE = 0x0040 /**< Removable mapping */
137 } drmMapFlags;
139 /**
140 * \warning These values *MUST* match drm.h
141 */
142 typedef enum {
143 /** \name Flags for DMA buffer dispatch */
144 /*@{*/
145 DRM_DMA_BLOCK = 0x01, /**<
146 * Block until buffer dispatched.
147 *
148 * \note the buffer may not yet have been
149 * processed by the hardware -- getting a
150 * hardware lock with the hardware quiescent
151 * will ensure that the buffer has been
152 * processed.
153 */
154 DRM_DMA_WHILE_LOCKED = 0x02, /**< Dispatch while lock held */
155 DRM_DMA_PRIORITY = 0x04, /**< High priority dispatch */
156 /*@}*/
158 /** \name Flags for DMA buffer request */
159 /*@{*/
160 DRM_DMA_WAIT = 0x10, /**< Wait for free buffers */
161 DRM_DMA_SMALLER_OK = 0x20, /**< Smaller-than-requested buffers OK */
162 DRM_DMA_LARGER_OK = 0x40 /**< Larger-than-requested buffers OK */
163 /*@}*/
164 } drmDMAFlags;
166 typedef enum {
167 DRM_PAGE_ALIGN = 0x01,
168 DRM_AGP_BUFFER = 0x02,
169 DRM_SG_BUFFER = 0x04,
170 DRM_FB_BUFFER = 0x08,
171 DRM_PCI_BUFFER_RO = 0x10
172 } drmBufDescFlags;
174 typedef enum {
175 DRM_LOCK_READY = 0x01, /**< Wait until hardware is ready for DMA */
176 DRM_LOCK_QUIESCENT = 0x02, /**< Wait until hardware quiescent */
177 DRM_LOCK_FLUSH = 0x04, /**< Flush this context's DMA queue first */
178 DRM_LOCK_FLUSH_ALL = 0x08, /**< Flush all DMA queues first */
179 /* These *HALT* flags aren't supported yet
180 -- they will be used to support the
181 full-screen DGA-like mode. */
182 DRM_HALT_ALL_QUEUES = 0x10, /**< Halt all current and future queues */
183 DRM_HALT_CUR_QUEUES = 0x20 /**< Halt all current queues */
184 } drmLockFlags;
186 typedef enum {
187 DRM_CONTEXT_PRESERVED = 0x01, /**< This context is preserved and
188 never swapped. */
189 DRM_CONTEXT_2DONLY = 0x02 /**< This context is for 2D rendering only. */
190 } drm_context_tFlags, *drm_context_tFlagsPtr;
192 typedef struct _drmBufDesc {
193 int count; /**< Number of buffers of this size */
194 int size; /**< Size in bytes */
195 int low_mark; /**< Low water mark */
196 int high_mark; /**< High water mark */
197 } drmBufDesc, *drmBufDescPtr;
199 typedef struct _drmBufInfo {
200 int count; /**< Number of buffers described in list */
201 drmBufDescPtr list; /**< List of buffer descriptions */
202 } drmBufInfo, *drmBufInfoPtr;
204 typedef struct _drmBuf {
205 int idx; /**< Index into the master buffer list */
206 int total; /**< Buffer size */
207 int used; /**< Amount of buffer in use (for DMA) */
208 drmAddress address; /**< Address */
209 } drmBuf, *drmBufPtr;
211 /**
212 * Buffer mapping information.
213 *
214 * Used by drmMapBufs() and drmUnmapBufs() to store information about the
215 * mapped buffers.
216 */
217 typedef struct _drmBufMap {
218 int count; /**< Number of buffers mapped */
219 drmBufPtr list; /**< Buffers */
220 } drmBufMap, *drmBufMapPtr;
222 typedef struct _drmLock {
223 volatile unsigned int lock;
224 char padding[60];
225 /* This is big enough for most current (and future?) architectures:
226 DEC Alpha: 32 bytes
227 Intel Merced: ?
228 Intel P5/PPro/PII/PIII: 32 bytes
229 Intel StrongARM: 32 bytes
230 Intel i386/i486: 16 bytes
231 MIPS: 32 bytes (?)
232 Motorola 68k: 16 bytes
233 Motorola PowerPC: 32 bytes
234 Sun SPARC: 32 bytes
235 */
236 } drmLock, *drmLockPtr;
238 /**
239 * Indices here refer to the offset into
240 * list in drmBufInfo
241 */
242 typedef struct _drmDMAReq {
243 drm_context_t context; /**< Context handle */
244 int send_count; /**< Number of buffers to send */
245 int *send_list; /**< List of handles to buffers */
246 int *send_sizes; /**< Lengths of data to send, in bytes */
247 drmDMAFlags flags; /**< Flags */
248 int request_count; /**< Number of buffers requested */
249 int request_size; /**< Desired size of buffers requested */
250 int *request_list; /**< Buffer information */
251 int *request_sizes; /**< Minimum acceptable sizes */
252 int granted_count; /**< Number of buffers granted at this size */
253 } drmDMAReq, *drmDMAReqPtr;
255 typedef struct _drmRegion {
256 drm_handle_t handle;
257 unsigned int offset;
258 drmSize size;
259 drmAddress map;
260 } drmRegion, *drmRegionPtr;
262 typedef struct _drmTextureRegion {
263 unsigned char next;
264 unsigned char prev;
265 unsigned char in_use;
266 unsigned char padding; /**< Explicitly pad this out */
267 unsigned int age;
268 } drmTextureRegion, *drmTextureRegionPtr;
271 typedef enum {
272 DRM_VBLANK_ABSOLUTE = 0x0, /**< Wait for specific vblank sequence number */
273 DRM_VBLANK_RELATIVE = 0x1, /**< Wait for given number of vblanks */
274 DRM_VBLANK_EVENT = 0x4000000, /**< Send event instead of blocking */
275 DRM_VBLANK_FLIP = 0x8000000, /**< Scheduled buffer swap should flip */
276 DRM_VBLANK_NEXTONMISS = 0x10000000, /**< If missed, wait for next vblank */
277 DRM_VBLANK_SECONDARY = 0x20000000, /**< Secondary display controller */
278 DRM_VBLANK_SIGNAL = 0x40000000 /* Send signal instead of blocking */
279 } drmVBlankSeqType;
281 typedef struct _drmVBlankReq {
282 drmVBlankSeqType type;
283 unsigned int sequence;
284 unsigned long signal;
285 } drmVBlankReq, *drmVBlankReqPtr;
287 typedef struct _drmVBlankReply {
288 drmVBlankSeqType type;
289 unsigned int sequence;
290 long tval_sec;
291 long tval_usec;
292 } drmVBlankReply, *drmVBlankReplyPtr;
294 typedef union _drmVBlank {
295 drmVBlankReq request;
296 drmVBlankReply reply;
297 } drmVBlank, *drmVBlankPtr;
299 typedef struct _drmSetVersion {
300 int drm_di_major;
301 int drm_di_minor;
302 int drm_dd_major;
303 int drm_dd_minor;
304 } drmSetVersion, *drmSetVersionPtr;
306 #define __drm_dummy_lock(lock) (*(__volatile__ unsigned int *)lock)
308 #define DRM_LOCK_HELD 0x80000000U /**< Hardware lock is held */
309 #define DRM_LOCK_CONT 0x40000000U /**< Hardware lock is contended */
311 #if defined(__GNUC__) && (__GNUC__ >= 2)
312 # if defined(__i386) || defined(__AMD64__) || defined(__x86_64__) || defined(__amd64__)
313 /* Reflect changes here to drmP.h */
314 #define DRM_CAS(lock,old,new,__ret) \
315 do { \
316 int __dummy; /* Can't mark eax as clobbered */ \
317 __asm__ __volatile__( \
318 "lock ; cmpxchg %4,%1\n\t" \
319 "setnz %0" \
320 : "=d" (__ret), \
321 "=m" (__drm_dummy_lock(lock)), \
322 "=a" (__dummy) \
323 : "2" (old), \
324 "r" (new)); \
325 } while (0)
327 #elif defined(__alpha__)
329 #define DRM_CAS(lock, old, new, ret) \
330 do { \
331 int tmp, old32; \
332 __asm__ __volatile__( \
333 " addl $31, %5, %3\n" \
334 "1: ldl_l %0, %2\n" \
335 " cmpeq %0, %3, %1\n" \
336 " beq %1, 2f\n" \
337 " mov %4, %0\n" \
338 " stl_c %0, %2\n" \
339 " beq %0, 3f\n" \
340 " mb\n" \
341 "2: cmpeq %1, 0, %1\n" \
342 ".subsection 2\n" \
343 "3: br 1b\n" \
344 ".previous" \
345 : "=&r"(tmp), "=&r"(ret), \
346 "=m"(__drm_dummy_lock(lock)), \
347 "=&r"(old32) \
348 : "r"(new), "r"(old) \
349 : "memory"); \
350 } while (0)
352 #elif defined(__sparc__)
354 #define DRM_CAS(lock,old,new,__ret) \
355 do { register unsigned int __old __asm("o0"); \
356 register unsigned int __new __asm("o1"); \
357 register volatile unsigned int *__lock __asm("o2"); \
358 __old = old; \
359 __new = new; \
360 __lock = (volatile unsigned int *)lock; \
361 __asm__ __volatile__( \
362 /*"cas [%2], %3, %0"*/ \
363 ".word 0xd3e29008\n\t" \
364 /*"membar #StoreStore | #StoreLoad"*/ \
365 ".word 0x8143e00a" \
366 : "=&r" (__new) \
367 : "0" (__new), \
368 "r" (__lock), \
369 "r" (__old) \
370 : "memory"); \
371 __ret = (__new != __old); \
372 } while(0)
374 #elif defined(__ia64__)
376 #ifdef __INTEL_COMPILER
377 /* this currently generates bad code (missing stop bits)... */
378 #include <ia64intrin.h>
380 #define DRM_CAS(lock,old,new,__ret) \
381 do { \
382 unsigned long __result, __old = (old) & 0xffffffff; \
383 __mf(); \
384 __result = _InterlockedCompareExchange_acq(&__drm_dummy_lock(lock), (new), __old);\
385 __ret = (__result) != (__old); \
386 /* __ret = (__sync_val_compare_and_swap(&__drm_dummy_lock(lock), \
387 (old), (new)) \
388 != (old)); */\
389 } while (0)
391 #else
392 #define DRM_CAS(lock,old,new,__ret) \
393 do { \
394 unsigned int __result, __old = (old); \
395 __asm__ __volatile__( \
396 "mf\n" \
397 "mov ar.ccv=%2\n" \
398 ";;\n" \
399 "cmpxchg4.acq %0=%1,%3,ar.ccv" \
400 : "=r" (__result), "=m" (__drm_dummy_lock(lock)) \
401 : "r" ((unsigned long)__old), "r" (new) \
402 : "memory"); \
403 __ret = (__result) != (__old); \
404 } while (0)
406 #endif
408 #elif defined(__powerpc__)
410 #define DRM_CAS(lock,old,new,__ret) \
411 do { \
412 __asm__ __volatile__( \
413 "sync;" \
414 "0: lwarx %0,0,%1;" \
415 " xor. %0,%3,%0;" \
416 " bne 1f;" \
417 " stwcx. %2,0,%1;" \
418 " bne- 0b;" \
419 "1: " \
420 "sync;" \
421 : "=&r"(__ret) \
422 : "r"(lock), "r"(new), "r"(old) \
423 : "cr0", "memory"); \
424 } while (0)
426 #endif /* architecture */
427 #endif /* __GNUC__ >= 2 */
429 #ifndef DRM_CAS
430 #define DRM_CAS(lock,old,new,ret) do { ret=1; } while (0) /* FAST LOCK FAILS */
431 #endif
433 #if defined(__alpha__)
434 #define DRM_CAS_RESULT(_result) long _result
435 #elif defined(__powerpc__)
436 #define DRM_CAS_RESULT(_result) int _result
437 #else
438 #define DRM_CAS_RESULT(_result) char _result
439 #endif
441 #define DRM_LIGHT_LOCK(fd,lock,context) \
442 do { \
443 DRM_CAS_RESULT(__ret); \
444 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \
445 if (__ret) drmGetLock(fd,context,0); \
446 } while(0)
448 /* This one counts fast locks -- for
449 benchmarking only. */
450 #define DRM_LIGHT_LOCK_COUNT(fd,lock,context,count) \
451 do { \
452 DRM_CAS_RESULT(__ret); \
453 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \
454 if (__ret) drmGetLock(fd,context,0); \
455 else ++count; \
456 } while(0)
458 #define DRM_LOCK(fd,lock,context,flags) \
459 do { \
460 if (flags) drmGetLock(fd,context,flags); \
461 else DRM_LIGHT_LOCK(fd,lock,context); \
462 } while(0)
464 #define DRM_UNLOCK(fd,lock,context) \
465 do { \
466 DRM_CAS_RESULT(__ret); \
467 DRM_CAS(lock,DRM_LOCK_HELD|context,context,__ret); \
468 if (__ret) drmUnlock(fd,context); \
469 } while(0)
471 /* Simple spin locks */
472 #define DRM_SPINLOCK(spin,val) \
473 do { \
474 DRM_CAS_RESULT(__ret); \
475 do { \
476 DRM_CAS(spin,0,val,__ret); \
477 if (__ret) while ((spin)->lock); \
478 } while (__ret); \
479 } while(0)
481 #define DRM_SPINLOCK_TAKE(spin,val) \
482 do { \
483 DRM_CAS_RESULT(__ret); \
484 int cur; \
485 do { \
486 cur = (*spin).lock; \
487 DRM_CAS(spin,cur,val,__ret); \
488 } while (__ret); \
489 } while(0)
491 #define DRM_SPINLOCK_COUNT(spin,val,count,__ret) \
492 do { \
493 int __i; \
494 __ret = 1; \
495 for (__i = 0; __ret && __i < count; __i++) { \
496 DRM_CAS(spin,0,val,__ret); \
497 if (__ret) for (;__i < count && (spin)->lock; __i++); \
498 } \
499 } while(0)
501 #define DRM_SPINUNLOCK(spin,val) \
502 do { \
503 DRM_CAS_RESULT(__ret); \
504 if ((*spin).lock == val) { /* else server stole lock */ \
505 do { \
506 DRM_CAS(spin,val,0,__ret); \
507 } while (__ret); \
508 } \
509 } while(0)
513 /* General user-level programmer's API: unprivileged */
514 extern int drmAvailable(void);
515 extern int drmOpen(const char *name, const char *busid);
516 extern int drmOpenControl(int minor);
517 extern int drmClose(int fd);
518 extern drmVersionPtr drmGetVersion(int fd);
519 extern drmVersionPtr drmGetLibVersion(int fd);
520 extern void drmFreeVersion(drmVersionPtr);
521 extern int drmGetMagic(int fd, drm_magic_t * magic);
522 extern char *drmGetBusid(int fd);
523 extern int drmGetInterruptFromBusID(int fd, int busnum, int devnum,
524 int funcnum);
525 extern int drmGetMap(int fd, int idx, drm_handle_t *offset,
526 drmSize *size, drmMapType *type,
527 drmMapFlags *flags, drm_handle_t *handle,
528 int *mtrr);
529 extern int drmGetClient(int fd, int idx, int *auth, int *pid,
530 int *uid, unsigned long *magic,
531 unsigned long *iocs);
532 extern int drmGetStats(int fd, drmStatsT *stats);
533 extern int drmSetInterfaceVersion(int fd, drmSetVersion *version);
534 extern int drmCommandNone(int fd, unsigned long drmCommandIndex);
535 extern int drmCommandRead(int fd, unsigned long drmCommandIndex,
536 void *data, unsigned long size);
537 extern int drmCommandWrite(int fd, unsigned long drmCommandIndex,
538 void *data, unsigned long size);
539 extern int drmCommandWriteRead(int fd, unsigned long drmCommandIndex,
540 void *data, unsigned long size);
542 /* General user-level programmer's API: X server (root) only */
543 extern void drmFreeBusid(const char *busid);
544 extern int drmSetBusid(int fd, const char *busid);
545 extern int drmAuthMagic(int fd, drm_magic_t magic);
546 extern int drmAddMap(int fd,
547 drm_handle_t offset,
548 drmSize size,
549 drmMapType type,
550 drmMapFlags flags,
551 drm_handle_t * handle);
552 extern int drmRmMap(int fd, drm_handle_t handle);
553 extern int drmAddContextPrivateMapping(int fd, drm_context_t ctx_id,
554 drm_handle_t handle);
556 extern int drmAddBufs(int fd, int count, int size,
557 drmBufDescFlags flags,
558 int agp_offset);
559 extern int drmMarkBufs(int fd, double low, double high);
560 extern int drmCreateContext(int fd, drm_context_t * handle);
561 extern int drmSetContextFlags(int fd, drm_context_t context,
562 drm_context_tFlags flags);
563 extern int drmGetContextFlags(int fd, drm_context_t context,
564 drm_context_tFlagsPtr flags);
565 extern int drmAddContextTag(int fd, drm_context_t context, void *tag);
566 extern int drmDelContextTag(int fd, drm_context_t context);
567 extern void *drmGetContextTag(int fd, drm_context_t context);
568 extern drm_context_t * drmGetReservedContextList(int fd, int *count);
569 extern void drmFreeReservedContextList(drm_context_t *);
570 extern int drmSwitchToContext(int fd, drm_context_t context);
571 extern int drmDestroyContext(int fd, drm_context_t handle);
572 extern int drmCreateDrawable(int fd, drm_drawable_t * handle);
573 extern int drmDestroyDrawable(int fd, drm_drawable_t handle);
574 extern int drmUpdateDrawableInfo(int fd, drm_drawable_t handle,
575 drm_drawable_info_type_t type,
576 unsigned int num, void *data);
577 extern int drmCtlInstHandler(int fd, int irq);
578 extern int drmCtlUninstHandler(int fd);
580 /* General user-level programmer's API: authenticated client and/or X */
581 extern int drmMap(int fd,
582 drm_handle_t handle,
583 drmSize size,
584 drmAddressPtr address);
585 extern int drmUnmap(drmAddress address, drmSize size);
586 extern drmBufInfoPtr drmGetBufInfo(int fd);
587 extern drmBufMapPtr drmMapBufs(int fd);
588 extern int drmUnmapBufs(drmBufMapPtr bufs);
589 extern int drmDMA(int fd, drmDMAReqPtr request);
590 extern int drmFreeBufs(int fd, int count, int *list);
591 extern int drmGetLock(int fd,
592 drm_context_t context,
593 drmLockFlags flags);
594 extern int drmUnlock(int fd, drm_context_t context);
595 extern int drmFinish(int fd, int context, drmLockFlags flags);
596 extern int drmGetContextPrivateMapping(int fd, drm_context_t ctx_id,
597 drm_handle_t * handle);
599 /* AGP/GART support: X server (root) only */
600 extern int drmAgpAcquire(int fd);
601 extern int drmAgpRelease(int fd);
602 extern int drmAgpEnable(int fd, unsigned long mode);
603 extern int drmAgpAlloc(int fd, unsigned long size,
604 unsigned long type, unsigned long *address,
605 drm_handle_t *handle);
606 extern int drmAgpFree(int fd, drm_handle_t handle);
607 extern int drmAgpBind(int fd, drm_handle_t handle,
608 unsigned long offset);
609 extern int drmAgpUnbind(int fd, drm_handle_t handle);
611 /* AGP/GART info: authenticated client and/or X */
612 extern int drmAgpVersionMajor(int fd);
613 extern int drmAgpVersionMinor(int fd);
614 extern unsigned long drmAgpGetMode(int fd);
615 extern unsigned long drmAgpBase(int fd); /* Physical location */
616 extern unsigned long drmAgpSize(int fd); /* Bytes */
617 extern unsigned long drmAgpMemoryUsed(int fd);
618 extern unsigned long drmAgpMemoryAvail(int fd);
619 extern unsigned int drmAgpVendorId(int fd);
620 extern unsigned int drmAgpDeviceId(int fd);
622 /* PCI scatter/gather support: X server (root) only */
623 extern int drmScatterGatherAlloc(int fd, unsigned long size,
624 drm_handle_t *handle);
625 extern int drmScatterGatherFree(int fd, drm_handle_t handle);
627 extern int drmWaitVBlank(int fd, drmVBlankPtr vbl);
629 /* Support routines */
630 extern void drmSetServerInfo(drmServerInfoPtr info);
631 extern int drmError(int err, const char *label);
632 extern void *drmMalloc(int size);
633 extern void drmFree(void *pt);
635 /* Hash table routines */
636 extern void *drmHashCreate(void);
637 extern int drmHashDestroy(void *t);
638 extern int drmHashLookup(void *t, unsigned long key, void **value);
639 extern int drmHashInsert(void *t, unsigned long key, void *value);
640 extern int drmHashDelete(void *t, unsigned long key);
641 extern int drmHashFirst(void *t, unsigned long *key, void **value);
642 extern int drmHashNext(void *t, unsigned long *key, void **value);
644 /* PRNG routines */
645 extern void *drmRandomCreate(unsigned long seed);
646 extern int drmRandomDestroy(void *state);
647 extern unsigned long drmRandom(void *state);
648 extern double drmRandomDouble(void *state);
650 /* Skip list routines */
652 extern void *drmSLCreate(void);
653 extern int drmSLDestroy(void *l);
654 extern int drmSLLookup(void *l, unsigned long key, void **value);
655 extern int drmSLInsert(void *l, unsigned long key, void *value);
656 extern int drmSLDelete(void *l, unsigned long key);
657 extern int drmSLNext(void *l, unsigned long *key, void **value);
658 extern int drmSLFirst(void *l, unsigned long *key, void **value);
659 extern void drmSLDump(void *l);
660 extern int drmSLLookupNeighbors(void *l, unsigned long key,
661 unsigned long *prev_key, void **prev_value,
662 unsigned long *next_key, void **next_value);
664 extern int drmOpenOnce(void *unused, const char *BusID, int *newlyopened);
665 extern void drmCloseOnce(int fd);
666 extern void drmMsg(const char *format, ...);
668 extern int drmSetMaster(int fd);
669 extern int drmDropMaster(int fd);
671 #define DRM_EVENT_CONTEXT_VERSION 1
673 typedef struct _drmEventContext {
675 /* This struct is versioned so we can add more pointers if we
676 * add more events. */
677 int version;
679 void (*vblank_handler)(int fd,
680 unsigned int sequence,
681 unsigned int tv_sec,
682 unsigned int tv_usec,
683 void *user_data);
685 } drmEventContext, *drmEventContextPtr;
687 extern int drmHandleEvent(int fd, drmEventContextPtr evctx);
689 #endif