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 */ 7 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 */ 33 34 #ifndef _XF86DRM_H_ 35 #define _XF86DRM_H_ 36 37 #include <stdarg.h> 38 #include <sys/types.h> 39 #include <stdint.h> 40 #include "drm.h" 41 #include "libdrm_macros.h" 42 #if defined(__cplusplus) 43 extern "C" { 44 #endif 45 46 #ifndef DRM_MAX_MINOR 47 #define DRM_MAX_MINOR 16 48 #endif 49 50 #if defined(__linux__) 51 52 #define DRM_IOCTL_NR(n) _IOC_NR(n) 53 #define DRM_IOC_VOID _IOC_NONE 54 #define DRM_IOC_READ _IOC_READ 55 #define DRM_IOC_WRITE _IOC_WRITE 56 #define DRM_IOC_READWRITE _IOC_READ|_IOC_WRITE 57 #define DRM_IOC(dir, group, nr, size) _IOC(dir, group, nr, size) 58 59 #else /* One of the *BSDs */ 60 61 #include <sys/ioccom.h> 62 #define DRM_IOCTL_NR(n) ((n) & 0xff) 63 #define DRM_IOC_VOID IOC_VOID 64 #define DRM_IOC_READ IOC_OUT 65 #define DRM_IOC_WRITE IOC_IN 66 #define DRM_IOC_READWRITE IOC_INOUT 67 #define DRM_IOC(dir, group, nr, size) _IOC(dir, group, nr, size) 68 69 #endif 70 71 /* Defaults, if nothing set in xf86config */ 72 #define DRM_DEV_UID 0 73 #define DRM_DEV_GID 0 74 /* Default /dev/dri directory permissions 0755 */ 75 #define DRM_DEV_DIRMODE \ 76 (S_IRUSR|S_IWUSR|S_IXUSR|S_IRGRP|S_IXGRP|S_IROTH|S_IXOTH) 77 #define DRM_DEV_MODE (S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP) 78 79 #ifdef __OpenBSD__ 80 #define DRM_DIR_NAME "/dev" 81 #define DRM_DEV_NAME "%s/drm%d" 82 #define DRM_CONTROL_DEV_NAME "%s/drmC%d" 83 #define DRM_RENDER_DEV_NAME "%s/drmR%d" 84 #else 85 #define DRM_DIR_NAME "/dev/dri" 86 #define DRM_DEV_NAME "%s/card%d" 87 #define DRM_CONTROL_DEV_NAME "%s/controlD%d" 88 #define DRM_RENDER_DEV_NAME "%s/renderD%d" 89 #define DRM_PROC_NAME "/proc/dri/" /* For backward Linux compatibility */ 90 #endif 91 92 #define DRM_ERR_NO_DEVICE (-1001) 93 #define DRM_ERR_NO_ACCESS (-1002) 94 #define DRM_ERR_NOT_ROOT (-1003) 95 #define DRM_ERR_INVALID (-1004) 96 #define DRM_ERR_NO_FD (-1005) 97 98 #define DRM_AGP_NO_HANDLE 0 99 100 typedef unsigned int drmSize, *drmSizePtr; /**< For mapped regions */ 101 typedef void *drmAddress, **drmAddressPtr; /**< For mapped regions */ 102 103 #if (__GNUC__ >= 3) 104 #define DRM_PRINTFLIKE(f, a) __attribute__ ((format(__printf__, f, a))) 105 #else 106 #define DRM_PRINTFLIKE(f, a) 107 #endif 108 109 typedef struct _drmServerInfo { 110 int (*debug_print)(const char *format, va_list ap) DRM_PRINTFLIKE(1,0); 111 int (*load_module)(const char *name); 112 void (*get_perms)(gid_t *, mode_t *); 113 } drmServerInfo, *drmServerInfoPtr; 114 115 typedef struct drmHashEntry { 116 int fd; 117 void (*f)(int, void *, void *); 118 void *tagTable; 119 } drmHashEntry; 120 121 extern drm_export int mosdrmIoctl(int fd, unsigned long request, void *arg); 122 extern drm_export int drmIoctl(int fd, unsigned long request, void *arg); 123 extern void *drmGetHashTable(void); 124 extern drmHashEntry *drmGetEntry(int fd); 125 126 /** 127 * Driver version information. 128 * 129 * \sa drmGetVersion() and drmSetVersion(). 130 */ 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; 142 143 typedef struct _drmStats { 144 unsigned long count; /**< Number of data */ 145 struct { 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 */ 155 } data[15]; 156 } drmStatsT; 157 158 /* All of these enums *MUST* match with the 159 kernel implementation -- so do *NOT* 160 change them! (The drmlib implementation 161 will just copy the flags instead of 162 translating them.) */ 163 typedef enum { 164 DRM_FRAME_BUFFER = 0, /**< WC, no caching, no core dump */ 165 DRM_REGISTERS = 1, /**< no caching, no core dump */ 166 DRM_SHM = 2, /**< shared, cached */ 167 DRM_AGP = 3, /**< AGP/GART */ 168 DRM_SCATTER_GATHER = 4, /**< PCI scatter/gather */ 169 DRM_CONSISTENT = 5 /**< PCI consistent */ 170 } drmMapType; 171 172 typedef enum { 173 DRM_RESTRICTED = 0x0001, /**< Cannot be mapped to client-virtual */ 174 DRM_READ_ONLY = 0x0002, /**< Read-only in client-virtual */ 175 DRM_LOCKED = 0x0004, /**< Physical pages locked */ 176 DRM_KERNEL = 0x0008, /**< Kernel requires access */ 177 DRM_WRITE_COMBINING = 0x0010, /**< Use write-combining, if available */ 178 DRM_CONTAINS_LOCK = 0x0020, /**< SHM page that contains lock */ 179 DRM_REMOVABLE = 0x0040 /**< Removable mapping */ 180 } drmMapFlags; 181 182 /** 183 * \warning These values *MUST* match drm.h 184 */ 185 typedef enum { 186 /** \name Flags for DMA buffer dispatch */ 187 /*@{*/ 188 DRM_DMA_BLOCK = 0x01, /**< 189 * Block until buffer dispatched. 190 * 191 * \note the buffer may not yet have been 192 * processed by the hardware -- getting a 193 * hardware lock with the hardware quiescent 194 * will ensure that the buffer has been 195 * processed. 196 */ 197 DRM_DMA_WHILE_LOCKED = 0x02, /**< Dispatch while lock held */ 198 DRM_DMA_PRIORITY = 0x04, /**< High priority dispatch */ 199 /*@}*/ 200 201 /** \name Flags for DMA buffer request */ 202 /*@{*/ 203 DRM_DMA_WAIT = 0x10, /**< Wait for free buffers */ 204 DRM_DMA_SMALLER_OK = 0x20, /**< Smaller-than-requested buffers OK */ 205 DRM_DMA_LARGER_OK = 0x40 /**< Larger-than-requested buffers OK */ 206 /*@}*/ 207 } drmDMAFlags; 208 209 typedef enum { 210 DRM_PAGE_ALIGN = 0x01, 211 DRM_AGP_BUFFER = 0x02, 212 DRM_SG_BUFFER = 0x04, 213 DRM_FB_BUFFER = 0x08, 214 DRM_PCI_BUFFER_RO = 0x10 215 } drmBufDescFlags; 216 217 typedef enum { 218 DRM_LOCK_READY = 0x01, /**< Wait until hardware is ready for DMA */ 219 DRM_LOCK_QUIESCENT = 0x02, /**< Wait until hardware quiescent */ 220 DRM_LOCK_FLUSH = 0x04, /**< Flush this context's DMA queue first */ 221 DRM_LOCK_FLUSH_ALL = 0x08, /**< Flush all DMA queues first */ 222 /* These *HALT* flags aren't supported yet 223 -- they will be used to support the 224 full-screen DGA-like mode. */ 225 DRM_HALT_ALL_QUEUES = 0x10, /**< Halt all current and future queues */ 226 DRM_HALT_CUR_QUEUES = 0x20 /**< Halt all current queues */ 227 } drmLockFlags; 228 229 typedef enum { 230 DRM_CONTEXT_PRESERVED = 0x01, /**< This context is preserved and 231 never swapped. */ 232 DRM_CONTEXT_2DONLY = 0x02 /**< This context is for 2D rendering only. */ 233 } drm_context_tFlags, *drm_context_tFlagsPtr; 234 235 typedef struct _drmBufDesc { 236 int count; /**< Number of buffers of this size */ 237 int size; /**< Size in bytes */ 238 int low_mark; /**< Low water mark */ 239 int high_mark; /**< High water mark */ 240 } drmBufDesc, *drmBufDescPtr; 241 242 typedef struct _drmBufInfo { 243 int count; /**< Number of buffers described in list */ 244 drmBufDescPtr list; /**< List of buffer descriptions */ 245 } drmBufInfo, *drmBufInfoPtr; 246 247 typedef struct _drmBuf { 248 int idx; /**< Index into the master buffer list */ 249 int total; /**< Buffer size */ 250 int used; /**< Amount of buffer in use (for DMA) */ 251 drmAddress address; /**< Address */ 252 } drmBuf, *drmBufPtr; 253 254 /** 255 * Buffer mapping information. 256 * 257 * Used by drmMapBufs() and drmUnmapBufs() to store information about the 258 * mapped buffers. 259 */ 260 typedef struct _drmBufMap { 261 int count; /**< Number of buffers mapped */ 262 drmBufPtr list; /**< Buffers */ 263 } drmBufMap, *drmBufMapPtr; 264 265 typedef struct _drmLock { 266 volatile unsigned int lock; 267 char padding[60]; 268 } drmLock, *drmLockPtr; 269 270 /** 271 * Indices here refer to the offset into 272 * list in drmBufInfo 273 */ 274 typedef struct _drmDMAReq { 275 drm_context_t context; /**< Context handle */ 276 int send_count; /**< Number of buffers to send */ 277 int *send_list; /**< List of handles to buffers */ 278 int *send_sizes; /**< Lengths of data to send, in bytes */ 279 drmDMAFlags flags; /**< Flags */ 280 int request_count; /**< Number of buffers requested */ 281 int request_size; /**< Desired size of buffers requested */ 282 int *request_list; /**< Buffer information */ 283 int *request_sizes; /**< Minimum acceptable sizes */ 284 int granted_count; /**< Number of buffers granted at this size */ 285 } drmDMAReq, *drmDMAReqPtr; 286 287 typedef struct _drmRegion { 288 drm_handle_t handle; 289 unsigned int offset; 290 drmSize size; 291 drmAddress map; 292 } drmRegion, *drmRegionPtr; 293 294 typedef struct _drmTextureRegion { 295 unsigned char next; 296 unsigned char prev; 297 unsigned char in_use; 298 unsigned char padding; /**< Explicitly pad this out */ 299 unsigned int age; 300 } drmTextureRegion, *drmTextureRegionPtr; 301 302 typedef enum { 303 DRM_VBLANK_ABSOLUTE = 0x0, /**< Wait for specific vblank sequence number */ 304 DRM_VBLANK_RELATIVE = 0x1, /**< Wait for given number of vblanks */ 305 /* bits 1-6 are reserved for high crtcs */ 306 DRM_VBLANK_HIGH_CRTC_MASK = 0x0000003e, 307 DRM_VBLANK_EVENT = 0x4000000, /**< Send event instead of blocking */ 308 DRM_VBLANK_FLIP = 0x8000000, /**< Scheduled buffer swap should flip */ 309 DRM_VBLANK_NEXTONMISS = 0x10000000, /**< If missed, wait for next vblank */ 310 DRM_VBLANK_SECONDARY = 0x20000000, /**< Secondary display controller */ 311 DRM_VBLANK_SIGNAL = 0x40000000 /* Send signal instead of blocking */ 312 } drmVBlankSeqType; 313 #define DRM_VBLANK_HIGH_CRTC_SHIFT 1 314 315 typedef struct _drmVBlankReq { 316 drmVBlankSeqType type; 317 unsigned int sequence; 318 unsigned long signal; 319 } drmVBlankReq, *drmVBlankReqPtr; 320 321 typedef struct _drmVBlankReply { 322 drmVBlankSeqType type; 323 unsigned int sequence; 324 long tval_sec; 325 long tval_usec; 326 } drmVBlankReply, *drmVBlankReplyPtr; 327 328 typedef union _drmVBlank { 329 drmVBlankReq request; 330 drmVBlankReply reply; 331 } drmVBlank, *drmVBlankPtr; 332 333 typedef struct _drmSetVersion { 334 int drm_di_major; 335 int drm_di_minor; 336 int drm_dd_major; 337 int drm_dd_minor; 338 } drmSetVersion, *drmSetVersionPtr; 339 340 #define __drm_dummy_lock(lock) (*(__volatile__ unsigned int *)lock) 341 342 #define DRM_LOCK_HELD 0x80000000U /**< Hardware lock is held */ 343 #define DRM_LOCK_CONT 0x40000000U /**< Hardware lock is contended */ 344 345 #if defined(__GNUC__) && (__GNUC__ >= 2) 346 # if defined(__i386) || defined(__AMD64__) || defined(__x86_64__) || defined(__amd64__) 347 /* Reflect changes here to drmP.h */ 348 #define DRM_CAS(lock,old,new,__ret) \ 349 do { \ 350 int __dummy; /* Can't mark eax as clobbered */ \ 351 __asm__ __volatile__( \ 352 "lock ; cmpxchg %4,%1\n\t" \ 353 "setnz %0" \ 354 : "=d" (__ret), \ 355 "=m" (__drm_dummy_lock(lock)), \ 356 "=a" (__dummy) \ 357 : "2" (old), \ 358 "r" (new)); \ 359 } while (0) 360 361 #elif defined(__alpha__) 362 363 #define DRM_CAS(lock, old, new, ret) \ 364 do { \ 365 int tmp, old32; \ 366 __asm__ __volatile__( \ 367 " addl $31, %5, %3\n" \ 368 "1: ldl_l %0, %2\n" \ 369 " cmpeq %0, %3, %1\n" \ 370 " beq %1, 2f\n" \ 371 " mov %4, %0\n" \ 372 " stl_c %0, %2\n" \ 373 " beq %0, 3f\n" \ 374 " mb\n" \ 375 "2: cmpeq %1, 0, %1\n" \ 376 ".subsection 2\n" \ 377 "3: br 1b\n" \ 378 ".previous" \ 379 : "=&r"(tmp), "=&r"(ret), \ 380 "=m"(__drm_dummy_lock(lock)), \ 381 "=&r"(old32) \ 382 : "r"(new), "r"(old) \ 383 : "memory"); \ 384 } while (0) 385 386 #elif defined(__sparc__) 387 388 #define DRM_CAS(lock,old,new,__ret) \ 389 do { register unsigned int __old __asm("o0"); \ 390 register unsigned int __new __asm("o1"); \ 391 register volatile unsigned int *__lock __asm("o2"); \ 392 __old = old; \ 393 __new = new; \ 394 __lock = (volatile unsigned int *)lock; \ 395 __asm__ __volatile__( \ 396 /*"cas [%2], %3, %0"*/ \ 397 ".word 0xd3e29008\n\t" \ 398 /*"membar #StoreStore | #StoreLoad"*/ \ 399 ".word 0x8143e00a" \ 400 : "=&r" (__new) \ 401 : "0" (__new), \ 402 "r" (__lock), \ 403 "r" (__old) \ 404 : "memory"); \ 405 __ret = (__new != __old); \ 406 } while(0) 407 408 #elif defined(__ia64__) 409 410 #ifdef __INTEL_COMPILER 411 /* this currently generates bad code (missing stop bits)... */ 412 #include <ia64intrin.h> 413 414 #define DRM_CAS(lock,old,new,__ret) \ 415 do { \ 416 unsigned long __result, __old = (old) & 0xffffffff; \ 417 __mf(); \ 418 __result = _InterlockedCompareExchange_acq(&__drm_dummy_lock(lock), (new), __old);\ 419 __ret = (__result) != (__old); \ 420 /* __ret = (__sync_val_compare_and_swap(&__drm_dummy_lock(lock), \ 421 (old), (new)) \ 422 != (old)); */\ 423 } while (0) 424 425 #else 426 #define DRM_CAS(lock,old,new,__ret) \ 427 do { \ 428 unsigned int __result, __old = (old); \ 429 __asm__ __volatile__( \ 430 "mf\n" \ 431 "mov ar.ccv=%2\n" \ 432 ";;\n" \ 433 "cmpxchg4.acq %0=%1,%3,ar.ccv" \ 434 : "=r" (__result), "=m" (__drm_dummy_lock(lock)) \ 435 : "r" ((unsigned long)__old), "r" (new) \ 436 : "memory"); \ 437 __ret = (__result) != (__old); \ 438 } while (0) 439 440 #endif 441 442 #elif defined(__powerpc__) 443 444 #define DRM_CAS(lock,old,new,__ret) \ 445 do { \ 446 __asm__ __volatile__( \ 447 "sync;" \ 448 "0: lwarx %0,0,%1;" \ 449 " xor. %0,%3,%0;" \ 450 " bne 1f;" \ 451 " stwcx. %2,0,%1;" \ 452 " bne- 0b;" \ 453 "1: " \ 454 "sync;" \ 455 : "=&r"(__ret) \ 456 : "r"(lock), "r"(new), "r"(old) \ 457 : "cr0", "memory"); \ 458 } while (0) 459 460 #endif /* architecture */ 461 #endif /* __GNUC__ >= 2 */ 462 463 #ifndef DRM_CAS 464 #define DRM_CAS(lock,old,new,ret) do { ret=1; } while (0) /* FAST LOCK FAILS */ 465 #endif 466 467 #if defined(__alpha__) 468 #define DRM_CAS_RESULT(_result) long _result 469 #elif defined(__powerpc__) 470 #define DRM_CAS_RESULT(_result) int _result 471 #else 472 #define DRM_CAS_RESULT(_result) char _result 473 #endif 474 475 #define DRM_LIGHT_LOCK(fd,lock,context) \ 476 do { \ 477 DRM_CAS_RESULT(__ret); \ 478 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \ 479 if (__ret) drmGetLock(fd,context,0); \ 480 } while(0) 481 482 /* This one counts fast locks -- for 483 benchmarking only. */ 484 #define DRM_LIGHT_LOCK_COUNT(fd,lock,context,count) \ 485 do { \ 486 DRM_CAS_RESULT(__ret); \ 487 DRM_CAS(lock,context,DRM_LOCK_HELD|context,__ret); \ 488 if (__ret) drmGetLock(fd,context,0); \ 489 else ++count; \ 490 } while(0) 491 492 #define DRM_LOCK(fd,lock,context,flags) \ 493 do { \ 494 if (flags) drmGetLock(fd,context,flags); \ 495 else DRM_LIGHT_LOCK(fd,lock,context); \ 496 } while(0) 497 498 #define DRM_UNLOCK(fd,lock,context) \ 499 do { \ 500 DRM_CAS_RESULT(__ret); \ 501 DRM_CAS(lock,DRM_LOCK_HELD|context,context,__ret); \ 502 if (__ret) drmUnlock(fd,context); \ 503 } while(0) 504 505 /* Simple spin locks */ 506 #define DRM_SPINLOCK(spin,val) \ 507 do { \ 508 DRM_CAS_RESULT(__ret); \ 509 do { \ 510 DRM_CAS(spin,0,val,__ret); \ 511 if (__ret) while ((spin)->lock); \ 512 } while (__ret); \ 513 } while(0) 514 515 #define DRM_SPINLOCK_TAKE(spin,val) \ 516 do { \ 517 DRM_CAS_RESULT(__ret); \ 518 int cur; \ 519 do { \ 520 cur = (*spin).lock; \ 521 DRM_CAS(spin,cur,val,__ret); \ 522 } while (__ret); \ 523 } while(0) 524 525 #define DRM_SPINLOCK_COUNT(spin,val,count,__ret) \ 526 do { \ 527 int __i; \ 528 __ret = 1; \ 529 for (__i = 0; __ret && __i < count; __i++) { \ 530 DRM_CAS(spin,0,val,__ret); \ 531 if (__ret) for (;__i < count && (spin)->lock; __i++); \ 532 } \ 533 } while(0) 534 535 #define DRM_SPINUNLOCK(spin,val) \ 536 do { \ 537 DRM_CAS_RESULT(__ret); \ 538 if ((*spin).lock == val) { /* else server stole lock */ \ 539 do { \ 540 DRM_CAS(spin,val,0,__ret); \ 541 } while (__ret); \ 542 } \ 543 } while(0) 544 545 /* General user-level programmer's API: unprivileged */ 546 extern int drmAvailable(void); 547 extern int drmOpen(const char *name, const char *busid); 548 549 #define DRM_NODE_PRIMARY 0 550 #define DRM_NODE_CONTROL 1 551 #define DRM_NODE_RENDER 2 552 #define DRM_NODE_MAX 3 553 554 extern int drmOpenWithType(const char *name, const char *busid, 555 int type); 556 557 extern int drmOpenControl(int minor); 558 extern int drmOpenRender(int minor); 559 extern int drmClose(int fd); 560 extern drmVersionPtr drmGetVersion(int fd); 561 extern void drmFreeVersion(drmVersionPtr); 562 extern char *drmGetBusid(int fd); 563 extern int drmGetInterruptFromBusID(int fd, int busnum, int devnum, 564 int funcnum); 565 extern int drmGetMap(int fd, int idx, drm_handle_t *offset, 566 drmSize *size, drmMapType *type, 567 drmMapFlags *flags, drm_handle_t *handle, 568 int *mtrr); 569 extern int drmGetClient(int fd, int idx, int *auth, int *pid, 570 int *uid, unsigned long *magic, 571 unsigned long *iocs); 572 extern int drmGetStats(int fd, drmStatsT *stats); 573 extern int drmSetInterfaceVersion(int fd, drmSetVersion *version); 574 575 /* General user-level programmer's API: X server (root) only */ 576 extern void drmFreeBusid(const char *busid); 577 extern int drmAddMap(int fd, 578 drm_handle_t offset, 579 drmSize size, 580 drmMapType type, 581 drmMapFlags flags, 582 drm_handle_t * handle); 583 extern int drmRmMap(int fd, drm_handle_t handle); 584 extern int drmAddContextPrivateMapping(int fd, drm_context_t ctx_id, 585 drm_handle_t handle); 586 587 extern int drmAddBufs(int fd, int count, int size, 588 drmBufDescFlags flags, 589 int agp_offset); 590 extern int drmMarkBufs(int fd, double low, double high); 591 extern int drmCreateContext(int fd, drm_context_t * handle); 592 extern int drmSetContextFlags(int fd, drm_context_t context, 593 drm_context_tFlags flags); 594 extern int drmGetContextFlags(int fd, drm_context_t context, 595 drm_context_tFlagsPtr flags); 596 extern int drmAddContextTag(int fd, drm_context_t context, void *tag); 597 extern int drmDelContextTag(int fd, drm_context_t context); 598 extern void *drmGetContextTag(int fd, drm_context_t context); 599 extern drm_context_t * drmGetReservedContextList(int fd, int *count); 600 extern void drmFreeReservedContextList(drm_context_t *); 601 extern int drmSwitchToContext(int fd, drm_context_t context); 602 extern int drmDestroyContext(int fd, drm_context_t handle); 603 extern int drmCreateDrawable(int fd, drm_drawable_t * handle); 604 extern int drmDestroyDrawable(int fd, drm_drawable_t handle); 605 extern int drmUpdateDrawableInfo(int fd, drm_drawable_t handle, 606 drm_drawable_info_type_t type, 607 unsigned int num, void *data); 608 extern int drmCtlInstHandler(int fd, int irq); 609 extern int drmCtlUninstHandler(int fd); 610 611 /* General user-level programmer's API: authenticated client and/or X */ 612 extern int drmDMA(int fd, drmDMAReqPtr request); 613 extern int drmFreeBufs(int fd, int count, int *list); 614 extern int drmGetLock(int fd, 615 drm_context_t context, 616 drmLockFlags flags); 617 extern int drmUnlock(int fd, drm_context_t context); 618 extern int drmFinish(int fd, int context, drmLockFlags flags); 619 extern int drmGetContextPrivateMapping(int fd, drm_context_t ctx_id, 620 drm_handle_t * handle); 621 622 /* AGP/GART support: X server (root) only */ 623 extern int drmAgpAcquire(int fd); 624 extern int drmAgpRelease(int fd); 625 extern int drmAgpEnable(int fd, unsigned long mode); 626 extern int drmAgpAlloc(int fd, unsigned long size, 627 unsigned long type, unsigned long *address, 628 drm_handle_t *handle); 629 extern int drmAgpFree(int fd, drm_handle_t handle); 630 extern int drmAgpBind(int fd, drm_handle_t handle, 631 unsigned long offset); 632 extern int drmAgpUnbind(int fd, drm_handle_t handle); 633 634 /* AGP/GART info: authenticated client and/or X */ 635 extern int drmAgpVersionMajor(int fd); 636 extern int drmAgpVersionMinor(int fd); 637 extern unsigned long drmAgpGetMode(int fd); 638 extern unsigned long drmAgpBase(int fd); /* Physical location */ 639 extern unsigned long drmAgpSize(int fd); /* Bytes */ 640 extern unsigned long drmAgpMemoryUsed(int fd); 641 extern unsigned long drmAgpMemoryAvail(int fd); 642 extern unsigned int drmAgpVendorId(int fd); 643 extern unsigned int drmAgpDeviceId(int fd); 644 645 /* PCI scatter/gather support: X server (root) only */ 646 extern int drmScatterGatherAlloc(int fd, unsigned long size, 647 drm_handle_t *handle); 648 extern int drmScatterGatherFree(int fd, drm_handle_t handle); 649 650 extern int drmWaitVBlank(int fd, drmVBlankPtr vbl); 651 652 /* Support routines */ 653 extern void drmSetServerInfo(drmServerInfoPtr info); 654 extern int drmError(int err, const char *label); 655 extern void *drmMalloc(int size); 656 extern void drmFree(void *pt); 657 658 /* Hash table routines */ 659 extern void *drmHashCreate(void); 660 extern int drmHashDestroy(void *t); 661 extern int drmHashLookup(void *t, unsigned long key, void **value); 662 extern int drmHashInsert(void *t, unsigned long key, void *value); 663 extern int drmHashDelete(void *t, unsigned long key); 664 665 /* PRNG routines */ 666 extern void *drmRandomCreate(unsigned long seed); 667 extern int drmRandomDestroy(void *state); 668 extern unsigned long drmRandom(void *state); 669 670 /* Skip list routines */ 671 672 extern void *drmSLCreate(void); 673 extern int drmSLDestroy(void *l); 674 extern int drmSLLookup(void *l, unsigned long key, void **value); 675 extern int drmSLInsert(void *l, unsigned long key, void *value); 676 extern int drmSLDelete(void *l, unsigned long key); 677 extern int drmSLNext(void *l, unsigned long *key, void **value); 678 extern int drmSLFirst(void *l, unsigned long *key, void **value); 679 extern void drmSLDump(void *l); 680 extern int drmSLLookupNeighbors(void *l, unsigned long key, 681 unsigned long *prev_key, void **prev_value, 682 unsigned long *next_key, void **next_value); 683 684 extern void drmMsg(const char *format, ...) DRM_PRINTFLIKE(1, 2); 685 686 #define DRM_EVENT_CONTEXT_VERSION 2 687 688 typedef struct _drmEventContext { 689 690 /* This struct is versioned so we can add more pointers if we 691 * add more events. */ 692 int version; 693 694 void (*vblank_handler)(int fd, 695 unsigned int sequence, 696 unsigned int tv_sec, 697 unsigned int tv_usec, 698 void *user_data); 699 700 void (*page_flip_handler)(int fd, 701 unsigned int sequence, 702 unsigned int tv_sec, 703 unsigned int tv_usec, 704 void *user_data); 705 706 } drmEventContext, *drmEventContextPtr; 707 708 extern int drmPrimeHandleToFD(int fd, uint32_t handle, uint32_t flags, int *prime_fd); 709 extern int drmPrimeFDToHandle(int fd, int prime_fd, uint32_t *handle); 710 711 extern char *drmGetPrimaryDeviceNameFromFd(int fd); 712 extern char *drmGetRenderDeviceNameFromFd(int fd); 713 714 #define DRM_BUS_PCI 0 715 716 typedef struct _drmPciBusInfo { 717 uint16_t domain; 718 uint8_t bus; 719 uint8_t dev; 720 uint8_t func; 721 } drmPciBusInfo, *drmPciBusInfoPtr; 722 723 typedef struct _drmPciDeviceInfo { 724 uint16_t vendor_id; 725 uint16_t device_id; 726 uint16_t subvendor_id; 727 uint16_t subdevice_id; 728 uint8_t revision_id; 729 } drmPciDeviceInfo, *drmPciDeviceInfoPtr; 730 731 typedef struct _drmDevice { 732 char **nodes; /* DRM_NODE_MAX sized array */ 733 int available_nodes; /* DRM_NODE_* bitmask */ 734 int bustype; 735 union { 736 drmPciBusInfoPtr pci; 737 } businfo; 738 union { 739 drmPciDeviceInfoPtr pci; 740 } deviceinfo; 741 } drmDevice, *drmDevicePtr; 742 743 extern int drmGetDevice(int fd, drmDevicePtr *device); 744 extern void drmFreeDevice(drmDevicePtr *device); 745 746 extern int drmGetDevices(drmDevicePtr devices[], int max_devices); 747 extern void drmFreeDevices(drmDevicePtr devices[], int count); 748 749 #if defined(__cplusplus) 750 } 751 #endif 752 753 #endif 754