Commit | Line | Data |
---|---|---|
2194a63a NT |
1 | // SPDX-License-Identifier: GPL-2.0 |
2 | /* | |
3 | * Copyright 2018 Noralf Trønnes | |
4 | */ | |
5 | ||
6 | #include <linux/dma-buf.h> | |
7 | #include <linux/export.h> | |
4b2b5e14 | 8 | #include <linux/module.h> |
2194a63a NT |
9 | #include <linux/mutex.h> |
10 | #include <linux/shmem_fs.h> | |
11 | #include <linux/slab.h> | |
12 | #include <linux/vmalloc.h> | |
8581fd40 | 13 | #include <linux/module.h> |
2194a63a | 14 | |
804b6e5e DV |
15 | #ifdef CONFIG_X86 |
16 | #include <asm/set_memory.h> | |
17 | #endif | |
18 | ||
d3ea256a | 19 | #include <drm/drm.h> |
2194a63a NT |
20 | #include <drm/drm_device.h> |
21 | #include <drm/drm_drv.h> | |
22 | #include <drm/drm_gem_shmem_helper.h> | |
23 | #include <drm/drm_prime.h> | |
24 | #include <drm/drm_print.h> | |
25 | ||
08e438e6 SR |
26 | MODULE_IMPORT_NS(DMA_BUF); |
27 | ||
2194a63a NT |
28 | /** |
29 | * DOC: overview | |
30 | * | |
31 | * This library provides helpers for GEM objects backed by shmem buffers | |
32 | * allocated using anonymous pageable memory. | |
a193f3b4 TZ |
33 | * |
34 | * Functions that operate on the GEM object receive struct &drm_gem_shmem_object. | |
35 | * For GEM callback helpers in struct &drm_gem_object functions, see likewise | |
36 | * named functions with an _object_ infix (e.g., drm_gem_shmem_object_vmap() wraps | |
37 | * drm_gem_shmem_vmap()). These helpers perform the necessary type conversion. | |
2194a63a NT |
38 | */ |
39 | ||
40 | static const struct drm_gem_object_funcs drm_gem_shmem_funcs = { | |
c7fbcb71 TZ |
41 | .free = drm_gem_shmem_object_free, |
42 | .print_info = drm_gem_shmem_object_print_info, | |
43 | .pin = drm_gem_shmem_object_pin, | |
44 | .unpin = drm_gem_shmem_object_unpin, | |
45 | .get_sg_table = drm_gem_shmem_object_get_sg_table, | |
46 | .vmap = drm_gem_shmem_object_vmap, | |
47 | .vunmap = drm_gem_shmem_object_vunmap, | |
48 | .mmap = drm_gem_shmem_object_mmap, | |
d315bdbf | 49 | .vm_ops = &drm_gem_shmem_vm_ops, |
2194a63a NT |
50 | }; |
51 | ||
7d2cd72a DV |
52 | static struct drm_gem_shmem_object * |
53 | __drm_gem_shmem_create(struct drm_device *dev, size_t size, bool private) | |
2194a63a NT |
54 | { |
55 | struct drm_gem_shmem_object *shmem; | |
56 | struct drm_gem_object *obj; | |
7d2cd72a | 57 | int ret = 0; |
2194a63a NT |
58 | |
59 | size = PAGE_ALIGN(size); | |
60 | ||
4ff22f48 | 61 | if (dev->driver->gem_create_object) { |
2194a63a | 62 | obj = dev->driver->gem_create_object(dev, size); |
4ff22f48 TZ |
63 | if (IS_ERR(obj)) |
64 | return ERR_CAST(obj); | |
65 | shmem = to_drm_gem_shmem_obj(obj); | |
66 | } else { | |
67 | shmem = kzalloc(sizeof(*shmem), GFP_KERNEL); | |
68 | if (!shmem) | |
69 | return ERR_PTR(-ENOMEM); | |
70 | obj = &shmem->base; | |
71 | } | |
0cf2ef46 | 72 | |
2194a63a NT |
73 | if (!obj->funcs) |
74 | obj->funcs = &drm_gem_shmem_funcs; | |
75 | ||
0cf2ef46 | 76 | if (private) { |
7d2cd72a | 77 | drm_gem_private_object_init(dev, obj, size); |
0cf2ef46 TZ |
78 | shmem->map_wc = false; /* dma-buf mappings use always writecombine */ |
79 | } else { | |
7d2cd72a | 80 | ret = drm_gem_object_init(dev, obj, size); |
0cf2ef46 | 81 | } |
7df34a61 C |
82 | if (ret) { |
83 | drm_gem_private_object_fini(obj); | |
2194a63a | 84 | goto err_free; |
7df34a61 | 85 | } |
2194a63a NT |
86 | |
87 | ret = drm_gem_create_mmap_offset(obj); | |
88 | if (ret) | |
89 | goto err_release; | |
90 | ||
2194a63a NT |
91 | mutex_init(&shmem->pages_lock); |
92 | mutex_init(&shmem->vmap_lock); | |
17acb9f3 | 93 | INIT_LIST_HEAD(&shmem->madv_list); |
2194a63a | 94 | |
5b9f5f11 DV |
95 | if (!private) { |
96 | /* | |
97 | * Our buffers are kept pinned, so allocating them | |
98 | * from the MOVABLE zone is a really bad idea, and | |
99 | * conflicts with CMA. See comments above new_inode() | |
100 | * why this is required _and_ expected if you're | |
101 | * going to pin these pages. | |
102 | */ | |
103 | mapping_set_gfp_mask(obj->filp->f_mapping, GFP_HIGHUSER | | |
104 | __GFP_RETRY_MAYFAIL | __GFP_NOWARN); | |
105 | } | |
2194a63a NT |
106 | |
107 | return shmem; | |
108 | ||
109 | err_release: | |
110 | drm_gem_object_release(obj); | |
111 | err_free: | |
112 | kfree(obj); | |
113 | ||
114 | return ERR_PTR(ret); | |
115 | } | |
7d2cd72a DV |
116 | /** |
117 | * drm_gem_shmem_create - Allocate an object with the given size | |
118 | * @dev: DRM device | |
119 | * @size: Size of the object to allocate | |
120 | * | |
121 | * This function creates a shmem GEM object. | |
122 | * | |
123 | * Returns: | |
124 | * A struct drm_gem_shmem_object * on success or an ERR_PTR()-encoded negative | |
125 | * error code on failure. | |
126 | */ | |
127 | struct drm_gem_shmem_object *drm_gem_shmem_create(struct drm_device *dev, size_t size) | |
128 | { | |
129 | return __drm_gem_shmem_create(dev, size, false); | |
130 | } | |
2194a63a NT |
131 | EXPORT_SYMBOL_GPL(drm_gem_shmem_create); |
132 | ||
133 | /** | |
a193f3b4 TZ |
134 | * drm_gem_shmem_free - Free resources associated with a shmem GEM object |
135 | * @shmem: shmem GEM object to free | |
2194a63a NT |
136 | * |
137 | * This function cleans up the GEM object state and frees the memory used to | |
c7fbcb71 | 138 | * store the object itself. |
2194a63a | 139 | */ |
a193f3b4 | 140 | void drm_gem_shmem_free(struct drm_gem_shmem_object *shmem) |
2194a63a | 141 | { |
a193f3b4 | 142 | struct drm_gem_object *obj = &shmem->base; |
2194a63a NT |
143 | |
144 | WARN_ON(shmem->vmap_use_count); | |
145 | ||
146 | if (obj->import_attach) { | |
2194a63a | 147 | drm_prime_gem_destroy(obj, shmem->sgt); |
2194a63a NT |
148 | } else { |
149 | if (shmem->sgt) { | |
6c6fa39c MS |
150 | dma_unmap_sgtable(obj->dev->dev, shmem->sgt, |
151 | DMA_BIDIRECTIONAL, 0); | |
2194a63a NT |
152 | sg_free_table(shmem->sgt); |
153 | kfree(shmem->sgt); | |
154 | } | |
3bf5189d RH |
155 | if (shmem->pages) |
156 | drm_gem_shmem_put_pages(shmem); | |
2194a63a NT |
157 | } |
158 | ||
159 | WARN_ON(shmem->pages_use_count); | |
160 | ||
161 | drm_gem_object_release(obj); | |
162 | mutex_destroy(&shmem->pages_lock); | |
163 | mutex_destroy(&shmem->vmap_lock); | |
164 | kfree(shmem); | |
165 | } | |
a193f3b4 | 166 | EXPORT_SYMBOL_GPL(drm_gem_shmem_free); |
2194a63a NT |
167 | |
168 | static int drm_gem_shmem_get_pages_locked(struct drm_gem_shmem_object *shmem) | |
169 | { | |
170 | struct drm_gem_object *obj = &shmem->base; | |
171 | struct page **pages; | |
172 | ||
173 | if (shmem->pages_use_count++ > 0) | |
174 | return 0; | |
175 | ||
176 | pages = drm_gem_get_pages(obj); | |
177 | if (IS_ERR(pages)) { | |
178 | DRM_DEBUG_KMS("Failed to get pages (%ld)\n", PTR_ERR(pages)); | |
179 | shmem->pages_use_count = 0; | |
180 | return PTR_ERR(pages); | |
181 | } | |
182 | ||
804b6e5e DV |
183 | /* |
184 | * TODO: Allocating WC pages which are correctly flushed is only | |
185 | * supported on x86. Ideal solution would be a GFP_WC flag, which also | |
186 | * ttm_pool.c could use. | |
187 | */ | |
188 | #ifdef CONFIG_X86 | |
189 | if (shmem->map_wc) | |
190 | set_pages_array_wc(pages, obj->size >> PAGE_SHIFT); | |
191 | #endif | |
192 | ||
2194a63a NT |
193 | shmem->pages = pages; |
194 | ||
195 | return 0; | |
196 | } | |
197 | ||
198 | /* | |
199 | * drm_gem_shmem_get_pages - Allocate backing pages for a shmem GEM object | |
200 | * @shmem: shmem GEM object | |
201 | * | |
202 | * This function makes sure that backing pages exists for the shmem GEM object | |
203 | * and increases the use count. | |
204 | * | |
205 | * Returns: | |
206 | * 0 on success or a negative error code on failure. | |
207 | */ | |
208 | int drm_gem_shmem_get_pages(struct drm_gem_shmem_object *shmem) | |
209 | { | |
210 | int ret; | |
211 | ||
52640835 DV |
212 | WARN_ON(shmem->base.import_attach); |
213 | ||
2194a63a NT |
214 | ret = mutex_lock_interruptible(&shmem->pages_lock); |
215 | if (ret) | |
216 | return ret; | |
217 | ret = drm_gem_shmem_get_pages_locked(shmem); | |
218 | mutex_unlock(&shmem->pages_lock); | |
219 | ||
220 | return ret; | |
221 | } | |
222 | EXPORT_SYMBOL(drm_gem_shmem_get_pages); | |
223 | ||
224 | static void drm_gem_shmem_put_pages_locked(struct drm_gem_shmem_object *shmem) | |
225 | { | |
226 | struct drm_gem_object *obj = &shmem->base; | |
227 | ||
228 | if (WARN_ON_ONCE(!shmem->pages_use_count)) | |
229 | return; | |
230 | ||
231 | if (--shmem->pages_use_count > 0) | |
232 | return; | |
233 | ||
804b6e5e DV |
234 | #ifdef CONFIG_X86 |
235 | if (shmem->map_wc) | |
236 | set_pages_array_wb(shmem->pages, obj->size >> PAGE_SHIFT); | |
237 | #endif | |
238 | ||
2194a63a NT |
239 | drm_gem_put_pages(obj, shmem->pages, |
240 | shmem->pages_mark_dirty_on_put, | |
241 | shmem->pages_mark_accessed_on_put); | |
242 | shmem->pages = NULL; | |
243 | } | |
244 | ||
245 | /* | |
246 | * drm_gem_shmem_put_pages - Decrease use count on the backing pages for a shmem GEM object | |
247 | * @shmem: shmem GEM object | |
248 | * | |
249 | * This function decreases the use count and puts the backing pages when use drops to zero. | |
250 | */ | |
251 | void drm_gem_shmem_put_pages(struct drm_gem_shmem_object *shmem) | |
252 | { | |
253 | mutex_lock(&shmem->pages_lock); | |
254 | drm_gem_shmem_put_pages_locked(shmem); | |
255 | mutex_unlock(&shmem->pages_lock); | |
256 | } | |
257 | EXPORT_SYMBOL(drm_gem_shmem_put_pages); | |
258 | ||
259 | /** | |
260 | * drm_gem_shmem_pin - Pin backing pages for a shmem GEM object | |
a193f3b4 | 261 | * @shmem: shmem GEM object |
2194a63a NT |
262 | * |
263 | * This function makes sure the backing pages are pinned in memory while the | |
c7fbcb71 | 264 | * buffer is exported. |
2194a63a NT |
265 | * |
266 | * Returns: | |
267 | * 0 on success or a negative error code on failure. | |
268 | */ | |
a193f3b4 | 269 | int drm_gem_shmem_pin(struct drm_gem_shmem_object *shmem) |
2194a63a | 270 | { |
52640835 DV |
271 | WARN_ON(shmem->base.import_attach); |
272 | ||
2194a63a NT |
273 | return drm_gem_shmem_get_pages(shmem); |
274 | } | |
275 | EXPORT_SYMBOL(drm_gem_shmem_pin); | |
276 | ||
277 | /** | |
278 | * drm_gem_shmem_unpin - Unpin backing pages for a shmem GEM object | |
a193f3b4 | 279 | * @shmem: shmem GEM object |
2194a63a NT |
280 | * |
281 | * This function removes the requirement that the backing pages are pinned in | |
c7fbcb71 | 282 | * memory. |
2194a63a | 283 | */ |
a193f3b4 | 284 | void drm_gem_shmem_unpin(struct drm_gem_shmem_object *shmem) |
2194a63a | 285 | { |
52640835 DV |
286 | WARN_ON(shmem->base.import_attach); |
287 | ||
2194a63a NT |
288 | drm_gem_shmem_put_pages(shmem); |
289 | } | |
290 | EXPORT_SYMBOL(drm_gem_shmem_unpin); | |
291 | ||
7938f421 LDM |
292 | static int drm_gem_shmem_vmap_locked(struct drm_gem_shmem_object *shmem, |
293 | struct iosys_map *map) | |
2194a63a NT |
294 | { |
295 | struct drm_gem_object *obj = &shmem->base; | |
6619ccf1 | 296 | int ret = 0; |
2194a63a | 297 | |
49a3f51d | 298 | if (shmem->vmap_use_count++ > 0) { |
7938f421 | 299 | iosys_map_set_vaddr(map, shmem->vaddr); |
49a3f51d TZ |
300 | return 0; |
301 | } | |
2194a63a | 302 | |
1cad6292 | 303 | if (obj->import_attach) { |
49a3f51d TZ |
304 | ret = dma_buf_vmap(obj->import_attach->dmabuf, map); |
305 | if (!ret) { | |
306 | if (WARN_ON(map->is_iomem)) { | |
df4aaf01 | 307 | dma_buf_vunmap(obj->import_attach->dmabuf, map); |
49a3f51d TZ |
308 | ret = -EIO; |
309 | goto err_put_pages; | |
310 | } | |
311 | shmem->vaddr = map->vaddr; | |
312 | } | |
1cad6292 GH |
313 | } else { |
314 | pgprot_t prot = PAGE_KERNEL; | |
315 | ||
0cc5fb4e DV |
316 | ret = drm_gem_shmem_get_pages(shmem); |
317 | if (ret) | |
318 | goto err_zero_use; | |
319 | ||
0cf2ef46 | 320 | if (shmem->map_wc) |
1cad6292 | 321 | prot = pgprot_writecombine(prot); |
be7d9f05 | 322 | shmem->vaddr = vmap(shmem->pages, obj->size >> PAGE_SHIFT, |
1cad6292 | 323 | VM_MAP, prot); |
6619ccf1 TZ |
324 | if (!shmem->vaddr) |
325 | ret = -ENOMEM; | |
49a3f51d | 326 | else |
7938f421 | 327 | iosys_map_set_vaddr(map, shmem->vaddr); |
1cad6292 | 328 | } |
2194a63a | 329 | |
6619ccf1 TZ |
330 | if (ret) { |
331 | DRM_DEBUG_KMS("Failed to vmap pages, error %d\n", ret); | |
2194a63a NT |
332 | goto err_put_pages; |
333 | } | |
334 | ||
49a3f51d | 335 | return 0; |
2194a63a NT |
336 | |
337 | err_put_pages: | |
0cc5fb4e DV |
338 | if (!obj->import_attach) |
339 | drm_gem_shmem_put_pages(shmem); | |
2194a63a NT |
340 | err_zero_use: |
341 | shmem->vmap_use_count = 0; | |
342 | ||
49a3f51d | 343 | return ret; |
2194a63a NT |
344 | } |
345 | ||
346 | /* | |
347 | * drm_gem_shmem_vmap - Create a virtual mapping for a shmem GEM object | |
348 | * @shmem: shmem GEM object | |
49a3f51d TZ |
349 | * @map: Returns the kernel virtual address of the SHMEM GEM object's backing |
350 | * store. | |
2194a63a | 351 | * |
0b638559 | 352 | * This function makes sure that a contiguous kernel virtual address mapping |
c7fbcb71 TZ |
353 | * exists for the buffer backing the shmem GEM object. It hides the differences |
354 | * between dma-buf imported and natively allocated objects. | |
0b638559 DV |
355 | * |
356 | * Acquired mappings should be cleaned up by calling drm_gem_shmem_vunmap(). | |
2194a63a NT |
357 | * |
358 | * Returns: | |
359 | * 0 on success or a negative error code on failure. | |
360 | */ | |
7938f421 LDM |
361 | int drm_gem_shmem_vmap(struct drm_gem_shmem_object *shmem, |
362 | struct iosys_map *map) | |
2194a63a | 363 | { |
2194a63a NT |
364 | int ret; |
365 | ||
366 | ret = mutex_lock_interruptible(&shmem->vmap_lock); | |
367 | if (ret) | |
49a3f51d TZ |
368 | return ret; |
369 | ret = drm_gem_shmem_vmap_locked(shmem, map); | |
2194a63a NT |
370 | mutex_unlock(&shmem->vmap_lock); |
371 | ||
49a3f51d | 372 | return ret; |
2194a63a NT |
373 | } |
374 | EXPORT_SYMBOL(drm_gem_shmem_vmap); | |
375 | ||
49a3f51d | 376 | static void drm_gem_shmem_vunmap_locked(struct drm_gem_shmem_object *shmem, |
7938f421 | 377 | struct iosys_map *map) |
2194a63a NT |
378 | { |
379 | struct drm_gem_object *obj = &shmem->base; | |
380 | ||
381 | if (WARN_ON_ONCE(!shmem->vmap_use_count)) | |
382 | return; | |
383 | ||
384 | if (--shmem->vmap_use_count > 0) | |
385 | return; | |
386 | ||
64e194e2 | 387 | if (obj->import_attach) { |
49a3f51d | 388 | dma_buf_vunmap(obj->import_attach->dmabuf, map); |
64e194e2 | 389 | } else { |
2194a63a | 390 | vunmap(shmem->vaddr); |
64e194e2 NT |
391 | drm_gem_shmem_put_pages(shmem); |
392 | } | |
2194a63a NT |
393 | |
394 | shmem->vaddr = NULL; | |
2194a63a NT |
395 | } |
396 | ||
397 | /* | |
0ae865ef | 398 | * drm_gem_shmem_vunmap - Unmap a virtual mapping for a shmem GEM object |
2194a63a | 399 | * @shmem: shmem GEM object |
49a3f51d | 400 | * @map: Kernel virtual address where the SHMEM GEM object was mapped |
2194a63a | 401 | * |
0b638559 DV |
402 | * This function cleans up a kernel virtual address mapping acquired by |
403 | * drm_gem_shmem_vmap(). The mapping is only removed when the use count drops to | |
404 | * zero. | |
405 | * | |
c7fbcb71 TZ |
406 | * This function hides the differences between dma-buf imported and natively |
407 | * allocated objects. | |
2194a63a | 408 | */ |
7938f421 LDM |
409 | void drm_gem_shmem_vunmap(struct drm_gem_shmem_object *shmem, |
410 | struct iosys_map *map) | |
2194a63a | 411 | { |
2194a63a | 412 | mutex_lock(&shmem->vmap_lock); |
49a3f51d | 413 | drm_gem_shmem_vunmap_locked(shmem, map); |
2194a63a NT |
414 | mutex_unlock(&shmem->vmap_lock); |
415 | } | |
416 | EXPORT_SYMBOL(drm_gem_shmem_vunmap); | |
417 | ||
3ad8173b | 418 | static int |
2194a63a NT |
419 | drm_gem_shmem_create_with_handle(struct drm_file *file_priv, |
420 | struct drm_device *dev, size_t size, | |
421 | uint32_t *handle) | |
422 | { | |
423 | struct drm_gem_shmem_object *shmem; | |
424 | int ret; | |
425 | ||
cfe28f90 | 426 | shmem = drm_gem_shmem_create(dev, size); |
2194a63a | 427 | if (IS_ERR(shmem)) |
3ad8173b | 428 | return PTR_ERR(shmem); |
2194a63a NT |
429 | |
430 | /* | |
431 | * Allocate an id of idr table where the obj is registered | |
432 | * and handle has the id what user can see. | |
433 | */ | |
434 | ret = drm_gem_handle_create(file_priv, &shmem->base, handle); | |
435 | /* drop reference from allocate - handle holds it now. */ | |
be6ee102 | 436 | drm_gem_object_put(&shmem->base); |
2194a63a | 437 | |
3ad8173b | 438 | return ret; |
2194a63a | 439 | } |
2194a63a | 440 | |
17acb9f3 RH |
441 | /* Update madvise status, returns true if not purged, else |
442 | * false or -errno. | |
443 | */ | |
a193f3b4 | 444 | int drm_gem_shmem_madvise(struct drm_gem_shmem_object *shmem, int madv) |
17acb9f3 | 445 | { |
17acb9f3 RH |
446 | mutex_lock(&shmem->pages_lock); |
447 | ||
448 | if (shmem->madv >= 0) | |
449 | shmem->madv = madv; | |
450 | ||
451 | madv = shmem->madv; | |
452 | ||
453 | mutex_unlock(&shmem->pages_lock); | |
454 | ||
455 | return (madv >= 0); | |
456 | } | |
457 | EXPORT_SYMBOL(drm_gem_shmem_madvise); | |
458 | ||
a193f3b4 | 459 | void drm_gem_shmem_purge_locked(struct drm_gem_shmem_object *shmem) |
17acb9f3 | 460 | { |
a193f3b4 | 461 | struct drm_gem_object *obj = &shmem->base; |
17acb9f3 | 462 | struct drm_device *dev = obj->dev; |
17acb9f3 RH |
463 | |
464 | WARN_ON(!drm_gem_shmem_is_purgeable(shmem)); | |
465 | ||
a193f3b4 | 466 | dma_unmap_sgtable(dev->dev, shmem->sgt, DMA_BIDIRECTIONAL, 0); |
4fa3d66f RH |
467 | sg_free_table(shmem->sgt); |
468 | kfree(shmem->sgt); | |
469 | shmem->sgt = NULL; | |
470 | ||
17acb9f3 RH |
471 | drm_gem_shmem_put_pages_locked(shmem); |
472 | ||
473 | shmem->madv = -1; | |
474 | ||
475 | drm_vma_node_unmap(&obj->vma_node, dev->anon_inode->i_mapping); | |
476 | drm_gem_free_mmap_offset(obj); | |
477 | ||
478 | /* Our goal here is to return as much of the memory as | |
479 | * is possible back to the system as we are called from OOM. | |
480 | * To do this we must instruct the shmfs to drop all of its | |
481 | * backing pages, *now*. | |
482 | */ | |
483 | shmem_truncate_range(file_inode(obj->filp), 0, (loff_t)-1); | |
484 | ||
a193f3b4 | 485 | invalidate_mapping_pages(file_inode(obj->filp)->i_mapping, 0, (loff_t)-1); |
17acb9f3 RH |
486 | } |
487 | EXPORT_SYMBOL(drm_gem_shmem_purge_locked); | |
488 | ||
a193f3b4 | 489 | bool drm_gem_shmem_purge(struct drm_gem_shmem_object *shmem) |
17acb9f3 | 490 | { |
dfbc7a46 RH |
491 | if (!mutex_trylock(&shmem->pages_lock)) |
492 | return false; | |
a193f3b4 | 493 | drm_gem_shmem_purge_locked(shmem); |
17acb9f3 | 494 | mutex_unlock(&shmem->pages_lock); |
dfbc7a46 RH |
495 | |
496 | return true; | |
17acb9f3 RH |
497 | } |
498 | EXPORT_SYMBOL(drm_gem_shmem_purge); | |
499 | ||
2194a63a NT |
500 | /** |
501 | * drm_gem_shmem_dumb_create - Create a dumb shmem buffer object | |
502 | * @file: DRM file structure to create the dumb buffer for | |
503 | * @dev: DRM device | |
504 | * @args: IOCTL data | |
505 | * | |
506 | * This function computes the pitch of the dumb buffer and rounds it up to an | |
507 | * integer number of bytes per pixel. Drivers for hardware that doesn't have | |
508 | * any additional restrictions on the pitch can directly use this function as | |
509 | * their &drm_driver.dumb_create callback. | |
510 | * | |
511 | * For hardware with additional restrictions, drivers can adjust the fields | |
512 | * set up by userspace before calling into this function. | |
513 | * | |
514 | * Returns: | |
515 | * 0 on success or a negative error code on failure. | |
516 | */ | |
517 | int drm_gem_shmem_dumb_create(struct drm_file *file, struct drm_device *dev, | |
518 | struct drm_mode_create_dumb *args) | |
519 | { | |
520 | u32 min_pitch = DIV_ROUND_UP(args->width * args->bpp, 8); | |
2194a63a NT |
521 | |
522 | if (!args->pitch || !args->size) { | |
523 | args->pitch = min_pitch; | |
35d28365 | 524 | args->size = PAGE_ALIGN(args->pitch * args->height); |
2194a63a NT |
525 | } else { |
526 | /* ensure sane minimum values */ | |
527 | if (args->pitch < min_pitch) | |
528 | args->pitch = min_pitch; | |
529 | if (args->size < args->pitch * args->height) | |
35d28365 | 530 | args->size = PAGE_ALIGN(args->pitch * args->height); |
2194a63a NT |
531 | } |
532 | ||
3ad8173b | 533 | return drm_gem_shmem_create_with_handle(file, dev, args->size, &args->handle); |
2194a63a NT |
534 | } |
535 | EXPORT_SYMBOL_GPL(drm_gem_shmem_dumb_create); | |
536 | ||
537 | static vm_fault_t drm_gem_shmem_fault(struct vm_fault *vmf) | |
538 | { | |
539 | struct vm_area_struct *vma = vmf->vma; | |
540 | struct drm_gem_object *obj = vma->vm_private_data; | |
541 | struct drm_gem_shmem_object *shmem = to_drm_gem_shmem_obj(obj); | |
542 | loff_t num_pages = obj->size >> PAGE_SHIFT; | |
d611b4a0 | 543 | vm_fault_t ret; |
2194a63a | 544 | struct page *page; |
11d5a474 NR |
545 | pgoff_t page_offset; |
546 | ||
547 | /* We don't use vmf->pgoff since that has the fake offset */ | |
548 | page_offset = (vmf->address - vma->vm_start) >> PAGE_SHIFT; | |
2194a63a | 549 | |
d611b4a0 NR |
550 | mutex_lock(&shmem->pages_lock); |
551 | ||
11d5a474 | 552 | if (page_offset >= num_pages || |
d611b4a0 NR |
553 | WARN_ON_ONCE(!shmem->pages) || |
554 | shmem->madv < 0) { | |
555 | ret = VM_FAULT_SIGBUS; | |
556 | } else { | |
11d5a474 | 557 | page = shmem->pages[page_offset]; |
2194a63a | 558 | |
8b93d1d7 | 559 | ret = vmf_insert_pfn(vma, vmf->address, page_to_pfn(page)); |
d611b4a0 | 560 | } |
2194a63a | 561 | |
d611b4a0 NR |
562 | mutex_unlock(&shmem->pages_lock); |
563 | ||
564 | return ret; | |
2194a63a NT |
565 | } |
566 | ||
567 | static void drm_gem_shmem_vm_open(struct vm_area_struct *vma) | |
568 | { | |
569 | struct drm_gem_object *obj = vma->vm_private_data; | |
570 | struct drm_gem_shmem_object *shmem = to_drm_gem_shmem_obj(obj); | |
2194a63a | 571 | |
52640835 DV |
572 | WARN_ON(shmem->base.import_attach); |
573 | ||
09bf649a RC |
574 | mutex_lock(&shmem->pages_lock); |
575 | ||
576 | /* | |
577 | * We should have already pinned the pages when the buffer was first | |
578 | * mmap'd, vm_open() just grabs an additional reference for the new | |
579 | * mm the vma is getting copied into (ie. on fork()). | |
580 | */ | |
581 | if (!WARN_ON_ONCE(!shmem->pages_use_count)) | |
582 | shmem->pages_use_count++; | |
583 | ||
584 | mutex_unlock(&shmem->pages_lock); | |
2194a63a NT |
585 | |
586 | drm_gem_vm_open(vma); | |
587 | } | |
588 | ||
589 | static void drm_gem_shmem_vm_close(struct vm_area_struct *vma) | |
590 | { | |
591 | struct drm_gem_object *obj = vma->vm_private_data; | |
592 | struct drm_gem_shmem_object *shmem = to_drm_gem_shmem_obj(obj); | |
593 | ||
594 | drm_gem_shmem_put_pages(shmem); | |
595 | drm_gem_vm_close(vma); | |
596 | } | |
597 | ||
d315bdbf | 598 | const struct vm_operations_struct drm_gem_shmem_vm_ops = { |
2194a63a NT |
599 | .fault = drm_gem_shmem_fault, |
600 | .open = drm_gem_shmem_vm_open, | |
601 | .close = drm_gem_shmem_vm_close, | |
602 | }; | |
d315bdbf | 603 | EXPORT_SYMBOL_GPL(drm_gem_shmem_vm_ops); |
2194a63a NT |
604 | |
605 | /** | |
606 | * drm_gem_shmem_mmap - Memory-map a shmem GEM object | |
a193f3b4 | 607 | * @shmem: shmem GEM object |
2194a63a NT |
608 | * @vma: VMA for the area to be mapped |
609 | * | |
610 | * This function implements an augmented version of the GEM DRM file mmap | |
c7fbcb71 | 611 | * operation for shmem objects. |
2194a63a NT |
612 | * |
613 | * Returns: | |
614 | * 0 on success or a negative error code on failure. | |
615 | */ | |
a193f3b4 | 616 | int drm_gem_shmem_mmap(struct drm_gem_shmem_object *shmem, struct vm_area_struct *vma) |
2194a63a | 617 | { |
a193f3b4 | 618 | struct drm_gem_object *obj = &shmem->base; |
2194a63a NT |
619 | int ret; |
620 | ||
f49a51bf DV |
621 | if (obj->import_attach) { |
622 | /* Drop the reference drm_gem_mmap_obj() acquired.*/ | |
623 | drm_gem_object_put(obj); | |
624 | vma->vm_private_data = NULL; | |
625 | ||
26d3ac3c | 626 | return dma_buf_mmap(obj->dma_buf, vma, 0); |
f49a51bf | 627 | } |
26d3ac3c | 628 | |
2194a63a | 629 | ret = drm_gem_shmem_get_pages(shmem); |
24013314 | 630 | if (ret) |
2194a63a | 631 | return ret; |
2194a63a | 632 | |
1c71222e | 633 | vm_flags_set(vma, VM_PFNMAP | VM_DONTEXPAND | VM_DONTDUMP); |
1cad6292 | 634 | vma->vm_page_prot = vm_get_page_prot(vma->vm_flags); |
0cf2ef46 | 635 | if (shmem->map_wc) |
1cad6292 | 636 | vma->vm_page_prot = pgprot_writecombine(vma->vm_page_prot); |
2194a63a | 637 | |
2194a63a NT |
638 | return 0; |
639 | } | |
640 | EXPORT_SYMBOL_GPL(drm_gem_shmem_mmap); | |
641 | ||
642 | /** | |
643 | * drm_gem_shmem_print_info() - Print &drm_gem_shmem_object info for debugfs | |
a193f3b4 | 644 | * @shmem: shmem GEM object |
2194a63a NT |
645 | * @p: DRM printer |
646 | * @indent: Tab indentation level | |
2194a63a | 647 | */ |
a193f3b4 TZ |
648 | void drm_gem_shmem_print_info(const struct drm_gem_shmem_object *shmem, |
649 | struct drm_printer *p, unsigned int indent) | |
2194a63a | 650 | { |
2194a63a NT |
651 | drm_printf_indent(p, indent, "pages_use_count=%u\n", shmem->pages_use_count); |
652 | drm_printf_indent(p, indent, "vmap_use_count=%u\n", shmem->vmap_use_count); | |
653 | drm_printf_indent(p, indent, "vaddr=%p\n", shmem->vaddr); | |
654 | } | |
655 | EXPORT_SYMBOL(drm_gem_shmem_print_info); | |
656 | ||
657 | /** | |
658 | * drm_gem_shmem_get_sg_table - Provide a scatter/gather table of pinned | |
659 | * pages for a shmem GEM object | |
a193f3b4 | 660 | * @shmem: shmem GEM object |
2194a63a NT |
661 | * |
662 | * This function exports a scatter/gather table suitable for PRIME usage by | |
c7fbcb71 | 663 | * calling the standard DMA mapping API. |
0b638559 DV |
664 | * |
665 | * Drivers who need to acquire an scatter/gather table for objects need to call | |
666 | * drm_gem_shmem_get_pages_sgt() instead. | |
2194a63a NT |
667 | * |
668 | * Returns: | |
2b8428a1 | 669 | * A pointer to the scatter/gather table of pinned pages or error pointer on failure. |
2194a63a | 670 | */ |
a193f3b4 | 671 | struct sg_table *drm_gem_shmem_get_sg_table(struct drm_gem_shmem_object *shmem) |
2194a63a | 672 | { |
a193f3b4 | 673 | struct drm_gem_object *obj = &shmem->base; |
2194a63a | 674 | |
52640835 DV |
675 | WARN_ON(shmem->base.import_attach); |
676 | ||
707d561f | 677 | return drm_prime_pages_to_sg(obj->dev, shmem->pages, obj->size >> PAGE_SHIFT); |
2194a63a NT |
678 | } |
679 | EXPORT_SYMBOL_GPL(drm_gem_shmem_get_sg_table); | |
680 | ||
ddddedaa | 681 | static struct sg_table *drm_gem_shmem_get_pages_sgt_locked(struct drm_gem_shmem_object *shmem) |
2194a63a | 682 | { |
a193f3b4 | 683 | struct drm_gem_object *obj = &shmem->base; |
2194a63a | 684 | int ret; |
2194a63a NT |
685 | struct sg_table *sgt; |
686 | ||
687 | if (shmem->sgt) | |
688 | return shmem->sgt; | |
689 | ||
690 | WARN_ON(obj->import_attach); | |
691 | ||
ddddedaa | 692 | ret = drm_gem_shmem_get_pages_locked(shmem); |
2194a63a NT |
693 | if (ret) |
694 | return ERR_PTR(ret); | |
695 | ||
a193f3b4 | 696 | sgt = drm_gem_shmem_get_sg_table(shmem); |
2194a63a NT |
697 | if (IS_ERR(sgt)) { |
698 | ret = PTR_ERR(sgt); | |
699 | goto err_put_pages; | |
700 | } | |
701 | /* Map the pages for use by the h/w. */ | |
6c6fa39c MS |
702 | ret = dma_map_sgtable(obj->dev->dev, sgt, DMA_BIDIRECTIONAL, 0); |
703 | if (ret) | |
704 | goto err_free_sgt; | |
2194a63a NT |
705 | |
706 | shmem->sgt = sgt; | |
707 | ||
708 | return sgt; | |
709 | ||
6c6fa39c MS |
710 | err_free_sgt: |
711 | sg_free_table(sgt); | |
712 | kfree(sgt); | |
2194a63a | 713 | err_put_pages: |
ddddedaa | 714 | drm_gem_shmem_put_pages_locked(shmem); |
2194a63a NT |
715 | return ERR_PTR(ret); |
716 | } | |
ddddedaa AL |
717 | |
718 | /** | |
719 | * drm_gem_shmem_get_pages_sgt - Pin pages, dma map them, and return a | |
720 | * scatter/gather table for a shmem GEM object. | |
721 | * @shmem: shmem GEM object | |
722 | * | |
723 | * This function returns a scatter/gather table suitable for driver usage. If | |
724 | * the sg table doesn't exist, the pages are pinned, dma-mapped, and a sg | |
725 | * table created. | |
726 | * | |
727 | * This is the main function for drivers to get at backing storage, and it hides | |
728 | * and difference between dma-buf imported and natively allocated objects. | |
729 | * drm_gem_shmem_get_sg_table() should not be directly called by drivers. | |
730 | * | |
731 | * Returns: | |
732 | * A pointer to the scatter/gather table of pinned pages or errno on failure. | |
733 | */ | |
734 | struct sg_table *drm_gem_shmem_get_pages_sgt(struct drm_gem_shmem_object *shmem) | |
735 | { | |
736 | int ret; | |
737 | struct sg_table *sgt; | |
738 | ||
739 | ret = mutex_lock_interruptible(&shmem->pages_lock); | |
740 | if (ret) | |
741 | return ERR_PTR(ret); | |
742 | sgt = drm_gem_shmem_get_pages_sgt_locked(shmem); | |
743 | mutex_unlock(&shmem->pages_lock); | |
744 | ||
745 | return sgt; | |
746 | } | |
747 | EXPORT_SYMBOL(drm_gem_shmem_get_pages_sgt); | |
2194a63a NT |
748 | |
749 | /** | |
750 | * drm_gem_shmem_prime_import_sg_table - Produce a shmem GEM object from | |
751 | * another driver's scatter/gather table of pinned pages | |
752 | * @dev: Device to import into | |
753 | * @attach: DMA-BUF attachment | |
754 | * @sgt: Scatter/gather table of pinned pages | |
755 | * | |
756 | * This function imports a scatter/gather table exported via DMA-BUF by | |
757 | * another driver. Drivers that use the shmem helpers should set this as their | |
758 | * &drm_driver.gem_prime_import_sg_table callback. | |
759 | * | |
760 | * Returns: | |
761 | * A pointer to a newly created GEM object or an ERR_PTR-encoded negative | |
762 | * error code on failure. | |
763 | */ | |
764 | struct drm_gem_object * | |
765 | drm_gem_shmem_prime_import_sg_table(struct drm_device *dev, | |
766 | struct dma_buf_attachment *attach, | |
767 | struct sg_table *sgt) | |
768 | { | |
769 | size_t size = PAGE_ALIGN(attach->dmabuf->size); | |
2194a63a | 770 | struct drm_gem_shmem_object *shmem; |
2194a63a | 771 | |
cfe28f90 | 772 | shmem = __drm_gem_shmem_create(dev, size, true); |
2194a63a NT |
773 | if (IS_ERR(shmem)) |
774 | return ERR_CAST(shmem); | |
775 | ||
2194a63a | 776 | shmem->sgt = sgt; |
2194a63a | 777 | |
46652809 | 778 | drm_dbg_prime(dev, "size = %zu\n", size); |
2194a63a NT |
779 | |
780 | return &shmem->base; | |
2194a63a NT |
781 | } |
782 | EXPORT_SYMBOL_GPL(drm_gem_shmem_prime_import_sg_table); | |
4b2b5e14 TZ |
783 | |
784 | MODULE_DESCRIPTION("DRM SHMEM memory-management helpers"); | |
67505311 | 785 | MODULE_IMPORT_NS(DMA_BUF); |
4b2b5e14 | 786 | MODULE_LICENSE("GPL v2"); |