Loading...
1/* SPDX-License-Identifier: GPL-2.0 OR MIT */
2/**************************************************************************
3 *
4 * Copyright (c) 2006-2009 VMware, Inc., Palo Alto, CA., USA
5 * All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the
9 * "Software"), to deal in the Software without restriction, including
10 * without limitation the rights to use, copy, modify, merge, publish,
11 * distribute, sub license, and/or sell copies of the Software, and to
12 * permit persons to whom the Software is furnished to do so, subject to
13 * the following conditions:
14 *
15 * The above copyright notice and this permission notice (including the
16 * next paragraph) shall be included in all copies or substantial portions
17 * 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 NON-INFRINGEMENT. IN NO EVENT SHALL
22 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
23 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
24 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
25 * USE OR OTHER DEALINGS IN THE SOFTWARE.
26 *
27 **************************************************************************/
28/*
29 * Authors: Thomas Hellstrom <thellstrom-at-vmware-dot-com>
30 */
31
32#define pr_fmt(fmt) "[TTM] " fmt
33
34#include <drm/ttm/ttm_bo.h>
35#include <drm/ttm/ttm_placement.h>
36#include <drm/ttm/ttm_tt.h>
37
38#include <linux/jiffies.h>
39#include <linux/slab.h>
40#include <linux/sched.h>
41#include <linux/mm.h>
42#include <linux/file.h>
43#include <linux/module.h>
44#include <linux/atomic.h>
45#include <linux/dma-resv.h>
46
47#include "ttm_module.h"
48
49static void ttm_bo_mem_space_debug(struct ttm_buffer_object *bo,
50 struct ttm_placement *placement)
51{
52 struct drm_printer p = drm_debug_printer(TTM_PFX);
53 struct ttm_resource_manager *man;
54 int i, mem_type;
55
56 for (i = 0; i < placement->num_placement; i++) {
57 mem_type = placement->placement[i].mem_type;
58 drm_printf(&p, " placement[%d]=0x%08X (%d)\n",
59 i, placement->placement[i].flags, mem_type);
60 man = ttm_manager_type(bo->bdev, mem_type);
61 ttm_resource_manager_debug(man, &p);
62 }
63}
64
65/**
66 * ttm_bo_move_to_lru_tail
67 *
68 * @bo: The buffer object.
69 *
70 * Move this BO to the tail of all lru lists used to lookup and reserve an
71 * object. This function must be called with struct ttm_global::lru_lock
72 * held, and is used to make a BO less likely to be considered for eviction.
73 */
74void ttm_bo_move_to_lru_tail(struct ttm_buffer_object *bo)
75{
76 dma_resv_assert_held(bo->base.resv);
77
78 if (bo->resource)
79 ttm_resource_move_to_lru_tail(bo->resource);
80}
81EXPORT_SYMBOL(ttm_bo_move_to_lru_tail);
82
83/**
84 * ttm_bo_set_bulk_move - update BOs bulk move object
85 *
86 * @bo: The buffer object.
87 * @bulk: bulk move structure
88 *
89 * Update the BOs bulk move object, making sure that resources are added/removed
90 * as well. A bulk move allows to move many resource on the LRU at once,
91 * resulting in much less overhead of maintaining the LRU.
92 * The only requirement is that the resources stay together on the LRU and are
93 * never separated. This is enforces by setting the bulk_move structure on a BO.
94 * ttm_lru_bulk_move_tail() should be used to move all resources to the tail of
95 * their LRU list.
96 */
97void ttm_bo_set_bulk_move(struct ttm_buffer_object *bo,
98 struct ttm_lru_bulk_move *bulk)
99{
100 dma_resv_assert_held(bo->base.resv);
101
102 if (bo->bulk_move == bulk)
103 return;
104
105 spin_lock(&bo->bdev->lru_lock);
106 if (bo->resource)
107 ttm_resource_del_bulk_move(bo->resource, bo);
108 bo->bulk_move = bulk;
109 if (bo->resource)
110 ttm_resource_add_bulk_move(bo->resource, bo);
111 spin_unlock(&bo->bdev->lru_lock);
112}
113EXPORT_SYMBOL(ttm_bo_set_bulk_move);
114
115static int ttm_bo_handle_move_mem(struct ttm_buffer_object *bo,
116 struct ttm_resource *mem, bool evict,
117 struct ttm_operation_ctx *ctx,
118 struct ttm_place *hop)
119{
120 struct ttm_device *bdev = bo->bdev;
121 bool old_use_tt, new_use_tt;
122 int ret;
123
124 old_use_tt = !bo->resource || ttm_manager_type(bdev, bo->resource->mem_type)->use_tt;
125 new_use_tt = ttm_manager_type(bdev, mem->mem_type)->use_tt;
126
127 ttm_bo_unmap_virtual(bo);
128
129 /*
130 * Create and bind a ttm if required.
131 */
132
133 if (new_use_tt) {
134 /* Zero init the new TTM structure if the old location should
135 * have used one as well.
136 */
137 ret = ttm_tt_create(bo, old_use_tt);
138 if (ret)
139 goto out_err;
140
141 if (mem->mem_type != TTM_PL_SYSTEM) {
142 ret = ttm_tt_populate(bo->bdev, bo->ttm, ctx);
143 if (ret)
144 goto out_err;
145 }
146 }
147
148 ret = dma_resv_reserve_fences(bo->base.resv, 1);
149 if (ret)
150 goto out_err;
151
152 ret = bdev->funcs->move(bo, evict, ctx, mem, hop);
153 if (ret) {
154 if (ret == -EMULTIHOP)
155 return ret;
156 goto out_err;
157 }
158
159 ctx->bytes_moved += bo->base.size;
160 return 0;
161
162out_err:
163 if (!old_use_tt)
164 ttm_bo_tt_destroy(bo);
165
166 return ret;
167}
168
169/*
170 * Call bo::reserved.
171 * Will release GPU memory type usage on destruction.
172 * This is the place to put in driver specific hooks to release
173 * driver private resources.
174 * Will release the bo::reserved lock.
175 */
176
177static void ttm_bo_cleanup_memtype_use(struct ttm_buffer_object *bo)
178{
179 if (bo->bdev->funcs->delete_mem_notify)
180 bo->bdev->funcs->delete_mem_notify(bo);
181
182 ttm_bo_tt_destroy(bo);
183 ttm_resource_free(bo, &bo->resource);
184}
185
186static int ttm_bo_individualize_resv(struct ttm_buffer_object *bo)
187{
188 int r;
189
190 if (bo->base.resv == &bo->base._resv)
191 return 0;
192
193 BUG_ON(!dma_resv_trylock(&bo->base._resv));
194
195 r = dma_resv_copy_fences(&bo->base._resv, bo->base.resv);
196 dma_resv_unlock(&bo->base._resv);
197 if (r)
198 return r;
199
200 if (bo->type != ttm_bo_type_sg) {
201 /* This works because the BO is about to be destroyed and nobody
202 * reference it any more. The only tricky case is the trylock on
203 * the resv object while holding the lru_lock.
204 */
205 spin_lock(&bo->bdev->lru_lock);
206 bo->base.resv = &bo->base._resv;
207 spin_unlock(&bo->bdev->lru_lock);
208 }
209
210 return r;
211}
212
213static void ttm_bo_flush_all_fences(struct ttm_buffer_object *bo)
214{
215 struct dma_resv *resv = &bo->base._resv;
216 struct dma_resv_iter cursor;
217 struct dma_fence *fence;
218
219 dma_resv_iter_begin(&cursor, resv, DMA_RESV_USAGE_BOOKKEEP);
220 dma_resv_for_each_fence_unlocked(&cursor, fence) {
221 if (!fence->ops->signaled)
222 dma_fence_enable_sw_signaling(fence);
223 }
224 dma_resv_iter_end(&cursor);
225}
226
227/**
228 * ttm_bo_cleanup_refs
229 * If bo idle, remove from lru lists, and unref.
230 * If not idle, block if possible.
231 *
232 * Must be called with lru_lock and reservation held, this function
233 * will drop the lru lock and optionally the reservation lock before returning.
234 *
235 * @bo: The buffer object to clean-up
236 * @interruptible: Any sleeps should occur interruptibly.
237 * @no_wait_gpu: Never wait for gpu. Return -EBUSY instead.
238 * @unlock_resv: Unlock the reservation lock as well.
239 */
240
241static int ttm_bo_cleanup_refs(struct ttm_buffer_object *bo,
242 bool interruptible, bool no_wait_gpu,
243 bool unlock_resv)
244{
245 struct dma_resv *resv = &bo->base._resv;
246 int ret;
247
248 if (dma_resv_test_signaled(resv, DMA_RESV_USAGE_BOOKKEEP))
249 ret = 0;
250 else
251 ret = -EBUSY;
252
253 if (ret && !no_wait_gpu) {
254 long lret;
255
256 if (unlock_resv)
257 dma_resv_unlock(bo->base.resv);
258 spin_unlock(&bo->bdev->lru_lock);
259
260 lret = dma_resv_wait_timeout(resv, DMA_RESV_USAGE_BOOKKEEP,
261 interruptible,
262 30 * HZ);
263
264 if (lret < 0)
265 return lret;
266 else if (lret == 0)
267 return -EBUSY;
268
269 spin_lock(&bo->bdev->lru_lock);
270 if (unlock_resv && !dma_resv_trylock(bo->base.resv)) {
271 /*
272 * We raced, and lost, someone else holds the reservation now,
273 * and is probably busy in ttm_bo_cleanup_memtype_use.
274 *
275 * Even if it's not the case, because we finished waiting any
276 * delayed destruction would succeed, so just return success
277 * here.
278 */
279 spin_unlock(&bo->bdev->lru_lock);
280 return 0;
281 }
282 ret = 0;
283 }
284
285 if (ret) {
286 if (unlock_resv)
287 dma_resv_unlock(bo->base.resv);
288 spin_unlock(&bo->bdev->lru_lock);
289 return ret;
290 }
291
292 spin_unlock(&bo->bdev->lru_lock);
293 ttm_bo_cleanup_memtype_use(bo);
294
295 if (unlock_resv)
296 dma_resv_unlock(bo->base.resv);
297
298 return 0;
299}
300
301/*
302 * Block for the dma_resv object to become idle, lock the buffer and clean up
303 * the resource and tt object.
304 */
305static void ttm_bo_delayed_delete(struct work_struct *work)
306{
307 struct ttm_buffer_object *bo;
308
309 bo = container_of(work, typeof(*bo), delayed_delete);
310
311 dma_resv_wait_timeout(bo->base.resv, DMA_RESV_USAGE_BOOKKEEP, false,
312 MAX_SCHEDULE_TIMEOUT);
313 dma_resv_lock(bo->base.resv, NULL);
314 ttm_bo_cleanup_memtype_use(bo);
315 dma_resv_unlock(bo->base.resv);
316 ttm_bo_put(bo);
317}
318
319static void ttm_bo_release(struct kref *kref)
320{
321 struct ttm_buffer_object *bo =
322 container_of(kref, struct ttm_buffer_object, kref);
323 struct ttm_device *bdev = bo->bdev;
324 int ret;
325
326 WARN_ON_ONCE(bo->pin_count);
327 WARN_ON_ONCE(bo->bulk_move);
328
329 if (!bo->deleted) {
330 ret = ttm_bo_individualize_resv(bo);
331 if (ret) {
332 /* Last resort, if we fail to allocate memory for the
333 * fences block for the BO to become idle
334 */
335 dma_resv_wait_timeout(bo->base.resv,
336 DMA_RESV_USAGE_BOOKKEEP, false,
337 30 * HZ);
338 }
339
340 if (bo->bdev->funcs->release_notify)
341 bo->bdev->funcs->release_notify(bo);
342
343 drm_vma_offset_remove(bdev->vma_manager, &bo->base.vma_node);
344 ttm_mem_io_free(bdev, bo->resource);
345
346 if (!dma_resv_test_signaled(bo->base.resv,
347 DMA_RESV_USAGE_BOOKKEEP) ||
348 (want_init_on_free() && (bo->ttm != NULL)) ||
349 !dma_resv_trylock(bo->base.resv)) {
350 /* The BO is not idle, resurrect it for delayed destroy */
351 ttm_bo_flush_all_fences(bo);
352 bo->deleted = true;
353
354 spin_lock(&bo->bdev->lru_lock);
355
356 /*
357 * Make pinned bos immediately available to
358 * shrinkers, now that they are queued for
359 * destruction.
360 *
361 * FIXME: QXL is triggering this. Can be removed when the
362 * driver is fixed.
363 */
364 if (bo->pin_count) {
365 bo->pin_count = 0;
366 ttm_resource_move_to_lru_tail(bo->resource);
367 }
368
369 kref_init(&bo->kref);
370 spin_unlock(&bo->bdev->lru_lock);
371
372 INIT_WORK(&bo->delayed_delete, ttm_bo_delayed_delete);
373
374 /* Schedule the worker on the closest NUMA node. This
375 * improves performance since system memory might be
376 * cleared on free and that is best done on a CPU core
377 * close to it.
378 */
379 queue_work_node(bdev->pool.nid, bdev->wq, &bo->delayed_delete);
380 return;
381 }
382
383 ttm_bo_cleanup_memtype_use(bo);
384 dma_resv_unlock(bo->base.resv);
385 }
386
387 atomic_dec(&ttm_glob.bo_count);
388 bo->destroy(bo);
389}
390
391/**
392 * ttm_bo_put
393 *
394 * @bo: The buffer object.
395 *
396 * Unreference a buffer object.
397 */
398void ttm_bo_put(struct ttm_buffer_object *bo)
399{
400 kref_put(&bo->kref, ttm_bo_release);
401}
402EXPORT_SYMBOL(ttm_bo_put);
403
404static int ttm_bo_bounce_temp_buffer(struct ttm_buffer_object *bo,
405 struct ttm_resource **mem,
406 struct ttm_operation_ctx *ctx,
407 struct ttm_place *hop)
408{
409 struct ttm_placement hop_placement;
410 struct ttm_resource *hop_mem;
411 int ret;
412
413 hop_placement.num_placement = hop_placement.num_busy_placement = 1;
414 hop_placement.placement = hop_placement.busy_placement = hop;
415
416 /* find space in the bounce domain */
417 ret = ttm_bo_mem_space(bo, &hop_placement, &hop_mem, ctx);
418 if (ret)
419 return ret;
420 /* move to the bounce domain */
421 ret = ttm_bo_handle_move_mem(bo, hop_mem, false, ctx, NULL);
422 if (ret) {
423 ttm_resource_free(bo, &hop_mem);
424 return ret;
425 }
426 return 0;
427}
428
429static int ttm_bo_evict(struct ttm_buffer_object *bo,
430 struct ttm_operation_ctx *ctx)
431{
432 struct ttm_device *bdev = bo->bdev;
433 struct ttm_resource *evict_mem;
434 struct ttm_placement placement;
435 struct ttm_place hop;
436 int ret = 0;
437
438 memset(&hop, 0, sizeof(hop));
439
440 dma_resv_assert_held(bo->base.resv);
441
442 placement.num_placement = 0;
443 placement.num_busy_placement = 0;
444 bdev->funcs->evict_flags(bo, &placement);
445
446 if (!placement.num_placement && !placement.num_busy_placement) {
447 ret = ttm_bo_wait_ctx(bo, ctx);
448 if (ret)
449 return ret;
450
451 /*
452 * Since we've already synced, this frees backing store
453 * immediately.
454 */
455 return ttm_bo_pipeline_gutting(bo);
456 }
457
458 ret = ttm_bo_mem_space(bo, &placement, &evict_mem, ctx);
459 if (ret) {
460 if (ret != -ERESTARTSYS) {
461 pr_err("Failed to find memory space for buffer 0x%p eviction\n",
462 bo);
463 ttm_bo_mem_space_debug(bo, &placement);
464 }
465 goto out;
466 }
467
468 do {
469 ret = ttm_bo_handle_move_mem(bo, evict_mem, true, ctx, &hop);
470 if (ret != -EMULTIHOP)
471 break;
472
473 ret = ttm_bo_bounce_temp_buffer(bo, &evict_mem, ctx, &hop);
474 } while (!ret);
475
476 if (ret) {
477 ttm_resource_free(bo, &evict_mem);
478 if (ret != -ERESTARTSYS && ret != -EINTR)
479 pr_err("Buffer eviction failed\n");
480 }
481out:
482 return ret;
483}
484
485/**
486 * ttm_bo_eviction_valuable
487 *
488 * @bo: The buffer object to evict
489 * @place: the placement we need to make room for
490 *
491 * Check if it is valuable to evict the BO to make room for the given placement.
492 */
493bool ttm_bo_eviction_valuable(struct ttm_buffer_object *bo,
494 const struct ttm_place *place)
495{
496 struct ttm_resource *res = bo->resource;
497 struct ttm_device *bdev = bo->bdev;
498
499 dma_resv_assert_held(bo->base.resv);
500 if (bo->resource->mem_type == TTM_PL_SYSTEM)
501 return true;
502
503 /* Don't evict this BO if it's outside of the
504 * requested placement range
505 */
506 return ttm_resource_intersects(bdev, res, place, bo->base.size);
507}
508EXPORT_SYMBOL(ttm_bo_eviction_valuable);
509
510/*
511 * Check the target bo is allowable to be evicted or swapout, including cases:
512 *
513 * a. if share same reservation object with ctx->resv, have assumption
514 * reservation objects should already be locked, so not lock again and
515 * return true directly when either the opreation allow_reserved_eviction
516 * or the target bo already is in delayed free list;
517 *
518 * b. Otherwise, trylock it.
519 */
520static bool ttm_bo_evict_swapout_allowable(struct ttm_buffer_object *bo,
521 struct ttm_operation_ctx *ctx,
522 const struct ttm_place *place,
523 bool *locked, bool *busy)
524{
525 bool ret = false;
526
527 if (bo->pin_count) {
528 *locked = false;
529 if (busy)
530 *busy = false;
531 return false;
532 }
533
534 if (bo->base.resv == ctx->resv) {
535 dma_resv_assert_held(bo->base.resv);
536 if (ctx->allow_res_evict)
537 ret = true;
538 *locked = false;
539 if (busy)
540 *busy = false;
541 } else {
542 ret = dma_resv_trylock(bo->base.resv);
543 *locked = ret;
544 if (busy)
545 *busy = !ret;
546 }
547
548 if (ret && place && (bo->resource->mem_type != place->mem_type ||
549 !bo->bdev->funcs->eviction_valuable(bo, place))) {
550 ret = false;
551 if (*locked) {
552 dma_resv_unlock(bo->base.resv);
553 *locked = false;
554 }
555 }
556
557 return ret;
558}
559
560/**
561 * ttm_mem_evict_wait_busy - wait for a busy BO to become available
562 *
563 * @busy_bo: BO which couldn't be locked with trylock
564 * @ctx: operation context
565 * @ticket: acquire ticket
566 *
567 * Try to lock a busy buffer object to avoid failing eviction.
568 */
569static int ttm_mem_evict_wait_busy(struct ttm_buffer_object *busy_bo,
570 struct ttm_operation_ctx *ctx,
571 struct ww_acquire_ctx *ticket)
572{
573 int r;
574
575 if (!busy_bo || !ticket)
576 return -EBUSY;
577
578 if (ctx->interruptible)
579 r = dma_resv_lock_interruptible(busy_bo->base.resv,
580 ticket);
581 else
582 r = dma_resv_lock(busy_bo->base.resv, ticket);
583
584 /*
585 * TODO: It would be better to keep the BO locked until allocation is at
586 * least tried one more time, but that would mean a much larger rework
587 * of TTM.
588 */
589 if (!r)
590 dma_resv_unlock(busy_bo->base.resv);
591
592 return r == -EDEADLK ? -EBUSY : r;
593}
594
595int ttm_mem_evict_first(struct ttm_device *bdev,
596 struct ttm_resource_manager *man,
597 const struct ttm_place *place,
598 struct ttm_operation_ctx *ctx,
599 struct ww_acquire_ctx *ticket)
600{
601 struct ttm_buffer_object *bo = NULL, *busy_bo = NULL;
602 struct ttm_resource_cursor cursor;
603 struct ttm_resource *res;
604 bool locked = false;
605 int ret;
606
607 spin_lock(&bdev->lru_lock);
608 ttm_resource_manager_for_each_res(man, &cursor, res) {
609 bool busy;
610
611 if (!ttm_bo_evict_swapout_allowable(res->bo, ctx, place,
612 &locked, &busy)) {
613 if (busy && !busy_bo && ticket !=
614 dma_resv_locking_ctx(res->bo->base.resv))
615 busy_bo = res->bo;
616 continue;
617 }
618
619 if (ttm_bo_get_unless_zero(res->bo)) {
620 bo = res->bo;
621 break;
622 }
623 if (locked)
624 dma_resv_unlock(res->bo->base.resv);
625 }
626
627 if (!bo) {
628 if (busy_bo && !ttm_bo_get_unless_zero(busy_bo))
629 busy_bo = NULL;
630 spin_unlock(&bdev->lru_lock);
631 ret = ttm_mem_evict_wait_busy(busy_bo, ctx, ticket);
632 if (busy_bo)
633 ttm_bo_put(busy_bo);
634 return ret;
635 }
636
637 if (bo->deleted) {
638 ret = ttm_bo_cleanup_refs(bo, ctx->interruptible,
639 ctx->no_wait_gpu, locked);
640 ttm_bo_put(bo);
641 return ret;
642 }
643
644 spin_unlock(&bdev->lru_lock);
645
646 ret = ttm_bo_evict(bo, ctx);
647 if (locked)
648 ttm_bo_unreserve(bo);
649 else
650 ttm_bo_move_to_lru_tail_unlocked(bo);
651
652 ttm_bo_put(bo);
653 return ret;
654}
655
656/**
657 * ttm_bo_pin - Pin the buffer object.
658 * @bo: The buffer object to pin
659 *
660 * Make sure the buffer is not evicted any more during memory pressure.
661 * @bo must be unpinned again by calling ttm_bo_unpin().
662 */
663void ttm_bo_pin(struct ttm_buffer_object *bo)
664{
665 dma_resv_assert_held(bo->base.resv);
666 WARN_ON_ONCE(!kref_read(&bo->kref));
667 spin_lock(&bo->bdev->lru_lock);
668 if (bo->resource)
669 ttm_resource_del_bulk_move(bo->resource, bo);
670 ++bo->pin_count;
671 spin_unlock(&bo->bdev->lru_lock);
672}
673EXPORT_SYMBOL(ttm_bo_pin);
674
675/**
676 * ttm_bo_unpin - Unpin the buffer object.
677 * @bo: The buffer object to unpin
678 *
679 * Allows the buffer object to be evicted again during memory pressure.
680 */
681void ttm_bo_unpin(struct ttm_buffer_object *bo)
682{
683 dma_resv_assert_held(bo->base.resv);
684 WARN_ON_ONCE(!kref_read(&bo->kref));
685 if (WARN_ON_ONCE(!bo->pin_count))
686 return;
687
688 spin_lock(&bo->bdev->lru_lock);
689 --bo->pin_count;
690 if (bo->resource)
691 ttm_resource_add_bulk_move(bo->resource, bo);
692 spin_unlock(&bo->bdev->lru_lock);
693}
694EXPORT_SYMBOL(ttm_bo_unpin);
695
696/*
697 * Add the last move fence to the BO as kernel dependency and reserve a new
698 * fence slot.
699 */
700static int ttm_bo_add_move_fence(struct ttm_buffer_object *bo,
701 struct ttm_resource_manager *man,
702 struct ttm_resource *mem,
703 bool no_wait_gpu)
704{
705 struct dma_fence *fence;
706 int ret;
707
708 spin_lock(&man->move_lock);
709 fence = dma_fence_get(man->move);
710 spin_unlock(&man->move_lock);
711
712 if (!fence)
713 return 0;
714
715 if (no_wait_gpu) {
716 ret = dma_fence_is_signaled(fence) ? 0 : -EBUSY;
717 dma_fence_put(fence);
718 return ret;
719 }
720
721 dma_resv_add_fence(bo->base.resv, fence, DMA_RESV_USAGE_KERNEL);
722
723 ret = dma_resv_reserve_fences(bo->base.resv, 1);
724 dma_fence_put(fence);
725 return ret;
726}
727
728/*
729 * Repeatedly evict memory from the LRU for @mem_type until we create enough
730 * space, or we've evicted everything and there isn't enough space.
731 */
732static int ttm_bo_mem_force_space(struct ttm_buffer_object *bo,
733 const struct ttm_place *place,
734 struct ttm_resource **mem,
735 struct ttm_operation_ctx *ctx)
736{
737 struct ttm_device *bdev = bo->bdev;
738 struct ttm_resource_manager *man;
739 struct ww_acquire_ctx *ticket;
740 int ret;
741
742 man = ttm_manager_type(bdev, place->mem_type);
743 ticket = dma_resv_locking_ctx(bo->base.resv);
744 do {
745 ret = ttm_resource_alloc(bo, place, mem);
746 if (likely(!ret))
747 break;
748 if (unlikely(ret != -ENOSPC))
749 return ret;
750 ret = ttm_mem_evict_first(bdev, man, place, ctx,
751 ticket);
752 if (unlikely(ret != 0))
753 return ret;
754 } while (1);
755
756 return ttm_bo_add_move_fence(bo, man, *mem, ctx->no_wait_gpu);
757}
758
759/**
760 * ttm_bo_mem_space
761 *
762 * @bo: Pointer to a struct ttm_buffer_object. the data of which
763 * we want to allocate space for.
764 * @placement: Proposed new placement for the buffer object.
765 * @mem: A struct ttm_resource.
766 * @ctx: if and how to sleep, lock buffers and alloc memory
767 *
768 * Allocate memory space for the buffer object pointed to by @bo, using
769 * the placement flags in @placement, potentially evicting other idle buffer objects.
770 * This function may sleep while waiting for space to become available.
771 * Returns:
772 * -EBUSY: No space available (only if no_wait == 1).
773 * -ENOMEM: Could not allocate memory for the buffer object, either due to
774 * fragmentation or concurrent allocators.
775 * -ERESTARTSYS: An interruptible sleep was interrupted by a signal.
776 */
777int ttm_bo_mem_space(struct ttm_buffer_object *bo,
778 struct ttm_placement *placement,
779 struct ttm_resource **mem,
780 struct ttm_operation_ctx *ctx)
781{
782 struct ttm_device *bdev = bo->bdev;
783 bool type_found = false;
784 int i, ret;
785
786 ret = dma_resv_reserve_fences(bo->base.resv, 1);
787 if (unlikely(ret))
788 return ret;
789
790 for (i = 0; i < placement->num_placement; ++i) {
791 const struct ttm_place *place = &placement->placement[i];
792 struct ttm_resource_manager *man;
793
794 man = ttm_manager_type(bdev, place->mem_type);
795 if (!man || !ttm_resource_manager_used(man))
796 continue;
797
798 type_found = true;
799 ret = ttm_resource_alloc(bo, place, mem);
800 if (ret == -ENOSPC)
801 continue;
802 if (unlikely(ret))
803 goto error;
804
805 ret = ttm_bo_add_move_fence(bo, man, *mem, ctx->no_wait_gpu);
806 if (unlikely(ret)) {
807 ttm_resource_free(bo, mem);
808 if (ret == -EBUSY)
809 continue;
810
811 goto error;
812 }
813 return 0;
814 }
815
816 for (i = 0; i < placement->num_busy_placement; ++i) {
817 const struct ttm_place *place = &placement->busy_placement[i];
818 struct ttm_resource_manager *man;
819
820 man = ttm_manager_type(bdev, place->mem_type);
821 if (!man || !ttm_resource_manager_used(man))
822 continue;
823
824 type_found = true;
825 ret = ttm_bo_mem_force_space(bo, place, mem, ctx);
826 if (likely(!ret))
827 return 0;
828
829 if (ret && ret != -EBUSY)
830 goto error;
831 }
832
833 ret = -ENOMEM;
834 if (!type_found) {
835 pr_err(TTM_PFX "No compatible memory type found\n");
836 ret = -EINVAL;
837 }
838
839error:
840 return ret;
841}
842EXPORT_SYMBOL(ttm_bo_mem_space);
843
844static int ttm_bo_move_buffer(struct ttm_buffer_object *bo,
845 struct ttm_placement *placement,
846 struct ttm_operation_ctx *ctx)
847{
848 struct ttm_resource *mem;
849 struct ttm_place hop;
850 int ret;
851
852 dma_resv_assert_held(bo->base.resv);
853
854 /*
855 * Determine where to move the buffer.
856 *
857 * If driver determines move is going to need
858 * an extra step then it will return -EMULTIHOP
859 * and the buffer will be moved to the temporary
860 * stop and the driver will be called to make
861 * the second hop.
862 */
863 ret = ttm_bo_mem_space(bo, placement, &mem, ctx);
864 if (ret)
865 return ret;
866bounce:
867 ret = ttm_bo_handle_move_mem(bo, mem, false, ctx, &hop);
868 if (ret == -EMULTIHOP) {
869 ret = ttm_bo_bounce_temp_buffer(bo, &mem, ctx, &hop);
870 if (ret)
871 goto out;
872 /* try and move to final place now. */
873 goto bounce;
874 }
875out:
876 if (ret)
877 ttm_resource_free(bo, &mem);
878 return ret;
879}
880
881/**
882 * ttm_bo_validate
883 *
884 * @bo: The buffer object.
885 * @placement: Proposed placement for the buffer object.
886 * @ctx: validation parameters.
887 *
888 * Changes placement and caching policy of the buffer object
889 * according proposed placement.
890 * Returns
891 * -EINVAL on invalid proposed placement.
892 * -ENOMEM on out-of-memory condition.
893 * -EBUSY if no_wait is true and buffer busy.
894 * -ERESTARTSYS if interrupted by a signal.
895 */
896int ttm_bo_validate(struct ttm_buffer_object *bo,
897 struct ttm_placement *placement,
898 struct ttm_operation_ctx *ctx)
899{
900 int ret;
901
902 dma_resv_assert_held(bo->base.resv);
903
904 /*
905 * Remove the backing store if no placement is given.
906 */
907 if (!placement->num_placement && !placement->num_busy_placement)
908 return ttm_bo_pipeline_gutting(bo);
909
910 /* Check whether we need to move buffer. */
911 if (bo->resource && ttm_resource_compat(bo->resource, placement))
912 return 0;
913
914 /* Moving of pinned BOs is forbidden */
915 if (bo->pin_count)
916 return -EINVAL;
917
918 ret = ttm_bo_move_buffer(bo, placement, ctx);
919 if (ret)
920 return ret;
921
922 /*
923 * We might need to add a TTM.
924 */
925 if (!bo->resource || bo->resource->mem_type == TTM_PL_SYSTEM) {
926 ret = ttm_tt_create(bo, true);
927 if (ret)
928 return ret;
929 }
930 return 0;
931}
932EXPORT_SYMBOL(ttm_bo_validate);
933
934/**
935 * ttm_bo_init_reserved
936 *
937 * @bdev: Pointer to a ttm_device struct.
938 * @bo: Pointer to a ttm_buffer_object to be initialized.
939 * @type: Requested type of buffer object.
940 * @placement: Initial placement for buffer object.
941 * @alignment: Data alignment in pages.
942 * @ctx: TTM operation context for memory allocation.
943 * @sg: Scatter-gather table.
944 * @resv: Pointer to a dma_resv, or NULL to let ttm allocate one.
945 * @destroy: Destroy function. Use NULL for kfree().
946 *
947 * This function initializes a pre-allocated struct ttm_buffer_object.
948 * As this object may be part of a larger structure, this function,
949 * together with the @destroy function, enables driver-specific objects
950 * derived from a ttm_buffer_object.
951 *
952 * On successful return, the caller owns an object kref to @bo. The kref and
953 * list_kref are usually set to 1, but note that in some situations, other
954 * tasks may already be holding references to @bo as well.
955 * Furthermore, if resv == NULL, the buffer's reservation lock will be held,
956 * and it is the caller's responsibility to call ttm_bo_unreserve.
957 *
958 * If a failure occurs, the function will call the @destroy function. Thus,
959 * after a failure, dereferencing @bo is illegal and will likely cause memory
960 * corruption.
961 *
962 * Returns
963 * -ENOMEM: Out of memory.
964 * -EINVAL: Invalid placement flags.
965 * -ERESTARTSYS: Interrupted by signal while sleeping waiting for resources.
966 */
967int ttm_bo_init_reserved(struct ttm_device *bdev, struct ttm_buffer_object *bo,
968 enum ttm_bo_type type, struct ttm_placement *placement,
969 uint32_t alignment, struct ttm_operation_ctx *ctx,
970 struct sg_table *sg, struct dma_resv *resv,
971 void (*destroy) (struct ttm_buffer_object *))
972{
973 int ret;
974
975 kref_init(&bo->kref);
976 bo->bdev = bdev;
977 bo->type = type;
978 bo->page_alignment = alignment;
979 bo->destroy = destroy;
980 bo->pin_count = 0;
981 bo->sg = sg;
982 bo->bulk_move = NULL;
983 if (resv)
984 bo->base.resv = resv;
985 else
986 bo->base.resv = &bo->base._resv;
987 atomic_inc(&ttm_glob.bo_count);
988
989 /*
990 * For ttm_bo_type_device buffers, allocate
991 * address space from the device.
992 */
993 if (bo->type == ttm_bo_type_device || bo->type == ttm_bo_type_sg) {
994 ret = drm_vma_offset_add(bdev->vma_manager, &bo->base.vma_node,
995 PFN_UP(bo->base.size));
996 if (ret)
997 goto err_put;
998 }
999
1000 /* passed reservation objects should already be locked,
1001 * since otherwise lockdep will be angered in radeon.
1002 */
1003 if (!resv)
1004 WARN_ON(!dma_resv_trylock(bo->base.resv));
1005 else
1006 dma_resv_assert_held(resv);
1007
1008 ret = ttm_bo_validate(bo, placement, ctx);
1009 if (unlikely(ret))
1010 goto err_unlock;
1011
1012 return 0;
1013
1014err_unlock:
1015 if (!resv)
1016 dma_resv_unlock(bo->base.resv);
1017
1018err_put:
1019 ttm_bo_put(bo);
1020 return ret;
1021}
1022EXPORT_SYMBOL(ttm_bo_init_reserved);
1023
1024/**
1025 * ttm_bo_init_validate
1026 *
1027 * @bdev: Pointer to a ttm_device struct.
1028 * @bo: Pointer to a ttm_buffer_object to be initialized.
1029 * @type: Requested type of buffer object.
1030 * @placement: Initial placement for buffer object.
1031 * @alignment: Data alignment in pages.
1032 * @interruptible: If needing to sleep to wait for GPU resources,
1033 * sleep interruptible.
1034 * pinned in physical memory. If this behaviour is not desired, this member
1035 * holds a pointer to a persistent shmem object. Typically, this would
1036 * point to the shmem object backing a GEM object if TTM is used to back a
1037 * GEM user interface.
1038 * @sg: Scatter-gather table.
1039 * @resv: Pointer to a dma_resv, or NULL to let ttm allocate one.
1040 * @destroy: Destroy function. Use NULL for kfree().
1041 *
1042 * This function initializes a pre-allocated struct ttm_buffer_object.
1043 * As this object may be part of a larger structure, this function,
1044 * together with the @destroy function,
1045 * enables driver-specific objects derived from a ttm_buffer_object.
1046 *
1047 * On successful return, the caller owns an object kref to @bo. The kref and
1048 * list_kref are usually set to 1, but note that in some situations, other
1049 * tasks may already be holding references to @bo as well.
1050 *
1051 * If a failure occurs, the function will call the @destroy function, Thus,
1052 * after a failure, dereferencing @bo is illegal and will likely cause memory
1053 * corruption.
1054 *
1055 * Returns
1056 * -ENOMEM: Out of memory.
1057 * -EINVAL: Invalid placement flags.
1058 * -ERESTARTSYS: Interrupted by signal while sleeping waiting for resources.
1059 */
1060int ttm_bo_init_validate(struct ttm_device *bdev, struct ttm_buffer_object *bo,
1061 enum ttm_bo_type type, struct ttm_placement *placement,
1062 uint32_t alignment, bool interruptible,
1063 struct sg_table *sg, struct dma_resv *resv,
1064 void (*destroy) (struct ttm_buffer_object *))
1065{
1066 struct ttm_operation_ctx ctx = { interruptible, false };
1067 int ret;
1068
1069 ret = ttm_bo_init_reserved(bdev, bo, type, placement, alignment, &ctx,
1070 sg, resv, destroy);
1071 if (ret)
1072 return ret;
1073
1074 if (!resv)
1075 ttm_bo_unreserve(bo);
1076
1077 return 0;
1078}
1079EXPORT_SYMBOL(ttm_bo_init_validate);
1080
1081/*
1082 * buffer object vm functions.
1083 */
1084
1085/**
1086 * ttm_bo_unmap_virtual
1087 *
1088 * @bo: tear down the virtual mappings for this BO
1089 */
1090void ttm_bo_unmap_virtual(struct ttm_buffer_object *bo)
1091{
1092 struct ttm_device *bdev = bo->bdev;
1093
1094 drm_vma_node_unmap(&bo->base.vma_node, bdev->dev_mapping);
1095 ttm_mem_io_free(bdev, bo->resource);
1096}
1097EXPORT_SYMBOL(ttm_bo_unmap_virtual);
1098
1099/**
1100 * ttm_bo_wait_ctx - wait for buffer idle.
1101 *
1102 * @bo: The buffer object.
1103 * @ctx: defines how to wait
1104 *
1105 * Waits for the buffer to be idle. Used timeout depends on the context.
1106 * Returns -EBUSY if wait timed outt, -ERESTARTSYS if interrupted by a signal or
1107 * zero on success.
1108 */
1109int ttm_bo_wait_ctx(struct ttm_buffer_object *bo, struct ttm_operation_ctx *ctx)
1110{
1111 long ret;
1112
1113 if (ctx->no_wait_gpu) {
1114 if (dma_resv_test_signaled(bo->base.resv,
1115 DMA_RESV_USAGE_BOOKKEEP))
1116 return 0;
1117 else
1118 return -EBUSY;
1119 }
1120
1121 ret = dma_resv_wait_timeout(bo->base.resv, DMA_RESV_USAGE_BOOKKEEP,
1122 ctx->interruptible, 15 * HZ);
1123 if (unlikely(ret < 0))
1124 return ret;
1125 if (unlikely(ret == 0))
1126 return -EBUSY;
1127 return 0;
1128}
1129EXPORT_SYMBOL(ttm_bo_wait_ctx);
1130
1131int ttm_bo_swapout(struct ttm_buffer_object *bo, struct ttm_operation_ctx *ctx,
1132 gfp_t gfp_flags)
1133{
1134 struct ttm_place place;
1135 bool locked;
1136 long ret;
1137
1138 /*
1139 * While the bo may already reside in SYSTEM placement, set
1140 * SYSTEM as new placement to cover also the move further below.
1141 * The driver may use the fact that we're moving from SYSTEM
1142 * as an indication that we're about to swap out.
1143 */
1144 memset(&place, 0, sizeof(place));
1145 place.mem_type = bo->resource->mem_type;
1146 if (!ttm_bo_evict_swapout_allowable(bo, ctx, &place, &locked, NULL))
1147 return -EBUSY;
1148
1149 if (!bo->ttm || !ttm_tt_is_populated(bo->ttm) ||
1150 bo->ttm->page_flags & TTM_TT_FLAG_EXTERNAL ||
1151 bo->ttm->page_flags & TTM_TT_FLAG_SWAPPED ||
1152 !ttm_bo_get_unless_zero(bo)) {
1153 if (locked)
1154 dma_resv_unlock(bo->base.resv);
1155 return -EBUSY;
1156 }
1157
1158 if (bo->deleted) {
1159 ret = ttm_bo_cleanup_refs(bo, false, false, locked);
1160 ttm_bo_put(bo);
1161 return ret == -EBUSY ? -ENOSPC : ret;
1162 }
1163
1164 /* TODO: Cleanup the locking */
1165 spin_unlock(&bo->bdev->lru_lock);
1166
1167 /*
1168 * Move to system cached
1169 */
1170 if (bo->resource->mem_type != TTM_PL_SYSTEM) {
1171 struct ttm_resource *evict_mem;
1172 struct ttm_place hop;
1173
1174 memset(&hop, 0, sizeof(hop));
1175 place.mem_type = TTM_PL_SYSTEM;
1176 ret = ttm_resource_alloc(bo, &place, &evict_mem);
1177 if (unlikely(ret))
1178 goto out;
1179
1180 ret = ttm_bo_handle_move_mem(bo, evict_mem, true, ctx, &hop);
1181 if (unlikely(ret != 0)) {
1182 WARN(ret == -EMULTIHOP, "Unexpected multihop in swaput - likely driver bug.\n");
1183 ttm_resource_free(bo, &evict_mem);
1184 goto out;
1185 }
1186 }
1187
1188 /*
1189 * Make sure BO is idle.
1190 */
1191 ret = ttm_bo_wait_ctx(bo, ctx);
1192 if (unlikely(ret != 0))
1193 goto out;
1194
1195 ttm_bo_unmap_virtual(bo);
1196
1197 /*
1198 * Swap out. Buffer will be swapped in again as soon as
1199 * anyone tries to access a ttm page.
1200 */
1201 if (bo->bdev->funcs->swap_notify)
1202 bo->bdev->funcs->swap_notify(bo);
1203
1204 if (ttm_tt_is_populated(bo->ttm))
1205 ret = ttm_tt_swapout(bo->bdev, bo->ttm, gfp_flags);
1206out:
1207
1208 /*
1209 * Unreserve without putting on LRU to avoid swapping out an
1210 * already swapped buffer.
1211 */
1212 if (locked)
1213 dma_resv_unlock(bo->base.resv);
1214 ttm_bo_put(bo);
1215 return ret == -EBUSY ? -ENOSPC : ret;
1216}
1217
1218void ttm_bo_tt_destroy(struct ttm_buffer_object *bo)
1219{
1220 if (bo->ttm == NULL)
1221 return;
1222
1223 ttm_tt_unpopulate(bo->bdev, bo->ttm);
1224 ttm_tt_destroy(bo->bdev, bo->ttm);
1225 bo->ttm = NULL;
1226}
1/* SPDX-License-Identifier: GPL-2.0 OR MIT */
2/**************************************************************************
3 *
4 * Copyright (c) 2006-2009 VMware, Inc., Palo Alto, CA., USA
5 * All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the
9 * "Software"), to deal in the Software without restriction, including
10 * without limitation the rights to use, copy, modify, merge, publish,
11 * distribute, sub license, and/or sell copies of the Software, and to
12 * permit persons to whom the Software is furnished to do so, subject to
13 * the following conditions:
14 *
15 * The above copyright notice and this permission notice (including the
16 * next paragraph) shall be included in all copies or substantial portions
17 * 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 NON-INFRINGEMENT. IN NO EVENT SHALL
22 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
23 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
24 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
25 * USE OR OTHER DEALINGS IN THE SOFTWARE.
26 *
27 **************************************************************************/
28/*
29 * Authors: Thomas Hellstrom <thellstrom-at-vmware-dot-com>
30 */
31
32#define pr_fmt(fmt) "[TTM] " fmt
33
34#include <drm/ttm/ttm_bo_driver.h>
35#include <drm/ttm/ttm_placement.h>
36#include <linux/jiffies.h>
37#include <linux/slab.h>
38#include <linux/sched.h>
39#include <linux/mm.h>
40#include <linux/file.h>
41#include <linux/module.h>
42#include <linux/atomic.h>
43#include <linux/dma-resv.h>
44
45#include "ttm_module.h"
46
47static void ttm_bo_mem_space_debug(struct ttm_buffer_object *bo,
48 struct ttm_placement *placement)
49{
50 struct drm_printer p = drm_debug_printer(TTM_PFX);
51 struct ttm_resource_manager *man;
52 int i, mem_type;
53
54 for (i = 0; i < placement->num_placement; i++) {
55 mem_type = placement->placement[i].mem_type;
56 drm_printf(&p, " placement[%d]=0x%08X (%d)\n",
57 i, placement->placement[i].flags, mem_type);
58 man = ttm_manager_type(bo->bdev, mem_type);
59 ttm_resource_manager_debug(man, &p);
60 }
61}
62
63/**
64 * ttm_bo_move_to_lru_tail
65 *
66 * @bo: The buffer object.
67 *
68 * Move this BO to the tail of all lru lists used to lookup and reserve an
69 * object. This function must be called with struct ttm_global::lru_lock
70 * held, and is used to make a BO less likely to be considered for eviction.
71 */
72void ttm_bo_move_to_lru_tail(struct ttm_buffer_object *bo)
73{
74 dma_resv_assert_held(bo->base.resv);
75
76 if (bo->resource)
77 ttm_resource_move_to_lru_tail(bo->resource);
78}
79EXPORT_SYMBOL(ttm_bo_move_to_lru_tail);
80
81/**
82 * ttm_bo_set_bulk_move - update BOs bulk move object
83 *
84 * @bo: The buffer object.
85 *
86 * Update the BOs bulk move object, making sure that resources are added/removed
87 * as well. A bulk move allows to move many resource on the LRU at once,
88 * resulting in much less overhead of maintaining the LRU.
89 * The only requirement is that the resources stay together on the LRU and are
90 * never separated. This is enforces by setting the bulk_move structure on a BO.
91 * ttm_lru_bulk_move_tail() should be used to move all resources to the tail of
92 * their LRU list.
93 */
94void ttm_bo_set_bulk_move(struct ttm_buffer_object *bo,
95 struct ttm_lru_bulk_move *bulk)
96{
97 dma_resv_assert_held(bo->base.resv);
98
99 if (bo->bulk_move == bulk)
100 return;
101
102 spin_lock(&bo->bdev->lru_lock);
103 if (bo->resource)
104 ttm_resource_del_bulk_move(bo->resource, bo);
105 bo->bulk_move = bulk;
106 if (bo->resource)
107 ttm_resource_add_bulk_move(bo->resource, bo);
108 spin_unlock(&bo->bdev->lru_lock);
109}
110EXPORT_SYMBOL(ttm_bo_set_bulk_move);
111
112static int ttm_bo_handle_move_mem(struct ttm_buffer_object *bo,
113 struct ttm_resource *mem, bool evict,
114 struct ttm_operation_ctx *ctx,
115 struct ttm_place *hop)
116{
117 struct ttm_device *bdev = bo->bdev;
118 bool old_use_tt, new_use_tt;
119 int ret;
120
121 old_use_tt = bo->resource &&
122 ttm_manager_type(bdev, bo->resource->mem_type)->use_tt;
123 new_use_tt = ttm_manager_type(bdev, mem->mem_type)->use_tt;
124
125 ttm_bo_unmap_virtual(bo);
126
127 /*
128 * Create and bind a ttm if required.
129 */
130
131 if (new_use_tt) {
132 /* Zero init the new TTM structure if the old location should
133 * have used one as well.
134 */
135 ret = ttm_tt_create(bo, old_use_tt);
136 if (ret)
137 goto out_err;
138
139 if (mem->mem_type != TTM_PL_SYSTEM) {
140 ret = ttm_tt_populate(bo->bdev, bo->ttm, ctx);
141 if (ret)
142 goto out_err;
143 }
144 }
145
146 ret = dma_resv_reserve_fences(bo->base.resv, 1);
147 if (ret)
148 goto out_err;
149
150 ret = bdev->funcs->move(bo, evict, ctx, mem, hop);
151 if (ret) {
152 if (ret == -EMULTIHOP)
153 return ret;
154 goto out_err;
155 }
156
157 ctx->bytes_moved += bo->base.size;
158 return 0;
159
160out_err:
161 if (!old_use_tt)
162 ttm_bo_tt_destroy(bo);
163
164 return ret;
165}
166
167/*
168 * Call bo::reserved.
169 * Will release GPU memory type usage on destruction.
170 * This is the place to put in driver specific hooks to release
171 * driver private resources.
172 * Will release the bo::reserved lock.
173 */
174
175static void ttm_bo_cleanup_memtype_use(struct ttm_buffer_object *bo)
176{
177 if (bo->bdev->funcs->delete_mem_notify)
178 bo->bdev->funcs->delete_mem_notify(bo);
179
180 ttm_bo_tt_destroy(bo);
181 ttm_resource_free(bo, &bo->resource);
182}
183
184static int ttm_bo_individualize_resv(struct ttm_buffer_object *bo)
185{
186 int r;
187
188 if (bo->base.resv == &bo->base._resv)
189 return 0;
190
191 BUG_ON(!dma_resv_trylock(&bo->base._resv));
192
193 r = dma_resv_copy_fences(&bo->base._resv, bo->base.resv);
194 dma_resv_unlock(&bo->base._resv);
195 if (r)
196 return r;
197
198 if (bo->type != ttm_bo_type_sg) {
199 /* This works because the BO is about to be destroyed and nobody
200 * reference it any more. The only tricky case is the trylock on
201 * the resv object while holding the lru_lock.
202 */
203 spin_lock(&bo->bdev->lru_lock);
204 bo->base.resv = &bo->base._resv;
205 spin_unlock(&bo->bdev->lru_lock);
206 }
207
208 return r;
209}
210
211static void ttm_bo_flush_all_fences(struct ttm_buffer_object *bo)
212{
213 struct dma_resv *resv = &bo->base._resv;
214 struct dma_resv_iter cursor;
215 struct dma_fence *fence;
216
217 dma_resv_iter_begin(&cursor, resv, DMA_RESV_USAGE_BOOKKEEP);
218 dma_resv_for_each_fence_unlocked(&cursor, fence) {
219 if (!fence->ops->signaled)
220 dma_fence_enable_sw_signaling(fence);
221 }
222 dma_resv_iter_end(&cursor);
223}
224
225/**
226 * ttm_bo_cleanup_refs
227 * If bo idle, remove from lru lists, and unref.
228 * If not idle, block if possible.
229 *
230 * Must be called with lru_lock and reservation held, this function
231 * will drop the lru lock and optionally the reservation lock before returning.
232 *
233 * @bo: The buffer object to clean-up
234 * @interruptible: Any sleeps should occur interruptibly.
235 * @no_wait_gpu: Never wait for gpu. Return -EBUSY instead.
236 * @unlock_resv: Unlock the reservation lock as well.
237 */
238
239static int ttm_bo_cleanup_refs(struct ttm_buffer_object *bo,
240 bool interruptible, bool no_wait_gpu,
241 bool unlock_resv)
242{
243 struct dma_resv *resv = &bo->base._resv;
244 int ret;
245
246 if (dma_resv_test_signaled(resv, DMA_RESV_USAGE_BOOKKEEP))
247 ret = 0;
248 else
249 ret = -EBUSY;
250
251 if (ret && !no_wait_gpu) {
252 long lret;
253
254 if (unlock_resv)
255 dma_resv_unlock(bo->base.resv);
256 spin_unlock(&bo->bdev->lru_lock);
257
258 lret = dma_resv_wait_timeout(resv, DMA_RESV_USAGE_BOOKKEEP,
259 interruptible,
260 30 * HZ);
261
262 if (lret < 0)
263 return lret;
264 else if (lret == 0)
265 return -EBUSY;
266
267 spin_lock(&bo->bdev->lru_lock);
268 if (unlock_resv && !dma_resv_trylock(bo->base.resv)) {
269 /*
270 * We raced, and lost, someone else holds the reservation now,
271 * and is probably busy in ttm_bo_cleanup_memtype_use.
272 *
273 * Even if it's not the case, because we finished waiting any
274 * delayed destruction would succeed, so just return success
275 * here.
276 */
277 spin_unlock(&bo->bdev->lru_lock);
278 return 0;
279 }
280 ret = 0;
281 }
282
283 if (ret || unlikely(list_empty(&bo->ddestroy))) {
284 if (unlock_resv)
285 dma_resv_unlock(bo->base.resv);
286 spin_unlock(&bo->bdev->lru_lock);
287 return ret;
288 }
289
290 list_del_init(&bo->ddestroy);
291 spin_unlock(&bo->bdev->lru_lock);
292 ttm_bo_cleanup_memtype_use(bo);
293
294 if (unlock_resv)
295 dma_resv_unlock(bo->base.resv);
296
297 ttm_bo_put(bo);
298
299 return 0;
300}
301
302/*
303 * Traverse the delayed list, and call ttm_bo_cleanup_refs on all
304 * encountered buffers.
305 */
306bool ttm_bo_delayed_delete(struct ttm_device *bdev, bool remove_all)
307{
308 struct list_head removed;
309 bool empty;
310
311 INIT_LIST_HEAD(&removed);
312
313 spin_lock(&bdev->lru_lock);
314 while (!list_empty(&bdev->ddestroy)) {
315 struct ttm_buffer_object *bo;
316
317 bo = list_first_entry(&bdev->ddestroy, struct ttm_buffer_object,
318 ddestroy);
319 list_move_tail(&bo->ddestroy, &removed);
320 if (!ttm_bo_get_unless_zero(bo))
321 continue;
322
323 if (remove_all || bo->base.resv != &bo->base._resv) {
324 spin_unlock(&bdev->lru_lock);
325 dma_resv_lock(bo->base.resv, NULL);
326
327 spin_lock(&bdev->lru_lock);
328 ttm_bo_cleanup_refs(bo, false, !remove_all, true);
329
330 } else if (dma_resv_trylock(bo->base.resv)) {
331 ttm_bo_cleanup_refs(bo, false, !remove_all, true);
332 } else {
333 spin_unlock(&bdev->lru_lock);
334 }
335
336 ttm_bo_put(bo);
337 spin_lock(&bdev->lru_lock);
338 }
339 list_splice_tail(&removed, &bdev->ddestroy);
340 empty = list_empty(&bdev->ddestroy);
341 spin_unlock(&bdev->lru_lock);
342
343 return empty;
344}
345
346static void ttm_bo_release(struct kref *kref)
347{
348 struct ttm_buffer_object *bo =
349 container_of(kref, struct ttm_buffer_object, kref);
350 struct ttm_device *bdev = bo->bdev;
351 int ret;
352
353 WARN_ON_ONCE(bo->pin_count);
354 WARN_ON_ONCE(bo->bulk_move);
355
356 if (!bo->deleted) {
357 ret = ttm_bo_individualize_resv(bo);
358 if (ret) {
359 /* Last resort, if we fail to allocate memory for the
360 * fences block for the BO to become idle
361 */
362 dma_resv_wait_timeout(bo->base.resv,
363 DMA_RESV_USAGE_BOOKKEEP, false,
364 30 * HZ);
365 }
366
367 if (bo->bdev->funcs->release_notify)
368 bo->bdev->funcs->release_notify(bo);
369
370 drm_vma_offset_remove(bdev->vma_manager, &bo->base.vma_node);
371 ttm_mem_io_free(bdev, bo->resource);
372 }
373
374 if (!dma_resv_test_signaled(bo->base.resv, DMA_RESV_USAGE_BOOKKEEP) ||
375 !dma_resv_trylock(bo->base.resv)) {
376 /* The BO is not idle, resurrect it for delayed destroy */
377 ttm_bo_flush_all_fences(bo);
378 bo->deleted = true;
379
380 spin_lock(&bo->bdev->lru_lock);
381
382 /*
383 * Make pinned bos immediately available to
384 * shrinkers, now that they are queued for
385 * destruction.
386 *
387 * FIXME: QXL is triggering this. Can be removed when the
388 * driver is fixed.
389 */
390 if (bo->pin_count) {
391 bo->pin_count = 0;
392 ttm_resource_move_to_lru_tail(bo->resource);
393 }
394
395 kref_init(&bo->kref);
396 list_add_tail(&bo->ddestroy, &bdev->ddestroy);
397 spin_unlock(&bo->bdev->lru_lock);
398
399 schedule_delayed_work(&bdev->wq,
400 ((HZ / 100) < 1) ? 1 : HZ / 100);
401 return;
402 }
403
404 spin_lock(&bo->bdev->lru_lock);
405 list_del(&bo->ddestroy);
406 spin_unlock(&bo->bdev->lru_lock);
407
408 ttm_bo_cleanup_memtype_use(bo);
409 dma_resv_unlock(bo->base.resv);
410
411 atomic_dec(&ttm_glob.bo_count);
412 bo->destroy(bo);
413}
414
415void ttm_bo_put(struct ttm_buffer_object *bo)
416{
417 kref_put(&bo->kref, ttm_bo_release);
418}
419EXPORT_SYMBOL(ttm_bo_put);
420
421int ttm_bo_lock_delayed_workqueue(struct ttm_device *bdev)
422{
423 return cancel_delayed_work_sync(&bdev->wq);
424}
425EXPORT_SYMBOL(ttm_bo_lock_delayed_workqueue);
426
427void ttm_bo_unlock_delayed_workqueue(struct ttm_device *bdev, int resched)
428{
429 if (resched)
430 schedule_delayed_work(&bdev->wq,
431 ((HZ / 100) < 1) ? 1 : HZ / 100);
432}
433EXPORT_SYMBOL(ttm_bo_unlock_delayed_workqueue);
434
435static int ttm_bo_bounce_temp_buffer(struct ttm_buffer_object *bo,
436 struct ttm_resource **mem,
437 struct ttm_operation_ctx *ctx,
438 struct ttm_place *hop)
439{
440 struct ttm_placement hop_placement;
441 struct ttm_resource *hop_mem;
442 int ret;
443
444 hop_placement.num_placement = hop_placement.num_busy_placement = 1;
445 hop_placement.placement = hop_placement.busy_placement = hop;
446
447 /* find space in the bounce domain */
448 ret = ttm_bo_mem_space(bo, &hop_placement, &hop_mem, ctx);
449 if (ret)
450 return ret;
451 /* move to the bounce domain */
452 ret = ttm_bo_handle_move_mem(bo, hop_mem, false, ctx, NULL);
453 if (ret) {
454 ttm_resource_free(bo, &hop_mem);
455 return ret;
456 }
457 return 0;
458}
459
460static int ttm_bo_evict(struct ttm_buffer_object *bo,
461 struct ttm_operation_ctx *ctx)
462{
463 struct ttm_device *bdev = bo->bdev;
464 struct ttm_resource *evict_mem;
465 struct ttm_placement placement;
466 struct ttm_place hop;
467 int ret = 0;
468
469 memset(&hop, 0, sizeof(hop));
470
471 dma_resv_assert_held(bo->base.resv);
472
473 placement.num_placement = 0;
474 placement.num_busy_placement = 0;
475 bdev->funcs->evict_flags(bo, &placement);
476
477 if (!placement.num_placement && !placement.num_busy_placement) {
478 ret = ttm_bo_wait(bo, true, false);
479 if (ret)
480 return ret;
481
482 /*
483 * Since we've already synced, this frees backing store
484 * immediately.
485 */
486 return ttm_bo_pipeline_gutting(bo);
487 }
488
489 ret = ttm_bo_mem_space(bo, &placement, &evict_mem, ctx);
490 if (ret) {
491 if (ret != -ERESTARTSYS) {
492 pr_err("Failed to find memory space for buffer 0x%p eviction\n",
493 bo);
494 ttm_bo_mem_space_debug(bo, &placement);
495 }
496 goto out;
497 }
498
499bounce:
500 ret = ttm_bo_handle_move_mem(bo, evict_mem, true, ctx, &hop);
501 if (ret == -EMULTIHOP) {
502 ret = ttm_bo_bounce_temp_buffer(bo, &evict_mem, ctx, &hop);
503 if (ret) {
504 pr_err("Buffer eviction failed\n");
505 ttm_resource_free(bo, &evict_mem);
506 goto out;
507 }
508 /* try and move to final place now. */
509 goto bounce;
510 }
511out:
512 return ret;
513}
514
515bool ttm_bo_eviction_valuable(struct ttm_buffer_object *bo,
516 const struct ttm_place *place)
517{
518 struct ttm_resource *res = bo->resource;
519 struct ttm_device *bdev = bo->bdev;
520
521 dma_resv_assert_held(bo->base.resv);
522 if (bo->resource->mem_type == TTM_PL_SYSTEM)
523 return true;
524
525 /* Don't evict this BO if it's outside of the
526 * requested placement range
527 */
528 return ttm_resource_intersects(bdev, res, place, bo->base.size);
529}
530EXPORT_SYMBOL(ttm_bo_eviction_valuable);
531
532/*
533 * Check the target bo is allowable to be evicted or swapout, including cases:
534 *
535 * a. if share same reservation object with ctx->resv, have assumption
536 * reservation objects should already be locked, so not lock again and
537 * return true directly when either the opreation allow_reserved_eviction
538 * or the target bo already is in delayed free list;
539 *
540 * b. Otherwise, trylock it.
541 */
542static bool ttm_bo_evict_swapout_allowable(struct ttm_buffer_object *bo,
543 struct ttm_operation_ctx *ctx,
544 const struct ttm_place *place,
545 bool *locked, bool *busy)
546{
547 bool ret = false;
548
549 if (bo->base.resv == ctx->resv) {
550 dma_resv_assert_held(bo->base.resv);
551 if (ctx->allow_res_evict)
552 ret = true;
553 *locked = false;
554 if (busy)
555 *busy = false;
556 } else {
557 ret = dma_resv_trylock(bo->base.resv);
558 *locked = ret;
559 if (busy)
560 *busy = !ret;
561 }
562
563 if (ret && place && (bo->resource->mem_type != place->mem_type ||
564 !bo->bdev->funcs->eviction_valuable(bo, place))) {
565 ret = false;
566 if (*locked) {
567 dma_resv_unlock(bo->base.resv);
568 *locked = false;
569 }
570 }
571
572 return ret;
573}
574
575/**
576 * ttm_mem_evict_wait_busy - wait for a busy BO to become available
577 *
578 * @busy_bo: BO which couldn't be locked with trylock
579 * @ctx: operation context
580 * @ticket: acquire ticket
581 *
582 * Try to lock a busy buffer object to avoid failing eviction.
583 */
584static int ttm_mem_evict_wait_busy(struct ttm_buffer_object *busy_bo,
585 struct ttm_operation_ctx *ctx,
586 struct ww_acquire_ctx *ticket)
587{
588 int r;
589
590 if (!busy_bo || !ticket)
591 return -EBUSY;
592
593 if (ctx->interruptible)
594 r = dma_resv_lock_interruptible(busy_bo->base.resv,
595 ticket);
596 else
597 r = dma_resv_lock(busy_bo->base.resv, ticket);
598
599 /*
600 * TODO: It would be better to keep the BO locked until allocation is at
601 * least tried one more time, but that would mean a much larger rework
602 * of TTM.
603 */
604 if (!r)
605 dma_resv_unlock(busy_bo->base.resv);
606
607 return r == -EDEADLK ? -EBUSY : r;
608}
609
610int ttm_mem_evict_first(struct ttm_device *bdev,
611 struct ttm_resource_manager *man,
612 const struct ttm_place *place,
613 struct ttm_operation_ctx *ctx,
614 struct ww_acquire_ctx *ticket)
615{
616 struct ttm_buffer_object *bo = NULL, *busy_bo = NULL;
617 struct ttm_resource_cursor cursor;
618 struct ttm_resource *res;
619 bool locked = false;
620 int ret;
621
622 spin_lock(&bdev->lru_lock);
623 ttm_resource_manager_for_each_res(man, &cursor, res) {
624 bool busy;
625
626 if (!ttm_bo_evict_swapout_allowable(res->bo, ctx, place,
627 &locked, &busy)) {
628 if (busy && !busy_bo && ticket !=
629 dma_resv_locking_ctx(res->bo->base.resv))
630 busy_bo = res->bo;
631 continue;
632 }
633
634 if (ttm_bo_get_unless_zero(res->bo)) {
635 bo = res->bo;
636 break;
637 }
638 if (locked)
639 dma_resv_unlock(res->bo->base.resv);
640 }
641
642 if (!bo) {
643 if (busy_bo && !ttm_bo_get_unless_zero(busy_bo))
644 busy_bo = NULL;
645 spin_unlock(&bdev->lru_lock);
646 ret = ttm_mem_evict_wait_busy(busy_bo, ctx, ticket);
647 if (busy_bo)
648 ttm_bo_put(busy_bo);
649 return ret;
650 }
651
652 if (bo->deleted) {
653 ret = ttm_bo_cleanup_refs(bo, ctx->interruptible,
654 ctx->no_wait_gpu, locked);
655 ttm_bo_put(bo);
656 return ret;
657 }
658
659 spin_unlock(&bdev->lru_lock);
660
661 ret = ttm_bo_evict(bo, ctx);
662 if (locked)
663 ttm_bo_unreserve(bo);
664 else
665 ttm_bo_move_to_lru_tail_unlocked(bo);
666
667 ttm_bo_put(bo);
668 return ret;
669}
670
671/**
672 * ttm_bo_pin - Pin the buffer object.
673 * @bo: The buffer object to pin
674 *
675 * Make sure the buffer is not evicted any more during memory pressure.
676 * @bo must be unpinned again by calling ttm_bo_unpin().
677 */
678void ttm_bo_pin(struct ttm_buffer_object *bo)
679{
680 dma_resv_assert_held(bo->base.resv);
681 WARN_ON_ONCE(!kref_read(&bo->kref));
682 spin_lock(&bo->bdev->lru_lock);
683 if (bo->resource)
684 ttm_resource_del_bulk_move(bo->resource, bo);
685 ++bo->pin_count;
686 spin_unlock(&bo->bdev->lru_lock);
687}
688EXPORT_SYMBOL(ttm_bo_pin);
689
690/**
691 * ttm_bo_unpin - Unpin the buffer object.
692 * @bo: The buffer object to unpin
693 *
694 * Allows the buffer object to be evicted again during memory pressure.
695 */
696void ttm_bo_unpin(struct ttm_buffer_object *bo)
697{
698 dma_resv_assert_held(bo->base.resv);
699 WARN_ON_ONCE(!kref_read(&bo->kref));
700 if (WARN_ON_ONCE(!bo->pin_count))
701 return;
702
703 spin_lock(&bo->bdev->lru_lock);
704 --bo->pin_count;
705 if (bo->resource)
706 ttm_resource_add_bulk_move(bo->resource, bo);
707 spin_unlock(&bo->bdev->lru_lock);
708}
709EXPORT_SYMBOL(ttm_bo_unpin);
710
711/*
712 * Add the last move fence to the BO as kernel dependency and reserve a new
713 * fence slot.
714 */
715static int ttm_bo_add_move_fence(struct ttm_buffer_object *bo,
716 struct ttm_resource_manager *man,
717 struct ttm_resource *mem,
718 bool no_wait_gpu)
719{
720 struct dma_fence *fence;
721 int ret;
722
723 spin_lock(&man->move_lock);
724 fence = dma_fence_get(man->move);
725 spin_unlock(&man->move_lock);
726
727 if (!fence)
728 return 0;
729
730 if (no_wait_gpu) {
731 ret = dma_fence_is_signaled(fence) ? 0 : -EBUSY;
732 dma_fence_put(fence);
733 return ret;
734 }
735
736 dma_resv_add_fence(bo->base.resv, fence, DMA_RESV_USAGE_KERNEL);
737
738 ret = dma_resv_reserve_fences(bo->base.resv, 1);
739 dma_fence_put(fence);
740 return ret;
741}
742
743/*
744 * Repeatedly evict memory from the LRU for @mem_type until we create enough
745 * space, or we've evicted everything and there isn't enough space.
746 */
747static int ttm_bo_mem_force_space(struct ttm_buffer_object *bo,
748 const struct ttm_place *place,
749 struct ttm_resource **mem,
750 struct ttm_operation_ctx *ctx)
751{
752 struct ttm_device *bdev = bo->bdev;
753 struct ttm_resource_manager *man;
754 struct ww_acquire_ctx *ticket;
755 int ret;
756
757 man = ttm_manager_type(bdev, place->mem_type);
758 ticket = dma_resv_locking_ctx(bo->base.resv);
759 do {
760 ret = ttm_resource_alloc(bo, place, mem);
761 if (likely(!ret))
762 break;
763 if (unlikely(ret != -ENOSPC))
764 return ret;
765 ret = ttm_mem_evict_first(bdev, man, place, ctx,
766 ticket);
767 if (unlikely(ret != 0))
768 return ret;
769 } while (1);
770
771 return ttm_bo_add_move_fence(bo, man, *mem, ctx->no_wait_gpu);
772}
773
774/*
775 * Creates space for memory region @mem according to its type.
776 *
777 * This function first searches for free space in compatible memory types in
778 * the priority order defined by the driver. If free space isn't found, then
779 * ttm_bo_mem_force_space is attempted in priority order to evict and find
780 * space.
781 */
782int ttm_bo_mem_space(struct ttm_buffer_object *bo,
783 struct ttm_placement *placement,
784 struct ttm_resource **mem,
785 struct ttm_operation_ctx *ctx)
786{
787 struct ttm_device *bdev = bo->bdev;
788 bool type_found = false;
789 int i, ret;
790
791 ret = dma_resv_reserve_fences(bo->base.resv, 1);
792 if (unlikely(ret))
793 return ret;
794
795 for (i = 0; i < placement->num_placement; ++i) {
796 const struct ttm_place *place = &placement->placement[i];
797 struct ttm_resource_manager *man;
798
799 man = ttm_manager_type(bdev, place->mem_type);
800 if (!man || !ttm_resource_manager_used(man))
801 continue;
802
803 type_found = true;
804 ret = ttm_resource_alloc(bo, place, mem);
805 if (ret == -ENOSPC)
806 continue;
807 if (unlikely(ret))
808 goto error;
809
810 ret = ttm_bo_add_move_fence(bo, man, *mem, ctx->no_wait_gpu);
811 if (unlikely(ret)) {
812 ttm_resource_free(bo, mem);
813 if (ret == -EBUSY)
814 continue;
815
816 goto error;
817 }
818 return 0;
819 }
820
821 for (i = 0; i < placement->num_busy_placement; ++i) {
822 const struct ttm_place *place = &placement->busy_placement[i];
823 struct ttm_resource_manager *man;
824
825 man = ttm_manager_type(bdev, place->mem_type);
826 if (!man || !ttm_resource_manager_used(man))
827 continue;
828
829 type_found = true;
830 ret = ttm_bo_mem_force_space(bo, place, mem, ctx);
831 if (likely(!ret))
832 return 0;
833
834 if (ret && ret != -EBUSY)
835 goto error;
836 }
837
838 ret = -ENOMEM;
839 if (!type_found) {
840 pr_err(TTM_PFX "No compatible memory type found\n");
841 ret = -EINVAL;
842 }
843
844error:
845 return ret;
846}
847EXPORT_SYMBOL(ttm_bo_mem_space);
848
849static int ttm_bo_move_buffer(struct ttm_buffer_object *bo,
850 struct ttm_placement *placement,
851 struct ttm_operation_ctx *ctx)
852{
853 struct ttm_resource *mem;
854 struct ttm_place hop;
855 int ret;
856
857 dma_resv_assert_held(bo->base.resv);
858
859 /*
860 * Determine where to move the buffer.
861 *
862 * If driver determines move is going to need
863 * an extra step then it will return -EMULTIHOP
864 * and the buffer will be moved to the temporary
865 * stop and the driver will be called to make
866 * the second hop.
867 */
868 ret = ttm_bo_mem_space(bo, placement, &mem, ctx);
869 if (ret)
870 return ret;
871bounce:
872 ret = ttm_bo_handle_move_mem(bo, mem, false, ctx, &hop);
873 if (ret == -EMULTIHOP) {
874 ret = ttm_bo_bounce_temp_buffer(bo, &mem, ctx, &hop);
875 if (ret)
876 goto out;
877 /* try and move to final place now. */
878 goto bounce;
879 }
880out:
881 if (ret)
882 ttm_resource_free(bo, &mem);
883 return ret;
884}
885
886int ttm_bo_validate(struct ttm_buffer_object *bo,
887 struct ttm_placement *placement,
888 struct ttm_operation_ctx *ctx)
889{
890 int ret;
891
892 dma_resv_assert_held(bo->base.resv);
893
894 /*
895 * Remove the backing store if no placement is given.
896 */
897 if (!placement->num_placement && !placement->num_busy_placement)
898 return ttm_bo_pipeline_gutting(bo);
899
900 /*
901 * Check whether we need to move buffer.
902 */
903 if (!bo->resource || !ttm_resource_compat(bo->resource, placement)) {
904 ret = ttm_bo_move_buffer(bo, placement, ctx);
905 if (ret)
906 return ret;
907 }
908 /*
909 * We might need to add a TTM.
910 */
911 if (!bo->resource || bo->resource->mem_type == TTM_PL_SYSTEM) {
912 ret = ttm_tt_create(bo, true);
913 if (ret)
914 return ret;
915 }
916 return 0;
917}
918EXPORT_SYMBOL(ttm_bo_validate);
919
920/**
921 * ttm_bo_init_reserved
922 *
923 * @bdev: Pointer to a ttm_device struct.
924 * @bo: Pointer to a ttm_buffer_object to be initialized.
925 * @type: Requested type of buffer object.
926 * @placement: Initial placement for buffer object.
927 * @alignment: Data alignment in pages.
928 * @ctx: TTM operation context for memory allocation.
929 * @sg: Scatter-gather table.
930 * @resv: Pointer to a dma_resv, or NULL to let ttm allocate one.
931 * @destroy: Destroy function. Use NULL for kfree().
932 *
933 * This function initializes a pre-allocated struct ttm_buffer_object.
934 * As this object may be part of a larger structure, this function,
935 * together with the @destroy function, enables driver-specific objects
936 * derived from a ttm_buffer_object.
937 *
938 * On successful return, the caller owns an object kref to @bo. The kref and
939 * list_kref are usually set to 1, but note that in some situations, other
940 * tasks may already be holding references to @bo as well.
941 * Furthermore, if resv == NULL, the buffer's reservation lock will be held,
942 * and it is the caller's responsibility to call ttm_bo_unreserve.
943 *
944 * If a failure occurs, the function will call the @destroy function. Thus,
945 * after a failure, dereferencing @bo is illegal and will likely cause memory
946 * corruption.
947 *
948 * Returns
949 * -ENOMEM: Out of memory.
950 * -EINVAL: Invalid placement flags.
951 * -ERESTARTSYS: Interrupted by signal while sleeping waiting for resources.
952 */
953int ttm_bo_init_reserved(struct ttm_device *bdev, struct ttm_buffer_object *bo,
954 enum ttm_bo_type type, struct ttm_placement *placement,
955 uint32_t alignment, struct ttm_operation_ctx *ctx,
956 struct sg_table *sg, struct dma_resv *resv,
957 void (*destroy) (struct ttm_buffer_object *))
958{
959 static const struct ttm_place sys_mem = { .mem_type = TTM_PL_SYSTEM };
960 int ret;
961
962 kref_init(&bo->kref);
963 INIT_LIST_HEAD(&bo->ddestroy);
964 bo->bdev = bdev;
965 bo->type = type;
966 bo->page_alignment = alignment;
967 bo->destroy = destroy;
968 bo->pin_count = 0;
969 bo->sg = sg;
970 bo->bulk_move = NULL;
971 if (resv)
972 bo->base.resv = resv;
973 else
974 bo->base.resv = &bo->base._resv;
975 atomic_inc(&ttm_glob.bo_count);
976
977 ret = ttm_resource_alloc(bo, &sys_mem, &bo->resource);
978 if (unlikely(ret)) {
979 ttm_bo_put(bo);
980 return ret;
981 }
982
983 /*
984 * For ttm_bo_type_device buffers, allocate
985 * address space from the device.
986 */
987 if (bo->type == ttm_bo_type_device || bo->type == ttm_bo_type_sg) {
988 ret = drm_vma_offset_add(bdev->vma_manager, &bo->base.vma_node,
989 PFN_UP(bo->base.size));
990 if (ret)
991 goto err_put;
992 }
993
994 /* passed reservation objects should already be locked,
995 * since otherwise lockdep will be angered in radeon.
996 */
997 if (!resv)
998 WARN_ON(!dma_resv_trylock(bo->base.resv));
999 else
1000 dma_resv_assert_held(resv);
1001
1002 ret = ttm_bo_validate(bo, placement, ctx);
1003 if (unlikely(ret))
1004 goto err_unlock;
1005
1006 return 0;
1007
1008err_unlock:
1009 if (!resv)
1010 dma_resv_unlock(bo->base.resv);
1011
1012err_put:
1013 ttm_bo_put(bo);
1014 return ret;
1015}
1016EXPORT_SYMBOL(ttm_bo_init_reserved);
1017
1018/**
1019 * ttm_bo_init_validate
1020 *
1021 * @bdev: Pointer to a ttm_device struct.
1022 * @bo: Pointer to a ttm_buffer_object to be initialized.
1023 * @type: Requested type of buffer object.
1024 * @placement: Initial placement for buffer object.
1025 * @alignment: Data alignment in pages.
1026 * @interruptible: If needing to sleep to wait for GPU resources,
1027 * sleep interruptible.
1028 * pinned in physical memory. If this behaviour is not desired, this member
1029 * holds a pointer to a persistent shmem object. Typically, this would
1030 * point to the shmem object backing a GEM object if TTM is used to back a
1031 * GEM user interface.
1032 * @sg: Scatter-gather table.
1033 * @resv: Pointer to a dma_resv, or NULL to let ttm allocate one.
1034 * @destroy: Destroy function. Use NULL for kfree().
1035 *
1036 * This function initializes a pre-allocated struct ttm_buffer_object.
1037 * As this object may be part of a larger structure, this function,
1038 * together with the @destroy function,
1039 * enables driver-specific objects derived from a ttm_buffer_object.
1040 *
1041 * On successful return, the caller owns an object kref to @bo. The kref and
1042 * list_kref are usually set to 1, but note that in some situations, other
1043 * tasks may already be holding references to @bo as well.
1044 *
1045 * If a failure occurs, the function will call the @destroy function, Thus,
1046 * after a failure, dereferencing @bo is illegal and will likely cause memory
1047 * corruption.
1048 *
1049 * Returns
1050 * -ENOMEM: Out of memory.
1051 * -EINVAL: Invalid placement flags.
1052 * -ERESTARTSYS: Interrupted by signal while sleeping waiting for resources.
1053 */
1054int ttm_bo_init_validate(struct ttm_device *bdev, struct ttm_buffer_object *bo,
1055 enum ttm_bo_type type, struct ttm_placement *placement,
1056 uint32_t alignment, bool interruptible,
1057 struct sg_table *sg, struct dma_resv *resv,
1058 void (*destroy) (struct ttm_buffer_object *))
1059{
1060 struct ttm_operation_ctx ctx = { interruptible, false };
1061 int ret;
1062
1063 ret = ttm_bo_init_reserved(bdev, bo, type, placement, alignment, &ctx,
1064 sg, resv, destroy);
1065 if (ret)
1066 return ret;
1067
1068 if (!resv)
1069 ttm_bo_unreserve(bo);
1070
1071 return 0;
1072}
1073EXPORT_SYMBOL(ttm_bo_init_validate);
1074
1075/*
1076 * buffer object vm functions.
1077 */
1078
1079void ttm_bo_unmap_virtual(struct ttm_buffer_object *bo)
1080{
1081 struct ttm_device *bdev = bo->bdev;
1082
1083 drm_vma_node_unmap(&bo->base.vma_node, bdev->dev_mapping);
1084 ttm_mem_io_free(bdev, bo->resource);
1085}
1086EXPORT_SYMBOL(ttm_bo_unmap_virtual);
1087
1088int ttm_bo_wait(struct ttm_buffer_object *bo,
1089 bool interruptible, bool no_wait)
1090{
1091 long timeout = 15 * HZ;
1092
1093 if (no_wait) {
1094 if (dma_resv_test_signaled(bo->base.resv, DMA_RESV_USAGE_BOOKKEEP))
1095 return 0;
1096 else
1097 return -EBUSY;
1098 }
1099
1100 timeout = dma_resv_wait_timeout(bo->base.resv, DMA_RESV_USAGE_BOOKKEEP,
1101 interruptible, timeout);
1102 if (timeout < 0)
1103 return timeout;
1104
1105 if (timeout == 0)
1106 return -EBUSY;
1107
1108 return 0;
1109}
1110EXPORT_SYMBOL(ttm_bo_wait);
1111
1112int ttm_bo_swapout(struct ttm_buffer_object *bo, struct ttm_operation_ctx *ctx,
1113 gfp_t gfp_flags)
1114{
1115 struct ttm_place place;
1116 bool locked;
1117 int ret;
1118
1119 /*
1120 * While the bo may already reside in SYSTEM placement, set
1121 * SYSTEM as new placement to cover also the move further below.
1122 * The driver may use the fact that we're moving from SYSTEM
1123 * as an indication that we're about to swap out.
1124 */
1125 memset(&place, 0, sizeof(place));
1126 place.mem_type = bo->resource->mem_type;
1127 if (!ttm_bo_evict_swapout_allowable(bo, ctx, &place, &locked, NULL))
1128 return -EBUSY;
1129
1130 if (!bo->ttm || !ttm_tt_is_populated(bo->ttm) ||
1131 bo->ttm->page_flags & TTM_TT_FLAG_EXTERNAL ||
1132 bo->ttm->page_flags & TTM_TT_FLAG_SWAPPED ||
1133 !ttm_bo_get_unless_zero(bo)) {
1134 if (locked)
1135 dma_resv_unlock(bo->base.resv);
1136 return -EBUSY;
1137 }
1138
1139 if (bo->deleted) {
1140 ret = ttm_bo_cleanup_refs(bo, false, false, locked);
1141 ttm_bo_put(bo);
1142 return ret == -EBUSY ? -ENOSPC : ret;
1143 }
1144
1145 /* TODO: Cleanup the locking */
1146 spin_unlock(&bo->bdev->lru_lock);
1147
1148 /*
1149 * Move to system cached
1150 */
1151 if (bo->resource->mem_type != TTM_PL_SYSTEM) {
1152 struct ttm_operation_ctx ctx = { false, false };
1153 struct ttm_resource *evict_mem;
1154 struct ttm_place hop;
1155
1156 memset(&hop, 0, sizeof(hop));
1157 place.mem_type = TTM_PL_SYSTEM;
1158 ret = ttm_resource_alloc(bo, &place, &evict_mem);
1159 if (unlikely(ret))
1160 goto out;
1161
1162 ret = ttm_bo_handle_move_mem(bo, evict_mem, true, &ctx, &hop);
1163 if (unlikely(ret != 0)) {
1164 WARN(ret == -EMULTIHOP, "Unexpected multihop in swaput - likely driver bug.\n");
1165 goto out;
1166 }
1167 }
1168
1169 /*
1170 * Make sure BO is idle.
1171 */
1172 ret = ttm_bo_wait(bo, false, false);
1173 if (unlikely(ret != 0))
1174 goto out;
1175
1176 ttm_bo_unmap_virtual(bo);
1177
1178 /*
1179 * Swap out. Buffer will be swapped in again as soon as
1180 * anyone tries to access a ttm page.
1181 */
1182 if (bo->bdev->funcs->swap_notify)
1183 bo->bdev->funcs->swap_notify(bo);
1184
1185 if (ttm_tt_is_populated(bo->ttm))
1186 ret = ttm_tt_swapout(bo->bdev, bo->ttm, gfp_flags);
1187out:
1188
1189 /*
1190 * Unreserve without putting on LRU to avoid swapping out an
1191 * already swapped buffer.
1192 */
1193 if (locked)
1194 dma_resv_unlock(bo->base.resv);
1195 ttm_bo_put(bo);
1196 return ret == -EBUSY ? -ENOSPC : ret;
1197}
1198
1199void ttm_bo_tt_destroy(struct ttm_buffer_object *bo)
1200{
1201 if (bo->ttm == NULL)
1202 return;
1203
1204 ttm_tt_unpopulate(bo->bdev, bo->ttm);
1205 ttm_tt_destroy(bo->bdev, bo->ttm);
1206 bo->ttm = NULL;
1207}