change system file

hc

2024-10-09 244b2c5ca8b14627e4a17755e5922221e121c771

 kernel/include/drm/drm_gem.h
..
..
@@ -35,8 +35,143 @@
35
35
  */
36
36
 
37
37
 #include <linux/kref.h>
38
+#include <linux/dma-resv.h>
38
39
 
39
40
 #include <drm/drm_vma_manager.h>
41
+
42
+struct drm_gem_object;
43
+
44
+/**
45
+ * struct drm_gem_object_funcs - GEM object functions
46
+ */
47
+struct drm_gem_object_funcs {
48
+	/**
49
+	 * @free:
50
+	 *
51
+	 * Deconstructor for drm_gem_objects.
52
+	 *
53
+	 * This callback is mandatory.
54
+	 */
55
+	void (*free)(struct drm_gem_object *obj);
56
+
57
+	/**
58
+	 * @open:
59
+	 *
60
+	 * Called upon GEM handle creation.
61
+	 *
62
+	 * This callback is optional.
63
+	 */
64
+	int (*open)(struct drm_gem_object *obj, struct drm_file *file);
65
+
66
+	/**
67
+	 * @close:
68
+	 *
69
+	 * Called upon GEM handle release.
70
+	 *
71
+	 * This callback is optional.
72
+	 */
73
+	void (*close)(struct drm_gem_object *obj, struct drm_file *file);
74
+
75
+	/**
76
+	 * @print_info:
77
+	 *
78
+	 * If driver subclasses struct &drm_gem_object, it can implement this
79
+	 * optional hook for printing additional driver specific info.
80
+	 *
81
+	 * drm_printf_indent() should be used in the callback passing it the
82
+	 * indent argument.
83
+	 *
84
+	 * This callback is called from drm_gem_print_info().
85
+	 *
86
+	 * This callback is optional.
87
+	 */
88
+	void (*print_info)(struct drm_printer *p, unsigned int indent,
89
+			   const struct drm_gem_object *obj);
90
+
91
+	/**
92
+	 * @export:
93
+	 *
94
+	 * Export backing buffer as a &dma_buf.
95
+	 * If this is not set drm_gem_prime_export() is used.
96
+	 *
97
+	 * This callback is optional.
98
+	 */
99
+	struct dma_buf *(*export)(struct drm_gem_object *obj, int flags);
100
+
101
+	/**
102
+	 * @pin:
103
+	 *
104
+	 * Pin backing buffer in memory. Used by the drm_gem_map_attach() helper.
105
+	 *
106
+	 * This callback is optional.
107
+	 */
108
+	int (*pin)(struct drm_gem_object *obj);
109
+
110
+	/**
111
+	 * @unpin:
112
+	 *
113
+	 * Unpin backing buffer. Used by the drm_gem_map_detach() helper.
114
+	 *
115
+	 * This callback is optional.
116
+	 */
117
+	void (*unpin)(struct drm_gem_object *obj);
118
+
119
+	/**
120
+	 * @get_sg_table:
121
+	 *
122
+	 * Returns a Scatter-Gather table representation of the buffer.
123
+	 * Used when exporting a buffer by the drm_gem_map_dma_buf() helper.
124
+	 * Releasing is done by calling dma_unmap_sg_attrs() and sg_free_table()
125
+	 * in drm_gem_unmap_buf(), therefore these helpers and this callback
126
+	 * here cannot be used for sg tables pointing at driver private memory
127
+	 * ranges.
128
+	 *
129
+	 * See also drm_prime_pages_to_sg().
130
+	 */
131
+	struct sg_table *(*get_sg_table)(struct drm_gem_object *obj);
132
+
133
+	/**
134
+	 * @vmap:
135
+	 *
136
+	 * Returns a virtual address for the buffer. Used by the
137
+	 * drm_gem_dmabuf_vmap() helper.
138
+	 *
139
+	 * This callback is optional.
140
+	 */
141
+	void *(*vmap)(struct drm_gem_object *obj);
142
+
143
+	/**
144
+	 * @vunmap:
145
+	 *
146
+	 * Releases the address previously returned by @vmap. Used by the
147
+	 * drm_gem_dmabuf_vunmap() helper.
148
+	 *
149
+	 * This callback is optional.
150
+	 */
151
+	void (*vunmap)(struct drm_gem_object *obj, void *vaddr);
152
+
153
+	/**
154
+	 * @mmap:
155
+	 *
156
+	 * Handle mmap() of the gem object, setup vma accordingly.
157
+	 *
158
+	 * This callback is optional.
159
+	 *
160
+	 * The callback is used by both drm_gem_mmap_obj() and
161
+	 * drm_gem_prime_mmap().  When @mmap is present @vm_ops is not
162
+	 * used, the @mmap callback must set vma->vm_ops instead.
163
+	 */
164
+	int (*mmap)(struct drm_gem_object *obj, struct vm_area_struct *vma);
165
+
166
+	/**
167
+	 * @vm_ops:
168
+	 *
169
+	 * Virtual memory operations used with mmap.
170
+	 *
171
+	 * This is optional but necessary for mmap support.
172
+	 */
173
+	const struct vm_operations_struct *vm_ops;
174
+};
40
175
 
