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