Commit | Line | Data |
---|---|---|
3248877e DA |
1 | /* |
2 | * Copyright © 2012 Red Hat | |
3 | * | |
4 | * Permission is hereby granted, free of charge, to any person obtaining a | |
5 | * copy of this software and associated documentation files (the "Software"), | |
6 | * to deal in the Software without restriction, including without limitation | |
7 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
8 | * and/or sell copies of the Software, and to permit persons to whom the | |
9 | * Software is furnished to do so, subject to the following conditions: | |
10 | * | |
11 | * The above copyright notice and this permission notice (including the next | |
12 | * paragraph) shall be included in all copies or substantial portions of the | |
13 | * 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 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
19 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |
20 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS | |
21 | * IN THE SOFTWARE. | |
22 | * | |
23 | * Authors: | |
24 | * Dave Airlie <airlied@redhat.com> | |
25 | * Rob Clark <rob.clark@linaro.org> | |
26 | * | |
27 | */ | |
28 | ||
29 | #include <linux/export.h> | |
30 | #include <linux/dma-buf.h> | |
077675c1 | 31 | #include <linux/rbtree.h> |
c6bb9baa | 32 | #include <drm/drm_prime.h> |
d9fc9413 | 33 | #include <drm/drm_gem.h> |
c6bb9baa | 34 | #include <drm/drmP.h> |
d9fc9413 | 35 | |
67d0ec4e | 36 | #include "drm_internal.h" |
3248877e DA |
37 | |
38 | /* | |
39 | * DMA-BUF/GEM Object references and lifetime overview: | |
40 | * | |
41 | * On the export the dma_buf holds a reference to the exporting GEM | |
42 | * object. It takes this reference in handle_to_fd_ioctl, when it | |
43 | * first calls .prime_export and stores the exporting GEM object in | |
fa4c1de4 OA |
44 | * the dma_buf priv. This reference needs to be released when the |
45 | * final reference to the &dma_buf itself is dropped and its | |
46 | * &dma_buf_ops.release function is called. For GEM-based drivers, | |
47 | * the dma_buf should be exported using drm_gem_dmabuf_export() and | |
48 | * then released by drm_gem_dmabuf_release(). | |
3248877e DA |
49 | * |
50 | * On the import the importing GEM object holds a reference to the | |
51 | * dma_buf (which in turn holds a ref to the exporting GEM object). | |
52 | * It takes that reference in the fd_to_handle ioctl. | |
53 | * It calls dma_buf_get, creates an attachment to it and stores the | |
54 | * attachment in the GEM object. When this attachment is destroyed | |
55 | * when the imported object is destroyed, we remove the attachment | |
56 | * and drop the reference to the dma_buf. | |
57 | * | |
fa4c1de4 OA |
58 | * When all the references to the &dma_buf are dropped, i.e. when |
59 | * userspace has closed both handles to the imported GEM object (through the | |
60 | * FD_TO_HANDLE IOCTL) and closed the file descriptor of the exported | |
61 | * (through the HANDLE_TO_FD IOCTL) dma_buf, and all kernel-internal references | |
62 | * are also gone, then the dma_buf gets destroyed. This can also happen as a | |
63 | * part of the clean up procedure in the drm_release() function if userspace | |
64 | * fails to properly clean up. Note that both the kernel and userspace (by | |
65 | * keeeping the PRIME file descriptors open) can hold references onto a | |
66 | * &dma_buf. | |
67 | * | |
3248877e DA |
68 | * Thus the chain of references always flows in one direction |
69 | * (avoiding loops): importing_gem -> dmabuf -> exporting_gem | |
70 | * | |
71 | * Self-importing: if userspace is using PRIME as a replacement for flink | |
72 | * then it will get a fd->handle request for a GEM object that it created. | |
73 | * Drivers should detect this situation and return back the gem object | |
89177644 AP |
74 | * from the dma-buf private. Prime will do this automatically for drivers that |
75 | * use the drm_gem_prime_{import,export} helpers. | |
f7a71b0c SL |
76 | * |
77 | * GEM struct &dma_buf_ops symbols are now exported. They can be resued by | |
78 | * drivers which implement GEM interface. | |
3248877e DA |
79 | */ |
80 | ||
81 | struct drm_prime_member { | |
3248877e DA |
82 | struct dma_buf *dma_buf; |
83 | uint32_t handle; | |
077675c1 CW |
84 | |
85 | struct rb_node dmabuf_rb; | |
86 | struct rb_node handle_rb; | |
3248877e | 87 | }; |
538d6661 JS |
88 | |
89 | struct drm_prime_attachment { | |
90 | struct sg_table *sgt; | |
91 | enum dma_data_direction dir; | |
92 | }; | |
93 | ||
39cc344a DV |
94 | static int drm_prime_add_buf_handle(struct drm_prime_file_private *prime_fpriv, |
95 | struct dma_buf *dma_buf, uint32_t handle) | |
ce92e3c9 SWK |
96 | { |
97 | struct drm_prime_member *member; | |
077675c1 | 98 | struct rb_node **p, *rb; |
ce92e3c9 SWK |
99 | |
100 | member = kmalloc(sizeof(*member), GFP_KERNEL); | |
101 | if (!member) | |
102 | return -ENOMEM; | |
103 | ||
104 | get_dma_buf(dma_buf); | |
105 | member->dma_buf = dma_buf; | |
106 | member->handle = handle; | |
077675c1 CW |
107 | |
108 | rb = NULL; | |
109 | p = &prime_fpriv->dmabufs.rb_node; | |
110 | while (*p) { | |
111 | struct drm_prime_member *pos; | |
112 | ||
113 | rb = *p; | |
114 | pos = rb_entry(rb, struct drm_prime_member, dmabuf_rb); | |
115 | if (dma_buf > pos->dma_buf) | |
116 | p = &rb->rb_right; | |
117 | else | |
118 | p = &rb->rb_left; | |
119 | } | |
120 | rb_link_node(&member->dmabuf_rb, rb, p); | |
121 | rb_insert_color(&member->dmabuf_rb, &prime_fpriv->dmabufs); | |
122 | ||
123 | rb = NULL; | |
124 | p = &prime_fpriv->handles.rb_node; | |
125 | while (*p) { | |
126 | struct drm_prime_member *pos; | |
127 | ||
128 | rb = *p; | |
129 | pos = rb_entry(rb, struct drm_prime_member, handle_rb); | |
130 | if (handle > pos->handle) | |
131 | p = &rb->rb_right; | |
132 | else | |
133 | p = &rb->rb_left; | |
134 | } | |
135 | rb_link_node(&member->handle_rb, rb, p); | |
136 | rb_insert_color(&member->handle_rb, &prime_fpriv->handles); | |
137 | ||
ce92e3c9 SWK |
138 | return 0; |
139 | } | |
3248877e | 140 | |
d0b2c533 DV |
141 | static struct dma_buf *drm_prime_lookup_buf_by_handle(struct drm_prime_file_private *prime_fpriv, |
142 | uint32_t handle) | |
143 | { | |
077675c1 CW |
144 | struct rb_node *rb; |
145 | ||
146 | rb = prime_fpriv->handles.rb_node; | |
147 | while (rb) { | |
148 | struct drm_prime_member *member; | |
d0b2c533 | 149 | |
077675c1 | 150 | member = rb_entry(rb, struct drm_prime_member, handle_rb); |
d0b2c533 DV |
151 | if (member->handle == handle) |
152 | return member->dma_buf; | |
077675c1 CW |
153 | else if (member->handle < handle) |
154 | rb = rb->rb_right; | |
155 | else | |
156 | rb = rb->rb_left; | |
d0b2c533 DV |
157 | } |
158 | ||
159 | return NULL; | |
160 | } | |
161 | ||
de9564d8 DV |
162 | static int drm_prime_lookup_buf_handle(struct drm_prime_file_private *prime_fpriv, |
163 | struct dma_buf *dma_buf, | |
164 | uint32_t *handle) | |
165 | { | |
077675c1 CW |
166 | struct rb_node *rb; |
167 | ||
168 | rb = prime_fpriv->dmabufs.rb_node; | |
169 | while (rb) { | |
170 | struct drm_prime_member *member; | |
de9564d8 | 171 | |
077675c1 | 172 | member = rb_entry(rb, struct drm_prime_member, dmabuf_rb); |
de9564d8 DV |
173 | if (member->dma_buf == dma_buf) { |
174 | *handle = member->handle; | |
175 | return 0; | |
077675c1 CW |
176 | } else if (member->dma_buf < dma_buf) { |
177 | rb = rb->rb_right; | |
178 | } else { | |
179 | rb = rb->rb_left; | |
de9564d8 DV |
180 | } |
181 | } | |
077675c1 | 182 | |
de9564d8 DV |
183 | return -ENOENT; |
184 | } | |
185 | ||
f7a71b0c SL |
186 | /** |
187 | * drm_gem_map_attach - dma_buf attach implementation for GEM | |
188 | * @dma_buf: buffer to attach device to | |
189 | * @target_dev: not used | |
190 | * @attach: buffer attachment data | |
191 | * | |
192 | * Allocates &drm_prime_attachment and calls &drm_driver.gem_prime_pin for | |
193 | * device specific attachment. This can be used as the &dma_buf_ops.attach | |
194 | * callback. | |
195 | * | |
196 | * Returns 0 on success, negative error code on failure. | |
197 | */ | |
c308279f SL |
198 | int drm_gem_map_attach(struct dma_buf *dma_buf, struct device *target_dev, |
199 | struct dma_buf_attachment *attach) | |
ca793f75 | 200 | { |
538d6661 | 201 | struct drm_prime_attachment *prime_attach; |
ca793f75 ML |
202 | struct drm_gem_object *obj = dma_buf->priv; |
203 | struct drm_device *dev = obj->dev; | |
204 | ||
538d6661 JS |
205 | prime_attach = kzalloc(sizeof(*prime_attach), GFP_KERNEL); |
206 | if (!prime_attach) | |
207 | return -ENOMEM; | |
208 | ||
209 | prime_attach->dir = DMA_NONE; | |
210 | attach->priv = prime_attach; | |
211 | ||
ca793f75 ML |
212 | if (!dev->driver->gem_prime_pin) |
213 | return 0; | |
214 | ||
215 | return dev->driver->gem_prime_pin(obj); | |
216 | } | |
c308279f | 217 | EXPORT_SYMBOL(drm_gem_map_attach); |
ca793f75 | 218 | |
f7a71b0c SL |
219 | /** |
220 | * drm_gem_map_detach - dma_buf detach implementation for GEM | |
221 | * @dma_buf: buffer to detach from | |
222 | * @attach: attachment to be detached | |
223 | * | |
224 | * Cleans up &dma_buf_attachment. This can be used as the &dma_buf_ops.detach | |
225 | * callback. | |
226 | */ | |
c308279f SL |
227 | void drm_gem_map_detach(struct dma_buf *dma_buf, |
228 | struct dma_buf_attachment *attach) | |
ca793f75 | 229 | { |
538d6661 | 230 | struct drm_prime_attachment *prime_attach = attach->priv; |
ca793f75 ML |
231 | struct drm_gem_object *obj = dma_buf->priv; |
232 | struct drm_device *dev = obj->dev; | |
233 | ||
681066ec CK |
234 | if (prime_attach) { |
235 | struct sg_table *sgt = prime_attach->sgt; | |
538d6661 | 236 | |
681066ec CK |
237 | if (sgt) { |
238 | if (prime_attach->dir != DMA_NONE) | |
239 | dma_unmap_sg_attrs(attach->dev, sgt->sgl, | |
240 | sgt->nents, | |
241 | prime_attach->dir, | |
242 | DMA_ATTR_SKIP_CPU_SYNC); | |
243 | sg_free_table(sgt); | |
244 | } | |
245 | ||
246 | kfree(sgt); | |
247 | kfree(prime_attach); | |
248 | attach->priv = NULL; | |
f9d8a129 | 249 | } |
538d6661 | 250 | |
681066ec CK |
251 | if (dev->driver->gem_prime_unpin) |
252 | dev->driver->gem_prime_unpin(obj); | |
ca793f75 | 253 | } |
c308279f | 254 | EXPORT_SYMBOL(drm_gem_map_detach); |
ca793f75 | 255 | |
d0b2c533 DV |
256 | void drm_prime_remove_buf_handle_locked(struct drm_prime_file_private *prime_fpriv, |
257 | struct dma_buf *dma_buf) | |
da34242e | 258 | { |
077675c1 | 259 | struct rb_node *rb; |
da34242e | 260 | |
077675c1 CW |
261 | rb = prime_fpriv->dmabufs.rb_node; |
262 | while (rb) { | |
263 | struct drm_prime_member *member; | |
264 | ||
265 | member = rb_entry(rb, struct drm_prime_member, dmabuf_rb); | |
da34242e | 266 | if (member->dma_buf == dma_buf) { |
077675c1 CW |
267 | rb_erase(&member->handle_rb, &prime_fpriv->handles); |
268 | rb_erase(&member->dmabuf_rb, &prime_fpriv->dmabufs); | |
269 | ||
da34242e | 270 | dma_buf_put(dma_buf); |
da34242e | 271 | kfree(member); |
077675c1 CW |
272 | return; |
273 | } else if (member->dma_buf < dma_buf) { | |
274 | rb = rb->rb_right; | |
275 | } else { | |
276 | rb = rb->rb_left; | |
da34242e YC |
277 | } |
278 | } | |
279 | } | |
280 | ||
f7a71b0c SL |
281 | /** |
282 | * drm_gem_map_dma_buf - map_dma_buf implementation for GEM | |
283 | * @attach: attachment whose scatterlist is to be returned | |
284 | * @dir: direction of DMA transfer | |
285 | * | |
286 | * Calls &drm_driver.gem_prime_get_sg_table and then maps the scatterlist. This | |
287 | * can be used as the &dma_buf_ops.map_dma_buf callback. | |
288 | * | |
289 | * Returns sg_table containing the scatterlist to be returned; returns ERR_PTR | |
290 | * on error. May return -EINTR if it is interrupted by a signal. | |
291 | */ | |
292 | ||
c308279f SL |
293 | struct sg_table *drm_gem_map_dma_buf(struct dma_buf_attachment *attach, |
294 | enum dma_data_direction dir) | |
89177644 | 295 | { |
538d6661 | 296 | struct drm_prime_attachment *prime_attach = attach->priv; |
89177644 AP |
297 | struct drm_gem_object *obj = attach->dmabuf->priv; |
298 | struct sg_table *sgt; | |
299 | ||
538d6661 JS |
300 | if (WARN_ON(dir == DMA_NONE || !prime_attach)) |
301 | return ERR_PTR(-EINVAL); | |
302 | ||
303 | /* return the cached mapping when possible */ | |
304 | if (prime_attach->dir == dir) | |
305 | return prime_attach->sgt; | |
306 | ||
307 | /* | |
308 | * two mappings with different directions for the same attachment are | |
309 | * not allowed | |
310 | */ | |
311 | if (WARN_ON(prime_attach->dir != DMA_NONE)) | |
312 | return ERR_PTR(-EBUSY); | |
313 | ||
89177644 AP |
314 | sgt = obj->dev->driver->gem_prime_get_sg_table(obj); |
315 | ||
7e3d88f9 | 316 | if (!IS_ERR(sgt)) { |
ca0e68e2 LS |
317 | if (!dma_map_sg_attrs(attach->dev, sgt->sgl, sgt->nents, dir, |
318 | DMA_ATTR_SKIP_CPU_SYNC)) { | |
b720d54a YC |
319 | sg_free_table(sgt); |
320 | kfree(sgt); | |
321 | sgt = ERR_PTR(-ENOMEM); | |
538d6661 JS |
322 | } else { |
323 | prime_attach->sgt = sgt; | |
324 | prime_attach->dir = dir; | |
b720d54a YC |
325 | } |
326 | } | |
89177644 | 327 | |
89177644 AP |
328 | return sgt; |
329 | } | |
c308279f | 330 | EXPORT_SYMBOL(drm_gem_map_dma_buf); |
89177644 | 331 | |
f7a71b0c SL |
332 | /** |
333 | * drm_gem_unmap_dma_buf - unmap_dma_buf implementation for GEM | |
790861cc SL |
334 | * @attach: attachment to unmap buffer from |
335 | * @sgt: scatterlist info of the buffer to unmap | |
336 | * @dir: direction of DMA transfer | |
f7a71b0c SL |
337 | * |
338 | * Not implemented. The unmap is done at drm_gem_map_detach(). This can be | |
339 | * used as the &dma_buf_ops.unmap_dma_buf callback. | |
340 | */ | |
c308279f SL |
341 | void drm_gem_unmap_dma_buf(struct dma_buf_attachment *attach, |
342 | struct sg_table *sgt, | |
343 | enum dma_data_direction dir) | |
89177644 | 344 | { |
538d6661 | 345 | /* nothing to be done here */ |
89177644 | 346 | } |
c308279f | 347 | EXPORT_SYMBOL(drm_gem_unmap_dma_buf); |
89177644 | 348 | |
a4fce9cb CW |
349 | /** |
350 | * drm_gem_dmabuf_export - dma_buf export implementation for GEM | |
67c8f116 CW |
351 | * @dev: parent device for the exported dmabuf |
352 | * @exp_info: the export information used by dma_buf_export() | |
a4fce9cb CW |
353 | * |
354 | * This wraps dma_buf_export() for use by generic GEM drivers that are using | |
355 | * drm_gem_dmabuf_release(). In addition to calling dma_buf_export(), we take | |
72a93e8d | 356 | * a reference to the &drm_device and the exported &drm_gem_object (stored in |
940eba2d | 357 | * &dma_buf_export_info.priv) which is released by drm_gem_dmabuf_release(). |
a4fce9cb CW |
358 | * |
359 | * Returns the new dmabuf. | |
360 | */ | |
361 | struct dma_buf *drm_gem_dmabuf_export(struct drm_device *dev, | |
362 | struct dma_buf_export_info *exp_info) | |
363 | { | |
364 | struct dma_buf *dma_buf; | |
365 | ||
366 | dma_buf = dma_buf_export(exp_info); | |
72a93e8d CW |
367 | if (IS_ERR(dma_buf)) |
368 | return dma_buf; | |
369 | ||
9a96f550 | 370 | drm_dev_get(dev); |
e6b62714 | 371 | drm_gem_object_get(exp_info->priv); |
a4fce9cb CW |
372 | |
373 | return dma_buf; | |
374 | } | |
375 | EXPORT_SYMBOL(drm_gem_dmabuf_export); | |
376 | ||
39cc344a DV |
377 | /** |
378 | * drm_gem_dmabuf_release - dma_buf release implementation for GEM | |
379 | * @dma_buf: buffer to be released | |
380 | * | |
381 | * Generic release function for dma_bufs exported as PRIME buffers. GEM drivers | |
382 | * must use this in their dma_buf ops structure as the release callback. | |
a4fce9cb CW |
383 | * drm_gem_dmabuf_release() should be used in conjunction with |
384 | * drm_gem_dmabuf_export(). | |
39cc344a | 385 | */ |
c1d6798d | 386 | void drm_gem_dmabuf_release(struct dma_buf *dma_buf) |
89177644 AP |
387 | { |
388 | struct drm_gem_object *obj = dma_buf->priv; | |
a4fce9cb | 389 | struct drm_device *dev = obj->dev; |
89177644 | 390 | |
319c933c | 391 | /* drop the reference on the export fd holds */ |
e6b62714 | 392 | drm_gem_object_put_unlocked(obj); |
a4fce9cb | 393 | |
ffeeeed0 | 394 | drm_dev_put(dev); |
89177644 | 395 | } |
c1d6798d | 396 | EXPORT_SYMBOL(drm_gem_dmabuf_release); |
89177644 | 397 | |
f7a71b0c SL |
398 | /** |
399 | * drm_gem_dmabuf_vmap - dma_buf vmap implementation for GEM | |
400 | * @dma_buf: buffer to be mapped | |
401 | * | |
402 | * Sets up a kernel virtual mapping. This can be used as the &dma_buf_ops.vmap | |
403 | * callback. | |
404 | * | |
405 | * Returns the kernel virtual address. | |
406 | */ | |
c308279f | 407 | void *drm_gem_dmabuf_vmap(struct dma_buf *dma_buf) |
89177644 AP |
408 | { |
409 | struct drm_gem_object *obj = dma_buf->priv; | |
410 | struct drm_device *dev = obj->dev; | |
411 | ||
412 | return dev->driver->gem_prime_vmap(obj); | |
413 | } | |
c308279f | 414 | EXPORT_SYMBOL(drm_gem_dmabuf_vmap); |
89177644 | 415 | |
f7a71b0c SL |
416 | /** |
417 | * drm_gem_dmabuf_vunmap - dma_buf vunmap implementation for GEM | |
418 | * @dma_buf: buffer to be unmapped | |
419 | * @vaddr: the virtual address of the buffer | |
420 | * | |
421 | * Releases a kernel virtual mapping. This can be used as the | |
422 | * &dma_buf_ops.vunmap callback. | |
423 | */ | |
c308279f | 424 | void drm_gem_dmabuf_vunmap(struct dma_buf *dma_buf, void *vaddr) |
89177644 AP |
425 | { |
426 | struct drm_gem_object *obj = dma_buf->priv; | |
427 | struct drm_device *dev = obj->dev; | |
428 | ||
429 | dev->driver->gem_prime_vunmap(obj, vaddr); | |
430 | } | |
c308279f | 431 | EXPORT_SYMBOL(drm_gem_dmabuf_vunmap); |
89177644 | 432 | |
f7a71b0c SL |
433 | /** |
434 | * drm_gem_dmabuf_kmap_atomic - map_atomic implementation for GEM | |
790861cc SL |
435 | * @dma_buf: buffer to be mapped |
436 | * @page_num: page number within the buffer | |
f7a71b0c SL |
437 | * |
438 | * Not implemented. This can be used as the &dma_buf_ops.map_atomic callback. | |
439 | */ | |
c308279f SL |
440 | void *drm_gem_dmabuf_kmap_atomic(struct dma_buf *dma_buf, |
441 | unsigned long page_num) | |
89177644 AP |
442 | { |
443 | return NULL; | |
444 | } | |
c308279f | 445 | EXPORT_SYMBOL(drm_gem_dmabuf_kmap_atomic); |
89177644 | 446 | |
f7a71b0c SL |
447 | /** |
448 | * drm_gem_dmabuf_kunmap_atomic - unmap_atomic implementation for GEM | |
790861cc SL |
449 | * @dma_buf: buffer to be unmapped |
450 | * @page_num: page number within the buffer | |
451 | * @addr: virtual address of the buffer | |
f7a71b0c SL |
452 | * |
453 | * Not implemented. This can be used as the &dma_buf_ops.unmap_atomic callback. | |
454 | */ | |
c308279f SL |
455 | void drm_gem_dmabuf_kunmap_atomic(struct dma_buf *dma_buf, |
456 | unsigned long page_num, void *addr) | |
89177644 AP |
457 | { |
458 | ||
459 | } | |
c308279f SL |
460 | EXPORT_SYMBOL(drm_gem_dmabuf_kunmap_atomic); |
461 | ||
f7a71b0c SL |
462 | /** |
463 | * drm_gem_dmabuf_kmap - map implementation for GEM | |
790861cc SL |
464 | * @dma_buf: buffer to be mapped |
465 | * @page_num: page number within the buffer | |
f7a71b0c SL |
466 | * |
467 | * Not implemented. This can be used as the &dma_buf_ops.map callback. | |
468 | */ | |
c308279f | 469 | void *drm_gem_dmabuf_kmap(struct dma_buf *dma_buf, unsigned long page_num) |
89177644 AP |
470 | { |
471 | return NULL; | |
472 | } | |
c308279f | 473 | EXPORT_SYMBOL(drm_gem_dmabuf_kmap); |
89177644 | 474 | |
f7a71b0c SL |
475 | /** |
476 | * drm_gem_dmabuf_kunmap - unmap implementation for GEM | |
790861cc SL |
477 | * @dma_buf: buffer to be unmapped |
478 | * @page_num: page number within the buffer | |
479 | * @addr: virtual address of the buffer | |
f7a71b0c SL |
480 | * |
481 | * Not implemented. This can be used as the &dma_buf_ops.unmap callback. | |
482 | */ | |
c308279f SL |
483 | void drm_gem_dmabuf_kunmap(struct dma_buf *dma_buf, unsigned long page_num, |
484 | void *addr) | |
89177644 AP |
485 | { |
486 | ||
487 | } | |
c308279f | 488 | EXPORT_SYMBOL(drm_gem_dmabuf_kunmap); |
89177644 | 489 | |
f7a71b0c SL |
490 | /** |
491 | * drm_gem_dmabuf_mmap - dma_buf mmap implementation for GEM | |
492 | * @dma_buf: buffer to be mapped | |
493 | * @vma: virtual address range | |
494 | * | |
495 | * Provides memory mapping for the buffer. This can be used as the | |
496 | * &dma_buf_ops.mmap callback. | |
497 | * | |
498 | * Returns 0 on success or a negative error code on failure. | |
499 | */ | |
c308279f | 500 | int drm_gem_dmabuf_mmap(struct dma_buf *dma_buf, struct vm_area_struct *vma) |
89177644 | 501 | { |
7c397cd9 JS |
502 | struct drm_gem_object *obj = dma_buf->priv; |
503 | struct drm_device *dev = obj->dev; | |
504 | ||
505 | if (!dev->driver->gem_prime_mmap) | |
506 | return -ENOSYS; | |
507 | ||
508 | return dev->driver->gem_prime_mmap(obj, vma); | |
89177644 | 509 | } |
c308279f | 510 | EXPORT_SYMBOL(drm_gem_dmabuf_mmap); |
89177644 AP |
511 | |
512 | static const struct dma_buf_ops drm_gem_prime_dmabuf_ops = { | |
ca793f75 ML |
513 | .attach = drm_gem_map_attach, |
514 | .detach = drm_gem_map_detach, | |
89177644 AP |
515 | .map_dma_buf = drm_gem_map_dma_buf, |
516 | .unmap_dma_buf = drm_gem_unmap_dma_buf, | |
517 | .release = drm_gem_dmabuf_release, | |
f9b67f00 LG |
518 | .map = drm_gem_dmabuf_kmap, |
519 | .map_atomic = drm_gem_dmabuf_kmap_atomic, | |
520 | .unmap = drm_gem_dmabuf_kunmap, | |
521 | .unmap_atomic = drm_gem_dmabuf_kunmap_atomic, | |
89177644 AP |
522 | .mmap = drm_gem_dmabuf_mmap, |
523 | .vmap = drm_gem_dmabuf_vmap, | |
524 | .vunmap = drm_gem_dmabuf_vunmap, | |
525 | }; | |
526 | ||
527 | /** | |
528 | * DOC: PRIME Helpers | |
529 | * | |
530 | * Drivers can implement @gem_prime_export and @gem_prime_import in terms of | |
531 | * simpler APIs by using the helper functions @drm_gem_prime_export and | |
532 | * @drm_gem_prime_import. These functions implement dma-buf support in terms of | |
ffc5fbdb | 533 | * six lower-level driver callbacks: |
89177644 AP |
534 | * |
535 | * Export callbacks: | |
536 | * | |
f03d8ede DCLP |
537 | * * @gem_prime_pin (optional): prepare a GEM object for exporting |
538 | * * @gem_prime_get_sg_table: provide a scatter/gather table of pinned pages | |
539 | * * @gem_prime_vmap: vmap a buffer exported by your driver | |
540 | * * @gem_prime_vunmap: vunmap a buffer exported by your driver | |
541 | * * @gem_prime_mmap (optional): mmap a buffer exported by your driver | |
ffc5fbdb | 542 | * |
89177644 AP |
543 | * Import callback: |
544 | * | |
f03d8ede | 545 | * * @gem_prime_import_sg_table (import): produce a GEM object from another |
89177644 AP |
546 | * driver's scatter/gather table |
547 | */ | |
548 | ||
39cc344a | 549 | /** |
32197aab | 550 | * drm_gem_prime_export - helper library implementation of the export callback |
39cc344a DV |
551 | * @dev: drm_device to export from |
552 | * @obj: GEM object to export | |
bfe981a0 | 553 | * @flags: flags like DRM_CLOEXEC and DRM_RDWR |
39cc344a DV |
554 | * |
555 | * This is the implementation of the gem_prime_export functions for GEM drivers | |
556 | * using the PRIME helpers. | |
557 | */ | |
89177644 | 558 | struct dma_buf *drm_gem_prime_export(struct drm_device *dev, |
56a76c01 CW |
559 | struct drm_gem_object *obj, |
560 | int flags) | |
89177644 | 561 | { |
56a76c01 CW |
562 | struct dma_buf_export_info exp_info = { |
563 | .exp_name = KBUILD_MODNAME, /* white lie for debug */ | |
564 | .owner = dev->driver->fops->owner, | |
565 | .ops = &drm_gem_prime_dmabuf_ops, | |
566 | .size = obj->size, | |
567 | .flags = flags, | |
568 | .priv = obj, | |
569 | }; | |
3aac4502 ML |
570 | |
571 | if (dev->driver->gem_prime_res_obj) | |
d8fbe341 | 572 | exp_info.resv = dev->driver->gem_prime_res_obj(obj); |
3aac4502 | 573 | |
a4fce9cb | 574 | return drm_gem_dmabuf_export(dev, &exp_info); |
89177644 AP |
575 | } |
576 | EXPORT_SYMBOL(drm_gem_prime_export); | |
577 | ||
319c933c DV |
578 | static struct dma_buf *export_and_register_object(struct drm_device *dev, |
579 | struct drm_gem_object *obj, | |
580 | uint32_t flags) | |
581 | { | |
582 | struct dma_buf *dmabuf; | |
583 | ||
584 | /* prevent races with concurrent gem_close. */ | |
585 | if (obj->handle_count == 0) { | |
586 | dmabuf = ERR_PTR(-ENOENT); | |
587 | return dmabuf; | |
588 | } | |
589 | ||
590 | dmabuf = dev->driver->gem_prime_export(dev, obj, flags); | |
591 | if (IS_ERR(dmabuf)) { | |
592 | /* normally the created dma-buf takes ownership of the ref, | |
593 | * but if that fails then drop the ref | |
594 | */ | |
595 | return dmabuf; | |
596 | } | |
597 | ||
598 | /* | |
599 | * Note that callers do not need to clean up the export cache | |
600 | * since the check for obj->handle_count guarantees that someone | |
601 | * will clean it up. | |
602 | */ | |
603 | obj->dma_buf = dmabuf; | |
604 | get_dma_buf(obj->dma_buf); | |
605 | ||
606 | return dmabuf; | |
607 | } | |
608 | ||
39cc344a DV |
609 | /** |
610 | * drm_gem_prime_handle_to_fd - PRIME export function for GEM drivers | |
611 | * @dev: dev to export the buffer from | |
612 | * @file_priv: drm file-private structure | |
613 | * @handle: buffer handle to export | |
614 | * @flags: flags like DRM_CLOEXEC | |
615 | * @prime_fd: pointer to storage for the fd id of the create dma-buf | |
616 | * | |
617 | * This is the PRIME export function which must be used mandatorily by GEM | |
618 | * drivers to ensure correct lifetime management of the underlying GEM object. | |
619 | * The actual exporting from GEM object to a dma-buf is done through the | |
620 | * gem_prime_export driver callback. | |
621 | */ | |
3248877e | 622 | int drm_gem_prime_handle_to_fd(struct drm_device *dev, |
39cc344a DV |
623 | struct drm_file *file_priv, uint32_t handle, |
624 | uint32_t flags, | |
625 | int *prime_fd) | |
3248877e DA |
626 | { |
627 | struct drm_gem_object *obj; | |
219b4733 DA |
628 | int ret = 0; |
629 | struct dma_buf *dmabuf; | |
3248877e | 630 | |
d0b2c533 | 631 | mutex_lock(&file_priv->prime.lock); |
a8ad0bd8 | 632 | obj = drm_gem_object_lookup(file_priv, handle); |
d0b2c533 DV |
633 | if (!obj) { |
634 | ret = -ENOENT; | |
635 | goto out_unlock; | |
636 | } | |
637 | ||
638 | dmabuf = drm_prime_lookup_buf_by_handle(&file_priv->prime, handle); | |
639 | if (dmabuf) { | |
640 | get_dma_buf(dmabuf); | |
641 | goto out_have_handle; | |
642 | } | |
3248877e | 643 | |
d0b2c533 | 644 | mutex_lock(&dev->object_name_lock); |
3248877e DA |
645 | /* re-export the original imported object */ |
646 | if (obj->import_attach) { | |
219b4733 | 647 | dmabuf = obj->import_attach->dmabuf; |
319c933c | 648 | get_dma_buf(dmabuf); |
219b4733 | 649 | goto out_have_obj; |
3248877e DA |
650 | } |
651 | ||
319c933c DV |
652 | if (obj->dma_buf) { |
653 | get_dma_buf(obj->dma_buf); | |
654 | dmabuf = obj->dma_buf; | |
219b4733 | 655 | goto out_have_obj; |
3248877e | 656 | } |
219b4733 | 657 | |
319c933c | 658 | dmabuf = export_and_register_object(dev, obj, flags); |
4332bf43 | 659 | if (IS_ERR(dmabuf)) { |
219b4733 DA |
660 | /* normally the created dma-buf takes ownership of the ref, |
661 | * but if that fails then drop the ref | |
662 | */ | |
4332bf43 | 663 | ret = PTR_ERR(dmabuf); |
d0b2c533 | 664 | mutex_unlock(&dev->object_name_lock); |
219b4733 DA |
665 | goto out; |
666 | } | |
219b4733 | 667 | |
d0b2c533 DV |
668 | out_have_obj: |
669 | /* | |
670 | * If we've exported this buffer then cheat and add it to the import list | |
671 | * so we get the correct handle back. We must do this under the | |
672 | * protection of dev->object_name_lock to ensure that a racing gem close | |
673 | * ioctl doesn't miss to remove this buffer handle from the cache. | |
0ff926c7 | 674 | */ |
219b4733 | 675 | ret = drm_prime_add_buf_handle(&file_priv->prime, |
319c933c | 676 | dmabuf, handle); |
d0b2c533 | 677 | mutex_unlock(&dev->object_name_lock); |
219b4733 | 678 | if (ret) |
7d8f06ac | 679 | goto fail_put_dmabuf; |
0ff926c7 | 680 | |
d0b2c533 | 681 | out_have_handle: |
4332bf43 | 682 | ret = dma_buf_fd(dmabuf, flags); |
d0b2c533 DV |
683 | /* |
684 | * We must _not_ remove the buffer from the handle cache since the newly | |
685 | * created dma buf is already linked in the global obj->dma_buf pointer, | |
686 | * and that is invariant as long as a userspace gem handle exists. | |
687 | * Closing the handle will clean out the cache anyway, so we don't leak. | |
688 | */ | |
4a88f73f | 689 | if (ret < 0) { |
d0b2c533 | 690 | goto fail_put_dmabuf; |
4a88f73f | 691 | } else { |
da34242e | 692 | *prime_fd = ret; |
4a88f73f DV |
693 | ret = 0; |
694 | } | |
695 | ||
7d8f06ac YC |
696 | goto out; |
697 | ||
698 | fail_put_dmabuf: | |
4332bf43 | 699 | dma_buf_put(dmabuf); |
219b4733 | 700 | out: |
e6b62714 | 701 | drm_gem_object_put_unlocked(obj); |
d0b2c533 DV |
702 | out_unlock: |
703 | mutex_unlock(&file_priv->prime.lock); | |
704 | ||
219b4733 | 705 | return ret; |
3248877e DA |
706 | } |
707 | EXPORT_SYMBOL(drm_gem_prime_handle_to_fd); | |
708 | ||
39cc344a | 709 | /** |
7e491583 | 710 | * drm_gem_prime_import_dev - core implementation of the import callback |
39cc344a DV |
711 | * @dev: drm_device to import into |
712 | * @dma_buf: dma-buf object to import | |
7e491583 | 713 | * @attach_dev: struct device to dma_buf attach |
39cc344a | 714 | * |
7e491583 LA |
715 | * This is the core of drm_gem_prime_import. It's designed to be called by |
716 | * drivers who want to use a different device structure than dev->dev for | |
717 | * attaching via dma_buf. | |
39cc344a | 718 | */ |
7e491583 LA |
719 | struct drm_gem_object *drm_gem_prime_import_dev(struct drm_device *dev, |
720 | struct dma_buf *dma_buf, | |
721 | struct device *attach_dev) | |
89177644 AP |
722 | { |
723 | struct dma_buf_attachment *attach; | |
724 | struct sg_table *sgt; | |
725 | struct drm_gem_object *obj; | |
726 | int ret; | |
727 | ||
89177644 AP |
728 | if (dma_buf->ops == &drm_gem_prime_dmabuf_ops) { |
729 | obj = dma_buf->priv; | |
730 | if (obj->dev == dev) { | |
731 | /* | |
732 | * Importing dmabuf exported from out own gem increases | |
733 | * refcount on gem itself instead of f_count of dmabuf. | |
734 | */ | |
e6b62714 | 735 | drm_gem_object_get(obj); |
89177644 AP |
736 | return obj; |
737 | } | |
738 | } | |
739 | ||
98515035 TF |
740 | if (!dev->driver->gem_prime_import_sg_table) |
741 | return ERR_PTR(-EINVAL); | |
742 | ||
7e491583 | 743 | attach = dma_buf_attach(dma_buf, attach_dev); |
89177644 | 744 | if (IS_ERR(attach)) |
f2a5da4f | 745 | return ERR_CAST(attach); |
89177644 | 746 | |
011c2282 ID |
747 | get_dma_buf(dma_buf); |
748 | ||
89177644 | 749 | sgt = dma_buf_map_attachment(attach, DMA_BIDIRECTIONAL); |
fee0c54e | 750 | if (IS_ERR(sgt)) { |
89177644 AP |
751 | ret = PTR_ERR(sgt); |
752 | goto fail_detach; | |
753 | } | |
754 | ||
b5e9c1a2 | 755 | obj = dev->driver->gem_prime_import_sg_table(dev, attach, sgt); |
89177644 AP |
756 | if (IS_ERR(obj)) { |
757 | ret = PTR_ERR(obj); | |
758 | goto fail_unmap; | |
759 | } | |
760 | ||
761 | obj->import_attach = attach; | |
762 | ||
763 | return obj; | |
764 | ||
765 | fail_unmap: | |
766 | dma_buf_unmap_attachment(attach, sgt, DMA_BIDIRECTIONAL); | |
767 | fail_detach: | |
768 | dma_buf_detach(dma_buf, attach); | |
011c2282 ID |
769 | dma_buf_put(dma_buf); |
770 | ||
89177644 AP |
771 | return ERR_PTR(ret); |
772 | } | |
7e491583 LA |
773 | EXPORT_SYMBOL(drm_gem_prime_import_dev); |
774 | ||
775 | /** | |
776 | * drm_gem_prime_import - helper library implementation of the import callback | |
777 | * @dev: drm_device to import into | |
778 | * @dma_buf: dma-buf object to import | |
779 | * | |
780 | * This is the implementation of the gem_prime_import functions for GEM drivers | |
781 | * using the PRIME helpers. | |
782 | */ | |
783 | struct drm_gem_object *drm_gem_prime_import(struct drm_device *dev, | |
784 | struct dma_buf *dma_buf) | |
785 | { | |
786 | return drm_gem_prime_import_dev(dev, dma_buf, dev->dev); | |
787 | } | |
89177644 AP |
788 | EXPORT_SYMBOL(drm_gem_prime_import); |
789 | ||
39cc344a DV |
790 | /** |
791 | * drm_gem_prime_fd_to_handle - PRIME import function for GEM drivers | |
792 | * @dev: dev to export the buffer from | |
793 | * @file_priv: drm file-private structure | |
794 | * @prime_fd: fd id of the dma-buf which should be imported | |
795 | * @handle: pointer to storage for the handle of the imported buffer object | |
796 | * | |
797 | * This is the PRIME import function which must be used mandatorily by GEM | |
798 | * drivers to ensure correct lifetime management of the underlying GEM object. | |
799 | * The actual importing of GEM object from the dma-buf is done through the | |
800 | * gem_import_export driver callback. | |
801 | */ | |
3248877e | 802 | int drm_gem_prime_fd_to_handle(struct drm_device *dev, |
39cc344a DV |
803 | struct drm_file *file_priv, int prime_fd, |
804 | uint32_t *handle) | |
3248877e DA |
805 | { |
806 | struct dma_buf *dma_buf; | |
807 | struct drm_gem_object *obj; | |
808 | int ret; | |
809 | ||
810 | dma_buf = dma_buf_get(prime_fd); | |
811 | if (IS_ERR(dma_buf)) | |
812 | return PTR_ERR(dma_buf); | |
813 | ||
814 | mutex_lock(&file_priv->prime.lock); | |
815 | ||
219b4733 | 816 | ret = drm_prime_lookup_buf_handle(&file_priv->prime, |
3248877e | 817 | dma_buf, handle); |
84341c28 | 818 | if (ret == 0) |
3248877e | 819 | goto out_put; |
3248877e DA |
820 | |
821 | /* never seen this one, need to import */ | |
319c933c | 822 | mutex_lock(&dev->object_name_lock); |
3248877e DA |
823 | obj = dev->driver->gem_prime_import(dev, dma_buf); |
824 | if (IS_ERR(obj)) { | |
825 | ret = PTR_ERR(obj); | |
319c933c DV |
826 | goto out_unlock; |
827 | } | |
828 | ||
829 | if (obj->dma_buf) { | |
830 | WARN_ON(obj->dma_buf != dma_buf); | |
831 | } else { | |
832 | obj->dma_buf = dma_buf; | |
833 | get_dma_buf(dma_buf); | |
3248877e DA |
834 | } |
835 | ||
bd6e2732 | 836 | /* _handle_create_tail unconditionally unlocks dev->object_name_lock. */ |
319c933c | 837 | ret = drm_gem_handle_create_tail(file_priv, obj, handle); |
e6b62714 | 838 | drm_gem_object_put_unlocked(obj); |
3248877e DA |
839 | if (ret) |
840 | goto out_put; | |
841 | ||
219b4733 | 842 | ret = drm_prime_add_buf_handle(&file_priv->prime, |
3248877e | 843 | dma_buf, *handle); |
bd6e2732 | 844 | mutex_unlock(&file_priv->prime.lock); |
3248877e DA |
845 | if (ret) |
846 | goto fail; | |
847 | ||
011c2282 ID |
848 | dma_buf_put(dma_buf); |
849 | ||
3248877e DA |
850 | return 0; |
851 | ||
852 | fail: | |
853 | /* hmm, if driver attached, we are relying on the free-object path | |
854 | * to detach.. which seems ok.. | |
855 | */ | |
730c4ff9 | 856 | drm_gem_handle_delete(file_priv, *handle); |
bd6e2732 RC |
857 | dma_buf_put(dma_buf); |
858 | return ret; | |
859 | ||
319c933c | 860 | out_unlock: |
0adb2370 | 861 | mutex_unlock(&dev->object_name_lock); |
3248877e | 862 | out_put: |
3248877e | 863 | mutex_unlock(&file_priv->prime.lock); |
bd6e2732 | 864 | dma_buf_put(dma_buf); |
3248877e DA |
865 | return ret; |
866 | } | |
867 | EXPORT_SYMBOL(drm_gem_prime_fd_to_handle); | |
868 | ||
869 | int drm_prime_handle_to_fd_ioctl(struct drm_device *dev, void *data, | |
870 | struct drm_file *file_priv) | |
871 | { | |
872 | struct drm_prime_handle *args = data; | |
3248877e DA |
873 | |
874 | if (!drm_core_check_feature(dev, DRIVER_PRIME)) | |
875 | return -EINVAL; | |
876 | ||
877 | if (!dev->driver->prime_handle_to_fd) | |
878 | return -ENOSYS; | |
879 | ||
880 | /* check flags are valid */ | |
bfe981a0 | 881 | if (args->flags & ~(DRM_CLOEXEC | DRM_RDWR)) |
3248877e DA |
882 | return -EINVAL; |
883 | ||
3248877e | 884 | return dev->driver->prime_handle_to_fd(dev, file_priv, |
bfe981a0 | 885 | args->handle, args->flags, &args->fd); |
3248877e DA |
886 | } |
887 | ||
888 | int drm_prime_fd_to_handle_ioctl(struct drm_device *dev, void *data, | |
889 | struct drm_file *file_priv) | |
890 | { | |
891 | struct drm_prime_handle *args = data; | |
892 | ||
893 | if (!drm_core_check_feature(dev, DRIVER_PRIME)) | |
894 | return -EINVAL; | |
895 | ||
896 | if (!dev->driver->prime_fd_to_handle) | |
897 | return -ENOSYS; | |
898 | ||
899 | return dev->driver->prime_fd_to_handle(dev, file_priv, | |
900 | args->fd, &args->handle); | |
901 | } | |
902 | ||
39cc344a DV |
903 | /** |
904 | * drm_prime_pages_to_sg - converts a page array into an sg list | |
905 | * @pages: pointer to the array of page pointers to convert | |
906 | * @nr_pages: length of the page vector | |
3248877e | 907 | * |
39cc344a | 908 | * This helper creates an sg table object from a set of pages |
3248877e | 909 | * the driver is responsible for mapping the pages into the |
39cc344a | 910 | * importers address space for use with dma_buf itself. |
3248877e | 911 | */ |
34eab43e | 912 | struct sg_table *drm_prime_pages_to_sg(struct page **pages, unsigned int nr_pages) |
3248877e DA |
913 | { |
914 | struct sg_table *sg = NULL; | |
3248877e DA |
915 | int ret; |
916 | ||
917 | sg = kmalloc(sizeof(struct sg_table), GFP_KERNEL); | |
7e3d88f9 YC |
918 | if (!sg) { |
919 | ret = -ENOMEM; | |
3248877e | 920 | goto out; |
7e3d88f9 | 921 | } |
3248877e | 922 | |
dca25cb8 RS |
923 | ret = sg_alloc_table_from_pages(sg, pages, nr_pages, 0, |
924 | nr_pages << PAGE_SHIFT, GFP_KERNEL); | |
3248877e DA |
925 | if (ret) |
926 | goto out; | |
927 | ||
3248877e DA |
928 | return sg; |
929 | out: | |
930 | kfree(sg); | |
7e3d88f9 | 931 | return ERR_PTR(ret); |
3248877e DA |
932 | } |
933 | EXPORT_SYMBOL(drm_prime_pages_to_sg); | |
934 | ||
39cc344a DV |
935 | /** |
936 | * drm_prime_sg_to_page_addr_arrays - convert an sg table into a page array | |
937 | * @sgt: scatter-gather table to convert | |
186ca446 | 938 | * @pages: optional array of page pointers to store the page array in |
39cc344a | 939 | * @addrs: optional array to store the dma bus address of each page |
186ca446 | 940 | * @max_entries: size of both the passed-in arrays |
39cc344a DV |
941 | * |
942 | * Exports an sg table into an array of pages and addresses. This is currently | |
943 | * required by the TTM driver in order to do correct fault handling. | |
944 | */ | |
51ab7ba2 | 945 | int drm_prime_sg_to_page_addr_arrays(struct sg_table *sgt, struct page **pages, |
186ca446 | 946 | dma_addr_t *addrs, int max_entries) |
51ab7ba2 DA |
947 | { |
948 | unsigned count; | |
949 | struct scatterlist *sg; | |
950 | struct page *page; | |
186ca446 | 951 | u32 len, index; |
51ab7ba2 DA |
952 | dma_addr_t addr; |
953 | ||
186ca446 | 954 | index = 0; |
51ab7ba2 DA |
955 | for_each_sg(sgt->sgl, sg, sgt->nents, count) { |
956 | len = sg->length; | |
51ab7ba2 DA |
957 | page = sg_page(sg); |
958 | addr = sg_dma_address(sg); | |
959 | ||
960 | while (len > 0) { | |
186ca446 | 961 | if (WARN_ON(index >= max_entries)) |
51ab7ba2 | 962 | return -1; |
186ca446 CK |
963 | if (pages) |
964 | pages[index] = page; | |
51ab7ba2 | 965 | if (addrs) |
186ca446 | 966 | addrs[index] = addr; |
51ab7ba2 DA |
967 | |
968 | page++; | |
969 | addr += PAGE_SIZE; | |
970 | len -= PAGE_SIZE; | |
186ca446 | 971 | index++; |
51ab7ba2 DA |
972 | } |
973 | } | |
974 | return 0; | |
975 | } | |
976 | EXPORT_SYMBOL(drm_prime_sg_to_page_addr_arrays); | |
39cc344a DV |
977 | |
978 | /** | |
979 | * drm_prime_gem_destroy - helper to clean up a PRIME-imported GEM object | |
980 | * @obj: GEM object which was created from a dma-buf | |
981 | * @sg: the sg-table which was pinned at import time | |
982 | * | |
983 | * This is the cleanup functions which GEM drivers need to call when they use | |
984 | * @drm_gem_prime_import to import dma-bufs. | |
985 | */ | |
3248877e DA |
986 | void drm_prime_gem_destroy(struct drm_gem_object *obj, struct sg_table *sg) |
987 | { | |
988 | struct dma_buf_attachment *attach; | |
989 | struct dma_buf *dma_buf; | |
990 | attach = obj->import_attach; | |
991 | if (sg) | |
992 | dma_buf_unmap_attachment(attach, sg, DMA_BIDIRECTIONAL); | |
993 | dma_buf = attach->dmabuf; | |
994 | dma_buf_detach(attach->dmabuf, attach); | |
995 | /* remove the reference */ | |
996 | dma_buf_put(dma_buf); | |
997 | } | |
998 | EXPORT_SYMBOL(drm_prime_gem_destroy); | |
999 | ||
1000 | void drm_prime_init_file_private(struct drm_prime_file_private *prime_fpriv) | |
1001 | { | |
3248877e | 1002 | mutex_init(&prime_fpriv->lock); |
077675c1 CW |
1003 | prime_fpriv->dmabufs = RB_ROOT; |
1004 | prime_fpriv->handles = RB_ROOT; | |
3248877e | 1005 | } |
3248877e DA |
1006 | |
1007 | void drm_prime_destroy_file_private(struct drm_prime_file_private *prime_fpriv) | |
1008 | { | |
98b76231 | 1009 | /* by now drm_gem_release should've made sure the list is empty */ |
077675c1 | 1010 | WARN_ON(!RB_EMPTY_ROOT(&prime_fpriv->dmabufs)); |
3248877e | 1011 | } |