blob: 480c87d8edc50cc46aad4c612b1f6f4942d9a8a1 [file] [log] [blame]
Jerome Glisse771fe6b2009-06-05 14:42:42 +02001/*
2 * Copyright 2009 Jerome Glisse.
3 * All Rights Reserved.
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sub license, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
12 *
13 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
16 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
17 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
18 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
19 * USE OR OTHER DEALINGS IN THE SOFTWARE.
20 *
21 * The above copyright notice and this permission notice (including the
22 * next paragraph) shall be included in all copies or substantial portions
23 * of the Software.
24 *
25 */
26/*
27 * Authors:
28 * Jerome Glisse <glisse@freedesktop.org>
29 * Thomas Hellstrom <thomas-at-tungstengraphics-dot-com>
30 * Dave Airlie
31 */
32#include <linux/list.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090033#include <linux/slab.h>
Jerome Glisse771fe6b2009-06-05 14:42:42 +020034#include <drm/drmP.h>
David Howells760285e2012-10-02 18:01:07 +010035#include <drm/radeon_drm.h>
Jerome Glisse771fe6b2009-06-05 14:42:42 +020036#include "radeon.h"
Dave Airlie99ee7fa2010-11-23 11:47:49 +100037#include "radeon_trace.h"
Jerome Glisse771fe6b2009-06-05 14:42:42 +020038
Jerome Glisse771fe6b2009-06-05 14:42:42 +020039
40int radeon_ttm_init(struct radeon_device *rdev);
41void radeon_ttm_fini(struct radeon_device *rdev);
Jerome Glisse4c788672009-11-20 14:29:23 +010042static void radeon_bo_clear_surface_reg(struct radeon_bo *bo);
Jerome Glisse771fe6b2009-06-05 14:42:42 +020043
44/*
45 * To exclude mutual BO access we rely on bo_reserve exclusion, as all
46 * function are calling it.
47 */
48
Marek Olšák67e8e3f2014-03-02 00:56:18 +010049static void radeon_update_memory_usage(struct radeon_bo *bo,
50 unsigned mem_type, int sign)
51{
52 struct radeon_device *rdev = bo->rdev;
53 u64 size = (u64)bo->tbo.num_pages << PAGE_SHIFT;
54
55 switch (mem_type) {
56 case TTM_PL_TT:
57 if (sign > 0)
58 atomic64_add(size, &rdev->gtt_usage);
59 else
60 atomic64_sub(size, &rdev->gtt_usage);
61 break;
62 case TTM_PL_VRAM:
63 if (sign > 0)
64 atomic64_add(size, &rdev->vram_usage);
65 else
66 atomic64_sub(size, &rdev->vram_usage);
67 break;
68 }
69}
70
Jerome Glisse4c788672009-11-20 14:29:23 +010071static void radeon_ttm_bo_destroy(struct ttm_buffer_object *tbo)
Jerome Glisse771fe6b2009-06-05 14:42:42 +020072{
Jerome Glisse4c788672009-11-20 14:29:23 +010073 struct radeon_bo *bo;
74
75 bo = container_of(tbo, struct radeon_bo, tbo);
Marek Olšák67e8e3f2014-03-02 00:56:18 +010076
77 radeon_update_memory_usage(bo, bo->tbo.mem.mem_type, -1);
78
Jerome Glisse4c788672009-11-20 14:29:23 +010079 mutex_lock(&bo->rdev->gem.mutex);
80 list_del_init(&bo->list);
81 mutex_unlock(&bo->rdev->gem.mutex);
82 radeon_bo_clear_surface_reg(bo);
Christian Königc265f242014-07-18 09:24:54 +020083 WARN_ON(!list_empty(&bo->va));
Daniel Vetter441921d2011-02-18 17:59:16 +010084 drm_gem_object_release(&bo->gem_base);
Jerome Glisse4c788672009-11-20 14:29:23 +010085 kfree(bo);
Jerome Glisse771fe6b2009-06-05 14:42:42 +020086}
87
Jerome Glissed03d8582009-12-14 21:02:09 +010088bool radeon_ttm_bo_is_radeon_bo(struct ttm_buffer_object *bo)
89{
90 if (bo->destroy == &radeon_ttm_bo_destroy)
91 return true;
92 return false;
93}
94
Jerome Glisse312ea8d2009-12-07 15:52:58 +010095void radeon_ttm_placement_from_domain(struct radeon_bo *rbo, u32 domain)
96{
Lauri Kasanendeadcb32014-04-02 20:33:42 +030097 u32 c = 0, i;
Jerome Glisse312ea8d2009-12-07 15:52:58 +010098
99 rbo->placement.fpfn = 0;
Jerome Glisse93225b02010-12-03 16:38:19 -0500100 rbo->placement.lpfn = 0;
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100101 rbo->placement.placement = rbo->placements;
Alex Deucher20707872013-01-17 13:10:50 -0500102 rbo->placement.busy_placement = rbo->placements;
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100103 if (domain & RADEON_GEM_DOMAIN_VRAM)
104 rbo->placements[c++] = TTM_PL_FLAG_WC | TTM_PL_FLAG_UNCACHED |
105 TTM_PL_FLAG_VRAM;
Jerome Glisse0d0b3e72012-11-28 13:47:55 -0500106 if (domain & RADEON_GEM_DOMAIN_GTT) {
Michel Dänzer02376d82014-07-17 19:01:08 +0900107 if (rbo->flags & RADEON_GEM_GTT_UC) {
108 rbo->placements[c++] = TTM_PL_FLAG_UNCACHED | TTM_PL_FLAG_TT;
109 } else if ((rbo->flags & RADEON_GEM_GTT_WC) ||
110 (rbo->rdev->flags & RADEON_IS_AGP)) {
111 rbo->placements[c++] = TTM_PL_FLAG_WC | TTM_PL_FLAG_UNCACHED |
112 TTM_PL_FLAG_TT;
Jerome Glisse0d0b3e72012-11-28 13:47:55 -0500113 } else {
114 rbo->placements[c++] = TTM_PL_FLAG_CACHED | TTM_PL_FLAG_TT;
115 }
116 }
117 if (domain & RADEON_GEM_DOMAIN_CPU) {
Michel Dänzer02376d82014-07-17 19:01:08 +0900118 if (rbo->flags & RADEON_GEM_GTT_UC) {
119 rbo->placements[c++] = TTM_PL_FLAG_UNCACHED | TTM_PL_FLAG_SYSTEM;
120 } else if ((rbo->flags & RADEON_GEM_GTT_WC) ||
121 rbo->rdev->flags & RADEON_IS_AGP) {
122 rbo->placements[c++] = TTM_PL_FLAG_WC | TTM_PL_FLAG_UNCACHED |
123 TTM_PL_FLAG_SYSTEM;
Jerome Glisse0d0b3e72012-11-28 13:47:55 -0500124 } else {
Dave Airliedd54fee72012-12-14 21:04:46 +1000125 rbo->placements[c++] = TTM_PL_FLAG_CACHED | TTM_PL_FLAG_SYSTEM;
Jerome Glisse0d0b3e72012-11-28 13:47:55 -0500126 }
127 }
Jerome Glisse9fb03e62009-12-11 15:13:22 +0100128 if (!c)
129 rbo->placements[c++] = TTM_PL_MASK_CACHING | TTM_PL_FLAG_SYSTEM;
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100130 rbo->placement.num_placement = c;
131 rbo->placement.num_busy_placement = c;
Lauri Kasanendeadcb32014-04-02 20:33:42 +0300132
133 /*
134 * Use two-ended allocation depending on the buffer size to
135 * improve fragmentation quality.
136 * 512kb was measured as the most optimal number.
137 */
138 if (rbo->tbo.mem.size > 512 * 1024) {
139 for (i = 0; i < c; i++) {
140 rbo->placements[i] |= TTM_PL_FLAG_TOPDOWN;
141 }
142 }
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100143}
144
Daniel Vetter441921d2011-02-18 17:59:16 +0100145int radeon_bo_create(struct radeon_device *rdev,
Alex Deucher268b2512010-11-17 19:00:26 -0500146 unsigned long size, int byte_align, bool kernel, u32 domain,
Michel Dänzer02376d82014-07-17 19:01:08 +0900147 u32 flags, struct sg_table *sg, struct radeon_bo **bo_ptr)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200148{
Jerome Glisse4c788672009-11-20 14:29:23 +0100149 struct radeon_bo *bo;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200150 enum ttm_bo_type type;
Jerome Glisse93225b02010-12-03 16:38:19 -0500151 unsigned long page_align = roundup(byte_align, PAGE_SIZE) >> PAGE_SHIFT;
Jerome Glisse57de4ba2011-11-11 15:42:57 -0500152 size_t acc_size;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200153 int r;
154
Daniel Vetter441921d2011-02-18 17:59:16 +0100155 size = ALIGN(size, PAGE_SIZE);
156
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200157 if (kernel) {
158 type = ttm_bo_type_kernel;
Alex Deucher40f5cf92012-05-10 18:33:13 -0400159 } else if (sg) {
160 type = ttm_bo_type_sg;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200161 } else {
162 type = ttm_bo_type_device;
163 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100164 *bo_ptr = NULL;
Michel Dänzer2b66b502010-11-09 11:50:05 +0100165
Jerome Glisse57de4ba2011-11-11 15:42:57 -0500166 acc_size = ttm_bo_dma_acc_size(&rdev->mman.bdev, size,
167 sizeof(struct radeon_bo));
168
Jerome Glisse4c788672009-11-20 14:29:23 +0100169 bo = kzalloc(sizeof(struct radeon_bo), GFP_KERNEL);
170 if (bo == NULL)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200171 return -ENOMEM;
Daniel Vetter441921d2011-02-18 17:59:16 +0100172 r = drm_gem_object_init(rdev->ddev, &bo->gem_base, size);
173 if (unlikely(r)) {
174 kfree(bo);
175 return r;
176 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100177 bo->rdev = rdev;
Jerome Glisse4c788672009-11-20 14:29:23 +0100178 bo->surface_reg = -1;
179 INIT_LIST_HEAD(&bo->list);
Jerome Glisse721604a2012-01-05 22:11:05 -0500180 INIT_LIST_HEAD(&bo->va);
Marek Olšákbda72d52014-03-02 00:56:17 +0100181 bo->initial_domain = domain & (RADEON_GEM_DOMAIN_VRAM |
182 RADEON_GEM_DOMAIN_GTT |
183 RADEON_GEM_DOMAIN_CPU);
Michel Dänzer02376d82014-07-17 19:01:08 +0900184
185 bo->flags = flags;
186 /* PCI GART is always snooped */
187 if (!(rdev->flags & RADEON_IS_PCIE))
188 bo->flags &= ~(RADEON_GEM_GTT_WC | RADEON_GEM_GTT_UC);
189
Jerome Glisse1fb107f2009-12-10 17:16:28 +0100190 radeon_ttm_placement_from_domain(bo, domain);
Thomas Hellstrom5cc6fba2009-12-07 18:36:19 +0100191 /* Kernel allocation are uninterruptible */
Christian Königdb7fce32012-05-11 14:57:18 +0200192 down_read(&rdev->pm.mclk_lock);
Jerome Glisse1fb107f2009-12-10 17:16:28 +0100193 r = ttm_bo_init(&rdev->mman.bdev, &bo->tbo, size, type,
Marcin Slusarz0b91c4a2012-11-06 21:49:51 +0000194 &bo->placement, page_align, !kernel, NULL,
Alex Deucher40f5cf92012-05-10 18:33:13 -0400195 acc_size, sg, &radeon_ttm_bo_destroy);
Christian Königdb7fce32012-05-11 14:57:18 +0200196 up_read(&rdev->pm.mclk_lock);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200197 if (unlikely(r != 0)) {
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200198 return r;
199 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100200 *bo_ptr = bo;
Daniel Vetter441921d2011-02-18 17:59:16 +0100201
Dave Airlie99ee7fa2010-11-23 11:47:49 +1000202 trace_radeon_bo_create(bo);
Daniel Vetter441921d2011-02-18 17:59:16 +0100203
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200204 return 0;
205}
206
Jerome Glisse4c788672009-11-20 14:29:23 +0100207int radeon_bo_kmap(struct radeon_bo *bo, void **ptr)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200208{
Jerome Glisse4c788672009-11-20 14:29:23 +0100209 bool is_iomem;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200210 int r;
211
Jerome Glisse4c788672009-11-20 14:29:23 +0100212 if (bo->kptr) {
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200213 if (ptr) {
Jerome Glisse4c788672009-11-20 14:29:23 +0100214 *ptr = bo->kptr;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200215 }
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200216 return 0;
217 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100218 r = ttm_bo_kmap(&bo->tbo, 0, bo->tbo.num_pages, &bo->kmap);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200219 if (r) {
220 return r;
221 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100222 bo->kptr = ttm_kmap_obj_virtual(&bo->kmap, &is_iomem);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200223 if (ptr) {
Jerome Glisse4c788672009-11-20 14:29:23 +0100224 *ptr = bo->kptr;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200225 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100226 radeon_bo_check_tiling(bo, 0, 0);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200227 return 0;
228}
229
Jerome Glisse4c788672009-11-20 14:29:23 +0100230void radeon_bo_kunmap(struct radeon_bo *bo)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200231{
Jerome Glisse4c788672009-11-20 14:29:23 +0100232 if (bo->kptr == NULL)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200233 return;
Jerome Glisse4c788672009-11-20 14:29:23 +0100234 bo->kptr = NULL;
235 radeon_bo_check_tiling(bo, 0, 0);
236 ttm_bo_kunmap(&bo->kmap);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200237}
238
Christian König512d8af2014-07-30 21:04:56 +0200239struct radeon_bo *radeon_bo_ref(struct radeon_bo *bo)
240{
241 if (bo == NULL)
242 return NULL;
243
244 ttm_bo_reference(&bo->tbo);
245 return bo;
246}
247
Jerome Glisse4c788672009-11-20 14:29:23 +0100248void radeon_bo_unref(struct radeon_bo **bo)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200249{
Jerome Glisse4c788672009-11-20 14:29:23 +0100250 struct ttm_buffer_object *tbo;
Dave Airlief4b7fb92010-04-29 18:37:59 +1000251 struct radeon_device *rdev;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200252
Jerome Glisse4c788672009-11-20 14:29:23 +0100253 if ((*bo) == NULL)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200254 return;
Dave Airlief4b7fb92010-04-29 18:37:59 +1000255 rdev = (*bo)->rdev;
Jerome Glisse4c788672009-11-20 14:29:23 +0100256 tbo = &((*bo)->tbo);
257 ttm_bo_unref(&tbo);
258 if (tbo == NULL)
259 *bo = NULL;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200260}
261
Michel Dänzerc4353012012-03-14 17:12:41 +0100262int radeon_bo_pin_restricted(struct radeon_bo *bo, u32 domain, u64 max_offset,
263 u64 *gpu_addr)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200264{
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100265 int r, i;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200266
Jerome Glisse4c788672009-11-20 14:29:23 +0100267 if (bo->pin_count) {
268 bo->pin_count++;
269 if (gpu_addr)
270 *gpu_addr = radeon_bo_gpu_offset(bo);
Michel Dänzerd9366222012-03-28 08:52:32 +0200271
272 if (max_offset != 0) {
273 u64 domain_start;
274
275 if (domain == RADEON_GEM_DOMAIN_VRAM)
276 domain_start = bo->rdev->mc.vram_start;
277 else
278 domain_start = bo->rdev->mc.gtt_start;
Michel Dänzere199fd42012-03-29 16:47:43 +0200279 WARN_ON_ONCE(max_offset <
280 (radeon_bo_gpu_offset(bo) - domain_start));
Michel Dänzerd9366222012-03-28 08:52:32 +0200281 }
282
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200283 return 0;
284 }
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100285 radeon_ttm_placement_from_domain(bo, domain);
Michel Dänzer3ca82da2010-03-26 19:18:55 +0000286 if (domain == RADEON_GEM_DOMAIN_VRAM) {
287 /* force to pin into visible video ram */
288 bo->placement.lpfn = bo->rdev->mc.visible_vram_size >> PAGE_SHIFT;
289 }
Michel Dänzerc4353012012-03-14 17:12:41 +0100290 if (max_offset) {
291 u64 lpfn = max_offset >> PAGE_SHIFT;
292
293 if (!bo->placement.lpfn)
294 bo->placement.lpfn = bo->rdev->mc.gtt_size >> PAGE_SHIFT;
295
296 if (lpfn < bo->placement.lpfn)
297 bo->placement.lpfn = lpfn;
298 }
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100299 for (i = 0; i < bo->placement.num_placement; i++)
300 bo->placements[i] |= TTM_PL_FLAG_NO_EVICT;
Maarten Lankhorst97a875c2012-11-28 11:25:44 +0000301 r = ttm_bo_validate(&bo->tbo, &bo->placement, false, false);
Jerome Glisse4c788672009-11-20 14:29:23 +0100302 if (likely(r == 0)) {
303 bo->pin_count = 1;
304 if (gpu_addr != NULL)
305 *gpu_addr = radeon_bo_gpu_offset(bo);
Alex Deucher71ecc972014-07-17 12:09:25 -0400306 if (domain == RADEON_GEM_DOMAIN_VRAM)
307 bo->rdev->vram_pin_size += radeon_bo_size(bo);
308 else
309 bo->rdev->gart_pin_size += radeon_bo_size(bo);
310 } else {
Jerome Glisse4c788672009-11-20 14:29:23 +0100311 dev_err(bo->rdev->dev, "%p pin failed\n", bo);
Alex Deucher71ecc972014-07-17 12:09:25 -0400312 }
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200313 return r;
314}
315
Michel Dänzerc4353012012-03-14 17:12:41 +0100316int radeon_bo_pin(struct radeon_bo *bo, u32 domain, u64 *gpu_addr)
317{
318 return radeon_bo_pin_restricted(bo, domain, 0, gpu_addr);
319}
320
Jerome Glisse4c788672009-11-20 14:29:23 +0100321int radeon_bo_unpin(struct radeon_bo *bo)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200322{
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100323 int r, i;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200324
Jerome Glisse4c788672009-11-20 14:29:23 +0100325 if (!bo->pin_count) {
326 dev_warn(bo->rdev->dev, "%p unpin not necessary\n", bo);
327 return 0;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200328 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100329 bo->pin_count--;
330 if (bo->pin_count)
331 return 0;
Jerome Glisse312ea8d2009-12-07 15:52:58 +0100332 for (i = 0; i < bo->placement.num_placement; i++)
333 bo->placements[i] &= ~TTM_PL_FLAG_NO_EVICT;
Maarten Lankhorst97a875c2012-11-28 11:25:44 +0000334 r = ttm_bo_validate(&bo->tbo, &bo->placement, false, false);
Alex Deucher71ecc972014-07-17 12:09:25 -0400335 if (likely(r == 0)) {
336 if (bo->tbo.mem.mem_type == TTM_PL_VRAM)
337 bo->rdev->vram_pin_size -= radeon_bo_size(bo);
338 else
339 bo->rdev->gart_pin_size -= radeon_bo_size(bo);
340 } else {
Jerome Glisse4c788672009-11-20 14:29:23 +0100341 dev_err(bo->rdev->dev, "%p validate failed for unpin\n", bo);
Alex Deucher71ecc972014-07-17 12:09:25 -0400342 }
Thomas Hellstrom5cc6fba2009-12-07 18:36:19 +0100343 return r;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200344}
345
Jerome Glisse4c788672009-11-20 14:29:23 +0100346int radeon_bo_evict_vram(struct radeon_device *rdev)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200347{
Dave Airlied796d842010-01-25 13:08:08 +1000348 /* late 2.6.33 fix IGP hibernate - we need pm ops to do this correct */
349 if (0 && (rdev->flags & RADEON_IS_IGP)) {
Alex Deucher06b64762010-01-05 11:27:29 -0500350 if (rdev->mc.igp_sideport_enabled == false)
351 /* Useless to evict on IGP chips */
352 return 0;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200353 }
354 return ttm_bo_evict_mm(&rdev->mman.bdev, TTM_PL_VRAM);
355}
356
Jerome Glisse4c788672009-11-20 14:29:23 +0100357void radeon_bo_force_delete(struct radeon_device *rdev)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200358{
Jerome Glisse4c788672009-11-20 14:29:23 +0100359 struct radeon_bo *bo, *n;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200360
361 if (list_empty(&rdev->gem.objects)) {
362 return;
363 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100364 dev_err(rdev->dev, "Userspace still has active objects !\n");
365 list_for_each_entry_safe(bo, n, &rdev->gem.objects, list) {
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200366 mutex_lock(&rdev->ddev->struct_mutex);
Jerome Glisse4c788672009-11-20 14:29:23 +0100367 dev_err(rdev->dev, "%p %p %lu %lu force free\n",
Daniel Vetter31c36032011-02-18 17:59:18 +0100368 &bo->gem_base, bo, (unsigned long)bo->gem_base.size,
369 *((unsigned long *)&bo->gem_base.refcount));
Jerome Glisse4c788672009-11-20 14:29:23 +0100370 mutex_lock(&bo->rdev->gem.mutex);
371 list_del_init(&bo->list);
372 mutex_unlock(&bo->rdev->gem.mutex);
Dave Airlie91132d62011-03-01 13:40:06 +1000373 /* this should unref the ttm bo */
Daniel Vetter31c36032011-02-18 17:59:18 +0100374 drm_gem_object_unreference(&bo->gem_base);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200375 mutex_unlock(&rdev->ddev->struct_mutex);
376 }
377}
378
Jerome Glisse4c788672009-11-20 14:29:23 +0100379int radeon_bo_init(struct radeon_device *rdev)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200380{
Jerome Glissea4d68272009-09-11 13:00:43 +0200381 /* Add an MTRR for the VRAM */
Samuel Lia0a53aa2013-04-08 17:25:47 -0400382 if (!rdev->fastfb_working) {
Andy Lutomirski07ebea22013-05-13 23:58:45 +0000383 rdev->mc.vram_mtrr = arch_phys_wc_add(rdev->mc.aper_base,
384 rdev->mc.aper_size);
Samuel Lia0a53aa2013-04-08 17:25:47 -0400385 }
Jerome Glissea4d68272009-09-11 13:00:43 +0200386 DRM_INFO("Detected VRAM RAM=%lluM, BAR=%lluM\n",
387 rdev->mc.mc_vram_size >> 20,
388 (unsigned long long)rdev->mc.aper_size >> 20);
389 DRM_INFO("RAM width %dbits %cDR\n",
390 rdev->mc.vram_width, rdev->mc.vram_is_ddr ? 'D' : 'S');
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200391 return radeon_ttm_init(rdev);
392}
393
Jerome Glisse4c788672009-11-20 14:29:23 +0100394void radeon_bo_fini(struct radeon_device *rdev)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200395{
396 radeon_ttm_fini(rdev);
Andy Lutomirski07ebea22013-05-13 23:58:45 +0000397 arch_phys_wc_del(rdev->mc.vram_mtrr);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200398}
399
Marek Olšák19dff562014-03-02 00:56:22 +0100400/* Returns how many bytes TTM can move per IB.
401 */
402static u64 radeon_bo_get_threshold_for_moves(struct radeon_device *rdev)
403{
404 u64 real_vram_size = rdev->mc.real_vram_size;
405 u64 vram_usage = atomic64_read(&rdev->vram_usage);
406
407 /* This function is based on the current VRAM usage.
408 *
409 * - If all of VRAM is free, allow relocating the number of bytes that
410 * is equal to 1/4 of the size of VRAM for this IB.
411
412 * - If more than one half of VRAM is occupied, only allow relocating
413 * 1 MB of data for this IB.
414 *
415 * - From 0 to one half of used VRAM, the threshold decreases
416 * linearly.
417 * __________________
418 * 1/4 of -|\ |
419 * VRAM | \ |
420 * | \ |
421 * | \ |
422 * | \ |
423 * | \ |
424 * | \ |
425 * | \________|1 MB
426 * |----------------|
427 * VRAM 0 % 100 %
428 * used used
429 *
430 * Note: It's a threshold, not a limit. The threshold must be crossed
431 * for buffer relocations to stop, so any buffer of an arbitrary size
432 * can be moved as long as the threshold isn't crossed before
433 * the relocation takes place. We don't want to disable buffer
434 * relocations completely.
435 *
436 * The idea is that buffers should be placed in VRAM at creation time
437 * and TTM should only do a minimum number of relocations during
438 * command submission. In practice, you need to submit at least
439 * a dozen IBs to move all buffers to VRAM if they are in GTT.
440 *
441 * Also, things can get pretty crazy under memory pressure and actual
442 * VRAM usage can change a lot, so playing safe even at 50% does
443 * consistently increase performance.
444 */
445
446 u64 half_vram = real_vram_size >> 1;
447 u64 half_free_vram = vram_usage >= half_vram ? 0 : half_vram - vram_usage;
448 u64 bytes_moved_threshold = half_free_vram >> 1;
449 return max(bytes_moved_threshold, 1024*1024ull);
450}
451
452int radeon_bo_list_validate(struct radeon_device *rdev,
453 struct ww_acquire_ctx *ticket,
Maarten Lankhorstecff6652013-06-27 13:48:17 +0200454 struct list_head *head, int ring)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200455{
Christian Königdf0af442014-03-03 12:38:08 +0100456 struct radeon_cs_reloc *lobj;
Jerome Glisse4c788672009-11-20 14:29:23 +0100457 struct radeon_bo *bo;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200458 int r;
Marek Olšák19dff562014-03-02 00:56:22 +0100459 u64 bytes_moved = 0, initial_bytes_moved;
460 u64 bytes_moved_threshold = radeon_bo_get_threshold_for_moves(rdev);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200461
Maarten Lankhorstecff6652013-06-27 13:48:17 +0200462 r = ttm_eu_reserve_buffers(ticket, head);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200463 if (unlikely(r != 0)) {
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200464 return r;
465 }
Marek Olšák19dff562014-03-02 00:56:22 +0100466
Thomas Hellstrom147666f2010-11-17 12:38:32 +0000467 list_for_each_entry(lobj, head, tv.head) {
Christian Königdf0af442014-03-03 12:38:08 +0100468 bo = lobj->robj;
Jerome Glisse4c788672009-11-20 14:29:23 +0100469 if (!bo->pin_count) {
Christian Königce6758c2014-06-02 17:33:07 +0200470 u32 domain = lobj->prefered_domains;
Marek Olšák19dff562014-03-02 00:56:22 +0100471 u32 current_domain =
472 radeon_mem_type_to_domain(bo->tbo.mem.mem_type);
473
474 /* Check if this buffer will be moved and don't move it
475 * if we have moved too many buffers for this IB already.
476 *
477 * Note that this allows moving at least one buffer of
478 * any size, because it doesn't take the current "bo"
479 * into account. We don't want to disallow buffer moves
480 * completely.
481 */
Christian Königce6758c2014-06-02 17:33:07 +0200482 if ((lobj->allowed_domains & current_domain) != 0 &&
Marek Olšák19dff562014-03-02 00:56:22 +0100483 (domain & current_domain) == 0 && /* will be moved */
484 bytes_moved > bytes_moved_threshold) {
485 /* don't move it */
486 domain = current_domain;
487 }
488
Alex Deucher20707872013-01-17 13:10:50 -0500489 retry:
490 radeon_ttm_placement_from_domain(bo, domain);
Christian Königf2ba57b2013-04-08 12:41:29 +0200491 if (ring == R600_RING_TYPE_UVD_INDEX)
492 radeon_uvd_force_into_uvd_segment(bo);
Marek Olšák19dff562014-03-02 00:56:22 +0100493
494 initial_bytes_moved = atomic64_read(&rdev->num_bytes_moved);
495 r = ttm_bo_validate(&bo->tbo, &bo->placement, true, false);
496 bytes_moved += atomic64_read(&rdev->num_bytes_moved) -
497 initial_bytes_moved;
498
Michel Dänzere376573f2010-07-08 12:43:28 +1000499 if (unlikely(r)) {
Christian Königce6758c2014-06-02 17:33:07 +0200500 if (r != -ERESTARTSYS &&
501 domain != lobj->allowed_domains) {
502 domain = lobj->allowed_domains;
Alex Deucher20707872013-01-17 13:10:50 -0500503 goto retry;
504 }
Maarten Lankhorst1b6e5fd2013-07-10 12:26:56 +0200505 ttm_eu_backoff_reservation(ticket, head);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200506 return r;
Michel Dänzere376573f2010-07-08 12:43:28 +1000507 }
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200508 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100509 lobj->gpu_offset = radeon_bo_gpu_offset(bo);
510 lobj->tiling_flags = bo->tiling_flags;
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200511 }
512 return 0;
513}
514
Jerome Glisse4c788672009-11-20 14:29:23 +0100515int radeon_bo_fbdev_mmap(struct radeon_bo *bo,
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200516 struct vm_area_struct *vma)
517{
Jerome Glisse4c788672009-11-20 14:29:23 +0100518 return ttm_fbdev_mmap(vma, &bo->tbo);
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200519}
520
Dave Airlie550e2d92009-12-09 14:15:38 +1000521int radeon_bo_get_surface_reg(struct radeon_bo *bo)
Jerome Glisse771fe6b2009-06-05 14:42:42 +0200522{
Jerome Glisse4c788672009-11-20 14:29:23 +0100523 struct radeon_device *rdev = bo->rdev;
Dave Airliee024e112009-06-24 09:48:08 +1000524 struct radeon_surface_reg *reg;
Jerome Glisse4c788672009-11-20 14:29:23 +0100525 struct radeon_bo *old_object;
Dave Airliee024e112009-06-24 09:48:08 +1000526 int steal;
527 int i;
528
Maarten Lankhorst977c38d2013-06-27 13:48:26 +0200529 lockdep_assert_held(&bo->tbo.resv->lock.base);
Jerome Glisse4c788672009-11-20 14:29:23 +0100530
531 if (!bo->tiling_flags)
Dave Airliee024e112009-06-24 09:48:08 +1000532 return 0;
533
Jerome Glisse4c788672009-11-20 14:29:23 +0100534 if (bo->surface_reg >= 0) {
535 reg = &rdev->surface_regs[bo->surface_reg];
536 i = bo->surface_reg;
Dave Airliee024e112009-06-24 09:48:08 +1000537 goto out;
538 }
539
540 steal = -1;
541 for (i = 0; i < RADEON_GEM_MAX_SURFACES; i++) {
542
543 reg = &rdev->surface_regs[i];
Jerome Glisse4c788672009-11-20 14:29:23 +0100544 if (!reg->bo)
Dave Airliee024e112009-06-24 09:48:08 +1000545 break;
546
Jerome Glisse4c788672009-11-20 14:29:23 +0100547 old_object = reg->bo;
Dave Airliee024e112009-06-24 09:48:08 +1000548 if (old_object->pin_count == 0)
549 steal = i;
550 }
551
552 /* if we are all out */
553 if (i == RADEON_GEM_MAX_SURFACES) {
554 if (steal == -1)
555 return -ENOMEM;
556 /* find someone with a surface reg and nuke their BO */
557 reg = &rdev->surface_regs[steal];
Jerome Glisse4c788672009-11-20 14:29:23 +0100558 old_object = reg->bo;
Dave Airliee024e112009-06-24 09:48:08 +1000559 /* blow away the mapping */
560 DRM_DEBUG("stealing surface reg %d from %p\n", steal, old_object);
Jerome Glisse4c788672009-11-20 14:29:23 +0100561 ttm_bo_unmap_virtual(&old_object->tbo);
Dave Airliee024e112009-06-24 09:48:08 +1000562 old_object->surface_reg = -1;
563 i = steal;
564 }
565
Jerome Glisse4c788672009-11-20 14:29:23 +0100566 bo->surface_reg = i;
567 reg->bo = bo;
Dave Airliee024e112009-06-24 09:48:08 +1000568
569out:
Jerome Glisse4c788672009-11-20 14:29:23 +0100570 radeon_set_surface_reg(rdev, i, bo->tiling_flags, bo->pitch,
Ben Skeggsd961db72010-08-05 10:48:18 +1000571 bo->tbo.mem.start << PAGE_SHIFT,
Jerome Glisse4c788672009-11-20 14:29:23 +0100572 bo->tbo.num_pages << PAGE_SHIFT);
Dave Airliee024e112009-06-24 09:48:08 +1000573 return 0;
574}
575
Jerome Glisse4c788672009-11-20 14:29:23 +0100576static void radeon_bo_clear_surface_reg(struct radeon_bo *bo)
Dave Airliee024e112009-06-24 09:48:08 +1000577{
Jerome Glisse4c788672009-11-20 14:29:23 +0100578 struct radeon_device *rdev = bo->rdev;
Dave Airliee024e112009-06-24 09:48:08 +1000579 struct radeon_surface_reg *reg;
580
Jerome Glisse4c788672009-11-20 14:29:23 +0100581 if (bo->surface_reg == -1)
Dave Airliee024e112009-06-24 09:48:08 +1000582 return;
583
Jerome Glisse4c788672009-11-20 14:29:23 +0100584 reg = &rdev->surface_regs[bo->surface_reg];
585 radeon_clear_surface_reg(rdev, bo->surface_reg);
Dave Airliee024e112009-06-24 09:48:08 +1000586
Jerome Glisse4c788672009-11-20 14:29:23 +0100587 reg->bo = NULL;
588 bo->surface_reg = -1;
Dave Airliee024e112009-06-24 09:48:08 +1000589}
590
Jerome Glisse4c788672009-11-20 14:29:23 +0100591int radeon_bo_set_tiling_flags(struct radeon_bo *bo,
592 uint32_t tiling_flags, uint32_t pitch)
Dave Airliee024e112009-06-24 09:48:08 +1000593{
Jerome Glisse285484e2011-12-16 17:03:42 -0500594 struct radeon_device *rdev = bo->rdev;
Jerome Glisse4c788672009-11-20 14:29:23 +0100595 int r;
596
Jerome Glisse285484e2011-12-16 17:03:42 -0500597 if (rdev->family >= CHIP_CEDAR) {
598 unsigned bankw, bankh, mtaspect, tilesplit, stilesplit;
599
600 bankw = (tiling_flags >> RADEON_TILING_EG_BANKW_SHIFT) & RADEON_TILING_EG_BANKW_MASK;
601 bankh = (tiling_flags >> RADEON_TILING_EG_BANKH_SHIFT) & RADEON_TILING_EG_BANKH_MASK;
602 mtaspect = (tiling_flags >> RADEON_TILING_EG_MACRO_TILE_ASPECT_SHIFT) & RADEON_TILING_EG_MACRO_TILE_ASPECT_MASK;
603 tilesplit = (tiling_flags >> RADEON_TILING_EG_TILE_SPLIT_SHIFT) & RADEON_TILING_EG_TILE_SPLIT_MASK;
604 stilesplit = (tiling_flags >> RADEON_TILING_EG_STENCIL_TILE_SPLIT_SHIFT) & RADEON_TILING_EG_STENCIL_TILE_SPLIT_MASK;
605 switch (bankw) {
606 case 0:
607 case 1:
608 case 2:
609 case 4:
610 case 8:
611 break;
612 default:
613 return -EINVAL;
614 }
615 switch (bankh) {
616 case 0:
617 case 1:
618 case 2:
619 case 4:
620 case 8:
621 break;
622 default:
623 return -EINVAL;
624 }
625 switch (mtaspect) {
626 case 0:
627 case 1:
628 case 2:
629 case 4:
630 case 8:
631 break;
632 default:
633 return -EINVAL;
634 }
635 if (tilesplit > 6) {
636 return -EINVAL;
637 }
638 if (stilesplit > 6) {
639 return -EINVAL;
640 }
641 }
Jerome Glisse4c788672009-11-20 14:29:23 +0100642 r = radeon_bo_reserve(bo, false);
643 if (unlikely(r != 0))
644 return r;
645 bo->tiling_flags = tiling_flags;
646 bo->pitch = pitch;
647 radeon_bo_unreserve(bo);
648 return 0;
Dave Airliee024e112009-06-24 09:48:08 +1000649}
650
Jerome Glisse4c788672009-11-20 14:29:23 +0100651void radeon_bo_get_tiling_flags(struct radeon_bo *bo,
652 uint32_t *tiling_flags,
653 uint32_t *pitch)
Dave Airliee024e112009-06-24 09:48:08 +1000654{
Maarten Lankhorst977c38d2013-06-27 13:48:26 +0200655 lockdep_assert_held(&bo->tbo.resv->lock.base);
656
Dave Airliee024e112009-06-24 09:48:08 +1000657 if (tiling_flags)
Jerome Glisse4c788672009-11-20 14:29:23 +0100658 *tiling_flags = bo->tiling_flags;
Dave Airliee024e112009-06-24 09:48:08 +1000659 if (pitch)
Jerome Glisse4c788672009-11-20 14:29:23 +0100660 *pitch = bo->pitch;
Dave Airliee024e112009-06-24 09:48:08 +1000661}
662
Jerome Glisse4c788672009-11-20 14:29:23 +0100663int radeon_bo_check_tiling(struct radeon_bo *bo, bool has_moved,
664 bool force_drop)
Dave Airliee024e112009-06-24 09:48:08 +1000665{
Maarten Lankhorst977c38d2013-06-27 13:48:26 +0200666 if (!force_drop)
667 lockdep_assert_held(&bo->tbo.resv->lock.base);
Jerome Glisse4c788672009-11-20 14:29:23 +0100668
669 if (!(bo->tiling_flags & RADEON_TILING_SURFACE))
Dave Airliee024e112009-06-24 09:48:08 +1000670 return 0;
671
672 if (force_drop) {
Jerome Glisse4c788672009-11-20 14:29:23 +0100673 radeon_bo_clear_surface_reg(bo);
Dave Airliee024e112009-06-24 09:48:08 +1000674 return 0;
675 }
676
Jerome Glisse4c788672009-11-20 14:29:23 +0100677 if (bo->tbo.mem.mem_type != TTM_PL_VRAM) {
Dave Airliee024e112009-06-24 09:48:08 +1000678 if (!has_moved)
679 return 0;
680
Jerome Glisse4c788672009-11-20 14:29:23 +0100681 if (bo->surface_reg >= 0)
682 radeon_bo_clear_surface_reg(bo);
Dave Airliee024e112009-06-24 09:48:08 +1000683 return 0;
684 }
685
Jerome Glisse4c788672009-11-20 14:29:23 +0100686 if ((bo->surface_reg >= 0) && !has_moved)
Dave Airliee024e112009-06-24 09:48:08 +1000687 return 0;
688
Jerome Glisse4c788672009-11-20 14:29:23 +0100689 return radeon_bo_get_surface_reg(bo);
Dave Airliee024e112009-06-24 09:48:08 +1000690}
691
692void radeon_bo_move_notify(struct ttm_buffer_object *bo,
Marek Olšák67e8e3f2014-03-02 00:56:18 +0100693 struct ttm_mem_reg *new_mem)
Dave Airliee024e112009-06-24 09:48:08 +1000694{
Jerome Glissed03d8582009-12-14 21:02:09 +0100695 struct radeon_bo *rbo;
Marek Olšák67e8e3f2014-03-02 00:56:18 +0100696
Jerome Glissed03d8582009-12-14 21:02:09 +0100697 if (!radeon_ttm_bo_is_radeon_bo(bo))
698 return;
Marek Olšák67e8e3f2014-03-02 00:56:18 +0100699
Jerome Glissed03d8582009-12-14 21:02:09 +0100700 rbo = container_of(bo, struct radeon_bo, tbo);
Jerome Glisse4c788672009-11-20 14:29:23 +0100701 radeon_bo_check_tiling(rbo, 0, 1);
Jerome Glisse721604a2012-01-05 22:11:05 -0500702 radeon_vm_bo_invalidate(rbo->rdev, rbo);
Marek Olšák67e8e3f2014-03-02 00:56:18 +0100703
704 /* update statistics */
705 if (!new_mem)
706 return;
707
708 radeon_update_memory_usage(rbo, bo->mem.mem_type, -1);
709 radeon_update_memory_usage(rbo, new_mem->mem_type, 1);
Dave Airliee024e112009-06-24 09:48:08 +1000710}
711
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200712int radeon_bo_fault_reserve_notify(struct ttm_buffer_object *bo)
Dave Airliee024e112009-06-24 09:48:08 +1000713{
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200714 struct radeon_device *rdev;
Jerome Glissed03d8582009-12-14 21:02:09 +0100715 struct radeon_bo *rbo;
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200716 unsigned long offset, size;
717 int r;
718
Jerome Glissed03d8582009-12-14 21:02:09 +0100719 if (!radeon_ttm_bo_is_radeon_bo(bo))
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200720 return 0;
Jerome Glissed03d8582009-12-14 21:02:09 +0100721 rbo = container_of(bo, struct radeon_bo, tbo);
Jerome Glisse4c788672009-11-20 14:29:23 +0100722 radeon_bo_check_tiling(rbo, 0, 0);
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200723 rdev = rbo->rdev;
Christian König54409252014-05-05 18:40:12 +0200724 if (bo->mem.mem_type != TTM_PL_VRAM)
725 return 0;
726
727 size = bo->mem.num_pages << PAGE_SHIFT;
728 offset = bo->mem.start << PAGE_SHIFT;
729 if ((offset + size) <= rdev->mc.visible_vram_size)
730 return 0;
731
732 /* hurrah the memory is not visible ! */
733 radeon_ttm_placement_from_domain(rbo, RADEON_GEM_DOMAIN_VRAM);
734 rbo->placement.lpfn = rdev->mc.visible_vram_size >> PAGE_SHIFT;
735 r = ttm_bo_validate(bo, &rbo->placement, false, false);
736 if (unlikely(r == -ENOMEM)) {
737 radeon_ttm_placement_from_domain(rbo, RADEON_GEM_DOMAIN_GTT);
738 return ttm_bo_validate(bo, &rbo->placement, false, false);
739 } else if (unlikely(r != 0)) {
740 return r;
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200741 }
Christian König54409252014-05-05 18:40:12 +0200742
743 offset = bo->mem.start << PAGE_SHIFT;
744 /* this should never happen */
745 if ((offset + size) > rdev->mc.visible_vram_size)
746 return -EINVAL;
747
Jerome Glisse0a2d50e2010-04-09 14:39:24 +0200748 return 0;
Dave Airliee024e112009-06-24 09:48:08 +1000749}
Andi Kleence580fa2011-10-13 16:08:47 -0700750
Dave Airlie83f30d02011-10-27 18:15:10 +0200751int radeon_bo_wait(struct radeon_bo *bo, u32 *mem_type, bool no_wait)
Andi Kleence580fa2011-10-13 16:08:47 -0700752{
753 int r;
754
Michele CURTI12432352014-05-19 11:18:52 -0400755 r = ttm_bo_reserve(&bo->tbo, true, no_wait, false, NULL);
Andi Kleence580fa2011-10-13 16:08:47 -0700756 if (unlikely(r != 0))
757 return r;
758 spin_lock(&bo->tbo.bdev->fence_lock);
759 if (mem_type)
760 *mem_type = bo->tbo.mem.mem_type;
761 if (bo->tbo.sync_obj)
Dave Airlie1717c0e2011-10-27 18:28:37 +0200762 r = ttm_bo_wait(&bo->tbo, true, true, no_wait);
Andi Kleence580fa2011-10-13 16:08:47 -0700763 spin_unlock(&bo->tbo.bdev->fence_lock);
764 ttm_bo_unreserve(&bo->tbo);
765 return r;
766}