xref: /openbmc/linux/drivers/gpu/drm/ttm/ttm_resource.c (revision f59a3ee6)
1 /*
2  * Copyright 2020 Advanced Micro Devices, Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20  * OTHER DEALINGS IN THE SOFTWARE.
21  *
22  * Authors: Christian König
23  */
24 
25 #include <linux/iosys-map.h>
26 #include <linux/io-mapping.h>
27 #include <linux/scatterlist.h>
28 
29 #include <drm/ttm/ttm_resource.h>
30 #include <drm/ttm/ttm_bo_driver.h>
31 
32 /**
33  * ttm_lru_bulk_move_init - initialize a bulk move structure
34  * @bulk: the structure to init
35  *
36  * For now just memset the structure to zero.
37  */
38 void ttm_lru_bulk_move_init(struct ttm_lru_bulk_move *bulk)
39 {
40 	memset(bulk, 0, sizeof(*bulk));
41 }
42 EXPORT_SYMBOL(ttm_lru_bulk_move_init);
43 
44 /**
45  * ttm_lru_bulk_move_tail - bulk move range of resources to the LRU tail.
46  *
47  * @bulk: bulk move structure
48  *
49  * Bulk move BOs to the LRU tail, only valid to use when driver makes sure that
50  * resource order never changes. Should be called with &ttm_device.lru_lock held.
51  */
52 void ttm_lru_bulk_move_tail(struct ttm_lru_bulk_move *bulk)
53 {
54 	unsigned i, j;
55 
56 	for (i = 0; i < TTM_NUM_MEM_TYPES; ++i) {
57 		for (j = 0; j < TTM_MAX_BO_PRIORITY; ++j) {
58 			struct ttm_lru_bulk_move_pos *pos = &bulk->pos[i][j];
59 			struct ttm_resource_manager *man;
60 
61 			if (!pos->first)
62 				continue;
63 
64 			lockdep_assert_held(&pos->first->bo->bdev->lru_lock);
65 			dma_resv_assert_held(pos->first->bo->base.resv);
66 			dma_resv_assert_held(pos->last->bo->base.resv);
67 
68 			man = ttm_manager_type(pos->first->bo->bdev, i);
69 			list_bulk_move_tail(&man->lru[j], &pos->first->lru,
70 					    &pos->last->lru);
71 		}
72 	}
73 }
74 EXPORT_SYMBOL(ttm_lru_bulk_move_tail);
75 
76 /* Return the bulk move pos object for this resource */
77 static struct ttm_lru_bulk_move_pos *
78 ttm_lru_bulk_move_pos(struct ttm_lru_bulk_move *bulk, struct ttm_resource *res)
79 {
80 	return &bulk->pos[res->mem_type][res->bo->priority];
81 }
82 
83 /* Move the resource to the tail of the bulk move range */
84 static void ttm_lru_bulk_move_pos_tail(struct ttm_lru_bulk_move_pos *pos,
85 				       struct ttm_resource *res)
86 {
87 	if (pos->last != res) {
88 		list_move(&res->lru, &pos->last->lru);
89 		pos->last = res;
90 	}
91 }
92 
93 /* Add the resource to a bulk_move cursor */
94 static void ttm_lru_bulk_move_add(struct ttm_lru_bulk_move *bulk,
95 				  struct ttm_resource *res)
96 {
97 	struct ttm_lru_bulk_move_pos *pos = ttm_lru_bulk_move_pos(bulk, res);
98 
99 	if (!pos->first) {
100 		pos->first = res;
101 		pos->last = res;
102 	} else {
103 		ttm_lru_bulk_move_pos_tail(pos, res);
104 	}
105 }
106 
107 /* Remove the resource from a bulk_move range */
108 static void ttm_lru_bulk_move_del(struct ttm_lru_bulk_move *bulk,
109 				  struct ttm_resource *res)
110 {
111 	struct ttm_lru_bulk_move_pos *pos = ttm_lru_bulk_move_pos(bulk, res);
112 
113 	if (unlikely(pos->first == res && pos->last == res)) {
114 		pos->first = NULL;
115 		pos->last = NULL;
116 	} else if (pos->first == res) {
117 		pos->first = list_next_entry(res, lru);
118 	} else if (pos->last == res) {
119 		pos->last = list_prev_entry(res, lru);
120 	} else {
121 		list_move(&res->lru, &pos->last->lru);
122 	}
123 }
124 
125 /* Add the resource to a bulk move if the BO is configured for it */
126 void ttm_resource_add_bulk_move(struct ttm_resource *res,
127 				struct ttm_buffer_object *bo)
128 {
129 	if (bo->bulk_move && !bo->pin_count)
130 		ttm_lru_bulk_move_add(bo->bulk_move, res);
131 }
132 
133 /* Remove the resource from a bulk move if the BO is configured for it */
134 void ttm_resource_del_bulk_move(struct ttm_resource *res,
135 				struct ttm_buffer_object *bo)
136 {
137 	if (bo->bulk_move && !bo->pin_count)
138 		ttm_lru_bulk_move_del(bo->bulk_move, res);
139 }
140 
141 /* Move a resource to the LRU or bulk tail */
142 void ttm_resource_move_to_lru_tail(struct ttm_resource *res)
143 {
144 	struct ttm_buffer_object *bo = res->bo;
145 	struct ttm_device *bdev = bo->bdev;
146 
147 	lockdep_assert_held(&bo->bdev->lru_lock);
148 
149 	if (bo->pin_count) {
150 		list_move_tail(&res->lru, &bdev->pinned);
151 
152 	} else	if (bo->bulk_move) {
153 		struct ttm_lru_bulk_move_pos *pos =
154 			ttm_lru_bulk_move_pos(bo->bulk_move, res);
155 
156 		ttm_lru_bulk_move_pos_tail(pos, res);
157 	} else {
158 		struct ttm_resource_manager *man;
159 
160 		man = ttm_manager_type(bdev, res->mem_type);
161 		list_move_tail(&res->lru, &man->lru[bo->priority]);
162 	}
163 }
164 
165 /**
166  * ttm_resource_init - resource object constructure
167  * @bo: buffer object this resources is allocated for
168  * @place: placement of the resource
169  * @res: the resource object to inistilize
170  *
171  * Initialize a new resource object. Counterpart of ttm_resource_fini().
172  */
173 void ttm_resource_init(struct ttm_buffer_object *bo,
174                        const struct ttm_place *place,
175                        struct ttm_resource *res)
176 {
177 	struct ttm_resource_manager *man;
178 
179 	res->start = 0;
180 	res->num_pages = PFN_UP(bo->base.size);
181 	res->mem_type = place->mem_type;
182 	res->placement = place->flags;
183 	res->bus.addr = NULL;
184 	res->bus.offset = 0;
185 	res->bus.is_iomem = false;
186 	res->bus.caching = ttm_cached;
187 	res->bo = bo;
188 
189 	man = ttm_manager_type(bo->bdev, place->mem_type);
190 	spin_lock(&bo->bdev->lru_lock);
191 	if (bo->pin_count)
192 		list_add_tail(&res->lru, &bo->bdev->pinned);
193 	else
194 		list_add_tail(&res->lru, &man->lru[bo->priority]);
195 	man->usage += res->num_pages << PAGE_SHIFT;
196 	spin_unlock(&bo->bdev->lru_lock);
197 }
198 EXPORT_SYMBOL(ttm_resource_init);
199 
200 /**
201  * ttm_resource_fini - resource destructor
202  * @man: the resource manager this resource belongs to
203  * @res: the resource to clean up
204  *
205  * Should be used by resource manager backends to clean up the TTM resource
206  * objects before freeing the underlying structure. Makes sure the resource is
207  * removed from the LRU before destruction.
208  * Counterpart of ttm_resource_init().
209  */
210 void ttm_resource_fini(struct ttm_resource_manager *man,
211 		       struct ttm_resource *res)
212 {
213 	struct ttm_device *bdev = man->bdev;
214 
215 	spin_lock(&bdev->lru_lock);
216 	list_del_init(&res->lru);
217 	man->usage -= res->num_pages << PAGE_SHIFT;
218 	spin_unlock(&bdev->lru_lock);
219 }
220 EXPORT_SYMBOL(ttm_resource_fini);
221 
222 int ttm_resource_alloc(struct ttm_buffer_object *bo,
223 		       const struct ttm_place *place,
224 		       struct ttm_resource **res_ptr)
225 {
226 	struct ttm_resource_manager *man =
227 		ttm_manager_type(bo->bdev, place->mem_type);
228 	int ret;
229 
230 	ret = man->func->alloc(man, bo, place, res_ptr);
231 	if (ret)
232 		return ret;
233 
234 	spin_lock(&bo->bdev->lru_lock);
235 	ttm_resource_add_bulk_move(*res_ptr, bo);
236 	spin_unlock(&bo->bdev->lru_lock);
237 	return 0;
238 }
239 
240 void ttm_resource_free(struct ttm_buffer_object *bo, struct ttm_resource **res)
241 {
242 	struct ttm_resource_manager *man;
243 
244 	if (!*res)
245 		return;
246 
247 	spin_lock(&bo->bdev->lru_lock);
248 	ttm_resource_del_bulk_move(*res, bo);
249 	spin_unlock(&bo->bdev->lru_lock);
250 	man = ttm_manager_type(bo->bdev, (*res)->mem_type);
251 	man->func->free(man, *res);
252 	*res = NULL;
253 }
254 EXPORT_SYMBOL(ttm_resource_free);
255 
256 /**
257  * ttm_resource_intersects - test for intersection
258  *
259  * @bdev: TTM device structure
260  * @res: The resource to test
261  * @place: The placement to test
262  * @size: How many bytes the new allocation needs.
263  *
264  * Test if @res intersects with @place and @size. Used for testing if evictions
265  * are valueable or not.
266  *
267  * Returns true if the res placement intersects with @place and @size.
268  */
269 bool ttm_resource_intersects(struct ttm_device *bdev,
270 			     struct ttm_resource *res,
271 			     const struct ttm_place *place,
272 			     size_t size)
273 {
274 	struct ttm_resource_manager *man;
275 
276 	if (!res)
277 		return false;
278 
279 	man = ttm_manager_type(bdev, res->mem_type);
280 	if (!place || !man->func->intersects)
281 		return true;
282 
283 	return man->func->intersects(man, res, place, size);
284 }
285 
286 /**
287  * ttm_resource_compatible - test for compatibility
288  *
289  * @bdev: TTM device structure
290  * @res: The resource to test
291  * @place: The placement to test
292  * @size: How many bytes the new allocation needs.
293  *
294  * Test if @res compatible with @place and @size.
295  *
296  * Returns true if the res placement compatible with @place and @size.
297  */
298 bool ttm_resource_compatible(struct ttm_device *bdev,
299 			     struct ttm_resource *res,
300 			     const struct ttm_place *place,
301 			     size_t size)
302 {
303 	struct ttm_resource_manager *man;
304 
305 	if (!res || !place)
306 		return false;
307 
308 	man = ttm_manager_type(bdev, res->mem_type);
309 	if (!man->func->compatible)
310 		return true;
311 
312 	return man->func->compatible(man, res, place, size);
313 }
314 
315 static bool ttm_resource_places_compat(struct ttm_resource *res,
316 				       const struct ttm_place *places,
317 				       unsigned num_placement)
318 {
319 	struct ttm_buffer_object *bo = res->bo;
320 	struct ttm_device *bdev = bo->bdev;
321 	unsigned i;
322 
323 	if (res->placement & TTM_PL_FLAG_TEMPORARY)
324 		return false;
325 
326 	for (i = 0; i < num_placement; i++) {
327 		const struct ttm_place *heap = &places[i];
328 
329 		if (!ttm_resource_compatible(bdev, res, heap, bo->base.size))
330 			continue;
331 
332 		if ((res->mem_type == heap->mem_type) &&
333 		    (!(heap->flags & TTM_PL_FLAG_CONTIGUOUS) ||
334 		     (res->placement & TTM_PL_FLAG_CONTIGUOUS)))
335 			return true;
336 	}
337 	return false;
338 }
339 
340 /**
341  * ttm_resource_compat - check if resource is compatible with placement
342  *
343  * @res: the resource to check
344  * @placement: the placement to check against
345  *
346  * Returns true if the placement is compatible.
347  */
348 bool ttm_resource_compat(struct ttm_resource *res,
349 			 struct ttm_placement *placement)
350 {
351 	if (ttm_resource_places_compat(res, placement->placement,
352 				       placement->num_placement))
353 		return true;
354 
355 	if ((placement->busy_placement != placement->placement ||
356 	     placement->num_busy_placement > placement->num_placement) &&
357 	    ttm_resource_places_compat(res, placement->busy_placement,
358 				       placement->num_busy_placement))
359 		return true;
360 
361 	return false;
362 }
363 EXPORT_SYMBOL(ttm_resource_compat);
364 
365 void ttm_resource_set_bo(struct ttm_resource *res,
366 			 struct ttm_buffer_object *bo)
367 {
368 	spin_lock(&bo->bdev->lru_lock);
369 	res->bo = bo;
370 	spin_unlock(&bo->bdev->lru_lock);
371 }
372 
373 /**
374  * ttm_resource_manager_init
375  *
376  * @man: memory manager object to init
377  * @bdev: ttm device this manager belongs to
378  * @size: size of managed resources in arbitrary units
379  *
380  * Initialise core parts of a manager object.
381  */
382 void ttm_resource_manager_init(struct ttm_resource_manager *man,
383 			       struct ttm_device *bdev,
384 			       uint64_t size)
385 {
386 	unsigned i;
387 
388 	spin_lock_init(&man->move_lock);
389 	man->bdev = bdev;
390 	man->size = size;
391 	man->usage = 0;
392 
393 	for (i = 0; i < TTM_MAX_BO_PRIORITY; ++i)
394 		INIT_LIST_HEAD(&man->lru[i]);
395 	man->move = NULL;
396 }
397 EXPORT_SYMBOL(ttm_resource_manager_init);
398 
399 /*
400  * ttm_resource_manager_evict_all
401  *
402  * @bdev - device to use
403  * @man - manager to use
404  *
405  * Evict all the objects out of a memory manager until it is empty.
406  * Part of memory manager cleanup sequence.
407  */
408 int ttm_resource_manager_evict_all(struct ttm_device *bdev,
409 				   struct ttm_resource_manager *man)
410 {
411 	struct ttm_operation_ctx ctx = {
412 		.interruptible = false,
413 		.no_wait_gpu = false,
414 		.force_alloc = true
415 	};
416 	struct dma_fence *fence;
417 	int ret;
418 	unsigned i;
419 
420 	/*
421 	 * Can't use standard list traversal since we're unlocking.
422 	 */
423 
424 	spin_lock(&bdev->lru_lock);
425 	for (i = 0; i < TTM_MAX_BO_PRIORITY; ++i) {
426 		while (!list_empty(&man->lru[i])) {
427 			spin_unlock(&bdev->lru_lock);
428 			ret = ttm_mem_evict_first(bdev, man, NULL, &ctx,
429 						  NULL);
430 			if (ret)
431 				return ret;
432 			spin_lock(&bdev->lru_lock);
433 		}
434 	}
435 	spin_unlock(&bdev->lru_lock);
436 
437 	spin_lock(&man->move_lock);
438 	fence = dma_fence_get(man->move);
439 	spin_unlock(&man->move_lock);
440 
441 	if (fence) {
442 		ret = dma_fence_wait(fence, false);
443 		dma_fence_put(fence);
444 		if (ret)
445 			return ret;
446 	}
447 
448 	return 0;
449 }
450 EXPORT_SYMBOL(ttm_resource_manager_evict_all);
451 
452 /**
453  * ttm_resource_manager_usage
454  *
455  * @man: A memory manager object.
456  *
457  * Return how many resources are currently used.
458  */
459 uint64_t ttm_resource_manager_usage(struct ttm_resource_manager *man)
460 {
461 	uint64_t usage;
462 
463 	spin_lock(&man->bdev->lru_lock);
464 	usage = man->usage;
465 	spin_unlock(&man->bdev->lru_lock);
466 	return usage;
467 }
468 EXPORT_SYMBOL(ttm_resource_manager_usage);
469 
470 /**
471  * ttm_resource_manager_debug
472  *
473  * @man: manager type to dump.
474  * @p: printer to use for debug.
475  */
476 void ttm_resource_manager_debug(struct ttm_resource_manager *man,
477 				struct drm_printer *p)
478 {
479 	drm_printf(p, "  use_type: %d\n", man->use_type);
480 	drm_printf(p, "  use_tt: %d\n", man->use_tt);
481 	drm_printf(p, "  size: %llu\n", man->size);
482 	drm_printf(p, "  usage: %llu\n", ttm_resource_manager_usage(man));
483 	if (man->func->debug)
484 		man->func->debug(man, p);
485 }
486 EXPORT_SYMBOL(ttm_resource_manager_debug);
487 
488 /**
489  * ttm_resource_manager_first
490  *
491  * @man: resource manager to iterate over
492  * @cursor: cursor to record the position
493  *
494  * Returns the first resource from the resource manager.
495  */
496 struct ttm_resource *
497 ttm_resource_manager_first(struct ttm_resource_manager *man,
498 			   struct ttm_resource_cursor *cursor)
499 {
500 	struct ttm_resource *res;
501 
502 	lockdep_assert_held(&man->bdev->lru_lock);
503 
504 	for (cursor->priority = 0; cursor->priority < TTM_MAX_BO_PRIORITY;
505 	     ++cursor->priority)
506 		list_for_each_entry(res, &man->lru[cursor->priority], lru)
507 			return res;
508 
509 	return NULL;
510 }
511 
512 /**
513  * ttm_resource_manager_next
514  *
515  * @man: resource manager to iterate over
516  * @cursor: cursor to record the position
517  * @res: the current resource pointer
518  *
519  * Returns the next resource from the resource manager.
520  */
521 struct ttm_resource *
522 ttm_resource_manager_next(struct ttm_resource_manager *man,
523 			  struct ttm_resource_cursor *cursor,
524 			  struct ttm_resource *res)
525 {
526 	lockdep_assert_held(&man->bdev->lru_lock);
527 
528 	list_for_each_entry_continue(res, &man->lru[cursor->priority], lru)
529 		return res;
530 
531 	for (++cursor->priority; cursor->priority < TTM_MAX_BO_PRIORITY;
532 	     ++cursor->priority)
533 		list_for_each_entry(res, &man->lru[cursor->priority], lru)
534 			return res;
535 
536 	return NULL;
537 }
538 
539 static void ttm_kmap_iter_iomap_map_local(struct ttm_kmap_iter *iter,
540 					  struct iosys_map *dmap,
541 					  pgoff_t i)
542 {
543 	struct ttm_kmap_iter_iomap *iter_io =
544 		container_of(iter, typeof(*iter_io), base);
545 	void __iomem *addr;
546 
547 retry:
548 	while (i >= iter_io->cache.end) {
549 		iter_io->cache.sg = iter_io->cache.sg ?
550 			sg_next(iter_io->cache.sg) : iter_io->st->sgl;
551 		iter_io->cache.i = iter_io->cache.end;
552 		iter_io->cache.end += sg_dma_len(iter_io->cache.sg) >>
553 			PAGE_SHIFT;
554 		iter_io->cache.offs = sg_dma_address(iter_io->cache.sg) -
555 			iter_io->start;
556 	}
557 
558 	if (i < iter_io->cache.i) {
559 		iter_io->cache.end = 0;
560 		iter_io->cache.sg = NULL;
561 		goto retry;
562 	}
563 
564 	addr = io_mapping_map_local_wc(iter_io->iomap, iter_io->cache.offs +
565 				       (((resource_size_t)i - iter_io->cache.i)
566 					<< PAGE_SHIFT));
567 	iosys_map_set_vaddr_iomem(dmap, addr);
568 }
569 
570 static void ttm_kmap_iter_iomap_unmap_local(struct ttm_kmap_iter *iter,
571 					    struct iosys_map *map)
572 {
573 	io_mapping_unmap_local(map->vaddr_iomem);
574 }
575 
576 static const struct ttm_kmap_iter_ops ttm_kmap_iter_io_ops = {
577 	.map_local =  ttm_kmap_iter_iomap_map_local,
578 	.unmap_local = ttm_kmap_iter_iomap_unmap_local,
579 	.maps_tt = false,
580 };
581 
582 /**
583  * ttm_kmap_iter_iomap_init - Initialize a struct ttm_kmap_iter_iomap
584  * @iter_io: The struct ttm_kmap_iter_iomap to initialize.
585  * @iomap: The struct io_mapping representing the underlying linear io_memory.
586  * @st: sg_table into @iomap, representing the memory of the struct
587  * ttm_resource.
588  * @start: Offset that needs to be subtracted from @st to make
589  * sg_dma_address(st->sgl) - @start == 0 for @iomap start.
590  *
591  * Return: Pointer to the embedded struct ttm_kmap_iter.
592  */
593 struct ttm_kmap_iter *
594 ttm_kmap_iter_iomap_init(struct ttm_kmap_iter_iomap *iter_io,
595 			 struct io_mapping *iomap,
596 			 struct sg_table *st,
597 			 resource_size_t start)
598 {
599 	iter_io->base.ops = &ttm_kmap_iter_io_ops;
600 	iter_io->iomap = iomap;
601 	iter_io->st = st;
602 	iter_io->start = start;
603 	memset(&iter_io->cache, 0, sizeof(iter_io->cache));
604 
605 	return &iter_io->base;
606 }
607 EXPORT_SYMBOL(ttm_kmap_iter_iomap_init);
608 
609 /**
610  * DOC: Linear io iterator
611  *
612  * This code should die in the not too near future. Best would be if we could
613  * make io-mapping use memremap for all io memory, and have memremap
614  * implement a kmap_local functionality. We could then strip a huge amount of
615  * code. These linear io iterators are implemented to mimic old functionality,
616  * and they don't use kmap_local semantics at all internally. Rather ioremap or
617  * friends, and at least on 32-bit they add global TLB flushes and points
618  * of failure.
619  */
620 
621 static void ttm_kmap_iter_linear_io_map_local(struct ttm_kmap_iter *iter,
622 					      struct iosys_map *dmap,
623 					      pgoff_t i)
624 {
625 	struct ttm_kmap_iter_linear_io *iter_io =
626 		container_of(iter, typeof(*iter_io), base);
627 
628 	*dmap = iter_io->dmap;
629 	iosys_map_incr(dmap, i * PAGE_SIZE);
630 }
631 
632 static const struct ttm_kmap_iter_ops ttm_kmap_iter_linear_io_ops = {
633 	.map_local =  ttm_kmap_iter_linear_io_map_local,
634 	.maps_tt = false,
635 };
636 
637 /**
638  * ttm_kmap_iter_linear_io_init - Initialize an iterator for linear io memory
639  * @iter_io: The iterator to initialize
640  * @bdev: The TTM device
641  * @mem: The ttm resource representing the iomap.
642  *
643  * This function is for internal TTM use only. It sets up a memcpy kmap iterator
644  * pointing at a linear chunk of io memory.
645  *
646  * Return: A pointer to the embedded struct ttm_kmap_iter or error pointer on
647  * failure.
648  */
649 struct ttm_kmap_iter *
650 ttm_kmap_iter_linear_io_init(struct ttm_kmap_iter_linear_io *iter_io,
651 			     struct ttm_device *bdev,
652 			     struct ttm_resource *mem)
653 {
654 	int ret;
655 
656 	ret = ttm_mem_io_reserve(bdev, mem);
657 	if (ret)
658 		goto out_err;
659 	if (!mem->bus.is_iomem) {
660 		ret = -EINVAL;
661 		goto out_io_free;
662 	}
663 
664 	if (mem->bus.addr) {
665 		iosys_map_set_vaddr(&iter_io->dmap, mem->bus.addr);
666 		iter_io->needs_unmap = false;
667 	} else {
668 		size_t bus_size = (size_t)mem->num_pages << PAGE_SHIFT;
669 
670 		iter_io->needs_unmap = true;
671 		memset(&iter_io->dmap, 0, sizeof(iter_io->dmap));
672 		if (mem->bus.caching == ttm_write_combined)
673 			iosys_map_set_vaddr_iomem(&iter_io->dmap,
674 						  ioremap_wc(mem->bus.offset,
675 							     bus_size));
676 		else if (mem->bus.caching == ttm_cached)
677 			iosys_map_set_vaddr(&iter_io->dmap,
678 					    memremap(mem->bus.offset, bus_size,
679 						     MEMREMAP_WB |
680 						     MEMREMAP_WT |
681 						     MEMREMAP_WC));
682 
683 		/* If uncached requested or if mapping cached or wc failed */
684 		if (iosys_map_is_null(&iter_io->dmap))
685 			iosys_map_set_vaddr_iomem(&iter_io->dmap,
686 						  ioremap(mem->bus.offset,
687 							  bus_size));
688 
689 		if (iosys_map_is_null(&iter_io->dmap)) {
690 			ret = -ENOMEM;
691 			goto out_io_free;
692 		}
693 	}
694 
695 	iter_io->base.ops = &ttm_kmap_iter_linear_io_ops;
696 	return &iter_io->base;
697 
698 out_io_free:
699 	ttm_mem_io_free(bdev, mem);
700 out_err:
701 	return ERR_PTR(ret);
702 }
703 
704 /**
705  * ttm_kmap_iter_linear_io_fini - Clean up an iterator for linear io memory
706  * @iter_io: The iterator to initialize
707  * @bdev: The TTM device
708  * @mem: The ttm resource representing the iomap.
709  *
710  * This function is for internal TTM use only. It cleans up a memcpy kmap
711  * iterator initialized by ttm_kmap_iter_linear_io_init.
712  */
713 void
714 ttm_kmap_iter_linear_io_fini(struct ttm_kmap_iter_linear_io *iter_io,
715 			     struct ttm_device *bdev,
716 			     struct ttm_resource *mem)
717 {
718 	if (iter_io->needs_unmap && iosys_map_is_set(&iter_io->dmap)) {
719 		if (iter_io->dmap.is_iomem)
720 			iounmap(iter_io->dmap.vaddr_iomem);
721 		else
722 			memunmap(iter_io->dmap.vaddr);
723 	}
724 
725 	ttm_mem_io_free(bdev, mem);
726 }
727 
728 #if defined(CONFIG_DEBUG_FS)
729 
730 static int ttm_resource_manager_show(struct seq_file *m, void *unused)
731 {
732 	struct ttm_resource_manager *man =
733 		(struct ttm_resource_manager *)m->private;
734 	struct drm_printer p = drm_seq_file_printer(m);
735 	ttm_resource_manager_debug(man, &p);
736 	return 0;
737 }
738 DEFINE_SHOW_ATTRIBUTE(ttm_resource_manager);
739 
740 #endif
741 
742 /**
743  * ttm_resource_manager_create_debugfs - Create debugfs entry for specified
744  * resource manager.
745  * @man: The TTM resource manager for which the debugfs stats file be creates
746  * @parent: debugfs directory in which the file will reside
747  * @name: The filename to create.
748  *
749  * This function setups up a debugfs file that can be used to look
750  * at debug statistics of the specified ttm_resource_manager.
751  */
752 void ttm_resource_manager_create_debugfs(struct ttm_resource_manager *man,
753 					 struct dentry * parent,
754 					 const char *name)
755 {
756 #if defined(CONFIG_DEBUG_FS)
757 	debugfs_create_file(name, 0444, parent, man, &ttm_resource_manager_fops);
758 #endif
759 }
760 EXPORT_SYMBOL(ttm_resource_manager_create_debugfs);
761