1 /*
2  * Copyright © 2014 Intel Corporation
3  *   Daniel Vetter <daniel.vetter@ffwll.ch>
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be included in
13  * all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21  * OTHER DEALINGS IN THE SOFTWARE.
22  */
23 
24 #ifndef __DRM_INTERNAL_H__
25 #define __DRM_INTERNAL_H__
26 
27 #include <linux/kthread.h>
28 #include <linux/types.h>
29 
30 #include <drm/drm_ioctl.h>
31 #include <drm/drm_vblank.h>
32 
33 #define DRM_IF_MAJOR 1
34 #define DRM_IF_MINOR 4
35 
36 #define DRM_IF_VERSION(maj, min) (maj << 16 | min)
37 
38 struct dentry;
39 struct dma_buf;
40 struct iosys_map;
41 struct drm_connector;
42 struct drm_crtc;
43 struct drm_framebuffer;
44 struct drm_gem_object;
45 struct drm_master;
46 struct drm_minor;
47 struct drm_prime_file_private;
48 struct drm_printer;
49 struct drm_vblank_crtc;
50 
51 /* drm_file.c */
52 extern struct rwlock drm_global_mutex;
53 bool drm_dev_needs_global_mutex(struct drm_device *dev);
54 struct drm_file *drm_file_alloc(struct drm_minor *minor);
55 void drm_file_free(struct drm_file *file);
56 
57 #ifdef CONFIG_PCI
58 
59 /* drm_pci.c */
60 int drm_pci_set_busid(struct drm_device *dev, struct drm_master *master);
61 
62 #else
63 
drm_pci_set_busid(struct drm_device * dev,struct drm_master * master)64 static inline int drm_pci_set_busid(struct drm_device *dev,
65 				    struct drm_master *master)
66 {
67 	return -EINVAL;
68 }
69 
70 #endif
71 
72 /* drm_prime.c */
73 int drm_prime_handle_to_fd_ioctl(struct drm_device *dev, void *data,
74 				 struct drm_file *file_priv);
75 int drm_prime_fd_to_handle_ioctl(struct drm_device *dev, void *data,
76 				 struct drm_file *file_priv);
77 
78 void drm_prime_init_file_private(struct drm_prime_file_private *prime_fpriv);
79 void drm_prime_destroy_file_private(struct drm_prime_file_private *prime_fpriv);
80 void drm_prime_remove_buf_handle(struct drm_prime_file_private *prime_fpriv,
81 				 uint32_t handle);
82 
83 /* drm_managed.c */
84 void drm_managed_release(struct drm_device *dev);
85 void drmm_add_final_kfree(struct drm_device *dev, void *container);
86 
87 /* drm_vblank.c */
drm_vblank_passed(u64 seq,u64 ref)88 static inline bool drm_vblank_passed(u64 seq, u64 ref)
89 {
90 	return (seq - ref) <= (1 << 23);
91 }
92 
93 void drm_vblank_disable_and_save(struct drm_device *dev, unsigned int pipe);
94 int drm_vblank_get(struct drm_device *dev, unsigned int pipe);
95 void drm_vblank_put(struct drm_device *dev, unsigned int pipe);
96 u64 drm_vblank_count(struct drm_device *dev, unsigned int pipe);
97 
98 /* drm_vblank_work.c */
drm_vblank_flush_worker(struct drm_vblank_crtc * vblank)99 static inline void drm_vblank_flush_worker(struct drm_vblank_crtc *vblank)
100 {
101 	kthread_flush_worker(vblank->worker);
102 }
103 
drm_vblank_destroy_worker(struct drm_vblank_crtc * vblank)104 static inline void drm_vblank_destroy_worker(struct drm_vblank_crtc *vblank)
105 {
106 	if (vblank->worker)
107 		kthread_destroy_worker(vblank->worker);
108 }
109 
110 int drm_vblank_worker_init(struct drm_vblank_crtc *vblank);
111 void drm_vblank_cancel_pending_works(struct drm_vblank_crtc *vblank);
112 void drm_handle_vblank_works(struct drm_vblank_crtc *vblank);
113 
114 /* IOCTLS */
115 int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
116 			  struct drm_file *filp);
117 
118 /* drm_irq.c */
119 
120 /* IOCTLS */
121 int drm_crtc_get_sequence_ioctl(struct drm_device *dev, void *data,
122 				struct drm_file *filp);
123 
124 int drm_crtc_queue_sequence_ioctl(struct drm_device *dev, void *data,
125 				  struct drm_file *filp);
126 
127 /* drm_auth.c */
128 int drm_getmagic(struct drm_device *dev, void *data,
129 		 struct drm_file *file_priv);
130 int drm_authmagic(struct drm_device *dev, void *data,
131 		  struct drm_file *file_priv);
132 int drm_setmaster_ioctl(struct drm_device *dev, void *data,
133 			struct drm_file *file_priv);
134 int drm_dropmaster_ioctl(struct drm_device *dev, void *data,
135 			 struct drm_file *file_priv);
136 int drm_master_open(struct drm_file *file_priv);
137 void drm_master_release(struct drm_file *file_priv);
138 bool drm_master_internal_acquire(struct drm_device *dev);
139 void drm_master_internal_release(struct drm_device *dev);
140 
141 /* drm_sysfs.c */
142 #ifdef __linux__
143 extern struct class *drm_class;
144 
145 int drm_sysfs_init(void);
146 void drm_sysfs_destroy(void);
147 struct device *drm_sysfs_minor_alloc(struct drm_minor *minor);
148 int drm_sysfs_connector_add(struct drm_connector *connector);
149 int drm_sysfs_connector_add_late(struct drm_connector *connector);
150 void drm_sysfs_connector_remove_early(struct drm_connector *connector);
151 void drm_sysfs_connector_remove(struct drm_connector *connector);
152 
153 void drm_sysfs_lease_event(struct drm_device *dev);
154 #else
155 static inline struct device *
drm_sysfs_minor_alloc(struct drm_minor * minor)156 drm_sysfs_minor_alloc(struct drm_minor *minor)
157 {
158 	return ERR_PTR(-ENOSYS);
159 }
160 
161 static inline int
drm_sysfs_connector_add(struct drm_connector * connector)162 drm_sysfs_connector_add(struct drm_connector *connector)
163 {
164 	return 0;
165 }
166 
167 static inline void
drm_sysfs_connector_remove(struct drm_connector * connector)168 drm_sysfs_connector_remove(struct drm_connector *connector)
169 {
170 }
171 
172 static inline int
drm_sysfs_connector_add_late(struct drm_connector * connector)173 drm_sysfs_connector_add_late(struct drm_connector *connector)
174 {
175 	return 0;
176 }
177 
178 static inline void
drm_sysfs_connector_remove_early(struct drm_connector * connector)179 drm_sysfs_connector_remove_early(struct drm_connector *connector)
180 {
181 }
182 #endif
183 
184 /* drm_gem.c */
185 int drm_gem_init(struct drm_device *dev);
186 int drm_gem_handle_create_tail(struct drm_file *file_priv,
187 			       struct drm_gem_object *obj,
188 			       u32 *handlep);
189 int drm_gem_close_ioctl(struct drm_device *dev, void *data,
190 			struct drm_file *file_priv);
191 int drm_gem_flink_ioctl(struct drm_device *dev, void *data,
192 			struct drm_file *file_priv);
193 int drm_gem_open_ioctl(struct drm_device *dev, void *data,
194 		       struct drm_file *file_priv);
195 void drm_gem_open(struct drm_device *dev, struct drm_file *file_private);
196 void drm_gem_release(struct drm_device *dev, struct drm_file *file_private);
197 void drm_gem_print_info(struct drm_printer *p, unsigned int indent,
198 			const struct drm_gem_object *obj);
199 
200 int drm_gem_pin_locked(struct drm_gem_object *obj);
201 void drm_gem_unpin_locked(struct drm_gem_object *obj);
202 int drm_gem_pin(struct drm_gem_object *obj);
203 void drm_gem_unpin(struct drm_gem_object *obj);
204 int drm_gem_vmap(struct drm_gem_object *obj, struct iosys_map *map);
205 void drm_gem_vunmap(struct drm_gem_object *obj, struct iosys_map *map);
206 
207 /* drm_debugfs.c drm_debugfs_crc.c */
208 #if defined(CONFIG_DEBUG_FS)
209 void drm_debugfs_dev_fini(struct drm_device *dev);
210 void drm_debugfs_dev_register(struct drm_device *dev);
211 int drm_debugfs_register(struct drm_minor *minor, int minor_id,
212 			 struct dentry *root);
213 void drm_debugfs_unregister(struct drm_minor *minor);
214 void drm_debugfs_connector_add(struct drm_connector *connector);
215 void drm_debugfs_connector_remove(struct drm_connector *connector);
216 void drm_debugfs_crtc_add(struct drm_crtc *crtc);
217 void drm_debugfs_crtc_remove(struct drm_crtc *crtc);
218 void drm_debugfs_crtc_crc_add(struct drm_crtc *crtc);
219 void drm_debugfs_encoder_add(struct drm_encoder *encoder);
220 void drm_debugfs_encoder_remove(struct drm_encoder *encoder);
221 #else
drm_debugfs_dev_fini(struct drm_device * dev)222 static inline void drm_debugfs_dev_fini(struct drm_device *dev)
223 {
224 }
225 
drm_debugfs_dev_register(struct drm_device * dev)226 static inline void drm_debugfs_dev_register(struct drm_device *dev)
227 {
228 }
229 
drm_debugfs_register(struct drm_minor * minor,int minor_id,struct dentry * root)230 static inline int drm_debugfs_register(struct drm_minor *minor, int minor_id,
231 				       struct dentry *root)
232 {
233 	return 0;
234 }
235 
drm_debugfs_unregister(struct drm_minor * minor)236 static inline void drm_debugfs_unregister(struct drm_minor *minor)
237 {
238 }
239 
drm_debugfs_connector_add(struct drm_connector * connector)240 static inline void drm_debugfs_connector_add(struct drm_connector *connector)
241 {
242 }
drm_debugfs_connector_remove(struct drm_connector * connector)243 static inline void drm_debugfs_connector_remove(struct drm_connector *connector)
244 {
245 }
246 
drm_debugfs_crtc_add(struct drm_crtc * crtc)247 static inline void drm_debugfs_crtc_add(struct drm_crtc *crtc)
248 {
249 }
drm_debugfs_crtc_remove(struct drm_crtc * crtc)250 static inline void drm_debugfs_crtc_remove(struct drm_crtc *crtc)
251 {
252 }
253 
drm_debugfs_crtc_crc_add(struct drm_crtc * crtc)254 static inline void drm_debugfs_crtc_crc_add(struct drm_crtc *crtc)
255 {
256 }
257 
drm_debugfs_encoder_add(struct drm_encoder * encoder)258 static inline void drm_debugfs_encoder_add(struct drm_encoder *encoder)
259 {
260 }
261 
drm_debugfs_encoder_remove(struct drm_encoder * encoder)262 static inline void drm_debugfs_encoder_remove(struct drm_encoder *encoder)
263 {
264 }
265 
266 #endif
267 
268 drm_ioctl_t drm_version;
269 drm_ioctl_t drm_getunique;
270 drm_ioctl_t drm_getclient;
271 
272 /* drm_syncobj.c */
273 void drm_syncobj_open(struct drm_file *file_private);
274 void drm_syncobj_release(struct drm_file *file_private);
275 int drm_syncobj_create_ioctl(struct drm_device *dev, void *data,
276 			     struct drm_file *file_private);
277 int drm_syncobj_destroy_ioctl(struct drm_device *dev, void *data,
278 			      struct drm_file *file_private);
279 int drm_syncobj_handle_to_fd_ioctl(struct drm_device *dev, void *data,
280 				   struct drm_file *file_private);
281 int drm_syncobj_fd_to_handle_ioctl(struct drm_device *dev, void *data,
282 				   struct drm_file *file_private);
283 int drm_syncobj_transfer_ioctl(struct drm_device *dev, void *data,
284 			       struct drm_file *file_private);
285 int drm_syncobj_wait_ioctl(struct drm_device *dev, void *data,
286 			   struct drm_file *file_private);
287 int drm_syncobj_timeline_wait_ioctl(struct drm_device *dev, void *data,
288 				    struct drm_file *file_private);
289 int drm_syncobj_eventfd_ioctl(struct drm_device *dev, void *data,
290 			      struct drm_file *file_private);
291 int drm_syncobj_reset_ioctl(struct drm_device *dev, void *data,
292 			    struct drm_file *file_private);
293 int drm_syncobj_signal_ioctl(struct drm_device *dev, void *data,
294 			     struct drm_file *file_private);
295 int drm_syncobj_timeline_signal_ioctl(struct drm_device *dev, void *data,
296 				      struct drm_file *file_private);
297 int drm_syncobj_query_ioctl(struct drm_device *dev, void *data,
298 			    struct drm_file *file_private);
299 
300 /* drm_framebuffer.c */
301 void drm_framebuffer_print_info(struct drm_printer *p, unsigned int indent,
302 				const struct drm_framebuffer *fb);
303 void drm_framebuffer_debugfs_init(struct drm_device *dev);
304 
305 #endif /* __DRM_INTERNAL_H__ */
306