1 /* $NetBSD: drm_legacy.h,v 1.3 2021/12/18 23:44:57 riastradh Exp $ */
2
3 #ifndef __DRM_LEGACY_H__
4 #define __DRM_LEGACY_H__
5
6 /*
7 * Copyright (c) 2014 David Herrmann <dh.herrmann@gmail.com>
8 *
9 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
15 *
16 * The above copyright notice and this permission notice shall be included in
17 * all copies or substantial portions of the Software.
18 *
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
23 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
24 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25 * OTHER DEALINGS IN THE SOFTWARE.
26 */
27
28 /*
29 * This file contains legacy interfaces that modern drm drivers
30 * should no longer be using. They cannot be removed as legacy
31 * drivers use them, and removing them are API breaks.
32 */
33 #include <linux/list.h>
34
35 #include <drm/drm.h>
36 #include <drm/drm_device.h>
37 #include <drm/drm_legacy.h>
38
39 struct agp_memory;
40 struct drm_device;
41 struct drm_file;
42 struct drm_buf_desc;
43
44 /*
45 * Generic DRM Contexts
46 */
47
48 #define DRM_KERNEL_CONTEXT 0
49 #define DRM_RESERVED_CONTEXTS 1
50
51 #if IS_ENABLED(CONFIG_DRM_LEGACY)
52 void drm_legacy_ctxbitmap_init(struct drm_device *dev);
53 void drm_legacy_ctxbitmap_cleanup(struct drm_device *dev);
54 void drm_legacy_ctxbitmap_flush(struct drm_device *dev, struct drm_file *file);
55 #else
drm_legacy_ctxbitmap_init(struct drm_device * dev)56 static inline void drm_legacy_ctxbitmap_init(struct drm_device *dev) {}
drm_legacy_ctxbitmap_cleanup(struct drm_device * dev)57 static inline void drm_legacy_ctxbitmap_cleanup(struct drm_device *dev) {}
drm_legacy_ctxbitmap_flush(struct drm_device * dev,struct drm_file * file)58 static inline void drm_legacy_ctxbitmap_flush(struct drm_device *dev, struct drm_file *file) {}
59 #endif
60
61 void drm_legacy_ctxbitmap_free(struct drm_device *dev, int ctx_handle);
62
63 #if IS_ENABLED(CONFIG_DRM_LEGACY)
64 int drm_legacy_resctx(struct drm_device *d, void *v, struct drm_file *f);
65 int drm_legacy_addctx(struct drm_device *d, void *v, struct drm_file *f);
66 int drm_legacy_getctx(struct drm_device *d, void *v, struct drm_file *f);
67 int drm_legacy_switchctx(struct drm_device *d, void *v, struct drm_file *f);
68 int drm_legacy_newctx(struct drm_device *d, void *v, struct drm_file *f);
69 int drm_legacy_rmctx(struct drm_device *d, void *v, struct drm_file *f);
70
71 int drm_legacy_setsareactx(struct drm_device *d, void *v, struct drm_file *f);
72 int drm_legacy_getsareactx(struct drm_device *d, void *v, struct drm_file *f);
73 #endif
74
75 /*
76 * Generic Buffer Management
77 */
78
79 #define DRM_MAP_HASH_OFFSET 0x10000000
80
81 #if IS_ENABLED(CONFIG_DRM_LEGACY)
drm_legacy_create_map_hash(struct drm_device * dev)82 static inline int drm_legacy_create_map_hash(struct drm_device *dev)
83 {
84 return drm_ht_create(&dev->map_hash, 12);
85 }
86
drm_legacy_remove_map_hash(struct drm_device * dev)87 static inline void drm_legacy_remove_map_hash(struct drm_device *dev)
88 {
89 drm_ht_remove(&dev->map_hash);
90 }
91 #else
drm_legacy_create_map_hash(struct drm_device * dev)92 static inline int drm_legacy_create_map_hash(struct drm_device *dev)
93 {
94 return 0;
95 }
96
drm_legacy_remove_map_hash(struct drm_device * dev)97 static inline void drm_legacy_remove_map_hash(struct drm_device *dev) {}
98 #endif
99
100
101 #if IS_ENABLED(CONFIG_DRM_LEGACY)
102 int drm_legacy_getmap_ioctl(struct drm_device *dev, void *data,
103 struct drm_file *file_priv);
104 int drm_legacy_addmap_ioctl(struct drm_device *d, void *v, struct drm_file *f);
105 int drm_legacy_rmmap_ioctl(struct drm_device *d, void *v, struct drm_file *f);
106
107 int drm_legacy_addbufs(struct drm_device *d, void *v, struct drm_file *f);
108 int drm_legacy_infobufs(struct drm_device *d, void *v, struct drm_file *f);
109 int drm_legacy_markbufs(struct drm_device *d, void *v, struct drm_file *f);
110 int drm_legacy_freebufs(struct drm_device *d, void *v, struct drm_file *f);
111 int drm_legacy_mapbufs(struct drm_device *d, void *v, struct drm_file *f);
112 int drm_legacy_dma_ioctl(struct drm_device *d, void *v, struct drm_file *f);
113 #endif
114
115 int __drm_legacy_infobufs(struct drm_device *, void *, int *,
116 int (*)(void *, int, struct drm_buf_entry *));
117 int __drm_legacy_mapbufs(struct drm_device *, void *, int *,
118 void __user **,
119 int (*)(void *, int, unsigned long, struct drm_buf *),
120 struct drm_file *);
121
122 #if IS_ENABLED(CONFIG_DRM_LEGACY)
123 void drm_legacy_master_rmmaps(struct drm_device *dev,
124 struct drm_master *master);
125 void drm_legacy_rmmaps(struct drm_device *dev);
126 #else
drm_legacy_master_rmmaps(struct drm_device * dev,struct drm_master * master)127 static inline void drm_legacy_master_rmmaps(struct drm_device *dev,
128 struct drm_master *master) {}
drm_legacy_rmmaps(struct drm_device * dev)129 static inline void drm_legacy_rmmaps(struct drm_device *dev) {}
130 #endif
131
132 #if IS_ENABLED(CONFIG_DRM_VM) && IS_ENABLED(CONFIG_DRM_LEGACY)
133 void drm_legacy_vma_flush(struct drm_device *d);
134 #else
drm_legacy_vma_flush(struct drm_device * d)135 static inline void drm_legacy_vma_flush(struct drm_device *d)
136 {
137 /* do nothing */
138 }
139 #endif
140
141 /*
142 * AGP Support
143 */
144
145 struct drm_agp_mem {
146 unsigned long handle;
147 struct agp_memory *memory;
148 unsigned long bound;
149 int pages;
150 struct list_head head;
151 };
152
153 /* drm_lock.c */
154 #if IS_ENABLED(CONFIG_DRM_LEGACY)
155 int drm_legacy_lock(struct drm_device *d, void *v, struct drm_file *f);
156 int drm_legacy_unlock(struct drm_device *d, void *v, struct drm_file *f);
157 void drm_legacy_lock_release(struct drm_device *dev, struct file *filp);
158 #else
drm_legacy_lock_release(struct drm_device * dev,struct file * filp)159 static inline void drm_legacy_lock_release(struct drm_device *dev, struct file *filp) {}
160 #endif
161
162 /* DMA support */
163 #if IS_ENABLED(CONFIG_DRM_LEGACY)
164 int drm_legacy_dma_setup(struct drm_device *dev);
165 void drm_legacy_dma_takedown(struct drm_device *dev);
166 #else
drm_legacy_dma_setup(struct drm_device * dev)167 static inline int drm_legacy_dma_setup(struct drm_device *dev)
168 {
169 return 0;
170 }
171 #endif
172
173 void drm_legacy_free_buffer(struct drm_device *dev,
174 struct drm_buf * buf);
175 #if IS_ENABLED(CONFIG_DRM_LEGACY)
176 void drm_legacy_reclaim_buffers(struct drm_device *dev,
177 struct drm_file *filp);
178 #else
drm_legacy_reclaim_buffers(struct drm_device * dev,struct drm_file * filp)179 static inline void drm_legacy_reclaim_buffers(struct drm_device *dev,
180 struct drm_file *filp) {}
181 #endif
182
183 /* Scatter Gather Support */
184 #if IS_ENABLED(CONFIG_DRM_LEGACY)
185 void drm_legacy_sg_cleanup(struct drm_device *dev);
186 int drm_legacy_sg_alloc(struct drm_device *dev, void *data,
187 struct drm_file *file_priv);
188 int drm_legacy_sg_free(struct drm_device *dev, void *data,
189 struct drm_file *file_priv);
190 #endif
191
192 #if IS_ENABLED(CONFIG_DRM_LEGACY)
193 void drm_legacy_init_members(struct drm_device *dev);
194 void drm_legacy_destroy_members(struct drm_device *dev);
195 void drm_legacy_dev_reinit(struct drm_device *dev);
196 int drm_legacy_setup(struct drm_device * dev);
197 #else
drm_legacy_init_members(struct drm_device * dev)198 static inline void drm_legacy_init_members(struct drm_device *dev) {}
drm_legacy_destroy_members(struct drm_device * dev)199 static inline void drm_legacy_destroy_members(struct drm_device *dev) {}
drm_legacy_dev_reinit(struct drm_device * dev)200 static inline void drm_legacy_dev_reinit(struct drm_device *dev) {}
drm_legacy_setup(struct drm_device * dev)201 static inline int drm_legacy_setup(struct drm_device * dev) { return 0; }
202 #endif
203
204 #if IS_ENABLED(CONFIG_DRM_LEGACY)
205 void drm_legacy_lock_master_cleanup(struct drm_device *dev, struct drm_master *master);
206 #else
drm_legacy_lock_master_cleanup(struct drm_device * dev,struct drm_master * master)207 static inline void drm_legacy_lock_master_cleanup(struct drm_device *dev, struct drm_master *master) {}
208 #endif
209
210 #if IS_ENABLED(CONFIG_DRM_LEGACY)
211 void drm_master_legacy_init(struct drm_master *master);
212 #else
drm_master_legacy_init(struct drm_master * master)213 static inline void drm_master_legacy_init(struct drm_master *master) {}
214 #endif
215
216 #endif /* __DRM_LEGACY_H__ */
217