2 * Copyright © 2008 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>
29 #include <drm/i915_drm.h>
31 #include "i915_trace.h"
32 #include "intel_drv.h"
33 #include <linux/shmem_fs.h>
34 #include <linux/slab.h>
35 #include <linux/swap.h>
36 #include <linux/pci.h>
37 #include <linux/dma-buf.h>
39 static void i915_gem_object_flush_gtt_write_domain(struct drm_i915_gem_object *obj);
40 static void i915_gem_object_flush_cpu_write_domain(struct drm_i915_gem_object *obj);
41 static __must_check int i915_gem_object_bind_to_gtt(struct drm_i915_gem_object *obj,
43 bool map_and_fenceable,
45 static int i915_gem_phys_pwrite(struct drm_device *dev,
46 struct drm_i915_gem_object *obj,
47 struct drm_i915_gem_pwrite *args,
48 struct drm_file *file);
50 static void i915_gem_write_fence(struct drm_device *dev, int reg,
51 struct drm_i915_gem_object *obj);
52 static void i915_gem_object_update_fence(struct drm_i915_gem_object *obj,
53 struct drm_i915_fence_reg *fence,
56 static int i915_gem_inactive_shrink(struct shrinker *shrinker,
57 struct shrink_control *sc);
58 static long i915_gem_purge(struct drm_i915_private *dev_priv, long target);
59 static void i915_gem_shrink_all(struct drm_i915_private *dev_priv);
60 static void i915_gem_object_truncate(struct drm_i915_gem_object *obj);
62 static inline void i915_gem_object_fence_lost(struct drm_i915_gem_object *obj)
65 i915_gem_release_mmap(obj);
67 /* As we do not have an associated fence register, we will force
68 * a tiling change if we ever need to acquire one.
70 obj->fence_dirty = false;
71 obj->fence_reg = I915_FENCE_REG_NONE;
74 /* some bookkeeping */
75 static void i915_gem_info_add_obj(struct drm_i915_private *dev_priv,
78 dev_priv->mm.object_count++;
79 dev_priv->mm.object_memory += size;
82 static void i915_gem_info_remove_obj(struct drm_i915_private *dev_priv,
85 dev_priv->mm.object_count--;
86 dev_priv->mm.object_memory -= size;
90 i915_gem_wait_for_error(struct i915_gpu_error *error)
94 #define EXIT_COND (!i915_reset_in_progress(error) || \
95 i915_terminally_wedged(error))
100 * Only wait 10 seconds for the gpu reset to complete to avoid hanging
101 * userspace. If it takes that long something really bad is going on and
102 * we should simply try to bail out and fail as gracefully as possible.
104 ret = wait_event_interruptible_timeout(error->reset_queue,
108 DRM_ERROR("Timed out waiting for the gpu reset to complete\n");
110 } else if (ret < 0) {
118 int i915_mutex_lock_interruptible(struct drm_device *dev)
120 struct drm_i915_private *dev_priv = dev->dev_private;
123 ret = i915_gem_wait_for_error(&dev_priv->gpu_error);
127 ret = mutex_lock_interruptible(&dev->struct_mutex);
131 WARN_ON(i915_verify_lists(dev));
136 i915_gem_object_is_inactive(struct drm_i915_gem_object *obj)
138 return obj->gtt_space && !obj->active;
142 i915_gem_init_ioctl(struct drm_device *dev, void *data,
143 struct drm_file *file)
145 struct drm_i915_private *dev_priv = dev->dev_private;
146 struct drm_i915_gem_init *args = data;
148 if (drm_core_check_feature(dev, DRIVER_MODESET))
151 if (args->gtt_start >= args->gtt_end ||
152 (args->gtt_end | args->gtt_start) & (PAGE_SIZE - 1))
155 /* GEM with user mode setting was never supported on ilk and later. */
156 if (INTEL_INFO(dev)->gen >= 5)
159 mutex_lock(&dev->struct_mutex);
160 i915_gem_setup_global_gtt(dev, args->gtt_start, args->gtt_end,
162 dev_priv->gtt.mappable_end = args->gtt_end;
163 mutex_unlock(&dev->struct_mutex);
169 i915_gem_get_aperture_ioctl(struct drm_device *dev, void *data,
170 struct drm_file *file)
172 struct drm_i915_private *dev_priv = dev->dev_private;
173 struct drm_i915_gem_get_aperture *args = data;
174 struct drm_i915_gem_object *obj;
178 mutex_lock(&dev->struct_mutex);
179 list_for_each_entry(obj, &dev_priv->mm.bound_list, gtt_list)
181 pinned += obj->gtt_space->size;
182 mutex_unlock(&dev->struct_mutex);
184 args->aper_size = dev_priv->gtt.total;
185 args->aper_available_size = args->aper_size - pinned;
190 void *i915_gem_object_alloc(struct drm_device *dev)
192 struct drm_i915_private *dev_priv = dev->dev_private;
193 return kmem_cache_alloc(dev_priv->slab, GFP_KERNEL | __GFP_ZERO);
196 void i915_gem_object_free(struct drm_i915_gem_object *obj)
198 struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
199 kmem_cache_free(dev_priv->slab, obj);
203 i915_gem_create(struct drm_file *file,
204 struct drm_device *dev,
208 struct drm_i915_gem_object *obj;
212 size = roundup(size, PAGE_SIZE);
216 /* Allocate the new object */
217 obj = i915_gem_alloc_object(dev, size);
221 ret = drm_gem_handle_create(file, &obj->base, &handle);
223 drm_gem_object_release(&obj->base);
224 i915_gem_info_remove_obj(dev->dev_private, obj->base.size);
225 i915_gem_object_free(obj);
229 /* drop reference from allocate - handle holds it now */
230 drm_gem_object_unreference(&obj->base);
231 trace_i915_gem_object_create(obj);
238 i915_gem_dumb_create(struct drm_file *file,
239 struct drm_device *dev,
240 struct drm_mode_create_dumb *args)
242 /* have to work out size/pitch and return them */
243 args->pitch = ALIGN(args->width * ((args->bpp + 7) / 8), 64);
244 args->size = args->pitch * args->height;
245 return i915_gem_create(file, dev,
246 args->size, &args->handle);
249 int i915_gem_dumb_destroy(struct drm_file *file,
250 struct drm_device *dev,
253 return drm_gem_handle_delete(file, handle);
257 * Creates a new mm object and returns a handle to it.
260 i915_gem_create_ioctl(struct drm_device *dev, void *data,
261 struct drm_file *file)
263 struct drm_i915_gem_create *args = data;
265 return i915_gem_create(file, dev,
266 args->size, &args->handle);
270 __copy_to_user_swizzled(char __user *cpu_vaddr,
271 const char *gpu_vaddr, int gpu_offset,
274 int ret, cpu_offset = 0;
277 int cacheline_end = ALIGN(gpu_offset + 1, 64);
278 int this_length = min(cacheline_end - gpu_offset, length);
279 int swizzled_gpu_offset = gpu_offset ^ 64;
281 ret = __copy_to_user(cpu_vaddr + cpu_offset,
282 gpu_vaddr + swizzled_gpu_offset,
287 cpu_offset += this_length;
288 gpu_offset += this_length;
289 length -= this_length;
296 __copy_from_user_swizzled(char *gpu_vaddr, int gpu_offset,
297 const char __user *cpu_vaddr,
300 int ret, cpu_offset = 0;
303 int cacheline_end = ALIGN(gpu_offset + 1, 64);
304 int this_length = min(cacheline_end - gpu_offset, length);
305 int swizzled_gpu_offset = gpu_offset ^ 64;
307 ret = __copy_from_user(gpu_vaddr + swizzled_gpu_offset,
308 cpu_vaddr + cpu_offset,
313 cpu_offset += this_length;
314 gpu_offset += this_length;
315 length -= this_length;
321 /* Per-page copy function for the shmem pread fastpath.
322 * Flushes invalid cachelines before reading the target if
323 * needs_clflush is set. */
325 shmem_pread_fast(struct page *page, int shmem_page_offset, int page_length,
326 char __user *user_data,
327 bool page_do_bit17_swizzling, bool needs_clflush)
332 if (unlikely(page_do_bit17_swizzling))
335 vaddr = kmap_atomic(page);
337 drm_clflush_virt_range(vaddr + shmem_page_offset,
339 ret = __copy_to_user_inatomic(user_data,
340 vaddr + shmem_page_offset,
342 kunmap_atomic(vaddr);
344 return ret ? -EFAULT : 0;
348 shmem_clflush_swizzled_range(char *addr, unsigned long length,
351 if (unlikely(swizzled)) {
352 unsigned long start = (unsigned long) addr;
353 unsigned long end = (unsigned long) addr + length;
355 /* For swizzling simply ensure that we always flush both
356 * channels. Lame, but simple and it works. Swizzled
357 * pwrite/pread is far from a hotpath - current userspace
358 * doesn't use it at all. */
359 start = round_down(start, 128);
360 end = round_up(end, 128);
362 drm_clflush_virt_range((void *)start, end - start);
364 drm_clflush_virt_range(addr, length);
369 /* Only difference to the fast-path function is that this can handle bit17
370 * and uses non-atomic copy and kmap functions. */
372 shmem_pread_slow(struct page *page, int shmem_page_offset, int page_length,
373 char __user *user_data,
374 bool page_do_bit17_swizzling, bool needs_clflush)
381 shmem_clflush_swizzled_range(vaddr + shmem_page_offset,
383 page_do_bit17_swizzling);
385 if (page_do_bit17_swizzling)
386 ret = __copy_to_user_swizzled(user_data,
387 vaddr, shmem_page_offset,
390 ret = __copy_to_user(user_data,
391 vaddr + shmem_page_offset,
395 return ret ? - EFAULT : 0;
399 i915_gem_shmem_pread(struct drm_device *dev,
400 struct drm_i915_gem_object *obj,
401 struct drm_i915_gem_pread *args,
402 struct drm_file *file)
404 char __user *user_data;
407 int shmem_page_offset, page_length, ret = 0;
408 int obj_do_bit17_swizzling, page_do_bit17_swizzling;
410 int needs_clflush = 0;
411 struct sg_page_iter sg_iter;
413 user_data = to_user_ptr(args->data_ptr);
416 obj_do_bit17_swizzling = i915_gem_object_needs_bit17_swizzle(obj);
418 if (!(obj->base.read_domains & I915_GEM_DOMAIN_CPU)) {
419 /* If we're not in the cpu read domain, set ourself into the gtt
420 * read domain and manually flush cachelines (if required). This
421 * optimizes for the case when the gpu will dirty the data
422 * anyway again before the next pread happens. */
423 if (obj->cache_level == I915_CACHE_NONE)
425 if (obj->gtt_space) {
426 ret = i915_gem_object_set_to_gtt_domain(obj, false);
432 ret = i915_gem_object_get_pages(obj);
436 i915_gem_object_pin_pages(obj);
438 offset = args->offset;
440 for_each_sg_page(obj->pages->sgl, &sg_iter, obj->pages->nents,
441 offset >> PAGE_SHIFT) {
442 struct page *page = sg_page_iter_page(&sg_iter);
447 /* Operation in this page
449 * shmem_page_offset = offset within page in shmem file
450 * page_length = bytes to copy for this page
452 shmem_page_offset = offset_in_page(offset);
453 page_length = remain;
454 if ((shmem_page_offset + page_length) > PAGE_SIZE)
455 page_length = PAGE_SIZE - shmem_page_offset;
457 page_do_bit17_swizzling = obj_do_bit17_swizzling &&
458 (page_to_phys(page) & (1 << 17)) != 0;
460 ret = shmem_pread_fast(page, shmem_page_offset, page_length,
461 user_data, page_do_bit17_swizzling,
466 mutex_unlock(&dev->struct_mutex);
469 ret = fault_in_multipages_writeable(user_data, remain);
470 /* Userspace is tricking us, but we've already clobbered
471 * its pages with the prefault and promised to write the
472 * data up to the first fault. Hence ignore any errors
473 * and just continue. */
478 ret = shmem_pread_slow(page, shmem_page_offset, page_length,
479 user_data, page_do_bit17_swizzling,
482 mutex_lock(&dev->struct_mutex);
485 mark_page_accessed(page);
490 remain -= page_length;
491 user_data += page_length;
492 offset += page_length;
496 i915_gem_object_unpin_pages(obj);
502 * Reads data from the object referenced by handle.
504 * On error, the contents of *data are undefined.
507 i915_gem_pread_ioctl(struct drm_device *dev, void *data,
508 struct drm_file *file)
510 struct drm_i915_gem_pread *args = data;
511 struct drm_i915_gem_object *obj;
517 if (!access_ok(VERIFY_WRITE,
518 to_user_ptr(args->data_ptr),
522 ret = i915_mutex_lock_interruptible(dev);
526 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
527 if (&obj->base == NULL) {
532 /* Bounds check source. */
533 if (args->offset > obj->base.size ||
534 args->size > obj->base.size - args->offset) {
539 /* prime objects have no backing filp to GEM pread/pwrite
542 if (!obj->base.filp) {
547 trace_i915_gem_object_pread(obj, args->offset, args->size);
549 ret = i915_gem_shmem_pread(dev, obj, args, file);
552 drm_gem_object_unreference(&obj->base);
554 mutex_unlock(&dev->struct_mutex);
558 /* This is the fast write path which cannot handle
559 * page faults in the source data
563 fast_user_write(struct io_mapping *mapping,
564 loff_t page_base, int page_offset,
565 char __user *user_data,
568 void __iomem *vaddr_atomic;
570 unsigned long unwritten;
572 vaddr_atomic = io_mapping_map_atomic_wc(mapping, page_base);
573 /* We can use the cpu mem copy function because this is X86. */
574 vaddr = (void __force*)vaddr_atomic + page_offset;
575 unwritten = __copy_from_user_inatomic_nocache(vaddr,
577 io_mapping_unmap_atomic(vaddr_atomic);
582 * This is the fast pwrite path, where we copy the data directly from the
583 * user into the GTT, uncached.
586 i915_gem_gtt_pwrite_fast(struct drm_device *dev,
587 struct drm_i915_gem_object *obj,
588 struct drm_i915_gem_pwrite *args,
589 struct drm_file *file)
591 drm_i915_private_t *dev_priv = dev->dev_private;
593 loff_t offset, page_base;
594 char __user *user_data;
595 int page_offset, page_length, ret;
597 ret = i915_gem_object_pin(obj, 0, true, true);
601 ret = i915_gem_object_set_to_gtt_domain(obj, true);
605 ret = i915_gem_object_put_fence(obj);
609 user_data = to_user_ptr(args->data_ptr);
612 offset = obj->gtt_offset + args->offset;
615 /* Operation in this page
617 * page_base = page offset within aperture
618 * page_offset = offset within page
619 * page_length = bytes to copy for this page
621 page_base = offset & PAGE_MASK;
622 page_offset = offset_in_page(offset);
623 page_length = remain;
624 if ((page_offset + remain) > PAGE_SIZE)
625 page_length = PAGE_SIZE - page_offset;
627 /* If we get a fault while copying data, then (presumably) our
628 * source page isn't available. Return the error and we'll
629 * retry in the slow path.
631 if (fast_user_write(dev_priv->gtt.mappable, page_base,
632 page_offset, user_data, page_length)) {
637 remain -= page_length;
638 user_data += page_length;
639 offset += page_length;
643 i915_gem_object_unpin(obj);
648 /* Per-page copy function for the shmem pwrite fastpath.
649 * Flushes invalid cachelines before writing to the target if
650 * needs_clflush_before is set and flushes out any written cachelines after
651 * writing if needs_clflush is set. */
653 shmem_pwrite_fast(struct page *page, int shmem_page_offset, int page_length,
654 char __user *user_data,
655 bool page_do_bit17_swizzling,
656 bool needs_clflush_before,
657 bool needs_clflush_after)
662 if (unlikely(page_do_bit17_swizzling))
665 vaddr = kmap_atomic(page);
666 if (needs_clflush_before)
667 drm_clflush_virt_range(vaddr + shmem_page_offset,
669 ret = __copy_from_user_inatomic_nocache(vaddr + shmem_page_offset,
672 if (needs_clflush_after)
673 drm_clflush_virt_range(vaddr + shmem_page_offset,
675 kunmap_atomic(vaddr);
677 return ret ? -EFAULT : 0;
680 /* Only difference to the fast-path function is that this can handle bit17
681 * and uses non-atomic copy and kmap functions. */
683 shmem_pwrite_slow(struct page *page, int shmem_page_offset, int page_length,
684 char __user *user_data,
685 bool page_do_bit17_swizzling,
686 bool needs_clflush_before,
687 bool needs_clflush_after)
693 if (unlikely(needs_clflush_before || page_do_bit17_swizzling))
694 shmem_clflush_swizzled_range(vaddr + shmem_page_offset,
696 page_do_bit17_swizzling);
697 if (page_do_bit17_swizzling)
698 ret = __copy_from_user_swizzled(vaddr, shmem_page_offset,
702 ret = __copy_from_user(vaddr + shmem_page_offset,
705 if (needs_clflush_after)
706 shmem_clflush_swizzled_range(vaddr + shmem_page_offset,
708 page_do_bit17_swizzling);
711 return ret ? -EFAULT : 0;
715 i915_gem_shmem_pwrite(struct drm_device *dev,
716 struct drm_i915_gem_object *obj,
717 struct drm_i915_gem_pwrite *args,
718 struct drm_file *file)
722 char __user *user_data;
723 int shmem_page_offset, page_length, ret = 0;
724 int obj_do_bit17_swizzling, page_do_bit17_swizzling;
725 int hit_slowpath = 0;
726 int needs_clflush_after = 0;
727 int needs_clflush_before = 0;
728 struct sg_page_iter sg_iter;
730 user_data = to_user_ptr(args->data_ptr);
733 obj_do_bit17_swizzling = i915_gem_object_needs_bit17_swizzle(obj);
735 if (obj->base.write_domain != I915_GEM_DOMAIN_CPU) {
736 /* If we're not in the cpu write domain, set ourself into the gtt
737 * write domain and manually flush cachelines (if required). This
738 * optimizes for the case when the gpu will use the data
739 * right away and we therefore have to clflush anyway. */
740 if (obj->cache_level == I915_CACHE_NONE)
741 needs_clflush_after = 1;
742 if (obj->gtt_space) {
743 ret = i915_gem_object_set_to_gtt_domain(obj, true);
748 /* Same trick applies for invalidate partially written cachelines before
750 if (!(obj->base.read_domains & I915_GEM_DOMAIN_CPU)
751 && obj->cache_level == I915_CACHE_NONE)
752 needs_clflush_before = 1;
754 ret = i915_gem_object_get_pages(obj);
758 i915_gem_object_pin_pages(obj);
760 offset = args->offset;
763 for_each_sg_page(obj->pages->sgl, &sg_iter, obj->pages->nents,
764 offset >> PAGE_SHIFT) {
765 struct page *page = sg_page_iter_page(&sg_iter);
766 int partial_cacheline_write;
771 /* Operation in this page
773 * shmem_page_offset = offset within page in shmem file
774 * page_length = bytes to copy for this page
776 shmem_page_offset = offset_in_page(offset);
778 page_length = remain;
779 if ((shmem_page_offset + page_length) > PAGE_SIZE)
780 page_length = PAGE_SIZE - shmem_page_offset;
782 /* If we don't overwrite a cacheline completely we need to be
783 * careful to have up-to-date data by first clflushing. Don't
784 * overcomplicate things and flush the entire patch. */
785 partial_cacheline_write = needs_clflush_before &&
786 ((shmem_page_offset | page_length)
787 & (boot_cpu_data.x86_clflush_size - 1));
789 page_do_bit17_swizzling = obj_do_bit17_swizzling &&
790 (page_to_phys(page) & (1 << 17)) != 0;
792 ret = shmem_pwrite_fast(page, shmem_page_offset, page_length,
793 user_data, page_do_bit17_swizzling,
794 partial_cacheline_write,
795 needs_clflush_after);
800 mutex_unlock(&dev->struct_mutex);
801 ret = shmem_pwrite_slow(page, shmem_page_offset, page_length,
802 user_data, page_do_bit17_swizzling,
803 partial_cacheline_write,
804 needs_clflush_after);
806 mutex_lock(&dev->struct_mutex);
809 set_page_dirty(page);
810 mark_page_accessed(page);
815 remain -= page_length;
816 user_data += page_length;
817 offset += page_length;
821 i915_gem_object_unpin_pages(obj);
825 * Fixup: Flush cpu caches in case we didn't flush the dirty
826 * cachelines in-line while writing and the object moved
827 * out of the cpu write domain while we've dropped the lock.
829 if (!needs_clflush_after &&
830 obj->base.write_domain != I915_GEM_DOMAIN_CPU) {
831 i915_gem_clflush_object(obj);
832 i915_gem_chipset_flush(dev);
836 if (needs_clflush_after)
837 i915_gem_chipset_flush(dev);
843 * Writes data to the object referenced by handle.
845 * On error, the contents of the buffer that were to be modified are undefined.
848 i915_gem_pwrite_ioctl(struct drm_device *dev, void *data,
849 struct drm_file *file)
851 struct drm_i915_gem_pwrite *args = data;
852 struct drm_i915_gem_object *obj;
858 if (!access_ok(VERIFY_READ,
859 to_user_ptr(args->data_ptr),
863 ret = fault_in_multipages_readable(to_user_ptr(args->data_ptr),
868 ret = i915_mutex_lock_interruptible(dev);
872 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
873 if (&obj->base == NULL) {
878 /* Bounds check destination. */
879 if (args->offset > obj->base.size ||
880 args->size > obj->base.size - args->offset) {
885 /* prime objects have no backing filp to GEM pread/pwrite
888 if (!obj->base.filp) {
893 trace_i915_gem_object_pwrite(obj, args->offset, args->size);
896 /* We can only do the GTT pwrite on untiled buffers, as otherwise
897 * it would end up going through the fenced access, and we'll get
898 * different detiling behavior between reading and writing.
899 * pread/pwrite currently are reading and writing from the CPU
900 * perspective, requiring manual detiling by the client.
903 ret = i915_gem_phys_pwrite(dev, obj, args, file);
907 if (obj->cache_level == I915_CACHE_NONE &&
908 obj->tiling_mode == I915_TILING_NONE &&
909 obj->base.write_domain != I915_GEM_DOMAIN_CPU) {
910 ret = i915_gem_gtt_pwrite_fast(dev, obj, args, file);
911 /* Note that the gtt paths might fail with non-page-backed user
912 * pointers (e.g. gtt mappings when moving data between
913 * textures). Fallback to the shmem path in that case. */
916 if (ret == -EFAULT || ret == -ENOSPC)
917 ret = i915_gem_shmem_pwrite(dev, obj, args, file);
920 drm_gem_object_unreference(&obj->base);
922 mutex_unlock(&dev->struct_mutex);
927 i915_gem_check_wedge(struct i915_gpu_error *error,
930 if (i915_reset_in_progress(error)) {
931 /* Non-interruptible callers can't handle -EAGAIN, hence return
932 * -EIO unconditionally for these. */
936 /* Recovery complete, but the reset failed ... */
937 if (i915_terminally_wedged(error))
947 * Compare seqno against outstanding lazy request. Emit a request if they are
951 i915_gem_check_olr(struct intel_ring_buffer *ring, u32 seqno)
955 BUG_ON(!mutex_is_locked(&ring->dev->struct_mutex));
958 if (seqno == ring->outstanding_lazy_request)
959 ret = i915_add_request(ring, NULL, NULL);
965 * __wait_seqno - wait until execution of seqno has finished
966 * @ring: the ring expected to report seqno
968 * @reset_counter: reset sequence associated with the given seqno
969 * @interruptible: do an interruptible wait (normally yes)
970 * @timeout: in - how long to wait (NULL forever); out - how much time remaining
972 * Note: It is of utmost importance that the passed in seqno and reset_counter
973 * values have been read by the caller in an smp safe manner. Where read-side
974 * locks are involved, it is sufficient to read the reset_counter before
975 * unlocking the lock that protects the seqno. For lockless tricks, the
976 * reset_counter _must_ be read before, and an appropriate smp_rmb must be
979 * Returns 0 if the seqno was found within the alloted time. Else returns the
980 * errno with remaining time filled in timeout argument.
982 static int __wait_seqno(struct intel_ring_buffer *ring, u32 seqno,
983 unsigned reset_counter,
984 bool interruptible, struct timespec *timeout)
986 drm_i915_private_t *dev_priv = ring->dev->dev_private;
987 struct timespec before, now, wait_time={1,0};
988 unsigned long timeout_jiffies;
990 bool wait_forever = true;
993 if (i915_seqno_passed(ring->get_seqno(ring, true), seqno))
996 trace_i915_gem_request_wait_begin(ring, seqno);
998 if (timeout != NULL) {
999 wait_time = *timeout;
1000 wait_forever = false;
1003 timeout_jiffies = timespec_to_jiffies_timeout(&wait_time);
1005 if (WARN_ON(!ring->irq_get(ring)))
1008 /* Record current time in case interrupted by signal, or wedged * */
1009 getrawmonotonic(&before);
1012 (i915_seqno_passed(ring->get_seqno(ring, false), seqno) || \
1013 i915_reset_in_progress(&dev_priv->gpu_error) || \
1014 reset_counter != atomic_read(&dev_priv->gpu_error.reset_counter))
1017 end = wait_event_interruptible_timeout(ring->irq_queue,
1021 end = wait_event_timeout(ring->irq_queue, EXIT_COND,
1024 /* We need to check whether any gpu reset happened in between
1025 * the caller grabbing the seqno and now ... */
1026 if (reset_counter != atomic_read(&dev_priv->gpu_error.reset_counter))
1029 /* ... but upgrade the -EGAIN to an -EIO if the gpu is truely
1031 ret = i915_gem_check_wedge(&dev_priv->gpu_error, interruptible);
1034 } while (end == 0 && wait_forever);
1036 getrawmonotonic(&now);
1038 ring->irq_put(ring);
1039 trace_i915_gem_request_wait_end(ring, seqno);
1043 struct timespec sleep_time = timespec_sub(now, before);
1044 *timeout = timespec_sub(*timeout, sleep_time);
1045 if (!timespec_valid(timeout)) /* i.e. negative time remains */
1046 set_normalized_timespec(timeout, 0, 0);
1051 case -EAGAIN: /* Wedged */
1052 case -ERESTARTSYS: /* Signal */
1054 case 0: /* Timeout */
1056 default: /* Completed */
1057 WARN_ON(end < 0); /* We're not aware of other errors */
1063 * Waits for a sequence number to be signaled, and cleans up the
1064 * request and object lists appropriately for that event.
1067 i915_wait_seqno(struct intel_ring_buffer *ring, uint32_t seqno)
1069 struct drm_device *dev = ring->dev;
1070 struct drm_i915_private *dev_priv = dev->dev_private;
1071 bool interruptible = dev_priv->mm.interruptible;
1074 BUG_ON(!mutex_is_locked(&dev->struct_mutex));
1077 ret = i915_gem_check_wedge(&dev_priv->gpu_error, interruptible);
1081 ret = i915_gem_check_olr(ring, seqno);
1085 return __wait_seqno(ring, seqno,
1086 atomic_read(&dev_priv->gpu_error.reset_counter),
1087 interruptible, NULL);
1091 * Ensures that all rendering to the object has completed and the object is
1092 * safe to unbind from the GTT or access from the CPU.
1094 static __must_check int
1095 i915_gem_object_wait_rendering(struct drm_i915_gem_object *obj,
1098 struct intel_ring_buffer *ring = obj->ring;
1102 seqno = readonly ? obj->last_write_seqno : obj->last_read_seqno;
1106 ret = i915_wait_seqno(ring, seqno);
1110 i915_gem_retire_requests_ring(ring);
1112 /* Manually manage the write flush as we may have not yet
1113 * retired the buffer.
1115 if (obj->last_write_seqno &&
1116 i915_seqno_passed(seqno, obj->last_write_seqno)) {
1117 obj->last_write_seqno = 0;
1118 obj->base.write_domain &= ~I915_GEM_GPU_DOMAINS;
1124 /* A nonblocking variant of the above wait. This is a highly dangerous routine
1125 * as the object state may change during this call.
1127 static __must_check int
1128 i915_gem_object_wait_rendering__nonblocking(struct drm_i915_gem_object *obj,
1131 struct drm_device *dev = obj->base.dev;
1132 struct drm_i915_private *dev_priv = dev->dev_private;
1133 struct intel_ring_buffer *ring = obj->ring;
1134 unsigned reset_counter;
1138 BUG_ON(!mutex_is_locked(&dev->struct_mutex));
1139 BUG_ON(!dev_priv->mm.interruptible);
1141 seqno = readonly ? obj->last_write_seqno : obj->last_read_seqno;
1145 ret = i915_gem_check_wedge(&dev_priv->gpu_error, true);
1149 ret = i915_gem_check_olr(ring, seqno);
1153 reset_counter = atomic_read(&dev_priv->gpu_error.reset_counter);
1154 mutex_unlock(&dev->struct_mutex);
1155 ret = __wait_seqno(ring, seqno, reset_counter, true, NULL);
1156 mutex_lock(&dev->struct_mutex);
1158 i915_gem_retire_requests_ring(ring);
1160 /* Manually manage the write flush as we may have not yet
1161 * retired the buffer.
1163 if (obj->last_write_seqno &&
1164 i915_seqno_passed(seqno, obj->last_write_seqno)) {
1165 obj->last_write_seqno = 0;
1166 obj->base.write_domain &= ~I915_GEM_GPU_DOMAINS;
1173 * Called when user space prepares to use an object with the CPU, either
1174 * through the mmap ioctl's mapping or a GTT mapping.
1177 i915_gem_set_domain_ioctl(struct drm_device *dev, void *data,
1178 struct drm_file *file)
1180 struct drm_i915_gem_set_domain *args = data;
1181 struct drm_i915_gem_object *obj;
1182 uint32_t read_domains = args->read_domains;
1183 uint32_t write_domain = args->write_domain;
1186 /* Only handle setting domains to types used by the CPU. */
1187 if (write_domain & I915_GEM_GPU_DOMAINS)
1190 if (read_domains & I915_GEM_GPU_DOMAINS)
1193 /* Having something in the write domain implies it's in the read
1194 * domain, and only that read domain. Enforce that in the request.
1196 if (write_domain != 0 && read_domains != write_domain)
1199 ret = i915_mutex_lock_interruptible(dev);
1203 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
1204 if (&obj->base == NULL) {
1209 /* Try to flush the object off the GPU without holding the lock.
1210 * We will repeat the flush holding the lock in the normal manner
1211 * to catch cases where we are gazumped.
1213 ret = i915_gem_object_wait_rendering__nonblocking(obj, !write_domain);
1217 if (read_domains & I915_GEM_DOMAIN_GTT) {
1218 ret = i915_gem_object_set_to_gtt_domain(obj, write_domain != 0);
1220 /* Silently promote "you're not bound, there was nothing to do"
1221 * to success, since the client was just asking us to
1222 * make sure everything was done.
1227 ret = i915_gem_object_set_to_cpu_domain(obj, write_domain != 0);
1231 drm_gem_object_unreference(&obj->base);
1233 mutex_unlock(&dev->struct_mutex);
1238 * Called when user space has done writes to this buffer
1241 i915_gem_sw_finish_ioctl(struct drm_device *dev, void *data,
1242 struct drm_file *file)
1244 struct drm_i915_gem_sw_finish *args = data;
1245 struct drm_i915_gem_object *obj;
1248 ret = i915_mutex_lock_interruptible(dev);
1252 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
1253 if (&obj->base == NULL) {
1258 /* Pinned buffers may be scanout, so flush the cache */
1260 i915_gem_object_flush_cpu_write_domain(obj);
1262 drm_gem_object_unreference(&obj->base);
1264 mutex_unlock(&dev->struct_mutex);
1269 * Maps the contents of an object, returning the address it is mapped
1272 * While the mapping holds a reference on the contents of the object, it doesn't
1273 * imply a ref on the object itself.
1276 i915_gem_mmap_ioctl(struct drm_device *dev, void *data,
1277 struct drm_file *file)
1279 struct drm_i915_gem_mmap *args = data;
1280 struct drm_gem_object *obj;
1283 obj = drm_gem_object_lookup(dev, file, args->handle);
1287 /* prime objects have no backing filp to GEM mmap
1291 drm_gem_object_unreference_unlocked(obj);
1295 addr = vm_mmap(obj->filp, 0, args->size,
1296 PROT_READ | PROT_WRITE, MAP_SHARED,
1298 drm_gem_object_unreference_unlocked(obj);
1299 if (IS_ERR((void *)addr))
1302 args->addr_ptr = (uint64_t) addr;
1308 * i915_gem_fault - fault a page into the GTT
1309 * vma: VMA in question
1312 * The fault handler is set up by drm_gem_mmap() when a object is GTT mapped
1313 * from userspace. The fault handler takes care of binding the object to
1314 * the GTT (if needed), allocating and programming a fence register (again,
1315 * only if needed based on whether the old reg is still valid or the object
1316 * is tiled) and inserting a new PTE into the faulting process.
1318 * Note that the faulting process may involve evicting existing objects
1319 * from the GTT and/or fence registers to make room. So performance may
1320 * suffer if the GTT working set is large or there are few fence registers
1323 int i915_gem_fault(struct vm_area_struct *vma, struct vm_fault *vmf)
1325 struct drm_i915_gem_object *obj = to_intel_bo(vma->vm_private_data);
1326 struct drm_device *dev = obj->base.dev;
1327 drm_i915_private_t *dev_priv = dev->dev_private;
1328 pgoff_t page_offset;
1331 bool write = !!(vmf->flags & FAULT_FLAG_WRITE);
1333 /* We don't use vmf->pgoff since that has the fake offset */
1334 page_offset = ((unsigned long)vmf->virtual_address - vma->vm_start) >>
1337 ret = i915_mutex_lock_interruptible(dev);
1341 trace_i915_gem_object_fault(obj, page_offset, true, write);
1343 /* Access to snoopable pages through the GTT is incoherent. */
1344 if (obj->cache_level != I915_CACHE_NONE && !HAS_LLC(dev)) {
1349 /* Now bind it into the GTT if needed */
1350 ret = i915_gem_object_pin(obj, 0, true, false);
1354 ret = i915_gem_object_set_to_gtt_domain(obj, write);
1358 ret = i915_gem_object_get_fence(obj);
1362 obj->fault_mappable = true;
1364 pfn = ((dev_priv->gtt.mappable_base + obj->gtt_offset) >> PAGE_SHIFT) +
1367 /* Finally, remap it using the new GTT offset */
1368 ret = vm_insert_pfn(vma, (unsigned long)vmf->virtual_address, pfn);
1370 i915_gem_object_unpin(obj);
1372 mutex_unlock(&dev->struct_mutex);
1376 /* If this -EIO is due to a gpu hang, give the reset code a
1377 * chance to clean up the mess. Otherwise return the proper
1379 if (i915_terminally_wedged(&dev_priv->gpu_error))
1380 return VM_FAULT_SIGBUS;
1382 /* Give the error handler a chance to run and move the
1383 * objects off the GPU active list. Next time we service the
1384 * fault, we should be able to transition the page into the
1385 * GTT without touching the GPU (and so avoid further
1386 * EIO/EGAIN). If the GPU is wedged, then there is no issue
1387 * with coherency, just lost writes.
1395 * EBUSY is ok: this just means that another thread
1396 * already did the job.
1398 return VM_FAULT_NOPAGE;
1400 return VM_FAULT_OOM;
1402 return VM_FAULT_SIGBUS;
1404 WARN_ONCE(ret, "unhandled error in i915_gem_fault: %i\n", ret);
1405 return VM_FAULT_SIGBUS;
1410 * i915_gem_release_mmap - remove physical page mappings
1411 * @obj: obj in question
1413 * Preserve the reservation of the mmapping with the DRM core code, but
1414 * relinquish ownership of the pages back to the system.
1416 * It is vital that we remove the page mapping if we have mapped a tiled
1417 * object through the GTT and then lose the fence register due to
1418 * resource pressure. Similarly if the object has been moved out of the
1419 * aperture, than pages mapped into userspace must be revoked. Removing the
1420 * mapping will then trigger a page fault on the next user access, allowing
1421 * fixup by i915_gem_fault().
1424 i915_gem_release_mmap(struct drm_i915_gem_object *obj)
1426 if (!obj->fault_mappable)
1429 if (obj->base.dev->dev_mapping)
1430 unmap_mapping_range(obj->base.dev->dev_mapping,
1431 (loff_t)obj->base.map_list.hash.key<<PAGE_SHIFT,
1434 obj->fault_mappable = false;
1438 i915_gem_get_gtt_size(struct drm_device *dev, uint32_t size, int tiling_mode)
1442 if (INTEL_INFO(dev)->gen >= 4 ||
1443 tiling_mode == I915_TILING_NONE)
1446 /* Previous chips need a power-of-two fence region when tiling */
1447 if (INTEL_INFO(dev)->gen == 3)
1448 gtt_size = 1024*1024;
1450 gtt_size = 512*1024;
1452 while (gtt_size < size)
1459 * i915_gem_get_gtt_alignment - return required GTT alignment for an object
1460 * @obj: object to check
1462 * Return the required GTT alignment for an object, taking into account
1463 * potential fence register mapping.
1466 i915_gem_get_gtt_alignment(struct drm_device *dev, uint32_t size,
1467 int tiling_mode, bool fenced)
1470 * Minimum alignment is 4k (GTT page size), but might be greater
1471 * if a fence register is needed for the object.
1473 if (INTEL_INFO(dev)->gen >= 4 || (!fenced && IS_G33(dev)) ||
1474 tiling_mode == I915_TILING_NONE)
1478 * Previous chips need to be aligned to the size of the smallest
1479 * fence register that can contain the object.
1481 return i915_gem_get_gtt_size(dev, size, tiling_mode);
1484 static int i915_gem_object_create_mmap_offset(struct drm_i915_gem_object *obj)
1486 struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
1489 if (obj->base.map_list.map)
1492 dev_priv->mm.shrinker_no_lock_stealing = true;
1494 ret = drm_gem_create_mmap_offset(&obj->base);
1498 /* Badly fragmented mmap space? The only way we can recover
1499 * space is by destroying unwanted objects. We can't randomly release
1500 * mmap_offsets as userspace expects them to be persistent for the
1501 * lifetime of the objects. The closest we can is to release the
1502 * offsets on purgeable objects by truncating it and marking it purged,
1503 * which prevents userspace from ever using that object again.
1505 i915_gem_purge(dev_priv, obj->base.size >> PAGE_SHIFT);
1506 ret = drm_gem_create_mmap_offset(&obj->base);
1510 i915_gem_shrink_all(dev_priv);
1511 ret = drm_gem_create_mmap_offset(&obj->base);
1513 dev_priv->mm.shrinker_no_lock_stealing = false;
1518 static void i915_gem_object_free_mmap_offset(struct drm_i915_gem_object *obj)
1520 if (!obj->base.map_list.map)
1523 drm_gem_free_mmap_offset(&obj->base);
1527 i915_gem_mmap_gtt(struct drm_file *file,
1528 struct drm_device *dev,
1532 struct drm_i915_private *dev_priv = dev->dev_private;
1533 struct drm_i915_gem_object *obj;
1536 ret = i915_mutex_lock_interruptible(dev);
1540 obj = to_intel_bo(drm_gem_object_lookup(dev, file, handle));
1541 if (&obj->base == NULL) {
1546 if (obj->base.size > dev_priv->gtt.mappable_end) {
1551 if (obj->madv != I915_MADV_WILLNEED) {
1552 DRM_ERROR("Attempting to mmap a purgeable buffer\n");
1557 ret = i915_gem_object_create_mmap_offset(obj);
1561 *offset = (u64)obj->base.map_list.hash.key << PAGE_SHIFT;
1564 drm_gem_object_unreference(&obj->base);
1566 mutex_unlock(&dev->struct_mutex);
1571 * i915_gem_mmap_gtt_ioctl - prepare an object for GTT mmap'ing
1573 * @data: GTT mapping ioctl data
1574 * @file: GEM object info
1576 * Simply returns the fake offset to userspace so it can mmap it.
1577 * The mmap call will end up in drm_gem_mmap(), which will set things
1578 * up so we can get faults in the handler above.
1580 * The fault handler will take care of binding the object into the GTT
1581 * (since it may have been evicted to make room for something), allocating
1582 * a fence register, and mapping the appropriate aperture address into
1586 i915_gem_mmap_gtt_ioctl(struct drm_device *dev, void *data,
1587 struct drm_file *file)
1589 struct drm_i915_gem_mmap_gtt *args = data;
1591 return i915_gem_mmap_gtt(file, dev, args->handle, &args->offset);
1594 /* Immediately discard the backing storage */
1596 i915_gem_object_truncate(struct drm_i915_gem_object *obj)
1598 struct inode *inode;
1600 i915_gem_object_free_mmap_offset(obj);
1602 if (obj->base.filp == NULL)
1605 /* Our goal here is to return as much of the memory as
1606 * is possible back to the system as we are called from OOM.
1607 * To do this we must instruct the shmfs to drop all of its
1608 * backing pages, *now*.
1610 inode = file_inode(obj->base.filp);
1611 shmem_truncate_range(inode, 0, (loff_t)-1);
1613 obj->madv = __I915_MADV_PURGED;
1617 i915_gem_object_is_purgeable(struct drm_i915_gem_object *obj)
1619 return obj->madv == I915_MADV_DONTNEED;
1623 i915_gem_object_put_pages_gtt(struct drm_i915_gem_object *obj)
1625 struct sg_page_iter sg_iter;
1628 BUG_ON(obj->madv == __I915_MADV_PURGED);
1630 ret = i915_gem_object_set_to_cpu_domain(obj, true);
1632 /* In the event of a disaster, abandon all caches and
1633 * hope for the best.
1635 WARN_ON(ret != -EIO);
1636 i915_gem_clflush_object(obj);
1637 obj->base.read_domains = obj->base.write_domain = I915_GEM_DOMAIN_CPU;
1640 if (i915_gem_object_needs_bit17_swizzle(obj))
1641 i915_gem_object_save_bit_17_swizzle(obj);
1643 if (obj->madv == I915_MADV_DONTNEED)
1646 for_each_sg_page(obj->pages->sgl, &sg_iter, obj->pages->nents, 0) {
1647 struct page *page = sg_page_iter_page(&sg_iter);
1650 set_page_dirty(page);
1652 if (obj->madv == I915_MADV_WILLNEED)
1653 mark_page_accessed(page);
1655 page_cache_release(page);
1659 sg_free_table(obj->pages);
1664 i915_gem_object_put_pages(struct drm_i915_gem_object *obj)
1666 const struct drm_i915_gem_object_ops *ops = obj->ops;
1668 if (obj->pages == NULL)
1671 BUG_ON(obj->gtt_space);
1673 if (obj->pages_pin_count)
1676 /* ->put_pages might need to allocate memory for the bit17 swizzle
1677 * array, hence protect them from being reaped by removing them from gtt
1679 list_del(&obj->gtt_list);
1681 ops->put_pages(obj);
1684 if (i915_gem_object_is_purgeable(obj))
1685 i915_gem_object_truncate(obj);
1691 __i915_gem_shrink(struct drm_i915_private *dev_priv, long target,
1692 bool purgeable_only)
1694 struct drm_i915_gem_object *obj, *next;
1697 list_for_each_entry_safe(obj, next,
1698 &dev_priv->mm.unbound_list,
1700 if ((i915_gem_object_is_purgeable(obj) || !purgeable_only) &&
1701 i915_gem_object_put_pages(obj) == 0) {
1702 count += obj->base.size >> PAGE_SHIFT;
1703 if (count >= target)
1708 list_for_each_entry_safe(obj, next,
1709 &dev_priv->mm.inactive_list,
1711 if ((i915_gem_object_is_purgeable(obj) || !purgeable_only) &&
1712 i915_gem_object_unbind(obj) == 0 &&
1713 i915_gem_object_put_pages(obj) == 0) {
1714 count += obj->base.size >> PAGE_SHIFT;
1715 if (count >= target)
1724 i915_gem_purge(struct drm_i915_private *dev_priv, long target)
1726 return __i915_gem_shrink(dev_priv, target, true);
1730 i915_gem_shrink_all(struct drm_i915_private *dev_priv)
1732 struct drm_i915_gem_object *obj, *next;
1734 i915_gem_evict_everything(dev_priv->dev);
1736 list_for_each_entry_safe(obj, next, &dev_priv->mm.unbound_list, gtt_list)
1737 i915_gem_object_put_pages(obj);
1741 i915_gem_object_get_pages_gtt(struct drm_i915_gem_object *obj)
1743 struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
1745 struct address_space *mapping;
1746 struct sg_table *st;
1747 struct scatterlist *sg;
1748 struct sg_page_iter sg_iter;
1750 unsigned long last_pfn = 0; /* suppress gcc warning */
1753 /* Assert that the object is not currently in any GPU domain. As it
1754 * wasn't in the GTT, there shouldn't be any way it could have been in
1757 BUG_ON(obj->base.read_domains & I915_GEM_GPU_DOMAINS);
1758 BUG_ON(obj->base.write_domain & I915_GEM_GPU_DOMAINS);
1760 st = kmalloc(sizeof(*st), GFP_KERNEL);
1764 page_count = obj->base.size / PAGE_SIZE;
1765 if (sg_alloc_table(st, page_count, GFP_KERNEL)) {
1771 /* Get the list of pages out of our struct file. They'll be pinned
1772 * at this point until we release them.
1774 * Fail silently without starting the shrinker
1776 mapping = file_inode(obj->base.filp)->i_mapping;
1777 gfp = mapping_gfp_mask(mapping);
1778 gfp |= __GFP_NORETRY | __GFP_NOWARN | __GFP_NO_KSWAPD;
1779 gfp &= ~(__GFP_IO | __GFP_WAIT);
1782 for (i = 0; i < page_count; i++) {
1783 page = shmem_read_mapping_page_gfp(mapping, i, gfp);
1785 i915_gem_purge(dev_priv, page_count);
1786 page = shmem_read_mapping_page_gfp(mapping, i, gfp);
1789 /* We've tried hard to allocate the memory by reaping
1790 * our own buffer, now let the real VM do its job and
1791 * go down in flames if truly OOM.
1793 gfp &= ~(__GFP_NORETRY | __GFP_NOWARN | __GFP_NO_KSWAPD);
1794 gfp |= __GFP_IO | __GFP_WAIT;
1796 i915_gem_shrink_all(dev_priv);
1797 page = shmem_read_mapping_page_gfp(mapping, i, gfp);
1801 gfp |= __GFP_NORETRY | __GFP_NOWARN | __GFP_NO_KSWAPD;
1802 gfp &= ~(__GFP_IO | __GFP_WAIT);
1804 #ifdef CONFIG_SWIOTLB
1805 if (swiotlb_nr_tbl()) {
1807 sg_set_page(sg, page, PAGE_SIZE, 0);
1812 if (!i || page_to_pfn(page) != last_pfn + 1) {
1816 sg_set_page(sg, page, PAGE_SIZE, 0);
1818 sg->length += PAGE_SIZE;
1820 last_pfn = page_to_pfn(page);
1822 #ifdef CONFIG_SWIOTLB
1823 if (!swiotlb_nr_tbl())
1828 if (i915_gem_object_needs_bit17_swizzle(obj))
1829 i915_gem_object_do_bit_17_swizzle(obj);
1835 for_each_sg_page(st->sgl, &sg_iter, st->nents, 0)
1836 page_cache_release(sg_page_iter_page(&sg_iter));
1839 return PTR_ERR(page);
1842 /* Ensure that the associated pages are gathered from the backing storage
1843 * and pinned into our object. i915_gem_object_get_pages() may be called
1844 * multiple times before they are released by a single call to
1845 * i915_gem_object_put_pages() - once the pages are no longer referenced
1846 * either as a result of memory pressure (reaping pages under the shrinker)
1847 * or as the object is itself released.
1850 i915_gem_object_get_pages(struct drm_i915_gem_object *obj)
1852 struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
1853 const struct drm_i915_gem_object_ops *ops = obj->ops;
1859 if (obj->madv != I915_MADV_WILLNEED) {
1860 DRM_ERROR("Attempting to obtain a purgeable object\n");
1864 BUG_ON(obj->pages_pin_count);
1866 ret = ops->get_pages(obj);
1870 list_add_tail(&obj->gtt_list, &dev_priv->mm.unbound_list);
1875 i915_gem_object_move_to_active(struct drm_i915_gem_object *obj,
1876 struct intel_ring_buffer *ring)
1878 struct drm_device *dev = obj->base.dev;
1879 struct drm_i915_private *dev_priv = dev->dev_private;
1880 u32 seqno = intel_ring_get_seqno(ring);
1882 BUG_ON(ring == NULL);
1885 /* Add a reference if we're newly entering the active list. */
1887 drm_gem_object_reference(&obj->base);
1891 /* Move from whatever list we were on to the tail of execution. */
1892 list_move_tail(&obj->mm_list, &dev_priv->mm.active_list);
1893 list_move_tail(&obj->ring_list, &ring->active_list);
1895 obj->last_read_seqno = seqno;
1897 if (obj->fenced_gpu_access) {
1898 obj->last_fenced_seqno = seqno;
1900 /* Bump MRU to take account of the delayed flush */
1901 if (obj->fence_reg != I915_FENCE_REG_NONE) {
1902 struct drm_i915_fence_reg *reg;
1904 reg = &dev_priv->fence_regs[obj->fence_reg];
1905 list_move_tail(®->lru_list,
1906 &dev_priv->mm.fence_list);
1912 i915_gem_object_move_to_inactive(struct drm_i915_gem_object *obj)
1914 struct drm_device *dev = obj->base.dev;
1915 struct drm_i915_private *dev_priv = dev->dev_private;
1917 BUG_ON(obj->base.write_domain & ~I915_GEM_GPU_DOMAINS);
1918 BUG_ON(!obj->active);
1920 list_move_tail(&obj->mm_list, &dev_priv->mm.inactive_list);
1922 list_del_init(&obj->ring_list);
1925 obj->last_read_seqno = 0;
1926 obj->last_write_seqno = 0;
1927 obj->base.write_domain = 0;
1929 obj->last_fenced_seqno = 0;
1930 obj->fenced_gpu_access = false;
1933 drm_gem_object_unreference(&obj->base);
1935 WARN_ON(i915_verify_lists(dev));
1939 i915_gem_init_seqno(struct drm_device *dev, u32 seqno)
1941 struct drm_i915_private *dev_priv = dev->dev_private;
1942 struct intel_ring_buffer *ring;
1945 /* Carefully retire all requests without writing to the rings */
1946 for_each_ring(ring, dev_priv, i) {
1947 ret = intel_ring_idle(ring);
1951 i915_gem_retire_requests(dev);
1953 /* Finally reset hw state */
1954 for_each_ring(ring, dev_priv, i) {
1955 intel_ring_init_seqno(ring, seqno);
1957 for (j = 0; j < ARRAY_SIZE(ring->sync_seqno); j++)
1958 ring->sync_seqno[j] = 0;
1964 int i915_gem_set_seqno(struct drm_device *dev, u32 seqno)
1966 struct drm_i915_private *dev_priv = dev->dev_private;
1972 /* HWS page needs to be set less than what we
1973 * will inject to ring
1975 ret = i915_gem_init_seqno(dev, seqno - 1);
1979 /* Carefully set the last_seqno value so that wrap
1980 * detection still works
1982 dev_priv->next_seqno = seqno;
1983 dev_priv->last_seqno = seqno - 1;
1984 if (dev_priv->last_seqno == 0)
1985 dev_priv->last_seqno--;
1991 i915_gem_get_seqno(struct drm_device *dev, u32 *seqno)
1993 struct drm_i915_private *dev_priv = dev->dev_private;
1995 /* reserve 0 for non-seqno */
1996 if (dev_priv->next_seqno == 0) {
1997 int ret = i915_gem_init_seqno(dev, 0);
2001 dev_priv->next_seqno = 1;
2004 *seqno = dev_priv->last_seqno = dev_priv->next_seqno++;
2009 i915_add_request(struct intel_ring_buffer *ring,
2010 struct drm_file *file,
2013 drm_i915_private_t *dev_priv = ring->dev->dev_private;
2014 struct drm_i915_gem_request *request;
2015 u32 request_ring_position;
2020 * Emit any outstanding flushes - execbuf can fail to emit the flush
2021 * after having emitted the batchbuffer command. Hence we need to fix
2022 * things up similar to emitting the lazy request. The difference here
2023 * is that the flush _must_ happen before the next request, no matter
2026 ret = intel_ring_flush_all_caches(ring);
2030 request = kmalloc(sizeof(*request), GFP_KERNEL);
2031 if (request == NULL)
2035 /* Record the position of the start of the request so that
2036 * should we detect the updated seqno part-way through the
2037 * GPU processing the request, we never over-estimate the
2038 * position of the head.
2040 request_ring_position = intel_ring_get_tail(ring);
2042 ret = ring->add_request(ring);
2048 request->seqno = intel_ring_get_seqno(ring);
2049 request->ring = ring;
2050 request->tail = request_ring_position;
2051 request->emitted_jiffies = jiffies;
2052 was_empty = list_empty(&ring->request_list);
2053 list_add_tail(&request->list, &ring->request_list);
2054 request->file_priv = NULL;
2057 struct drm_i915_file_private *file_priv = file->driver_priv;
2059 spin_lock(&file_priv->mm.lock);
2060 request->file_priv = file_priv;
2061 list_add_tail(&request->client_list,
2062 &file_priv->mm.request_list);
2063 spin_unlock(&file_priv->mm.lock);
2066 trace_i915_gem_request_add(ring, request->seqno);
2067 ring->outstanding_lazy_request = 0;
2069 if (!dev_priv->mm.suspended) {
2070 if (i915_enable_hangcheck) {
2071 mod_timer(&dev_priv->gpu_error.hangcheck_timer,
2072 round_jiffies_up(jiffies + DRM_I915_HANGCHECK_JIFFIES));
2075 queue_delayed_work(dev_priv->wq,
2076 &dev_priv->mm.retire_work,
2077 round_jiffies_up_relative(HZ));
2078 intel_mark_busy(dev_priv->dev);
2083 *out_seqno = request->seqno;
2088 i915_gem_request_remove_from_client(struct drm_i915_gem_request *request)
2090 struct drm_i915_file_private *file_priv = request->file_priv;
2095 spin_lock(&file_priv->mm.lock);
2096 if (request->file_priv) {
2097 list_del(&request->client_list);
2098 request->file_priv = NULL;
2100 spin_unlock(&file_priv->mm.lock);
2103 static void i915_gem_reset_ring_lists(struct drm_i915_private *dev_priv,
2104 struct intel_ring_buffer *ring)
2106 while (!list_empty(&ring->request_list)) {
2107 struct drm_i915_gem_request *request;
2109 request = list_first_entry(&ring->request_list,
2110 struct drm_i915_gem_request,
2113 list_del(&request->list);
2114 i915_gem_request_remove_from_client(request);
2118 while (!list_empty(&ring->active_list)) {
2119 struct drm_i915_gem_object *obj;
2121 obj = list_first_entry(&ring->active_list,
2122 struct drm_i915_gem_object,
2125 i915_gem_object_move_to_inactive(obj);
2129 void i915_gem_restore_fences(struct drm_device *dev)
2131 struct drm_i915_private *dev_priv = dev->dev_private;
2134 for (i = 0; i < dev_priv->num_fence_regs; i++) {
2135 struct drm_i915_fence_reg *reg = &dev_priv->fence_regs[i];
2136 i915_gem_write_fence(dev, i, reg->obj);
2140 void i915_gem_reset(struct drm_device *dev)
2142 struct drm_i915_private *dev_priv = dev->dev_private;
2143 struct drm_i915_gem_object *obj;
2144 struct intel_ring_buffer *ring;
2147 for_each_ring(ring, dev_priv, i)
2148 i915_gem_reset_ring_lists(dev_priv, ring);
2150 /* Move everything out of the GPU domains to ensure we do any
2151 * necessary invalidation upon reuse.
2153 list_for_each_entry(obj,
2154 &dev_priv->mm.inactive_list,
2157 obj->base.read_domains &= ~I915_GEM_GPU_DOMAINS;
2160 i915_gem_restore_fences(dev);
2164 * This function clears the request list as sequence numbers are passed.
2167 i915_gem_retire_requests_ring(struct intel_ring_buffer *ring)
2171 if (list_empty(&ring->request_list))
2174 WARN_ON(i915_verify_lists(ring->dev));
2176 seqno = ring->get_seqno(ring, true);
2178 while (!list_empty(&ring->request_list)) {
2179 struct drm_i915_gem_request *request;
2181 request = list_first_entry(&ring->request_list,
2182 struct drm_i915_gem_request,
2185 if (!i915_seqno_passed(seqno, request->seqno))
2188 trace_i915_gem_request_retire(ring, request->seqno);
2189 /* We know the GPU must have read the request to have
2190 * sent us the seqno + interrupt, so use the position
2191 * of tail of the request to update the last known position
2194 ring->last_retired_head = request->tail;
2196 list_del(&request->list);
2197 i915_gem_request_remove_from_client(request);
2201 /* Move any buffers on the active list that are no longer referenced
2202 * by the ringbuffer to the flushing/inactive lists as appropriate.
2204 while (!list_empty(&ring->active_list)) {
2205 struct drm_i915_gem_object *obj;
2207 obj = list_first_entry(&ring->active_list,
2208 struct drm_i915_gem_object,
2211 if (!i915_seqno_passed(seqno, obj->last_read_seqno))
2214 i915_gem_object_move_to_inactive(obj);
2217 if (unlikely(ring->trace_irq_seqno &&
2218 i915_seqno_passed(seqno, ring->trace_irq_seqno))) {
2219 ring->irq_put(ring);
2220 ring->trace_irq_seqno = 0;
2223 WARN_ON(i915_verify_lists(ring->dev));
2227 i915_gem_retire_requests(struct drm_device *dev)
2229 drm_i915_private_t *dev_priv = dev->dev_private;
2230 struct intel_ring_buffer *ring;
2233 for_each_ring(ring, dev_priv, i)
2234 i915_gem_retire_requests_ring(ring);
2238 i915_gem_retire_work_handler(struct work_struct *work)
2240 drm_i915_private_t *dev_priv;
2241 struct drm_device *dev;
2242 struct intel_ring_buffer *ring;
2246 dev_priv = container_of(work, drm_i915_private_t,
2247 mm.retire_work.work);
2248 dev = dev_priv->dev;
2250 /* Come back later if the device is busy... */
2251 if (!mutex_trylock(&dev->struct_mutex)) {
2252 queue_delayed_work(dev_priv->wq, &dev_priv->mm.retire_work,
2253 round_jiffies_up_relative(HZ));
2257 i915_gem_retire_requests(dev);
2259 /* Send a periodic flush down the ring so we don't hold onto GEM
2260 * objects indefinitely.
2263 for_each_ring(ring, dev_priv, i) {
2264 if (ring->gpu_caches_dirty)
2265 i915_add_request(ring, NULL, NULL);
2267 idle &= list_empty(&ring->request_list);
2270 if (!dev_priv->mm.suspended && !idle)
2271 queue_delayed_work(dev_priv->wq, &dev_priv->mm.retire_work,
2272 round_jiffies_up_relative(HZ));
2274 intel_mark_idle(dev);
2276 mutex_unlock(&dev->struct_mutex);
2280 * Ensures that an object will eventually get non-busy by flushing any required
2281 * write domains, emitting any outstanding lazy request and retiring and
2282 * completed requests.
2285 i915_gem_object_flush_active(struct drm_i915_gem_object *obj)
2290 ret = i915_gem_check_olr(obj->ring, obj->last_read_seqno);
2294 i915_gem_retire_requests_ring(obj->ring);
2301 * i915_gem_wait_ioctl - implements DRM_IOCTL_I915_GEM_WAIT
2302 * @DRM_IOCTL_ARGS: standard ioctl arguments
2304 * Returns 0 if successful, else an error is returned with the remaining time in
2305 * the timeout parameter.
2306 * -ETIME: object is still busy after timeout
2307 * -ERESTARTSYS: signal interrupted the wait
2308 * -ENONENT: object doesn't exist
2309 * Also possible, but rare:
2310 * -EAGAIN: GPU wedged
2312 * -ENODEV: Internal IRQ fail
2313 * -E?: The add request failed
2315 * The wait ioctl with a timeout of 0 reimplements the busy ioctl. With any
2316 * non-zero timeout parameter the wait ioctl will wait for the given number of
2317 * nanoseconds on an object becoming unbusy. Since the wait itself does so
2318 * without holding struct_mutex the object may become re-busied before this
2319 * function completes. A similar but shorter * race condition exists in the busy
2323 i915_gem_wait_ioctl(struct drm_device *dev, void *data, struct drm_file *file)
2325 drm_i915_private_t *dev_priv = dev->dev_private;
2326 struct drm_i915_gem_wait *args = data;
2327 struct drm_i915_gem_object *obj;
2328 struct intel_ring_buffer *ring = NULL;
2329 struct timespec timeout_stack, *timeout = NULL;
2330 unsigned reset_counter;
2334 if (args->timeout_ns >= 0) {
2335 timeout_stack = ns_to_timespec(args->timeout_ns);
2336 timeout = &timeout_stack;
2339 ret = i915_mutex_lock_interruptible(dev);
2343 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->bo_handle));
2344 if (&obj->base == NULL) {
2345 mutex_unlock(&dev->struct_mutex);
2349 /* Need to make sure the object gets inactive eventually. */
2350 ret = i915_gem_object_flush_active(obj);
2355 seqno = obj->last_read_seqno;
2362 /* Do this after OLR check to make sure we make forward progress polling
2363 * on this IOCTL with a 0 timeout (like busy ioctl)
2365 if (!args->timeout_ns) {
2370 drm_gem_object_unreference(&obj->base);
2371 reset_counter = atomic_read(&dev_priv->gpu_error.reset_counter);
2372 mutex_unlock(&dev->struct_mutex);
2374 ret = __wait_seqno(ring, seqno, reset_counter, true, timeout);
2376 args->timeout_ns = timespec_to_ns(timeout);
2380 drm_gem_object_unreference(&obj->base);
2381 mutex_unlock(&dev->struct_mutex);
2386 * i915_gem_object_sync - sync an object to a ring.
2388 * @obj: object which may be in use on another ring.
2389 * @to: ring we wish to use the object on. May be NULL.
2391 * This code is meant to abstract object synchronization with the GPU.
2392 * Calling with NULL implies synchronizing the object with the CPU
2393 * rather than a particular GPU ring.
2395 * Returns 0 if successful, else propagates up the lower layer error.
2398 i915_gem_object_sync(struct drm_i915_gem_object *obj,
2399 struct intel_ring_buffer *to)
2401 struct intel_ring_buffer *from = obj->ring;
2405 if (from == NULL || to == from)
2408 if (to == NULL || !i915_semaphore_is_enabled(obj->base.dev))
2409 return i915_gem_object_wait_rendering(obj, false);
2411 idx = intel_ring_sync_index(from, to);
2413 seqno = obj->last_read_seqno;
2414 if (seqno <= from->sync_seqno[idx])
2417 ret = i915_gem_check_olr(obj->ring, seqno);
2421 ret = to->sync_to(to, from, seqno);
2423 /* We use last_read_seqno because sync_to()
2424 * might have just caused seqno wrap under
2427 from->sync_seqno[idx] = obj->last_read_seqno;
2432 static void i915_gem_object_finish_gtt(struct drm_i915_gem_object *obj)
2434 u32 old_write_domain, old_read_domains;
2436 /* Force a pagefault for domain tracking on next user access */
2437 i915_gem_release_mmap(obj);
2439 if ((obj->base.read_domains & I915_GEM_DOMAIN_GTT) == 0)
2442 /* Wait for any direct GTT access to complete */
2445 old_read_domains = obj->base.read_domains;
2446 old_write_domain = obj->base.write_domain;
2448 obj->base.read_domains &= ~I915_GEM_DOMAIN_GTT;
2449 obj->base.write_domain &= ~I915_GEM_DOMAIN_GTT;
2451 trace_i915_gem_object_change_domain(obj,
2457 * Unbinds an object from the GTT aperture.
2460 i915_gem_object_unbind(struct drm_i915_gem_object *obj)
2462 drm_i915_private_t *dev_priv = obj->base.dev->dev_private;
2465 if (obj->gtt_space == NULL)
2471 BUG_ON(obj->pages == NULL);
2473 ret = i915_gem_object_finish_gpu(obj);
2476 /* Continue on if we fail due to EIO, the GPU is hung so we
2477 * should be safe and we need to cleanup or else we might
2478 * cause memory corruption through use-after-free.
2481 i915_gem_object_finish_gtt(obj);
2483 /* release the fence reg _after_ flushing */
2484 ret = i915_gem_object_put_fence(obj);
2488 trace_i915_gem_object_unbind(obj);
2490 if (obj->has_global_gtt_mapping)
2491 i915_gem_gtt_unbind_object(obj);
2492 if (obj->has_aliasing_ppgtt_mapping) {
2493 i915_ppgtt_unbind_object(dev_priv->mm.aliasing_ppgtt, obj);
2494 obj->has_aliasing_ppgtt_mapping = 0;
2496 i915_gem_gtt_finish_object(obj);
2498 list_del(&obj->mm_list);
2499 list_move_tail(&obj->gtt_list, &dev_priv->mm.unbound_list);
2500 /* Avoid an unnecessary call to unbind on rebind. */
2501 obj->map_and_fenceable = true;
2503 drm_mm_put_block(obj->gtt_space);
2504 obj->gtt_space = NULL;
2505 obj->gtt_offset = 0;
2510 int i915_gpu_idle(struct drm_device *dev)
2512 drm_i915_private_t *dev_priv = dev->dev_private;
2513 struct intel_ring_buffer *ring;
2516 /* Flush everything onto the inactive list. */
2517 for_each_ring(ring, dev_priv, i) {
2518 ret = i915_switch_context(ring, NULL, DEFAULT_CONTEXT_ID);
2522 ret = intel_ring_idle(ring);
2530 static void i965_write_fence_reg(struct drm_device *dev, int reg,
2531 struct drm_i915_gem_object *obj)
2533 drm_i915_private_t *dev_priv = dev->dev_private;
2535 int fence_pitch_shift;
2538 if (INTEL_INFO(dev)->gen >= 6) {
2539 fence_reg = FENCE_REG_SANDYBRIDGE_0;
2540 fence_pitch_shift = SANDYBRIDGE_FENCE_PITCH_SHIFT;
2542 fence_reg = FENCE_REG_965_0;
2543 fence_pitch_shift = I965_FENCE_PITCH_SHIFT;
2547 u32 size = obj->gtt_space->size;
2549 val = (uint64_t)((obj->gtt_offset + size - 4096) &
2551 val |= obj->gtt_offset & 0xfffff000;
2552 val |= (uint64_t)((obj->stride / 128) - 1) << fence_pitch_shift;
2553 if (obj->tiling_mode == I915_TILING_Y)
2554 val |= 1 << I965_FENCE_TILING_Y_SHIFT;
2555 val |= I965_FENCE_REG_VALID;
2559 fence_reg += reg * 8;
2560 I915_WRITE64(fence_reg, val);
2561 POSTING_READ(fence_reg);
2564 static void i915_write_fence_reg(struct drm_device *dev, int reg,
2565 struct drm_i915_gem_object *obj)
2567 drm_i915_private_t *dev_priv = dev->dev_private;
2571 u32 size = obj->gtt_space->size;
2575 WARN((obj->gtt_offset & ~I915_FENCE_START_MASK) ||
2576 (size & -size) != size ||
2577 (obj->gtt_offset & (size - 1)),
2578 "object 0x%08x [fenceable? %d] not 1M or pot-size (0x%08x) aligned\n",
2579 obj->gtt_offset, obj->map_and_fenceable, size);
2581 if (obj->tiling_mode == I915_TILING_Y && HAS_128_BYTE_Y_TILING(dev))
2586 /* Note: pitch better be a power of two tile widths */
2587 pitch_val = obj->stride / tile_width;
2588 pitch_val = ffs(pitch_val) - 1;
2590 val = obj->gtt_offset;
2591 if (obj->tiling_mode == I915_TILING_Y)
2592 val |= 1 << I830_FENCE_TILING_Y_SHIFT;
2593 val |= I915_FENCE_SIZE_BITS(size);
2594 val |= pitch_val << I830_FENCE_PITCH_SHIFT;
2595 val |= I830_FENCE_REG_VALID;
2600 reg = FENCE_REG_830_0 + reg * 4;
2602 reg = FENCE_REG_945_8 + (reg - 8) * 4;
2604 I915_WRITE(reg, val);
2608 static void i830_write_fence_reg(struct drm_device *dev, int reg,
2609 struct drm_i915_gem_object *obj)
2611 drm_i915_private_t *dev_priv = dev->dev_private;
2615 u32 size = obj->gtt_space->size;
2618 WARN((obj->gtt_offset & ~I830_FENCE_START_MASK) ||
2619 (size & -size) != size ||
2620 (obj->gtt_offset & (size - 1)),
2621 "object 0x%08x not 512K or pot-size 0x%08x aligned\n",
2622 obj->gtt_offset, size);
2624 pitch_val = obj->stride / 128;
2625 pitch_val = ffs(pitch_val) - 1;
2627 val = obj->gtt_offset;
2628 if (obj->tiling_mode == I915_TILING_Y)
2629 val |= 1 << I830_FENCE_TILING_Y_SHIFT;
2630 val |= I830_FENCE_SIZE_BITS(size);
2631 val |= pitch_val << I830_FENCE_PITCH_SHIFT;
2632 val |= I830_FENCE_REG_VALID;
2636 I915_WRITE(FENCE_REG_830_0 + reg * 4, val);
2637 POSTING_READ(FENCE_REG_830_0 + reg * 4);
2640 inline static bool i915_gem_object_needs_mb(struct drm_i915_gem_object *obj)
2642 return obj && obj->base.read_domains & I915_GEM_DOMAIN_GTT;
2645 static void i915_gem_write_fence(struct drm_device *dev, int reg,
2646 struct drm_i915_gem_object *obj)
2648 struct drm_i915_private *dev_priv = dev->dev_private;
2650 /* Ensure that all CPU reads are completed before installing a fence
2651 * and all writes before removing the fence.
2653 if (i915_gem_object_needs_mb(dev_priv->fence_regs[reg].obj))
2656 switch (INTEL_INFO(dev)->gen) {
2660 case 4: i965_write_fence_reg(dev, reg, obj); break;
2661 case 3: i915_write_fence_reg(dev, reg, obj); break;
2662 case 2: i830_write_fence_reg(dev, reg, obj); break;
2666 /* And similarly be paranoid that no direct access to this region
2667 * is reordered to before the fence is installed.
2669 if (i915_gem_object_needs_mb(obj))
2673 static inline int fence_number(struct drm_i915_private *dev_priv,
2674 struct drm_i915_fence_reg *fence)
2676 return fence - dev_priv->fence_regs;
2679 static void i915_gem_write_fence__ipi(void *data)
2684 static void i915_gem_object_update_fence(struct drm_i915_gem_object *obj,
2685 struct drm_i915_fence_reg *fence,
2688 struct drm_device *dev = obj->base.dev;
2689 struct drm_i915_private *dev_priv = dev->dev_private;
2690 int fence_reg = fence_number(dev_priv, fence);
2692 /* In order to fully serialize access to the fenced region and
2693 * the update to the fence register we need to take extreme
2694 * measures on SNB+. In theory, the write to the fence register
2695 * flushes all memory transactions before, and coupled with the
2696 * mb() placed around the register write we serialise all memory
2697 * operations with respect to the changes in the tiler. Yet, on
2698 * SNB+ we need to take a step further and emit an explicit wbinvd()
2699 * on each processor in order to manually flush all memory
2700 * transactions before updating the fence register.
2702 if (HAS_LLC(obj->base.dev))
2703 on_each_cpu(i915_gem_write_fence__ipi, NULL, 1);
2704 i915_gem_write_fence(dev, fence_reg, enable ? obj : NULL);
2707 obj->fence_reg = fence_reg;
2709 list_move_tail(&fence->lru_list, &dev_priv->mm.fence_list);
2711 obj->fence_reg = I915_FENCE_REG_NONE;
2713 list_del_init(&fence->lru_list);
2718 i915_gem_object_wait_fence(struct drm_i915_gem_object *obj)
2720 if (obj->last_fenced_seqno) {
2721 int ret = i915_wait_seqno(obj->ring, obj->last_fenced_seqno);
2725 obj->last_fenced_seqno = 0;
2728 obj->fenced_gpu_access = false;
2733 i915_gem_object_put_fence(struct drm_i915_gem_object *obj)
2735 struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
2736 struct drm_i915_fence_reg *fence;
2739 ret = i915_gem_object_wait_fence(obj);
2743 if (obj->fence_reg == I915_FENCE_REG_NONE)
2746 fence = &dev_priv->fence_regs[obj->fence_reg];
2748 i915_gem_object_fence_lost(obj);
2749 i915_gem_object_update_fence(obj, fence, false);
2754 static struct drm_i915_fence_reg *
2755 i915_find_fence_reg(struct drm_device *dev)
2757 struct drm_i915_private *dev_priv = dev->dev_private;
2758 struct drm_i915_fence_reg *reg, *avail;
2761 /* First try to find a free reg */
2763 for (i = dev_priv->fence_reg_start; i < dev_priv->num_fence_regs; i++) {
2764 reg = &dev_priv->fence_regs[i];
2768 if (!reg->pin_count)
2775 /* None available, try to steal one or wait for a user to finish */
2776 list_for_each_entry(reg, &dev_priv->mm.fence_list, lru_list) {
2787 * i915_gem_object_get_fence - set up fencing for an object
2788 * @obj: object to map through a fence reg
2790 * When mapping objects through the GTT, userspace wants to be able to write
2791 * to them without having to worry about swizzling if the object is tiled.
2792 * This function walks the fence regs looking for a free one for @obj,
2793 * stealing one if it can't find any.
2795 * It then sets up the reg based on the object's properties: address, pitch
2796 * and tiling format.
2798 * For an untiled surface, this removes any existing fence.
2801 i915_gem_object_get_fence(struct drm_i915_gem_object *obj)
2803 struct drm_device *dev = obj->base.dev;
2804 struct drm_i915_private *dev_priv = dev->dev_private;
2805 bool enable = obj->tiling_mode != I915_TILING_NONE;
2806 struct drm_i915_fence_reg *reg;
2809 /* Have we updated the tiling parameters upon the object and so
2810 * will need to serialise the write to the associated fence register?
2812 if (obj->fence_dirty) {
2813 ret = i915_gem_object_wait_fence(obj);
2818 /* Just update our place in the LRU if our fence is getting reused. */
2819 if (obj->fence_reg != I915_FENCE_REG_NONE) {
2820 reg = &dev_priv->fence_regs[obj->fence_reg];
2821 if (!obj->fence_dirty) {
2822 list_move_tail(®->lru_list,
2823 &dev_priv->mm.fence_list);
2826 } else if (enable) {
2827 reg = i915_find_fence_reg(dev);
2832 struct drm_i915_gem_object *old = reg->obj;
2834 ret = i915_gem_object_wait_fence(old);
2838 i915_gem_object_fence_lost(old);
2843 i915_gem_object_update_fence(obj, reg, enable);
2844 obj->fence_dirty = false;
2849 static bool i915_gem_valid_gtt_space(struct drm_device *dev,
2850 struct drm_mm_node *gtt_space,
2851 unsigned long cache_level)
2853 struct drm_mm_node *other;
2855 /* On non-LLC machines we have to be careful when putting differing
2856 * types of snoopable memory together to avoid the prefetcher
2857 * crossing memory domains and dying.
2862 if (gtt_space == NULL)
2865 if (list_empty(>t_space->node_list))
2868 other = list_entry(gtt_space->node_list.prev, struct drm_mm_node, node_list);
2869 if (other->allocated && !other->hole_follows && other->color != cache_level)
2872 other = list_entry(gtt_space->node_list.next, struct drm_mm_node, node_list);
2873 if (other->allocated && !gtt_space->hole_follows && other->color != cache_level)
2879 static void i915_gem_verify_gtt(struct drm_device *dev)
2882 struct drm_i915_private *dev_priv = dev->dev_private;
2883 struct drm_i915_gem_object *obj;
2886 list_for_each_entry(obj, &dev_priv->mm.gtt_list, gtt_list) {
2887 if (obj->gtt_space == NULL) {
2888 printk(KERN_ERR "object found on GTT list with no space reserved\n");
2893 if (obj->cache_level != obj->gtt_space->color) {
2894 printk(KERN_ERR "object reserved space [%08lx, %08lx] with wrong color, cache_level=%x, color=%lx\n",
2895 obj->gtt_space->start,
2896 obj->gtt_space->start + obj->gtt_space->size,
2898 obj->gtt_space->color);
2903 if (!i915_gem_valid_gtt_space(dev,
2905 obj->cache_level)) {
2906 printk(KERN_ERR "invalid GTT space found at [%08lx, %08lx] - color=%x\n",
2907 obj->gtt_space->start,
2908 obj->gtt_space->start + obj->gtt_space->size,
2920 * Finds free space in the GTT aperture and binds the object there.
2923 i915_gem_object_bind_to_gtt(struct drm_i915_gem_object *obj,
2925 bool map_and_fenceable,
2928 struct drm_device *dev = obj->base.dev;
2929 drm_i915_private_t *dev_priv = dev->dev_private;
2930 struct drm_mm_node *node;
2931 u32 size, fence_size, fence_alignment, unfenced_alignment;
2932 bool mappable, fenceable;
2935 fence_size = i915_gem_get_gtt_size(dev,
2938 fence_alignment = i915_gem_get_gtt_alignment(dev,
2940 obj->tiling_mode, true);
2941 unfenced_alignment =
2942 i915_gem_get_gtt_alignment(dev,
2944 obj->tiling_mode, false);
2947 alignment = map_and_fenceable ? fence_alignment :
2949 if (map_and_fenceable && alignment & (fence_alignment - 1)) {
2950 DRM_ERROR("Invalid object alignment requested %u\n", alignment);
2954 size = map_and_fenceable ? fence_size : obj->base.size;
2956 /* If the object is bigger than the entire aperture, reject it early
2957 * before evicting everything in a vain attempt to find space.
2959 if (obj->base.size >
2960 (map_and_fenceable ? dev_priv->gtt.mappable_end : dev_priv->gtt.total)) {
2961 DRM_ERROR("Attempting to bind an object larger than the aperture\n");
2965 ret = i915_gem_object_get_pages(obj);
2969 i915_gem_object_pin_pages(obj);
2971 node = kzalloc(sizeof(*node), GFP_KERNEL);
2973 i915_gem_object_unpin_pages(obj);
2978 if (map_and_fenceable)
2979 ret = drm_mm_insert_node_in_range_generic(&dev_priv->mm.gtt_space, node,
2980 size, alignment, obj->cache_level,
2981 0, dev_priv->gtt.mappable_end);
2983 ret = drm_mm_insert_node_generic(&dev_priv->mm.gtt_space, node,
2984 size, alignment, obj->cache_level);
2986 ret = i915_gem_evict_something(dev, size, alignment,
2993 i915_gem_object_unpin_pages(obj);
2997 if (WARN_ON(!i915_gem_valid_gtt_space(dev, node, obj->cache_level))) {
2998 i915_gem_object_unpin_pages(obj);
2999 drm_mm_put_block(node);
3003 ret = i915_gem_gtt_prepare_object(obj);
3005 i915_gem_object_unpin_pages(obj);
3006 drm_mm_put_block(node);
3010 list_move_tail(&obj->gtt_list, &dev_priv->mm.bound_list);
3011 list_add_tail(&obj->mm_list, &dev_priv->mm.inactive_list);
3013 obj->gtt_space = node;
3014 obj->gtt_offset = node->start;
3017 node->size == fence_size &&
3018 (node->start & (fence_alignment - 1)) == 0;
3021 obj->gtt_offset + obj->base.size <= dev_priv->gtt.mappable_end;
3023 obj->map_and_fenceable = mappable && fenceable;
3025 i915_gem_object_unpin_pages(obj);
3026 trace_i915_gem_object_bind(obj, map_and_fenceable);
3027 i915_gem_verify_gtt(dev);
3032 i915_gem_clflush_object(struct drm_i915_gem_object *obj)
3034 /* If we don't have a page list set up, then we're not pinned
3035 * to GPU, and we can ignore the cache flush because it'll happen
3036 * again at bind time.
3038 if (obj->pages == NULL)
3042 * Stolen memory is always coherent with the GPU as it is explicitly
3043 * marked as wc by the system, or the system is cache-coherent.
3048 /* If the GPU is snooping the contents of the CPU cache,
3049 * we do not need to manually clear the CPU cache lines. However,
3050 * the caches are only snooped when the render cache is
3051 * flushed/invalidated. As we always have to emit invalidations
3052 * and flushes when moving into and out of the RENDER domain, correct
3053 * snooping behaviour occurs naturally as the result of our domain
3056 if (obj->cache_level != I915_CACHE_NONE)
3059 trace_i915_gem_object_clflush(obj);
3061 drm_clflush_sg(obj->pages);
3064 /** Flushes the GTT write domain for the object if it's dirty. */
3066 i915_gem_object_flush_gtt_write_domain(struct drm_i915_gem_object *obj)
3068 uint32_t old_write_domain;
3070 if (obj->base.write_domain != I915_GEM_DOMAIN_GTT)
3073 /* No actual flushing is required for the GTT write domain. Writes
3074 * to it immediately go to main memory as far as we know, so there's
3075 * no chipset flush. It also doesn't land in render cache.
3077 * However, we do have to enforce the order so that all writes through
3078 * the GTT land before any writes to the device, such as updates to
3083 old_write_domain = obj->base.write_domain;
3084 obj->base.write_domain = 0;
3086 trace_i915_gem_object_change_domain(obj,
3087 obj->base.read_domains,
3091 /** Flushes the CPU write domain for the object if it's dirty. */
3093 i915_gem_object_flush_cpu_write_domain(struct drm_i915_gem_object *obj)
3095 uint32_t old_write_domain;
3097 if (obj->base.write_domain != I915_GEM_DOMAIN_CPU)
3100 i915_gem_clflush_object(obj);
3101 i915_gem_chipset_flush(obj->base.dev);
3102 old_write_domain = obj->base.write_domain;
3103 obj->base.write_domain = 0;
3105 trace_i915_gem_object_change_domain(obj,
3106 obj->base.read_domains,
3111 * Moves a single object to the GTT read, and possibly write domain.
3113 * This function returns when the move is complete, including waiting on
3117 i915_gem_object_set_to_gtt_domain(struct drm_i915_gem_object *obj, bool write)
3119 drm_i915_private_t *dev_priv = obj->base.dev->dev_private;
3120 uint32_t old_write_domain, old_read_domains;
3123 /* Not valid to be called on unbound objects. */
3124 if (obj->gtt_space == NULL)
3127 if (obj->base.write_domain == I915_GEM_DOMAIN_GTT)
3130 ret = i915_gem_object_wait_rendering(obj, !write);
3134 i915_gem_object_flush_cpu_write_domain(obj);
3136 /* Serialise direct access to this object with the barriers for
3137 * coherent writes from the GPU, by effectively invalidating the
3138 * GTT domain upon first access.
3140 if ((obj->base.read_domains & I915_GEM_DOMAIN_GTT) == 0)
3143 old_write_domain = obj->base.write_domain;
3144 old_read_domains = obj->base.read_domains;
3146 /* It should now be out of any other write domains, and we can update
3147 * the domain values for our changes.
3149 BUG_ON((obj->base.write_domain & ~I915_GEM_DOMAIN_GTT) != 0);
3150 obj->base.read_domains |= I915_GEM_DOMAIN_GTT;
3152 obj->base.read_domains = I915_GEM_DOMAIN_GTT;
3153 obj->base.write_domain = I915_GEM_DOMAIN_GTT;
3157 trace_i915_gem_object_change_domain(obj,
3161 /* And bump the LRU for this access */
3162 if (i915_gem_object_is_inactive(obj))
3163 list_move_tail(&obj->mm_list, &dev_priv->mm.inactive_list);
3168 int i915_gem_object_set_cache_level(struct drm_i915_gem_object *obj,
3169 enum i915_cache_level cache_level)
3171 struct drm_device *dev = obj->base.dev;
3172 drm_i915_private_t *dev_priv = dev->dev_private;
3175 if (obj->cache_level == cache_level)
3178 if (obj->pin_count) {
3179 DRM_DEBUG("can not change the cache level of pinned objects\n");
3183 if (!i915_gem_valid_gtt_space(dev, obj->gtt_space, cache_level)) {
3184 ret = i915_gem_object_unbind(obj);
3189 if (obj->gtt_space) {
3190 ret = i915_gem_object_finish_gpu(obj);
3194 i915_gem_object_finish_gtt(obj);
3196 /* Before SandyBridge, you could not use tiling or fence
3197 * registers with snooped memory, so relinquish any fences
3198 * currently pointing to our region in the aperture.
3200 if (INTEL_INFO(dev)->gen < 6) {
3201 ret = i915_gem_object_put_fence(obj);
3206 if (obj->has_global_gtt_mapping)
3207 i915_gem_gtt_bind_object(obj, cache_level);
3208 if (obj->has_aliasing_ppgtt_mapping)
3209 i915_ppgtt_bind_object(dev_priv->mm.aliasing_ppgtt,
3212 obj->gtt_space->color = cache_level;
3215 if (cache_level == I915_CACHE_NONE) {
3216 u32 old_read_domains, old_write_domain;
3218 /* If we're coming from LLC cached, then we haven't
3219 * actually been tracking whether the data is in the
3220 * CPU cache or not, since we only allow one bit set
3221 * in obj->write_domain and have been skipping the clflushes.
3222 * Just set it to the CPU cache for now.
3224 WARN_ON(obj->base.write_domain & ~I915_GEM_DOMAIN_CPU);
3225 WARN_ON(obj->base.read_domains & ~I915_GEM_DOMAIN_CPU);
3227 old_read_domains = obj->base.read_domains;
3228 old_write_domain = obj->base.write_domain;
3230 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
3231 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
3233 trace_i915_gem_object_change_domain(obj,
3238 obj->cache_level = cache_level;
3239 i915_gem_verify_gtt(dev);
3243 int i915_gem_get_caching_ioctl(struct drm_device *dev, void *data,
3244 struct drm_file *file)
3246 struct drm_i915_gem_caching *args = data;
3247 struct drm_i915_gem_object *obj;
3250 ret = i915_mutex_lock_interruptible(dev);
3254 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
3255 if (&obj->base == NULL) {
3260 args->caching = obj->cache_level != I915_CACHE_NONE;
3262 drm_gem_object_unreference(&obj->base);
3264 mutex_unlock(&dev->struct_mutex);
3268 int i915_gem_set_caching_ioctl(struct drm_device *dev, void *data,
3269 struct drm_file *file)
3271 struct drm_i915_gem_caching *args = data;
3272 struct drm_i915_gem_object *obj;
3273 enum i915_cache_level level;
3276 switch (args->caching) {
3277 case I915_CACHING_NONE:
3278 level = I915_CACHE_NONE;
3280 case I915_CACHING_CACHED:
3281 level = I915_CACHE_LLC;
3287 ret = i915_mutex_lock_interruptible(dev);
3291 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
3292 if (&obj->base == NULL) {
3297 ret = i915_gem_object_set_cache_level(obj, level);
3299 drm_gem_object_unreference(&obj->base);
3301 mutex_unlock(&dev->struct_mutex);
3306 * Prepare buffer for display plane (scanout, cursors, etc).
3307 * Can be called from an uninterruptible phase (modesetting) and allows
3308 * any flushes to be pipelined (for pageflips).
3311 i915_gem_object_pin_to_display_plane(struct drm_i915_gem_object *obj,
3313 struct intel_ring_buffer *pipelined)
3315 u32 old_read_domains, old_write_domain;
3318 if (pipelined != obj->ring) {
3319 ret = i915_gem_object_sync(obj, pipelined);
3324 /* The display engine is not coherent with the LLC cache on gen6. As
3325 * a result, we make sure that the pinning that is about to occur is
3326 * done with uncached PTEs. This is lowest common denominator for all
3329 * However for gen6+, we could do better by using the GFDT bit instead
3330 * of uncaching, which would allow us to flush all the LLC-cached data
3331 * with that bit in the PTE to main memory with just one PIPE_CONTROL.
3333 ret = i915_gem_object_set_cache_level(obj, I915_CACHE_NONE);
3337 /* As the user may map the buffer once pinned in the display plane
3338 * (e.g. libkms for the bootup splash), we have to ensure that we
3339 * always use map_and_fenceable for all scanout buffers.
3341 ret = i915_gem_object_pin(obj, alignment, true, false);
3345 i915_gem_object_flush_cpu_write_domain(obj);
3347 old_write_domain = obj->base.write_domain;
3348 old_read_domains = obj->base.read_domains;
3350 /* It should now be out of any other write domains, and we can update
3351 * the domain values for our changes.
3353 obj->base.write_domain = 0;
3354 obj->base.read_domains |= I915_GEM_DOMAIN_GTT;
3356 trace_i915_gem_object_change_domain(obj,
3364 i915_gem_object_finish_gpu(struct drm_i915_gem_object *obj)
3368 if ((obj->base.read_domains & I915_GEM_GPU_DOMAINS) == 0)
3371 ret = i915_gem_object_wait_rendering(obj, false);
3375 /* Ensure that we invalidate the GPU's caches and TLBs. */
3376 obj->base.read_domains &= ~I915_GEM_GPU_DOMAINS;
3381 * Moves a single object to the CPU read, and possibly write domain.
3383 * This function returns when the move is complete, including waiting on
3387 i915_gem_object_set_to_cpu_domain(struct drm_i915_gem_object *obj, bool write)
3389 uint32_t old_write_domain, old_read_domains;
3392 if (obj->base.write_domain == I915_GEM_DOMAIN_CPU)
3395 ret = i915_gem_object_wait_rendering(obj, !write);
3399 i915_gem_object_flush_gtt_write_domain(obj);
3401 old_write_domain = obj->base.write_domain;
3402 old_read_domains = obj->base.read_domains;
3404 /* Flush the CPU cache if it's still invalid. */
3405 if ((obj->base.read_domains & I915_GEM_DOMAIN_CPU) == 0) {
3406 i915_gem_clflush_object(obj);
3408 obj->base.read_domains |= I915_GEM_DOMAIN_CPU;
3411 /* It should now be out of any other write domains, and we can update
3412 * the domain values for our changes.
3414 BUG_ON((obj->base.write_domain & ~I915_GEM_DOMAIN_CPU) != 0);
3416 /* If we're writing through the CPU, then the GPU read domains will
3417 * need to be invalidated at next use.
3420 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
3421 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
3424 trace_i915_gem_object_change_domain(obj,
3431 /* Throttle our rendering by waiting until the ring has completed our requests
3432 * emitted over 20 msec ago.
3434 * Note that if we were to use the current jiffies each time around the loop,
3435 * we wouldn't escape the function with any frames outstanding if the time to
3436 * render a frame was over 20ms.
3438 * This should get us reasonable parallelism between CPU and GPU but also
3439 * relatively low latency when blocking on a particular request to finish.
3442 i915_gem_ring_throttle(struct drm_device *dev, struct drm_file *file)
3444 struct drm_i915_private *dev_priv = dev->dev_private;
3445 struct drm_i915_file_private *file_priv = file->driver_priv;
3446 unsigned long recent_enough = jiffies - msecs_to_jiffies(20);
3447 struct drm_i915_gem_request *request;
3448 struct intel_ring_buffer *ring = NULL;
3449 unsigned reset_counter;
3453 ret = i915_gem_wait_for_error(&dev_priv->gpu_error);
3457 ret = i915_gem_check_wedge(&dev_priv->gpu_error, false);
3461 spin_lock(&file_priv->mm.lock);
3462 list_for_each_entry(request, &file_priv->mm.request_list, client_list) {
3463 if (time_after_eq(request->emitted_jiffies, recent_enough))
3466 ring = request->ring;
3467 seqno = request->seqno;
3469 reset_counter = atomic_read(&dev_priv->gpu_error.reset_counter);
3470 spin_unlock(&file_priv->mm.lock);
3475 ret = __wait_seqno(ring, seqno, reset_counter, true, NULL);
3477 queue_delayed_work(dev_priv->wq, &dev_priv->mm.retire_work, 0);
3483 i915_gem_object_pin(struct drm_i915_gem_object *obj,
3485 bool map_and_fenceable,
3490 if (WARN_ON(obj->pin_count == DRM_I915_GEM_OBJECT_MAX_PIN_COUNT))
3493 if (obj->gtt_space != NULL) {
3494 if ((alignment && obj->gtt_offset & (alignment - 1)) ||
3495 (map_and_fenceable && !obj->map_and_fenceable)) {
3496 WARN(obj->pin_count,
3497 "bo is already pinned with incorrect alignment:"
3498 " offset=%x, req.alignment=%x, req.map_and_fenceable=%d,"
3499 " obj->map_and_fenceable=%d\n",
3500 obj->gtt_offset, alignment,
3502 obj->map_and_fenceable);
3503 ret = i915_gem_object_unbind(obj);
3509 if (obj->gtt_space == NULL) {
3510 struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
3512 ret = i915_gem_object_bind_to_gtt(obj, alignment,
3518 if (!dev_priv->mm.aliasing_ppgtt)
3519 i915_gem_gtt_bind_object(obj, obj->cache_level);
3522 if (!obj->has_global_gtt_mapping && map_and_fenceable)
3523 i915_gem_gtt_bind_object(obj, obj->cache_level);
3526 obj->pin_mappable |= map_and_fenceable;
3532 i915_gem_object_unpin(struct drm_i915_gem_object *obj)
3534 BUG_ON(obj->pin_count == 0);
3535 BUG_ON(obj->gtt_space == NULL);
3537 if (--obj->pin_count == 0)
3538 obj->pin_mappable = false;
3542 i915_gem_pin_ioctl(struct drm_device *dev, void *data,
3543 struct drm_file *file)
3545 struct drm_i915_gem_pin *args = data;
3546 struct drm_i915_gem_object *obj;
3549 ret = i915_mutex_lock_interruptible(dev);
3553 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
3554 if (&obj->base == NULL) {
3559 if (obj->madv != I915_MADV_WILLNEED) {
3560 DRM_ERROR("Attempting to pin a purgeable buffer\n");
3565 if (obj->pin_filp != NULL && obj->pin_filp != file) {
3566 DRM_ERROR("Already pinned in i915_gem_pin_ioctl(): %d\n",
3572 if (obj->user_pin_count == 0) {
3573 ret = i915_gem_object_pin(obj, args->alignment, true, false);
3578 obj->user_pin_count++;
3579 obj->pin_filp = file;
3581 /* XXX - flush the CPU caches for pinned objects
3582 * as the X server doesn't manage domains yet
3584 i915_gem_object_flush_cpu_write_domain(obj);
3585 args->offset = obj->gtt_offset;
3587 drm_gem_object_unreference(&obj->base);
3589 mutex_unlock(&dev->struct_mutex);
3594 i915_gem_unpin_ioctl(struct drm_device *dev, void *data,
3595 struct drm_file *file)
3597 struct drm_i915_gem_pin *args = data;
3598 struct drm_i915_gem_object *obj;
3601 ret = i915_mutex_lock_interruptible(dev);
3605 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
3606 if (&obj->base == NULL) {
3611 if (obj->pin_filp != file) {
3612 DRM_ERROR("Not pinned by caller in i915_gem_pin_ioctl(): %d\n",
3617 obj->user_pin_count--;
3618 if (obj->user_pin_count == 0) {
3619 obj->pin_filp = NULL;
3620 i915_gem_object_unpin(obj);
3624 drm_gem_object_unreference(&obj->base);
3626 mutex_unlock(&dev->struct_mutex);
3631 i915_gem_busy_ioctl(struct drm_device *dev, void *data,
3632 struct drm_file *file)
3634 struct drm_i915_gem_busy *args = data;
3635 struct drm_i915_gem_object *obj;
3638 ret = i915_mutex_lock_interruptible(dev);
3642 obj = to_intel_bo(drm_gem_object_lookup(dev, file, args->handle));
3643 if (&obj->base == NULL) {
3648 /* Count all active objects as busy, even if they are currently not used
3649 * by the gpu. Users of this interface expect objects to eventually
3650 * become non-busy without any further actions, therefore emit any
3651 * necessary flushes here.
3653 ret = i915_gem_object_flush_active(obj);
3655 args->busy = obj->active;
3657 BUILD_BUG_ON(I915_NUM_RINGS > 16);
3658 args->busy |= intel_ring_flag(obj->ring) << 16;
3661 drm_gem_object_unreference(&obj->base);
3663 mutex_unlock(&dev->struct_mutex);
3668 i915_gem_throttle_ioctl(struct drm_device *dev, void *data,
3669 struct drm_file *file_priv)
3671 return i915_gem_ring_throttle(dev, file_priv);
3675 i915_gem_madvise_ioctl(struct drm_device *dev, void *data,
3676 struct drm_file *file_priv)
3678 struct drm_i915_gem_madvise *args = data;
3679 struct drm_i915_gem_object *obj;
3682 switch (args->madv) {
3683 case I915_MADV_DONTNEED:
3684 case I915_MADV_WILLNEED:
3690 ret = i915_mutex_lock_interruptible(dev);
3694 obj = to_intel_bo(drm_gem_object_lookup(dev, file_priv, args->handle));
3695 if (&obj->base == NULL) {
3700 if (obj->pin_count) {
3705 if (obj->madv != __I915_MADV_PURGED)
3706 obj->madv = args->madv;
3708 /* if the object is no longer attached, discard its backing storage */
3709 if (i915_gem_object_is_purgeable(obj) && obj->pages == NULL)
3710 i915_gem_object_truncate(obj);
3712 args->retained = obj->madv != __I915_MADV_PURGED;
3715 drm_gem_object_unreference(&obj->base);
3717 mutex_unlock(&dev->struct_mutex);
3721 void i915_gem_object_init(struct drm_i915_gem_object *obj,
3722 const struct drm_i915_gem_object_ops *ops)
3724 INIT_LIST_HEAD(&obj->mm_list);
3725 INIT_LIST_HEAD(&obj->gtt_list);
3726 INIT_LIST_HEAD(&obj->ring_list);
3727 INIT_LIST_HEAD(&obj->exec_list);
3731 obj->fence_reg = I915_FENCE_REG_NONE;
3732 obj->madv = I915_MADV_WILLNEED;
3733 /* Avoid an unnecessary call to unbind on the first bind. */
3734 obj->map_and_fenceable = true;
3736 i915_gem_info_add_obj(obj->base.dev->dev_private, obj->base.size);
3739 static const struct drm_i915_gem_object_ops i915_gem_object_ops = {
3740 .get_pages = i915_gem_object_get_pages_gtt,
3741 .put_pages = i915_gem_object_put_pages_gtt,
3744 struct drm_i915_gem_object *i915_gem_alloc_object(struct drm_device *dev,
3747 struct drm_i915_gem_object *obj;
3748 struct address_space *mapping;
3751 obj = i915_gem_object_alloc(dev);
3755 if (drm_gem_object_init(dev, &obj->base, size) != 0) {
3756 i915_gem_object_free(obj);
3760 mask = GFP_HIGHUSER | __GFP_RECLAIMABLE;
3761 if (IS_CRESTLINE(dev) || IS_BROADWATER(dev)) {
3762 /* 965gm cannot relocate objects above 4GiB. */
3763 mask &= ~__GFP_HIGHMEM;
3764 mask |= __GFP_DMA32;
3767 mapping = file_inode(obj->base.filp)->i_mapping;
3768 mapping_set_gfp_mask(mapping, mask);
3770 i915_gem_object_init(obj, &i915_gem_object_ops);
3772 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
3773 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
3776 /* On some devices, we can have the GPU use the LLC (the CPU
3777 * cache) for about a 10% performance improvement
3778 * compared to uncached. Graphics requests other than
3779 * display scanout are coherent with the CPU in
3780 * accessing this cache. This means in this mode we
3781 * don't need to clflush on the CPU side, and on the
3782 * GPU side we only need to flush internal caches to
3783 * get data visible to the CPU.
3785 * However, we maintain the display planes as UC, and so
3786 * need to rebind when first used as such.
3788 obj->cache_level = I915_CACHE_LLC;
3790 obj->cache_level = I915_CACHE_NONE;
3795 int i915_gem_init_object(struct drm_gem_object *obj)
3802 void i915_gem_free_object(struct drm_gem_object *gem_obj)
3804 struct drm_i915_gem_object *obj = to_intel_bo(gem_obj);
3805 struct drm_device *dev = obj->base.dev;
3806 drm_i915_private_t *dev_priv = dev->dev_private;
3808 trace_i915_gem_object_destroy(obj);
3811 i915_gem_detach_phys_object(dev, obj);
3814 if (WARN_ON(i915_gem_object_unbind(obj) == -ERESTARTSYS)) {
3815 bool was_interruptible;
3817 was_interruptible = dev_priv->mm.interruptible;
3818 dev_priv->mm.interruptible = false;
3820 WARN_ON(i915_gem_object_unbind(obj));
3822 dev_priv->mm.interruptible = was_interruptible;
3825 obj->pages_pin_count = 0;
3826 i915_gem_object_put_pages(obj);
3827 i915_gem_object_free_mmap_offset(obj);
3828 i915_gem_object_release_stolen(obj);
3832 if (obj->base.import_attach)
3833 drm_prime_gem_destroy(&obj->base, NULL);
3835 drm_gem_object_release(&obj->base);
3836 i915_gem_info_remove_obj(dev_priv, obj->base.size);
3839 i915_gem_object_free(obj);
3843 i915_gem_idle(struct drm_device *dev)
3845 drm_i915_private_t *dev_priv = dev->dev_private;
3848 mutex_lock(&dev->struct_mutex);
3850 if (dev_priv->mm.suspended) {
3851 mutex_unlock(&dev->struct_mutex);
3855 ret = i915_gpu_idle(dev);
3857 mutex_unlock(&dev->struct_mutex);
3860 i915_gem_retire_requests(dev);
3862 /* Under UMS, be paranoid and evict. */
3863 if (!drm_core_check_feature(dev, DRIVER_MODESET))
3864 i915_gem_evict_everything(dev);
3866 /* Hack! Don't let anybody do execbuf while we don't control the chip.
3867 * We need to replace this with a semaphore, or something.
3868 * And not confound mm.suspended!
3870 dev_priv->mm.suspended = 1;
3871 del_timer_sync(&dev_priv->gpu_error.hangcheck_timer);
3873 i915_kernel_lost_context(dev);
3874 i915_gem_cleanup_ringbuffer(dev);
3876 mutex_unlock(&dev->struct_mutex);
3878 /* Cancel the retire work handler, which should be idle now. */
3879 cancel_delayed_work_sync(&dev_priv->mm.retire_work);
3884 void i915_gem_l3_remap(struct drm_device *dev)
3886 drm_i915_private_t *dev_priv = dev->dev_private;
3890 if (!HAS_L3_GPU_CACHE(dev))
3893 if (!dev_priv->l3_parity.remap_info)
3896 misccpctl = I915_READ(GEN7_MISCCPCTL);
3897 I915_WRITE(GEN7_MISCCPCTL, misccpctl & ~GEN7_DOP_CLOCK_GATE_ENABLE);
3898 POSTING_READ(GEN7_MISCCPCTL);
3900 for (i = 0; i < GEN7_L3LOG_SIZE; i += 4) {
3901 u32 remap = I915_READ(GEN7_L3LOG_BASE + i);
3902 if (remap && remap != dev_priv->l3_parity.remap_info[i/4])
3903 DRM_DEBUG("0x%x was already programmed to %x\n",
3904 GEN7_L3LOG_BASE + i, remap);
3905 if (remap && !dev_priv->l3_parity.remap_info[i/4])
3906 DRM_DEBUG_DRIVER("Clearing remapped register\n");
3907 I915_WRITE(GEN7_L3LOG_BASE + i, dev_priv->l3_parity.remap_info[i/4]);
3910 /* Make sure all the writes land before disabling dop clock gating */
3911 POSTING_READ(GEN7_L3LOG_BASE);
3913 I915_WRITE(GEN7_MISCCPCTL, misccpctl);
3916 void i915_gem_init_swizzling(struct drm_device *dev)
3918 drm_i915_private_t *dev_priv = dev->dev_private;
3920 if (INTEL_INFO(dev)->gen < 5 ||
3921 dev_priv->mm.bit_6_swizzle_x == I915_BIT_6_SWIZZLE_NONE)
3924 I915_WRITE(DISP_ARB_CTL, I915_READ(DISP_ARB_CTL) |
3925 DISP_TILE_SURFACE_SWIZZLING);
3930 I915_WRITE(TILECTL, I915_READ(TILECTL) | TILECTL_SWZCTL);
3932 I915_WRITE(ARB_MODE, _MASKED_BIT_ENABLE(ARB_MODE_SWIZZLE_SNB));
3933 else if (IS_GEN7(dev))
3934 I915_WRITE(ARB_MODE, _MASKED_BIT_ENABLE(ARB_MODE_SWIZZLE_IVB));
3940 intel_enable_blt(struct drm_device *dev)
3945 /* The blitter was dysfunctional on early prototypes */
3946 if (IS_GEN6(dev) && dev->pdev->revision < 8) {
3947 DRM_INFO("BLT not supported on this pre-production hardware;"
3948 " graphics performance will be degraded.\n");
3955 static int i915_gem_init_rings(struct drm_device *dev)
3957 struct drm_i915_private *dev_priv = dev->dev_private;
3960 ret = intel_init_render_ring_buffer(dev);
3965 ret = intel_init_bsd_ring_buffer(dev);
3967 goto cleanup_render_ring;
3970 if (intel_enable_blt(dev)) {
3971 ret = intel_init_blt_ring_buffer(dev);
3973 goto cleanup_bsd_ring;
3976 ret = i915_gem_set_seqno(dev, ((u32)~0 - 0x1000));
3978 goto cleanup_blt_ring;
3983 intel_cleanup_ring_buffer(&dev_priv->ring[BCS]);
3985 intel_cleanup_ring_buffer(&dev_priv->ring[VCS]);
3986 cleanup_render_ring:
3987 intel_cleanup_ring_buffer(&dev_priv->ring[RCS]);
3993 i915_gem_init_hw(struct drm_device *dev)
3995 drm_i915_private_t *dev_priv = dev->dev_private;
3998 if (INTEL_INFO(dev)->gen < 6 && !intel_enable_gtt())
4001 if (IS_HASWELL(dev) && (I915_READ(0x120010) == 1))
4002 I915_WRITE(0x9008, I915_READ(0x9008) | 0xf0000);
4004 if (HAS_PCH_NOP(dev)) {
4005 u32 temp = I915_READ(GEN7_MSG_CTL);
4006 temp &= ~(WAIT_FOR_PCH_FLR_ACK | WAIT_FOR_PCH_RESET_ACK);
4007 I915_WRITE(GEN7_MSG_CTL, temp);
4010 i915_gem_l3_remap(dev);
4012 i915_gem_init_swizzling(dev);
4014 ret = i915_gem_init_rings(dev);
4019 * XXX: There was some w/a described somewhere suggesting loading
4020 * contexts before PPGTT.
4022 i915_gem_context_init(dev);
4023 if (dev_priv->mm.aliasing_ppgtt) {
4024 ret = dev_priv->mm.aliasing_ppgtt->enable(dev);
4026 i915_gem_cleanup_aliasing_ppgtt(dev);
4027 DRM_INFO("PPGTT enable failed. This is not fatal, but unexpected\n");
4034 int i915_gem_init(struct drm_device *dev)
4036 struct drm_i915_private *dev_priv = dev->dev_private;
4039 mutex_lock(&dev->struct_mutex);
4041 if (IS_VALLEYVIEW(dev)) {
4042 /* VLVA0 (potential hack), BIOS isn't actually waking us */
4043 I915_WRITE(VLV_GTLC_WAKE_CTRL, 1);
4044 if (wait_for((I915_READ(VLV_GTLC_PW_STATUS) & 1) == 1, 10))
4045 DRM_DEBUG_DRIVER("allow wake ack timed out\n");
4048 i915_gem_init_global_gtt(dev);
4050 ret = i915_gem_init_hw(dev);
4051 mutex_unlock(&dev->struct_mutex);
4053 i915_gem_cleanup_aliasing_ppgtt(dev);
4057 /* Allow hardware batchbuffers unless told otherwise, but not for KMS. */
4058 if (!drm_core_check_feature(dev, DRIVER_MODESET))
4059 dev_priv->dri1.allow_batchbuffer = 1;
4064 i915_gem_cleanup_ringbuffer(struct drm_device *dev)
4066 drm_i915_private_t *dev_priv = dev->dev_private;
4067 struct intel_ring_buffer *ring;
4070 for_each_ring(ring, dev_priv, i)
4071 intel_cleanup_ring_buffer(ring);
4075 i915_gem_entervt_ioctl(struct drm_device *dev, void *data,
4076 struct drm_file *file_priv)
4078 drm_i915_private_t *dev_priv = dev->dev_private;
4081 if (drm_core_check_feature(dev, DRIVER_MODESET))
4084 if (i915_reset_in_progress(&dev_priv->gpu_error)) {
4085 DRM_ERROR("Reenabling wedged hardware, good luck\n");
4086 atomic_set(&dev_priv->gpu_error.reset_counter, 0);
4089 mutex_lock(&dev->struct_mutex);
4090 dev_priv->mm.suspended = 0;
4092 ret = i915_gem_init_hw(dev);
4094 mutex_unlock(&dev->struct_mutex);
4098 BUG_ON(!list_empty(&dev_priv->mm.active_list));
4099 mutex_unlock(&dev->struct_mutex);
4101 ret = drm_irq_install(dev);
4103 goto cleanup_ringbuffer;
4108 mutex_lock(&dev->struct_mutex);
4109 i915_gem_cleanup_ringbuffer(dev);
4110 dev_priv->mm.suspended = 1;
4111 mutex_unlock(&dev->struct_mutex);
4117 i915_gem_leavevt_ioctl(struct drm_device *dev, void *data,
4118 struct drm_file *file_priv)
4120 if (drm_core_check_feature(dev, DRIVER_MODESET))
4123 drm_irq_uninstall(dev);
4124 return i915_gem_idle(dev);
4128 i915_gem_lastclose(struct drm_device *dev)
4132 if (drm_core_check_feature(dev, DRIVER_MODESET))
4135 ret = i915_gem_idle(dev);
4137 DRM_ERROR("failed to idle hardware: %d\n", ret);
4141 init_ring_lists(struct intel_ring_buffer *ring)
4143 INIT_LIST_HEAD(&ring->active_list);
4144 INIT_LIST_HEAD(&ring->request_list);
4148 i915_gem_load(struct drm_device *dev)
4150 drm_i915_private_t *dev_priv = dev->dev_private;
4154 kmem_cache_create("i915_gem_object",
4155 sizeof(struct drm_i915_gem_object), 0,
4159 INIT_LIST_HEAD(&dev_priv->mm.active_list);
4160 INIT_LIST_HEAD(&dev_priv->mm.inactive_list);
4161 INIT_LIST_HEAD(&dev_priv->mm.unbound_list);
4162 INIT_LIST_HEAD(&dev_priv->mm.bound_list);
4163 INIT_LIST_HEAD(&dev_priv->mm.fence_list);
4164 for (i = 0; i < I915_NUM_RINGS; i++)
4165 init_ring_lists(&dev_priv->ring[i]);
4166 for (i = 0; i < I915_MAX_NUM_FENCES; i++)
4167 INIT_LIST_HEAD(&dev_priv->fence_regs[i].lru_list);
4168 INIT_DELAYED_WORK(&dev_priv->mm.retire_work,
4169 i915_gem_retire_work_handler);
4170 init_waitqueue_head(&dev_priv->gpu_error.reset_queue);
4172 /* On GEN3 we really need to make sure the ARB C3 LP bit is set */
4174 I915_WRITE(MI_ARB_STATE,
4175 _MASKED_BIT_ENABLE(MI_ARB_C3_LP_WRITE_ENABLE));
4178 dev_priv->relative_constants_mode = I915_EXEC_CONSTANTS_REL_GENERAL;
4180 /* Old X drivers will take 0-2 for front, back, depth buffers */
4181 if (!drm_core_check_feature(dev, DRIVER_MODESET))
4182 dev_priv->fence_reg_start = 3;
4184 if (INTEL_INFO(dev)->gen >= 7 && !IS_VALLEYVIEW(dev))
4185 dev_priv->num_fence_regs = 32;
4186 else if (INTEL_INFO(dev)->gen >= 4 || IS_I945G(dev) || IS_I945GM(dev) || IS_G33(dev))
4187 dev_priv->num_fence_regs = 16;
4189 dev_priv->num_fence_regs = 8;
4191 /* Initialize fence registers to zero */
4192 INIT_LIST_HEAD(&dev_priv->mm.fence_list);
4193 i915_gem_restore_fences(dev);
4195 i915_gem_detect_bit_6_swizzle(dev);
4196 init_waitqueue_head(&dev_priv->pending_flip_queue);
4198 dev_priv->mm.interruptible = true;
4200 dev_priv->mm.inactive_shrinker.shrink = i915_gem_inactive_shrink;
4201 dev_priv->mm.inactive_shrinker.seeks = DEFAULT_SEEKS;
4202 register_shrinker(&dev_priv->mm.inactive_shrinker);
4206 * Create a physically contiguous memory object for this object
4207 * e.g. for cursor + overlay regs
4209 static int i915_gem_init_phys_object(struct drm_device *dev,
4210 int id, int size, int align)
4212 drm_i915_private_t *dev_priv = dev->dev_private;
4213 struct drm_i915_gem_phys_object *phys_obj;
4216 if (dev_priv->mm.phys_objs[id - 1] || !size)
4219 phys_obj = kzalloc(sizeof(struct drm_i915_gem_phys_object), GFP_KERNEL);
4225 phys_obj->handle = drm_pci_alloc(dev, size, align);
4226 if (!phys_obj->handle) {
4231 set_memory_wc((unsigned long)phys_obj->handle->vaddr, phys_obj->handle->size / PAGE_SIZE);
4234 dev_priv->mm.phys_objs[id - 1] = phys_obj;
4242 static void i915_gem_free_phys_object(struct drm_device *dev, int id)
4244 drm_i915_private_t *dev_priv = dev->dev_private;
4245 struct drm_i915_gem_phys_object *phys_obj;
4247 if (!dev_priv->mm.phys_objs[id - 1])
4250 phys_obj = dev_priv->mm.phys_objs[id - 1];
4251 if (phys_obj->cur_obj) {
4252 i915_gem_detach_phys_object(dev, phys_obj->cur_obj);
4256 set_memory_wb((unsigned long)phys_obj->handle->vaddr, phys_obj->handle->size / PAGE_SIZE);
4258 drm_pci_free(dev, phys_obj->handle);
4260 dev_priv->mm.phys_objs[id - 1] = NULL;
4263 void i915_gem_free_all_phys_object(struct drm_device *dev)
4267 for (i = I915_GEM_PHYS_CURSOR_0; i <= I915_MAX_PHYS_OBJECT; i++)
4268 i915_gem_free_phys_object(dev, i);
4271 void i915_gem_detach_phys_object(struct drm_device *dev,
4272 struct drm_i915_gem_object *obj)
4274 struct address_space *mapping = file_inode(obj->base.filp)->i_mapping;
4281 vaddr = obj->phys_obj->handle->vaddr;
4283 page_count = obj->base.size / PAGE_SIZE;
4284 for (i = 0; i < page_count; i++) {
4285 struct page *page = shmem_read_mapping_page(mapping, i);
4286 if (!IS_ERR(page)) {
4287 char *dst = kmap_atomic(page);
4288 memcpy(dst, vaddr + i*PAGE_SIZE, PAGE_SIZE);
4291 drm_clflush_pages(&page, 1);
4293 set_page_dirty(page);
4294 mark_page_accessed(page);
4295 page_cache_release(page);
4298 i915_gem_chipset_flush(dev);
4300 obj->phys_obj->cur_obj = NULL;
4301 obj->phys_obj = NULL;
4305 i915_gem_attach_phys_object(struct drm_device *dev,
4306 struct drm_i915_gem_object *obj,
4310 struct address_space *mapping = file_inode(obj->base.filp)->i_mapping;
4311 drm_i915_private_t *dev_priv = dev->dev_private;
4316 if (id > I915_MAX_PHYS_OBJECT)
4319 if (obj->phys_obj) {
4320 if (obj->phys_obj->id == id)
4322 i915_gem_detach_phys_object(dev, obj);
4325 /* create a new object */
4326 if (!dev_priv->mm.phys_objs[id - 1]) {
4327 ret = i915_gem_init_phys_object(dev, id,
4328 obj->base.size, align);
4330 DRM_ERROR("failed to init phys object %d size: %zu\n",
4331 id, obj->base.size);
4336 /* bind to the object */
4337 obj->phys_obj = dev_priv->mm.phys_objs[id - 1];
4338 obj->phys_obj->cur_obj = obj;
4340 page_count = obj->base.size / PAGE_SIZE;
4342 for (i = 0; i < page_count; i++) {
4346 page = shmem_read_mapping_page(mapping, i);
4348 return PTR_ERR(page);
4350 src = kmap_atomic(page);
4351 dst = obj->phys_obj->handle->vaddr + (i * PAGE_SIZE);
4352 memcpy(dst, src, PAGE_SIZE);
4355 mark_page_accessed(page);
4356 page_cache_release(page);
4363 i915_gem_phys_pwrite(struct drm_device *dev,
4364 struct drm_i915_gem_object *obj,
4365 struct drm_i915_gem_pwrite *args,
4366 struct drm_file *file_priv)
4368 void *vaddr = obj->phys_obj->handle->vaddr + args->offset;
4369 char __user *user_data = to_user_ptr(args->data_ptr);
4371 if (__copy_from_user_inatomic_nocache(vaddr, user_data, args->size)) {
4372 unsigned long unwritten;
4374 /* The physical object once assigned is fixed for the lifetime
4375 * of the obj, so we can safely drop the lock and continue
4378 mutex_unlock(&dev->struct_mutex);
4379 unwritten = copy_from_user(vaddr, user_data, args->size);
4380 mutex_lock(&dev->struct_mutex);
4385 i915_gem_chipset_flush(dev);
4389 void i915_gem_release(struct drm_device *dev, struct drm_file *file)
4391 struct drm_i915_file_private *file_priv = file->driver_priv;
4393 /* Clean up our request list when the client is going away, so that
4394 * later retire_requests won't dereference our soon-to-be-gone
4397 spin_lock(&file_priv->mm.lock);
4398 while (!list_empty(&file_priv->mm.request_list)) {
4399 struct drm_i915_gem_request *request;
4401 request = list_first_entry(&file_priv->mm.request_list,
4402 struct drm_i915_gem_request,
4404 list_del(&request->client_list);
4405 request->file_priv = NULL;
4407 spin_unlock(&file_priv->mm.lock);
4410 static bool mutex_is_locked_by(struct mutex *mutex, struct task_struct *task)
4412 if (!mutex_is_locked(mutex))
4415 #if defined(CONFIG_SMP) || defined(CONFIG_DEBUG_MUTEXES)
4416 return mutex->owner == task;
4418 /* Since UP may be pre-empted, we cannot assume that we own the lock */
4424 i915_gem_inactive_shrink(struct shrinker *shrinker, struct shrink_control *sc)
4426 struct drm_i915_private *dev_priv =
4427 container_of(shrinker,
4428 struct drm_i915_private,
4429 mm.inactive_shrinker);
4430 struct drm_device *dev = dev_priv->dev;
4431 struct drm_i915_gem_object *obj;
4432 int nr_to_scan = sc->nr_to_scan;
4436 if (!mutex_trylock(&dev->struct_mutex)) {
4437 if (!mutex_is_locked_by(&dev->struct_mutex, current))
4440 if (dev_priv->mm.shrinker_no_lock_stealing)
4447 nr_to_scan -= i915_gem_purge(dev_priv, nr_to_scan);
4449 nr_to_scan -= __i915_gem_shrink(dev_priv, nr_to_scan,
4452 i915_gem_shrink_all(dev_priv);
4456 list_for_each_entry(obj, &dev_priv->mm.unbound_list, gtt_list)
4457 if (obj->pages_pin_count == 0)
4458 cnt += obj->base.size >> PAGE_SHIFT;
4459 list_for_each_entry(obj, &dev_priv->mm.inactive_list, gtt_list)
4460 if (obj->pin_count == 0 && obj->pages_pin_count == 0)
4461 cnt += obj->base.size >> PAGE_SHIFT;
4464 mutex_unlock(&dev->struct_mutex);