]>
Commit | Line | Data |
---|---|---|
1da177e4 | 1 | /* |
d7d2c48e DH |
2 | * Internal Header for the Direct Rendering Manager |
3 | * | |
1da177e4 LT |
4 | * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas. |
5 | * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California. | |
dcdb1674 | 6 | * Copyright (c) 2009-2010, Code Aurora Forum. |
1da177e4 LT |
7 | * All rights reserved. |
8 | * | |
d7d2c48e DH |
9 | * Author: Rickard E. (Rik) Faith <faith@valinux.com> |
10 | * Author: Gareth Hughes <gareth@valinux.com> | |
11 | * | |
1da177e4 LT |
12 | * Permission is hereby granted, free of charge, to any person obtaining a |
13 | * copy of this software and associated documentation files (the "Software"), | |
14 | * to deal in the Software without restriction, including without limitation | |
15 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
16 | * and/or sell copies of the Software, and to permit persons to whom the | |
17 | * Software is furnished to do so, subject to the following conditions: | |
18 | * | |
19 | * The above copyright notice and this permission notice (including the next | |
20 | * paragraph) shall be included in all copies or substantial portions of the | |
21 | * Software. | |
22 | * | |
23 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
24 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
25 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
26 | * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR | |
27 | * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, | |
28 | * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR | |
29 | * OTHER DEALINGS IN THE SOFTWARE. | |
30 | */ | |
31 | ||
32 | #ifndef _DRM_P_H_ | |
33 | #define _DRM_P_H_ | |
34 | ||
96993908 DH |
35 | #include <linux/agp_backend.h> |
36 | #include <linux/cdev.h> | |
37 | #include <linux/dma-mapping.h> | |
38 | #include <linux/file.h> | |
1da177e4 | 39 | #include <linux/fs.h> |
96993908 DH |
40 | #include <linux/highmem.h> |
41 | #include <linux/idr.h> | |
1da177e4 | 42 | #include <linux/init.h> |
96993908 | 43 | #include <linux/io.h> |
1da177e4 | 44 | #include <linux/jiffies.h> |
96993908 DH |
45 | #include <linux/kernel.h> |
46 | #include <linux/kref.h> | |
47 | #include <linux/miscdevice.h> | |
1da177e4 | 48 | #include <linux/mm.h> |
30e2fb18 | 49 | #include <linux/mutex.h> |
96993908 DH |
50 | #include <linux/pci.h> |
51 | #include <linux/platform_device.h> | |
52 | #include <linux/poll.h> | |
5d13d425 | 53 | #include <linux/ratelimit.h> |
077675c1 | 54 | #include <linux/rbtree.h> |
96993908 DH |
55 | #include <linux/sched.h> |
56 | #include <linux/slab.h> | |
1da177e4 | 57 | #include <linux/types.h> |
d6db6564 | 58 | #include <linux/vmalloc.h> |
96993908 | 59 | #include <linux/workqueue.h> |
f54d1867 | 60 | #include <linux/dma-fence.h> |
96993908 DH |
61 | |
62 | #include <asm/mman.h> | |
1da177e4 | 63 | #include <asm/pgalloc.h> |
7c0f6ba6 | 64 | #include <linux/uaccess.h> |
96993908 | 65 | |
d7d2c48e DH |
66 | #include <uapi/drm/drm.h> |
67 | #include <uapi/drm/drm_mode.h> | |
68 | ||
69 | #include <drm/drm_agpsupport.h> | |
70 | #include <drm/drm_crtc.h> | |
ae4df11a | 71 | #include <drm/drm_fourcc.h> |
d7d2c48e | 72 | #include <drm/drm_global.h> |
96993908 | 73 | #include <drm/drm_hashtab.h> |
d7d2c48e | 74 | #include <drm/drm_mem_util.h> |
96993908 DH |
75 | #include <drm/drm_mm.h> |
76 | #include <drm/drm_os_linux.h> | |
19218e48 | 77 | #include <drm/drm_sarea.h> |
0de23977 | 78 | #include <drm/drm_vma_manager.h> |
85e634bc | 79 | #include <drm/drm_drv.h> |
1da177e4 | 80 | |
de477254 PG |
81 | struct module; |
82 | ||
c153f45f EA |
83 | struct drm_file; |
84 | struct drm_device; | |
cc5ea594 | 85 | struct drm_agp_head; |
ba8286fa DV |
86 | struct drm_local_map; |
87 | struct drm_device_dma; | |
88 | struct drm_dma_handle; | |
d9fc9413 | 89 | struct drm_gem_object; |
3b96a0b1 | 90 | struct drm_master; |
34a67dd7 | 91 | struct drm_vblank_crtc; |
c153f45f | 92 | |
edb37a95 | 93 | struct device_node; |
ebc64e45 | 94 | struct videomode; |
3aac4502 | 95 | struct reservation_object; |
b5e9c1a2 | 96 | struct dma_buf_attachment; |
ebc64e45 | 97 | |
87fdff81 | 98 | /* |
346fea63 | 99 | * The following categories are defined: |
1414b76c LD |
100 | * |
101 | * CORE: Used in the generic drm code: drm_ioctl.c, drm_mm.c, drm_memory.c, ... | |
102 | * This is the category used by the DRM_DEBUG() macro. | |
103 | * | |
104 | * DRIVER: Used in the vendor specific part of the driver: i915, radeon, ... | |
105 | * This is the category used by the DRM_DEBUG_DRIVER() macro. | |
87fdff81 | 106 | * |
1414b76c LD |
107 | * KMS: used in the modesetting code. |
108 | * This is the category used by the DRM_DEBUG_KMS() macro. | |
87fdff81 | 109 | * |
1414b76c LD |
110 | * PRIME: used in the prime code. |
111 | * This is the category used by the DRM_DEBUG_PRIME() macro. | |
87fdff81 | 112 | * |
17a38d9c DV |
113 | * ATOMIC: used in the atomic code. |
114 | * This is the category used by the DRM_DEBUG_ATOMIC() macro. | |
115 | * | |
235fabe0 VS |
116 | * VBL: used for verbose debug message in the vblank code |
117 | * This is the category used by the DRM_DEBUG_VBL() macro. | |
118 | * | |
1414b76c LD |
119 | * Enabling verbose debug messages is done through the drm.debug parameter, |
120 | * each category being enabled by a bit. | |
121 | * | |
122 | * drm.debug=0x1 will enable CORE messages | |
123 | * drm.debug=0x2 will enable DRIVER messages | |
124 | * drm.debug=0x3 will enable CORE and DRIVER messages | |
125 | * ... | |
235fabe0 | 126 | * drm.debug=0x3f will enable all messages |
1414b76c LD |
127 | * |
128 | * An interesting feature is that it's possible to enable verbose logging at | |
129 | * run-time by echoing the debug value in its sysfs node: | |
130 | * # echo 0xf > /sys/module/drm/parameters/debug | |
87fdff81 | 131 | */ |
c4e68a58 | 132 | #define DRM_UT_NONE 0x00 |
1414b76c LD |
133 | #define DRM_UT_CORE 0x01 |
134 | #define DRM_UT_DRIVER 0x02 | |
135 | #define DRM_UT_KMS 0x04 | |
136 | #define DRM_UT_PRIME 0x08 | |
17a38d9c | 137 | #define DRM_UT_ATOMIC 0x10 |
235fabe0 | 138 | #define DRM_UT_VBL 0x20 |
fceffb32 | 139 | #define DRM_UT_STATE 0x40 |
4fefcb27 | 140 | |
1da177e4 LT |
141 | /***********************************************************************/ |
142 | /** \name DRM template customization defaults */ | |
143 | /*@{*/ | |
144 | ||
1da177e4 | 145 | /***********************************************************************/ |
1da177e4 LT |
146 | /** \name Macros to make printk easier */ |
147 | /*@{*/ | |
148 | ||
30b0da8d DG |
149 | #define _DRM_PRINTK(once, level, fmt, ...) \ |
150 | do { \ | |
151 | printk##once(KERN_##level "[" DRM_NAME "] " fmt, \ | |
152 | ##__VA_ARGS__); \ | |
153 | } while (0) | |
154 | ||
155 | #define DRM_INFO(fmt, ...) \ | |
156 | _DRM_PRINTK(, INFO, fmt, ##__VA_ARGS__) | |
157 | #define DRM_NOTE(fmt, ...) \ | |
158 | _DRM_PRINTK(, NOTICE, fmt, ##__VA_ARGS__) | |
159 | #define DRM_WARN(fmt, ...) \ | |
160 | _DRM_PRINTK(, WARNING, fmt, ##__VA_ARGS__) | |
161 | ||
162 | #define DRM_INFO_ONCE(fmt, ...) \ | |
163 | _DRM_PRINTK(_once, INFO, fmt, ##__VA_ARGS__) | |
164 | #define DRM_NOTE_ONCE(fmt, ...) \ | |
165 | _DRM_PRINTK(_once, NOTICE, fmt, ##__VA_ARGS__) | |
166 | #define DRM_WARN_ONCE(fmt, ...) \ | |
167 | _DRM_PRINTK(_once, WARNING, fmt, ##__VA_ARGS__) | |
168 | ||
1da177e4 LT |
169 | /** |
170 | * Error output. | |
171 | * | |
172 | * \param fmt printf() like format string. | |
173 | * \param arg arguments | |
174 | */ | |
c4e68a58 SP |
175 | #define DRM_DEV_ERROR(dev, fmt, ...) \ |
176 | drm_dev_printk(dev, KERN_ERR, DRM_UT_NONE, __func__, " *ERROR*",\ | |
177 | fmt, ##__VA_ARGS__) | |
178 | #define DRM_ERROR(fmt, ...) \ | |
6bd488db | 179 | drm_printk(KERN_ERR, DRM_UT_NONE, fmt, ##__VA_ARGS__) |
1da177e4 | 180 | |
5d13d425 RC |
181 | /** |
182 | * Rate limited error output. Like DRM_ERROR() but won't flood the log. | |
183 | * | |
184 | * \param fmt printf() like format string. | |
185 | * \param arg arguments | |
186 | */ | |
c4e68a58 | 187 | #define DRM_DEV_ERROR_RATELIMITED(dev, fmt, ...) \ |
5d13d425 RC |
188 | ({ \ |
189 | static DEFINE_RATELIMIT_STATE(_rs, \ | |
190 | DEFAULT_RATELIMIT_INTERVAL, \ | |
191 | DEFAULT_RATELIMIT_BURST); \ | |
192 | \ | |
193 | if (__ratelimit(&_rs)) \ | |
c4e68a58 | 194 | DRM_DEV_ERROR(dev, fmt, ##__VA_ARGS__); \ |
5d13d425 | 195 | }) |
c4e68a58 SP |
196 | #define DRM_ERROR_RATELIMITED(fmt, ...) \ |
197 | DRM_DEV_ERROR_RATELIMITED(NULL, fmt, ##__VA_ARGS__) | |
5d13d425 | 198 | |
c4e68a58 SP |
199 | #define DRM_DEV_INFO(dev, fmt, ...) \ |
200 | drm_dev_printk(dev, KERN_INFO, DRM_UT_NONE, __func__, "", fmt, \ | |
201 | ##__VA_ARGS__) | |
1da177e4 | 202 | |
c4e68a58 SP |
203 | #define DRM_DEV_INFO_ONCE(dev, fmt, ...) \ |
204 | ({ \ | |
205 | static bool __print_once __read_mostly; \ | |
206 | if (!__print_once) { \ | |
207 | __print_once = true; \ | |
208 | DRM_DEV_INFO(dev, fmt, ##__VA_ARGS__); \ | |
209 | } \ | |
210 | }) | |
48b8f631 | 211 | |
1da177e4 LT |
212 | /** |
213 | * Debug output. | |
b5e89ed5 | 214 | * |
1da177e4 LT |
215 | * \param fmt printf() like format string. |
216 | * \param arg arguments | |
217 | */ | |
c4e68a58 SP |
218 | #define DRM_DEV_DEBUG(dev, fmt, args...) \ |
219 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_CORE, __func__, "", fmt, \ | |
220 | ##args) | |
6bd488db JP |
221 | #define DRM_DEBUG(fmt, ...) \ |
222 | drm_printk(KERN_DEBUG, DRM_UT_CORE, fmt, ##__VA_ARGS__) | |
4fefcb27 | 223 | |
c4e68a58 SP |
224 | #define DRM_DEV_DEBUG_DRIVER(dev, fmt, args...) \ |
225 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_DRIVER, __func__, "", \ | |
226 | fmt, ##args) | |
6bd488db JP |
227 | #define DRM_DEBUG_DRIVER(fmt, ...) \ |
228 | drm_printk(KERN_DEBUG, DRM_UT_DRIVER, fmt, ##__VA_ARGS__) | |
c4e68a58 SP |
229 | |
230 | #define DRM_DEV_DEBUG_KMS(dev, fmt, args...) \ | |
231 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_KMS, __func__, "", fmt, \ | |
232 | ##args) | |
6bd488db JP |
233 | #define DRM_DEBUG_KMS(fmt, ...) \ |
234 | drm_printk(KERN_DEBUG, DRM_UT_KMS, fmt, ##__VA_ARGS__) | |
c4e68a58 SP |
235 | |
236 | #define DRM_DEV_DEBUG_PRIME(dev, fmt, args...) \ | |
237 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_PRIME, __func__, "", \ | |
238 | fmt, ##args) | |
6bd488db JP |
239 | #define DRM_DEBUG_PRIME(fmt, ...) \ |
240 | drm_printk(KERN_DEBUG, DRM_UT_PRIME, fmt, ##__VA_ARGS__) | |
c4e68a58 SP |
241 | |
242 | #define DRM_DEV_DEBUG_ATOMIC(dev, fmt, args...) \ | |
243 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_ATOMIC, __func__, "", \ | |
244 | fmt, ##args) | |
6bd488db JP |
245 | #define DRM_DEBUG_ATOMIC(fmt, ...) \ |
246 | drm_printk(KERN_DEBUG, DRM_UT_ATOMIC, fmt, ##__VA_ARGS__) | |
c4e68a58 SP |
247 | |
248 | #define DRM_DEV_DEBUG_VBL(dev, fmt, args...) \ | |
249 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_VBL, __func__, "", fmt, \ | |
250 | ##args) | |
6bd488db JP |
251 | #define DRM_DEBUG_VBL(fmt, ...) \ |
252 | drm_printk(KERN_DEBUG, DRM_UT_VBL, fmt, ##__VA_ARGS__) | |
1da177e4 | 253 | |
c4e68a58 SP |
254 | #define _DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, level, fmt, args...) \ |
255 | ({ \ | |
256 | static DEFINE_RATELIMIT_STATE(_rs, \ | |
257 | DEFAULT_RATELIMIT_INTERVAL, \ | |
258 | DEFAULT_RATELIMIT_BURST); \ | |
259 | if (__ratelimit(&_rs)) \ | |
260 | drm_dev_printk(dev, KERN_DEBUG, DRM_UT_ ## level, \ | |
261 | __func__, "", fmt, ##args); \ | |
262 | }) | |
27528c66 L |
263 | |
264 | /** | |
265 | * Rate limited debug output. Like DRM_DEBUG() but won't flood the log. | |
266 | * | |
267 | * \param fmt printf() like format string. | |
268 | * \param arg arguments | |
269 | */ | |
c4e68a58 SP |
270 | #define DRM_DEV_DEBUG_RATELIMITED(dev, fmt, args...) \ |
271 | DEV__DRM_DEFINE_DEBUG_RATELIMITED(dev, CORE, fmt, ##args) | |
27528c66 | 272 | #define DRM_DEBUG_RATELIMITED(fmt, args...) \ |
c4e68a58 SP |
273 | DRM_DEV_DEBUG_RATELIMITED(NULL, fmt, ##args) |
274 | #define DRM_DEV_DEBUG_DRIVER_RATELIMITED(dev, fmt, args...) \ | |
275 | _DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, DRIVER, fmt, ##args) | |
27528c66 | 276 | #define DRM_DEBUG_DRIVER_RATELIMITED(fmt, args...) \ |
c4e68a58 SP |
277 | DRM_DEV_DEBUG_DRIVER_RATELIMITED(NULL, fmt, ##args) |
278 | #define DRM_DEV_DEBUG_KMS_RATELIMITED(dev, fmt, args...) \ | |
279 | _DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, KMS, fmt, ##args) | |
27528c66 | 280 | #define DRM_DEBUG_KMS_RATELIMITED(fmt, args...) \ |
c4e68a58 SP |
281 | DRM_DEV_DEBUG_KMS_RATELIMITED(NULL, fmt, ##args) |
282 | #define DRM_DEV_DEBUG_PRIME_RATELIMITED(dev, fmt, args...) \ | |
283 | _DRM_DEV_DEFINE_DEBUG_RATELIMITED(dev, PRIME, fmt, ##args) | |
27528c66 | 284 | #define DRM_DEBUG_PRIME_RATELIMITED(fmt, args...) \ |
c4e68a58 | 285 | DRM_DEV_DEBUG_PRIME_RATELIMITED(NULL, fmt, ##args) |
27528c66 | 286 | |
65c7dc18 RC |
287 | /* Format strings and argument splitters to simplify printing |
288 | * various "complex" objects | |
289 | */ | |
290 | #define DRM_MODE_FMT "%d:\"%s\" %d %d %d %d %d %d %d %d %d %d 0x%x 0x%x" | |
291 | #define DRM_MODE_ARG(m) \ | |
292 | (m)->base.id, (m)->name, (m)->vrefresh, (m)->clock, \ | |
293 | (m)->hdisplay, (m)->hsync_start, (m)->hsync_end, (m)->htotal, \ | |
294 | (m)->vdisplay, (m)->vsync_start, (m)->vsync_end, (m)->vtotal, \ | |
295 | (m)->type, (m)->flags | |
296 | ||
297 | #define DRM_RECT_FMT "%dx%d%+d%+d" | |
298 | #define DRM_RECT_ARG(r) drm_rect_width(r), drm_rect_height(r), (r)->x1, (r)->y1 | |
299 | ||
300 | /* for rect's in fixed-point format: */ | |
301 | #define DRM_RECT_FP_FMT "%d.%06ux%d.%06u%+d.%06u%+d.%06u" | |
302 | #define DRM_RECT_FP_ARG(r) \ | |
303 | drm_rect_width(r) >> 16, ((drm_rect_width(r) & 0xffff) * 15625) >> 10, \ | |
304 | drm_rect_height(r) >> 16, ((drm_rect_height(r) & 0xffff) * 15625) >> 10, \ | |
305 | (r)->x1 >> 16, (((r)->x1 & 0xffff) * 15625) >> 10, \ | |
306 | (r)->y1 >> 16, (((r)->y1 & 0xffff) * 15625) >> 10 | |
307 | ||
1da177e4 LT |
308 | /*@}*/ |
309 | ||
1da177e4 LT |
310 | /***********************************************************************/ |
311 | /** \name Internal types and structures */ | |
312 | /*@{*/ | |
313 | ||
1da177e4 | 314 | #define DRM_IF_VERSION(maj, min) (maj << 16 | min) |
1da177e4 | 315 | |
1da177e4 LT |
316 | /** |
317 | * Ioctl function type. | |
318 | * | |
319 | * \param inode device inode. | |
6c340eac | 320 | * \param file_priv DRM file private pointer. |
1da177e4 LT |
321 | * \param cmd command. |
322 | * \param arg argument. | |
323 | */ | |
c153f45f EA |
324 | typedef int drm_ioctl_t(struct drm_device *dev, void *data, |
325 | struct drm_file *file_priv); | |
1da177e4 | 326 | |
9a186645 DA |
327 | typedef int drm_ioctl_compat_t(struct file *filp, unsigned int cmd, |
328 | unsigned long arg); | |
329 | ||
1a95916f KH |
330 | #define DRM_IOCTL_NR(n) _IOC_NR(n) |
331 | #define DRM_MAJOR 226 | |
332 | ||
a7a2cc31 DA |
333 | #define DRM_AUTH 0x1 |
334 | #define DRM_MASTER 0x2 | |
335 | #define DRM_ROOT_ONLY 0x4 | |
f453ba04 | 336 | #define DRM_CONTROL_ALLOW 0x8 |
ed8b6704 | 337 | #define DRM_UNLOCKED 0x10 |
1793126f | 338 | #define DRM_RENDER_ALLOW 0x20 |
a7a2cc31 | 339 | |
c153f45f EA |
340 | struct drm_ioctl_desc { |
341 | unsigned int cmd; | |
a7a2cc31 | 342 | int flags; |
c972d750 | 343 | drm_ioctl_t *func; |
b9434d0f | 344 | const char *name; |
c153f45f EA |
345 | }; |
346 | ||
347 | /** | |
348 | * Creates a driver or general drm_ioctl_desc array entry for the given | |
349 | * ioctl, for use by drm_ioctl(). | |
350 | */ | |
1b2f1489 | 351 | |
066626d5 EV |
352 | #define DRM_IOCTL_DEF_DRV(ioctl, _func, _flags) \ |
353 | [DRM_IOCTL_NR(DRM_IOCTL_##ioctl) - DRM_COMMAND_BASE] = { \ | |
354 | .cmd = DRM_IOCTL_##ioctl, \ | |
355 | .func = _func, \ | |
356 | .flags = _flags, \ | |
357 | .name = #ioctl \ | |
358 | } | |
1da177e4 | 359 | |
c9a9c5e0 KH |
360 | /* Event queued up for userspace to read */ |
361 | struct drm_pending_event { | |
3b24f7d6 | 362 | struct completion *completion; |
7ff24865 | 363 | void (*completion_release)(struct completion *completion); |
c9a9c5e0 | 364 | struct drm_event *event; |
f54d1867 | 365 | struct dma_fence *fence; |
c9a9c5e0 | 366 | struct list_head link; |
681047b4 | 367 | struct list_head pending_link; |
c9a9c5e0 | 368 | struct drm_file *file_priv; |
b9c2c9ae JB |
369 | pid_t pid; /* pid of requester, no guarantee it's valid by the time |
370 | we deliver the event, for tracing only */ | |
c9a9c5e0 KH |
371 | }; |
372 | ||
3248877e | 373 | struct drm_prime_file_private { |
3248877e | 374 | struct mutex lock; |
077675c1 CW |
375 | struct rb_root dmabufs; |
376 | struct rb_root handles; | |
3248877e DA |
377 | }; |
378 | ||
1da177e4 | 379 | /** File private data */ |
84b1fd10 | 380 | struct drm_file { |
39868bd7 | 381 | unsigned authenticated :1; |
39868bd7 CW |
382 | /* true when the client has asked us to expose stereo 3D mode flags */ |
383 | unsigned stereo_allowed :1; | |
681e7ec7 MR |
384 | /* |
385 | * true if client understands CRTC primary planes and cursor planes | |
386 | * in the plane list | |
387 | */ | |
388 | unsigned universal_planes:1; | |
88a48e29 RC |
389 | /* true if client understands atomic properties */ |
390 | unsigned atomic:1; | |
a0af2e53 | 391 | /* |
0aae5920 | 392 | * This client is the creator of @master. |
a0af2e53 TH |
393 | * Protected by struct drm_device::master_mutex. |
394 | */ | |
0aae5920 | 395 | unsigned is_master:1; |
39868bd7 | 396 | |
5fce5e0b | 397 | struct pid *pid; |
b5e89ed5 | 398 | drm_magic_t magic; |
bd1b331f | 399 | struct list_head lhead; |
2c14f28b | 400 | struct drm_minor *minor; |
b5e89ed5 | 401 | unsigned long lock_count; |
7c1c2871 | 402 | |
673a394b EA |
403 | /** Mapping of mm object handles to object pointers. */ |
404 | struct idr object_idr; | |
405 | /** Lock for synchronization of access to object_idr. */ | |
406 | spinlock_t table_lock; | |
7c1c2871 | 407 | |
6c340eac | 408 | struct file *filp; |
8562b3f2 | 409 | void *driver_priv; |
7c1c2871 | 410 | |
7c1c2871 | 411 | struct drm_master *master; /* master this node is currently associated with |
95c081c1 | 412 | N.B. not always dev->master */ |
4b096ac1 DV |
413 | /** |
414 | * fbs - List of framebuffers associated with this file. | |
415 | * | |
416 | * Protected by fbs_lock. Note that the fbs list holds a reference on | |
417 | * the fb object to prevent it from untimely disappearing. | |
418 | */ | |
f453ba04 | 419 | struct list_head fbs; |
4b096ac1 | 420 | struct mutex fbs_lock; |
c9a9c5e0 | 421 | |
e2f5d2ea DS |
422 | /** User-created blob properties; this retains a reference on the |
423 | * property. */ | |
424 | struct list_head blobs; | |
425 | ||
c9a9c5e0 | 426 | wait_queue_head_t event_wait; |
681047b4 | 427 | struct list_head pending_event_list; |
c9a9c5e0 KH |
428 | struct list_head event_list; |
429 | int event_space; | |
3248877e | 430 | |
9b2c0b7f CW |
431 | struct mutex event_read_lock; |
432 | ||
3248877e | 433 | struct drm_prime_file_private prime; |
84b1fd10 | 434 | }; |
1da177e4 | 435 | |
1da177e4 LT |
436 | /** |
437 | * Lock data. | |
438 | */ | |
55910517 | 439 | struct drm_lock_data { |
c60ce623 | 440 | struct drm_hw_lock *hw_lock; /**< Hardware lock */ |
8562b3f2 DA |
441 | /** Private of lock holder's file (NULL=kernel) */ |
442 | struct drm_file *file_priv; | |
1da177e4 | 443 | wait_queue_head_t lock_queue; /**< Queue of blocked processes */ |
b5e89ed5 | 444 | unsigned long lock_time; /**< Time of last lock in jiffies */ |
040ac320 TH |
445 | spinlock_t spinlock; |
446 | uint32_t kernel_waiters; | |
447 | uint32_t user_waiters; | |
448 | int idle_has_lock; | |
55910517 | 449 | }; |
1da177e4 | 450 | |
27641c3f MK |
451 | /* Flags and return codes for get_vblank_timestamp() driver function. */ |
452 | #define DRM_CALLED_FROM_VBLIRQ 1 | |
453 | #define DRM_VBLANKTIME_SCANOUTPOS_METHOD (1 << 0) | |
3d3cbd84 | 454 | #define DRM_VBLANKTIME_IN_VBLANK (1 << 1) |
27641c3f MK |
455 | |
456 | /* get_scanout_position() return flags */ | |
457 | #define DRM_SCANOUTPOS_VALID (1 << 0) | |
3d3cbd84 | 458 | #define DRM_SCANOUTPOS_IN_VBLANK (1 << 1) |
27641c3f MK |
459 | #define DRM_SCANOUTPOS_ACCURATE (1 << 2) |
460 | ||
cb8a239b | 461 | enum drm_minor_type { |
a3ccc461 | 462 | DRM_MINOR_PRIMARY, |
cb8a239b DH |
463 | DRM_MINOR_CONTROL, |
464 | DRM_MINOR_RENDER, | |
465 | DRM_MINOR_CNT, | |
466 | }; | |
2c14f28b | 467 | |
955b12de BG |
468 | /** |
469 | * Info file list entry. This structure represents a debugfs or proc file to | |
470 | * be created by the drm core | |
471 | */ | |
472 | struct drm_info_list { | |
473 | const char *name; /** file name */ | |
474 | int (*show)(struct seq_file*, void*); /** show callback */ | |
475 | u32 driver_features; /**< Required driver features for this entry */ | |
476 | void *data; | |
477 | }; | |
478 | ||
479 | /** | |
480 | * debugfs node structure. This structure represents a debugfs file. | |
481 | */ | |
482 | struct drm_info_node { | |
483 | struct list_head list; | |
484 | struct drm_minor *minor; | |
ce089b54 | 485 | const struct drm_info_list *info_ent; |
955b12de BG |
486 | struct dentry *dent; |
487 | }; | |
488 | ||
1da177e4 | 489 | /** |
2c14f28b | 490 | * DRM minor structure. This structure represents a drm minor number. |
1da177e4 | 491 | */ |
2c14f28b DA |
492 | struct drm_minor { |
493 | int index; /**< Minor device number */ | |
494 | int type; /**< Control or render */ | |
5bdebb18 | 495 | struct device *kdev; /**< Linux device */ |
1da177e4 | 496 | struct drm_device *dev; |
955b12de | 497 | |
955b12de | 498 | struct dentry *debugfs_root; |
b3e067c0 MS |
499 | |
500 | struct list_head debugfs_list; | |
501 | struct mutex debugfs_lock; /* Protects debugfs_list. */ | |
84b1fd10 | 502 | }; |
1da177e4 LT |
503 | |
504 | /** | |
505 | * DRM device structure. This structure represent a complete card that | |
506 | * may contain multiple heads. | |
507 | */ | |
84b1fd10 | 508 | struct drm_device { |
b3f2333d | 509 | struct list_head legacy_dev_list;/**< list of devices per driver for stealth attach cleanup */ |
b5e89ed5 | 510 | int if_version; /**< Highest interface version set */ |
1da177e4 | 511 | |
45e212d2 DH |
512 | /** \name Lifetime Management */ |
513 | /*@{ */ | |
099d1c29 | 514 | struct kref ref; /**< Object ref-count */ |
45e212d2 DH |
515 | struct device *dev; /**< Device structure of bus-device */ |
516 | struct drm_driver *driver; /**< DRM driver managing the device */ | |
517 | void *dev_private; /**< DRM driver private data */ | |
45e212d2 DH |
518 | struct drm_minor *control; /**< Control node */ |
519 | struct drm_minor *primary; /**< Primary node */ | |
520 | struct drm_minor *render; /**< Render node */ | |
e6e7b48b | 521 | bool registered; |
95c081c1 DV |
522 | |
523 | /* currently active master for this device. Protected by master_mutex */ | |
524 | struct drm_master *master; | |
525 | ||
45e212d2 | 526 | atomic_t unplugged; /**< Flag whether dev is dead */ |
07b48c3a | 527 | struct inode *anon_inode; /**< inode for private address-space */ |
ca8e2ad7 | 528 | char *unique; /**< unique name of the device */ |
45e212d2 DH |
529 | /*@} */ |
530 | ||
1da177e4 | 531 | /** \name Locks */ |
b5e89ed5 | 532 | /*@{ */ |
30e2fb18 | 533 | struct mutex struct_mutex; /**< For others */ |
c996fd0b | 534 | struct mutex master_mutex; /**< For drm_minor::master and drm_file::is_master */ |
b5e89ed5 | 535 | /*@} */ |
1da177e4 LT |
536 | |
537 | /** \name Usage Counters */ | |
b5e89ed5 | 538 | /*@{ */ |
fc8fd40e | 539 | int open_count; /**< Outstanding files open, protected by drm_global_mutex. */ |
2177a218 | 540 | spinlock_t buf_lock; /**< For drm_device::buf_use and a few other things. */ |
b5e89ed5 DA |
541 | int buf_use; /**< Buffers in use -- cannot alloc */ |
542 | atomic_t buf_alloc; /**< Buffer allocation in progress */ | |
543 | /*@} */ | |
1da177e4 | 544 | |
1d2ac403 | 545 | struct mutex filelist_mutex; |
bd1b331f | 546 | struct list_head filelist; |
1da177e4 LT |
547 | |
548 | /** \name Memory management */ | |
b5e89ed5 | 549 | /*@{ */ |
bd1b331f | 550 | struct list_head maplist; /**< Linked list of regions */ |
e0be428e | 551 | struct drm_open_hash map_hash; /**< User token hash table for maps */ |
1da177e4 LT |
552 | |
553 | /** \name Context handle management */ | |
b5e89ed5 | 554 | /*@{ */ |
bd1b331f | 555 | struct list_head ctxlist; /**< Linked list of context handles */ |
30e2fb18 | 556 | struct mutex ctxlist_mutex; /**< For ctxlist */ |
1da177e4 | 557 | |
62968144 | 558 | struct idr ctx_idr; |
1da177e4 | 559 | |
bd1b331f | 560 | struct list_head vmalist; /**< List of vmas (for debugging) */ |
f453ba04 | 561 | |
b5e89ed5 | 562 | /*@} */ |
1da177e4 | 563 | |
a344a7e7 | 564 | /** \name DMA support */ |
b5e89ed5 | 565 | /*@{ */ |
cdd55a29 | 566 | struct drm_device_dma *dma; /**< Optional pointer for DMA support */ |
b5e89ed5 | 567 | /*@} */ |
1da177e4 LT |
568 | |
569 | /** \name Context support */ | |
b5e89ed5 | 570 | /*@{ */ |
7c1a38e3 | 571 | |
1da177e4 | 572 | __volatile__ long context_flag; /**< Context swapping flag */ |
b5e89ed5 | 573 | int last_context; /**< Last current context */ |
b5e89ed5 DA |
574 | /*@} */ |
575 | ||
1da177e4 | 576 | /** \name VBLANK IRQ support */ |
b5e89ed5 | 577 | /*@{ */ |
b46004b7 TR |
578 | bool irq_enabled; |
579 | int irq; | |
b5e89ed5 | 580 | |
00185e66 VS |
581 | /* |
582 | * If true, vblank interrupt will be disabled immediately when the | |
583 | * refcount drops to zero, as opposed to via the vblank disable | |
584 | * timer. | |
585 | * This can be set to true it the hardware has a working vblank | |
586 | * counter and the driver uses drm_vblank_on() and drm_vblank_off() | |
587 | * appropriately. | |
588 | */ | |
589 | bool vblank_disable_immediate; | |
590 | ||
5380e929 VS |
591 | /* array of size num_crtcs */ |
592 | struct drm_vblank_crtc *vblank; | |
0a3e67a4 | 593 | |
27641c3f | 594 | spinlock_t vblank_time_lock; /**< Protects vblank count and time updates during vblank enable/disable */ |
b5e89ed5 | 595 | spinlock_t vbl_lock; |
0a3e67a4 JB |
596 | |
597 | u32 max_vblank_count; /**< size of vblank counter register */ | |
b5e89ed5 | 598 | |
c9a9c5e0 KH |
599 | /** |
600 | * List of events | |
601 | */ | |
602 | struct list_head vblank_event_list; | |
603 | spinlock_t event_lock; | |
604 | ||
b5e89ed5 | 605 | /*@} */ |
b5e89ed5 | 606 | |
55910517 | 607 | struct drm_agp_head *agp; /**< AGP data */ |
1da177e4 | 608 | |
b5e89ed5 | 609 | struct pci_dev *pdev; /**< PCI device structure */ |
1da177e4 | 610 | #ifdef __alpha__ |
1da177e4 | 611 | struct pci_controller *hose; |
1da177e4 | 612 | #endif |
dcdb1674 JC |
613 | |
614 | struct platform_device *platformdev; /**< Platform device struture */ | |
dc5698e8 | 615 | struct virtio_device *virtdev; |
dcdb1674 | 616 | |
55910517 | 617 | struct drm_sg_mem *sg; /**< Scatter gather memory */ |
19227561 | 618 | unsigned int num_crtcs; /**< Number of CRTCs on this device */ |
b5e89ed5 | 619 | |
69d516c0 DH |
620 | struct { |
621 | int context; | |
622 | struct drm_hw_lock *lock; | |
623 | } sigdata; | |
624 | ||
f77d390c | 625 | struct drm_local_map *agp_buffer_map; |
d1f2b55a | 626 | unsigned int agp_buffer_token; |
bea5679f | 627 | |
417009fb | 628 | struct drm_mode_config mode_config; /**< Current mode config */ |
f453ba04 | 629 | |
673a394b EA |
630 | /** \name GEM information */ |
631 | /*@{ */ | |
cd4f013f | 632 | struct mutex object_name_lock; |
673a394b | 633 | struct idr object_name_idr; |
b04a5906 | 634 | struct drm_vma_offset_manager *vma_offset_manager; |
673a394b | 635 | /*@} */ |
5bcf719b | 636 | int switch_power_state; |
84b1fd10 | 637 | }; |
1da177e4 | 638 | |
34a67dd7 DV |
639 | #include <drm/drm_irq.h> |
640 | ||
5bcf719b DA |
641 | #define DRM_SWITCH_POWER_ON 0 |
642 | #define DRM_SWITCH_POWER_OFF 1 | |
643 | #define DRM_SWITCH_POWER_CHANGING 2 | |
13bb9cc8 | 644 | #define DRM_SWITCH_POWER_DYNAMIC_OFF 3 |
5bcf719b | 645 | |
b5e89ed5 DA |
646 | static __inline__ int drm_core_check_feature(struct drm_device *dev, |
647 | int feature) | |
1da177e4 LT |
648 | { |
649 | return ((dev->driver->driver_features & feature) ? 1 : 0); | |
650 | } | |
651 | ||
2c07a21d DA |
652 | static inline void drm_device_set_unplugged(struct drm_device *dev) |
653 | { | |
654 | smp_wmb(); | |
655 | atomic_set(&dev->unplugged, 1); | |
656 | } | |
657 | ||
658 | static inline int drm_device_is_unplugged(struct drm_device *dev) | |
659 | { | |
660 | int ret = atomic_read(&dev->unplugged); | |
661 | smp_rmb(); | |
662 | return ret; | |
663 | } | |
664 | ||
43683057 | 665 | static inline bool drm_is_render_client(const struct drm_file *file_priv) |
1793126f DH |
666 | { |
667 | return file_priv->minor->type == DRM_MINOR_RENDER; | |
668 | } | |
669 | ||
ac05dbc5 TH |
670 | static inline bool drm_is_control_client(const struct drm_file *file_priv) |
671 | { | |
672 | return file_priv->minor->type == DRM_MINOR_CONTROL; | |
673 | } | |
674 | ||
43683057 TH |
675 | static inline bool drm_is_primary_client(const struct drm_file *file_priv) |
676 | { | |
a3ccc461 | 677 | return file_priv->minor->type == DRM_MINOR_PRIMARY; |
43683057 TH |
678 | } |
679 | ||
1da177e4 LT |
680 | /******************************************************************/ |
681 | /** \name Internal function definitions */ | |
682 | /*@{*/ | |
683 | ||
1da177e4 | 684 | /* Driver support (drm_drv.h) */ |
5101020c | 685 | extern int drm_ioctl_permit(u32 flags, struct drm_file *file_priv); |
ed8b6704 AB |
686 | extern long drm_ioctl(struct file *filp, |
687 | unsigned int cmd, unsigned long arg); | |
55edf41b | 688 | #ifdef CONFIG_COMPAT |
b5e89ed5 DA |
689 | extern long drm_compat_ioctl(struct file *filp, |
690 | unsigned int cmd, unsigned long arg); | |
55edf41b JN |
691 | #else |
692 | /* Let drm_compat_ioctl be assigned to .compat_ioctl unconditionally */ | |
693 | #define drm_compat_ioctl NULL | |
694 | #endif | |
4beb6d9f | 695 | extern bool drm_ioctl_flags(unsigned int nr, unsigned int *flags); |
1da177e4 | 696 | |
bcb877e4 DV |
697 | /* File Operations (drm_fops.c) */ |
698 | int drm_open(struct inode *inode, struct file *filp); | |
699 | ssize_t drm_read(struct file *filp, char __user *buffer, | |
700 | size_t count, loff_t *offset); | |
701 | int drm_release(struct inode *inode, struct file *filp); | |
bcb877e4 | 702 | unsigned int drm_poll(struct file *filp, struct poll_table_struct *wait); |
4020b220 DV |
703 | int drm_event_reserve_init_locked(struct drm_device *dev, |
704 | struct drm_file *file_priv, | |
705 | struct drm_pending_event *p, | |
706 | struct drm_event *e); | |
2dd500f1 DV |
707 | int drm_event_reserve_init(struct drm_device *dev, |
708 | struct drm_file *file_priv, | |
709 | struct drm_pending_event *p, | |
710 | struct drm_event *e); | |
711 | void drm_event_cancel_free(struct drm_device *dev, | |
712 | struct drm_pending_event *p); | |
fb740cf2 DV |
713 | void drm_send_event_locked(struct drm_device *dev, struct drm_pending_event *e); |
714 | void drm_send_event(struct drm_device *dev, struct drm_pending_event *e); | |
1da177e4 | 715 | |
78238757 DV |
716 | /* Misc. IOCTL support (drm_ioctl.c) */ |
717 | int drm_noop(struct drm_device *dev, void *data, | |
718 | struct drm_file *file_priv); | |
4b63539b DV |
719 | int drm_invalid_op(struct drm_device *dev, void *data, |
720 | struct drm_file *file_priv); | |
1da177e4 | 721 | |
673a394b EA |
722 | /* Cache management (drm_cache.c) */ |
723 | void drm_clflush_pages(struct page *pages[], unsigned long num_pages); | |
9da3da66 | 724 | void drm_clflush_sg(struct sg_table *st); |
c2d15359 | 725 | void drm_clflush_virt_range(void *addr, unsigned long length); |
673a394b | 726 | |
040ac320 TH |
727 | /* |
728 | * These are exported to drivers so that they can implement fencing using | |
729 | * DMA quiscent + idle. DMA quiescent usually requires the hardware lock. | |
730 | */ | |
731 | ||
955b12de BG |
732 | /* Debugfs support */ |
733 | #if defined(CONFIG_DEBUG_FS) | |
7d74795b LD |
734 | extern int drm_debugfs_create_files(const struct drm_info_list *files, |
735 | int count, struct dentry *root, | |
736 | struct drm_minor *minor); | |
737 | extern int drm_debugfs_remove_files(const struct drm_info_list *files, | |
738 | int count, struct drm_minor *minor); | |
66ee52e2 | 739 | #else |
66ee52e2 TR |
740 | static inline int drm_debugfs_create_files(const struct drm_info_list *files, |
741 | int count, struct dentry *root, | |
742 | struct drm_minor *minor) | |
743 | { | |
744 | return 0; | |
745 | } | |
746 | ||
747 | static inline int drm_debugfs_remove_files(const struct drm_info_list *files, | |
748 | int count, struct drm_minor *minor) | |
749 | { | |
750 | return 0; | |
751 | } | |
955b12de BG |
752 | #endif |
753 | ||
a4fce9cb CW |
754 | struct dma_buf_export_info; |
755 | ||
89177644 | 756 | extern struct dma_buf *drm_gem_prime_export(struct drm_device *dev, |
56a76c01 CW |
757 | struct drm_gem_object *obj, |
758 | int flags); | |
3248877e DA |
759 | extern int drm_gem_prime_handle_to_fd(struct drm_device *dev, |
760 | struct drm_file *file_priv, uint32_t handle, uint32_t flags, | |
761 | int *prime_fd); | |
89177644 AP |
762 | extern struct drm_gem_object *drm_gem_prime_import(struct drm_device *dev, |
763 | struct dma_buf *dma_buf); | |
3248877e DA |
764 | extern int drm_gem_prime_fd_to_handle(struct drm_device *dev, |
765 | struct drm_file *file_priv, int prime_fd, uint32_t *handle); | |
a4fce9cb CW |
766 | struct dma_buf *drm_gem_dmabuf_export(struct drm_device *dev, |
767 | struct dma_buf_export_info *exp_info); | |
c1d6798d | 768 | extern void drm_gem_dmabuf_release(struct dma_buf *dma_buf); |
3248877e | 769 | |
51ab7ba2 DA |
770 | extern int drm_prime_sg_to_page_addr_arrays(struct sg_table *sgt, struct page **pages, |
771 | dma_addr_t *addrs, int max_pages); | |
34eab43e | 772 | extern struct sg_table *drm_prime_pages_to_sg(struct page **pages, unsigned int nr_pages); |
3248877e DA |
773 | extern void drm_prime_gem_destroy(struct drm_gem_object *obj, struct sg_table *sg); |
774 | ||
1da177e4 | 775 | |
ba8286fa DV |
776 | extern struct drm_dma_handle *drm_pci_alloc(struct drm_device *dev, size_t size, |
777 | size_t align); | |
778 | extern void drm_pci_free(struct drm_device *dev, struct drm_dma_handle * dmah); | |
1da177e4 LT |
779 | |
780 | /* sysfs support (drm_sysfs.c) */ | |
f453ba04 | 781 | extern void drm_sysfs_hotplug_event(struct drm_device *dev); |
1da177e4 | 782 | |
673a394b | 783 | |
8410ea3b DA |
784 | /*@}*/ |
785 | ||
786 | /* PCI section */ | |
787 | static __inline__ int drm_pci_device_is_agp(struct drm_device *dev) | |
788 | { | |
b5e89ed5 DA |
789 | if (dev->driver->device_is_agp != NULL) { |
790 | int err = (*dev->driver->device_is_agp) (dev); | |
791 | ||
cda17380 DA |
792 | if (err != 2) { |
793 | return err; | |
794 | } | |
795 | } | |
796 | ||
797 | return pci_find_capability(dev->pdev, PCI_CAP_ID_AGP); | |
798 | } | |
4efafebe | 799 | void drm_pci_agp_destroy(struct drm_device *dev); |
cda17380 | 800 | |
8410ea3b DA |
801 | extern int drm_pci_init(struct drm_driver *driver, struct pci_driver *pdriver); |
802 | extern void drm_pci_exit(struct drm_driver *driver, struct pci_driver *pdriver); | |
a9e3c90c | 803 | #ifdef CONFIG_PCI |
8410ea3b | 804 | extern int drm_get_pci_dev(struct pci_dev *pdev, |
dcdb1674 JC |
805 | const struct pci_device_id *ent, |
806 | struct drm_driver *driver); | |
915b4d11 | 807 | extern int drm_pci_set_busid(struct drm_device *dev, struct drm_master *master); |
a9e3c90c TR |
808 | #else |
809 | static inline int drm_get_pci_dev(struct pci_dev *pdev, | |
810 | const struct pci_device_id *ent, | |
811 | struct drm_driver *driver) | |
812 | { | |
813 | return -ENOSYS; | |
814 | } | |
815 | ||
816 | static inline int drm_pci_set_busid(struct drm_device *dev, | |
817 | struct drm_master *master) | |
818 | { | |
819 | return -ENOSYS; | |
820 | } | |
821 | #endif | |
8410ea3b | 822 | |
f4297784 DA |
823 | #define DRM_PCIE_SPEED_25 1 |
824 | #define DRM_PCIE_SPEED_50 2 | |
825 | #define DRM_PCIE_SPEED_80 4 | |
826 | ||
827 | extern int drm_pcie_get_speed_cap_mask(struct drm_device *dev, u32 *speed_mask); | |
60d8edd4 | 828 | extern int drm_pcie_get_max_link_width(struct drm_device *dev, u32 *mlw); |
8410ea3b DA |
829 | |
830 | /* platform section */ | |
831 | extern int drm_platform_init(struct drm_driver *driver, struct platform_device *platform_device); | |
8410ea3b | 832 | |
cc1f7194 DA |
833 | /* returns true if currently okay to sleep */ |
834 | static __inline__ bool drm_can_sleep(void) | |
835 | { | |
836 | if (in_atomic() || in_dbg_master() || irqs_disabled()) | |
837 | return false; | |
838 | return true; | |
839 | } | |
840 | ||
373701b1 JN |
841 | /* helper for handling conditionals in various for_each macros */ |
842 | #define for_each_if(condition) if (!(condition)) {} else | |
843 | ||
1da177e4 | 844 | #endif |