2 * Copyright © 2008-2010 Intel Corporation
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:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
24 * Eric Anholt <eric@anholt.net>
25 * Chris Wilson <chris@chris-wilson.co.uuk>
30 #include <drm/i915_drm.h>
33 #include "intel_drv.h"
34 #include "i915_trace.h"
36 static bool ggtt_is_idle(struct drm_i915_private
*dev_priv
)
38 struct i915_ggtt
*ggtt
= &dev_priv
->ggtt
;
39 struct intel_engine_cs
*engine
;
40 enum intel_engine_id id
;
42 for_each_engine(engine
, dev_priv
, id
) {
43 struct intel_timeline
*tl
;
45 tl
= &ggtt
->base
.timeline
.engine
[engine
->id
];
46 if (i915_gem_active_isset(&tl
->last_request
))
54 mark_free(struct drm_mm_scan
*scan
,
57 struct list_head
*unwind
)
59 if (i915_vma_is_pinned(vma
))
62 if (WARN_ON(!list_empty(&vma
->exec_list
)))
65 if (flags
& PIN_NONFAULT
&& !list_empty(&vma
->obj
->userfault_link
))
68 list_add(&vma
->exec_list
, unwind
);
69 return drm_mm_scan_add_block(scan
, &vma
->node
);
73 * i915_gem_evict_something - Evict vmas to make room for binding a new one
74 * @vm: address space to evict from
75 * @min_size: size of the desired free space
76 * @alignment: alignment constraint of the desired free space
77 * @cache_level: cache_level for the desired space
78 * @start: start (inclusive) of the range from which to evict objects
79 * @end: end (exclusive) of the range from which to evict objects
80 * @flags: additional flags to control the eviction algorithm
82 * This function will try to evict vmas until a free space satisfying the
83 * requirements is found. Callers must check first whether any such hole exists
84 * already before calling this function.
86 * This function is used by the object/vma binding code.
88 * Since this function is only used to free up virtual address space it only
89 * ignores pinned vmas, and not object where the backing storage itself is
90 * pinned. Hence obj->pages_pin_count does not protect against eviction.
92 * To clarify: This is for freeing up virtual address space, not for freeing
93 * memory in e.g. the shrinker.
96 i915_gem_evict_something(struct i915_address_space
*vm
,
97 u64 min_size
, u64 alignment
,
102 struct drm_i915_private
*dev_priv
= vm
->i915
;
103 struct drm_mm_scan scan
;
104 struct list_head eviction_list
;
105 struct list_head
*phases
[] = {
110 struct i915_vma
*vma
, *next
;
111 struct drm_mm_node
*node
;
114 lockdep_assert_held(&vm
->i915
->drm
.struct_mutex
);
115 trace_i915_gem_evict(vm
, min_size
, alignment
, flags
);
118 * The goal is to evict objects and amalgamate space in LRU order.
119 * The oldest idle objects reside on the inactive list, which is in
120 * retirement order. The next objects to retire are those in flight,
121 * on the active list, again in retirement order.
123 * The retirement sequence is thus:
124 * 1. Inactive objects (already retired)
125 * 2. Active objects (will stall on unbinding)
127 * On each list, the oldest objects lie at the HEAD with the freshest
128 * object on the TAIL.
130 drm_mm_scan_init_with_range(&scan
, &vm
->mm
,
131 min_size
, alignment
, cache_level
,
133 flags
& PIN_HIGH
? DRM_MM_CREATE_TOP
: 0);
135 /* Retire before we search the active list. Although we have
136 * reasonable accuracy in our retirement lists, we may have
137 * a stray pin (preventing eviction) that can only be resolved by
140 if (!(flags
& PIN_NONBLOCK
))
141 i915_gem_retire_requests(dev_priv
);
146 INIT_LIST_HEAD(&eviction_list
);
149 list_for_each_entry(vma
, *phase
, vm_link
)
150 if (mark_free(&scan
, vma
, flags
, &eviction_list
))
154 /* Nothing found, clean up and bail out! */
155 list_for_each_entry_safe(vma
, next
, &eviction_list
, exec_list
) {
156 ret
= drm_mm_scan_remove_block(&scan
, &vma
->node
);
159 INIT_LIST_HEAD(&vma
->exec_list
);
162 /* Can we unpin some objects such as idle hw contents,
163 * or pending flips? But since only the GGTT has global entries
164 * such as scanouts, rinbuffers and contexts, we can skip the
165 * purge when inspecting per-process local address spaces.
167 if (!i915_is_ggtt(vm
) || flags
& PIN_NONBLOCK
)
170 if (ggtt_is_idle(dev_priv
)) {
171 /* If we still have pending pageflip completions, drop
172 * back to userspace to give our workqueues time to
173 * acquire our locks and unpin the old scanouts.
175 return intel_has_pending_fb_unpin(dev_priv
) ? -EAGAIN
: -ENOSPC
;
178 /* Not everything in the GGTT is tracked via vma (otherwise we
179 * could evict as required with minimal stalling) so we are forced
180 * to idle the GPU and explicitly retire outstanding requests in
181 * the hopes that we can then remove contexts and the like only
182 * bound by their active reference.
184 ret
= i915_gem_switch_to_kernel_context(dev_priv
);
188 ret
= i915_gem_wait_for_idle(dev_priv
,
189 I915_WAIT_INTERRUPTIBLE
|
194 i915_gem_retire_requests(dev_priv
);
198 /* drm_mm doesn't allow any other other operations while
199 * scanning, therefore store to-be-evicted objects on a
200 * temporary list and take a reference for all before
201 * calling unbind (which may remove the active reference
202 * of any of our objects, thus corrupting the list).
204 list_for_each_entry_safe(vma
, next
, &eviction_list
, exec_list
) {
205 if (drm_mm_scan_remove_block(&scan
, &vma
->node
))
208 list_del_init(&vma
->exec_list
);
211 /* Unbinding will emit any required flushes */
213 while (!list_empty(&eviction_list
)) {
214 vma
= list_first_entry(&eviction_list
,
218 list_del_init(&vma
->exec_list
);
219 __i915_vma_unpin(vma
);
221 ret
= i915_vma_unbind(vma
);
224 while (ret
== 0 && (node
= drm_mm_scan_color_evict(&scan
))) {
225 vma
= container_of(node
, struct i915_vma
, node
);
226 ret
= i915_vma_unbind(vma
);
233 * i915_gem_evict_for_vma - Evict vmas to make room for binding a new one
234 * @vm: address space to evict from
235 * @target: range (and color) to evict for
236 * @flags: additional flags to control the eviction algorithm
238 * This function will try to evict vmas that overlap the target node.
240 * To clarify: This is for freeing up virtual address space, not for freeing
241 * memory in e.g. the shrinker.
243 int i915_gem_evict_for_node(struct i915_address_space
*vm
,
244 struct drm_mm_node
*target
,
247 LIST_HEAD(eviction_list
);
248 struct drm_mm_node
*node
;
249 u64 start
= target
->start
;
250 u64 end
= start
+ target
->size
;
251 struct i915_vma
*vma
, *next
;
255 lockdep_assert_held(&vm
->i915
->drm
.struct_mutex
);
256 trace_i915_gem_evict_node(vm
, target
, flags
);
258 /* Retire before we search the active list. Although we have
259 * reasonable accuracy in our retirement lists, we may have
260 * a stray pin (preventing eviction) that can only be resolved by
263 if (!(flags
& PIN_NONBLOCK
))
264 i915_gem_retire_requests(vm
->i915
);
266 check_color
= vm
->mm
.color_adjust
;
268 /* Expand search to cover neighbouring guard pages (or lack!) */
269 if (start
> vm
->start
)
270 start
-= I915_GTT_PAGE_SIZE
;
271 if (end
< vm
->start
+ vm
->total
)
272 end
+= I915_GTT_PAGE_SIZE
;
275 drm_mm_for_each_node_in_range(node
, &vm
->mm
, start
, end
) {
276 /* If we find any non-objects (!vma), we cannot evict them */
277 if (node
->color
== I915_COLOR_UNEVICTABLE
) {
282 vma
= container_of(node
, typeof(*vma
), node
);
284 /* If we are using coloring to insert guard pages between
285 * different cache domains within the address space, we have
286 * to check whether the objects on either side of our range
287 * abutt and conflict. If they are in conflict, then we evict
288 * those as well to make room for our guard pages.
291 if (vma
->node
.start
+ vma
->node
.size
== node
->start
) {
292 if (vma
->node
.color
== node
->color
)
295 if (vma
->node
.start
== node
->start
+ node
->size
) {
296 if (vma
->node
.color
== node
->color
)
301 if (flags
& PIN_NONBLOCK
&&
302 (i915_vma_is_pinned(vma
) || i915_vma_is_active(vma
))) {
307 /* Overlap of objects in the same batch? */
308 if (i915_vma_is_pinned(vma
) || !list_empty(&vma
->exec_list
)) {
310 if (vma
->exec_entry
&&
311 vma
->exec_entry
->flags
& EXEC_OBJECT_PINNED
)
316 /* Never show fear in the face of dragons!
318 * We cannot directly remove this node from within this
319 * iterator and as with i915_gem_evict_something() we employ
320 * the vma pin_count in order to prevent the action of
321 * unbinding one vma from freeing (by dropping its active
322 * reference) another in our eviction list.
325 list_add(&vma
->exec_list
, &eviction_list
);
328 list_for_each_entry_safe(vma
, next
, &eviction_list
, exec_list
) {
329 list_del_init(&vma
->exec_list
);
330 __i915_vma_unpin(vma
);
332 ret
= i915_vma_unbind(vma
);
339 * i915_gem_evict_vm - Evict all idle vmas from a vm
340 * @vm: Address space to cleanse
341 * @do_idle: Boolean directing whether to idle first.
343 * This function evicts all idles vmas from a vm. If all unpinned vmas should be
344 * evicted the @do_idle needs to be set to true.
346 * This is used by the execbuf code as a last-ditch effort to defragment the
349 * To clarify: This is for freeing up virtual address space, not for freeing
350 * memory in e.g. the shrinker.
352 int i915_gem_evict_vm(struct i915_address_space
*vm
, bool do_idle
)
354 struct i915_vma
*vma
, *next
;
357 lockdep_assert_held(&vm
->i915
->drm
.struct_mutex
);
358 trace_i915_gem_evict_vm(vm
);
361 struct drm_i915_private
*dev_priv
= vm
->i915
;
363 if (i915_is_ggtt(vm
)) {
364 ret
= i915_gem_switch_to_kernel_context(dev_priv
);
369 ret
= i915_gem_wait_for_idle(dev_priv
,
370 I915_WAIT_INTERRUPTIBLE
|
375 i915_gem_retire_requests(dev_priv
);
376 WARN_ON(!list_empty(&vm
->active_list
));
379 list_for_each_entry_safe(vma
, next
, &vm
->inactive_list
, vm_link
)
380 if (!i915_vma_is_pinned(vma
))
381 WARN_ON(i915_vma_unbind(vma
));