]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - include/drm/drmP.h
crypto: ahash - Fix EINPROGRESS notification callback
[mirror_ubuntu-zesty-kernel.git] / include / drm / drmP.h
CommitLineData
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
81struct module;
82
c153f45f
EA
83struct drm_file;
84struct drm_device;
cc5ea594 85struct drm_agp_head;
ba8286fa
DV
86struct drm_local_map;
87struct drm_device_dma;
88struct drm_dma_handle;
d9fc9413 89struct drm_gem_object;
3b96a0b1 90struct drm_master;
34a67dd7 91struct drm_vblank_crtc;
c153f45f 92
edb37a95 93struct device_node;
ebc64e45 94struct videomode;
3aac4502 95struct reservation_object;
b5e9c1a2 96struct 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
324typedef int drm_ioctl_t(struct drm_device *dev, void *data,
325 struct drm_file *file_priv);
1da177e4 326
9a186645
DA
327typedef 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
340struct 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 */
361struct 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 373struct 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 380struct 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 439struct 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 461enum 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 */
472struct 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 */
482struct 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
492struct 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 508struct 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
646static __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
652static inline void drm_device_set_unplugged(struct drm_device *dev)
653{
654 smp_wmb();
655 atomic_set(&dev->unplugged, 1);
656}
657
658static 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 665static 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
670static 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
675static 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 685extern int drm_ioctl_permit(u32 flags, struct drm_file *file_priv);
ed8b6704
AB
686extern long drm_ioctl(struct file *filp,
687 unsigned int cmd, unsigned long arg);
55edf41b 688#ifdef CONFIG_COMPAT
b5e89ed5
DA
689extern 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 695extern bool drm_ioctl_flags(unsigned int nr, unsigned int *flags);
1da177e4 696
bcb877e4
DV
697/* File Operations (drm_fops.c) */
698int drm_open(struct inode *inode, struct file *filp);
699ssize_t drm_read(struct file *filp, char __user *buffer,
700 size_t count, loff_t *offset);
701int drm_release(struct inode *inode, struct file *filp);
bcb877e4 702unsigned int drm_poll(struct file *filp, struct poll_table_struct *wait);
4020b220
DV
703int 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
707int 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);
711void drm_event_cancel_free(struct drm_device *dev,
712 struct drm_pending_event *p);
fb740cf2
DV
713void drm_send_event_locked(struct drm_device *dev, struct drm_pending_event *e);
714void drm_send_event(struct drm_device *dev, struct drm_pending_event *e);
1da177e4 715
78238757
DV
716/* Misc. IOCTL support (drm_ioctl.c) */
717int drm_noop(struct drm_device *dev, void *data,
718 struct drm_file *file_priv);
4b63539b
DV
719int 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) */
723void drm_clflush_pages(struct page *pages[], unsigned long num_pages);
9da3da66 724void drm_clflush_sg(struct sg_table *st);
c2d15359 725void 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
734extern int drm_debugfs_create_files(const struct drm_info_list *files,
735 int count, struct dentry *root,
736 struct drm_minor *minor);
737extern int drm_debugfs_remove_files(const struct drm_info_list *files,
738 int count, struct drm_minor *minor);
66ee52e2 739#else
66ee52e2
TR
740static 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
747static 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
754struct dma_buf_export_info;
755
89177644 756extern struct dma_buf *drm_gem_prime_export(struct drm_device *dev,
56a76c01
CW
757 struct drm_gem_object *obj,
758 int flags);
3248877e
DA
759extern 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
762extern struct drm_gem_object *drm_gem_prime_import(struct drm_device *dev,
763 struct dma_buf *dma_buf);
3248877e
DA
764extern 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
766struct dma_buf *drm_gem_dmabuf_export(struct drm_device *dev,
767 struct dma_buf_export_info *exp_info);
c1d6798d 768extern void drm_gem_dmabuf_release(struct dma_buf *dma_buf);
3248877e 769
51ab7ba2
DA
770extern int drm_prime_sg_to_page_addr_arrays(struct sg_table *sgt, struct page **pages,
771 dma_addr_t *addrs, int max_pages);
34eab43e 772extern struct sg_table *drm_prime_pages_to_sg(struct page **pages, unsigned int nr_pages);
3248877e
DA
773extern void drm_prime_gem_destroy(struct drm_gem_object *obj, struct sg_table *sg);
774
1da177e4 775
ba8286fa
DV
776extern struct drm_dma_handle *drm_pci_alloc(struct drm_device *dev, size_t size,
777 size_t align);
778extern void drm_pci_free(struct drm_device *dev, struct drm_dma_handle * dmah);
1da177e4
LT
779
780 /* sysfs support (drm_sysfs.c) */
f453ba04 781extern void drm_sysfs_hotplug_event(struct drm_device *dev);
1da177e4 782
673a394b 783
8410ea3b
DA
784/*@}*/
785
786/* PCI section */
787static __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 799void drm_pci_agp_destroy(struct drm_device *dev);
cda17380 800
8410ea3b
DA
801extern int drm_pci_init(struct drm_driver *driver, struct pci_driver *pdriver);
802extern void drm_pci_exit(struct drm_driver *driver, struct pci_driver *pdriver);
a9e3c90c 803#ifdef CONFIG_PCI
8410ea3b 804extern int drm_get_pci_dev(struct pci_dev *pdev,
dcdb1674
JC
805 const struct pci_device_id *ent,
806 struct drm_driver *driver);
915b4d11 807extern int drm_pci_set_busid(struct drm_device *dev, struct drm_master *master);
a9e3c90c
TR
808#else
809static 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
816static 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
827extern int drm_pcie_get_speed_cap_mask(struct drm_device *dev, u32 *speed_mask);
60d8edd4 828extern int drm_pcie_get_max_link_width(struct drm_device *dev, u32 *mlw);
8410ea3b
DA
829
830/* platform section */
831extern 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 */
834static __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