drm.h 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416
  1. /*
  2. * Header for the Direct Rendering Manager
  3. *
  4. * Author: Rickard E. (Rik) Faith <faith@valinux.com>
  5. *
  6. * Acknowledgments:
  7. * Dec 1999, Richard Henderson <rth@twiddle.net>, move to generic cmpxchg.
  8. */
  9. /*
  10. * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
  11. * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
  12. * All rights reserved.
  13. *
  14. * Permission is hereby granted, free of charge, to any person obtaining a
  15. * copy of this software and associated documentation files (the "Software"),
  16. * to deal in the Software without restriction, including without limitation
  17. * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  18. * and/or sell copies of the Software, and to permit persons to whom the
  19. * Software is furnished to do so, subject to the following conditions:
  20. *
  21. * The above copyright notice and this permission notice (including the next
  22. * paragraph) shall be included in all copies or substantial portions of the
  23. * Software.
  24. *
  25. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  26. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  27. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  28. * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  29. * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  30. * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  31. * OTHER DEALINGS IN THE SOFTWARE.
  32. */
  33. #ifndef _DRM_H_
  34. #define _DRM_H_
  35. #if defined(__KERNEL__)
  36. #include <linux/types.h>
  37. #include <asm/ioctl.h>
  38. typedef unsigned int drm_handle_t;
  39. #elif defined(__linux__)
  40. #include <linux/types.h>
  41. #include <asm/ioctl.h>
  42. typedef unsigned int drm_handle_t;
  43. #else /* One of the BSDs */
  44. #include <stdint.h>
  45. #include <sys/ioccom.h>
  46. #include <sys/types.h>
  47. typedef int8_t __s8;
  48. typedef uint8_t __u8;
  49. typedef int16_t __s16;
  50. typedef uint16_t __u16;
  51. typedef int32_t __s32;
  52. typedef uint32_t __u32;
  53. typedef int64_t __s64;
  54. typedef uint64_t __u64;
  55. typedef size_t __kernel_size_t;
  56. typedef unsigned long drm_handle_t;
  57. #endif
  58. #if defined(__cplusplus)
  59. extern "C" {
  60. #endif
  61. #define DRM_NAME "drm" /**< Name in kernel, /dev, and /proc */
  62. #define DRM_MIN_ORDER 5 /**< At least 2^5 bytes = 32 bytes */
  63. #define DRM_MAX_ORDER 22 /**< Up to 2^22 bytes = 4MB */
  64. #define DRM_RAM_PERCENT 10 /**< How much system ram can we lock? */
  65. #define _DRM_LOCK_HELD 0x80000000U /**< Hardware lock is held */
  66. #define _DRM_LOCK_CONT 0x40000000U /**< Hardware lock is contended */
  67. #define _DRM_LOCK_IS_HELD(lock) ((lock) & _DRM_LOCK_HELD)
  68. #define _DRM_LOCK_IS_CONT(lock) ((lock) & _DRM_LOCK_CONT)
  69. #define _DRM_LOCKING_CONTEXT(lock) ((lock) & ~(_DRM_LOCK_HELD|_DRM_LOCK_CONT))
  70. typedef unsigned int drm_context_t;
  71. typedef unsigned int drm_drawable_t;
  72. typedef unsigned int drm_magic_t;
  73. /*
  74. * Cliprect.
  75. *
  76. * \warning: If you change this structure, make sure you change
  77. * XF86DRIClipRectRec in the server as well
  78. *
  79. * \note KW: Actually it's illegal to change either for
  80. * backwards-compatibility reasons.
  81. */
  82. struct drm_clip_rect {
  83. unsigned short x1;
  84. unsigned short y1;
  85. unsigned short x2;
  86. unsigned short y2;
  87. };
  88. /*
  89. * Drawable information.
  90. */
  91. struct drm_drawable_info {
  92. unsigned int num_rects;
  93. struct drm_clip_rect *rects;
  94. };
  95. /*
  96. * Texture region,
  97. */
  98. struct drm_tex_region {
  99. unsigned char next;
  100. unsigned char prev;
  101. unsigned char in_use;
  102. unsigned char padding;
  103. unsigned int age;
  104. };
  105. /*
  106. * Hardware lock.
  107. *
  108. * The lock structure is a simple cache-line aligned integer. To avoid
  109. * processor bus contention on a multiprocessor system, there should not be any
  110. * other data stored in the same cache line.
  111. */
  112. struct drm_hw_lock {
  113. __volatile__ unsigned int lock; /**< lock variable */
  114. char padding[60]; /**< Pad to cache line */
  115. };
  116. /*
  117. * DRM_IOCTL_VERSION ioctl argument type.
  118. *
  119. * \sa drmGetVersion().
  120. */
  121. struct drm_version {
  122. int version_major; /**< Major version */
  123. int version_minor; /**< Minor version */
  124. int version_patchlevel; /**< Patch level */
  125. __kernel_size_t name_len; /**< Length of name buffer */
  126. char __user *name; /**< Name of driver */
  127. __kernel_size_t date_len; /**< Length of date buffer */
  128. char __user *date; /**< User-space buffer to hold date */
  129. __kernel_size_t desc_len; /**< Length of desc buffer */
  130. char __user *desc; /**< User-space buffer to hold desc */
  131. };
  132. /*
  133. * DRM_IOCTL_GET_UNIQUE ioctl argument type.
  134. *
  135. * \sa drmGetBusid() and drmSetBusId().
  136. */
  137. struct drm_unique {
  138. __kernel_size_t unique_len; /**< Length of unique */
  139. char __user *unique; /**< Unique name for driver instantiation */
  140. };
  141. struct drm_list {
  142. int count; /**< Length of user-space structures */
  143. struct drm_version __user *version;
  144. };
  145. struct drm_block {
  146. int unused;
  147. };
  148. /*
  149. * DRM_IOCTL_CONTROL ioctl argument type.
  150. *
  151. * \sa drmCtlInstHandler() and drmCtlUninstHandler().
  152. */
  153. struct drm_control {
  154. enum {
  155. DRM_ADD_COMMAND,
  156. DRM_RM_COMMAND,
  157. DRM_INST_HANDLER,
  158. DRM_UNINST_HANDLER
  159. } func;
  160. int irq;
  161. };
  162. /*
  163. * Type of memory to map.
  164. */
  165. enum drm_map_type {
  166. _DRM_FRAME_BUFFER = 0, /**< WC (no caching), no core dump */
  167. _DRM_REGISTERS = 1, /**< no caching, no core dump */
  168. _DRM_SHM = 2, /**< shared, cached */
  169. _DRM_AGP = 3, /**< AGP/GART */
  170. _DRM_SCATTER_GATHER = 4, /**< Scatter/gather memory for PCI DMA */
  171. _DRM_CONSISTENT = 5 /**< Consistent memory for PCI DMA */
  172. };
  173. /*
  174. * Memory mapping flags.
  175. */
  176. enum drm_map_flags {
  177. _DRM_RESTRICTED = 0x01, /**< Cannot be mapped to user-virtual */
  178. _DRM_READ_ONLY = 0x02,
  179. _DRM_LOCKED = 0x04, /**< shared, cached, locked */
  180. _DRM_KERNEL = 0x08, /**< kernel requires access */
  181. _DRM_WRITE_COMBINING = 0x10, /**< use write-combining if available */
  182. _DRM_CONTAINS_LOCK = 0x20, /**< SHM page that contains lock */
  183. _DRM_REMOVABLE = 0x40, /**< Removable mapping */
  184. _DRM_DRIVER = 0x80 /**< Managed by driver */
  185. };
  186. struct drm_ctx_priv_map {
  187. unsigned int ctx_id; /**< Context requesting private mapping */
  188. void *handle; /**< Handle of map */
  189. };
  190. /*
  191. * DRM_IOCTL_GET_MAP, DRM_IOCTL_ADD_MAP and DRM_IOCTL_RM_MAP ioctls
  192. * argument type.
  193. *
  194. * \sa drmAddMap().
  195. */
  196. struct drm_map {
  197. unsigned long offset; /**< Requested physical address (0 for SAREA)*/
  198. unsigned long size; /**< Requested physical size (bytes) */
  199. enum drm_map_type type; /**< Type of memory to map */
  200. enum drm_map_flags flags; /**< Flags */
  201. void *handle; /**< User-space: "Handle" to pass to mmap() */
  202. /**< Kernel-space: kernel-virtual address */
  203. int mtrr; /**< MTRR slot used */
  204. /* Private data */
  205. };
  206. /*
  207. * DRM_IOCTL_GET_CLIENT ioctl argument type.
  208. */
  209. struct drm_client {
  210. int idx; /**< Which client desired? */
  211. int auth; /**< Is client authenticated? */
  212. unsigned long pid; /**< Process ID */
  213. unsigned long uid; /**< User ID */
  214. unsigned long magic; /**< Magic */
  215. unsigned long iocs; /**< Ioctl count */
  216. };
  217. enum drm_stat_type {
  218. _DRM_STAT_LOCK,
  219. _DRM_STAT_OPENS,
  220. _DRM_STAT_CLOSES,
  221. _DRM_STAT_IOCTLS,
  222. _DRM_STAT_LOCKS,
  223. _DRM_STAT_UNLOCKS,
  224. _DRM_STAT_VALUE, /**< Generic value */
  225. _DRM_STAT_BYTE, /**< Generic byte counter (1024bytes/K) */
  226. _DRM_STAT_COUNT, /**< Generic non-byte counter (1000/k) */
  227. _DRM_STAT_IRQ, /**< IRQ */
  228. _DRM_STAT_PRIMARY, /**< Primary DMA bytes */
  229. _DRM_STAT_SECONDARY, /**< Secondary DMA bytes */
  230. _DRM_STAT_DMA, /**< DMA */
  231. _DRM_STAT_SPECIAL, /**< Special DMA (e.g., priority or polled) */
  232. _DRM_STAT_MISSED /**< Missed DMA opportunity */
  233. /* Add to the *END* of the list */
  234. };
  235. /*
  236. * DRM_IOCTL_GET_STATS ioctl argument type.
  237. */
  238. struct drm_stats {
  239. unsigned long count;
  240. struct {
  241. unsigned long value;
  242. enum drm_stat_type type;
  243. } data[15];
  244. };
  245. /*
  246. * Hardware locking flags.
  247. */
  248. enum drm_lock_flags {
  249. _DRM_LOCK_READY = 0x01, /**< Wait until hardware is ready for DMA */
  250. _DRM_LOCK_QUIESCENT = 0x02, /**< Wait until hardware quiescent */
  251. _DRM_LOCK_FLUSH = 0x04, /**< Flush this context's DMA queue first */
  252. _DRM_LOCK_FLUSH_ALL = 0x08, /**< Flush all DMA queues first */
  253. /* These *HALT* flags aren't supported yet
  254. -- they will be used to support the
  255. full-screen DGA-like mode. */
  256. _DRM_HALT_ALL_QUEUES = 0x10, /**< Halt all current and future queues */
  257. _DRM_HALT_CUR_QUEUES = 0x20 /**< Halt all current queues */
  258. };
  259. /*
  260. * DRM_IOCTL_LOCK, DRM_IOCTL_UNLOCK and DRM_IOCTL_FINISH ioctl argument type.
  261. *
  262. * \sa drmGetLock() and drmUnlock().
  263. */
  264. struct drm_lock {
  265. int context;
  266. enum drm_lock_flags flags;
  267. };
  268. /*
  269. * DMA flags
  270. *
  271. * \warning
  272. * These values \e must match xf86drm.h.
  273. *
  274. * \sa drm_dma.
  275. */
  276. enum drm_dma_flags {
  277. /* Flags for DMA buffer dispatch */
  278. _DRM_DMA_BLOCK = 0x01, /**<
  279. * Block until buffer dispatched.
  280. *
  281. * \note The buffer may not yet have
  282. * been processed by the hardware --
  283. * getting a hardware lock with the
  284. * hardware quiescent will ensure
  285. * that the buffer has been
  286. * processed.
  287. */
  288. _DRM_DMA_WHILE_LOCKED = 0x02, /**< Dispatch while lock held */
  289. _DRM_DMA_PRIORITY = 0x04, /**< High priority dispatch */
  290. /* Flags for DMA buffer request */
  291. _DRM_DMA_WAIT = 0x10, /**< Wait for free buffers */
  292. _DRM_DMA_SMALLER_OK = 0x20, /**< Smaller-than-requested buffers OK */
  293. _DRM_DMA_LARGER_OK = 0x40 /**< Larger-than-requested buffers OK */
  294. };
  295. /*
  296. * DRM_IOCTL_ADD_BUFS and DRM_IOCTL_MARK_BUFS ioctl argument type.
  297. *
  298. * \sa drmAddBufs().
  299. */
  300. struct drm_buf_desc {
  301. int count; /**< Number of buffers of this size */
  302. int size; /**< Size in bytes */
  303. int low_mark; /**< Low water mark */
  304. int high_mark; /**< High water mark */
  305. enum {
  306. _DRM_PAGE_ALIGN = 0x01, /**< Align on page boundaries for DMA */
  307. _DRM_AGP_BUFFER = 0x02, /**< Buffer is in AGP space */
  308. _DRM_SG_BUFFER = 0x04, /**< Scatter/gather memory buffer */
  309. _DRM_FB_BUFFER = 0x08, /**< Buffer is in frame buffer */
  310. _DRM_PCI_BUFFER_RO = 0x10 /**< Map PCI DMA buffer read-only */
  311. } flags;
  312. unsigned long agp_start; /**<
  313. * Start address of where the AGP buffers are
  314. * in the AGP aperture
  315. */
  316. };
  317. /*
  318. * DRM_IOCTL_INFO_BUFS ioctl argument type.
  319. */
  320. struct drm_buf_info {
  321. int count; /**< Entries in list */
  322. struct drm_buf_desc __user *list;
  323. };
  324. /*
  325. * DRM_IOCTL_FREE_BUFS ioctl argument type.
  326. */
  327. struct drm_buf_free {
  328. int count;
  329. int __user *list;
  330. };
  331. /*
  332. * Buffer information
  333. *
  334. * \sa drm_buf_map.
  335. */
  336. struct drm_buf_pub {
  337. int idx; /**< Index into the master buffer list */
  338. int total; /**< Buffer size */
  339. int used; /**< Amount of buffer in use (for DMA) */
  340. void __user *address; /**< Address of buffer */
  341. };
  342. /*
  343. * DRM_IOCTL_MAP_BUFS ioctl argument type.
  344. */
  345. struct drm_buf_map {
  346. int count; /**< Length of the buffer list */
  347. #ifdef __cplusplus
  348. void __user *virt;
  349. #else
  350. void __user *virtual; /**< Mmap'd area in user-virtual */
  351. #endif
  352. struct drm_buf_pub __user *list; /**< Buffer information */
  353. };
  354. /*
  355. * DRM_IOCTL_DMA ioctl argument type.
  356. *
  357. * Indices here refer to the offset into the buffer list in drm_buf_get.
  358. *
  359. * \sa drmDMA().
  360. */
  361. struct drm_dma {
  362. int context; /**< Context handle */
  363. int send_count; /**< Number of buffers to send */
  364. int __user *send_indices; /**< List of handles to buffers */
  365. int __user *send_sizes; /**< Lengths of data to send */
  366. enum drm_dma_flags flags; /**< Flags */
  367. int request_count; /**< Number of buffers requested */
  368. int request_size; /**< Desired size for buffers */
  369. int __user *request_indices; /**< Buffer information */
  370. int __user *request_sizes;
  371. int granted_count; /**< Number of buffers granted */
  372. };
  373. enum drm_ctx_flags {
  374. _DRM_CONTEXT_PRESERVED = 0x01,
  375. _DRM_CONTEXT_2DONLY = 0x02
  376. };
  377. /*
  378. * DRM_IOCTL_ADD_CTX ioctl argument type.
  379. *
  380. * \sa drmCreateContext() and drmDestroyContext().
  381. */
  382. struct drm_ctx {
  383. drm_context_t handle;
  384. enum drm_ctx_flags flags;
  385. };
  386. /*
  387. * DRM_IOCTL_RES_CTX ioctl argument type.
  388. */
  389. struct drm_ctx_res {
  390. int count;
  391. struct drm_ctx __user *contexts;
  392. };
  393. /*
  394. * DRM_IOCTL_ADD_DRAW and DRM_IOCTL_RM_DRAW ioctl argument type.
  395. */
  396. struct drm_draw {
  397. drm_drawable_t handle;
  398. };
  399. /*
  400. * DRM_IOCTL_UPDATE_DRAW ioctl argument type.
  401. */
  402. typedef enum {
  403. DRM_DRAWABLE_CLIPRECTS
  404. } drm_drawable_info_type_t;
  405. struct drm_update_draw {
  406. drm_drawable_t handle;
  407. unsigned int type;
  408. unsigned int num;
  409. unsigned long long data;
  410. };
  411. /*
  412. * DRM_IOCTL_GET_MAGIC and DRM_IOCTL_AUTH_MAGIC ioctl argument type.
  413. */
  414. struct drm_auth {
  415. drm_magic_t magic;
  416. };
  417. /*
  418. * DRM_IOCTL_IRQ_BUSID ioctl argument type.
  419. *
  420. * \sa drmGetInterruptFromBusID().
  421. */
  422. struct drm_irq_busid {
  423. int irq; /**< IRQ number */
  424. int busnum; /**< bus number */
  425. int devnum; /**< device number */
  426. int funcnum; /**< function number */
  427. };
  428. enum drm_vblank_seq_type {
  429. _DRM_VBLANK_ABSOLUTE = 0x0, /**< Wait for specific vblank sequence number */
  430. _DRM_VBLANK_RELATIVE = 0x1, /**< Wait for given number of vblanks */
  431. /* bits 1-6 are reserved for high crtcs */
  432. _DRM_VBLANK_HIGH_CRTC_MASK = 0x0000003e,
  433. _DRM_VBLANK_EVENT = 0x4000000, /**< Send event instead of blocking */
  434. _DRM_VBLANK_FLIP = 0x8000000, /**< Scheduled buffer swap should flip */
  435. _DRM_VBLANK_NEXTONMISS = 0x10000000, /**< If missed, wait for next vblank */
  436. _DRM_VBLANK_SECONDARY = 0x20000000, /**< Secondary display controller */
  437. _DRM_VBLANK_SIGNAL = 0x40000000 /**< Send signal instead of blocking, unsupported */
  438. };
  439. #define _DRM_VBLANK_HIGH_CRTC_SHIFT 1
  440. #define _DRM_VBLANK_TYPES_MASK (_DRM_VBLANK_ABSOLUTE | _DRM_VBLANK_RELATIVE)
  441. #define _DRM_VBLANK_FLAGS_MASK (_DRM_VBLANK_EVENT | _DRM_VBLANK_SIGNAL | \
  442. _DRM_VBLANK_SECONDARY | _DRM_VBLANK_NEXTONMISS)
  443. struct drm_wait_vblank_request {
  444. enum drm_vblank_seq_type type;
  445. unsigned int sequence;
  446. unsigned long signal;
  447. };
  448. struct drm_wait_vblank_reply {
  449. enum drm_vblank_seq_type type;
  450. unsigned int sequence;
  451. long tval_sec;
  452. long tval_usec;
  453. };
  454. /*
  455. * DRM_IOCTL_WAIT_VBLANK ioctl argument type.
  456. *
  457. * \sa drmWaitVBlank().
  458. */
  459. union drm_wait_vblank {
  460. struct drm_wait_vblank_request request;
  461. struct drm_wait_vblank_reply reply;
  462. };
  463. #define _DRM_PRE_MODESET 1
  464. #define _DRM_POST_MODESET 2
  465. /*
  466. * DRM_IOCTL_MODESET_CTL ioctl argument type
  467. *
  468. * \sa drmModesetCtl().
  469. */
  470. struct drm_modeset_ctl {
  471. __u32 crtc;
  472. __u32 cmd;
  473. };
  474. /*
  475. * DRM_IOCTL_AGP_ENABLE ioctl argument type.
  476. *
  477. * \sa drmAgpEnable().
  478. */
  479. struct drm_agp_mode {
  480. unsigned long mode; /**< AGP mode */
  481. };
  482. /*
  483. * DRM_IOCTL_AGP_ALLOC and DRM_IOCTL_AGP_FREE ioctls argument type.
  484. *
  485. * \sa drmAgpAlloc() and drmAgpFree().
  486. */
  487. struct drm_agp_buffer {
  488. unsigned long size; /**< In bytes -- will round to page boundary */
  489. unsigned long handle; /**< Used for binding / unbinding */
  490. unsigned long type; /**< Type of memory to allocate */
  491. unsigned long physical; /**< Physical used by i810 */
  492. };
  493. /*
  494. * DRM_IOCTL_AGP_BIND and DRM_IOCTL_AGP_UNBIND ioctls argument type.
  495. *
  496. * \sa drmAgpBind() and drmAgpUnbind().
  497. */
  498. struct drm_agp_binding {
  499. unsigned long handle; /**< From drm_agp_buffer */
  500. unsigned long offset; /**< In bytes -- will round to page boundary */
  501. };
  502. /*
  503. * DRM_IOCTL_AGP_INFO ioctl argument type.
  504. *
  505. * \sa drmAgpVersionMajor(), drmAgpVersionMinor(), drmAgpGetMode(),
  506. * drmAgpBase(), drmAgpSize(), drmAgpMemoryUsed(), drmAgpMemoryAvail(),
  507. * drmAgpVendorId() and drmAgpDeviceId().
  508. */
  509. struct drm_agp_info {
  510. int agp_version_major;
  511. int agp_version_minor;
  512. unsigned long mode;
  513. unsigned long aperture_base; /* physical address */
  514. unsigned long aperture_size; /* bytes */
  515. unsigned long memory_allowed; /* bytes */
  516. unsigned long memory_used;
  517. /* PCI information */
  518. unsigned short id_vendor;
  519. unsigned short id_device;
  520. };
  521. /*
  522. * DRM_IOCTL_SG_ALLOC ioctl argument type.
  523. */
  524. struct drm_scatter_gather {
  525. unsigned long size; /**< In bytes -- will round to page boundary */
  526. unsigned long handle; /**< Used for mapping / unmapping */
  527. };
  528. /*
  529. * DRM_IOCTL_SET_VERSION ioctl argument type.
  530. */
  531. struct drm_set_version {
  532. int drm_di_major;
  533. int drm_di_minor;
  534. int drm_dd_major;
  535. int drm_dd_minor;
  536. };
  537. /* DRM_IOCTL_GEM_CLOSE ioctl argument type */
  538. struct drm_gem_close {
  539. /** Handle of the object to be closed. */
  540. __u32 handle;
  541. __u32 pad;
  542. };
  543. /* DRM_IOCTL_GEM_FLINK ioctl argument type */
  544. struct drm_gem_flink {
  545. /** Handle for the object being named */
  546. __u32 handle;
  547. /** Returned global name */
  548. __u32 name;
  549. };
  550. /* DRM_IOCTL_GEM_OPEN ioctl argument type */
  551. struct drm_gem_open {
  552. /** Name of object being opened */
  553. __u32 name;
  554. /** Returned handle for the object */
  555. __u32 handle;
  556. /** Returned size of the object */
  557. __u64 size;
  558. };
  559. /**
  560. * DRM_CAP_DUMB_BUFFER
  561. *
  562. * If set to 1, the driver supports creating dumb buffers via the
  563. * &DRM_IOCTL_MODE_CREATE_DUMB ioctl.
  564. */
  565. #define DRM_CAP_DUMB_BUFFER 0x1
  566. /**
  567. * DRM_CAP_VBLANK_HIGH_CRTC
  568. *
  569. * If set to 1, the kernel supports specifying a :ref:`CRTC index<crtc_index>`
  570. * in the high bits of &drm_wait_vblank_request.type.
  571. *
  572. * Starting kernel version 2.6.39, this capability is always set to 1.
  573. */
  574. #define DRM_CAP_VBLANK_HIGH_CRTC 0x2
  575. /**
  576. * DRM_CAP_DUMB_PREFERRED_DEPTH
  577. *
  578. * The preferred bit depth for dumb buffers.
  579. *
  580. * The bit depth is the number of bits used to indicate the color of a single
  581. * pixel excluding any padding. This is different from the number of bits per
  582. * pixel. For instance, XRGB8888 has a bit depth of 24 but has 32 bits per
  583. * pixel.
  584. *
  585. * Note that this preference only applies to dumb buffers, it's irrelevant for
  586. * other types of buffers.
  587. */
  588. #define DRM_CAP_DUMB_PREFERRED_DEPTH 0x3
  589. /**
  590. * DRM_CAP_DUMB_PREFER_SHADOW
  591. *
  592. * If set to 1, the driver prefers userspace to render to a shadow buffer
  593. * instead of directly rendering to a dumb buffer. For best speed, userspace
  594. * should do streaming ordered memory copies into the dumb buffer and never
  595. * read from it.
  596. *
  597. * Note that this preference only applies to dumb buffers, it's irrelevant for
  598. * other types of buffers.
  599. */
  600. #define DRM_CAP_DUMB_PREFER_SHADOW 0x4
  601. /**
  602. * DRM_CAP_PRIME
  603. *
  604. * Bitfield of supported PRIME sharing capabilities. See &DRM_PRIME_CAP_IMPORT
  605. * and &DRM_PRIME_CAP_EXPORT.
  606. *
  607. * Starting from kernel version 6.6, both &DRM_PRIME_CAP_IMPORT and
  608. * &DRM_PRIME_CAP_EXPORT are always advertised.
  609. *
  610. * PRIME buffers are exposed as dma-buf file descriptors.
  611. * See :ref:`prime_buffer_sharing`.
  612. */
  613. #define DRM_CAP_PRIME 0x5
  614. /**
  615. * DRM_PRIME_CAP_IMPORT
  616. *
  617. * If this bit is set in &DRM_CAP_PRIME, the driver supports importing PRIME
  618. * buffers via the &DRM_IOCTL_PRIME_FD_TO_HANDLE ioctl.
  619. *
  620. * Starting from kernel version 6.6, this bit is always set in &DRM_CAP_PRIME.
  621. */
  622. #define DRM_PRIME_CAP_IMPORT 0x1
  623. /**
  624. * DRM_PRIME_CAP_EXPORT
  625. *
  626. * If this bit is set in &DRM_CAP_PRIME, the driver supports exporting PRIME
  627. * buffers via the &DRM_IOCTL_PRIME_HANDLE_TO_FD ioctl.
  628. *
  629. * Starting from kernel version 6.6, this bit is always set in &DRM_CAP_PRIME.
  630. */
  631. #define DRM_PRIME_CAP_EXPORT 0x2
  632. /**
  633. * DRM_CAP_TIMESTAMP_MONOTONIC
  634. *
  635. * If set to 0, the kernel will report timestamps with ``CLOCK_REALTIME`` in
  636. * struct drm_event_vblank. If set to 1, the kernel will report timestamps with
  637. * ``CLOCK_MONOTONIC``. See ``clock_gettime(2)`` for the definition of these
  638. * clocks.
  639. *
  640. * Starting from kernel version 2.6.39, the default value for this capability
  641. * is 1. Starting kernel version 4.15, this capability is always set to 1.
  642. */
  643. #define DRM_CAP_TIMESTAMP_MONOTONIC 0x6
  644. /**
  645. * DRM_CAP_ASYNC_PAGE_FLIP
  646. *
  647. * If set to 1, the driver supports &DRM_MODE_PAGE_FLIP_ASYNC for legacy
  648. * page-flips.
  649. */
  650. #define DRM_CAP_ASYNC_PAGE_FLIP 0x7
  651. /**
  652. * DRM_CAP_CURSOR_WIDTH
  653. *
  654. * The ``CURSOR_WIDTH`` and ``CURSOR_HEIGHT`` capabilities return a valid
  655. * width x height combination for the hardware cursor. The intention is that a
  656. * hardware agnostic userspace can query a cursor plane size to use.
  657. *
  658. * Note that the cross-driver contract is to merely return a valid size;
  659. * drivers are free to attach another meaning on top, eg. i915 returns the
  660. * maximum plane size.
  661. */
  662. #define DRM_CAP_CURSOR_WIDTH 0x8
  663. /**
  664. * DRM_CAP_CURSOR_HEIGHT
  665. *
  666. * See &DRM_CAP_CURSOR_WIDTH.
  667. */
  668. #define DRM_CAP_CURSOR_HEIGHT 0x9
  669. /**
  670. * DRM_CAP_ADDFB2_MODIFIERS
  671. *
  672. * If set to 1, the driver supports supplying modifiers in the
  673. * &DRM_IOCTL_MODE_ADDFB2 ioctl.
  674. */
  675. #define DRM_CAP_ADDFB2_MODIFIERS 0x10
  676. /**
  677. * DRM_CAP_PAGE_FLIP_TARGET
  678. *
  679. * If set to 1, the driver supports the &DRM_MODE_PAGE_FLIP_TARGET_ABSOLUTE and
  680. * &DRM_MODE_PAGE_FLIP_TARGET_RELATIVE flags in
  681. * &drm_mode_crtc_page_flip_target.flags for the &DRM_IOCTL_MODE_PAGE_FLIP
  682. * ioctl.
  683. */
  684. #define DRM_CAP_PAGE_FLIP_TARGET 0x11
  685. /**
  686. * DRM_CAP_CRTC_IN_VBLANK_EVENT
  687. *
  688. * If set to 1, the kernel supports reporting the CRTC ID in
  689. * &drm_event_vblank.crtc_id for the &DRM_EVENT_VBLANK and
  690. * &DRM_EVENT_FLIP_COMPLETE events.
  691. *
  692. * Starting kernel version 4.12, this capability is always set to 1.
  693. */
  694. #define DRM_CAP_CRTC_IN_VBLANK_EVENT 0x12
  695. /**
  696. * DRM_CAP_SYNCOBJ
  697. *
  698. * If set to 1, the driver supports sync objects. See :ref:`drm_sync_objects`.
  699. */
  700. #define DRM_CAP_SYNCOBJ 0x13
  701. /**
  702. * DRM_CAP_SYNCOBJ_TIMELINE
  703. *
  704. * If set to 1, the driver supports timeline operations on sync objects. See
  705. * :ref:`drm_sync_objects`.
  706. */
  707. #define DRM_CAP_SYNCOBJ_TIMELINE 0x14
  708. /**
  709. * DRM_CAP_ATOMIC_ASYNC_PAGE_FLIP
  710. *
  711. * If set to 1, the driver supports &DRM_MODE_PAGE_FLIP_ASYNC for atomic
  712. * commits.
  713. */
  714. #define DRM_CAP_ATOMIC_ASYNC_PAGE_FLIP 0x15
  715. /* DRM_IOCTL_GET_CAP ioctl argument type */
  716. struct drm_get_cap {
  717. __u64 capability;
  718. __u64 value;
  719. };
  720. /**
  721. * DRM_CLIENT_CAP_STEREO_3D
  722. *
  723. * If set to 1, the DRM core will expose the stereo 3D capabilities of the
  724. * monitor by advertising the supported 3D layouts in the flags of struct
  725. * drm_mode_modeinfo. See ``DRM_MODE_FLAG_3D_*``.
  726. *
  727. * This capability is always supported for all drivers starting from kernel
  728. * version 3.13.
  729. */
  730. #define DRM_CLIENT_CAP_STEREO_3D 1
  731. /**
  732. * DRM_CLIENT_CAP_UNIVERSAL_PLANES
  733. *
  734. * If set to 1, the DRM core will expose all planes (overlay, primary, and
  735. * cursor) to userspace.
  736. *
  737. * This capability has been introduced in kernel version 3.15. Starting from
  738. * kernel version 3.17, this capability is always supported for all drivers.
  739. */
  740. #define DRM_CLIENT_CAP_UNIVERSAL_PLANES 2
  741. /**
  742. * DRM_CLIENT_CAP_ATOMIC
  743. *
  744. * If set to 1, the DRM core will expose atomic properties to userspace. This
  745. * implicitly enables &DRM_CLIENT_CAP_UNIVERSAL_PLANES and
  746. * &DRM_CLIENT_CAP_ASPECT_RATIO.
  747. *
  748. * If the driver doesn't support atomic mode-setting, enabling this capability
  749. * will fail with -EOPNOTSUPP.
  750. *
  751. * This capability has been introduced in kernel version 4.0. Starting from
  752. * kernel version 4.2, this capability is always supported for atomic-capable
  753. * drivers.
  754. */
  755. #define DRM_CLIENT_CAP_ATOMIC 3
  756. /**
  757. * DRM_CLIENT_CAP_ASPECT_RATIO
  758. *
  759. * If set to 1, the DRM core will provide aspect ratio information in modes.
  760. * See ``DRM_MODE_FLAG_PIC_AR_*``.
  761. *
  762. * This capability is always supported for all drivers starting from kernel
  763. * version 4.18.
  764. */
  765. #define DRM_CLIENT_CAP_ASPECT_RATIO 4
  766. /**
  767. * DRM_CLIENT_CAP_WRITEBACK_CONNECTORS
  768. *
  769. * If set to 1, the DRM core will expose special connectors to be used for
  770. * writing back to memory the scene setup in the commit. The client must enable
  771. * &DRM_CLIENT_CAP_ATOMIC first.
  772. *
  773. * This capability is always supported for atomic-capable drivers starting from
  774. * kernel version 4.19.
  775. */
  776. #define DRM_CLIENT_CAP_WRITEBACK_CONNECTORS 5
  777. /**
  778. * DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT
  779. *
  780. * Drivers for para-virtualized hardware (e.g. vmwgfx, qxl, virtio and
  781. * virtualbox) have additional restrictions for cursor planes (thus
  782. * making cursor planes on those drivers not truly universal,) e.g.
  783. * they need cursor planes to act like one would expect from a mouse
  784. * cursor and have correctly set hotspot properties.
  785. * If this client cap is not set the DRM core will hide cursor plane on
  786. * those virtualized drivers because not setting it implies that the
  787. * client is not capable of dealing with those extra restictions.
  788. * Clients which do set cursor hotspot and treat the cursor plane
  789. * like a mouse cursor should set this property.
  790. * The client must enable &DRM_CLIENT_CAP_ATOMIC first.
  791. *
  792. * Setting this property on drivers which do not special case
  793. * cursor planes (i.e. non-virtualized drivers) will return
  794. * EOPNOTSUPP, which can be used by userspace to gauge
  795. * requirements of the hardware/drivers they're running on.
  796. *
  797. * This capability is always supported for atomic-capable virtualized
  798. * drivers starting from kernel version 6.6.
  799. */
  800. #define DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT 6
  801. /* DRM_IOCTL_SET_CLIENT_CAP ioctl argument type */
  802. struct drm_set_client_cap {
  803. __u64 capability;
  804. __u64 value;
  805. };
  806. #define DRM_RDWR O_RDWR
  807. #define DRM_CLOEXEC O_CLOEXEC
  808. struct drm_prime_handle {
  809. __u32 handle;
  810. /** Flags.. only applicable for handle->fd */
  811. __u32 flags;
  812. /** Returned dmabuf file descriptor */
  813. __s32 fd;
  814. };
  815. struct drm_syncobj_create {
  816. __u32 handle;
  817. #define DRM_SYNCOBJ_CREATE_SIGNALED (1 << 0)
  818. __u32 flags;
  819. };
  820. struct drm_syncobj_destroy {
  821. __u32 handle;
  822. __u32 pad;
  823. };
  824. #define DRM_SYNCOBJ_FD_TO_HANDLE_FLAGS_IMPORT_SYNC_FILE (1 << 0)
  825. #define DRM_SYNCOBJ_HANDLE_TO_FD_FLAGS_EXPORT_SYNC_FILE (1 << 0)
  826. struct drm_syncobj_handle {
  827. __u32 handle;
  828. __u32 flags;
  829. __s32 fd;
  830. __u32 pad;
  831. };
  832. struct drm_syncobj_transfer {
  833. __u32 src_handle;
  834. __u32 dst_handle;
  835. __u64 src_point;
  836. __u64 dst_point;
  837. __u32 flags;
  838. __u32 pad;
  839. };
  840. #define DRM_SYNCOBJ_WAIT_FLAGS_WAIT_ALL (1 << 0)
  841. #define DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT (1 << 1)
  842. #define DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE (1 << 2) /* wait for time point to become available */
  843. #define DRM_SYNCOBJ_WAIT_FLAGS_WAIT_DEADLINE (1 << 3) /* set fence deadline to deadline_nsec */
  844. struct drm_syncobj_wait {
  845. __u64 handles;
  846. /* absolute timeout */
  847. __s64 timeout_nsec;
  848. __u32 count_handles;
  849. __u32 flags;
  850. __u32 first_signaled; /* only valid when not waiting all */
  851. __u32 pad;
  852. /**
  853. * @deadline_nsec - fence deadline hint
  854. *
  855. * Deadline hint, in absolute CLOCK_MONOTONIC, to set on backing
  856. * fence(s) if the DRM_SYNCOBJ_WAIT_FLAGS_WAIT_DEADLINE flag is
  857. * set.
  858. */
  859. __u64 deadline_nsec;
  860. };
  861. struct drm_syncobj_timeline_wait {
  862. __u64 handles;
  863. /* wait on specific timeline point for every handles*/
  864. __u64 points;
  865. /* absolute timeout */
  866. __s64 timeout_nsec;
  867. __u32 count_handles;
  868. __u32 flags;
  869. __u32 first_signaled; /* only valid when not waiting all */
  870. __u32 pad;
  871. /**
  872. * @deadline_nsec - fence deadline hint
  873. *
  874. * Deadline hint, in absolute CLOCK_MONOTONIC, to set on backing
  875. * fence(s) if the DRM_SYNCOBJ_WAIT_FLAGS_WAIT_DEADLINE flag is
  876. * set.
  877. */
  878. __u64 deadline_nsec;
  879. };
  880. /**
  881. * struct drm_syncobj_eventfd
  882. * @handle: syncobj handle.
  883. * @flags: Zero to wait for the point to be signalled, or
  884. * &DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE to wait for a fence to be
  885. * available for the point.
  886. * @point: syncobj timeline point (set to zero for binary syncobjs).
  887. * @fd: Existing eventfd to sent events to.
  888. * @pad: Must be zero.
  889. *
  890. * Register an eventfd to be signalled by a syncobj. The eventfd counter will
  891. * be incremented by one.
  892. */
  893. struct drm_syncobj_eventfd {
  894. __u32 handle;
  895. __u32 flags;
  896. __u64 point;
  897. __s32 fd;
  898. __u32 pad;
  899. };
  900. struct drm_syncobj_array {
  901. __u64 handles;
  902. __u32 count_handles;
  903. __u32 pad;
  904. };
  905. #define DRM_SYNCOBJ_QUERY_FLAGS_LAST_SUBMITTED (1 << 0) /* last available point on timeline syncobj */
  906. struct drm_syncobj_timeline_array {
  907. __u64 handles;
  908. __u64 points;
  909. __u32 count_handles;
  910. __u32 flags;
  911. };
  912. /* Query current scanout sequence number */
  913. struct drm_crtc_get_sequence {
  914. __u32 crtc_id; /* requested crtc_id */
  915. __u32 active; /* return: crtc output is active */
  916. __u64 sequence; /* return: most recent vblank sequence */
  917. __s64 sequence_ns; /* return: most recent time of first pixel out */
  918. };
  919. /* Queue event to be delivered at specified sequence. Time stamp marks
  920. * when the first pixel of the refresh cycle leaves the display engine
  921. * for the display
  922. */
  923. #define DRM_CRTC_SEQUENCE_RELATIVE 0x00000001 /* sequence is relative to current */
  924. #define DRM_CRTC_SEQUENCE_NEXT_ON_MISS 0x00000002 /* Use next sequence if we've missed */
  925. struct drm_crtc_queue_sequence {
  926. __u32 crtc_id;
  927. __u32 flags;
  928. __u64 sequence; /* on input, target sequence. on output, actual sequence */
  929. __u64 user_data; /* user data passed to event */
  930. };
  931. #if defined(__cplusplus)
  932. }
  933. #endif
  934. #include "drm_mode.h"
  935. #if defined(__cplusplus)
  936. extern "C" {
  937. #endif
  938. #define DRM_IOCTL_BASE 'd'
  939. #define DRM_IO(nr) _IO(DRM_IOCTL_BASE,nr)
  940. #define DRM_IOR(nr,type) _IOR(DRM_IOCTL_BASE,nr,type)
  941. #define DRM_IOW(nr,type) _IOW(DRM_IOCTL_BASE,nr,type)
  942. #define DRM_IOWR(nr,type) _IOWR(DRM_IOCTL_BASE,nr,type)
  943. #define DRM_IOCTL_VERSION DRM_IOWR(0x00, struct drm_version)
  944. #define DRM_IOCTL_GET_UNIQUE DRM_IOWR(0x01, struct drm_unique)
  945. #define DRM_IOCTL_GET_MAGIC DRM_IOR( 0x02, struct drm_auth)
  946. #define DRM_IOCTL_IRQ_BUSID DRM_IOWR(0x03, struct drm_irq_busid)
  947. #define DRM_IOCTL_GET_MAP DRM_IOWR(0x04, struct drm_map)
  948. #define DRM_IOCTL_GET_CLIENT DRM_IOWR(0x05, struct drm_client)
  949. #define DRM_IOCTL_GET_STATS DRM_IOR( 0x06, struct drm_stats)
  950. #define DRM_IOCTL_SET_VERSION DRM_IOWR(0x07, struct drm_set_version)
  951. #define DRM_IOCTL_MODESET_CTL DRM_IOW(0x08, struct drm_modeset_ctl)
  952. /**
  953. * DRM_IOCTL_GEM_CLOSE - Close a GEM handle.
  954. *
  955. * GEM handles are not reference-counted by the kernel. User-space is
  956. * responsible for managing their lifetime. For example, if user-space imports
  957. * the same memory object twice on the same DRM file description, the same GEM
  958. * handle is returned by both imports, and user-space needs to ensure
  959. * &DRM_IOCTL_GEM_CLOSE is performed once only. The same situation can happen
  960. * when a memory object is allocated, then exported and imported again on the
  961. * same DRM file description. The &DRM_IOCTL_MODE_GETFB2 IOCTL is an exception
  962. * and always returns fresh new GEM handles even if an existing GEM handle
  963. * already refers to the same memory object before the IOCTL is performed.
  964. */
  965. #define DRM_IOCTL_GEM_CLOSE DRM_IOW (0x09, struct drm_gem_close)
  966. #define DRM_IOCTL_GEM_FLINK DRM_IOWR(0x0a, struct drm_gem_flink)
  967. #define DRM_IOCTL_GEM_OPEN DRM_IOWR(0x0b, struct drm_gem_open)
  968. #define DRM_IOCTL_GET_CAP DRM_IOWR(0x0c, struct drm_get_cap)
  969. #define DRM_IOCTL_SET_CLIENT_CAP DRM_IOW( 0x0d, struct drm_set_client_cap)
  970. #define DRM_IOCTL_SET_UNIQUE DRM_IOW( 0x10, struct drm_unique)
  971. #define DRM_IOCTL_AUTH_MAGIC DRM_IOW( 0x11, struct drm_auth)
  972. #define DRM_IOCTL_BLOCK DRM_IOWR(0x12, struct drm_block)
  973. #define DRM_IOCTL_UNBLOCK DRM_IOWR(0x13, struct drm_block)
  974. #define DRM_IOCTL_CONTROL DRM_IOW( 0x14, struct drm_control)
  975. #define DRM_IOCTL_ADD_MAP DRM_IOWR(0x15, struct drm_map)
  976. #define DRM_IOCTL_ADD_BUFS DRM_IOWR(0x16, struct drm_buf_desc)
  977. #define DRM_IOCTL_MARK_BUFS DRM_IOW( 0x17, struct drm_buf_desc)
  978. #define DRM_IOCTL_INFO_BUFS DRM_IOWR(0x18, struct drm_buf_info)
  979. #define DRM_IOCTL_MAP_BUFS DRM_IOWR(0x19, struct drm_buf_map)
  980. #define DRM_IOCTL_FREE_BUFS DRM_IOW( 0x1a, struct drm_buf_free)
  981. #define DRM_IOCTL_RM_MAP DRM_IOW( 0x1b, struct drm_map)
  982. #define DRM_IOCTL_SET_SAREA_CTX DRM_IOW( 0x1c, struct drm_ctx_priv_map)
  983. #define DRM_IOCTL_GET_SAREA_CTX DRM_IOWR(0x1d, struct drm_ctx_priv_map)
  984. #define DRM_IOCTL_SET_MASTER DRM_IO(0x1e)
  985. #define DRM_IOCTL_DROP_MASTER DRM_IO(0x1f)
  986. #define DRM_IOCTL_ADD_CTX DRM_IOWR(0x20, struct drm_ctx)
  987. #define DRM_IOCTL_RM_CTX DRM_IOWR(0x21, struct drm_ctx)
  988. #define DRM_IOCTL_MOD_CTX DRM_IOW( 0x22, struct drm_ctx)
  989. #define DRM_IOCTL_GET_CTX DRM_IOWR(0x23, struct drm_ctx)
  990. #define DRM_IOCTL_SWITCH_CTX DRM_IOW( 0x24, struct drm_ctx)
  991. #define DRM_IOCTL_NEW_CTX DRM_IOW( 0x25, struct drm_ctx)
  992. #define DRM_IOCTL_RES_CTX DRM_IOWR(0x26, struct drm_ctx_res)
  993. #define DRM_IOCTL_ADD_DRAW DRM_IOWR(0x27, struct drm_draw)
  994. #define DRM_IOCTL_RM_DRAW DRM_IOWR(0x28, struct drm_draw)
  995. #define DRM_IOCTL_DMA DRM_IOWR(0x29, struct drm_dma)
  996. #define DRM_IOCTL_LOCK DRM_IOW( 0x2a, struct drm_lock)
  997. #define DRM_IOCTL_UNLOCK DRM_IOW( 0x2b, struct drm_lock)
  998. #define DRM_IOCTL_FINISH DRM_IOW( 0x2c, struct drm_lock)
  999. /**
  1000. * DRM_IOCTL_PRIME_HANDLE_TO_FD - Convert a GEM handle to a DMA-BUF FD.
  1001. *
  1002. * User-space sets &drm_prime_handle.handle with the GEM handle to export and
  1003. * &drm_prime_handle.flags, and gets back a DMA-BUF file descriptor in
  1004. * &drm_prime_handle.fd.
  1005. *
  1006. * The export can fail for any driver-specific reason, e.g. because export is
  1007. * not supported for this specific GEM handle (but might be for others).
  1008. *
  1009. * Support for exporting DMA-BUFs is advertised via &DRM_PRIME_CAP_EXPORT.
  1010. */
  1011. #define DRM_IOCTL_PRIME_HANDLE_TO_FD DRM_IOWR(0x2d, struct drm_prime_handle)
  1012. /**
  1013. * DRM_IOCTL_PRIME_FD_TO_HANDLE - Convert a DMA-BUF FD to a GEM handle.
  1014. *
  1015. * User-space sets &drm_prime_handle.fd with a DMA-BUF file descriptor to
  1016. * import, and gets back a GEM handle in &drm_prime_handle.handle.
  1017. * &drm_prime_handle.flags is unused.
  1018. *
  1019. * If an existing GEM handle refers to the memory object backing the DMA-BUF,
  1020. * that GEM handle is returned. Therefore user-space which needs to handle
  1021. * arbitrary DMA-BUFs must have a user-space lookup data structure to manually
  1022. * reference-count duplicated GEM handles. For more information see
  1023. * &DRM_IOCTL_GEM_CLOSE.
  1024. *
  1025. * The import can fail for any driver-specific reason, e.g. because import is
  1026. * only supported for DMA-BUFs allocated on this DRM device.
  1027. *
  1028. * Support for importing DMA-BUFs is advertised via &DRM_PRIME_CAP_IMPORT.
  1029. */
  1030. #define DRM_IOCTL_PRIME_FD_TO_HANDLE DRM_IOWR(0x2e, struct drm_prime_handle)
  1031. #define DRM_IOCTL_AGP_ACQUIRE DRM_IO( 0x30)
  1032. #define DRM_IOCTL_AGP_RELEASE DRM_IO( 0x31)
  1033. #define DRM_IOCTL_AGP_ENABLE DRM_IOW( 0x32, struct drm_agp_mode)
  1034. #define DRM_IOCTL_AGP_INFO DRM_IOR( 0x33, struct drm_agp_info)
  1035. #define DRM_IOCTL_AGP_ALLOC DRM_IOWR(0x34, struct drm_agp_buffer)
  1036. #define DRM_IOCTL_AGP_FREE DRM_IOW( 0x35, struct drm_agp_buffer)
  1037. #define DRM_IOCTL_AGP_BIND DRM_IOW( 0x36, struct drm_agp_binding)
  1038. #define DRM_IOCTL_AGP_UNBIND DRM_IOW( 0x37, struct drm_agp_binding)
  1039. #define DRM_IOCTL_SG_ALLOC DRM_IOWR(0x38, struct drm_scatter_gather)
  1040. #define DRM_IOCTL_SG_FREE DRM_IOW( 0x39, struct drm_scatter_gather)
  1041. #define DRM_IOCTL_WAIT_VBLANK DRM_IOWR(0x3a, union drm_wait_vblank)
  1042. #define DRM_IOCTL_CRTC_GET_SEQUENCE DRM_IOWR(0x3b, struct drm_crtc_get_sequence)
  1043. #define DRM_IOCTL_CRTC_QUEUE_SEQUENCE DRM_IOWR(0x3c, struct drm_crtc_queue_sequence)
  1044. #define DRM_IOCTL_UPDATE_DRAW DRM_IOW(0x3f, struct drm_update_draw)
  1045. #define DRM_IOCTL_MODE_GETRESOURCES DRM_IOWR(0xA0, struct drm_mode_card_res)
  1046. #define DRM_IOCTL_MODE_GETCRTC DRM_IOWR(0xA1, struct drm_mode_crtc)
  1047. #define DRM_IOCTL_MODE_SETCRTC DRM_IOWR(0xA2, struct drm_mode_crtc)
  1048. #define DRM_IOCTL_MODE_CURSOR DRM_IOWR(0xA3, struct drm_mode_cursor)
  1049. #define DRM_IOCTL_MODE_GETGAMMA DRM_IOWR(0xA4, struct drm_mode_crtc_lut)
  1050. #define DRM_IOCTL_MODE_SETGAMMA DRM_IOWR(0xA5, struct drm_mode_crtc_lut)
  1051. #define DRM_IOCTL_MODE_GETENCODER DRM_IOWR(0xA6, struct drm_mode_get_encoder)
  1052. #define DRM_IOCTL_MODE_GETCONNECTOR DRM_IOWR(0xA7, struct drm_mode_get_connector)
  1053. #define DRM_IOCTL_MODE_ATTACHMODE DRM_IOWR(0xA8, struct drm_mode_mode_cmd) /* deprecated (never worked) */
  1054. #define DRM_IOCTL_MODE_DETACHMODE DRM_IOWR(0xA9, struct drm_mode_mode_cmd) /* deprecated (never worked) */
  1055. #define DRM_IOCTL_MODE_GETPROPERTY DRM_IOWR(0xAA, struct drm_mode_get_property)
  1056. #define DRM_IOCTL_MODE_SETPROPERTY DRM_IOWR(0xAB, struct drm_mode_connector_set_property)
  1057. #define DRM_IOCTL_MODE_GETPROPBLOB DRM_IOWR(0xAC, struct drm_mode_get_blob)
  1058. #define DRM_IOCTL_MODE_GETFB DRM_IOWR(0xAD, struct drm_mode_fb_cmd)
  1059. #define DRM_IOCTL_MODE_ADDFB DRM_IOWR(0xAE, struct drm_mode_fb_cmd)
  1060. /**
  1061. * DRM_IOCTL_MODE_RMFB - Remove a framebuffer.
  1062. *
  1063. * This removes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL
  1064. * argument is a framebuffer object ID.
  1065. *
  1066. * Warning: removing a framebuffer currently in-use on an enabled plane will
  1067. * disable that plane. The CRTC the plane is linked to may also be disabled
  1068. * (depending on driver capabilities).
  1069. */
  1070. #define DRM_IOCTL_MODE_RMFB DRM_IOWR(0xAF, unsigned int)
  1071. #define DRM_IOCTL_MODE_PAGE_FLIP DRM_IOWR(0xB0, struct drm_mode_crtc_page_flip)
  1072. #define DRM_IOCTL_MODE_DIRTYFB DRM_IOWR(0xB1, struct drm_mode_fb_dirty_cmd)
  1073. /**
  1074. * DRM_IOCTL_MODE_CREATE_DUMB - Create a new dumb buffer object.
  1075. *
  1076. * KMS dumb buffers provide a very primitive way to allocate a buffer object
  1077. * suitable for scanout and map it for software rendering. KMS dumb buffers are
  1078. * not suitable for hardware-accelerated rendering nor video decoding. KMS dumb
  1079. * buffers are not suitable to be displayed on any other device than the KMS
  1080. * device where they were allocated from. Also see
  1081. * :ref:`kms_dumb_buffer_objects`.
  1082. *
  1083. * The IOCTL argument is a struct drm_mode_create_dumb.
  1084. *
  1085. * User-space is expected to create a KMS dumb buffer via this IOCTL, then add
  1086. * it as a KMS framebuffer via &DRM_IOCTL_MODE_ADDFB and map it via
  1087. * &DRM_IOCTL_MODE_MAP_DUMB.
  1088. *
  1089. * &DRM_CAP_DUMB_BUFFER indicates whether this IOCTL is supported.
  1090. * &DRM_CAP_DUMB_PREFERRED_DEPTH and &DRM_CAP_DUMB_PREFER_SHADOW indicate
  1091. * driver preferences for dumb buffers.
  1092. */
  1093. #define DRM_IOCTL_MODE_CREATE_DUMB DRM_IOWR(0xB2, struct drm_mode_create_dumb)
  1094. #define DRM_IOCTL_MODE_MAP_DUMB DRM_IOWR(0xB3, struct drm_mode_map_dumb)
  1095. #define DRM_IOCTL_MODE_DESTROY_DUMB DRM_IOWR(0xB4, struct drm_mode_destroy_dumb)
  1096. #define DRM_IOCTL_MODE_GETPLANERESOURCES DRM_IOWR(0xB5, struct drm_mode_get_plane_res)
  1097. #define DRM_IOCTL_MODE_GETPLANE DRM_IOWR(0xB6, struct drm_mode_get_plane)
  1098. #define DRM_IOCTL_MODE_SETPLANE DRM_IOWR(0xB7, struct drm_mode_set_plane)
  1099. #define DRM_IOCTL_MODE_ADDFB2 DRM_IOWR(0xB8, struct drm_mode_fb_cmd2)
  1100. #define DRM_IOCTL_MODE_OBJ_GETPROPERTIES DRM_IOWR(0xB9, struct drm_mode_obj_get_properties)
  1101. #define DRM_IOCTL_MODE_OBJ_SETPROPERTY DRM_IOWR(0xBA, struct drm_mode_obj_set_property)
  1102. #define DRM_IOCTL_MODE_CURSOR2 DRM_IOWR(0xBB, struct drm_mode_cursor2)
  1103. #define DRM_IOCTL_MODE_ATOMIC DRM_IOWR(0xBC, struct drm_mode_atomic)
  1104. #define DRM_IOCTL_MODE_CREATEPROPBLOB DRM_IOWR(0xBD, struct drm_mode_create_blob)
  1105. #define DRM_IOCTL_MODE_DESTROYPROPBLOB DRM_IOWR(0xBE, struct drm_mode_destroy_blob)
  1106. #define DRM_IOCTL_SYNCOBJ_CREATE DRM_IOWR(0xBF, struct drm_syncobj_create)
  1107. #define DRM_IOCTL_SYNCOBJ_DESTROY DRM_IOWR(0xC0, struct drm_syncobj_destroy)
  1108. #define DRM_IOCTL_SYNCOBJ_HANDLE_TO_FD DRM_IOWR(0xC1, struct drm_syncobj_handle)
  1109. #define DRM_IOCTL_SYNCOBJ_FD_TO_HANDLE DRM_IOWR(0xC2, struct drm_syncobj_handle)
  1110. #define DRM_IOCTL_SYNCOBJ_WAIT DRM_IOWR(0xC3, struct drm_syncobj_wait)
  1111. #define DRM_IOCTL_SYNCOBJ_RESET DRM_IOWR(0xC4, struct drm_syncobj_array)
  1112. #define DRM_IOCTL_SYNCOBJ_SIGNAL DRM_IOWR(0xC5, struct drm_syncobj_array)
  1113. #define DRM_IOCTL_MODE_CREATE_LEASE DRM_IOWR(0xC6, struct drm_mode_create_lease)
  1114. #define DRM_IOCTL_MODE_LIST_LESSEES DRM_IOWR(0xC7, struct drm_mode_list_lessees)
  1115. #define DRM_IOCTL_MODE_GET_LEASE DRM_IOWR(0xC8, struct drm_mode_get_lease)
  1116. #define DRM_IOCTL_MODE_REVOKE_LEASE DRM_IOWR(0xC9, struct drm_mode_revoke_lease)
  1117. #define DRM_IOCTL_SYNCOBJ_TIMELINE_WAIT DRM_IOWR(0xCA, struct drm_syncobj_timeline_wait)
  1118. #define DRM_IOCTL_SYNCOBJ_QUERY DRM_IOWR(0xCB, struct drm_syncobj_timeline_array)
  1119. #define DRM_IOCTL_SYNCOBJ_TRANSFER DRM_IOWR(0xCC, struct drm_syncobj_transfer)
  1120. #define DRM_IOCTL_SYNCOBJ_TIMELINE_SIGNAL DRM_IOWR(0xCD, struct drm_syncobj_timeline_array)
  1121. /**
  1122. * DRM_IOCTL_MODE_GETFB2 - Get framebuffer metadata.
  1123. *
  1124. * This queries metadata about a framebuffer. User-space fills
  1125. * &drm_mode_fb_cmd2.fb_id as the input, and the kernels fills the rest of the
  1126. * struct as the output.
  1127. *
  1128. * If the client is DRM master or has &CAP_SYS_ADMIN, &drm_mode_fb_cmd2.handles
  1129. * will be filled with GEM buffer handles. Fresh new GEM handles are always
  1130. * returned, even if another GEM handle referring to the same memory object
  1131. * already exists on the DRM file description. The caller is responsible for
  1132. * removing the new handles, e.g. via the &DRM_IOCTL_GEM_CLOSE IOCTL. The same
  1133. * new handle will be returned for multiple planes in case they use the same
  1134. * memory object. Planes are valid until one has a zero handle -- this can be
  1135. * used to compute the number of planes.
  1136. *
  1137. * Otherwise, &drm_mode_fb_cmd2.handles will be zeroed and planes are valid
  1138. * until one has a zero &drm_mode_fb_cmd2.pitches.
  1139. *
  1140. * If the framebuffer has a format modifier, &DRM_MODE_FB_MODIFIERS will be set
  1141. * in &drm_mode_fb_cmd2.flags and &drm_mode_fb_cmd2.modifier will contain the
  1142. * modifier. Otherwise, user-space must ignore &drm_mode_fb_cmd2.modifier.
  1143. *
  1144. * To obtain DMA-BUF FDs for each plane without leaking GEM handles, user-space
  1145. * can export each handle via &DRM_IOCTL_PRIME_HANDLE_TO_FD, then immediately
  1146. * close each unique handle via &DRM_IOCTL_GEM_CLOSE, making sure to not
  1147. * double-close handles which are specified multiple times in the array.
  1148. */
  1149. #define DRM_IOCTL_MODE_GETFB2 DRM_IOWR(0xCE, struct drm_mode_fb_cmd2)
  1150. #define DRM_IOCTL_SYNCOBJ_EVENTFD DRM_IOWR(0xCF, struct drm_syncobj_eventfd)
  1151. /**
  1152. * DRM_IOCTL_MODE_CLOSEFB - Close a framebuffer.
  1153. *
  1154. * This closes a framebuffer previously added via ADDFB/ADDFB2. The IOCTL
  1155. * argument is a framebuffer object ID.
  1156. *
  1157. * This IOCTL is similar to &DRM_IOCTL_MODE_RMFB, except it doesn't disable
  1158. * planes and CRTCs. As long as the framebuffer is used by a plane, it's kept
  1159. * alive. When the plane no longer uses the framebuffer (because the
  1160. * framebuffer is replaced with another one, or the plane is disabled), the
  1161. * framebuffer is cleaned up.
  1162. *
  1163. * This is useful to implement flicker-free transitions between two processes.
  1164. *
  1165. * Depending on the threat model, user-space may want to ensure that the
  1166. * framebuffer doesn't expose any sensitive user information: closed
  1167. * framebuffers attached to a plane can be read back by the next DRM master.
  1168. */
  1169. #define DRM_IOCTL_MODE_CLOSEFB DRM_IOWR(0xD0, struct drm_mode_closefb)
  1170. /*
  1171. * Device specific ioctls should only be in their respective headers
  1172. * The device specific ioctl range is from 0x40 to 0x9f.
  1173. * Generic IOCTLS restart at 0xA0.
  1174. *
  1175. * \sa drmCommandNone(), drmCommandRead(), drmCommandWrite(), and
  1176. * drmCommandReadWrite().
  1177. */
  1178. #define DRM_COMMAND_BASE 0x40
  1179. #define DRM_COMMAND_END 0xA0
  1180. /**
  1181. * struct drm_event - Header for DRM events
  1182. * @type: event type.
  1183. * @length: total number of payload bytes (including header).
  1184. *
  1185. * This struct is a header for events written back to user-space on the DRM FD.
  1186. * A read on the DRM FD will always only return complete events: e.g. if the
  1187. * read buffer is 100 bytes large and there are two 64 byte events pending,
  1188. * only one will be returned.
  1189. *
  1190. * Event types 0 - 0x7fffffff are generic DRM events, 0x80000000 and
  1191. * up are chipset specific. Generic DRM events include &DRM_EVENT_VBLANK,
  1192. * &DRM_EVENT_FLIP_COMPLETE and &DRM_EVENT_CRTC_SEQUENCE.
  1193. */
  1194. struct drm_event {
  1195. __u32 type;
  1196. __u32 length;
  1197. };
  1198. /**
  1199. * DRM_EVENT_VBLANK - vertical blanking event
  1200. *
  1201. * This event is sent in response to &DRM_IOCTL_WAIT_VBLANK with the
  1202. * &_DRM_VBLANK_EVENT flag set.
  1203. *
  1204. * The event payload is a struct drm_event_vblank.
  1205. */
  1206. #define DRM_EVENT_VBLANK 0x01
  1207. /**
  1208. * DRM_EVENT_FLIP_COMPLETE - page-flip completion event
  1209. *
  1210. * This event is sent in response to an atomic commit or legacy page-flip with
  1211. * the &DRM_MODE_PAGE_FLIP_EVENT flag set.
  1212. *
  1213. * The event payload is a struct drm_event_vblank.
  1214. */
  1215. #define DRM_EVENT_FLIP_COMPLETE 0x02
  1216. /**
  1217. * DRM_EVENT_CRTC_SEQUENCE - CRTC sequence event
  1218. *
  1219. * This event is sent in response to &DRM_IOCTL_CRTC_QUEUE_SEQUENCE.
  1220. *
  1221. * The event payload is a struct drm_event_crtc_sequence.
  1222. */
  1223. #define DRM_EVENT_CRTC_SEQUENCE 0x03
  1224. struct drm_event_vblank {
  1225. struct drm_event base;
  1226. __u64 user_data;
  1227. __u32 tv_sec;
  1228. __u32 tv_usec;
  1229. __u32 sequence;
  1230. __u32 crtc_id; /* 0 on older kernels that do not support this */
  1231. };
  1232. /* Event delivered at sequence. Time stamp marks when the first pixel
  1233. * of the refresh cycle leaves the display engine for the display
  1234. */
  1235. struct drm_event_crtc_sequence {
  1236. struct drm_event base;
  1237. __u64 user_data;
  1238. __s64 time_ns;
  1239. __u64 sequence;
  1240. };
  1241. /* typedef area */
  1242. #ifndef __KERNEL__
  1243. typedef struct drm_clip_rect drm_clip_rect_t;
  1244. typedef struct drm_drawable_info drm_drawable_info_t;
  1245. typedef struct drm_tex_region drm_tex_region_t;
  1246. typedef struct drm_hw_lock drm_hw_lock_t;
  1247. typedef struct drm_version drm_version_t;
  1248. typedef struct drm_unique drm_unique_t;
  1249. typedef struct drm_list drm_list_t;
  1250. typedef struct drm_block drm_block_t;
  1251. typedef struct drm_control drm_control_t;
  1252. typedef enum drm_map_type drm_map_type_t;
  1253. typedef enum drm_map_flags drm_map_flags_t;
  1254. typedef struct drm_ctx_priv_map drm_ctx_priv_map_t;
  1255. typedef struct drm_map drm_map_t;
  1256. typedef struct drm_client drm_client_t;
  1257. typedef enum drm_stat_type drm_stat_type_t;
  1258. typedef struct drm_stats drm_stats_t;
  1259. typedef enum drm_lock_flags drm_lock_flags_t;
  1260. typedef struct drm_lock drm_lock_t;
  1261. typedef enum drm_dma_flags drm_dma_flags_t;
  1262. typedef struct drm_buf_desc drm_buf_desc_t;
  1263. typedef struct drm_buf_info drm_buf_info_t;
  1264. typedef struct drm_buf_free drm_buf_free_t;
  1265. typedef struct drm_buf_pub drm_buf_pub_t;
  1266. typedef struct drm_buf_map drm_buf_map_t;
  1267. typedef struct drm_dma drm_dma_t;
  1268. typedef union drm_wait_vblank drm_wait_vblank_t;
  1269. typedef struct drm_agp_mode drm_agp_mode_t;
  1270. typedef enum drm_ctx_flags drm_ctx_flags_t;
  1271. typedef struct drm_ctx drm_ctx_t;
  1272. typedef struct drm_ctx_res drm_ctx_res_t;
  1273. typedef struct drm_draw drm_draw_t;
  1274. typedef struct drm_update_draw drm_update_draw_t;
  1275. typedef struct drm_auth drm_auth_t;
  1276. typedef struct drm_irq_busid drm_irq_busid_t;
  1277. typedef enum drm_vblank_seq_type drm_vblank_seq_type_t;
  1278. typedef struct drm_agp_buffer drm_agp_buffer_t;
  1279. typedef struct drm_agp_binding drm_agp_binding_t;
  1280. typedef struct drm_agp_info drm_agp_info_t;
  1281. typedef struct drm_scatter_gather drm_scatter_gather_t;
  1282. typedef struct drm_set_version drm_set_version_t;
  1283. #endif
  1284. #if defined(__cplusplus)
  1285. }
  1286. #endif
  1287. #endif