xref: /linux-6.15/drivers/gpu/drm/drm_internal.h (revision b5d7cb76)
1 /*
2  * Copyright © 2014 Intel Corporation
3  *   Daniel Vetter <[email protected]>
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 cea_sad;
39 struct dentry;
40 struct dma_buf;
41 struct iosys_map;
42 struct drm_connector;
43 struct drm_crtc;
44 struct drm_framebuffer;
45 struct drm_gem_object;
46 struct drm_master;
47 struct drm_minor;
48 struct drm_prime_file_private;
49 struct drm_printer;
50 struct drm_vblank_crtc;
51 
52 /* drm_file.c */
53 extern struct mutex drm_global_mutex;
54 bool drm_dev_needs_global_mutex(struct drm_device *dev);
55 struct drm_file *drm_file_alloc(struct drm_minor *minor);
56 void drm_file_free(struct drm_file *file);
57 void drm_lastclose(struct drm_device *dev);
58 
59 #ifdef CONFIG_PCI
60 
61 /* drm_pci.c */
62 int drm_pci_set_busid(struct drm_device *dev, struct drm_master *master);
63 
64 #else
65 
66 static inline int drm_pci_set_busid(struct drm_device *dev,
67 				    struct drm_master *master)
68 {
69 	return -EINVAL;
70 }
71 
72 #endif
73 
74 /* drm_prime.c */
75 int drm_prime_handle_to_fd_ioctl(struct drm_device *dev, void *data,
76 				 struct drm_file *file_priv);
77 int drm_prime_fd_to_handle_ioctl(struct drm_device *dev, void *data,
78 				 struct drm_file *file_priv);
79 
80 void drm_prime_init_file_private(struct drm_prime_file_private *prime_fpriv);
81 void drm_prime_destroy_file_private(struct drm_prime_file_private *prime_fpriv);
82 void drm_prime_remove_buf_handle(struct drm_prime_file_private *prime_fpriv,
83 				 uint32_t handle);
84 
85 /* drm_drv.c */
86 struct drm_minor *drm_minor_acquire(unsigned int minor_id);
87 void drm_minor_release(struct drm_minor *minor);
88 
89 /* drm_managed.c */
90 void drm_managed_release(struct drm_device *dev);
91 void drmm_add_final_kfree(struct drm_device *dev, void *container);
92 
93 /* drm_vblank.c */
94 static inline bool drm_vblank_passed(u64 seq, u64 ref)
95 {
96 	return (seq - ref) <= (1 << 23);
97 }
98 
99 void drm_vblank_disable_and_save(struct drm_device *dev, unsigned int pipe);
100 int drm_vblank_get(struct drm_device *dev, unsigned int pipe);
101 void drm_vblank_put(struct drm_device *dev, unsigned int pipe);
102 u64 drm_vblank_count(struct drm_device *dev, unsigned int pipe);
103 
104 /* drm_vblank_work.c */
105 static inline void drm_vblank_flush_worker(struct drm_vblank_crtc *vblank)
106 {
107 	kthread_flush_worker(vblank->worker);
108 }
109 
110 static inline void drm_vblank_destroy_worker(struct drm_vblank_crtc *vblank)
111 {
112 	if (vblank->worker)
113 		kthread_destroy_worker(vblank->worker);
114 }
115 
116 int drm_vblank_worker_init(struct drm_vblank_crtc *vblank);
117 void drm_vblank_cancel_pending_works(struct drm_vblank_crtc *vblank);
118 void drm_handle_vblank_works(struct drm_vblank_crtc *vblank);
119 
120 /* IOCTLS */
121 int drm_wait_vblank_ioctl(struct drm_device *dev, void *data,
122 			  struct drm_file *filp);
123 
124 /* drm_irq.c */
125 
126 /* IOCTLS */
127 int drm_crtc_get_sequence_ioctl(struct drm_device *dev, void *data,
128 				struct drm_file *filp);
129 
130 int drm_crtc_queue_sequence_ioctl(struct drm_device *dev, void *data,
131 				  struct drm_file *filp);
132 
133 /* drm_auth.c */
134 int drm_getmagic(struct drm_device *dev, void *data,
135 		 struct drm_file *file_priv);
136 int drm_authmagic(struct drm_device *dev, void *data,
137 		  struct drm_file *file_priv);
138 int drm_setmaster_ioctl(struct drm_device *dev, void *data,
139 			struct drm_file *file_priv);
140 int drm_dropmaster_ioctl(struct drm_device *dev, void *data,
141 			 struct drm_file *file_priv);
142 int drm_master_open(struct drm_file *file_priv);
143 void drm_master_release(struct drm_file *file_priv);
144 bool drm_master_internal_acquire(struct drm_device *dev);
145 void drm_master_internal_release(struct drm_device *dev);
146 
147 /* drm_sysfs.c */
148 extern struct class *drm_class;
149 
150 int drm_sysfs_init(void);
151 void drm_sysfs_destroy(void);
152 struct device *drm_sysfs_minor_alloc(struct drm_minor *minor);
153 int drm_sysfs_connector_add(struct drm_connector *connector);
154 int drm_sysfs_connector_add_late(struct drm_connector *connector);
155 void drm_sysfs_connector_remove_early(struct drm_connector *connector);
156 void drm_sysfs_connector_remove(struct drm_connector *connector);
157 
158 void drm_sysfs_lease_event(struct drm_device *dev);
159 
160 /* drm_gem.c */
161 int drm_gem_init(struct drm_device *dev);
162 int drm_gem_handle_create_tail(struct drm_file *file_priv,
163 			       struct drm_gem_object *obj,
164 			       u32 *handlep);
165 int drm_gem_close_ioctl(struct drm_device *dev, void *data,
166 			struct drm_file *file_priv);
167 int drm_gem_flink_ioctl(struct drm_device *dev, void *data,
168 			struct drm_file *file_priv);
169 int drm_gem_open_ioctl(struct drm_device *dev, void *data,
170 		       struct drm_file *file_priv);
171 void drm_gem_open(struct drm_device *dev, struct drm_file *file_private);
172 void drm_gem_release(struct drm_device *dev, struct drm_file *file_private);
173 void drm_gem_print_info(struct drm_printer *p, unsigned int indent,
174 			const struct drm_gem_object *obj);
175 
176 int drm_gem_pin(struct drm_gem_object *obj);
177 void drm_gem_unpin(struct drm_gem_object *obj);
178 int drm_gem_vmap(struct drm_gem_object *obj, struct iosys_map *map);
179 void drm_gem_vunmap(struct drm_gem_object *obj, struct iosys_map *map);
180 
181 /* drm_debugfs.c drm_debugfs_crc.c */
182 #if defined(CONFIG_DEBUG_FS)
183 void drm_debugfs_dev_fini(struct drm_device *dev);
184 void drm_debugfs_dev_register(struct drm_device *dev);
185 int drm_debugfs_register(struct drm_minor *minor, int minor_id,
186 			 struct dentry *root);
187 void drm_debugfs_unregister(struct drm_minor *minor);
188 void drm_debugfs_connector_add(struct drm_connector *connector);
189 void drm_debugfs_connector_remove(struct drm_connector *connector);
190 void drm_debugfs_crtc_add(struct drm_crtc *crtc);
191 void drm_debugfs_crtc_remove(struct drm_crtc *crtc);
192 void drm_debugfs_crtc_crc_add(struct drm_crtc *crtc);
193 void drm_debugfs_encoder_add(struct drm_encoder *encoder);
194 void drm_debugfs_encoder_remove(struct drm_encoder *encoder);
195 #else
196 static inline void drm_debugfs_dev_fini(struct drm_device *dev)
197 {
198 }
199 
200 static inline void drm_debugfs_dev_register(struct drm_device *dev)
201 {
202 }
203 
204 static inline int drm_debugfs_register(struct drm_minor *minor, int minor_id,
205 				       struct dentry *root)
206 {
207 	return 0;
208 }
209 
210 static inline void drm_debugfs_unregister(struct drm_minor *minor)
211 {
212 }
213 
214 static inline void drm_debugfs_connector_add(struct drm_connector *connector)
215 {
216 }
217 static inline void drm_debugfs_connector_remove(struct drm_connector *connector)
218 {
219 }
220 
221 static inline void drm_debugfs_crtc_add(struct drm_crtc *crtc)
222 {
223 }
224 static inline void drm_debugfs_crtc_remove(struct drm_crtc *crtc)
225 {
226 }
227 
228 static inline void drm_debugfs_crtc_crc_add(struct drm_crtc *crtc)
229 {
230 }
231 
232 static inline void drm_debugfs_encoder_add(struct drm_encoder *encoder)
233 {
234 }
235 
236 static inline void drm_debugfs_encoder_remove(struct drm_encoder *encoder)
237 {
238 }
239 
240 #endif
241 
242 drm_ioctl_t drm_version;
243 drm_ioctl_t drm_getunique;
244 drm_ioctl_t drm_getclient;
245 
246 /* drm_syncobj.c */
247 void drm_syncobj_open(struct drm_file *file_private);
248 void drm_syncobj_release(struct drm_file *file_private);
249 int drm_syncobj_create_ioctl(struct drm_device *dev, void *data,
250 			     struct drm_file *file_private);
251 int drm_syncobj_destroy_ioctl(struct drm_device *dev, void *data,
252 			      struct drm_file *file_private);
253 int drm_syncobj_handle_to_fd_ioctl(struct drm_device *dev, void *data,
254 				   struct drm_file *file_private);
255 int drm_syncobj_fd_to_handle_ioctl(struct drm_device *dev, void *data,
256 				   struct drm_file *file_private);
257 int drm_syncobj_transfer_ioctl(struct drm_device *dev, void *data,
258 			       struct drm_file *file_private);
259 int drm_syncobj_wait_ioctl(struct drm_device *dev, void *data,
260 			   struct drm_file *file_private);
261 int drm_syncobj_timeline_wait_ioctl(struct drm_device *dev, void *data,
262 				    struct drm_file *file_private);
263 int drm_syncobj_eventfd_ioctl(struct drm_device *dev, void *data,
264 			      struct drm_file *file_private);
265 int drm_syncobj_reset_ioctl(struct drm_device *dev, void *data,
266 			    struct drm_file *file_private);
267 int drm_syncobj_signal_ioctl(struct drm_device *dev, void *data,
268 			     struct drm_file *file_private);
269 int drm_syncobj_timeline_signal_ioctl(struct drm_device *dev, void *data,
270 				      struct drm_file *file_private);
271 int drm_syncobj_query_ioctl(struct drm_device *dev, void *data,
272 			    struct drm_file *file_private);
273 
274 /* drm_framebuffer.c */
275 void drm_framebuffer_print_info(struct drm_printer *p, unsigned int indent,
276 				const struct drm_framebuffer *fb);
277 void drm_framebuffer_debugfs_init(struct drm_device *dev);
278 
279 /* drm_edid.c */
280 void drm_edid_cta_sad_get(const struct cea_sad *cta_sad, u8 *sad);
281 void drm_edid_cta_sad_set(struct cea_sad *cta_sad, const u8 *sad);
282 
283 #endif /* __DRM_INTERNAL_H__ */
284