41
176
 /**
42
177
  * struct drm_gem_object - GEM buffer object
..
..
@@ -52,8 +187,8 @@
52
187
 	 *
53
188
 	 * Reference count of this object
54
189
 	 *
55
-	 * Please use drm_gem_object_get() to acquire and drm_gem_object_put()
56
-	 * or drm_gem_object_put_unlocked() to release a reference to a GEM
190
+	 * Please use drm_gem_object_get() to acquire and drm_gem_object_put_locked()
191
+	 * or drm_gem_object_put() to release a reference to a GEM
57
192
 	 * buffer object.
58
193
 	 */
59
194
 	struct kref refcount;
..
..
@@ -137,8 +272,9 @@
137
272
 	 * attachment point for the device. This is invariant over the lifetime
138
273
 	 * of a gem object.
139
274
 	 *
140
-	 * The &drm_driver.gem_free_object callback is responsible for cleaning
141
-	 * up the dma_buf attachment and references acquired at import time.
275
+	 * The &drm_driver.gem_free_object_unlocked callback is responsible for
276
+	 * cleaning up the dma_buf attachment and references acquired at import
277
+	 * time.
142
278
 	 *
143
279
 	 * Note that the drm gem/prime core does not depend upon drivers setting
144
280
 	 * this field any more. So for drivers where this doesn't make sense
..
..
@@ -146,6 +282,35 @@
146
282
 	 * simply leave it as NULL.
147
283
 	 */
148
284
 	struct dma_buf_attachment *import_attach;
285
+
286
+	/**
287
+	 * @resv:
288
+	 *
289
+	 * Pointer to reservation object associated with the this GEM object.
290
+	 *
291
+	 * Normally (@resv == &@_resv) except for imported GEM objects.
292
+	 */
293
+	struct dma_resv *resv;
294
+
295
+	/**
296
+	 * @_resv:
297
+	 *
298
+	 * A reservation object for this GEM object.
299
+	 *
300
+	 * This is unused for imported GEM objects.
301
+	 */
302
+	struct dma_resv _resv;
303
+
304
+	/**
305
+	 * @funcs:
306
+	 *
307
+	 * Optional GEM object functions. If this is set, it will be used instead of the
308
+	 * corresponding &drm_driver GEM callbacks.
309
+	 *
310
+	 * New drivers should use this.
311
+	 *
312
+	 */
313
+	const struct drm_gem_object_funcs *funcs;
149
314
 };
150
315
 
151
316
 /**
..
..
@@ -198,79 +363,27 @@
198
363
 	kref_get(&obj->refcount);
199
364
 }
200
365
 
201
-/**
202
- * __drm_gem_object_put - raw function to release a GEM buffer object reference
203
- * @obj: GEM buffer object
204
- *
205
- * This function is meant to be used by drivers which are not encumbered with
206
- * &drm_device.struct_mutex legacy locking and which are using the
207
- * gem_free_object_unlocked callback. It avoids all the locking checks and
208
- * locking overhead of drm_gem_object_put() and drm_gem_object_put_unlocked().
209
- *
210
- * Drivers should never call this directly in their code. Instead they should
211
- * wrap it up into a ``driver_gem_object_put(struct driver_gem_object *obj)``
212
- * wrapper function, and use that. Shared code should never call this, to
213
- * avoid breaking drivers by accident which still depend upon
214
- * &drm_device.struct_mutex locking.
215
- */
366
+__attribute__((nonnull))
216
367
 static inline void
