1 // SPDX-License-Identifier: MIT
2 /*
3  * Copyright © 2021 Intel Corporation
4  */
5 #include <drm/ttm/ttm_device.h>
6 #include <drm/ttm/ttm_range_manager.h>
7 
8 #include "i915_drv.h"
9 #include "i915_scatterlist.h"
10 #include "i915_ttm_buddy_manager.h"
11 
12 #include "intel_region_ttm.h"
13 
14 #include "gem/i915_gem_region.h"
15 #include "gem/i915_gem_ttm.h" /* For the funcs/ops export only */
16 /**
17  * DOC: TTM support structure
18  *
19  * The code in this file deals with setting up memory managers for TTM
20  * LMEM and MOCK regions and converting the output from
21  * the managers to struct sg_table, Basically providing the mapping from
22  * i915 GEM regions to TTM memory types and resource managers.
23  */
24 
25 /**
26  * intel_region_ttm_device_init - Initialize a TTM device
27  * @dev_priv: Pointer to an i915 device private structure.
28  *
29  * Return: 0 on success, negative error code on failure.
30  */
31 int intel_region_ttm_device_init(struct drm_i915_private *dev_priv)
32 {
33 	struct drm_device *drm = &dev_priv->drm;
34 
35 	return ttm_device_init(&dev_priv->bdev, i915_ttm_driver(),
36 			       drm->dev, drm->anon_inode->i_mapping,
37 			       drm->vma_offset_manager, false, false);
38 }
39 
40 /**
41  * intel_region_ttm_device_fini - Finalize a TTM device
42  * @dev_priv: Pointer to an i915 device private structure.
43  */
44 void intel_region_ttm_device_fini(struct drm_i915_private *dev_priv)
45 {
46 	ttm_device_fini(&dev_priv->bdev);
47 }
48 
49 /*
50  * Map the i915 memory regions to TTM memory types. We use the
51  * driver-private types for now, reserving TTM_PL_VRAM for stolen
52  * memory and TTM_PL_TT for GGTT use if decided to implement this.
53  */
54 int intel_region_to_ttm_type(const struct intel_memory_region *mem)
55 {
56 	int type;
57 
58 	GEM_BUG_ON(mem->type != INTEL_MEMORY_LOCAL &&
59 		   mem->type != INTEL_MEMORY_MOCK &&
60 		   mem->type != INTEL_MEMORY_SYSTEM);
61 
62 	if (mem->type == INTEL_MEMORY_SYSTEM)
63 		return TTM_PL_SYSTEM;
64 
65 	type = mem->instance + TTM_PL_PRIV;
66 	GEM_BUG_ON(type >= TTM_NUM_MEM_TYPES);
67 
68 	return type;
69 }
70 
71 /**
72  * intel_region_ttm_init - Initialize a memory region for TTM.
73  * @mem: The region to initialize.
74  *
75  * This function initializes a suitable TTM resource manager for the
76  * region, and if it's a LMEM region type, attaches it to the TTM
77  * device. MOCK regions are NOT attached to the TTM device, since we don't
78  * have one for the mock selftests.
79  *
80  * Return: 0 on success, negative error code on failure.
81  */
82 int intel_region_ttm_init(struct intel_memory_region *mem)
83 {
84 	struct ttm_device *bdev = &mem->i915->bdev;
85 	int mem_type = intel_region_to_ttm_type(mem);
86 	int ret;
87 
88 	ret = i915_ttm_buddy_man_init(bdev, mem_type, false,
89 				      resource_size(&mem->region),
90 				      mem->io_size,
91 				      mem->min_page_size, PAGE_SIZE);
92 	if (ret)
93 		return ret;
94 
95 	mem->region_private = ttm_manager_type(bdev, mem_type);
96 
97 	return 0;
98 }
99 
100 /**
101  * intel_region_ttm_fini - Finalize a TTM region.
102  * @mem: The memory region
103  *
104  * This functions takes down the TTM resource manager associated with the
105  * memory region, and if it was registered with the TTM device,
106  * removes that registration.
107  */
108 int intel_region_ttm_fini(struct intel_memory_region *mem)
109 {
110 	struct ttm_resource_manager *man = mem->region_private;
111 	int ret = -EBUSY;
112 	int count;
113 
114 	/*
115 	 * Put the region's move fences. This releases requests that
116 	 * may hold on to contexts and vms that may hold on to buffer
117 	 * objects placed in this region.
118 	 */
119 	if (man)
120 		ttm_resource_manager_cleanup(man);
121 
122 	/* Flush objects from region. */
123 	for (count = 0; count < 10; ++count) {
124 		i915_gem_flush_free_objects(mem->i915);
125 
126 		mutex_lock(&mem->objects.lock);
127 		if (list_empty(&mem->objects.list))
128 			ret = 0;
129 		mutex_unlock(&mem->objects.lock);
130 		if (!ret)
131 			break;
132 
133 		msleep(20);
134 		drain_workqueue(mem->i915->bdev.wq);
135 	}
136 
137 	/* If we leaked objects, Don't free the region causing use after free */
138 	if (ret || !man)
139 		return ret;
140 
141 	ret = i915_ttm_buddy_man_fini(&mem->i915->bdev,
142 				      intel_region_to_ttm_type(mem));
143 	GEM_WARN_ON(ret);
144 	mem->region_private = NULL;
145 
146 	return ret;
147 }
148 
149 /**
150  * intel_region_ttm_resource_to_rsgt -
151  * Convert an opaque TTM resource manager resource to a refcounted sg_table.
152  * @mem: The memory region.
153  * @res: The resource manager resource obtained from the TTM resource manager.
154  * @page_alignment: Required page alignment for each sg entry. Power of two.
155  *
156  * The gem backends typically use sg-tables for operations on the underlying
157  * io_memory. So provide a way for the backends to translate the
158  * nodes they are handed from TTM to sg-tables.
159  *
160  * Return: A malloced sg_table on success, an error pointer on failure.
161  */
162 struct i915_refct_sgt *
163 intel_region_ttm_resource_to_rsgt(struct intel_memory_region *mem,
164 				  struct ttm_resource *res,
165 				  u32 page_alignment)
166 {
167 	if (mem->is_range_manager) {
168 		struct ttm_range_mgr_node *range_node =
169 			to_ttm_range_mgr_node(res);
170 
171 		return i915_rsgt_from_mm_node(&range_node->mm_nodes[0],
172 					      mem->region.start,
173 					      page_alignment);
174 	} else {
175 		return i915_rsgt_from_buddy_resource(res, mem->region.start,
176 						     page_alignment);
177 	}
178 }
179 
180 #ifdef CONFIG_DRM_I915_SELFTEST
181 /**
182  * intel_region_ttm_resource_alloc - Allocate memory resources from a region
183  * @mem: The memory region,
184  * @size: The requested size in bytes
185  * @flags: Allocation flags
186  *
187  * This functionality is provided only for callers that need to allocate
188  * memory from standalone TTM range managers, without the TTM eviction
189  * functionality. Don't use if you are not completely sure that's the
190  * case. The returned opaque node can be converted to an sg_table using
191  * intel_region_ttm_resource_to_st(), and can be freed using
192  * intel_region_ttm_resource_free().
193  *
194  * Return: A valid pointer on success, an error pointer on failure.
195  */
196 struct ttm_resource *
197 intel_region_ttm_resource_alloc(struct intel_memory_region *mem,
198 				resource_size_t offset,
199 				resource_size_t size,
200 				unsigned int flags)
201 {
202 	struct ttm_resource_manager *man = mem->region_private;
203 	struct ttm_place place = {};
204 	struct ttm_buffer_object mock_bo = {};
205 	struct ttm_resource *res;
206 	int ret;
207 
208 	if (flags & I915_BO_ALLOC_CONTIGUOUS)
209 		place.flags |= TTM_PL_FLAG_CONTIGUOUS;
210 	if (offset != I915_BO_INVALID_OFFSET) {
211 		if (WARN_ON(overflows_type(offset >> PAGE_SHIFT, place.fpfn))) {
212 			ret = -E2BIG;
213 			goto out;
214 		}
215 		place.fpfn = offset >> PAGE_SHIFT;
216 		if (WARN_ON(overflows_type(place.fpfn + (size >> PAGE_SHIFT), place.lpfn))) {
217 			ret = -E2BIG;
218 			goto out;
219 		}
220 		place.lpfn = place.fpfn + (size >> PAGE_SHIFT);
221 	} else if (mem->io_size && mem->io_size < mem->total) {
222 		if (flags & I915_BO_ALLOC_GPU_ONLY) {
223 			place.flags |= TTM_PL_FLAG_TOPDOWN;
224 		} else {
225 			place.fpfn = 0;
226 			if (WARN_ON(overflows_type(mem->io_size >> PAGE_SHIFT, place.lpfn))) {
227 				ret = -E2BIG;
228 				goto out;
229 			}
230 			place.lpfn = mem->io_size >> PAGE_SHIFT;
231 		}
232 	}
233 
234 	mock_bo.base.size = size;
235 	mock_bo.bdev = &mem->i915->bdev;
236 
237 	ret = man->func->alloc(man, &mock_bo, &place, &res);
238 
239 out:
240 	if (ret == -ENOSPC)
241 		ret = -ENXIO;
242 	if (!ret)
243 		res->bo = NULL; /* Rather blow up, then some uaf */
244 	return ret ? ERR_PTR(ret) : res;
245 }
246 
247 #endif
248 
249 /**
250  * intel_region_ttm_resource_free - Free a resource allocated from a resource manager
251  * @mem: The region the resource was allocated from.
252  * @res: The opaque resource representing an allocation.
253  */
254 void intel_region_ttm_resource_free(struct intel_memory_region *mem,
255 				    struct ttm_resource *res)
256 {
257 	struct ttm_resource_manager *man = mem->region_private;
258 	struct ttm_buffer_object mock_bo = {};
259 
260 	mock_bo.base.size = res->size;
261 	mock_bo.bdev = &mem->i915->bdev;
262 	res->bo = &mock_bo;
263 
264 	man->func->free(man, res);
265 }
266