]>
Commit | Line | Data |
---|---|---|
1da177e4 | 1 | /** |
b5e89ed5 | 2 | * \file drmP.h |
1da177e4 | 3 | * Private header for Direct Rendering Manager |
b5e89ed5 | 4 | * |
1da177e4 LT |
5 | * \author Rickard E. (Rik) Faith <faith@valinux.com> |
6 | * \author Gareth Hughes <gareth@valinux.com> | |
7 | */ | |
8 | ||
9 | /* | |
10 | * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas. | |
11 | * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California. | |
dcdb1674 | 12 | * Copyright (c) 2009-2010, Code Aurora Forum. |
1da177e4 LT |
13 | * All rights reserved. |
14 | * | |
15 | * Permission is hereby granted, free of charge, to any person obtaining a | |
16 | * copy of this software and associated documentation files (the "Software"), | |
17 | * to deal in the Software without restriction, including without limitation | |
18 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
19 | * and/or sell copies of the Software, and to permit persons to whom the | |
20 | * Software is furnished to do so, subject to the following conditions: | |
21 | * | |
22 | * The above copyright notice and this permission notice (including the next | |
23 | * paragraph) shall be included in all copies or substantial portions of the | |
24 | * Software. | |
25 | * | |
26 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
27 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
28 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
29 | * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR | |
30 | * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, | |
31 | * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR | |
32 | * OTHER DEALINGS IN THE SOFTWARE. | |
33 | */ | |
34 | ||
35 | #ifndef _DRM_P_H_ | |
36 | #define _DRM_P_H_ | |
37 | ||
2791ee85 | 38 | #include <linux/sched.h> |
1da177e4 | 39 | #include <linux/kernel.h> |
099d1c29 | 40 | #include <linux/kref.h> |
1da177e4 LT |
41 | #include <linux/miscdevice.h> |
42 | #include <linux/fs.h> | |
1da177e4 LT |
43 | #include <linux/init.h> |
44 | #include <linux/file.h> | |
dcdb1674 | 45 | #include <linux/platform_device.h> |
1da177e4 | 46 | #include <linux/pci.h> |
1da177e4 | 47 | #include <linux/jiffies.h> |
b05c2385 | 48 | #include <linux/dma-mapping.h> |
1da177e4 LT |
49 | #include <linux/mm.h> |
50 | #include <linux/cdev.h> | |
30e2fb18 | 51 | #include <linux/mutex.h> |
03dae7c5 | 52 | #include <linux/io.h> |
5a0e3ad6 | 53 | #include <linux/slab.h> |
5d13d425 | 54 | #include <linux/ratelimit.h> |
1da177e4 LT |
55 | #include <asm/mman.h> |
56 | #include <asm/uaccess.h> | |
1da177e4 LT |
57 | #include <linux/types.h> |
58 | #include <linux/agp_backend.h> | |
1da177e4 LT |
59 | #include <linux/workqueue.h> |
60 | #include <linux/poll.h> | |
61 | #include <asm/pgalloc.h> | |
19218e48 DH |
62 | #include <drm/drm.h> |
63 | #include <drm/drm_sarea.h> | |
0de23977 | 64 | #include <drm/drm_vma_manager.h> |
1da177e4 | 65 | |
62968144 DA |
66 | #include <linux/idr.h> |
67 | ||
1da177e4 | 68 | #define __OS_HAS_AGP (defined(CONFIG_AGP) || (defined(CONFIG_AGP_MODULE) && defined(MODULE))) |
1da177e4 | 69 | |
de477254 PG |
70 | struct module; |
71 | ||
c153f45f EA |
72 | struct drm_file; |
73 | struct drm_device; | |
cc5ea594 | 74 | struct drm_agp_head; |
c153f45f | 75 | |
edb37a95 | 76 | struct device_node; |
ebc64e45 | 77 | struct videomode; |
3aac4502 | 78 | struct reservation_object; |
ebc64e45 | 79 | |
a1ce3928 DH |
80 | #include <drm/drm_os_linux.h> |
81 | #include <drm/drm_hashtab.h> | |
82 | #include <drm/drm_mm.h> | |
1da177e4 | 83 | |
87fdff81 | 84 | /* |
1414b76c LD |
85 | * 4 debug categories are defined: |
86 | * | |
87 | * CORE: Used in the generic drm code: drm_ioctl.c, drm_mm.c, drm_memory.c, ... | |
88 | * This is the category used by the DRM_DEBUG() macro. | |
89 | * | |
90 | * DRIVER: Used in the vendor specific part of the driver: i915, radeon, ... | |
91 | * This is the category used by the DRM_DEBUG_DRIVER() macro. | |
87fdff81 | 92 | * |
1414b76c LD |
93 | * KMS: used in the modesetting code. |
94 | * This is the category used by the DRM_DEBUG_KMS() macro. | |
87fdff81 | 95 | * |
1414b76c LD |
96 | * PRIME: used in the prime code. |
97 | * This is the category used by the DRM_DEBUG_PRIME() macro. | |
87fdff81 | 98 | * |
1414b76c LD |
99 | * Enabling verbose debug messages is done through the drm.debug parameter, |
100 | * each category being enabled by a bit. | |
101 | * | |
102 | * drm.debug=0x1 will enable CORE messages | |
103 | * drm.debug=0x2 will enable DRIVER messages | |
104 | * drm.debug=0x3 will enable CORE and DRIVER messages | |
105 | * ... | |
106 | * drm.debug=0xf will enable all messages | |
107 | * | |
108 | * An interesting feature is that it's possible to enable verbose logging at | |
109 | * run-time by echoing the debug value in its sysfs node: | |
110 | * # echo 0xf > /sys/module/drm/parameters/debug | |
87fdff81 | 111 | */ |
1414b76c LD |
112 | #define DRM_UT_CORE 0x01 |
113 | #define DRM_UT_DRIVER 0x02 | |
114 | #define DRM_UT_KMS 0x04 | |
115 | #define DRM_UT_PRIME 0x08 | |
4fefcb27 | 116 | |
1287aa90 LD |
117 | extern __printf(2, 3) |
118 | void drm_ut_debug_printk(const char *function_name, | |
b9075fa9 JP |
119 | const char *format, ...); |
120 | extern __printf(2, 3) | |
5ad3d883 JP |
121 | int drm_err(const char *func, const char *format, ...); |
122 | ||
1da177e4 LT |
123 | /***********************************************************************/ |
124 | /** \name DRM template customization defaults */ | |
125 | /*@{*/ | |
126 | ||
127 | /* driver capabilities and requirements mask */ | |
128 | #define DRIVER_USE_AGP 0x1 | |
1da177e4 LT |
129 | #define DRIVER_PCI_DMA 0x8 |
130 | #define DRIVER_SG 0x10 | |
131 | #define DRIVER_HAVE_DMA 0x20 | |
132 | #define DRIVER_HAVE_IRQ 0x40 | |
133 | #define DRIVER_IRQ_SHARED 0x80 | |
673a394b | 134 | #define DRIVER_GEM 0x1000 |
f453ba04 | 135 | #define DRIVER_MODESET 0x2000 |
3248877e | 136 | #define DRIVER_PRIME 0x4000 |
1793126f | 137 | #define DRIVER_RENDER 0x8000 |
8410ea3b | 138 | |
1da177e4 LT |
139 | /***********************************************************************/ |
140 | /** \name Begin the DRM... */ | |
141 | /*@{*/ | |
142 | ||
143 | #define DRM_DEBUG_CODE 2 /**< Include debugging code if > 1, then | |
144 | also include looping detection. */ | |
145 | ||
8669cbc5 | 146 | #define DRM_MAGIC_HASH_ORDER 4 /**< Size of key hash table. Must be power of 2. */ |
1da177e4 | 147 | |
b5e89ed5 | 148 | /*@}*/ |
1da177e4 | 149 | |
1da177e4 LT |
150 | /***********************************************************************/ |
151 | /** \name Macros to make printk easier */ | |
152 | /*@{*/ | |
153 | ||
154 | /** | |
155 | * Error output. | |
156 | * | |
157 | * \param fmt printf() like format string. | |
158 | * \param arg arguments | |
159 | */ | |
5ad3d883 JP |
160 | #define DRM_ERROR(fmt, ...) \ |
161 | drm_err(__func__, fmt, ##__VA_ARGS__) | |
1da177e4 | 162 | |
5d13d425 RC |
163 | /** |
164 | * Rate limited error output. Like DRM_ERROR() but won't flood the log. | |
165 | * | |
166 | * \param fmt printf() like format string. | |
167 | * \param arg arguments | |
168 | */ | |
169 | #define DRM_ERROR_RATELIMITED(fmt, ...) \ | |
170 | ({ \ | |
171 | static DEFINE_RATELIMIT_STATE(_rs, \ | |
172 | DEFAULT_RATELIMIT_INTERVAL, \ | |
173 | DEFAULT_RATELIMIT_BURST); \ | |
174 | \ | |
175 | if (__ratelimit(&_rs)) \ | |
176 | drm_err(__func__, fmt, ##__VA_ARGS__); \ | |
177 | }) | |
178 | ||
5ad3d883 JP |
179 | #define DRM_INFO(fmt, ...) \ |
180 | printk(KERN_INFO "[" DRM_NAME "] " fmt, ##__VA_ARGS__) | |
1da177e4 | 181 | |
48b8f631 JN |
182 | #define DRM_INFO_ONCE(fmt, ...) \ |
183 | printk_once(KERN_INFO "[" DRM_NAME "] " fmt, ##__VA_ARGS__) | |
184 | ||
1da177e4 LT |
185 | /** |
186 | * Debug output. | |
b5e89ed5 | 187 | * |
1da177e4 LT |
188 | * \param fmt printf() like format string. |
189 | * \param arg arguments | |
190 | */ | |
191 | #if DRM_DEBUG_CODE | |
4fefcb27 | 192 | #define DRM_DEBUG(fmt, args...) \ |
1da177e4 | 193 | do { \ |
a73d4e91 | 194 | if (unlikely(drm_debug & DRM_UT_CORE)) \ |
1287aa90 | 195 | drm_ut_debug_printk(__func__, fmt, ##args); \ |
4fefcb27 | 196 | } while (0) |
197 | ||
8a4c47f3 | 198 | #define DRM_DEBUG_DRIVER(fmt, args...) \ |
4fefcb27 | 199 | do { \ |
a73d4e91 | 200 | if (unlikely(drm_debug & DRM_UT_DRIVER)) \ |
1287aa90 | 201 | drm_ut_debug_printk(__func__, fmt, ##args); \ |
4fefcb27 | 202 | } while (0) |
a73d4e91 | 203 | #define DRM_DEBUG_KMS(fmt, args...) \ |
4fefcb27 | 204 | do { \ |
a73d4e91 | 205 | if (unlikely(drm_debug & DRM_UT_KMS)) \ |
1287aa90 | 206 | drm_ut_debug_printk(__func__, fmt, ##args); \ |
4fefcb27 | 207 | } while (0) |
3248877e DA |
208 | #define DRM_DEBUG_PRIME(fmt, args...) \ |
209 | do { \ | |
a73d4e91 | 210 | if (unlikely(drm_debug & DRM_UT_PRIME)) \ |
1287aa90 | 211 | drm_ut_debug_printk(__func__, fmt, ##args); \ |
1da177e4 LT |
212 | } while (0) |
213 | #else | |
8a4c47f3 ZY |
214 | #define DRM_DEBUG_DRIVER(fmt, args...) do { } while (0) |
215 | #define DRM_DEBUG_KMS(fmt, args...) do { } while (0) | |
3248877e | 216 | #define DRM_DEBUG_PRIME(fmt, args...) do { } while (0) |
1da177e4 LT |
217 | #define DRM_DEBUG(fmt, arg...) do { } while (0) |
218 | #endif | |
219 | ||
1da177e4 LT |
220 | /*@}*/ |
221 | ||
1da177e4 LT |
222 | /***********************************************************************/ |
223 | /** \name Internal types and structures */ | |
224 | /*@{*/ | |
225 | ||
1da177e4 | 226 | #define DRM_IF_VERSION(maj, min) (maj << 16 | min) |
1da177e4 LT |
227 | |
228 | /** | |
229 | * Test that the hardware lock is held by the caller, returning otherwise. | |
230 | * | |
231 | * \param dev DRM device. | |
232 | * \param filp file pointer of the caller. | |
233 | */ | |
dcae3626 RK |
234 | #define LOCK_TEST_WITH_RETURN( dev, _file_priv ) \ |
235 | do { \ | |
236 | if (!_DRM_LOCK_IS_HELD(_file_priv->master->lock.hw_lock->lock) || \ | |
237 | _file_priv->master->lock.file_priv != _file_priv) { \ | |
c153f45f | 238 | DRM_ERROR( "%s called without lock held, held %d owner %p %p\n",\ |
dcae3626 RK |
239 | __func__, _DRM_LOCK_IS_HELD(_file_priv->master->lock.hw_lock->lock),\ |
240 | _file_priv->master->lock.file_priv, _file_priv); \ | |
241 | return -EINVAL; \ | |
242 | } \ | |
1da177e4 LT |
243 | } while (0) |
244 | ||
1da177e4 LT |
245 | /** |
246 | * Ioctl function type. | |
247 | * | |
248 | * \param inode device inode. | |
6c340eac | 249 | * \param file_priv DRM file private pointer. |
1da177e4 LT |
250 | * \param cmd command. |
251 | * \param arg argument. | |
252 | */ | |
c153f45f EA |
253 | typedef int drm_ioctl_t(struct drm_device *dev, void *data, |
254 | struct drm_file *file_priv); | |
1da177e4 | 255 | |
9a186645 DA |
256 | typedef int drm_ioctl_compat_t(struct file *filp, unsigned int cmd, |
257 | unsigned long arg); | |
258 | ||
1a95916f KH |
259 | #define DRM_IOCTL_NR(n) _IOC_NR(n) |
260 | #define DRM_MAJOR 226 | |
261 | ||
a7a2cc31 DA |
262 | #define DRM_AUTH 0x1 |
263 | #define DRM_MASTER 0x2 | |
264 | #define DRM_ROOT_ONLY 0x4 | |
f453ba04 | 265 | #define DRM_CONTROL_ALLOW 0x8 |
ed8b6704 | 266 | #define DRM_UNLOCKED 0x10 |
1793126f | 267 | #define DRM_RENDER_ALLOW 0x20 |
a7a2cc31 | 268 | |
c153f45f EA |
269 | struct drm_ioctl_desc { |
270 | unsigned int cmd; | |
a7a2cc31 | 271 | int flags; |
c972d750 | 272 | drm_ioctl_t *func; |
1b2f1489 | 273 | unsigned int cmd_drv; |
b9434d0f | 274 | const char *name; |
c153f45f EA |
275 | }; |
276 | ||
277 | /** | |
278 | * Creates a driver or general drm_ioctl_desc array entry for the given | |
279 | * ioctl, for use by drm_ioctl(). | |
280 | */ | |
1b2f1489 DA |
281 | |
282 | #define DRM_IOCTL_DEF_DRV(ioctl, _func, _flags) \ | |
b9434d0f | 283 | [DRM_IOCTL_NR(DRM_##ioctl)] = {.cmd = DRM_##ioctl, .func = _func, .flags = _flags, .cmd_drv = DRM_IOCTL_##ioctl, .name = #ioctl} |
1da177e4 | 284 | |
1da177e4 LT |
285 | /** |
286 | * DMA buffer. | |
287 | */ | |
056219e2 | 288 | struct drm_buf { |
b5e89ed5 DA |
289 | int idx; /**< Index into master buflist */ |
290 | int total; /**< Buffer size */ | |
291 | int order; /**< log-base-2(total) */ | |
292 | int used; /**< Amount of buffer in use (for DMA) */ | |
293 | unsigned long offset; /**< Byte offset (used internally) */ | |
294 | void *address; /**< Address of buffer */ | |
295 | unsigned long bus_address; /**< Bus address of buffer */ | |
296 | struct drm_buf *next; /**< Kernel-only: used for free list */ | |
297 | __volatile__ int waiting; /**< On kernel DMA queue */ | |
298 | __volatile__ int pending; /**< On hardware DMA queue */ | |
6c340eac | 299 | struct drm_file *file_priv; /**< Private of holding file descr */ |
b5e89ed5 DA |
300 | int context; /**< Kernel queue for this buffer */ |
301 | int while_locked; /**< Dispatch this buffer while locked */ | |
1da177e4 | 302 | enum { |
b5e89ed5 DA |
303 | DRM_LIST_NONE = 0, |
304 | DRM_LIST_FREE = 1, | |
305 | DRM_LIST_WAIT = 2, | |
306 | DRM_LIST_PEND = 3, | |
307 | DRM_LIST_PRIO = 4, | |
1da177e4 | 308 | DRM_LIST_RECLAIM = 5 |
b5e89ed5 | 309 | } list; /**< Which list we're on */ |
1da177e4 | 310 | |
b5e89ed5 DA |
311 | int dev_priv_size; /**< Size of buffer private storage */ |
312 | void *dev_private; /**< Per-buffer private storage */ | |
056219e2 | 313 | }; |
1da177e4 | 314 | |
ddf19b97 DA |
315 | typedef struct drm_dma_handle { |
316 | dma_addr_t busaddr; | |
317 | void *vaddr; | |
318 | size_t size; | |
319 | } drm_dma_handle_t; | |
320 | ||
1da177e4 LT |
321 | /** |
322 | * Buffer entry. There is one of this for each buffer size order. | |
323 | */ | |
cdd55a29 | 324 | struct drm_buf_entry { |
b5e89ed5 DA |
325 | int buf_size; /**< size */ |
326 | int buf_count; /**< number of buffers */ | |
056219e2 | 327 | struct drm_buf *buflist; /**< buffer list */ |
b5e89ed5 DA |
328 | int seg_count; |
329 | int page_order; | |
cdd55a29 | 330 | struct drm_dma_handle **seglist; |
b5e89ed5 | 331 | |
b008c0fc DH |
332 | int low_mark; /**< Low water mark */ |
333 | int high_mark; /**< High water mark */ | |
cdd55a29 | 334 | }; |
1da177e4 | 335 | |
c9a9c5e0 KH |
336 | /* Event queued up for userspace to read */ |
337 | struct drm_pending_event { | |
338 | struct drm_event *event; | |
339 | struct list_head link; | |
340 | struct drm_file *file_priv; | |
b9c2c9ae JB |
341 | pid_t pid; /* pid of requester, no guarantee it's valid by the time |
342 | we deliver the event, for tracing only */ | |
c9a9c5e0 KH |
343 | void (*destroy)(struct drm_pending_event *event); |
344 | }; | |
345 | ||
3248877e DA |
346 | /* initial implementaton using a linked list - todo hashtab */ |
347 | struct drm_prime_file_private { | |
348 | struct list_head head; | |
349 | struct mutex lock; | |
350 | }; | |
351 | ||
1da177e4 | 352 | /** File private data */ |
84b1fd10 | 353 | struct drm_file { |
39868bd7 | 354 | unsigned authenticated :1; |
c996fd0b TH |
355 | /* Whether we're master for a minor. Protected by master_mutex */ |
356 | unsigned is_master :1; | |
39868bd7 CW |
357 | /* true when the client has asked us to expose stereo 3D mode flags */ |
358 | unsigned stereo_allowed :1; | |
681e7ec7 MR |
359 | /* |
360 | * true if client understands CRTC primary planes and cursor planes | |
361 | * in the plane list | |
362 | */ | |
363 | unsigned universal_planes:1; | |
39868bd7 | 364 | |
5fce5e0b EB |
365 | struct pid *pid; |
366 | kuid_t uid; | |
b5e89ed5 | 367 | drm_magic_t magic; |
bd1b331f | 368 | struct list_head lhead; |
2c14f28b | 369 | struct drm_minor *minor; |
b5e89ed5 | 370 | unsigned long lock_count; |
7c1c2871 | 371 | |
673a394b EA |
372 | /** Mapping of mm object handles to object pointers. */ |
373 | struct idr object_idr; | |
374 | /** Lock for synchronization of access to object_idr. */ | |
375 | spinlock_t table_lock; | |
7c1c2871 | 376 | |
6c340eac | 377 | struct file *filp; |
8562b3f2 | 378 | void *driver_priv; |
7c1c2871 | 379 | |
7c1c2871 DA |
380 | struct drm_master *master; /* master this node is currently associated with |
381 | N.B. not always minor->master */ | |
4b096ac1 DV |
382 | /** |
383 | * fbs - List of framebuffers associated with this file. | |
384 | * | |
385 | * Protected by fbs_lock. Note that the fbs list holds a reference on | |
386 | * the fb object to prevent it from untimely disappearing. | |
387 | */ | |
f453ba04 | 388 | struct list_head fbs; |
4b096ac1 | 389 | struct mutex fbs_lock; |
c9a9c5e0 KH |
390 | |
391 | wait_queue_head_t event_wait; | |
392 | struct list_head event_list; | |
393 | int event_space; | |
3248877e DA |
394 | |
395 | struct drm_prime_file_private prime; | |
84b1fd10 | 396 | }; |
1da177e4 | 397 | |
1da177e4 LT |
398 | /** |
399 | * Lock data. | |
400 | */ | |
55910517 | 401 | struct drm_lock_data { |
c60ce623 | 402 | struct drm_hw_lock *hw_lock; /**< Hardware lock */ |
8562b3f2 DA |
403 | /** Private of lock holder's file (NULL=kernel) */ |
404 | struct drm_file *file_priv; | |
1da177e4 | 405 | wait_queue_head_t lock_queue; /**< Queue of blocked processes */ |
b5e89ed5 | 406 | unsigned long lock_time; /**< Time of last lock in jiffies */ |
040ac320 TH |
407 | spinlock_t spinlock; |
408 | uint32_t kernel_waiters; | |
409 | uint32_t user_waiters; | |
410 | int idle_has_lock; | |
55910517 | 411 | }; |
1da177e4 LT |
412 | |
413 | /** | |
414 | * DMA data. | |
415 | */ | |
cdd55a29 | 416 | struct drm_device_dma { |
1da177e4 | 417 | |
cdd55a29 | 418 | struct drm_buf_entry bufs[DRM_MAX_ORDER + 1]; /**< buffers, grouped by their size order */ |
b5e89ed5 | 419 | int buf_count; /**< total number of buffers */ |
056219e2 | 420 | struct drm_buf **buflist; /**< Vector of pointers into drm_device_dma::bufs */ |
b5e89ed5 DA |
421 | int seg_count; |
422 | int page_count; /**< number of pages */ | |
423 | unsigned long *pagelist; /**< page list */ | |
424 | unsigned long byte_count; | |
1da177e4 LT |
425 | enum { |
426 | _DRM_DMA_USE_AGP = 0x01, | |
b5e89ed5 | 427 | _DRM_DMA_USE_SG = 0x02, |
3417f33e GS |
428 | _DRM_DMA_USE_FB = 0x04, |
429 | _DRM_DMA_USE_PCI_RO = 0x08 | |
1da177e4 LT |
430 | } flags; |
431 | ||
cdd55a29 | 432 | }; |
1da177e4 | 433 | |
1da177e4 LT |
434 | /** |
435 | * Scatter-gather memory. | |
436 | */ | |
55910517 | 437 | struct drm_sg_mem { |
b5e89ed5 DA |
438 | unsigned long handle; |
439 | void *virtual; | |
440 | int pages; | |
441 | struct page **pagelist; | |
442 | dma_addr_t *busaddr; | |
55910517 | 443 | }; |
1da177e4 | 444 | |
55910517 | 445 | struct drm_sigdata { |
b5e89ed5 | 446 | int context; |
c60ce623 | 447 | struct drm_hw_lock *lock; |
55910517 | 448 | }; |
1da177e4 | 449 | |
8562b3f2 | 450 | |
f77d390c BH |
451 | /** |
452 | * Kernel side of a mapping | |
453 | */ | |
454 | struct drm_local_map { | |
41c2e75e | 455 | resource_size_t offset; /**< Requested physical address (0 for SAREA)*/ |
f77d390c BH |
456 | unsigned long size; /**< Requested physical size (bytes) */ |
457 | enum drm_map_type type; /**< Type of memory to map */ | |
458 | enum drm_map_flags flags; /**< Flags */ | |
459 | void *handle; /**< User-space: "Handle" to pass to mmap() */ | |
460 | /**< Kernel-space: kernel-virtual address */ | |
461 | int mtrr; /**< MTRR slot used */ | |
462 | }; | |
463 | ||
464 | typedef struct drm_local_map drm_local_map_t; | |
465 | ||
1da177e4 LT |
466 | /** |
467 | * Mappings list | |
468 | */ | |
55910517 | 469 | struct drm_map_list { |
b5e89ed5 | 470 | struct list_head head; /**< list head */ |
e0be428e | 471 | struct drm_hash_item hash; |
f77d390c | 472 | struct drm_local_map *map; /**< mapping */ |
8562b3f2 | 473 | uint64_t user_token; |
7c1c2871 | 474 | struct drm_master *master; |
55910517 | 475 | }; |
1da177e4 | 476 | |
ea98a92f DA |
477 | /* location of GART table */ |
478 | #define DRM_ATI_GART_MAIN 1 | |
479 | #define DRM_ATI_GART_FB 2 | |
480 | ||
f2b04cd2 DA |
481 | #define DRM_ATI_GART_PCI 1 |
482 | #define DRM_ATI_GART_PCIE 2 | |
483 | #define DRM_ATI_GART_IGP 3 | |
484 | ||
55910517 | 485 | struct drm_ati_pcigart_info { |
ea98a92f | 486 | int gart_table_location; |
f2b04cd2 | 487 | int gart_reg_if; |
f26c473c | 488 | void *addr; |
ea98a92f | 489 | dma_addr_t bus_addr; |
b05c2385 DA |
490 | dma_addr_t table_mask; |
491 | struct drm_dma_handle *table_handle; | |
f77d390c | 492 | struct drm_local_map mapping; |
f2b04cd2 | 493 | int table_size; |
55910517 | 494 | }; |
ea98a92f | 495 | |
673a394b EA |
496 | /** |
497 | * This structure defines the drm_mm memory object, which will be used by the | |
498 | * DRM for its buffer objects. | |
499 | */ | |
500 | struct drm_gem_object { | |
501 | /** Reference count of this object */ | |
502 | struct kref refcount; | |
503 | ||
a8e11d1c DV |
504 | /** |
505 | * handle_count - gem file_priv handle count of this object | |
506 | * | |
507 | * Each handle also holds a reference. Note that when the handle_count | |
508 | * drops to 0 any global names (e.g. the id in the flink namespace) will | |
509 | * be cleared. | |
510 | * | |
511 | * Protected by dev->object_name_lock. | |
512 | * */ | |
513 | unsigned handle_count; | |
673a394b EA |
514 | |
515 | /** Related drm device */ | |
516 | struct drm_device *dev; | |
517 | ||
518 | /** File representing the shmem storage */ | |
519 | struct file *filp; | |
520 | ||
a2c0a97b | 521 | /* Mapping info for this object */ |
0de23977 | 522 | struct drm_vma_offset_node vma_node; |
a2c0a97b | 523 | |
673a394b EA |
524 | /** |
525 | * Size of the object, in bytes. Immutable over the object's | |
526 | * lifetime. | |
527 | */ | |
528 | size_t size; | |
529 | ||
530 | /** | |
531 | * Global name for this object, starts at 1. 0 means unnamed. | |
532 | * Access is covered by the object_name_lock in the related drm_device | |
533 | */ | |
534 | int name; | |
535 | ||
536 | /** | |
537 | * Memory domains. These monitor which caches contain read/write data | |
538 | * related to the object. When transitioning from one set of domains | |
539 | * to another, the driver is called to ensure that caches are suitably | |
540 | * flushed and invalidated | |
541 | */ | |
542 | uint32_t read_domains; | |
543 | uint32_t write_domain; | |
544 | ||
545 | /** | |
546 | * While validating an exec operation, the | |
547 | * new read/write domain values are computed here. | |
548 | * They will be transferred to the above values | |
549 | * at the point that any cache flushing occurs | |
550 | */ | |
551 | uint32_t pending_read_domains; | |
552 | uint32_t pending_write_domain; | |
553 | ||
319c933c DV |
554 | /** |
555 | * dma_buf - dma buf associated with this GEM object | |
556 | * | |
557 | * Pointer to the dma-buf associated with this gem object (either | |
558 | * through importing or exporting). We break the resulting reference | |
559 | * loop when the last gem handle for this object is released. | |
560 | * | |
561 | * Protected by obj->object_name_lock | |
562 | */ | |
563 | struct dma_buf *dma_buf; | |
3248877e | 564 | |
7106bf96 DV |
565 | /** |
566 | * import_attach - dma buf attachment backing this object | |
567 | * | |
568 | * Any foreign dma_buf imported as a gem object has this set to the | |
569 | * attachment point for the device. This is invariant over the lifetime | |
570 | * of a gem object. | |
571 | * | |
572 | * The driver's ->gem_free_object callback is responsible for cleaning | |
573 | * up the dma_buf attachment and references acquired at import time. | |
838cd445 DV |
574 | * |
575 | * Note that the drm gem/prime core does not depend upon drivers setting | |
576 | * this field any more. So for drivers where this doesn't make sense | |
577 | * (e.g. virtual devices or a displaylink behind an usb bus) they can | |
578 | * simply leave it as NULL. | |
7106bf96 | 579 | */ |
3248877e | 580 | struct dma_buf_attachment *import_attach; |
673a394b EA |
581 | }; |
582 | ||
a1ce3928 | 583 | #include <drm/drm_crtc.h> |
f453ba04 | 584 | |
c996fd0b TH |
585 | /** |
586 | * struct drm_master - drm master structure | |
587 | * | |
588 | * @refcount: Refcount for this master object. | |
589 | * @minor: Link back to minor char device we are master for. Immutable. | |
590 | * @unique: Unique identifier: e.g. busid. Protected by drm_global_mutex. | |
591 | * @unique_len: Length of unique field. Protected by drm_global_mutex. | |
592 | * @unique_size: Amount allocated. Protected by drm_global_mutex. | |
593 | * @magiclist: Hash of used authentication tokens. Protected by struct_mutex. | |
594 | * @magicfree: List of used authentication tokens. Protected by struct_mutex. | |
595 | * @lock: DRI lock information. | |
596 | * @driver_priv: Pointer to driver-private information. | |
597 | */ | |
7c1c2871 | 598 | struct drm_master { |
c996fd0b TH |
599 | struct kref refcount; |
600 | struct drm_minor *minor; | |
601 | char *unique; | |
602 | int unique_len; | |
603 | int unique_size; | |
7c1c2871 DA |
604 | struct drm_open_hash magiclist; |
605 | struct list_head magicfree; | |
c996fd0b TH |
606 | struct drm_lock_data lock; |
607 | void *driver_priv; | |
7c1c2871 DA |
608 | }; |
609 | ||
27641c3f MK |
610 | /* Size of ringbuffer for vblank timestamps. Just double-buffer |
611 | * in initial implementation. | |
612 | */ | |
613 | #define DRM_VBLANKTIME_RBSIZE 2 | |
614 | ||
615 | /* Flags and return codes for get_vblank_timestamp() driver function. */ | |
616 | #define DRM_CALLED_FROM_VBLIRQ 1 | |
617 | #define DRM_VBLANKTIME_SCANOUTPOS_METHOD (1 << 0) | |
618 | #define DRM_VBLANKTIME_INVBL (1 << 1) | |
619 | ||
620 | /* get_scanout_position() return flags */ | |
621 | #define DRM_SCANOUTPOS_VALID (1 << 0) | |
622 | #define DRM_SCANOUTPOS_INVBL (1 << 1) | |
623 | #define DRM_SCANOUTPOS_ACCURATE (1 << 2) | |
624 | ||
8410ea3b | 625 | struct drm_bus { |
8410ea3b | 626 | int (*set_busid)(struct drm_device *dev, struct drm_master *master); |
8410ea3b DA |
627 | }; |
628 | ||
1da177e4 LT |
629 | /** |
630 | * DRM driver structure. This structure represent the common code for | |
631 | * a family of cards. There will one drm_device for each card present | |
632 | * in this family | |
633 | */ | |
1da177e4 | 634 | struct drm_driver { |
22eae947 DA |
635 | int (*load) (struct drm_device *, unsigned long flags); |
636 | int (*firstopen) (struct drm_device *); | |
84b1fd10 | 637 | int (*open) (struct drm_device *, struct drm_file *); |
6c340eac | 638 | void (*preclose) (struct drm_device *, struct drm_file *file_priv); |
84b1fd10 | 639 | void (*postclose) (struct drm_device *, struct drm_file *); |
22eae947 DA |
640 | void (*lastclose) (struct drm_device *); |
641 | int (*unload) (struct drm_device *); | |
b932ccb5 | 642 | int (*suspend) (struct drm_device *, pm_message_t state); |
e8b962b6 | 643 | int (*resume) (struct drm_device *); |
c153f45f | 644 | int (*dma_ioctl) (struct drm_device *dev, void *data, struct drm_file *file_priv); |
b5e89ed5 | 645 | int (*dma_quiescent) (struct drm_device *); |
84b1fd10 | 646 | int (*context_dtor) (struct drm_device *dev, int context); |
b5e89ed5 | 647 | |
0a3e67a4 JB |
648 | /** |
649 | * get_vblank_counter - get raw hardware vblank counter | |
650 | * @dev: DRM device | |
651 | * @crtc: counter to fetch | |
652 | * | |
3b02ab88 LP |
653 | * Driver callback for fetching a raw hardware vblank counter for @crtc. |
654 | * If a device doesn't have a hardware counter, the driver can simply | |
655 | * return the value of drm_vblank_count. The DRM core will account for | |
656 | * missed vblank events while interrupts where disabled based on system | |
657 | * timestamps. | |
0a3e67a4 JB |
658 | * |
659 | * Wraparound handling and loss of events due to modesetting is dealt | |
660 | * with in the DRM core code. | |
661 | * | |
662 | * RETURNS | |
663 | * Raw vblank counter value. | |
664 | */ | |
665 | u32 (*get_vblank_counter) (struct drm_device *dev, int crtc); | |
666 | ||
667 | /** | |
668 | * enable_vblank - enable vblank interrupt events | |
669 | * @dev: DRM device | |
670 | * @crtc: which irq to enable | |
671 | * | |
672 | * Enable vblank interrupts for @crtc. If the device doesn't have | |
673 | * a hardware vblank counter, this routine should be a no-op, since | |
674 | * interrupts will have to stay on to keep the count accurate. | |
675 | * | |
676 | * RETURNS | |
677 | * Zero on success, appropriate errno if the given @crtc's vblank | |
678 | * interrupt cannot be enabled. | |
679 | */ | |
680 | int (*enable_vblank) (struct drm_device *dev, int crtc); | |
681 | ||
682 | /** | |
683 | * disable_vblank - disable vblank interrupt events | |
684 | * @dev: DRM device | |
685 | * @crtc: which irq to enable | |
686 | * | |
687 | * Disable vblank interrupts for @crtc. If the device doesn't have | |
688 | * a hardware vblank counter, this routine should be a no-op, since | |
689 | * interrupts will have to stay on to keep the count accurate. | |
690 | */ | |
691 | void (*disable_vblank) (struct drm_device *dev, int crtc); | |
692 | ||
cda17380 DA |
693 | /** |
694 | * Called by \c drm_device_is_agp. Typically used to determine if a | |
695 | * card is really attached to AGP or not. | |
696 | * | |
697 | * \param dev DRM device handle | |
698 | * | |
699 | * \returns | |
700 | * One of three values is returned depending on whether or not the | |
701 | * card is absolutely \b not AGP (return of 0), absolutely \b is AGP | |
702 | * (return of 1), or may or may not be AGP (return of 2). | |
703 | */ | |
84b1fd10 | 704 | int (*device_is_agp) (struct drm_device *dev); |
cda17380 | 705 | |
27641c3f MK |
706 | /** |
707 | * Called by vblank timestamping code. | |
708 | * | |
8f6fce03 MK |
709 | * Return the current display scanout position from a crtc, and an |
710 | * optional accurate ktime_get timestamp of when position was measured. | |
27641c3f MK |
711 | * |
712 | * \param dev DRM device. | |
713 | * \param crtc Id of the crtc to query. | |
abca9e45 | 714 | * \param flags Flags from the caller (DRM_CALLED_FROM_VBLIRQ or 0). |
27641c3f MK |
715 | * \param *vpos Target location for current vertical scanout position. |
716 | * \param *hpos Target location for current horizontal scanout position. | |
8f6fce03 MK |
717 | * \param *stime Target location for timestamp taken immediately before |
718 | * scanout position query. Can be NULL to skip timestamp. | |
719 | * \param *etime Target location for timestamp taken immediately after | |
720 | * scanout position query. Can be NULL to skip timestamp. | |
27641c3f MK |
721 | * |
722 | * Returns vpos as a positive number while in active scanout area. | |
723 | * Returns vpos as a negative number inside vblank, counting the number | |
724 | * of scanlines to go until end of vblank, e.g., -1 means "one scanline | |
725 | * until start of active scanout / end of vblank." | |
726 | * | |
727 | * \return Flags, or'ed together as follows: | |
728 | * | |
25985edc | 729 | * DRM_SCANOUTPOS_VALID = Query successful. |
27641c3f MK |
730 | * DRM_SCANOUTPOS_INVBL = Inside vblank. |
731 | * DRM_SCANOUTPOS_ACCURATE = Returned position is accurate. A lack of | |
732 | * this flag means that returned position may be offset by a constant | |
733 | * but unknown small number of scanlines wrt. real scanout position. | |
734 | * | |
735 | */ | |
736 | int (*get_scanout_position) (struct drm_device *dev, int crtc, | |
abca9e45 | 737 | unsigned int flags, |
8f6fce03 MK |
738 | int *vpos, int *hpos, ktime_t *stime, |
739 | ktime_t *etime); | |
27641c3f MK |
740 | |
741 | /** | |
742 | * Called by \c drm_get_last_vbltimestamp. Should return a precise | |
743 | * timestamp when the most recent VBLANK interval ended or will end. | |
744 | * | |
745 | * Specifically, the timestamp in @vblank_time should correspond as | |
746 | * closely as possible to the time when the first video scanline of | |
747 | * the video frame after the end of VBLANK will start scanning out, | |
42b2aa86 | 748 | * the time immediately after end of the VBLANK interval. If the |
27641c3f MK |
749 | * @crtc is currently inside VBLANK, this will be a time in the future. |
750 | * If the @crtc is currently scanning out a frame, this will be the | |
751 | * past start time of the current scanout. This is meant to adhere | |
752 | * to the OpenML OML_sync_control extension specification. | |
753 | * | |
754 | * \param dev dev DRM device handle. | |
755 | * \param crtc crtc for which timestamp should be returned. | |
756 | * \param *max_error Maximum allowable timestamp error in nanoseconds. | |
757 | * Implementation should strive to provide timestamp | |
758 | * with an error of at most *max_error nanoseconds. | |
759 | * Returns true upper bound on error for timestamp. | |
760 | * \param *vblank_time Target location for returned vblank timestamp. | |
761 | * \param flags 0 = Defaults, no special treatment needed. | |
762 | * \param DRM_CALLED_FROM_VBLIRQ = Function is called from vblank | |
763 | * irq handler. Some drivers need to apply some workarounds | |
764 | * for gpu-specific vblank irq quirks if flag is set. | |
765 | * | |
766 | * \returns | |
767 | * Zero if timestamping isn't supported in current display mode or a | |
768 | * negative number on failure. A positive status code on success, | |
769 | * which describes how the vblank_time timestamp was computed. | |
770 | */ | |
771 | int (*get_vblank_timestamp) (struct drm_device *dev, int crtc, | |
772 | int *max_error, | |
773 | struct timeval *vblank_time, | |
774 | unsigned flags); | |
775 | ||
1da177e4 | 776 | /* these have to be filled in */ |
b5e89ed5 | 777 | |
e9f0d76f | 778 | irqreturn_t(*irq_handler) (int irq, void *arg); |
84b1fd10 | 779 | void (*irq_preinstall) (struct drm_device *dev); |
0a3e67a4 | 780 | int (*irq_postinstall) (struct drm_device *dev); |
84b1fd10 | 781 | void (*irq_uninstall) (struct drm_device *dev); |
22eae947 | 782 | |
7c1c2871 DA |
783 | /* Master routines */ |
784 | int (*master_create)(struct drm_device *dev, struct drm_master *master); | |
785 | void (*master_destroy)(struct drm_device *dev, struct drm_master *master); | |
862302ff TH |
786 | /** |
787 | * master_set is called whenever the minor master is set. | |
788 | * master_drop is called whenever the minor master is dropped. | |
789 | */ | |
790 | ||
791 | int (*master_set)(struct drm_device *dev, struct drm_file *file_priv, | |
792 | bool from_open); | |
793 | void (*master_drop)(struct drm_device *dev, struct drm_file *file_priv, | |
794 | bool from_release); | |
7c1c2871 | 795 | |
955b12de BG |
796 | int (*debugfs_init)(struct drm_minor *minor); |
797 | void (*debugfs_cleanup)(struct drm_minor *minor); | |
673a394b EA |
798 | |
799 | /** | |
800 | * Driver-specific constructor for drm_gem_objects, to set up | |
801 | * obj->driver_private. | |
802 | * | |
803 | * Returns 0 on success. | |
804 | */ | |
673a394b | 805 | void (*gem_free_object) (struct drm_gem_object *obj); |
304eda32 BS |
806 | int (*gem_open_object) (struct drm_gem_object *, struct drm_file *); |
807 | void (*gem_close_object) (struct drm_gem_object *, struct drm_file *); | |
673a394b | 808 | |
3248877e DA |
809 | /* prime: */ |
810 | /* export handle -> fd (see drm_gem_prime_handle_to_fd() helper) */ | |
811 | int (*prime_handle_to_fd)(struct drm_device *dev, struct drm_file *file_priv, | |
812 | uint32_t handle, uint32_t flags, int *prime_fd); | |
813 | /* import fd -> handle (see drm_gem_prime_fd_to_handle() helper) */ | |
814 | int (*prime_fd_to_handle)(struct drm_device *dev, struct drm_file *file_priv, | |
815 | int prime_fd, uint32_t *handle); | |
816 | /* export GEM -> dmabuf */ | |
817 | struct dma_buf * (*gem_prime_export)(struct drm_device *dev, | |
818 | struct drm_gem_object *obj, int flags); | |
819 | /* import dmabuf -> GEM */ | |
820 | struct drm_gem_object * (*gem_prime_import)(struct drm_device *dev, | |
821 | struct dma_buf *dma_buf); | |
89177644 AP |
822 | /* low-level interface used by drm_gem_prime_{import,export} */ |
823 | int (*gem_prime_pin)(struct drm_gem_object *obj); | |
102d6dba | 824 | void (*gem_prime_unpin)(struct drm_gem_object *obj); |
3aac4502 ML |
825 | struct reservation_object * (*gem_prime_res_obj)( |
826 | struct drm_gem_object *obj); | |
89177644 AP |
827 | struct sg_table *(*gem_prime_get_sg_table)(struct drm_gem_object *obj); |
828 | struct drm_gem_object *(*gem_prime_import_sg_table)( | |
829 | struct drm_device *dev, size_t size, | |
830 | struct sg_table *sgt); | |
831 | void *(*gem_prime_vmap)(struct drm_gem_object *obj); | |
832 | void (*gem_prime_vunmap)(struct drm_gem_object *obj, void *vaddr); | |
7c397cd9 JS |
833 | int (*gem_prime_mmap)(struct drm_gem_object *obj, |
834 | struct vm_area_struct *vma); | |
3248877e | 835 | |
28d52043 DA |
836 | /* vga arb irq handler */ |
837 | void (*vgaarb_irq)(struct drm_device *dev, bool state); | |
838 | ||
ff72145b DA |
839 | /* dumb alloc support */ |
840 | int (*dumb_create)(struct drm_file *file_priv, | |
841 | struct drm_device *dev, | |
842 | struct drm_mode_create_dumb *args); | |
843 | int (*dumb_map_offset)(struct drm_file *file_priv, | |
844 | struct drm_device *dev, uint32_t handle, | |
845 | uint64_t *offset); | |
846 | int (*dumb_destroy)(struct drm_file *file_priv, | |
847 | struct drm_device *dev, | |
848 | uint32_t handle); | |
849 | ||
a2c0a97b | 850 | /* Driver private ops for this object */ |
78b68556 | 851 | const struct vm_operations_struct *gem_vm_ops; |
a2c0a97b | 852 | |
22eae947 DA |
853 | int major; |
854 | int minor; | |
855 | int patchlevel; | |
856 | char *name; | |
857 | char *desc; | |
858 | char *date; | |
859 | ||
1da177e4 LT |
860 | u32 driver_features; |
861 | int dev_priv_size; | |
baa70943 | 862 | const struct drm_ioctl_desc *ioctls; |
1da177e4 | 863 | int num_ioctls; |
e08e96de | 864 | const struct file_operations *fops; |
8410ea3b DA |
865 | struct drm_bus *bus; |
866 | ||
b3f2333d DV |
867 | /* List of devices hanging off this driver with stealth attach. */ |
868 | struct list_head legacy_dev_list; | |
1da177e4 LT |
869 | }; |
870 | ||
cb8a239b DH |
871 | enum drm_minor_type { |
872 | DRM_MINOR_LEGACY, | |
873 | DRM_MINOR_CONTROL, | |
874 | DRM_MINOR_RENDER, | |
875 | DRM_MINOR_CNT, | |
876 | }; | |
2c14f28b | 877 | |
955b12de BG |
878 | /** |
879 | * Info file list entry. This structure represents a debugfs or proc file to | |
880 | * be created by the drm core | |
881 | */ | |
882 | struct drm_info_list { | |
883 | const char *name; /** file name */ | |
884 | int (*show)(struct seq_file*, void*); /** show callback */ | |
885 | u32 driver_features; /**< Required driver features for this entry */ | |
886 | void *data; | |
887 | }; | |
888 | ||
889 | /** | |
890 | * debugfs node structure. This structure represents a debugfs file. | |
891 | */ | |
892 | struct drm_info_node { | |
893 | struct list_head list; | |
894 | struct drm_minor *minor; | |
ce089b54 | 895 | const struct drm_info_list *info_ent; |
955b12de BG |
896 | struct dentry *dent; |
897 | }; | |
898 | ||
1da177e4 | 899 | /** |
2c14f28b | 900 | * DRM minor structure. This structure represents a drm minor number. |
1da177e4 | 901 | */ |
2c14f28b DA |
902 | struct drm_minor { |
903 | int index; /**< Minor device number */ | |
904 | int type; /**< Control or render */ | |
5bdebb18 | 905 | struct device *kdev; /**< Linux device */ |
1da177e4 | 906 | struct drm_device *dev; |
955b12de | 907 | |
955b12de | 908 | struct dentry *debugfs_root; |
b3e067c0 MS |
909 | |
910 | struct list_head debugfs_list; | |
911 | struct mutex debugfs_lock; /* Protects debugfs_list. */ | |
955b12de | 912 | |
c996fd0b TH |
913 | /* currently active master for this node. Protected by master_mutex */ |
914 | struct drm_master *master; | |
f453ba04 | 915 | struct drm_mode_group mode_group; |
84b1fd10 | 916 | }; |
1da177e4 | 917 | |
1794d257 | 918 | |
c9a9c5e0 KH |
919 | struct drm_pending_vblank_event { |
920 | struct drm_pending_event base; | |
921 | int pipe; | |
922 | struct drm_event_vblank event; | |
923 | }; | |
924 | ||
5380e929 | 925 | struct drm_vblank_crtc { |
e69595c2 | 926 | struct drm_device *dev; /* pointer to the drm_device */ |
5380e929 VS |
927 | wait_queue_head_t queue; /**< VBLANK wait queue */ |
928 | struct timeval time[DRM_VBLANKTIME_RBSIZE]; /**< timestamp of current count */ | |
e69595c2 | 929 | struct timer_list disable_timer; /* delayed disable timer */ |
5380e929 VS |
930 | atomic_t count; /**< number of VBLANK interrupts */ |
931 | atomic_t refcount; /* number of users of vblank interruptsper crtc */ | |
932 | u32 last; /* protected by dev->vbl_lock, used */ | |
933 | /* for wraparound handling */ | |
934 | u32 last_wait; /* Last vblank seqno waited per CRTC */ | |
935 | unsigned int inmodeset; /* Display driver is setting mode */ | |
e69595c2 | 936 | int crtc; /* crtc index */ |
5380e929 VS |
937 | bool enabled; /* so we don't call enable more than |
938 | once per disable */ | |
939 | }; | |
940 | ||
1da177e4 LT |
941 | /** |
942 | * DRM device structure. This structure represent a complete card that | |
943 | * may contain multiple heads. | |
944 | */ | |
84b1fd10 | 945 | struct drm_device { |
b3f2333d | 946 | struct list_head legacy_dev_list;/**< list of devices per driver for stealth attach cleanup */ |
b5e89ed5 | 947 | int if_version; /**< Highest interface version set */ |
1da177e4 | 948 | |
45e212d2 DH |
949 | /** \name Lifetime Management */ |
950 | /*@{ */ | |
099d1c29 | 951 | struct kref ref; /**< Object ref-count */ |
45e212d2 DH |
952 | struct device *dev; /**< Device structure of bus-device */ |
953 | struct drm_driver *driver; /**< DRM driver managing the device */ | |
954 | void *dev_private; /**< DRM driver private data */ | |
45e212d2 DH |
955 | struct drm_minor *control; /**< Control node */ |
956 | struct drm_minor *primary; /**< Primary node */ | |
957 | struct drm_minor *render; /**< Render node */ | |
958 | atomic_t unplugged; /**< Flag whether dev is dead */ | |
07b48c3a | 959 | struct inode *anon_inode; /**< inode for private address-space */ |
ca8e2ad7 | 960 | char *unique; /**< unique name of the device */ |
45e212d2 DH |
961 | /*@} */ |
962 | ||
1da177e4 | 963 | /** \name Locks */ |
b5e89ed5 | 964 | /*@{ */ |
30e2fb18 | 965 | struct mutex struct_mutex; /**< For others */ |
c996fd0b | 966 | struct mutex master_mutex; /**< For drm_minor::master and drm_file::is_master */ |
b5e89ed5 | 967 | /*@} */ |
1da177e4 LT |
968 | |
969 | /** \name Usage Counters */ | |
b5e89ed5 | 970 | /*@{ */ |
fc8fd40e | 971 | int open_count; /**< Outstanding files open, protected by drm_global_mutex. */ |
2177a218 | 972 | spinlock_t buf_lock; /**< For drm_device::buf_use and a few other things. */ |
b5e89ed5 DA |
973 | int buf_use; /**< Buffers in use -- cannot alloc */ |
974 | atomic_t buf_alloc; /**< Buffer allocation in progress */ | |
975 | /*@} */ | |
1da177e4 | 976 | |
bd1b331f | 977 | struct list_head filelist; |
1da177e4 LT |
978 | |
979 | /** \name Memory management */ | |
b5e89ed5 | 980 | /*@{ */ |
bd1b331f | 981 | struct list_head maplist; /**< Linked list of regions */ |
e0be428e | 982 | struct drm_open_hash map_hash; /**< User token hash table for maps */ |
1da177e4 LT |
983 | |
984 | /** \name Context handle management */ | |
b5e89ed5 | 985 | /*@{ */ |
bd1b331f | 986 | struct list_head ctxlist; /**< Linked list of context handles */ |
30e2fb18 | 987 | struct mutex ctxlist_mutex; /**< For ctxlist */ |
1da177e4 | 988 | |
62968144 | 989 | struct idr ctx_idr; |
1da177e4 | 990 | |
bd1b331f | 991 | struct list_head vmalist; /**< List of vmas (for debugging) */ |
f453ba04 | 992 | |
b5e89ed5 | 993 | /*@} */ |
1da177e4 | 994 | |
a344a7e7 | 995 | /** \name DMA support */ |
b5e89ed5 | 996 | /*@{ */ |
cdd55a29 | 997 | struct drm_device_dma *dma; /**< Optional pointer for DMA support */ |
b5e89ed5 | 998 | /*@} */ |
1da177e4 LT |
999 | |
1000 | /** \name Context support */ | |
b5e89ed5 | 1001 | /*@{ */ |
4423843c | 1002 | bool irq_enabled; /**< True if irq handler is enabled */ |
7c1a38e3 DV |
1003 | int irq; |
1004 | ||
1da177e4 | 1005 | __volatile__ long context_flag; /**< Context swapping flag */ |
b5e89ed5 | 1006 | int last_context; /**< Last current context */ |
b5e89ed5 DA |
1007 | /*@} */ |
1008 | ||
1da177e4 | 1009 | /** \name VBLANK IRQ support */ |
b5e89ed5 DA |
1010 | /*@{ */ |
1011 | ||
0a3e67a4 JB |
1012 | /* |
1013 | * At load time, disabling the vblank interrupt won't be allowed since | |
1014 | * old clients may not call the modeset ioctl and therefore misbehave. | |
1015 | * Once the modeset ioctl *has* been called though, we can safely | |
1016 | * disable them when unused. | |
1017 | */ | |
ba0bf120 | 1018 | bool vblank_disable_allowed; |
0a3e67a4 | 1019 | |
5380e929 VS |
1020 | /* array of size num_crtcs */ |
1021 | struct drm_vblank_crtc *vblank; | |
0a3e67a4 | 1022 | |
27641c3f | 1023 | spinlock_t vblank_time_lock; /**< Protects vblank count and time updates during vblank enable/disable */ |
b5e89ed5 | 1024 | spinlock_t vbl_lock; |
0a3e67a4 JB |
1025 | |
1026 | u32 max_vblank_count; /**< size of vblank counter register */ | |
b5e89ed5 | 1027 | |
c9a9c5e0 KH |
1028 | /** |
1029 | * List of events | |
1030 | */ | |
1031 | struct list_head vblank_event_list; | |
1032 | spinlock_t event_lock; | |
1033 | ||
b5e89ed5 | 1034 | /*@} */ |
b5e89ed5 | 1035 | |
55910517 | 1036 | struct drm_agp_head *agp; /**< AGP data */ |
1da177e4 | 1037 | |
b5e89ed5 | 1038 | struct pci_dev *pdev; /**< PCI device structure */ |
1da177e4 | 1039 | #ifdef __alpha__ |
1da177e4 | 1040 | struct pci_controller *hose; |
1da177e4 | 1041 | #endif |
dcdb1674 JC |
1042 | |
1043 | struct platform_device *platformdev; /**< Platform device struture */ | |
a250b9fd | 1044 | struct usb_device *usbdev; |
dcdb1674 | 1045 | |
55910517 | 1046 | struct drm_sg_mem *sg; /**< Scatter gather memory */ |
19227561 | 1047 | unsigned int num_crtcs; /**< Number of CRTCs on this device */ |
55910517 | 1048 | struct drm_sigdata sigdata; /**< For block_all_signals */ |
b5e89ed5 DA |
1049 | sigset_t sigmask; |
1050 | ||
f77d390c | 1051 | struct drm_local_map *agp_buffer_map; |
d1f2b55a | 1052 | unsigned int agp_buffer_token; |
bea5679f | 1053 | |
f453ba04 DA |
1054 | struct drm_mode_config mode_config; /**< Current mode config */ |
1055 | ||
673a394b EA |
1056 | /** \name GEM information */ |
1057 | /*@{ */ | |
cd4f013f | 1058 | struct mutex object_name_lock; |
673a394b | 1059 | struct idr object_name_idr; |
b04a5906 | 1060 | struct drm_vma_offset_manager *vma_offset_manager; |
673a394b | 1061 | /*@} */ |
5bcf719b | 1062 | int switch_power_state; |
84b1fd10 | 1063 | }; |
1da177e4 | 1064 | |
5bcf719b DA |
1065 | #define DRM_SWITCH_POWER_ON 0 |
1066 | #define DRM_SWITCH_POWER_OFF 1 | |
1067 | #define DRM_SWITCH_POWER_CHANGING 2 | |
13bb9cc8 | 1068 | #define DRM_SWITCH_POWER_DYNAMIC_OFF 3 |
5bcf719b | 1069 | |
b5e89ed5 DA |
1070 | static __inline__ int drm_core_check_feature(struct drm_device *dev, |
1071 | int feature) | |
1da177e4 LT |
1072 | { |
1073 | return ((dev->driver->driver_features & feature) ? 1 : 0); | |
1074 | } | |
1075 | ||
2c07a21d DA |
1076 | static inline void drm_device_set_unplugged(struct drm_device *dev) |
1077 | { | |
1078 | smp_wmb(); | |
1079 | atomic_set(&dev->unplugged, 1); | |
1080 | } | |
1081 | ||
1082 | static inline int drm_device_is_unplugged(struct drm_device *dev) | |
1083 | { | |
1084 | int ret = atomic_read(&dev->unplugged); | |
1085 | smp_rmb(); | |
1086 | return ret; | |
1087 | } | |
1088 | ||
43683057 | 1089 | static inline bool drm_is_render_client(const struct drm_file *file_priv) |
1793126f DH |
1090 | { |
1091 | return file_priv->minor->type == DRM_MINOR_RENDER; | |
1092 | } | |
1093 | ||
ac05dbc5 TH |
1094 | static inline bool drm_is_control_client(const struct drm_file *file_priv) |
1095 | { | |
1096 | return file_priv->minor->type == DRM_MINOR_CONTROL; | |
1097 | } | |
1098 | ||
43683057 TH |
1099 | static inline bool drm_is_primary_client(const struct drm_file *file_priv) |
1100 | { | |
1101 | return file_priv->minor->type == DRM_MINOR_LEGACY; | |
1102 | } | |
1103 | ||
1da177e4 LT |
1104 | /******************************************************************/ |
1105 | /** \name Internal function definitions */ | |
1106 | /*@{*/ | |
1107 | ||
1da177e4 | 1108 | /* Driver support (drm_drv.h) */ |
ed8b6704 AB |
1109 | extern long drm_ioctl(struct file *filp, |
1110 | unsigned int cmd, unsigned long arg); | |
b5e89ed5 DA |
1111 | extern long drm_compat_ioctl(struct file *filp, |
1112 | unsigned int cmd, unsigned long arg); | |
84b1fd10 | 1113 | extern int drm_lastclose(struct drm_device *dev); |
4beb6d9f | 1114 | extern bool drm_ioctl_flags(unsigned int nr, unsigned int *flags); |
1da177e4 LT |
1115 | |
1116 | /* Device support (drm_fops.h) */ | |
58374713 | 1117 | extern struct mutex drm_global_mutex; |
b5e89ed5 | 1118 | extern int drm_open(struct inode *inode, struct file *filp); |
c9a9c5e0 KH |
1119 | extern ssize_t drm_read(struct file *filp, char __user *buffer, |
1120 | size_t count, loff_t *offset); | |
b5e89ed5 | 1121 | extern int drm_release(struct inode *inode, struct file *filp); |
1da177e4 LT |
1122 | |
1123 | /* Mapping support (drm_vm.h) */ | |
b5e89ed5 | 1124 | extern int drm_mmap(struct file *filp, struct vm_area_struct *vma); |
a2c0a97b | 1125 | extern int drm_mmap_locked(struct file *filp, struct vm_area_struct *vma); |
b06d66be RC |
1126 | extern void drm_vm_open_locked(struct drm_device *dev, struct vm_area_struct *vma); |
1127 | extern void drm_vm_close_locked(struct drm_device *dev, struct vm_area_struct *vma); | |
b5e89ed5 | 1128 | extern unsigned int drm_poll(struct file *filp, struct poll_table_struct *wait); |
1da177e4 LT |
1129 | |
1130 | /* Memory management support (drm_memory.h) */ | |
a1ce3928 | 1131 | #include <drm/drm_memory.h> |
1da177e4 | 1132 | |
d2e546b8 | 1133 | |
1da177e4 | 1134 | /* Misc. IOCTL support (drm_ioctl.h) */ |
c153f45f EA |
1135 | extern int drm_irq_by_busid(struct drm_device *dev, void *data, |
1136 | struct drm_file *file_priv); | |
1137 | extern int drm_getunique(struct drm_device *dev, void *data, | |
1138 | struct drm_file *file_priv); | |
1139 | extern int drm_setunique(struct drm_device *dev, void *data, | |
1140 | struct drm_file *file_priv); | |
1141 | extern int drm_getmap(struct drm_device *dev, void *data, | |
1142 | struct drm_file *file_priv); | |
1143 | extern int drm_getclient(struct drm_device *dev, void *data, | |
1144 | struct drm_file *file_priv); | |
1145 | extern int drm_getstats(struct drm_device *dev, void *data, | |
1146 | struct drm_file *file_priv); | |
9f35421e BS |
1147 | extern int drm_getcap(struct drm_device *dev, void *data, |
1148 | struct drm_file *file_priv); | |
1c0814fe DL |
1149 | extern int drm_setclientcap(struct drm_device *dev, void *data, |
1150 | struct drm_file *file_priv); | |
c153f45f EA |
1151 | extern int drm_setversion(struct drm_device *dev, void *data, |
1152 | struct drm_file *file_priv); | |
1153 | extern int drm_noop(struct drm_device *dev, void *data, | |
1154 | struct drm_file *file_priv); | |
1da177e4 | 1155 | |
1da177e4 | 1156 | /* Authentication IOCTL support (drm_auth.h) */ |
c153f45f EA |
1157 | extern int drm_getmagic(struct drm_device *dev, void *data, |
1158 | struct drm_file *file_priv); | |
1159 | extern int drm_authmagic(struct drm_device *dev, void *data, | |
1160 | struct drm_file *file_priv); | |
598781d7 | 1161 | extern int drm_remove_magic(struct drm_master *master, drm_magic_t magic); |
1da177e4 | 1162 | |
673a394b EA |
1163 | /* Cache management (drm_cache.c) */ |
1164 | void drm_clflush_pages(struct page *pages[], unsigned long num_pages); | |
9da3da66 | 1165 | void drm_clflush_sg(struct sg_table *st); |
c2d15359 | 1166 | void drm_clflush_virt_range(void *addr, unsigned long length); |
673a394b | 1167 | |
1da177e4 | 1168 | /* Locking IOCTL support (drm_lock.h) */ |
c153f45f EA |
1169 | extern int drm_lock(struct drm_device *dev, void *data, |
1170 | struct drm_file *file_priv); | |
1171 | extern int drm_unlock(struct drm_device *dev, void *data, | |
1172 | struct drm_file *file_priv); | |
55910517 DA |
1173 | extern int drm_lock_free(struct drm_lock_data *lock_data, unsigned int context); |
1174 | extern void drm_idlelock_take(struct drm_lock_data *lock_data); | |
1175 | extern void drm_idlelock_release(struct drm_lock_data *lock_data); | |
040ac320 TH |
1176 | |
1177 | /* | |
1178 | * These are exported to drivers so that they can implement fencing using | |
1179 | * DMA quiscent + idle. DMA quiescent usually requires the hardware lock. | |
1180 | */ | |
1181 | ||
c153f45f | 1182 | extern int drm_i_have_hw_lock(struct drm_device *dev, struct drm_file *file_priv); |
1da177e4 | 1183 | |
1da177e4 | 1184 | /* DMA support (drm_dma.h) */ |
e2e99a82 DV |
1185 | extern int drm_legacy_dma_setup(struct drm_device *dev); |
1186 | extern void drm_legacy_dma_takedown(struct drm_device *dev); | |
056219e2 | 1187 | extern void drm_free_buffer(struct drm_device *dev, struct drm_buf * buf); |
6c340eac EA |
1188 | extern void drm_core_reclaim_buffers(struct drm_device *dev, |
1189 | struct drm_file *filp); | |
1da177e4 LT |
1190 | |
1191 | /* IRQ support (drm_irq.h) */ | |
c153f45f EA |
1192 | extern int drm_control(struct drm_device *dev, void *data, |
1193 | struct drm_file *file_priv); | |
bb0f1b5c | 1194 | extern int drm_irq_install(struct drm_device *dev, int irq); |
84b1fd10 | 1195 | extern int drm_irq_uninstall(struct drm_device *dev); |
b5e89ed5 | 1196 | |
0a3e67a4 | 1197 | extern int drm_vblank_init(struct drm_device *dev, int num_crtcs); |
af6061af | 1198 | extern int drm_wait_vblank(struct drm_device *dev, void *data, |
0a3e67a4 | 1199 | struct drm_file *filp); |
0a3e67a4 | 1200 | extern u32 drm_vblank_count(struct drm_device *dev, int crtc); |
27641c3f MK |
1201 | extern u32 drm_vblank_count_and_time(struct drm_device *dev, int crtc, |
1202 | struct timeval *vblanktime); | |
c6eefa17 RC |
1203 | extern void drm_send_vblank_event(struct drm_device *dev, int crtc, |
1204 | struct drm_pending_vblank_event *e); | |
78c6e170 | 1205 | extern bool drm_handle_vblank(struct drm_device *dev, int crtc); |
0a3e67a4 JB |
1206 | extern int drm_vblank_get(struct drm_device *dev, int crtc); |
1207 | extern void drm_vblank_put(struct drm_device *dev, int crtc); | |
89dd6a4b DV |
1208 | extern int drm_crtc_vblank_get(struct drm_crtc *crtc); |
1209 | extern void drm_crtc_vblank_put(struct drm_crtc *crtc); | |
e8450f51 DV |
1210 | extern void drm_wait_one_vblank(struct drm_device *dev, int crtc); |
1211 | extern void drm_crtc_wait_one_vblank(struct drm_crtc *crtc); | |
778c9026 | 1212 | extern void drm_vblank_off(struct drm_device *dev, int crtc); |
f2752282 | 1213 | extern void drm_vblank_on(struct drm_device *dev, int crtc); |
89dd6a4b DV |
1214 | extern void drm_crtc_vblank_off(struct drm_crtc *crtc); |
1215 | extern void drm_crtc_vblank_on(struct drm_crtc *crtc); | |
52440211 | 1216 | extern void drm_vblank_cleanup(struct drm_device *dev); |
89dd6a4b | 1217 | |
27641c3f MK |
1218 | extern u32 drm_get_last_vbltimestamp(struct drm_device *dev, int crtc, |
1219 | struct timeval *tvblank, unsigned flags); | |
1220 | extern int drm_calc_vbltimestamp_from_scanoutpos(struct drm_device *dev, | |
1221 | int crtc, int *max_error, | |
1222 | struct timeval *vblank_time, | |
1223 | unsigned flags, | |
7da903ef VS |
1224 | const struct drm_crtc *refcrtc, |
1225 | const struct drm_display_mode *mode); | |
545cdd55 VS |
1226 | extern void drm_calc_timestamping_constants(struct drm_crtc *crtc, |
1227 | const struct drm_display_mode *mode); | |
27641c3f | 1228 | |
020178a1 VS |
1229 | /** |
1230 | * drm_crtc_vblank_waitqueue - get vblank waitqueue for the CRTC | |
1231 | * @crtc: which CRTC's vblank waitqueue to retrieve | |
1232 | * | |
1233 | * This function returns a pointer to the vblank waitqueue for the CRTC. | |
1234 | * Drivers can use this to implement vblank waits using wait_event() & co. | |
1235 | */ | |
1236 | static inline wait_queue_head_t *drm_crtc_vblank_waitqueue(struct drm_crtc *crtc) | |
1237 | { | |
1238 | return &crtc->dev->vblank[drm_crtc_index(crtc)].queue; | |
1239 | } | |
ebc64e45 | 1240 | |
0a3e67a4 | 1241 | /* Modesetting support */ |
f453ba04 DA |
1242 | extern void drm_vblank_pre_modeset(struct drm_device *dev, int crtc); |
1243 | extern void drm_vblank_post_modeset(struct drm_device *dev, int crtc); | |
0a3e67a4 JB |
1244 | extern int drm_modeset_ctl(struct drm_device *dev, void *data, |
1245 | struct drm_file *file_priv); | |
1da177e4 LT |
1246 | |
1247 | /* AGP/GART support (drm_agpsupport.h) */ | |
00fd78e5 DH |
1248 | |
1249 | #include <drm/drm_agpsupport.h> | |
1da177e4 LT |
1250 | |
1251 | /* Stub support (drm_stub.h) */ | |
7c1c2871 DA |
1252 | extern int drm_setmaster_ioctl(struct drm_device *dev, void *data, |
1253 | struct drm_file *file_priv); | |
1254 | extern int drm_dropmaster_ioctl(struct drm_device *dev, void *data, | |
1255 | struct drm_file *file_priv); | |
1256 | struct drm_master *drm_master_create(struct drm_minor *minor); | |
1257 | extern struct drm_master *drm_master_get(struct drm_master *master); | |
1258 | extern void drm_master_put(struct drm_master **master); | |
8410ea3b | 1259 | |
112b715e | 1260 | extern void drm_put_dev(struct drm_device *dev); |
2c07a21d | 1261 | extern void drm_unplug_dev(struct drm_device *dev); |
b5e89ed5 | 1262 | extern unsigned int drm_debug; |
2c14f28b | 1263 | |
27641c3f MK |
1264 | extern unsigned int drm_vblank_offdelay; |
1265 | extern unsigned int drm_timestamp_precision; | |
c61eef72 | 1266 | extern unsigned int drm_timestamp_monotonic; |
27641c3f | 1267 | |
0650fd58 | 1268 | extern struct class *drm_class; |
2c14f28b | 1269 | |
955b12de BG |
1270 | /* Debugfs support */ |
1271 | #if defined(CONFIG_DEBUG_FS) | |
1272 | extern int drm_debugfs_init(struct drm_minor *minor, int minor_id, | |
1273 | struct dentry *root); | |
7d74795b LD |
1274 | extern int drm_debugfs_create_files(const struct drm_info_list *files, |
1275 | int count, struct dentry *root, | |
1276 | struct drm_minor *minor); | |
1277 | extern int drm_debugfs_remove_files(const struct drm_info_list *files, | |
1278 | int count, struct drm_minor *minor); | |
955b12de | 1279 | extern int drm_debugfs_cleanup(struct drm_minor *minor); |
30f65707 TW |
1280 | extern int drm_debugfs_connector_add(struct drm_connector *connector); |
1281 | extern void drm_debugfs_connector_remove(struct drm_connector *connector); | |
66ee52e2 TR |
1282 | #else |
1283 | static inline int drm_debugfs_init(struct drm_minor *minor, int minor_id, | |
1284 | struct dentry *root) | |
1285 | { | |
1286 | return 0; | |
1287 | } | |
1288 | ||
1289 | static inline int drm_debugfs_create_files(const struct drm_info_list *files, | |
1290 | int count, struct dentry *root, | |
1291 | struct drm_minor *minor) | |
1292 | { | |
1293 | return 0; | |
1294 | } | |
1295 | ||
1296 | static inline int drm_debugfs_remove_files(const struct drm_info_list *files, | |
1297 | int count, struct drm_minor *minor) | |
1298 | { | |
1299 | return 0; | |
1300 | } | |
1301 | ||
1302 | static inline int drm_debugfs_cleanup(struct drm_minor *minor) | |
1303 | { | |
1304 | return 0; | |
1305 | } | |
30f65707 TW |
1306 | |
1307 | static inline int drm_debugfs_connector_add(struct drm_connector *connector) | |
1308 | { | |
1309 | return 0; | |
1310 | } | |
1311 | static inline void drm_debugfs_connector_remove(struct drm_connector *connector) | |
1312 | { | |
1313 | } | |
1314 | ||
955b12de BG |
1315 | #endif |
1316 | ||
1317 | /* Info file support */ | |
1318 | extern int drm_name_info(struct seq_file *m, void *data); | |
1319 | extern int drm_vm_info(struct seq_file *m, void *data); | |
955b12de BG |
1320 | extern int drm_bufs_info(struct seq_file *m, void *data); |
1321 | extern int drm_vblank_info(struct seq_file *m, void *data); | |
1322 | extern int drm_clients_info(struct seq_file *m, void* data); | |
1323 | extern int drm_gem_name_info(struct seq_file *m, void *data); | |
955b12de | 1324 | |
3248877e | 1325 | |
89177644 AP |
1326 | extern struct dma_buf *drm_gem_prime_export(struct drm_device *dev, |
1327 | struct drm_gem_object *obj, int flags); | |
3248877e DA |
1328 | extern int drm_gem_prime_handle_to_fd(struct drm_device *dev, |
1329 | struct drm_file *file_priv, uint32_t handle, uint32_t flags, | |
1330 | int *prime_fd); | |
89177644 AP |
1331 | extern struct drm_gem_object *drm_gem_prime_import(struct drm_device *dev, |
1332 | struct dma_buf *dma_buf); | |
3248877e DA |
1333 | extern int drm_gem_prime_fd_to_handle(struct drm_device *dev, |
1334 | struct drm_file *file_priv, int prime_fd, uint32_t *handle); | |
c1d6798d | 1335 | extern void drm_gem_dmabuf_release(struct dma_buf *dma_buf); |
3248877e DA |
1336 | |
1337 | extern int drm_prime_handle_to_fd_ioctl(struct drm_device *dev, void *data, | |
1338 | struct drm_file *file_priv); | |
1339 | extern int drm_prime_fd_to_handle_ioctl(struct drm_device *dev, void *data, | |
1340 | struct drm_file *file_priv); | |
1341 | ||
51ab7ba2 DA |
1342 | extern int drm_prime_sg_to_page_addr_arrays(struct sg_table *sgt, struct page **pages, |
1343 | dma_addr_t *addrs, int max_pages); | |
3248877e DA |
1344 | extern struct sg_table *drm_prime_pages_to_sg(struct page **pages, int nr_pages); |
1345 | extern void drm_prime_gem_destroy(struct drm_gem_object *obj, struct sg_table *sg); | |
1346 | ||
43387b37 DV |
1347 | int drm_gem_dumb_destroy(struct drm_file *file, |
1348 | struct drm_device *dev, | |
1349 | uint32_t handle); | |
3248877e DA |
1350 | |
1351 | void drm_prime_init_file_private(struct drm_prime_file_private *prime_fpriv); | |
1352 | void drm_prime_destroy_file_private(struct drm_prime_file_private *prime_fpriv); | |
d0b2c533 | 1353 | void drm_prime_remove_buf_handle_locked(struct drm_prime_file_private *prime_fpriv, struct dma_buf *dma_buf); |
3248877e | 1354 | |
955b12de BG |
1355 | #if DRM_DEBUG_CODE |
1356 | extern int drm_vma_info(struct seq_file *m, void *data); | |
1357 | #endif | |
1358 | ||
1da177e4 | 1359 | /* Scatter Gather Support (drm_scatter.h) */ |
3d914e83 | 1360 | extern void drm_legacy_sg_cleanup(struct drm_device *dev); |
1d8d29cf | 1361 | extern int drm_sg_alloc(struct drm_device *dev, void *data, |
c153f45f | 1362 | struct drm_file *file_priv); |
c153f45f EA |
1363 | extern int drm_sg_free(struct drm_device *dev, void *data, |
1364 | struct drm_file *file_priv); | |
1da177e4 | 1365 | |
b5e89ed5 | 1366 | /* ATI PCIGART support (ati_pcigart.h) */ |
84b1fd10 | 1367 | extern int drm_ati_pcigart_init(struct drm_device *dev, |
55910517 | 1368 | struct drm_ati_pcigart_info * gart_info); |
84b1fd10 | 1369 | extern int drm_ati_pcigart_cleanup(struct drm_device *dev, |
55910517 | 1370 | struct drm_ati_pcigart_info * gart_info); |
1da177e4 | 1371 | |
84b1fd10 | 1372 | extern drm_dma_handle_t *drm_pci_alloc(struct drm_device *dev, size_t size, |
e6be8d9d | 1373 | size_t align); |
84b1fd10 DA |
1374 | extern void __drm_pci_free(struct drm_device *dev, drm_dma_handle_t * dmah); |
1375 | extern void drm_pci_free(struct drm_device *dev, drm_dma_handle_t * dmah); | |
53bf2a2b DV |
1376 | extern int drm_pci_set_unique(struct drm_device *dev, |
1377 | struct drm_master *master, | |
1378 | struct drm_unique *u); | |
1da177e4 | 1379 | |
9fc5cde7 DH |
1380 | /* Legacy Support */ |
1381 | ||
1382 | int drm_legacy_addmap(struct drm_device *d, resource_size_t offset, | |
1383 | unsigned int size, enum drm_map_type type, | |
1384 | enum drm_map_flags flags, struct drm_local_map **map_p); | |
1385 | int drm_legacy_rmmap(struct drm_device *d, struct drm_local_map *map); | |
1386 | int drm_legacy_rmmap_locked(struct drm_device *d, struct drm_local_map *map); | |
1387 | struct drm_local_map *drm_legacy_getsarea(struct drm_device *dev); | |
1388 | ||
1389 | int drm_legacy_addbufs_agp(struct drm_device *d, struct drm_buf_desc *req); | |
1390 | int drm_legacy_addbufs_pci(struct drm_device *d, struct drm_buf_desc *req); | |
1391 | ||
03decbe5 DH |
1392 | void drm_legacy_vma_flush(struct drm_device *d); |
1393 | ||
1da177e4 | 1394 | /* sysfs support (drm_sysfs.c) */ |
e8b962b6 | 1395 | struct drm_sysfs_class; |
0650fd58 | 1396 | extern struct class *drm_sysfs_create(struct module *owner, char *name); |
e8b962b6 | 1397 | extern void drm_sysfs_destroy(void); |
e1728075 | 1398 | extern struct device *drm_sysfs_minor_alloc(struct drm_minor *minor); |
f453ba04 | 1399 | extern void drm_sysfs_hotplug_event(struct drm_device *dev); |
f453ba04 DA |
1400 | extern int drm_sysfs_connector_add(struct drm_connector *connector); |
1401 | extern void drm_sysfs_connector_remove(struct drm_connector *connector); | |
1da177e4 | 1402 | |
673a394b EA |
1403 | /* Graphics Execution Manager library functions (drm_gem.c) */ |
1404 | int drm_gem_init(struct drm_device *dev); | |
a2c0a97b | 1405 | void drm_gem_destroy(struct drm_device *dev); |
fd632aa3 | 1406 | void drm_gem_object_release(struct drm_gem_object *obj); |
673a394b | 1407 | void drm_gem_object_free(struct kref *kref); |
1d397043 DV |
1408 | int drm_gem_object_init(struct drm_device *dev, |
1409 | struct drm_gem_object *obj, size_t size); | |
89c8233f DH |
1410 | void drm_gem_private_object_init(struct drm_device *dev, |
1411 | struct drm_gem_object *obj, size_t size); | |
ab00b3e5 JB |
1412 | void drm_gem_vm_open(struct vm_area_struct *vma); |
1413 | void drm_gem_vm_close(struct vm_area_struct *vma); | |
1c5aafa6 LP |
1414 | int drm_gem_mmap_obj(struct drm_gem_object *obj, unsigned long obj_size, |
1415 | struct vm_area_struct *vma); | |
a2c0a97b | 1416 | int drm_gem_mmap(struct file *filp, struct vm_area_struct *vma); |
673a394b | 1417 | |
a1ce3928 | 1418 | #include <drm/drm_global.h> |
ba4420c2 | 1419 | |
673a394b EA |
1420 | static inline void |
1421 | drm_gem_object_reference(struct drm_gem_object *obj) | |
1422 | { | |
1423 | kref_get(&obj->refcount); | |
1424 | } | |
1425 | ||
1426 | static inline void | |
1427 | drm_gem_object_unreference(struct drm_gem_object *obj) | |
1428 | { | |
c3ae90c0 LB |
1429 | if (obj != NULL) |
1430 | kref_put(&obj->refcount, drm_gem_object_free); | |
1431 | } | |
673a394b | 1432 | |
c3ae90c0 LB |
1433 | static inline void |
1434 | drm_gem_object_unreference_unlocked(struct drm_gem_object *obj) | |
1435 | { | |
7fc65eb7 | 1436 | if (obj && !atomic_add_unless(&obj->refcount.refcount, -1, 1)) { |
39b4d07a | 1437 | struct drm_device *dev = obj->dev; |
7fc65eb7 | 1438 | |
39b4d07a | 1439 | mutex_lock(&dev->struct_mutex); |
7fc65eb7 CW |
1440 | if (likely(atomic_dec_and_test(&obj->refcount.refcount))) |
1441 | drm_gem_object_free(&obj->refcount); | |
39b4d07a CW |
1442 | mutex_unlock(&dev->struct_mutex); |
1443 | } | |
673a394b EA |
1444 | } |
1445 | ||
20228c44 DV |
1446 | int drm_gem_handle_create_tail(struct drm_file *file_priv, |
1447 | struct drm_gem_object *obj, | |
1448 | u32 *handlep); | |
673a394b EA |
1449 | int drm_gem_handle_create(struct drm_file *file_priv, |
1450 | struct drm_gem_object *obj, | |
a1a2d1d3 | 1451 | u32 *handlep); |
ff72145b | 1452 | int drm_gem_handle_delete(struct drm_file *filp, u32 handle); |
673a394b | 1453 | |
c3ae90c0 | 1454 | |
75ef8b3b RC |
1455 | void drm_gem_free_mmap_offset(struct drm_gem_object *obj); |
1456 | int drm_gem_create_mmap_offset(struct drm_gem_object *obj); | |
367bbd49 | 1457 | int drm_gem_create_mmap_offset_size(struct drm_gem_object *obj, size_t size); |
75ef8b3b | 1458 | |
0cdbe8ac | 1459 | struct page **drm_gem_get_pages(struct drm_gem_object *obj); |
bcc5c9d5 RC |
1460 | void drm_gem_put_pages(struct drm_gem_object *obj, struct page **pages, |
1461 | bool dirty, bool accessed); | |
1462 | ||
673a394b EA |
1463 | struct drm_gem_object *drm_gem_object_lookup(struct drm_device *dev, |
1464 | struct drm_file *filp, | |
a1a2d1d3 | 1465 | u32 handle); |
673a394b EA |
1466 | int drm_gem_close_ioctl(struct drm_device *dev, void *data, |
1467 | struct drm_file *file_priv); | |
1468 | int drm_gem_flink_ioctl(struct drm_device *dev, void *data, | |
1469 | struct drm_file *file_priv); | |
1470 | int drm_gem_open_ioctl(struct drm_device *dev, void *data, | |
1471 | struct drm_file *file_priv); | |
1472 | void drm_gem_open(struct drm_device *dev, struct drm_file *file_private); | |
1473 | void drm_gem_release(struct drm_device *dev, struct drm_file *file_private); | |
1474 | ||
f77d390c BH |
1475 | extern void drm_core_ioremap(struct drm_local_map *map, struct drm_device *dev); |
1476 | extern void drm_core_ioremap_wc(struct drm_local_map *map, struct drm_device *dev); | |
1477 | extern void drm_core_ioremapfree(struct drm_local_map *map, struct drm_device *dev); | |
1da177e4 | 1478 | |
f77d390c BH |
1479 | static __inline__ struct drm_local_map *drm_core_findmap(struct drm_device *dev, |
1480 | unsigned int token) | |
1da177e4 | 1481 | { |
55910517 | 1482 | struct drm_map_list *_entry; |
bd1b331f | 1483 | list_for_each_entry(_entry, &dev->maplist, head) |
b5e89ed5 DA |
1484 | if (_entry->user_token == token) |
1485 | return _entry->map; | |
1da177e4 LT |
1486 | return NULL; |
1487 | } | |
1488 | ||
8410ea3b | 1489 | static __inline__ void drm_core_dropmap(struct drm_local_map *map) |
cda17380 | 1490 | { |
8410ea3b DA |
1491 | } |
1492 | ||
a1ce3928 | 1493 | #include <drm/drm_mem_util.h> |
dcdb1674 | 1494 | |
1bb72532 DH |
1495 | struct drm_device *drm_dev_alloc(struct drm_driver *driver, |
1496 | struct device *parent); | |
099d1c29 DH |
1497 | void drm_dev_ref(struct drm_device *dev); |
1498 | void drm_dev_unref(struct drm_device *dev); | |
c22f0ace | 1499 | int drm_dev_register(struct drm_device *dev, unsigned long flags); |
c3a49737 | 1500 | void drm_dev_unregister(struct drm_device *dev); |
ca8e2ad7 | 1501 | int drm_dev_set_unique(struct drm_device *dev, const char *fmt, ...); |
1616c525 DH |
1502 | |
1503 | struct drm_minor *drm_minor_acquire(unsigned int minor_id); | |
1504 | void drm_minor_release(struct drm_minor *minor); | |
1505 | ||
8410ea3b DA |
1506 | /*@}*/ |
1507 | ||
1508 | /* PCI section */ | |
1509 | static __inline__ int drm_pci_device_is_agp(struct drm_device *dev) | |
1510 | { | |
b5e89ed5 DA |
1511 | if (dev->driver->device_is_agp != NULL) { |
1512 | int err = (*dev->driver->device_is_agp) (dev); | |
1513 | ||
cda17380 DA |
1514 | if (err != 2) { |
1515 | return err; | |
1516 | } | |
1517 | } | |
1518 | ||
1519 | return pci_find_capability(dev->pdev, PCI_CAP_ID_AGP); | |
1520 | } | |
4efafebe | 1521 | void drm_pci_agp_destroy(struct drm_device *dev); |
cda17380 | 1522 | |
8410ea3b DA |
1523 | extern int drm_pci_init(struct drm_driver *driver, struct pci_driver *pdriver); |
1524 | extern void drm_pci_exit(struct drm_driver *driver, struct pci_driver *pdriver); | |
1525 | extern int drm_get_pci_dev(struct pci_dev *pdev, | |
dcdb1674 JC |
1526 | const struct pci_device_id *ent, |
1527 | struct drm_driver *driver); | |
8410ea3b | 1528 | |
f4297784 DA |
1529 | #define DRM_PCIE_SPEED_25 1 |
1530 | #define DRM_PCIE_SPEED_50 2 | |
1531 | #define DRM_PCIE_SPEED_80 4 | |
1532 | ||
1533 | extern int drm_pcie_get_speed_cap_mask(struct drm_device *dev, u32 *speed_mask); | |
8410ea3b DA |
1534 | |
1535 | /* platform section */ | |
1536 | extern int drm_platform_init(struct drm_driver *driver, struct platform_device *platform_device); | |
8410ea3b | 1537 | |
cc1f7194 DA |
1538 | /* returns true if currently okay to sleep */ |
1539 | static __inline__ bool drm_can_sleep(void) | |
1540 | { | |
1541 | if (in_atomic() || in_dbg_master() || irqs_disabled()) | |
1542 | return false; | |
1543 | return true; | |
1544 | } | |
1545 | ||
1da177e4 | 1546 | #endif |