217
368
 __drm_gem_object_put(struct drm_gem_object *obj)
218
369
 {
219
370
 	kref_put(&obj->refcount, drm_gem_object_free);
220
371
 }
221
372
 
222
-void drm_gem_object_put_unlocked(struct drm_gem_object *obj);
223
-void drm_gem_object_put(struct drm_gem_object *obj);
224
-
225
373
 /**
226
- * drm_gem_object_reference - acquire a GEM buffer object reference
374
+ * drm_gem_object_put - drop a GEM buffer object reference
227
375
  * @obj: GEM buffer object
228
376
  *
229
- * This is a compatibility alias for drm_gem_object_get() and should not be
230
- * used by new code.
231
- */
232
-static inline void drm_gem_object_reference(struct drm_gem_object *obj)
233
-{
234
-	drm_gem_object_get(obj);
235
-}
236
-
237
-/**
238
- * __drm_gem_object_unreference - raw function to release a GEM buffer object
239
- *                                reference
240
- * @obj: GEM buffer object
241
- *
242
- * This is a compatibility alias for __drm_gem_object_put() and should not be
243
- * used by new code.
244
- */
245
-static inline void __drm_gem_object_unreference(struct drm_gem_object *obj)
246
-{
247
-	__drm_gem_object_put(obj);
248
-}
249
-
250
-/**
251
- * drm_gem_object_unreference_unlocked - release a GEM buffer object reference
252
- * @obj: GEM buffer object
253
- *
254
- * This is a compatibility alias for drm_gem_object_put_unlocked() and should
255
- * not be used by new code.
377
+ * This releases a reference to @obj.
256
378
  */
257
379
 static inline void
258
-drm_gem_object_unreference_unlocked(struct drm_gem_object *obj)
380
+drm_gem_object_put(struct drm_gem_object *obj)
259
381
 {
260
-	drm_gem_object_put_unlocked(obj);
382
+	if (obj)
383
+		__drm_gem_object_put(obj);
261
384
 }
262
385
 
263
-/**
264
- * drm_gem_object_unreference - release a GEM buffer object reference
265
- * @obj: GEM buffer object
266
- *
267
- * This is a compatibility alias for drm_gem_object_put() and should not be
268
- * used by new code.
269
- */
270
-static inline void drm_gem_object_unreference(struct drm_gem_object *obj)
271
-{
272
-	drm_gem_object_put(obj);
273
-}
386
+void drm_gem_object_put_locked(struct drm_gem_object *obj);
274
387
 
275
388
 int drm_gem_handle_create(struct drm_file *file_priv,
276
389
 			  struct drm_gem_object *obj,
..
..
@@ -286,7 +399,20 @@
286
399
 void drm_gem_put_pages(struct drm_gem_object *obj, struct page **pages,
287
400
 		bool dirty, bool accessed);
288
401
 
402
+int drm_gem_objects_lookup(struct drm_file *filp, void __user *bo_handles,
403
+			   int count, struct drm_gem_object ***objs_out);
289
404
 struct drm_gem_object *drm_gem_object_lookup(struct drm_file *filp, u32 handle);
405
+long drm_gem_dma_resv_wait(struct drm_file *filep, u32 handle,
406
+				    bool wait_all, unsigned long timeout);
407
+int drm_gem_lock_reservations(struct drm_gem_object **objs, int count,
408
+			      struct ww_acquire_ctx *acquire_ctx);
409
+void drm_gem_unlock_reservations(struct drm_gem_object **objs, int count,
410
+				 struct ww_acquire_ctx *acquire_ctx);
411
+int drm_gem_fence_array_add(struct xarray *fence_array,
412
+			    struct dma_fence *fence);
413
+int drm_gem_fence_array_add_implicit(struct xarray *fence_array,
414
+				     struct drm_gem_object *obj,
415
+				     bool write);
290
416
 int drm_gem_dumb_map_offset(struct drm_file *file, struct drm_device *dev,
291
417
 			    u32 handle, u64 *offset);
292
418
 int drm_gem_dumb_destroy(struct drm_file *file,