2 * Copyright © 2008-2015 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/drm_vma_manager.h>
30 #include <drm/i915_drm.h>
32 #include "i915_gem_clflush.h"
33 #include "i915_vgpu.h"
34 #include "i915_trace.h"
35 #include "intel_drv.h"
36 #include "intel_frontbuffer.h"
37 #include "intel_mocs.h"
38 #include <linux/dma-fence-array.h>
39 #include <linux/kthread.h>
40 #include <linux/reservation.h>
41 #include <linux/shmem_fs.h>
42 #include <linux/slab.h>
43 #include <linux/stop_machine.h>
44 #include <linux/swap.h>
45 #include <linux/pci.h>
46 #include <linux/dma-buf.h>
48 static void i915_gem_flush_free_objects(struct drm_i915_private *i915);
50 static bool cpu_write_needs_clflush(struct drm_i915_gem_object *obj)
52 if (obj->base.write_domain == I915_GEM_DOMAIN_CPU)
55 if (!i915_gem_object_is_coherent(obj))
58 return obj->pin_display;
62 insert_mappable_node(struct i915_ggtt *ggtt,
63 struct drm_mm_node *node, u32 size)
65 memset(node, 0, sizeof(*node));
66 return drm_mm_insert_node_in_range(&ggtt->base.mm, node,
67 size, 0, I915_COLOR_UNEVICTABLE,
68 0, ggtt->mappable_end,
73 remove_mappable_node(struct drm_mm_node *node)
75 drm_mm_remove_node(node);
78 /* some bookkeeping */
79 static void i915_gem_info_add_obj(struct drm_i915_private *dev_priv,
82 spin_lock(&dev_priv->mm.object_stat_lock);
83 dev_priv->mm.object_count++;
84 dev_priv->mm.object_memory += size;
85 spin_unlock(&dev_priv->mm.object_stat_lock);
88 static void i915_gem_info_remove_obj(struct drm_i915_private *dev_priv,
91 spin_lock(&dev_priv->mm.object_stat_lock);
92 dev_priv->mm.object_count--;
93 dev_priv->mm.object_memory -= size;
94 spin_unlock(&dev_priv->mm.object_stat_lock);
98 i915_gem_wait_for_error(struct i915_gpu_error *error)
105 * Only wait 10 seconds for the gpu reset to complete to avoid hanging
106 * userspace. If it takes that long something really bad is going on and
107 * we should simply try to bail out and fail as gracefully as possible.
109 ret = wait_event_interruptible_timeout(error->reset_queue,
110 !i915_reset_backoff(error),
113 DRM_ERROR("Timed out waiting for the gpu reset to complete\n");
115 } else if (ret < 0) {
122 int i915_mutex_lock_interruptible(struct drm_device *dev)
124 struct drm_i915_private *dev_priv = to_i915(dev);
127 ret = i915_gem_wait_for_error(&dev_priv->gpu_error);
131 ret = mutex_lock_interruptible(&dev->struct_mutex);
139 i915_gem_get_aperture_ioctl(struct drm_device *dev, void *data,
140 struct drm_file *file)
142 struct drm_i915_private *dev_priv = to_i915(dev);
143 struct i915_ggtt *ggtt = &dev_priv->ggtt;
144 struct drm_i915_gem_get_aperture *args = data;
145 struct i915_vma *vma;
149 mutex_lock(&dev->struct_mutex);
150 list_for_each_entry(vma, &ggtt->base.active_list, vm_link)
151 if (i915_vma_is_pinned(vma))
152 pinned += vma->node.size;
153 list_for_each_entry(vma, &ggtt->base.inactive_list, vm_link)
154 if (i915_vma_is_pinned(vma))
155 pinned += vma->node.size;
156 mutex_unlock(&dev->struct_mutex);
158 args->aper_size = ggtt->base.total;
159 args->aper_available_size = args->aper_size - pinned;
164 static struct sg_table *
165 i915_gem_object_get_pages_phys(struct drm_i915_gem_object *obj)
167 struct address_space *mapping = obj->base.filp->f_mapping;
168 drm_dma_handle_t *phys;
170 struct scatterlist *sg;
174 if (WARN_ON(i915_gem_object_needs_bit17_swizzle(obj)))
175 return ERR_PTR(-EINVAL);
177 /* Always aligning to the object size, allows a single allocation
178 * to handle all possible callers, and given typical object sizes,
179 * the alignment of the buddy allocation will naturally match.
181 phys = drm_pci_alloc(obj->base.dev,
183 roundup_pow_of_two(obj->base.size));
185 return ERR_PTR(-ENOMEM);
188 for (i = 0; i < obj->base.size / PAGE_SIZE; i++) {
192 page = shmem_read_mapping_page(mapping, i);
198 src = kmap_atomic(page);
199 memcpy(vaddr, src, PAGE_SIZE);
200 drm_clflush_virt_range(vaddr, PAGE_SIZE);
207 i915_gem_chipset_flush(to_i915(obj->base.dev));
209 st = kmalloc(sizeof(*st), GFP_KERNEL);
211 st = ERR_PTR(-ENOMEM);
215 if (sg_alloc_table(st, 1, GFP_KERNEL)) {
217 st = ERR_PTR(-ENOMEM);
223 sg->length = obj->base.size;
225 sg_dma_address(sg) = phys->busaddr;
226 sg_dma_len(sg) = obj->base.size;
228 obj->phys_handle = phys;
232 drm_pci_free(obj->base.dev, phys);
237 __i915_gem_object_release_shmem(struct drm_i915_gem_object *obj,
238 struct sg_table *pages,
241 GEM_BUG_ON(obj->mm.madv == __I915_MADV_PURGED);
243 if (obj->mm.madv == I915_MADV_DONTNEED)
244 obj->mm.dirty = false;
247 (obj->base.read_domains & I915_GEM_DOMAIN_CPU) == 0 &&
248 !i915_gem_object_is_coherent(obj))
249 drm_clflush_sg(pages);
251 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
252 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
256 i915_gem_object_put_pages_phys(struct drm_i915_gem_object *obj,
257 struct sg_table *pages)
259 __i915_gem_object_release_shmem(obj, pages, false);
262 struct address_space *mapping = obj->base.filp->f_mapping;
263 char *vaddr = obj->phys_handle->vaddr;
266 for (i = 0; i < obj->base.size / PAGE_SIZE; i++) {
270 page = shmem_read_mapping_page(mapping, i);
274 dst = kmap_atomic(page);
275 drm_clflush_virt_range(vaddr, PAGE_SIZE);
276 memcpy(dst, vaddr, PAGE_SIZE);
279 set_page_dirty(page);
280 if (obj->mm.madv == I915_MADV_WILLNEED)
281 mark_page_accessed(page);
285 obj->mm.dirty = false;
288 sg_free_table(pages);
291 drm_pci_free(obj->base.dev, obj->phys_handle);
295 i915_gem_object_release_phys(struct drm_i915_gem_object *obj)
297 i915_gem_object_unpin_pages(obj);
300 static const struct drm_i915_gem_object_ops i915_gem_phys_ops = {
301 .get_pages = i915_gem_object_get_pages_phys,
302 .put_pages = i915_gem_object_put_pages_phys,
303 .release = i915_gem_object_release_phys,
306 static const struct drm_i915_gem_object_ops i915_gem_object_ops;
308 int i915_gem_object_unbind(struct drm_i915_gem_object *obj)
310 struct i915_vma *vma;
311 LIST_HEAD(still_in_list);
314 lockdep_assert_held(&obj->base.dev->struct_mutex);
316 /* Closed vma are removed from the obj->vma_list - but they may
317 * still have an active binding on the object. To remove those we
318 * must wait for all rendering to complete to the object (as unbinding
319 * must anyway), and retire the requests.
321 ret = i915_gem_object_wait(obj,
322 I915_WAIT_INTERRUPTIBLE |
325 MAX_SCHEDULE_TIMEOUT,
330 i915_gem_retire_requests(to_i915(obj->base.dev));
332 while ((vma = list_first_entry_or_null(&obj->vma_list,
335 list_move_tail(&vma->obj_link, &still_in_list);
336 ret = i915_vma_unbind(vma);
340 list_splice(&still_in_list, &obj->vma_list);
346 i915_gem_object_wait_fence(struct dma_fence *fence,
349 struct intel_rps_client *rps)
351 struct drm_i915_gem_request *rq;
353 BUILD_BUG_ON(I915_WAIT_INTERRUPTIBLE != 0x1);
355 if (test_bit(DMA_FENCE_FLAG_SIGNALED_BIT, &fence->flags))
358 if (!dma_fence_is_i915(fence))
359 return dma_fence_wait_timeout(fence,
360 flags & I915_WAIT_INTERRUPTIBLE,
363 rq = to_request(fence);
364 if (i915_gem_request_completed(rq))
367 /* This client is about to stall waiting for the GPU. In many cases
368 * this is undesirable and limits the throughput of the system, as
369 * many clients cannot continue processing user input/output whilst
370 * blocked. RPS autotuning may take tens of milliseconds to respond
371 * to the GPU load and thus incurs additional latency for the client.
372 * We can circumvent that by promoting the GPU frequency to maximum
373 * before we wait. This makes the GPU throttle up much more quickly
374 * (good for benchmarks and user experience, e.g. window animations),
375 * but at a cost of spending more power processing the workload
376 * (bad for battery). Not all clients even want their results
377 * immediately and for them we should just let the GPU select its own
378 * frequency to maximise efficiency. To prevent a single client from
379 * forcing the clocks too high for the whole system, we only allow
380 * each client to waitboost once in a busy period.
383 if (INTEL_GEN(rq->i915) >= 6)
384 gen6_rps_boost(rq->i915, rps, rq->emitted_jiffies);
389 timeout = i915_wait_request(rq, flags, timeout);
392 if (flags & I915_WAIT_LOCKED && i915_gem_request_completed(rq))
393 i915_gem_request_retire_upto(rq);
395 if (rps && i915_gem_request_global_seqno(rq) == intel_engine_last_submit(rq->engine)) {
396 /* The GPU is now idle and this client has stalled.
397 * Since no other client has submitted a request in the
398 * meantime, assume that this client is the only one
399 * supplying work to the GPU but is unable to keep that
400 * work supplied because it is waiting. Since the GPU is
401 * then never kept fully busy, RPS autoclocking will
402 * keep the clocks relatively low, causing further delays.
403 * Compensate by giving the synchronous client credit for
404 * a waitboost next time.
406 spin_lock(&rq->i915->rps.client_lock);
407 list_del_init(&rps->link);
408 spin_unlock(&rq->i915->rps.client_lock);
415 i915_gem_object_wait_reservation(struct reservation_object *resv,
418 struct intel_rps_client *rps)
420 unsigned int seq = __read_seqcount_begin(&resv->seq);
421 struct dma_fence *excl;
422 bool prune_fences = false;
424 if (flags & I915_WAIT_ALL) {
425 struct dma_fence **shared;
426 unsigned int count, i;
429 ret = reservation_object_get_fences_rcu(resv,
430 &excl, &count, &shared);
434 for (i = 0; i < count; i++) {
435 timeout = i915_gem_object_wait_fence(shared[i],
441 dma_fence_put(shared[i]);
444 for (; i < count; i++)
445 dma_fence_put(shared[i]);
448 prune_fences = count && timeout >= 0;
450 excl = reservation_object_get_excl_rcu(resv);
453 if (excl && timeout >= 0) {
454 timeout = i915_gem_object_wait_fence(excl, flags, timeout, rps);
455 prune_fences = timeout >= 0;
460 /* Oportunistically prune the fences iff we know they have *all* been
461 * signaled and that the reservation object has not been changed (i.e.
462 * no new fences have been added).
464 if (prune_fences && !__read_seqcount_retry(&resv->seq, seq)) {
465 if (reservation_object_trylock(resv)) {
466 if (!__read_seqcount_retry(&resv->seq, seq))
467 reservation_object_add_excl_fence(resv, NULL);
468 reservation_object_unlock(resv);
475 static void __fence_set_priority(struct dma_fence *fence, int prio)
477 struct drm_i915_gem_request *rq;
478 struct intel_engine_cs *engine;
480 if (!dma_fence_is_i915(fence))
483 rq = to_request(fence);
485 if (!engine->schedule)
488 engine->schedule(rq, prio);
491 static void fence_set_priority(struct dma_fence *fence, int prio)
493 /* Recurse once into a fence-array */
494 if (dma_fence_is_array(fence)) {
495 struct dma_fence_array *array = to_dma_fence_array(fence);
498 for (i = 0; i < array->num_fences; i++)
499 __fence_set_priority(array->fences[i], prio);
501 __fence_set_priority(fence, prio);
506 i915_gem_object_wait_priority(struct drm_i915_gem_object *obj,
510 struct dma_fence *excl;
512 if (flags & I915_WAIT_ALL) {
513 struct dma_fence **shared;
514 unsigned int count, i;
517 ret = reservation_object_get_fences_rcu(obj->resv,
518 &excl, &count, &shared);
522 for (i = 0; i < count; i++) {
523 fence_set_priority(shared[i], prio);
524 dma_fence_put(shared[i]);
529 excl = reservation_object_get_excl_rcu(obj->resv);
533 fence_set_priority(excl, prio);
540 * Waits for rendering to the object to be completed
541 * @obj: i915 gem object
542 * @flags: how to wait (under a lock, for all rendering or just for writes etc)
543 * @timeout: how long to wait
544 * @rps: client (user process) to charge for any waitboosting
547 i915_gem_object_wait(struct drm_i915_gem_object *obj,
550 struct intel_rps_client *rps)
553 #if IS_ENABLED(CONFIG_LOCKDEP)
554 GEM_BUG_ON(debug_locks &&
555 !!lockdep_is_held(&obj->base.dev->struct_mutex) !=
556 !!(flags & I915_WAIT_LOCKED));
558 GEM_BUG_ON(timeout < 0);
560 timeout = i915_gem_object_wait_reservation(obj->resv,
563 return timeout < 0 ? timeout : 0;
566 static struct intel_rps_client *to_rps_client(struct drm_file *file)
568 struct drm_i915_file_private *fpriv = file->driver_priv;
574 i915_gem_object_attach_phys(struct drm_i915_gem_object *obj,
579 if (align > obj->base.size)
582 if (obj->ops == &i915_gem_phys_ops)
585 if (obj->mm.madv != I915_MADV_WILLNEED)
588 if (obj->base.filp == NULL)
591 ret = i915_gem_object_unbind(obj);
595 __i915_gem_object_put_pages(obj, I915_MM_NORMAL);
599 GEM_BUG_ON(obj->ops != &i915_gem_object_ops);
600 obj->ops = &i915_gem_phys_ops;
602 ret = i915_gem_object_pin_pages(obj);
609 obj->ops = &i915_gem_object_ops;
614 i915_gem_phys_pwrite(struct drm_i915_gem_object *obj,
615 struct drm_i915_gem_pwrite *args,
616 struct drm_file *file)
618 void *vaddr = obj->phys_handle->vaddr + args->offset;
619 char __user *user_data = u64_to_user_ptr(args->data_ptr);
621 /* We manually control the domain here and pretend that it
622 * remains coherent i.e. in the GTT domain, like shmem_pwrite.
624 intel_fb_obj_invalidate(obj, ORIGIN_CPU);
625 if (copy_from_user(vaddr, user_data, args->size))
628 drm_clflush_virt_range(vaddr, args->size);
629 i915_gem_chipset_flush(to_i915(obj->base.dev));
631 intel_fb_obj_flush(obj, ORIGIN_CPU);
635 void *i915_gem_object_alloc(struct drm_i915_private *dev_priv)
637 return kmem_cache_zalloc(dev_priv->objects, GFP_KERNEL);
640 void i915_gem_object_free(struct drm_i915_gem_object *obj)
642 struct drm_i915_private *dev_priv = to_i915(obj->base.dev);
643 kmem_cache_free(dev_priv->objects, obj);
647 i915_gem_create(struct drm_file *file,
648 struct drm_i915_private *dev_priv,
652 struct drm_i915_gem_object *obj;
656 size = roundup(size, PAGE_SIZE);
660 /* Allocate the new object */
661 obj = i915_gem_object_create(dev_priv, size);
665 ret = drm_gem_handle_create(file, &obj->base, &handle);
666 /* drop reference from allocate - handle holds it now */
667 i915_gem_object_put(obj);
676 i915_gem_dumb_create(struct drm_file *file,
677 struct drm_device *dev,
678 struct drm_mode_create_dumb *args)
680 /* have to work out size/pitch and return them */
681 args->pitch = ALIGN(args->width * DIV_ROUND_UP(args->bpp, 8), 64);
682 args->size = args->pitch * args->height;
683 return i915_gem_create(file, to_i915(dev),
684 args->size, &args->handle);
688 * Creates a new mm object and returns a handle to it.
689 * @dev: drm device pointer
690 * @data: ioctl data blob
691 * @file: drm file pointer
694 i915_gem_create_ioctl(struct drm_device *dev, void *data,
695 struct drm_file *file)
697 struct drm_i915_private *dev_priv = to_i915(dev);
698 struct drm_i915_gem_create *args = data;
700 i915_gem_flush_free_objects(dev_priv);
702 return i915_gem_create(file, dev_priv,
703 args->size, &args->handle);
706 static inline enum fb_op_origin
707 fb_write_origin(struct drm_i915_gem_object *obj, unsigned int domain)
709 return (domain == I915_GEM_DOMAIN_GTT ?
710 obj->frontbuffer_ggtt_origin : ORIGIN_CPU);
714 flush_write_domain(struct drm_i915_gem_object *obj, unsigned int flush_domains)
716 struct drm_i915_private *dev_priv = to_i915(obj->base.dev);
718 if (!(obj->base.write_domain & flush_domains))
721 /* No actual flushing is required for the GTT write domain. Writes
722 * to it "immediately" go to main memory as far as we know, so there's
723 * no chipset flush. It also doesn't land in render cache.
725 * However, we do have to enforce the order so that all writes through
726 * the GTT land before any writes to the device, such as updates to
729 * We also have to wait a bit for the writes to land from the GTT.
730 * An uncached read (i.e. mmio) seems to be ideal for the round-trip
731 * timing. This issue has only been observed when switching quickly
732 * between GTT writes and CPU reads from inside the kernel on recent hw,
733 * and it appears to only affect discrete GTT blocks (i.e. on LLC
734 * system agents we cannot reproduce this behaviour).
738 switch (obj->base.write_domain) {
739 case I915_GEM_DOMAIN_GTT:
740 if (INTEL_GEN(dev_priv) >= 6 && !HAS_LLC(dev_priv)) {
741 if (intel_runtime_pm_get_if_in_use(dev_priv)) {
742 spin_lock_irq(&dev_priv->uncore.lock);
743 POSTING_READ_FW(RING_ACTHD(dev_priv->engine[RCS]->mmio_base));
744 spin_unlock_irq(&dev_priv->uncore.lock);
745 intel_runtime_pm_put(dev_priv);
749 intel_fb_obj_flush(obj,
750 fb_write_origin(obj, I915_GEM_DOMAIN_GTT));
753 case I915_GEM_DOMAIN_CPU:
754 i915_gem_clflush_object(obj, I915_CLFLUSH_SYNC);
758 obj->base.write_domain = 0;
762 __copy_to_user_swizzled(char __user *cpu_vaddr,
763 const char *gpu_vaddr, int gpu_offset,
766 int ret, cpu_offset = 0;
769 int cacheline_end = ALIGN(gpu_offset + 1, 64);
770 int this_length = min(cacheline_end - gpu_offset, length);
771 int swizzled_gpu_offset = gpu_offset ^ 64;
773 ret = __copy_to_user(cpu_vaddr + cpu_offset,
774 gpu_vaddr + swizzled_gpu_offset,
779 cpu_offset += this_length;
780 gpu_offset += this_length;
781 length -= this_length;
788 __copy_from_user_swizzled(char *gpu_vaddr, int gpu_offset,
789 const char __user *cpu_vaddr,
792 int ret, cpu_offset = 0;
795 int cacheline_end = ALIGN(gpu_offset + 1, 64);
796 int this_length = min(cacheline_end - gpu_offset, length);
797 int swizzled_gpu_offset = gpu_offset ^ 64;
799 ret = __copy_from_user(gpu_vaddr + swizzled_gpu_offset,
800 cpu_vaddr + cpu_offset,
805 cpu_offset += this_length;
806 gpu_offset += this_length;
807 length -= this_length;
814 * Pins the specified object's pages and synchronizes the object with
815 * GPU accesses. Sets needs_clflush to non-zero if the caller should
816 * flush the object from the CPU cache.
818 int i915_gem_obj_prepare_shmem_read(struct drm_i915_gem_object *obj,
819 unsigned int *needs_clflush)
823 lockdep_assert_held(&obj->base.dev->struct_mutex);
826 if (!i915_gem_object_has_struct_page(obj))
829 ret = i915_gem_object_wait(obj,
830 I915_WAIT_INTERRUPTIBLE |
832 MAX_SCHEDULE_TIMEOUT,
837 ret = i915_gem_object_pin_pages(obj);
841 if (i915_gem_object_is_coherent(obj) ||
842 !static_cpu_has(X86_FEATURE_CLFLUSH)) {
843 ret = i915_gem_object_set_to_cpu_domain(obj, false);
850 flush_write_domain(obj, ~I915_GEM_DOMAIN_CPU);
852 /* If we're not in the cpu read domain, set ourself into the gtt
853 * read domain and manually flush cachelines (if required). This
854 * optimizes for the case when the gpu will dirty the data
855 * anyway again before the next pread happens.
857 if (!(obj->base.read_domains & I915_GEM_DOMAIN_CPU))
858 *needs_clflush = CLFLUSH_BEFORE;
861 /* return with the pages pinned */
865 i915_gem_object_unpin_pages(obj);
869 int i915_gem_obj_prepare_shmem_write(struct drm_i915_gem_object *obj,
870 unsigned int *needs_clflush)
874 lockdep_assert_held(&obj->base.dev->struct_mutex);
877 if (!i915_gem_object_has_struct_page(obj))
880 ret = i915_gem_object_wait(obj,
881 I915_WAIT_INTERRUPTIBLE |
884 MAX_SCHEDULE_TIMEOUT,
889 ret = i915_gem_object_pin_pages(obj);
893 if (i915_gem_object_is_coherent(obj) ||
894 !static_cpu_has(X86_FEATURE_CLFLUSH)) {
895 ret = i915_gem_object_set_to_cpu_domain(obj, true);
902 flush_write_domain(obj, ~I915_GEM_DOMAIN_CPU);
904 /* If we're not in the cpu write domain, set ourself into the
905 * gtt write domain and manually flush cachelines (as required).
906 * This optimizes for the case when the gpu will use the data
907 * right away and we therefore have to clflush anyway.
909 if (obj->base.write_domain != I915_GEM_DOMAIN_CPU)
910 *needs_clflush |= CLFLUSH_AFTER;
912 /* Same trick applies to invalidate partially written cachelines read
915 if (!(obj->base.read_domains & I915_GEM_DOMAIN_CPU))
916 *needs_clflush |= CLFLUSH_BEFORE;
919 intel_fb_obj_invalidate(obj, ORIGIN_CPU);
920 obj->mm.dirty = true;
921 /* return with the pages pinned */
925 i915_gem_object_unpin_pages(obj);
930 shmem_clflush_swizzled_range(char *addr, unsigned long length,
933 if (unlikely(swizzled)) {
934 unsigned long start = (unsigned long) addr;
935 unsigned long end = (unsigned long) addr + length;
937 /* For swizzling simply ensure that we always flush both
938 * channels. Lame, but simple and it works. Swizzled
939 * pwrite/pread is far from a hotpath - current userspace
940 * doesn't use it at all. */
941 start = round_down(start, 128);
942 end = round_up(end, 128);
944 drm_clflush_virt_range((void *)start, end - start);
946 drm_clflush_virt_range(addr, length);
951 /* Only difference to the fast-path function is that this can handle bit17
952 * and uses non-atomic copy and kmap functions. */
954 shmem_pread_slow(struct page *page, int offset, int length,
955 char __user *user_data,
956 bool page_do_bit17_swizzling, bool needs_clflush)
963 shmem_clflush_swizzled_range(vaddr + offset, length,
964 page_do_bit17_swizzling);
966 if (page_do_bit17_swizzling)
967 ret = __copy_to_user_swizzled(user_data, vaddr, offset, length);
969 ret = __copy_to_user(user_data, vaddr + offset, length);
972 return ret ? - EFAULT : 0;
976 shmem_pread(struct page *page, int offset, int length, char __user *user_data,
977 bool page_do_bit17_swizzling, bool needs_clflush)
982 if (!page_do_bit17_swizzling) {
983 char *vaddr = kmap_atomic(page);
986 drm_clflush_virt_range(vaddr + offset, length);
987 ret = __copy_to_user_inatomic(user_data, vaddr + offset, length);
988 kunmap_atomic(vaddr);
993 return shmem_pread_slow(page, offset, length, user_data,
994 page_do_bit17_swizzling, needs_clflush);
998 i915_gem_shmem_pread(struct drm_i915_gem_object *obj,
999 struct drm_i915_gem_pread *args)
1001 char __user *user_data;
1003 unsigned int obj_do_bit17_swizzling;
1004 unsigned int needs_clflush;
1005 unsigned int idx, offset;
1008 obj_do_bit17_swizzling = 0;
1009 if (i915_gem_object_needs_bit17_swizzle(obj))
1010 obj_do_bit17_swizzling = BIT(17);
1012 ret = mutex_lock_interruptible(&obj->base.dev->struct_mutex);
1016 ret = i915_gem_obj_prepare_shmem_read(obj, &needs_clflush);
1017 mutex_unlock(&obj->base.dev->struct_mutex);
1021 remain = args->size;
1022 user_data = u64_to_user_ptr(args->data_ptr);
1023 offset = offset_in_page(args->offset);
1024 for (idx = args->offset >> PAGE_SHIFT; remain; idx++) {
1025 struct page *page = i915_gem_object_get_page(obj, idx);
1029 if (offset + length > PAGE_SIZE)
1030 length = PAGE_SIZE - offset;
1032 ret = shmem_pread(page, offset, length, user_data,
1033 page_to_phys(page) & obj_do_bit17_swizzling,
1039 user_data += length;
1043 i915_gem_obj_finish_shmem_access(obj);
1048 gtt_user_read(struct io_mapping *mapping,
1049 loff_t base, int offset,
1050 char __user *user_data, int length)
1053 unsigned long unwritten;
1055 /* We can use the cpu mem copy function because this is X86. */
1056 vaddr = (void __force *)io_mapping_map_atomic_wc(mapping, base);
1057 unwritten = __copy_to_user_inatomic(user_data, vaddr + offset, length);
1058 io_mapping_unmap_atomic(vaddr);
1060 vaddr = (void __force *)
1061 io_mapping_map_wc(mapping, base, PAGE_SIZE);
1062 unwritten = copy_to_user(user_data, vaddr + offset, length);
1063 io_mapping_unmap(vaddr);
1069 i915_gem_gtt_pread(struct drm_i915_gem_object *obj,
1070 const struct drm_i915_gem_pread *args)
1072 struct drm_i915_private *i915 = to_i915(obj->base.dev);
1073 struct i915_ggtt *ggtt = &i915->ggtt;
1074 struct drm_mm_node node;
1075 struct i915_vma *vma;
1076 void __user *user_data;
1080 ret = mutex_lock_interruptible(&i915->drm.struct_mutex);
1084 intel_runtime_pm_get(i915);
1085 vma = i915_gem_object_ggtt_pin(obj, NULL, 0, 0,
1086 PIN_MAPPABLE | PIN_NONBLOCK);
1088 node.start = i915_ggtt_offset(vma);
1089 node.allocated = false;
1090 ret = i915_vma_put_fence(vma);
1092 i915_vma_unpin(vma);
1097 ret = insert_mappable_node(ggtt, &node, PAGE_SIZE);
1100 GEM_BUG_ON(!node.allocated);
1103 ret = i915_gem_object_set_to_gtt_domain(obj, false);
1107 mutex_unlock(&i915->drm.struct_mutex);
1109 user_data = u64_to_user_ptr(args->data_ptr);
1110 remain = args->size;
1111 offset = args->offset;
1113 while (remain > 0) {
1114 /* Operation in this page
1116 * page_base = page offset within aperture
1117 * page_offset = offset within page
1118 * page_length = bytes to copy for this page
1120 u32 page_base = node.start;
1121 unsigned page_offset = offset_in_page(offset);
1122 unsigned page_length = PAGE_SIZE - page_offset;
1123 page_length = remain < page_length ? remain : page_length;
1124 if (node.allocated) {
1126 ggtt->base.insert_page(&ggtt->base,
1127 i915_gem_object_get_dma_address(obj, offset >> PAGE_SHIFT),
1128 node.start, I915_CACHE_NONE, 0);
1131 page_base += offset & PAGE_MASK;
1134 if (gtt_user_read(&ggtt->mappable, page_base, page_offset,
1135 user_data, page_length)) {
1140 remain -= page_length;
1141 user_data += page_length;
1142 offset += page_length;
1145 mutex_lock(&i915->drm.struct_mutex);
1147 if (node.allocated) {
1149 ggtt->base.clear_range(&ggtt->base,
1150 node.start, node.size);
1151 remove_mappable_node(&node);
1153 i915_vma_unpin(vma);
1156 intel_runtime_pm_put(i915);
1157 mutex_unlock(&i915->drm.struct_mutex);
1163 * Reads data from the object referenced by handle.
1164 * @dev: drm device pointer
1165 * @data: ioctl data blob
1166 * @file: drm file pointer
1168 * On error, the contents of *data are undefined.
1171 i915_gem_pread_ioctl(struct drm_device *dev, void *data,
1172 struct drm_file *file)
1174 struct drm_i915_gem_pread *args = data;
1175 struct drm_i915_gem_object *obj;
1178 if (args->size == 0)
1181 if (!access_ok(VERIFY_WRITE,
1182 u64_to_user_ptr(args->data_ptr),
1186 obj = i915_gem_object_lookup(file, args->handle);
1190 /* Bounds check source. */
1191 if (range_overflows_t(u64, args->offset, args->size, obj->base.size)) {
1196 trace_i915_gem_object_pread(obj, args->offset, args->size);
1198 ret = i915_gem_object_wait(obj,
1199 I915_WAIT_INTERRUPTIBLE,
1200 MAX_SCHEDULE_TIMEOUT,
1201 to_rps_client(file));
1205 ret = i915_gem_object_pin_pages(obj);
1209 ret = i915_gem_shmem_pread(obj, args);
1210 if (ret == -EFAULT || ret == -ENODEV)
1211 ret = i915_gem_gtt_pread(obj, args);
1213 i915_gem_object_unpin_pages(obj);
1215 i915_gem_object_put(obj);
1219 /* This is the fast write path which cannot handle
1220 * page faults in the source data
1224 ggtt_write(struct io_mapping *mapping,
1225 loff_t base, int offset,
1226 char __user *user_data, int length)
1229 unsigned long unwritten;
1231 /* We can use the cpu mem copy function because this is X86. */
1232 vaddr = (void __force *)io_mapping_map_atomic_wc(mapping, base);
1233 unwritten = __copy_from_user_inatomic_nocache(vaddr + offset,
1235 io_mapping_unmap_atomic(vaddr);
1237 vaddr = (void __force *)
1238 io_mapping_map_wc(mapping, base, PAGE_SIZE);
1239 unwritten = copy_from_user(vaddr + offset, user_data, length);
1240 io_mapping_unmap(vaddr);
1247 * This is the fast pwrite path, where we copy the data directly from the
1248 * user into the GTT, uncached.
1249 * @obj: i915 GEM object
1250 * @args: pwrite arguments structure
1253 i915_gem_gtt_pwrite_fast(struct drm_i915_gem_object *obj,
1254 const struct drm_i915_gem_pwrite *args)
1256 struct drm_i915_private *i915 = to_i915(obj->base.dev);
1257 struct i915_ggtt *ggtt = &i915->ggtt;
1258 struct drm_mm_node node;
1259 struct i915_vma *vma;
1261 void __user *user_data;
1264 ret = mutex_lock_interruptible(&i915->drm.struct_mutex);
1268 intel_runtime_pm_get(i915);
1269 vma = i915_gem_object_ggtt_pin(obj, NULL, 0, 0,
1270 PIN_MAPPABLE | PIN_NONBLOCK);
1272 node.start = i915_ggtt_offset(vma);
1273 node.allocated = false;
1274 ret = i915_vma_put_fence(vma);
1276 i915_vma_unpin(vma);
1281 ret = insert_mappable_node(ggtt, &node, PAGE_SIZE);
1284 GEM_BUG_ON(!node.allocated);
1287 ret = i915_gem_object_set_to_gtt_domain(obj, true);
1291 mutex_unlock(&i915->drm.struct_mutex);
1293 intel_fb_obj_invalidate(obj, ORIGIN_CPU);
1295 user_data = u64_to_user_ptr(args->data_ptr);
1296 offset = args->offset;
1297 remain = args->size;
1299 /* Operation in this page
1301 * page_base = page offset within aperture
1302 * page_offset = offset within page
1303 * page_length = bytes to copy for this page
1305 u32 page_base = node.start;
1306 unsigned int page_offset = offset_in_page(offset);
1307 unsigned int page_length = PAGE_SIZE - page_offset;
1308 page_length = remain < page_length ? remain : page_length;
1309 if (node.allocated) {
1310 wmb(); /* flush the write before we modify the GGTT */
1311 ggtt->base.insert_page(&ggtt->base,
1312 i915_gem_object_get_dma_address(obj, offset >> PAGE_SHIFT),
1313 node.start, I915_CACHE_NONE, 0);
1314 wmb(); /* flush modifications to the GGTT (insert_page) */
1316 page_base += offset & PAGE_MASK;
1318 /* If we get a fault while copying data, then (presumably) our
1319 * source page isn't available. Return the error and we'll
1320 * retry in the slow path.
1321 * If the object is non-shmem backed, we retry again with the
1322 * path that handles page fault.
1324 if (ggtt_write(&ggtt->mappable, page_base, page_offset,
1325 user_data, page_length)) {
1330 remain -= page_length;
1331 user_data += page_length;
1332 offset += page_length;
1334 intel_fb_obj_flush(obj, ORIGIN_CPU);
1336 mutex_lock(&i915->drm.struct_mutex);
1338 if (node.allocated) {
1340 ggtt->base.clear_range(&ggtt->base,
1341 node.start, node.size);
1342 remove_mappable_node(&node);
1344 i915_vma_unpin(vma);
1347 intel_runtime_pm_put(i915);
1348 mutex_unlock(&i915->drm.struct_mutex);
1353 shmem_pwrite_slow(struct page *page, int offset, int length,
1354 char __user *user_data,
1355 bool page_do_bit17_swizzling,
1356 bool needs_clflush_before,
1357 bool needs_clflush_after)
1363 if (unlikely(needs_clflush_before || page_do_bit17_swizzling))
1364 shmem_clflush_swizzled_range(vaddr + offset, length,
1365 page_do_bit17_swizzling);
1366 if (page_do_bit17_swizzling)
1367 ret = __copy_from_user_swizzled(vaddr, offset, user_data,
1370 ret = __copy_from_user(vaddr + offset, user_data, length);
1371 if (needs_clflush_after)
1372 shmem_clflush_swizzled_range(vaddr + offset, length,
1373 page_do_bit17_swizzling);
1376 return ret ? -EFAULT : 0;
1379 /* Per-page copy function for the shmem pwrite fastpath.
1380 * Flushes invalid cachelines before writing to the target if
1381 * needs_clflush_before is set and flushes out any written cachelines after
1382 * writing if needs_clflush is set.
1385 shmem_pwrite(struct page *page, int offset, int len, char __user *user_data,
1386 bool page_do_bit17_swizzling,
1387 bool needs_clflush_before,
1388 bool needs_clflush_after)
1393 if (!page_do_bit17_swizzling) {
1394 char *vaddr = kmap_atomic(page);
1396 if (needs_clflush_before)
1397 drm_clflush_virt_range(vaddr + offset, len);
1398 ret = __copy_from_user_inatomic(vaddr + offset, user_data, len);
1399 if (needs_clflush_after)
1400 drm_clflush_virt_range(vaddr + offset, len);
1402 kunmap_atomic(vaddr);
1407 return shmem_pwrite_slow(page, offset, len, user_data,
1408 page_do_bit17_swizzling,
1409 needs_clflush_before,
1410 needs_clflush_after);
1414 i915_gem_shmem_pwrite(struct drm_i915_gem_object *obj,
1415 const struct drm_i915_gem_pwrite *args)
1417 struct drm_i915_private *i915 = to_i915(obj->base.dev);
1418 void __user *user_data;
1420 unsigned int obj_do_bit17_swizzling;
1421 unsigned int partial_cacheline_write;
1422 unsigned int needs_clflush;
1423 unsigned int offset, idx;
1426 ret = mutex_lock_interruptible(&i915->drm.struct_mutex);
1430 ret = i915_gem_obj_prepare_shmem_write(obj, &needs_clflush);
1431 mutex_unlock(&i915->drm.struct_mutex);
1435 obj_do_bit17_swizzling = 0;
1436 if (i915_gem_object_needs_bit17_swizzle(obj))
1437 obj_do_bit17_swizzling = BIT(17);
1439 /* If we don't overwrite a cacheline completely we need to be
1440 * careful to have up-to-date data by first clflushing. Don't
1441 * overcomplicate things and flush the entire patch.
1443 partial_cacheline_write = 0;
1444 if (needs_clflush & CLFLUSH_BEFORE)
1445 partial_cacheline_write = boot_cpu_data.x86_clflush_size - 1;
1447 user_data = u64_to_user_ptr(args->data_ptr);
1448 remain = args->size;
1449 offset = offset_in_page(args->offset);
1450 for (idx = args->offset >> PAGE_SHIFT; remain; idx++) {
1451 struct page *page = i915_gem_object_get_page(obj, idx);
1455 if (offset + length > PAGE_SIZE)
1456 length = PAGE_SIZE - offset;
1458 ret = shmem_pwrite(page, offset, length, user_data,
1459 page_to_phys(page) & obj_do_bit17_swizzling,
1460 (offset | length) & partial_cacheline_write,
1461 needs_clflush & CLFLUSH_AFTER);
1466 user_data += length;
1470 intel_fb_obj_flush(obj, ORIGIN_CPU);
1471 i915_gem_obj_finish_shmem_access(obj);
1476 * Writes data to the object referenced by handle.
1478 * @data: ioctl data blob
1481 * On error, the contents of the buffer that were to be modified are undefined.
1484 i915_gem_pwrite_ioctl(struct drm_device *dev, void *data,
1485 struct drm_file *file)
1487 struct drm_i915_gem_pwrite *args = data;
1488 struct drm_i915_gem_object *obj;
1491 if (args->size == 0)
1494 if (!access_ok(VERIFY_READ,
1495 u64_to_user_ptr(args->data_ptr),
1499 obj = i915_gem_object_lookup(file, args->handle);
1503 /* Bounds check destination. */
1504 if (range_overflows_t(u64, args->offset, args->size, obj->base.size)) {
1509 trace_i915_gem_object_pwrite(obj, args->offset, args->size);
1512 if (obj->ops->pwrite)
1513 ret = obj->ops->pwrite(obj, args);
1517 ret = i915_gem_object_wait(obj,
1518 I915_WAIT_INTERRUPTIBLE |
1520 MAX_SCHEDULE_TIMEOUT,
1521 to_rps_client(file));
1525 ret = i915_gem_object_pin_pages(obj);
1530 /* We can only do the GTT pwrite on untiled buffers, as otherwise
1531 * it would end up going through the fenced access, and we'll get
1532 * different detiling behavior between reading and writing.
1533 * pread/pwrite currently are reading and writing from the CPU
1534 * perspective, requiring manual detiling by the client.
1536 if (!i915_gem_object_has_struct_page(obj) ||
1537 cpu_write_needs_clflush(obj))
1538 /* Note that the gtt paths might fail with non-page-backed user
1539 * pointers (e.g. gtt mappings when moving data between
1540 * textures). Fallback to the shmem path in that case.
1542 ret = i915_gem_gtt_pwrite_fast(obj, args);
1544 if (ret == -EFAULT || ret == -ENOSPC) {
1545 if (obj->phys_handle)
1546 ret = i915_gem_phys_pwrite(obj, args, file);
1548 ret = i915_gem_shmem_pwrite(obj, args);
1551 i915_gem_object_unpin_pages(obj);
1553 i915_gem_object_put(obj);
1557 static void i915_gem_object_bump_inactive_ggtt(struct drm_i915_gem_object *obj)
1559 struct drm_i915_private *i915;
1560 struct list_head *list;
1561 struct i915_vma *vma;
1563 list_for_each_entry(vma, &obj->vma_list, obj_link) {
1564 if (!i915_vma_is_ggtt(vma))
1567 if (i915_vma_is_active(vma))
1570 if (!drm_mm_node_allocated(&vma->node))
1573 list_move_tail(&vma->vm_link, &vma->vm->inactive_list);
1576 i915 = to_i915(obj->base.dev);
1577 list = obj->bind_count ? &i915->mm.bound_list : &i915->mm.unbound_list;
1578 list_move_tail(&obj->global_link, list);
1582 * Called when user space prepares to use an object with the CPU, either
1583 * through the mmap ioctl's mapping or a GTT mapping.
1585 * @data: ioctl data blob
1589 i915_gem_set_domain_ioctl(struct drm_device *dev, void *data,
1590 struct drm_file *file)
1592 struct drm_i915_gem_set_domain *args = data;
1593 struct drm_i915_gem_object *obj;
1594 uint32_t read_domains = args->read_domains;
1595 uint32_t write_domain = args->write_domain;
1598 /* Only handle setting domains to types used by the CPU. */
1599 if ((write_domain | read_domains) & I915_GEM_GPU_DOMAINS)
1602 /* Having something in the write domain implies it's in the read
1603 * domain, and only that read domain. Enforce that in the request.
1605 if (write_domain != 0 && read_domains != write_domain)
1608 obj = i915_gem_object_lookup(file, args->handle);
1612 /* Try to flush the object off the GPU without holding the lock.
1613 * We will repeat the flush holding the lock in the normal manner
1614 * to catch cases where we are gazumped.
1616 err = i915_gem_object_wait(obj,
1617 I915_WAIT_INTERRUPTIBLE |
1618 (write_domain ? I915_WAIT_ALL : 0),
1619 MAX_SCHEDULE_TIMEOUT,
1620 to_rps_client(file));
1624 /* Flush and acquire obj->pages so that we are coherent through
1625 * direct access in memory with previous cached writes through
1626 * shmemfs and that our cache domain tracking remains valid.
1627 * For example, if the obj->filp was moved to swap without us
1628 * being notified and releasing the pages, we would mistakenly
1629 * continue to assume that the obj remained out of the CPU cached
1632 err = i915_gem_object_pin_pages(obj);
1636 err = i915_mutex_lock_interruptible(dev);
1640 if (read_domains & I915_GEM_DOMAIN_WC)
1641 err = i915_gem_object_set_to_wc_domain(obj, write_domain);
1642 else if (read_domains & I915_GEM_DOMAIN_GTT)
1643 err = i915_gem_object_set_to_gtt_domain(obj, write_domain);
1645 err = i915_gem_object_set_to_cpu_domain(obj, write_domain);
1647 /* And bump the LRU for this access */
1648 i915_gem_object_bump_inactive_ggtt(obj);
1650 mutex_unlock(&dev->struct_mutex);
1652 if (write_domain != 0)
1653 intel_fb_obj_invalidate(obj,
1654 fb_write_origin(obj, write_domain));
1657 i915_gem_object_unpin_pages(obj);
1659 i915_gem_object_put(obj);
1664 * Called when user space has done writes to this buffer
1666 * @data: ioctl data blob
1670 i915_gem_sw_finish_ioctl(struct drm_device *dev, void *data,
1671 struct drm_file *file)
1673 struct drm_i915_gem_sw_finish *args = data;
1674 struct drm_i915_gem_object *obj;
1676 obj = i915_gem_object_lookup(file, args->handle);
1680 /* Pinned buffers may be scanout, so flush the cache */
1681 i915_gem_object_flush_if_display(obj);
1682 i915_gem_object_put(obj);
1688 * i915_gem_mmap_ioctl - Maps the contents of an object, returning the address
1691 * @data: ioctl data blob
1694 * While the mapping holds a reference on the contents of the object, it doesn't
1695 * imply a ref on the object itself.
1699 * DRM driver writers who look a this function as an example for how to do GEM
1700 * mmap support, please don't implement mmap support like here. The modern way
1701 * to implement DRM mmap support is with an mmap offset ioctl (like
1702 * i915_gem_mmap_gtt) and then using the mmap syscall on the DRM fd directly.
1703 * That way debug tooling like valgrind will understand what's going on, hiding
1704 * the mmap call in a driver private ioctl will break that. The i915 driver only
1705 * does cpu mmaps this way because we didn't know better.
1708 i915_gem_mmap_ioctl(struct drm_device *dev, void *data,
1709 struct drm_file *file)
1711 struct drm_i915_gem_mmap *args = data;
1712 struct drm_i915_gem_object *obj;
1715 if (args->flags & ~(I915_MMAP_WC))
1718 if (args->flags & I915_MMAP_WC && !boot_cpu_has(X86_FEATURE_PAT))
1721 obj = i915_gem_object_lookup(file, args->handle);
1725 /* prime objects have no backing filp to GEM mmap
1728 if (!obj->base.filp) {
1729 i915_gem_object_put(obj);
1733 addr = vm_mmap(obj->base.filp, 0, args->size,
1734 PROT_READ | PROT_WRITE, MAP_SHARED,
1736 if (args->flags & I915_MMAP_WC) {
1737 struct mm_struct *mm = current->mm;
1738 struct vm_area_struct *vma;
1740 if (down_write_killable(&mm->mmap_sem)) {
1741 i915_gem_object_put(obj);
1744 vma = find_vma(mm, addr);
1747 pgprot_writecombine(vm_get_page_prot(vma->vm_flags));
1750 up_write(&mm->mmap_sem);
1752 /* This may race, but that's ok, it only gets set */
1753 WRITE_ONCE(obj->frontbuffer_ggtt_origin, ORIGIN_CPU);
1755 i915_gem_object_put(obj);
1756 if (IS_ERR((void *)addr))
1759 args->addr_ptr = (uint64_t) addr;
1764 static unsigned int tile_row_pages(struct drm_i915_gem_object *obj)
1766 return i915_gem_object_get_tile_row_size(obj) >> PAGE_SHIFT;
1770 * i915_gem_mmap_gtt_version - report the current feature set for GTT mmaps
1772 * A history of the GTT mmap interface:
1774 * 0 - Everything had to fit into the GTT. Both parties of a memcpy had to
1775 * aligned and suitable for fencing, and still fit into the available
1776 * mappable space left by the pinned display objects. A classic problem
1777 * we called the page-fault-of-doom where we would ping-pong between
1778 * two objects that could not fit inside the GTT and so the memcpy
1779 * would page one object in at the expense of the other between every
1782 * 1 - Objects can be any size, and have any compatible fencing (X Y, or none
1783 * as set via i915_gem_set_tiling() [DRM_I915_GEM_SET_TILING]). If the
1784 * object is too large for the available space (or simply too large
1785 * for the mappable aperture!), a view is created instead and faulted
1786 * into userspace. (This view is aligned and sized appropriately for
1789 * 2 - Recognise WC as a separate cache domain so that we can flush the
1790 * delayed writes via GTT before performing direct access via WC.
1794 * * snoopable objects cannot be accessed via the GTT. It can cause machine
1795 * hangs on some architectures, corruption on others. An attempt to service
1796 * a GTT page fault from a snoopable object will generate a SIGBUS.
1798 * * the object must be able to fit into RAM (physical memory, though no
1799 * limited to the mappable aperture).
1804 * * a new GTT page fault will synchronize rendering from the GPU and flush
1805 * all data to system memory. Subsequent access will not be synchronized.
1807 * * all mappings are revoked on runtime device suspend.
1809 * * there are only 8, 16 or 32 fence registers to share between all users
1810 * (older machines require fence register for display and blitter access
1811 * as well). Contention of the fence registers will cause the previous users
1812 * to be unmapped and any new access will generate new page faults.
1814 * * running out of memory while servicing a fault may generate a SIGBUS,
1815 * rather than the expected SIGSEGV.
1817 int i915_gem_mmap_gtt_version(void)
1822 static inline struct i915_ggtt_view
1823 compute_partial_view(struct drm_i915_gem_object *obj,
1824 pgoff_t page_offset,
1827 struct i915_ggtt_view view;
1829 if (i915_gem_object_is_tiled(obj))
1830 chunk = roundup(chunk, tile_row_pages(obj));
1832 view.type = I915_GGTT_VIEW_PARTIAL;
1833 view.partial.offset = rounddown(page_offset, chunk);
1835 min_t(unsigned int, chunk,
1836 (obj->base.size >> PAGE_SHIFT) - view.partial.offset);
1838 /* If the partial covers the entire object, just create a normal VMA. */
1839 if (chunk >= obj->base.size >> PAGE_SHIFT)
1840 view.type = I915_GGTT_VIEW_NORMAL;
1846 * i915_gem_fault - fault a page into the GTT
1849 * The fault handler is set up by drm_gem_mmap() when a object is GTT mapped
1850 * from userspace. The fault handler takes care of binding the object to
1851 * the GTT (if needed), allocating and programming a fence register (again,
1852 * only if needed based on whether the old reg is still valid or the object
1853 * is tiled) and inserting a new PTE into the faulting process.
1855 * Note that the faulting process may involve evicting existing objects
1856 * from the GTT and/or fence registers to make room. So performance may
1857 * suffer if the GTT working set is large or there are few fence registers
1860 * The current feature set supported by i915_gem_fault() and thus GTT mmaps
1861 * is exposed via I915_PARAM_MMAP_GTT_VERSION (see i915_gem_mmap_gtt_version).
1863 int i915_gem_fault(struct vm_fault *vmf)
1865 #define MIN_CHUNK_PAGES ((1 << 20) >> PAGE_SHIFT) /* 1 MiB */
1866 struct vm_area_struct *area = vmf->vma;
1867 struct drm_i915_gem_object *obj = to_intel_bo(area->vm_private_data);
1868 struct drm_device *dev = obj->base.dev;
1869 struct drm_i915_private *dev_priv = to_i915(dev);
1870 struct i915_ggtt *ggtt = &dev_priv->ggtt;
1871 bool write = !!(vmf->flags & FAULT_FLAG_WRITE);
1872 struct i915_vma *vma;
1873 pgoff_t page_offset;
1877 /* We don't use vmf->pgoff since that has the fake offset */
1878 page_offset = (vmf->address - area->vm_start) >> PAGE_SHIFT;
1880 trace_i915_gem_object_fault(obj, page_offset, true, write);
1882 /* Try to flush the object off the GPU first without holding the lock.
1883 * Upon acquiring the lock, we will perform our sanity checks and then
1884 * repeat the flush holding the lock in the normal manner to catch cases
1885 * where we are gazumped.
1887 ret = i915_gem_object_wait(obj,
1888 I915_WAIT_INTERRUPTIBLE,
1889 MAX_SCHEDULE_TIMEOUT,
1894 ret = i915_gem_object_pin_pages(obj);
1898 intel_runtime_pm_get(dev_priv);
1900 ret = i915_mutex_lock_interruptible(dev);
1904 /* Access to snoopable pages through the GTT is incoherent. */
1905 if (obj->cache_level != I915_CACHE_NONE && !HAS_LLC(dev_priv)) {
1910 /* If the object is smaller than a couple of partial vma, it is
1911 * not worth only creating a single partial vma - we may as well
1912 * clear enough space for the full object.
1914 flags = PIN_MAPPABLE;
1915 if (obj->base.size > 2 * MIN_CHUNK_PAGES << PAGE_SHIFT)
1916 flags |= PIN_NONBLOCK | PIN_NONFAULT;
1918 /* Now pin it into the GTT as needed */
1919 vma = i915_gem_object_ggtt_pin(obj, NULL, 0, 0, flags);
1921 /* Use a partial view if it is bigger than available space */
1922 struct i915_ggtt_view view =
1923 compute_partial_view(obj, page_offset, MIN_CHUNK_PAGES);
1925 /* Userspace is now writing through an untracked VMA, abandon
1926 * all hope that the hardware is able to track future writes.
1928 obj->frontbuffer_ggtt_origin = ORIGIN_CPU;
1930 vma = i915_gem_object_ggtt_pin(obj, &view, 0, 0, PIN_MAPPABLE);
1937 ret = i915_gem_object_set_to_gtt_domain(obj, write);
1941 ret = i915_vma_get_fence(vma);
1945 /* Mark as being mmapped into userspace for later revocation */
1946 assert_rpm_wakelock_held(dev_priv);
1947 if (list_empty(&obj->userfault_link))
1948 list_add(&obj->userfault_link, &dev_priv->mm.userfault_list);
1950 /* Finally, remap it using the new GTT offset */
1951 ret = remap_io_mapping(area,
1952 area->vm_start + (vma->ggtt_view.partial.offset << PAGE_SHIFT),
1953 (ggtt->mappable_base + vma->node.start) >> PAGE_SHIFT,
1954 min_t(u64, vma->size, area->vm_end - area->vm_start),
1958 __i915_vma_unpin(vma);
1960 mutex_unlock(&dev->struct_mutex);
1962 intel_runtime_pm_put(dev_priv);
1963 i915_gem_object_unpin_pages(obj);
1968 * We eat errors when the gpu is terminally wedged to avoid
1969 * userspace unduly crashing (gl has no provisions for mmaps to
1970 * fail). But any other -EIO isn't ours (e.g. swap in failure)
1971 * and so needs to be reported.
1973 if (!i915_terminally_wedged(&dev_priv->gpu_error)) {
1974 ret = VM_FAULT_SIGBUS;
1979 * EAGAIN means the gpu is hung and we'll wait for the error
1980 * handler to reset everything when re-faulting in
1981 * i915_mutex_lock_interruptible.
1988 * EBUSY is ok: this just means that another thread
1989 * already did the job.
1991 ret = VM_FAULT_NOPAGE;
1998 ret = VM_FAULT_SIGBUS;
2001 WARN_ONCE(ret, "unhandled error in i915_gem_fault: %i\n", ret);
2002 ret = VM_FAULT_SIGBUS;
2009 * i915_gem_release_mmap - remove physical page mappings
2010 * @obj: obj in question
2012 * Preserve the reservation of the mmapping with the DRM core code, but
2013 * relinquish ownership of the pages back to the system.
2015 * It is vital that we remove the page mapping if we have mapped a tiled
2016 * object through the GTT and then lose the fence register due to
2017 * resource pressure. Similarly if the object has been moved out of the
2018 * aperture, than pages mapped into userspace must be revoked. Removing the
2019 * mapping will then trigger a page fault on the next user access, allowing
2020 * fixup by i915_gem_fault().
2023 i915_gem_release_mmap(struct drm_i915_gem_object *obj)
2025 struct drm_i915_private *i915 = to_i915(obj->base.dev);
2027 /* Serialisation between user GTT access and our code depends upon
2028 * revoking the CPU's PTE whilst the mutex is held. The next user
2029 * pagefault then has to wait until we release the mutex.
2031 * Note that RPM complicates somewhat by adding an additional
2032 * requirement that operations to the GGTT be made holding the RPM
2035 lockdep_assert_held(&i915->drm.struct_mutex);
2036 intel_runtime_pm_get(i915);
2038 if (list_empty(&obj->userfault_link))
2041 list_del_init(&obj->userfault_link);
2042 drm_vma_node_unmap(&obj->base.vma_node,
2043 obj->base.dev->anon_inode->i_mapping);
2045 /* Ensure that the CPU's PTE are revoked and there are not outstanding
2046 * memory transactions from userspace before we return. The TLB
2047 * flushing implied above by changing the PTE above *should* be
2048 * sufficient, an extra barrier here just provides us with a bit
2049 * of paranoid documentation about our requirement to serialise
2050 * memory writes before touching registers / GSM.
2055 intel_runtime_pm_put(i915);
2058 void i915_gem_runtime_suspend(struct drm_i915_private *dev_priv)
2060 struct drm_i915_gem_object *obj, *on;
2064 * Only called during RPM suspend. All users of the userfault_list
2065 * must be holding an RPM wakeref to ensure that this can not
2066 * run concurrently with themselves (and use the struct_mutex for
2067 * protection between themselves).
2070 list_for_each_entry_safe(obj, on,
2071 &dev_priv->mm.userfault_list, userfault_link) {
2072 list_del_init(&obj->userfault_link);
2073 drm_vma_node_unmap(&obj->base.vma_node,
2074 obj->base.dev->anon_inode->i_mapping);
2077 /* The fence will be lost when the device powers down. If any were
2078 * in use by hardware (i.e. they are pinned), we should not be powering
2079 * down! All other fences will be reacquired by the user upon waking.
2081 for (i = 0; i < dev_priv->num_fence_regs; i++) {
2082 struct drm_i915_fence_reg *reg = &dev_priv->fence_regs[i];
2084 /* Ideally we want to assert that the fence register is not
2085 * live at this point (i.e. that no piece of code will be
2086 * trying to write through fence + GTT, as that both violates
2087 * our tracking of activity and associated locking/barriers,
2088 * but also is illegal given that the hw is powered down).
2090 * Previously we used reg->pin_count as a "liveness" indicator.
2091 * That is not sufficient, and we need a more fine-grained
2092 * tool if we want to have a sanity check here.
2098 GEM_BUG_ON(!list_empty(®->vma->obj->userfault_link));
2103 static int i915_gem_object_create_mmap_offset(struct drm_i915_gem_object *obj)
2105 struct drm_i915_private *dev_priv = to_i915(obj->base.dev);
2108 err = drm_gem_create_mmap_offset(&obj->base);
2112 /* Attempt to reap some mmap space from dead objects */
2114 err = i915_gem_wait_for_idle(dev_priv, I915_WAIT_INTERRUPTIBLE);
2118 i915_gem_drain_freed_objects(dev_priv);
2119 err = drm_gem_create_mmap_offset(&obj->base);
2123 } while (flush_delayed_work(&dev_priv->gt.retire_work));
2128 static void i915_gem_object_free_mmap_offset(struct drm_i915_gem_object *obj)
2130 drm_gem_free_mmap_offset(&obj->base);
2134 i915_gem_mmap_gtt(struct drm_file *file,
2135 struct drm_device *dev,
2139 struct drm_i915_gem_object *obj;
2142 obj = i915_gem_object_lookup(file, handle);
2146 ret = i915_gem_object_create_mmap_offset(obj);
2148 *offset = drm_vma_node_offset_addr(&obj->base.vma_node);
2150 i915_gem_object_put(obj);
2155 * i915_gem_mmap_gtt_ioctl - prepare an object for GTT mmap'ing
2157 * @data: GTT mapping ioctl data
2158 * @file: GEM object info
2160 * Simply returns the fake offset to userspace so it can mmap it.
2161 * The mmap call will end up in drm_gem_mmap(), which will set things
2162 * up so we can get faults in the handler above.
2164 * The fault handler will take care of binding the object into the GTT
2165 * (since it may have been evicted to make room for something), allocating
2166 * a fence register, and mapping the appropriate aperture address into
2170 i915_gem_mmap_gtt_ioctl(struct drm_device *dev, void *data,
2171 struct drm_file *file)
2173 struct drm_i915_gem_mmap_gtt *args = data;
2175 return i915_gem_mmap_gtt(file, dev, args->handle, &args->offset);
2178 /* Immediately discard the backing storage */
2180 i915_gem_object_truncate(struct drm_i915_gem_object *obj)
2182 i915_gem_object_free_mmap_offset(obj);
2184 if (obj->base.filp == NULL)
2187 /* Our goal here is to return as much of the memory as
2188 * is possible back to the system as we are called from OOM.
2189 * To do this we must instruct the shmfs to drop all of its
2190 * backing pages, *now*.
2192 shmem_truncate_range(file_inode(obj->base.filp), 0, (loff_t)-1);
2193 obj->mm.madv = __I915_MADV_PURGED;
2194 obj->mm.pages = ERR_PTR(-EFAULT);
2197 /* Try to discard unwanted pages */
2198 void __i915_gem_object_invalidate(struct drm_i915_gem_object *obj)
2200 struct address_space *mapping;
2202 lockdep_assert_held(&obj->mm.lock);
2203 GEM_BUG_ON(obj->mm.pages);
2205 switch (obj->mm.madv) {
2206 case I915_MADV_DONTNEED:
2207 i915_gem_object_truncate(obj);
2208 case __I915_MADV_PURGED:
2212 if (obj->base.filp == NULL)
2215 mapping = obj->base.filp->f_mapping,
2216 invalidate_mapping_pages(mapping, 0, (loff_t)-1);
2220 i915_gem_object_put_pages_gtt(struct drm_i915_gem_object *obj,
2221 struct sg_table *pages)
2223 struct sgt_iter sgt_iter;
2226 __i915_gem_object_release_shmem(obj, pages, true);
2228 i915_gem_gtt_finish_pages(obj, pages);
2230 if (i915_gem_object_needs_bit17_swizzle(obj))
2231 i915_gem_object_save_bit_17_swizzle(obj, pages);
2233 for_each_sgt_page(page, sgt_iter, pages) {
2235 set_page_dirty(page);
2237 if (obj->mm.madv == I915_MADV_WILLNEED)
2238 mark_page_accessed(page);
2242 obj->mm.dirty = false;
2244 sg_free_table(pages);
2248 static void __i915_gem_object_reset_page_iter(struct drm_i915_gem_object *obj)
2250 struct radix_tree_iter iter;
2253 radix_tree_for_each_slot(slot, &obj->mm.get_page.radix, &iter, 0)
2254 radix_tree_delete(&obj->mm.get_page.radix, iter.index);
2257 void __i915_gem_object_put_pages(struct drm_i915_gem_object *obj,
2258 enum i915_mm_subclass subclass)
2260 struct sg_table *pages;
2262 if (i915_gem_object_has_pinned_pages(obj))
2265 GEM_BUG_ON(obj->bind_count);
2266 if (!READ_ONCE(obj->mm.pages))
2269 /* May be called by shrinker from within get_pages() (on another bo) */
2270 mutex_lock_nested(&obj->mm.lock, subclass);
2271 if (unlikely(atomic_read(&obj->mm.pages_pin_count)))
2274 /* ->put_pages might need to allocate memory for the bit17 swizzle
2275 * array, hence protect them from being reaped by removing them from gtt
2277 pages = fetch_and_zero(&obj->mm.pages);
2280 if (obj->mm.mapping) {
2283 ptr = ptr_mask_bits(obj->mm.mapping);
2284 if (is_vmalloc_addr(ptr))
2287 kunmap(kmap_to_page(ptr));
2289 obj->mm.mapping = NULL;
2292 __i915_gem_object_reset_page_iter(obj);
2295 obj->ops->put_pages(obj, pages);
2298 mutex_unlock(&obj->mm.lock);
2301 static bool i915_sg_trim(struct sg_table *orig_st)
2303 struct sg_table new_st;
2304 struct scatterlist *sg, *new_sg;
2307 if (orig_st->nents == orig_st->orig_nents)
2310 if (sg_alloc_table(&new_st, orig_st->nents, GFP_KERNEL | __GFP_NOWARN))
2313 new_sg = new_st.sgl;
2314 for_each_sg(orig_st->sgl, sg, orig_st->nents, i) {
2315 sg_set_page(new_sg, sg_page(sg), sg->length, 0);
2316 /* called before being DMA mapped, no need to copy sg->dma_* */
2317 new_sg = sg_next(new_sg);
2319 GEM_BUG_ON(new_sg); /* Should walk exactly nents and hit the end */
2321 sg_free_table(orig_st);
2327 static struct sg_table *
2328 i915_gem_object_get_pages_gtt(struct drm_i915_gem_object *obj)
2330 struct drm_i915_private *dev_priv = to_i915(obj->base.dev);
2331 const unsigned long page_count = obj->base.size / PAGE_SIZE;
2333 struct address_space *mapping;
2334 struct sg_table *st;
2335 struct scatterlist *sg;
2336 struct sgt_iter sgt_iter;
2338 unsigned long last_pfn = 0; /* suppress gcc warning */
2339 unsigned int max_segment;
2343 /* Assert that the object is not currently in any GPU domain. As it
2344 * wasn't in the GTT, there shouldn't be any way it could have been in
2347 GEM_BUG_ON(obj->base.read_domains & I915_GEM_GPU_DOMAINS);
2348 GEM_BUG_ON(obj->base.write_domain & I915_GEM_GPU_DOMAINS);
2350 max_segment = swiotlb_max_segment();
2352 max_segment = rounddown(UINT_MAX, PAGE_SIZE);
2354 st = kmalloc(sizeof(*st), GFP_KERNEL);
2356 return ERR_PTR(-ENOMEM);
2359 if (sg_alloc_table(st, page_count, GFP_KERNEL)) {
2361 return ERR_PTR(-ENOMEM);
2364 /* Get the list of pages out of our struct file. They'll be pinned
2365 * at this point until we release them.
2367 * Fail silently without starting the shrinker
2369 mapping = obj->base.filp->f_mapping;
2370 gfp = mapping_gfp_constraint(mapping, ~(__GFP_IO | __GFP_RECLAIM));
2371 gfp |= __GFP_NORETRY | __GFP_NOWARN;
2374 for (i = 0; i < page_count; i++) {
2375 page = shmem_read_mapping_page_gfp(mapping, i, gfp);
2376 if (unlikely(IS_ERR(page))) {
2377 i915_gem_shrink(dev_priv,
2380 I915_SHRINK_UNBOUND |
2381 I915_SHRINK_PURGEABLE);
2382 page = shmem_read_mapping_page_gfp(mapping, i, gfp);
2384 if (unlikely(IS_ERR(page))) {
2387 /* We've tried hard to allocate the memory by reaping
2388 * our own buffer, now let the real VM do its job and
2389 * go down in flames if truly OOM.
2391 * However, since graphics tend to be disposable,
2392 * defer the oom here by reporting the ENOMEM back
2395 reclaim = mapping_gfp_mask(mapping);
2396 reclaim |= __GFP_NORETRY; /* reclaim, but no oom */
2398 page = shmem_read_mapping_page_gfp(mapping, i, reclaim);
2400 ret = PTR_ERR(page);
2405 sg->length >= max_segment ||
2406 page_to_pfn(page) != last_pfn + 1) {
2410 sg_set_page(sg, page, PAGE_SIZE, 0);
2412 sg->length += PAGE_SIZE;
2414 last_pfn = page_to_pfn(page);
2416 /* Check that the i965g/gm workaround works. */
2417 WARN_ON((gfp & __GFP_DMA32) && (last_pfn >= 0x00100000UL));
2419 if (sg) /* loop terminated early; short sg table */
2422 /* Trim unused sg entries to avoid wasting memory. */
2425 ret = i915_gem_gtt_prepare_pages(obj, st);
2427 /* DMA remapping failed? One possible cause is that
2428 * it could not reserve enough large entries, asking
2429 * for PAGE_SIZE chunks instead may be helpful.
2431 if (max_segment > PAGE_SIZE) {
2432 for_each_sgt_page(page, sgt_iter, st)
2436 max_segment = PAGE_SIZE;
2439 dev_warn(&dev_priv->drm.pdev->dev,
2440 "Failed to DMA remap %lu pages\n",
2446 if (i915_gem_object_needs_bit17_swizzle(obj))
2447 i915_gem_object_do_bit_17_swizzle(obj, st);
2454 for_each_sgt_page(page, sgt_iter, st)
2459 /* shmemfs first checks if there is enough memory to allocate the page
2460 * and reports ENOSPC should there be insufficient, along with the usual
2461 * ENOMEM for a genuine allocation failure.
2463 * We use ENOSPC in our driver to mean that we have run out of aperture
2464 * space and so want to translate the error from shmemfs back to our
2465 * usual understanding of ENOMEM.
2470 return ERR_PTR(ret);
2473 void __i915_gem_object_set_pages(struct drm_i915_gem_object *obj,
2474 struct sg_table *pages)
2476 lockdep_assert_held(&obj->mm.lock);
2478 obj->mm.get_page.sg_pos = pages->sgl;
2479 obj->mm.get_page.sg_idx = 0;
2481 obj->mm.pages = pages;
2483 if (i915_gem_object_is_tiled(obj) &&
2484 to_i915(obj->base.dev)->quirks & QUIRK_PIN_SWIZZLED_PAGES) {
2485 GEM_BUG_ON(obj->mm.quirked);
2486 __i915_gem_object_pin_pages(obj);
2487 obj->mm.quirked = true;
2491 static int ____i915_gem_object_get_pages(struct drm_i915_gem_object *obj)
2493 struct sg_table *pages;
2495 GEM_BUG_ON(i915_gem_object_has_pinned_pages(obj));
2497 if (unlikely(obj->mm.madv != I915_MADV_WILLNEED)) {
2498 DRM_DEBUG("Attempting to obtain a purgeable object\n");
2502 pages = obj->ops->get_pages(obj);
2503 if (unlikely(IS_ERR(pages)))
2504 return PTR_ERR(pages);
2506 __i915_gem_object_set_pages(obj, pages);
2510 /* Ensure that the associated pages are gathered from the backing storage
2511 * and pinned into our object. i915_gem_object_pin_pages() may be called
2512 * multiple times before they are released by a single call to
2513 * i915_gem_object_unpin_pages() - once the pages are no longer referenced
2514 * either as a result of memory pressure (reaping pages under the shrinker)
2515 * or as the object is itself released.
2517 int __i915_gem_object_get_pages(struct drm_i915_gem_object *obj)
2521 err = mutex_lock_interruptible(&obj->mm.lock);
2525 if (unlikely(IS_ERR_OR_NULL(obj->mm.pages))) {
2526 err = ____i915_gem_object_get_pages(obj);
2530 smp_mb__before_atomic();
2532 atomic_inc(&obj->mm.pages_pin_count);
2535 mutex_unlock(&obj->mm.lock);
2539 /* The 'mapping' part of i915_gem_object_pin_map() below */
2540 static void *i915_gem_object_map(const struct drm_i915_gem_object *obj,
2541 enum i915_map_type type)
2543 unsigned long n_pages = obj->base.size >> PAGE_SHIFT;
2544 struct sg_table *sgt = obj->mm.pages;
2545 struct sgt_iter sgt_iter;
2547 struct page *stack_pages[32];
2548 struct page **pages = stack_pages;
2549 unsigned long i = 0;
2553 /* A single page can always be kmapped */
2554 if (n_pages == 1 && type == I915_MAP_WB)
2555 return kmap(sg_page(sgt->sgl));
2557 if (n_pages > ARRAY_SIZE(stack_pages)) {
2558 /* Too big for stack -- allocate temporary array instead */
2559 pages = drm_malloc_gfp(n_pages, sizeof(*pages), GFP_TEMPORARY);
2564 for_each_sgt_page(page, sgt_iter, sgt)
2567 /* Check that we have the expected number of pages */
2568 GEM_BUG_ON(i != n_pages);
2572 pgprot = PAGE_KERNEL;
2575 pgprot = pgprot_writecombine(PAGE_KERNEL_IO);
2578 addr = vmap(pages, n_pages, 0, pgprot);
2580 if (pages != stack_pages)
2581 drm_free_large(pages);
2586 /* get, pin, and map the pages of the object into kernel space */
2587 void *i915_gem_object_pin_map(struct drm_i915_gem_object *obj,
2588 enum i915_map_type type)
2590 enum i915_map_type has_type;
2595 GEM_BUG_ON(!i915_gem_object_has_struct_page(obj));
2597 ret = mutex_lock_interruptible(&obj->mm.lock);
2599 return ERR_PTR(ret);
2602 if (!atomic_inc_not_zero(&obj->mm.pages_pin_count)) {
2603 if (unlikely(IS_ERR_OR_NULL(obj->mm.pages))) {
2604 ret = ____i915_gem_object_get_pages(obj);
2608 smp_mb__before_atomic();
2610 atomic_inc(&obj->mm.pages_pin_count);
2613 GEM_BUG_ON(!obj->mm.pages);
2615 ptr = ptr_unpack_bits(obj->mm.mapping, has_type);
2616 if (ptr && has_type != type) {
2622 if (is_vmalloc_addr(ptr))
2625 kunmap(kmap_to_page(ptr));
2627 ptr = obj->mm.mapping = NULL;
2631 ptr = i915_gem_object_map(obj, type);
2637 obj->mm.mapping = ptr_pack_bits(ptr, type);
2641 mutex_unlock(&obj->mm.lock);
2645 atomic_dec(&obj->mm.pages_pin_count);
2652 i915_gem_object_pwrite_gtt(struct drm_i915_gem_object *obj,
2653 const struct drm_i915_gem_pwrite *arg)
2655 struct address_space *mapping = obj->base.filp->f_mapping;
2656 char __user *user_data = u64_to_user_ptr(arg->data_ptr);
2660 /* Before we instantiate/pin the backing store for our use, we
2661 * can prepopulate the shmemfs filp efficiently using a write into
2662 * the pagecache. We avoid the penalty of instantiating all the
2663 * pages, important if the user is just writing to a few and never
2664 * uses the object on the GPU, and using a direct write into shmemfs
2665 * allows it to avoid the cost of retrieving a page (either swapin
2666 * or clearing-before-use) before it is overwritten.
2668 if (READ_ONCE(obj->mm.pages))
2671 /* Before the pages are instantiated the object is treated as being
2672 * in the CPU domain. The pages will be clflushed as required before
2673 * use, and we can freely write into the pages directly. If userspace
2674 * races pwrite with any other operation; corruption will ensue -
2675 * that is userspace's prerogative!
2679 offset = arg->offset;
2680 pg = offset_in_page(offset);
2683 unsigned int len, unwritten;
2688 len = PAGE_SIZE - pg;
2692 err = pagecache_write_begin(obj->base.filp, mapping,
2699 unwritten = copy_from_user(vaddr + pg, user_data, len);
2702 err = pagecache_write_end(obj->base.filp, mapping,
2703 offset, len, len - unwritten,
2720 static bool ban_context(const struct i915_gem_context *ctx)
2722 return (i915_gem_context_is_bannable(ctx) &&
2723 ctx->ban_score >= CONTEXT_SCORE_BAN_THRESHOLD);
2726 static void i915_gem_context_mark_guilty(struct i915_gem_context *ctx)
2728 ctx->guilty_count++;
2729 ctx->ban_score += CONTEXT_SCORE_GUILTY;
2730 if (ban_context(ctx))
2731 i915_gem_context_set_banned(ctx);
2733 DRM_DEBUG_DRIVER("context %s marked guilty (score %d) banned? %s\n",
2734 ctx->name, ctx->ban_score,
2735 yesno(i915_gem_context_is_banned(ctx)));
2737 if (!i915_gem_context_is_banned(ctx) || IS_ERR_OR_NULL(ctx->file_priv))
2740 ctx->file_priv->context_bans++;
2741 DRM_DEBUG_DRIVER("client %s has had %d context banned\n",
2742 ctx->name, ctx->file_priv->context_bans);
2745 static void i915_gem_context_mark_innocent(struct i915_gem_context *ctx)
2747 ctx->active_count++;
2750 struct drm_i915_gem_request *
2751 i915_gem_find_active_request(struct intel_engine_cs *engine)
2753 struct drm_i915_gem_request *request, *active = NULL;
2754 unsigned long flags;
2756 /* We are called by the error capture and reset at a random
2757 * point in time. In particular, note that neither is crucially
2758 * ordered with an interrupt. After a hang, the GPU is dead and we
2759 * assume that no more writes can happen (we waited long enough for
2760 * all writes that were in transaction to be flushed) - adding an
2761 * extra delay for a recent interrupt is pointless. Hence, we do
2762 * not need an engine->irq_seqno_barrier() before the seqno reads.
2764 spin_lock_irqsave(&engine->timeline->lock, flags);
2765 list_for_each_entry(request, &engine->timeline->requests, link) {
2766 if (__i915_gem_request_completed(request,
2767 request->global_seqno))
2770 GEM_BUG_ON(request->engine != engine);
2771 GEM_BUG_ON(test_bit(DMA_FENCE_FLAG_SIGNALED_BIT,
2772 &request->fence.flags));
2777 spin_unlock_irqrestore(&engine->timeline->lock, flags);
2782 static bool engine_stalled(struct intel_engine_cs *engine)
2784 if (!engine->hangcheck.stalled)
2787 /* Check for possible seqno movement after hang declaration */
2788 if (engine->hangcheck.seqno != intel_engine_get_seqno(engine)) {
2789 DRM_DEBUG_DRIVER("%s pardoned\n", engine->name);
2796 int i915_gem_reset_prepare(struct drm_i915_private *dev_priv)
2798 struct intel_engine_cs *engine;
2799 enum intel_engine_id id;
2802 /* Ensure irq handler finishes, and not run again. */
2803 for_each_engine(engine, dev_priv, id) {
2804 struct drm_i915_gem_request *request;
2806 /* Prevent the signaler thread from updating the request
2807 * state (by calling dma_fence_signal) as we are processing
2808 * the reset. The write from the GPU of the seqno is
2809 * asynchronous and the signaler thread may see a different
2810 * value to us and declare the request complete, even though
2811 * the reset routine have picked that request as the active
2812 * (incomplete) request. This conflict is not handled
2815 kthread_park(engine->breadcrumbs.signaler);
2817 /* Prevent request submission to the hardware until we have
2818 * completed the reset in i915_gem_reset_finish(). If a request
2819 * is completed by one engine, it may then queue a request
2820 * to a second via its engine->irq_tasklet *just* as we are
2821 * calling engine->init_hw() and also writing the ELSP.
2822 * Turning off the engine->irq_tasklet until the reset is over
2823 * prevents the race.
2825 tasklet_kill(&engine->irq_tasklet);
2826 tasklet_disable(&engine->irq_tasklet);
2828 if (engine->irq_seqno_barrier)
2829 engine->irq_seqno_barrier(engine);
2831 if (engine_stalled(engine)) {
2832 request = i915_gem_find_active_request(engine);
2833 if (request && request->fence.error == -EIO)
2834 err = -EIO; /* Previous reset failed! */
2838 i915_gem_revoke_fences(dev_priv);
2843 static void skip_request(struct drm_i915_gem_request *request)
2845 void *vaddr = request->ring->vaddr;
2848 /* As this request likely depends on state from the lost
2849 * context, clear out all the user operations leaving the
2850 * breadcrumb at the end (so we get the fence notifications).
2852 head = request->head;
2853 if (request->postfix < head) {
2854 memset(vaddr + head, 0, request->ring->size - head);
2857 memset(vaddr + head, 0, request->postfix - head);
2859 dma_fence_set_error(&request->fence, -EIO);
2862 static void engine_skip_context(struct drm_i915_gem_request *request)
2864 struct intel_engine_cs *engine = request->engine;
2865 struct i915_gem_context *hung_ctx = request->ctx;
2866 struct intel_timeline *timeline;
2867 unsigned long flags;
2869 timeline = i915_gem_context_lookup_timeline(hung_ctx, engine);
2871 spin_lock_irqsave(&engine->timeline->lock, flags);
2872 spin_lock(&timeline->lock);
2874 list_for_each_entry_continue(request, &engine->timeline->requests, link)
2875 if (request->ctx == hung_ctx)
2876 skip_request(request);
2878 list_for_each_entry(request, &timeline->requests, link)
2879 skip_request(request);
2881 spin_unlock(&timeline->lock);
2882 spin_unlock_irqrestore(&engine->timeline->lock, flags);
2885 /* Returns true if the request was guilty of hang */
2886 static bool i915_gem_reset_request(struct drm_i915_gem_request *request)
2888 /* Read once and return the resolution */
2889 const bool guilty = engine_stalled(request->engine);
2891 /* The guilty request will get skipped on a hung engine.
2893 * Users of client default contexts do not rely on logical
2894 * state preserved between batches so it is safe to execute
2895 * queued requests following the hang. Non default contexts
2896 * rely on preserved state, so skipping a batch loses the
2897 * evolution of the state and it needs to be considered corrupted.
2898 * Executing more queued batches on top of corrupted state is
2899 * risky. But we take the risk by trying to advance through
2900 * the queued requests in order to make the client behaviour
2901 * more predictable around resets, by not throwing away random
2902 * amount of batches it has prepared for execution. Sophisticated
2903 * clients can use gem_reset_stats_ioctl and dma fence status
2904 * (exported via sync_file info ioctl on explicit fences) to observe
2905 * when it loses the context state and should rebuild accordingly.
2907 * The context ban, and ultimately the client ban, mechanism are safety
2908 * valves if client submission ends up resulting in nothing more than
2913 i915_gem_context_mark_guilty(request->ctx);
2914 skip_request(request);
2916 i915_gem_context_mark_innocent(request->ctx);
2917 dma_fence_set_error(&request->fence, -EAGAIN);
2923 static void i915_gem_reset_engine(struct intel_engine_cs *engine)
2925 struct drm_i915_gem_request *request;
2927 request = i915_gem_find_active_request(engine);
2928 if (request && i915_gem_reset_request(request)) {
2929 DRM_DEBUG_DRIVER("resetting %s to restart from tail of request 0x%x\n",
2930 engine->name, request->global_seqno);
2932 /* If this context is now banned, skip all pending requests. */
2933 if (i915_gem_context_is_banned(request->ctx))
2934 engine_skip_context(request);
2937 /* Setup the CS to resume from the breadcrumb of the hung request */
2938 engine->reset_hw(engine, request);
2941 void i915_gem_reset(struct drm_i915_private *dev_priv)
2943 struct intel_engine_cs *engine;
2944 enum intel_engine_id id;
2946 lockdep_assert_held(&dev_priv->drm.struct_mutex);
2948 i915_gem_retire_requests(dev_priv);
2950 for_each_engine(engine, dev_priv, id) {
2951 struct i915_gem_context *ctx;
2953 i915_gem_reset_engine(engine);
2954 ctx = fetch_and_zero(&engine->last_retired_context);
2956 engine->context_unpin(engine, ctx);
2959 i915_gem_restore_fences(dev_priv);
2961 if (dev_priv->gt.awake) {
2962 intel_sanitize_gt_powersave(dev_priv);
2963 intel_enable_gt_powersave(dev_priv);
2964 if (INTEL_GEN(dev_priv) >= 6)
2965 gen6_rps_busy(dev_priv);
2969 void i915_gem_reset_finish(struct drm_i915_private *dev_priv)
2971 struct intel_engine_cs *engine;
2972 enum intel_engine_id id;
2974 lockdep_assert_held(&dev_priv->drm.struct_mutex);
2976 for_each_engine(engine, dev_priv, id) {
2977 tasklet_enable(&engine->irq_tasklet);
2978 kthread_unpark(engine->breadcrumbs.signaler);
2982 static void nop_submit_request(struct drm_i915_gem_request *request)
2984 dma_fence_set_error(&request->fence, -EIO);
2985 i915_gem_request_submit(request);
2986 intel_engine_init_global_seqno(request->engine, request->global_seqno);
2989 static void engine_set_wedged(struct intel_engine_cs *engine)
2991 struct drm_i915_gem_request *request;
2992 unsigned long flags;
2994 /* We need to be sure that no thread is running the old callback as
2995 * we install the nop handler (otherwise we would submit a request
2996 * to hardware that will never complete). In order to prevent this
2997 * race, we wait until the machine is idle before making the swap
2998 * (using stop_machine()).
3000 engine->submit_request = nop_submit_request;
3002 /* Mark all executing requests as skipped */
3003 spin_lock_irqsave(&engine->timeline->lock, flags);
3004 list_for_each_entry(request, &engine->timeline->requests, link)
3005 dma_fence_set_error(&request->fence, -EIO);
3006 spin_unlock_irqrestore(&engine->timeline->lock, flags);
3008 /* Mark all pending requests as complete so that any concurrent
3009 * (lockless) lookup doesn't try and wait upon the request as we
3012 intel_engine_init_global_seqno(engine,
3013 intel_engine_last_submit(engine));
3016 * Clear the execlists queue up before freeing the requests, as those
3017 * are the ones that keep the context and ringbuffer backing objects
3021 if (i915.enable_execlists) {
3022 unsigned long flags;
3024 spin_lock_irqsave(&engine->timeline->lock, flags);
3026 i915_gem_request_put(engine->execlist_port[0].request);
3027 i915_gem_request_put(engine->execlist_port[1].request);
3028 memset(engine->execlist_port, 0, sizeof(engine->execlist_port));
3029 engine->execlist_queue = RB_ROOT;
3030 engine->execlist_first = NULL;
3032 spin_unlock_irqrestore(&engine->timeline->lock, flags);
3036 static int __i915_gem_set_wedged_BKL(void *data)
3038 struct drm_i915_private *i915 = data;
3039 struct intel_engine_cs *engine;
3040 enum intel_engine_id id;
3042 for_each_engine(engine, i915, id)
3043 engine_set_wedged(engine);
3048 void i915_gem_set_wedged(struct drm_i915_private *dev_priv)
3050 lockdep_assert_held(&dev_priv->drm.struct_mutex);
3051 set_bit(I915_WEDGED, &dev_priv->gpu_error.flags);
3053 /* Retire completed requests first so the list of inflight/incomplete
3054 * requests is accurate and we don't try and mark successful requests
3055 * as in error during __i915_gem_set_wedged_BKL().
3057 i915_gem_retire_requests(dev_priv);
3059 stop_machine(__i915_gem_set_wedged_BKL, dev_priv, NULL);
3061 i915_gem_context_lost(dev_priv);
3063 mod_delayed_work(dev_priv->wq, &dev_priv->gt.idle_work, 0);
3066 bool i915_gem_unset_wedged(struct drm_i915_private *i915)
3068 struct i915_gem_timeline *tl;
3071 lockdep_assert_held(&i915->drm.struct_mutex);
3072 if (!test_bit(I915_WEDGED, &i915->gpu_error.flags))
3075 /* Before unwedging, make sure that all pending operations
3076 * are flushed and errored out - we may have requests waiting upon
3077 * third party fences. We marked all inflight requests as EIO, and
3078 * every execbuf since returned EIO, for consistency we want all
3079 * the currently pending requests to also be marked as EIO, which
3080 * is done inside our nop_submit_request - and so we must wait.
3082 * No more can be submitted until we reset the wedged bit.
3084 list_for_each_entry(tl, &i915->gt.timelines, link) {
3085 for (i = 0; i < ARRAY_SIZE(tl->engine); i++) {
3086 struct drm_i915_gem_request *rq;
3088 rq = i915_gem_active_peek(&tl->engine[i].last_request,
3089 &i915->drm.struct_mutex);
3093 /* We can't use our normal waiter as we want to
3094 * avoid recursively trying to handle the current
3095 * reset. The basic dma_fence_default_wait() installs
3096 * a callback for dma_fence_signal(), which is
3097 * triggered by our nop handler (indirectly, the
3098 * callback enables the signaler thread which is
3099 * woken by the nop_submit_request() advancing the seqno
3100 * and when the seqno passes the fence, the signaler
3101 * then signals the fence waking us up).
3103 if (dma_fence_default_wait(&rq->fence, true,
3104 MAX_SCHEDULE_TIMEOUT) < 0)
3109 /* Undo nop_submit_request. We prevent all new i915 requests from
3110 * being queued (by disallowing execbuf whilst wedged) so having
3111 * waited for all active requests above, we know the system is idle
3112 * and do not have to worry about a thread being inside
3113 * engine->submit_request() as we swap over. So unlike installing
3114 * the nop_submit_request on reset, we can do this from normal
3115 * context and do not require stop_machine().
3117 intel_engines_reset_default_submission(i915);
3119 smp_mb__before_atomic(); /* complete takeover before enabling execbuf */
3120 clear_bit(I915_WEDGED, &i915->gpu_error.flags);
3126 i915_gem_retire_work_handler(struct work_struct *work)
3128 struct drm_i915_private *dev_priv =
3129 container_of(work, typeof(*dev_priv), gt.retire_work.work);
3130 struct drm_device *dev = &dev_priv->drm;
3132 /* Come back later if the device is busy... */
3133 if (mutex_trylock(&dev->struct_mutex)) {
3134 i915_gem_retire_requests(dev_priv);
3135 mutex_unlock(&dev->struct_mutex);
3138 /* Keep the retire handler running until we are finally idle.
3139 * We do not need to do this test under locking as in the worst-case
3140 * we queue the retire worker once too often.
3142 if (READ_ONCE(dev_priv->gt.awake)) {
3143 i915_queue_hangcheck(dev_priv);
3144 queue_delayed_work(dev_priv->wq,
3145 &dev_priv->gt.retire_work,
3146 round_jiffies_up_relative(HZ));
3151 i915_gem_idle_work_handler(struct work_struct *work)
3153 struct drm_i915_private *dev_priv =
3154 container_of(work, typeof(*dev_priv), gt.idle_work.work);
3155 struct drm_device *dev = &dev_priv->drm;
3156 struct intel_engine_cs *engine;
3157 enum intel_engine_id id;
3158 bool rearm_hangcheck;
3160 if (!READ_ONCE(dev_priv->gt.awake))
3164 * Wait for last execlists context complete, but bail out in case a
3165 * new request is submitted.
3167 wait_for(intel_engines_are_idle(dev_priv), 10);
3168 if (READ_ONCE(dev_priv->gt.active_requests))
3172 cancel_delayed_work_sync(&dev_priv->gpu_error.hangcheck_work);
3174 if (!mutex_trylock(&dev->struct_mutex)) {
3175 /* Currently busy, come back later */
3176 mod_delayed_work(dev_priv->wq,
3177 &dev_priv->gt.idle_work,
3178 msecs_to_jiffies(50));
3183 * New request retired after this work handler started, extend active
3184 * period until next instance of the work.
3186 if (work_pending(work))
3189 if (dev_priv->gt.active_requests)
3192 if (wait_for(intel_engines_are_idle(dev_priv), 10))
3193 DRM_ERROR("Timeout waiting for engines to idle\n");
3195 for_each_engine(engine, dev_priv, id) {
3196 intel_engine_disarm_breadcrumbs(engine);
3197 i915_gem_batch_pool_fini(&engine->batch_pool);
3199 i915_gem_timelines_mark_idle(dev_priv);
3201 GEM_BUG_ON(!dev_priv->gt.awake);
3202 dev_priv->gt.awake = false;
3203 rearm_hangcheck = false;
3205 if (INTEL_GEN(dev_priv) >= 6)
3206 gen6_rps_idle(dev_priv);
3207 intel_runtime_pm_put(dev_priv);
3209 mutex_unlock(&dev->struct_mutex);
3212 if (rearm_hangcheck) {
3213 GEM_BUG_ON(!dev_priv->gt.awake);
3214 i915_queue_hangcheck(dev_priv);
3218 void i915_gem_close_object(struct drm_gem_object *gem, struct drm_file *file)
3220 struct drm_i915_gem_object *obj = to_intel_bo(gem);
3221 struct drm_i915_file_private *fpriv = file->driver_priv;
3222 struct i915_vma *vma, *vn;
3224 mutex_lock(&obj->base.dev->struct_mutex);
3225 list_for_each_entry_safe(vma, vn, &obj->vma_list, obj_link)
3226 if (vma->vm->file == fpriv)
3227 i915_vma_close(vma);
3229 if (i915_gem_object_is_active(obj) &&
3230 !i915_gem_object_has_active_reference(obj)) {
3231 i915_gem_object_set_active_reference(obj);
3232 i915_gem_object_get(obj);
3234 mutex_unlock(&obj->base.dev->struct_mutex);
3237 static unsigned long to_wait_timeout(s64 timeout_ns)
3240 return MAX_SCHEDULE_TIMEOUT;
3242 if (timeout_ns == 0)
3245 return nsecs_to_jiffies_timeout(timeout_ns);
3249 * i915_gem_wait_ioctl - implements DRM_IOCTL_I915_GEM_WAIT
3250 * @dev: drm device pointer
3251 * @data: ioctl data blob
3252 * @file: drm file pointer
3254 * Returns 0 if successful, else an error is returned with the remaining time in
3255 * the timeout parameter.
3256 * -ETIME: object is still busy after timeout
3257 * -ERESTARTSYS: signal interrupted the wait
3258 * -ENONENT: object doesn't exist
3259 * Also possible, but rare:
3260 * -EAGAIN: GPU wedged
3262 * -ENODEV: Internal IRQ fail
3263 * -E?: The add request failed
3265 * The wait ioctl with a timeout of 0 reimplements the busy ioctl. With any
3266 * non-zero timeout parameter the wait ioctl will wait for the given number of
3267 * nanoseconds on an object becoming unbusy. Since the wait itself does so
3268 * without holding struct_mutex the object may become re-busied before this
3269 * function completes. A similar but shorter * race condition exists in the busy
3273 i915_gem_wait_ioctl(struct drm_device *dev, void *data, struct drm_file *file)
3275 struct drm_i915_gem_wait *args = data;
3276 struct drm_i915_gem_object *obj;
3280 if (args->flags != 0)
3283 obj = i915_gem_object_lookup(file, args->bo_handle);
3287 start = ktime_get();
3289 ret = i915_gem_object_wait(obj,
3290 I915_WAIT_INTERRUPTIBLE | I915_WAIT_ALL,
3291 to_wait_timeout(args->timeout_ns),
3292 to_rps_client(file));
3294 if (args->timeout_ns > 0) {
3295 args->timeout_ns -= ktime_to_ns(ktime_sub(ktime_get(), start));
3296 if (args->timeout_ns < 0)
3297 args->timeout_ns = 0;
3300 * Apparently ktime isn't accurate enough and occasionally has a
3301 * bit of mismatch in the jiffies<->nsecs<->ktime loop. So patch
3302 * things up to make the test happy. We allow up to 1 jiffy.
3304 * This is a regression from the timespec->ktime conversion.
3306 if (ret == -ETIME && !nsecs_to_jiffies(args->timeout_ns))
3307 args->timeout_ns = 0;
3310 i915_gem_object_put(obj);
3314 static int wait_for_timeline(struct i915_gem_timeline *tl, unsigned int flags)
3318 for (i = 0; i < ARRAY_SIZE(tl->engine); i++) {
3319 ret = i915_gem_active_wait(&tl->engine[i].last_request, flags);
3327 static int wait_for_engine(struct intel_engine_cs *engine, int timeout_ms)
3329 return wait_for(intel_engine_is_idle(engine), timeout_ms);
3332 static int wait_for_engines(struct drm_i915_private *i915)
3334 struct intel_engine_cs *engine;
3335 enum intel_engine_id id;
3337 for_each_engine(engine, i915, id) {
3338 if (GEM_WARN_ON(wait_for_engine(engine, 50))) {
3339 i915_gem_set_wedged(i915);
3343 GEM_BUG_ON(intel_engine_get_seqno(engine) !=
3344 intel_engine_last_submit(engine));
3350 int i915_gem_wait_for_idle(struct drm_i915_private *i915, unsigned int flags)
3354 if (flags & I915_WAIT_LOCKED) {
3355 struct i915_gem_timeline *tl;
3357 lockdep_assert_held(&i915->drm.struct_mutex);
3359 list_for_each_entry(tl, &i915->gt.timelines, link) {
3360 ret = wait_for_timeline(tl, flags);
3365 i915_gem_retire_requests(i915);
3366 GEM_BUG_ON(i915->gt.active_requests);
3368 ret = wait_for_engines(i915);
3370 ret = wait_for_timeline(&i915->gt.global_timeline, flags);
3376 static void __i915_gem_object_flush_for_display(struct drm_i915_gem_object *obj)
3378 if (obj->base.write_domain != I915_GEM_DOMAIN_CPU && !obj->cache_dirty)
3381 i915_gem_clflush_object(obj, I915_CLFLUSH_FORCE);
3382 obj->base.write_domain = 0;
3385 void i915_gem_object_flush_if_display(struct drm_i915_gem_object *obj)
3387 if (!READ_ONCE(obj->pin_display))
3390 mutex_lock(&obj->base.dev->struct_mutex);
3391 __i915_gem_object_flush_for_display(obj);
3392 mutex_unlock(&obj->base.dev->struct_mutex);
3396 * Moves a single object to the WC read, and possibly write domain.
3397 * @obj: object to act on
3398 * @write: ask for write access or read only
3400 * This function returns when the move is complete, including waiting on
3404 i915_gem_object_set_to_wc_domain(struct drm_i915_gem_object *obj, bool write)
3408 lockdep_assert_held(&obj->base.dev->struct_mutex);
3410 ret = i915_gem_object_wait(obj,
3411 I915_WAIT_INTERRUPTIBLE |
3413 (write ? I915_WAIT_ALL : 0),
3414 MAX_SCHEDULE_TIMEOUT,
3419 if (obj->base.write_domain == I915_GEM_DOMAIN_WC)
3422 /* Flush and acquire obj->pages so that we are coherent through
3423 * direct access in memory with previous cached writes through
3424 * shmemfs and that our cache domain tracking remains valid.
3425 * For example, if the obj->filp was moved to swap without us
3426 * being notified and releasing the pages, we would mistakenly
3427 * continue to assume that the obj remained out of the CPU cached
3430 ret = i915_gem_object_pin_pages(obj);
3434 flush_write_domain(obj, ~I915_GEM_DOMAIN_WC);
3436 /* Serialise direct access to this object with the barriers for
3437 * coherent writes from the GPU, by effectively invalidating the
3438 * WC domain upon first access.
3440 if ((obj->base.read_domains & I915_GEM_DOMAIN_WC) == 0)
3443 /* It should now be out of any other write domains, and we can update
3444 * the domain values for our changes.
3446 GEM_BUG_ON((obj->base.write_domain & ~I915_GEM_DOMAIN_WC) != 0);
3447 obj->base.read_domains |= I915_GEM_DOMAIN_WC;
3449 obj->base.read_domains = I915_GEM_DOMAIN_WC;
3450 obj->base.write_domain = I915_GEM_DOMAIN_WC;
3451 obj->mm.dirty = true;
3454 i915_gem_object_unpin_pages(obj);
3459 * Moves a single object to the GTT read, and possibly write domain.
3460 * @obj: object to act on
3461 * @write: ask for write access or read only
3463 * This function returns when the move is complete, including waiting on
3467 i915_gem_object_set_to_gtt_domain(struct drm_i915_gem_object *obj, bool write)
3471 lockdep_assert_held(&obj->base.dev->struct_mutex);
3473 ret = i915_gem_object_wait(obj,
3474 I915_WAIT_INTERRUPTIBLE |
3476 (write ? I915_WAIT_ALL : 0),
3477 MAX_SCHEDULE_TIMEOUT,
3482 if (obj->base.write_domain == I915_GEM_DOMAIN_GTT)
3485 /* Flush and acquire obj->pages so that we are coherent through
3486 * direct access in memory with previous cached writes through
3487 * shmemfs and that our cache domain tracking remains valid.
3488 * For example, if the obj->filp was moved to swap without us
3489 * being notified and releasing the pages, we would mistakenly
3490 * continue to assume that the obj remained out of the CPU cached
3493 ret = i915_gem_object_pin_pages(obj);
3497 flush_write_domain(obj, ~I915_GEM_DOMAIN_GTT);
3499 /* Serialise direct access to this object with the barriers for
3500 * coherent writes from the GPU, by effectively invalidating the
3501 * GTT domain upon first access.
3503 if ((obj->base.read_domains & I915_GEM_DOMAIN_GTT) == 0)
3506 /* It should now be out of any other write domains, and we can update
3507 * the domain values for our changes.
3509 GEM_BUG_ON((obj->base.write_domain & ~I915_GEM_DOMAIN_GTT) != 0);
3510 obj->base.read_domains |= I915_GEM_DOMAIN_GTT;
3512 obj->base.read_domains = I915_GEM_DOMAIN_GTT;
3513 obj->base.write_domain = I915_GEM_DOMAIN_GTT;
3514 obj->mm.dirty = true;
3517 i915_gem_object_unpin_pages(obj);
3522 * Changes the cache-level of an object across all VMA.
3523 * @obj: object to act on
3524 * @cache_level: new cache level to set for the object
3526 * After this function returns, the object will be in the new cache-level
3527 * across all GTT and the contents of the backing storage will be coherent,
3528 * with respect to the new cache-level. In order to keep the backing storage
3529 * coherent for all users, we only allow a single cache level to be set
3530 * globally on the object and prevent it from being changed whilst the
3531 * hardware is reading from the object. That is if the object is currently
3532 * on the scanout it will be set to uncached (or equivalent display
3533 * cache coherency) and all non-MOCS GPU access will also be uncached so
3534 * that all direct access to the scanout remains coherent.
3536 int i915_gem_object_set_cache_level(struct drm_i915_gem_object *obj,
3537 enum i915_cache_level cache_level)
3539 struct i915_vma *vma;
3542 lockdep_assert_held(&obj->base.dev->struct_mutex);
3544 if (obj->cache_level == cache_level)
3547 /* Inspect the list of currently bound VMA and unbind any that would
3548 * be invalid given the new cache-level. This is principally to
3549 * catch the issue of the CS prefetch crossing page boundaries and
3550 * reading an invalid PTE on older architectures.
3553 list_for_each_entry(vma, &obj->vma_list, obj_link) {
3554 if (!drm_mm_node_allocated(&vma->node))
3557 if (i915_vma_is_pinned(vma)) {
3558 DRM_DEBUG("can not change the cache level of pinned objects\n");
3562 if (i915_gem_valid_gtt_space(vma, cache_level))
3565 ret = i915_vma_unbind(vma);
3569 /* As unbinding may affect other elements in the
3570 * obj->vma_list (due to side-effects from retiring
3571 * an active vma), play safe and restart the iterator.
3576 /* We can reuse the existing drm_mm nodes but need to change the
3577 * cache-level on the PTE. We could simply unbind them all and
3578 * rebind with the correct cache-level on next use. However since
3579 * we already have a valid slot, dma mapping, pages etc, we may as
3580 * rewrite the PTE in the belief that doing so tramples upon less
3581 * state and so involves less work.
3583 if (obj->bind_count) {
3584 /* Before we change the PTE, the GPU must not be accessing it.
3585 * If we wait upon the object, we know that all the bound
3586 * VMA are no longer active.
3588 ret = i915_gem_object_wait(obj,
3589 I915_WAIT_INTERRUPTIBLE |
3592 MAX_SCHEDULE_TIMEOUT,
3597 if (!HAS_LLC(to_i915(obj->base.dev)) &&
3598 cache_level != I915_CACHE_NONE) {
3599 /* Access to snoopable pages through the GTT is
3600 * incoherent and on some machines causes a hard
3601 * lockup. Relinquish the CPU mmaping to force
3602 * userspace to refault in the pages and we can
3603 * then double check if the GTT mapping is still
3604 * valid for that pointer access.
3606 i915_gem_release_mmap(obj);
3608 /* As we no longer need a fence for GTT access,
3609 * we can relinquish it now (and so prevent having
3610 * to steal a fence from someone else on the next
3611 * fence request). Note GPU activity would have
3612 * dropped the fence as all snoopable access is
3613 * supposed to be linear.
3615 list_for_each_entry(vma, &obj->vma_list, obj_link) {
3616 ret = i915_vma_put_fence(vma);
3621 /* We either have incoherent backing store and
3622 * so no GTT access or the architecture is fully
3623 * coherent. In such cases, existing GTT mmaps
3624 * ignore the cache bit in the PTE and we can
3625 * rewrite it without confusing the GPU or having
3626 * to force userspace to fault back in its mmaps.
3630 list_for_each_entry(vma, &obj->vma_list, obj_link) {
3631 if (!drm_mm_node_allocated(&vma->node))
3634 ret = i915_vma_bind(vma, cache_level, PIN_UPDATE);
3640 if (obj->base.write_domain == I915_GEM_DOMAIN_CPU &&
3641 i915_gem_object_is_coherent(obj))
3642 obj->cache_dirty = true;
3644 list_for_each_entry(vma, &obj->vma_list, obj_link)
3645 vma->node.color = cache_level;
3646 obj->cache_level = cache_level;
3651 int i915_gem_get_caching_ioctl(struct drm_device *dev, void *data,
3652 struct drm_file *file)
3654 struct drm_i915_gem_caching *args = data;
3655 struct drm_i915_gem_object *obj;
3659 obj = i915_gem_object_lookup_rcu(file, args->handle);
3665 switch (obj->cache_level) {
3666 case I915_CACHE_LLC:
3667 case I915_CACHE_L3_LLC:
3668 args->caching = I915_CACHING_CACHED;
3672 args->caching = I915_CACHING_DISPLAY;
3676 args->caching = I915_CACHING_NONE;
3684 int i915_gem_set_caching_ioctl(struct drm_device *dev, void *data,
3685 struct drm_file *file)
3687 struct drm_i915_private *i915 = to_i915(dev);
3688 struct drm_i915_gem_caching *args = data;
3689 struct drm_i915_gem_object *obj;
3690 enum i915_cache_level level;
3693 switch (args->caching) {
3694 case I915_CACHING_NONE:
3695 level = I915_CACHE_NONE;
3697 case I915_CACHING_CACHED:
3699 * Due to a HW issue on BXT A stepping, GPU stores via a
3700 * snooped mapping may leave stale data in a corresponding CPU
3701 * cacheline, whereas normally such cachelines would get
3704 if (!HAS_LLC(i915) && !HAS_SNOOP(i915))
3707 level = I915_CACHE_LLC;
3709 case I915_CACHING_DISPLAY:
3710 level = HAS_WT(i915) ? I915_CACHE_WT : I915_CACHE_NONE;
3716 obj = i915_gem_object_lookup(file, args->handle);
3720 if (obj->cache_level == level)
3723 ret = i915_gem_object_wait(obj,
3724 I915_WAIT_INTERRUPTIBLE,
3725 MAX_SCHEDULE_TIMEOUT,
3726 to_rps_client(file));
3730 ret = i915_mutex_lock_interruptible(dev);
3734 ret = i915_gem_object_set_cache_level(obj, level);
3735 mutex_unlock(&dev->struct_mutex);
3738 i915_gem_object_put(obj);
3743 * Prepare buffer for display plane (scanout, cursors, etc).
3744 * Can be called from an uninterruptible phase (modesetting) and allows
3745 * any flushes to be pipelined (for pageflips).
3748 i915_gem_object_pin_to_display_plane(struct drm_i915_gem_object *obj,
3750 const struct i915_ggtt_view *view)
3752 struct i915_vma *vma;
3755 lockdep_assert_held(&obj->base.dev->struct_mutex);
3757 /* Mark the pin_display early so that we account for the
3758 * display coherency whilst setting up the cache domains.
3762 /* The display engine is not coherent with the LLC cache on gen6. As
3763 * a result, we make sure that the pinning that is about to occur is
3764 * done with uncached PTEs. This is lowest common denominator for all
3767 * However for gen6+, we could do better by using the GFDT bit instead
3768 * of uncaching, which would allow us to flush all the LLC-cached data
3769 * with that bit in the PTE to main memory with just one PIPE_CONTROL.
3771 ret = i915_gem_object_set_cache_level(obj,
3772 HAS_WT(to_i915(obj->base.dev)) ?
3773 I915_CACHE_WT : I915_CACHE_NONE);
3776 goto err_unpin_display;
3779 /* As the user may map the buffer once pinned in the display plane
3780 * (e.g. libkms for the bootup splash), we have to ensure that we
3781 * always use map_and_fenceable for all scanout buffers. However,
3782 * it may simply be too big to fit into mappable, in which case
3783 * put it anyway and hope that userspace can cope (but always first
3784 * try to preserve the existing ABI).
3786 vma = ERR_PTR(-ENOSPC);
3787 if (!view || view->type == I915_GGTT_VIEW_NORMAL)
3788 vma = i915_gem_object_ggtt_pin(obj, view, 0, alignment,
3789 PIN_MAPPABLE | PIN_NONBLOCK);
3791 struct drm_i915_private *i915 = to_i915(obj->base.dev);
3794 /* Valleyview is definitely limited to scanning out the first
3795 * 512MiB. Lets presume this behaviour was inherited from the
3796 * g4x display engine and that all earlier gen are similarly
3797 * limited. Testing suggests that it is a little more
3798 * complicated than this. For example, Cherryview appears quite
3799 * happy to scanout from anywhere within its global aperture.
3802 if (HAS_GMCH_DISPLAY(i915))
3803 flags = PIN_MAPPABLE;
3804 vma = i915_gem_object_ggtt_pin(obj, view, 0, alignment, flags);
3807 goto err_unpin_display;
3809 vma->display_alignment = max_t(u64, vma->display_alignment, alignment);
3811 /* Treat this as an end-of-frame, like intel_user_framebuffer_dirty() */
3812 __i915_gem_object_flush_for_display(obj);
3813 intel_fb_obj_flush(obj, ORIGIN_DIRTYFB);
3815 /* It should now be out of any other write domains, and we can update
3816 * the domain values for our changes.
3818 obj->base.read_domains |= I915_GEM_DOMAIN_GTT;
3828 i915_gem_object_unpin_from_display_plane(struct i915_vma *vma)
3830 lockdep_assert_held(&vma->vm->i915->drm.struct_mutex);
3832 if (WARN_ON(vma->obj->pin_display == 0))
3835 if (--vma->obj->pin_display == 0)
3836 vma->display_alignment = I915_GTT_MIN_ALIGNMENT;
3838 /* Bump the LRU to try and avoid premature eviction whilst flipping */
3839 i915_gem_object_bump_inactive_ggtt(vma->obj);
3841 i915_vma_unpin(vma);
3845 * Moves a single object to the CPU read, and possibly write domain.
3846 * @obj: object to act on
3847 * @write: requesting write or read-only access
3849 * This function returns when the move is complete, including waiting on
3853 i915_gem_object_set_to_cpu_domain(struct drm_i915_gem_object *obj, bool write)
3857 lockdep_assert_held(&obj->base.dev->struct_mutex);
3859 ret = i915_gem_object_wait(obj,
3860 I915_WAIT_INTERRUPTIBLE |
3862 (write ? I915_WAIT_ALL : 0),
3863 MAX_SCHEDULE_TIMEOUT,
3868 if (obj->base.write_domain == I915_GEM_DOMAIN_CPU)
3871 flush_write_domain(obj, ~I915_GEM_DOMAIN_CPU);
3873 /* Flush the CPU cache if it's still invalid. */
3874 if ((obj->base.read_domains & I915_GEM_DOMAIN_CPU) == 0) {
3875 i915_gem_clflush_object(obj, I915_CLFLUSH_SYNC);
3876 obj->base.read_domains |= I915_GEM_DOMAIN_CPU;
3879 /* It should now be out of any other write domains, and we can update
3880 * the domain values for our changes.
3882 GEM_BUG_ON((obj->base.write_domain & ~I915_GEM_DOMAIN_CPU) != 0);
3884 /* If we're writing through the CPU, then the GPU read domains will
3885 * need to be invalidated at next use.
3888 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
3889 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
3895 /* Throttle our rendering by waiting until the ring has completed our requests
3896 * emitted over 20 msec ago.
3898 * Note that if we were to use the current jiffies each time around the loop,
3899 * we wouldn't escape the function with any frames outstanding if the time to
3900 * render a frame was over 20ms.
3902 * This should get us reasonable parallelism between CPU and GPU but also
3903 * relatively low latency when blocking on a particular request to finish.
3906 i915_gem_ring_throttle(struct drm_device *dev, struct drm_file *file)
3908 struct drm_i915_private *dev_priv = to_i915(dev);
3909 struct drm_i915_file_private *file_priv = file->driver_priv;
3910 unsigned long recent_enough = jiffies - DRM_I915_THROTTLE_JIFFIES;
3911 struct drm_i915_gem_request *request, *target = NULL;
3914 /* ABI: return -EIO if already wedged */
3915 if (i915_terminally_wedged(&dev_priv->gpu_error))
3918 spin_lock(&file_priv->mm.lock);
3919 list_for_each_entry(request, &file_priv->mm.request_list, client_link) {
3920 if (time_after_eq(request->emitted_jiffies, recent_enough))
3924 list_del(&target->client_link);
3925 target->file_priv = NULL;
3931 i915_gem_request_get(target);
3932 spin_unlock(&file_priv->mm.lock);
3937 ret = i915_wait_request(target,
3938 I915_WAIT_INTERRUPTIBLE,
3939 MAX_SCHEDULE_TIMEOUT);
3940 i915_gem_request_put(target);
3942 return ret < 0 ? ret : 0;
3946 i915_gem_object_ggtt_pin(struct drm_i915_gem_object *obj,
3947 const struct i915_ggtt_view *view,
3952 struct drm_i915_private *dev_priv = to_i915(obj->base.dev);
3953 struct i915_address_space *vm = &dev_priv->ggtt.base;
3954 struct i915_vma *vma;
3957 lockdep_assert_held(&obj->base.dev->struct_mutex);
3959 vma = i915_vma_instance(obj, vm, view);
3960 if (unlikely(IS_ERR(vma)))
3963 if (i915_vma_misplaced(vma, size, alignment, flags)) {
3964 if (flags & PIN_NONBLOCK &&
3965 (i915_vma_is_pinned(vma) || i915_vma_is_active(vma)))
3966 return ERR_PTR(-ENOSPC);
3968 if (flags & PIN_MAPPABLE) {
3969 /* If the required space is larger than the available
3970 * aperture, we will not able to find a slot for the
3971 * object and unbinding the object now will be in
3972 * vain. Worse, doing so may cause us to ping-pong
3973 * the object in and out of the Global GTT and
3974 * waste a lot of cycles under the mutex.
3976 if (vma->fence_size > dev_priv->ggtt.mappable_end)
3977 return ERR_PTR(-E2BIG);
3979 /* If NONBLOCK is set the caller is optimistically
3980 * trying to cache the full object within the mappable
3981 * aperture, and *must* have a fallback in place for
3982 * situations where we cannot bind the object. We
3983 * can be a little more lax here and use the fallback
3984 * more often to avoid costly migrations of ourselves
3985 * and other objects within the aperture.
3987 * Half-the-aperture is used as a simple heuristic.
3988 * More interesting would to do search for a free
3989 * block prior to making the commitment to unbind.
3990 * That caters for the self-harm case, and with a
3991 * little more heuristics (e.g. NOFAULT, NOEVICT)
3992 * we could try to minimise harm to others.
3994 if (flags & PIN_NONBLOCK &&
3995 vma->fence_size > dev_priv->ggtt.mappable_end / 2)
3996 return ERR_PTR(-ENOSPC);
3999 WARN(i915_vma_is_pinned(vma),
4000 "bo is already pinned in ggtt with incorrect alignment:"
4001 " offset=%08x, req.alignment=%llx,"
4002 " req.map_and_fenceable=%d, vma->map_and_fenceable=%d\n",
4003 i915_ggtt_offset(vma), alignment,
4004 !!(flags & PIN_MAPPABLE),
4005 i915_vma_is_map_and_fenceable(vma));
4006 ret = i915_vma_unbind(vma);
4008 return ERR_PTR(ret);
4011 ret = i915_vma_pin(vma, size, alignment, flags | PIN_GLOBAL);
4013 return ERR_PTR(ret);
4018 static __always_inline unsigned int __busy_read_flag(unsigned int id)
4020 /* Note that we could alias engines in the execbuf API, but
4021 * that would be very unwise as it prevents userspace from
4022 * fine control over engine selection. Ahem.
4024 * This should be something like EXEC_MAX_ENGINE instead of
4027 BUILD_BUG_ON(I915_NUM_ENGINES > 16);
4028 return 0x10000 << id;
4031 static __always_inline unsigned int __busy_write_id(unsigned int id)
4033 /* The uABI guarantees an active writer is also amongst the read
4034 * engines. This would be true if we accessed the activity tracking
4035 * under the lock, but as we perform the lookup of the object and
4036 * its activity locklessly we can not guarantee that the last_write
4037 * being active implies that we have set the same engine flag from
4038 * last_read - hence we always set both read and write busy for
4041 return id | __busy_read_flag(id);
4044 static __always_inline unsigned int
4045 __busy_set_if_active(const struct dma_fence *fence,
4046 unsigned int (*flag)(unsigned int id))
4048 struct drm_i915_gem_request *rq;
4050 /* We have to check the current hw status of the fence as the uABI
4051 * guarantees forward progress. We could rely on the idle worker
4052 * to eventually flush us, but to minimise latency just ask the
4055 * Note we only report on the status of native fences.
4057 if (!dma_fence_is_i915(fence))
4060 /* opencode to_request() in order to avoid const warnings */
4061 rq = container_of(fence, struct drm_i915_gem_request, fence);
4062 if (i915_gem_request_completed(rq))
4065 return flag(rq->engine->uabi_id);
4068 static __always_inline unsigned int
4069 busy_check_reader(const struct dma_fence *fence)
4071 return __busy_set_if_active(fence, __busy_read_flag);
4074 static __always_inline unsigned int
4075 busy_check_writer(const struct dma_fence *fence)
4080 return __busy_set_if_active(fence, __busy_write_id);
4084 i915_gem_busy_ioctl(struct drm_device *dev, void *data,
4085 struct drm_file *file)
4087 struct drm_i915_gem_busy *args = data;
4088 struct drm_i915_gem_object *obj;
4089 struct reservation_object_list *list;
4095 obj = i915_gem_object_lookup_rcu(file, args->handle);
4099 /* A discrepancy here is that we do not report the status of
4100 * non-i915 fences, i.e. even though we may report the object as idle,
4101 * a call to set-domain may still stall waiting for foreign rendering.
4102 * This also means that wait-ioctl may report an object as busy,
4103 * where busy-ioctl considers it idle.
4105 * We trade the ability to warn of foreign fences to report on which
4106 * i915 engines are active for the object.
4108 * Alternatively, we can trade that extra information on read/write
4111 * !reservation_object_test_signaled_rcu(obj->resv, true);
4112 * to report the overall busyness. This is what the wait-ioctl does.
4116 seq = raw_read_seqcount(&obj->resv->seq);
4118 /* Translate the exclusive fence to the READ *and* WRITE engine */
4119 args->busy = busy_check_writer(rcu_dereference(obj->resv->fence_excl));
4121 /* Translate shared fences to READ set of engines */
4122 list = rcu_dereference(obj->resv->fence);
4124 unsigned int shared_count = list->shared_count, i;
4126 for (i = 0; i < shared_count; ++i) {
4127 struct dma_fence *fence =
4128 rcu_dereference(list->shared[i]);
4130 args->busy |= busy_check_reader(fence);
4134 if (args->busy && read_seqcount_retry(&obj->resv->seq, seq))
4144 i915_gem_throttle_ioctl(struct drm_device *dev, void *data,
4145 struct drm_file *file_priv)
4147 return i915_gem_ring_throttle(dev, file_priv);
4151 i915_gem_madvise_ioctl(struct drm_device *dev, void *data,
4152 struct drm_file *file_priv)
4154 struct drm_i915_private *dev_priv = to_i915(dev);
4155 struct drm_i915_gem_madvise *args = data;
4156 struct drm_i915_gem_object *obj;
4159 switch (args->madv) {
4160 case I915_MADV_DONTNEED:
4161 case I915_MADV_WILLNEED:
4167 obj = i915_gem_object_lookup(file_priv, args->handle);
4171 err = mutex_lock_interruptible(&obj->mm.lock);
4175 if (obj->mm.pages &&
4176 i915_gem_object_is_tiled(obj) &&
4177 dev_priv->quirks & QUIRK_PIN_SWIZZLED_PAGES) {
4178 if (obj->mm.madv == I915_MADV_WILLNEED) {
4179 GEM_BUG_ON(!obj->mm.quirked);
4180 __i915_gem_object_unpin_pages(obj);
4181 obj->mm.quirked = false;
4183 if (args->madv == I915_MADV_WILLNEED) {
4184 GEM_BUG_ON(obj->mm.quirked);
4185 __i915_gem_object_pin_pages(obj);
4186 obj->mm.quirked = true;
4190 if (obj->mm.madv != __I915_MADV_PURGED)
4191 obj->mm.madv = args->madv;
4193 /* if the object is no longer attached, discard its backing storage */
4194 if (obj->mm.madv == I915_MADV_DONTNEED && !obj->mm.pages)
4195 i915_gem_object_truncate(obj);
4197 args->retained = obj->mm.madv != __I915_MADV_PURGED;
4198 mutex_unlock(&obj->mm.lock);
4201 i915_gem_object_put(obj);
4206 frontbuffer_retire(struct i915_gem_active *active,
4207 struct drm_i915_gem_request *request)
4209 struct drm_i915_gem_object *obj =
4210 container_of(active, typeof(*obj), frontbuffer_write);
4212 intel_fb_obj_flush(obj, ORIGIN_CS);
4215 void i915_gem_object_init(struct drm_i915_gem_object *obj,
4216 const struct drm_i915_gem_object_ops *ops)
4218 mutex_init(&obj->mm.lock);
4220 INIT_LIST_HEAD(&obj->global_link);
4221 INIT_LIST_HEAD(&obj->userfault_link);
4222 INIT_LIST_HEAD(&obj->obj_exec_link);
4223 INIT_LIST_HEAD(&obj->vma_list);
4224 INIT_LIST_HEAD(&obj->batch_pool_link);
4228 reservation_object_init(&obj->__builtin_resv);
4229 obj->resv = &obj->__builtin_resv;
4231 obj->frontbuffer_ggtt_origin = ORIGIN_GTT;
4232 init_request_active(&obj->frontbuffer_write, frontbuffer_retire);
4234 obj->mm.madv = I915_MADV_WILLNEED;
4235 INIT_RADIX_TREE(&obj->mm.get_page.radix, GFP_KERNEL | __GFP_NOWARN);
4236 mutex_init(&obj->mm.get_page.lock);
4238 i915_gem_info_add_obj(to_i915(obj->base.dev), obj->base.size);
4241 static const struct drm_i915_gem_object_ops i915_gem_object_ops = {
4242 .flags = I915_GEM_OBJECT_HAS_STRUCT_PAGE |
4243 I915_GEM_OBJECT_IS_SHRINKABLE,
4245 .get_pages = i915_gem_object_get_pages_gtt,
4246 .put_pages = i915_gem_object_put_pages_gtt,
4248 .pwrite = i915_gem_object_pwrite_gtt,
4251 struct drm_i915_gem_object *
4252 i915_gem_object_create(struct drm_i915_private *dev_priv, u64 size)
4254 struct drm_i915_gem_object *obj;
4255 struct address_space *mapping;
4259 /* There is a prevalence of the assumption that we fit the object's
4260 * page count inside a 32bit _signed_ variable. Let's document this and
4261 * catch if we ever need to fix it. In the meantime, if you do spot
4262 * such a local variable, please consider fixing!
4264 if (size >> PAGE_SHIFT > INT_MAX)
4265 return ERR_PTR(-E2BIG);
4267 if (overflows_type(size, obj->base.size))
4268 return ERR_PTR(-E2BIG);
4270 obj = i915_gem_object_alloc(dev_priv);
4272 return ERR_PTR(-ENOMEM);
4274 ret = drm_gem_object_init(&dev_priv->drm, &obj->base, size);
4278 mask = GFP_HIGHUSER | __GFP_RECLAIMABLE;
4279 if (IS_I965GM(dev_priv) || IS_I965G(dev_priv)) {
4280 /* 965gm cannot relocate objects above 4GiB. */
4281 mask &= ~__GFP_HIGHMEM;
4282 mask |= __GFP_DMA32;
4285 mapping = obj->base.filp->f_mapping;
4286 mapping_set_gfp_mask(mapping, mask);
4288 i915_gem_object_init(obj, &i915_gem_object_ops);
4290 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
4291 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
4293 if (HAS_LLC(dev_priv)) {
4294 /* On some devices, we can have the GPU use the LLC (the CPU
4295 * cache) for about a 10% performance improvement
4296 * compared to uncached. Graphics requests other than
4297 * display scanout are coherent with the CPU in
4298 * accessing this cache. This means in this mode we
4299 * don't need to clflush on the CPU side, and on the
4300 * GPU side we only need to flush internal caches to
4301 * get data visible to the CPU.
4303 * However, we maintain the display planes as UC, and so
4304 * need to rebind when first used as such.
4306 obj->cache_level = I915_CACHE_LLC;
4308 obj->cache_level = I915_CACHE_NONE;
4310 trace_i915_gem_object_create(obj);
4315 i915_gem_object_free(obj);
4316 return ERR_PTR(ret);
4319 static bool discard_backing_storage(struct drm_i915_gem_object *obj)
4321 /* If we are the last user of the backing storage (be it shmemfs
4322 * pages or stolen etc), we know that the pages are going to be
4323 * immediately released. In this case, we can then skip copying
4324 * back the contents from the GPU.
4327 if (obj->mm.madv != I915_MADV_WILLNEED)
4330 if (obj->base.filp == NULL)
4333 /* At first glance, this looks racy, but then again so would be
4334 * userspace racing mmap against close. However, the first external
4335 * reference to the filp can only be obtained through the
4336 * i915_gem_mmap_ioctl() which safeguards us against the user
4337 * acquiring such a reference whilst we are in the middle of
4338 * freeing the object.
4340 return atomic_long_read(&obj->base.filp->f_count) == 1;
4343 static void __i915_gem_free_objects(struct drm_i915_private *i915,
4344 struct llist_node *freed)
4346 struct drm_i915_gem_object *obj, *on;
4348 mutex_lock(&i915->drm.struct_mutex);
4349 intel_runtime_pm_get(i915);
4350 llist_for_each_entry(obj, freed, freed) {
4351 struct i915_vma *vma, *vn;
4353 trace_i915_gem_object_destroy(obj);
4355 GEM_BUG_ON(i915_gem_object_is_active(obj));
4356 list_for_each_entry_safe(vma, vn,
4357 &obj->vma_list, obj_link) {
4358 GEM_BUG_ON(!i915_vma_is_ggtt(vma));
4359 GEM_BUG_ON(i915_vma_is_active(vma));
4360 vma->flags &= ~I915_VMA_PIN_MASK;
4361 i915_vma_close(vma);
4363 GEM_BUG_ON(!list_empty(&obj->vma_list));
4364 GEM_BUG_ON(!RB_EMPTY_ROOT(&obj->vma_tree));
4366 list_del(&obj->global_link);
4368 intel_runtime_pm_put(i915);
4369 mutex_unlock(&i915->drm.struct_mutex);
4373 llist_for_each_entry_safe(obj, on, freed, freed) {
4374 GEM_BUG_ON(obj->bind_count);
4375 GEM_BUG_ON(atomic_read(&obj->frontbuffer_bits));
4377 if (obj->ops->release)
4378 obj->ops->release(obj);
4380 if (WARN_ON(i915_gem_object_has_pinned_pages(obj)))
4381 atomic_set(&obj->mm.pages_pin_count, 0);
4382 __i915_gem_object_put_pages(obj, I915_MM_NORMAL);
4383 GEM_BUG_ON(obj->mm.pages);
4385 if (obj->base.import_attach)
4386 drm_prime_gem_destroy(&obj->base, NULL);
4388 reservation_object_fini(&obj->__builtin_resv);
4389 drm_gem_object_release(&obj->base);
4390 i915_gem_info_remove_obj(i915, obj->base.size);
4393 i915_gem_object_free(obj);
4397 static void i915_gem_flush_free_objects(struct drm_i915_private *i915)
4399 struct llist_node *freed;
4401 freed = llist_del_all(&i915->mm.free_list);
4402 if (unlikely(freed))
4403 __i915_gem_free_objects(i915, freed);
4406 static void __i915_gem_free_work(struct work_struct *work)
4408 struct drm_i915_private *i915 =
4409 container_of(work, struct drm_i915_private, mm.free_work);
4410 struct llist_node *freed;
4412 /* All file-owned VMA should have been released by this point through
4413 * i915_gem_close_object(), or earlier by i915_gem_context_close().
4414 * However, the object may also be bound into the global GTT (e.g.
4415 * older GPUs without per-process support, or for direct access through
4416 * the GTT either for the user or for scanout). Those VMA still need to
4420 while ((freed = llist_del_all(&i915->mm.free_list))) {
4421 __i915_gem_free_objects(i915, freed);
4427 static void __i915_gem_free_object_rcu(struct rcu_head *head)
4429 struct drm_i915_gem_object *obj =
4430 container_of(head, typeof(*obj), rcu);
4431 struct drm_i915_private *i915 = to_i915(obj->base.dev);
4433 /* We can't simply use call_rcu() from i915_gem_free_object()
4434 * as we need to block whilst unbinding, and the call_rcu
4435 * task may be called from softirq context. So we take a
4436 * detour through a worker.
4438 if (llist_add(&obj->freed, &i915->mm.free_list))
4439 schedule_work(&i915->mm.free_work);
4442 void i915_gem_free_object(struct drm_gem_object *gem_obj)
4444 struct drm_i915_gem_object *obj = to_intel_bo(gem_obj);
4446 if (obj->mm.quirked)
4447 __i915_gem_object_unpin_pages(obj);
4449 if (discard_backing_storage(obj))
4450 obj->mm.madv = I915_MADV_DONTNEED;
4452 /* Before we free the object, make sure any pure RCU-only
4453 * read-side critical sections are complete, e.g.
4454 * i915_gem_busy_ioctl(). For the corresponding synchronized
4455 * lookup see i915_gem_object_lookup_rcu().
4457 call_rcu(&obj->rcu, __i915_gem_free_object_rcu);
4460 void __i915_gem_object_release_unless_active(struct drm_i915_gem_object *obj)
4462 lockdep_assert_held(&obj->base.dev->struct_mutex);
4464 GEM_BUG_ON(i915_gem_object_has_active_reference(obj));
4465 if (i915_gem_object_is_active(obj))
4466 i915_gem_object_set_active_reference(obj);
4468 i915_gem_object_put(obj);
4471 static void assert_kernel_context_is_current(struct drm_i915_private *dev_priv)
4473 struct intel_engine_cs *engine;
4474 enum intel_engine_id id;
4476 for_each_engine(engine, dev_priv, id)
4477 GEM_BUG_ON(engine->last_retired_context &&
4478 !i915_gem_context_is_kernel(engine->last_retired_context));
4481 void i915_gem_sanitize(struct drm_i915_private *i915)
4484 * If we inherit context state from the BIOS or earlier occupants
4485 * of the GPU, the GPU may be in an inconsistent state when we
4486 * try to take over. The only way to remove the earlier state
4487 * is by resetting. However, resetting on earlier gen is tricky as
4488 * it may impact the display and we are uncertain about the stability
4489 * of the reset, so this could be applied to even earlier gen.
4491 if (INTEL_GEN(i915) >= 5) {
4492 int reset = intel_gpu_reset(i915, ALL_ENGINES);
4493 WARN_ON(reset && reset != -ENODEV);
4497 int i915_gem_suspend(struct drm_i915_private *dev_priv)
4499 struct drm_device *dev = &dev_priv->drm;
4502 intel_runtime_pm_get(dev_priv);
4503 intel_suspend_gt_powersave(dev_priv);
4505 mutex_lock(&dev->struct_mutex);
4507 /* We have to flush all the executing contexts to main memory so
4508 * that they can saved in the hibernation image. To ensure the last
4509 * context image is coherent, we have to switch away from it. That
4510 * leaves the dev_priv->kernel_context still active when
4511 * we actually suspend, and its image in memory may not match the GPU
4512 * state. Fortunately, the kernel_context is disposable and we do
4513 * not rely on its state.
4515 ret = i915_gem_switch_to_kernel_context(dev_priv);
4519 ret = i915_gem_wait_for_idle(dev_priv,
4520 I915_WAIT_INTERRUPTIBLE |
4525 assert_kernel_context_is_current(dev_priv);
4526 i915_gem_context_lost(dev_priv);
4527 mutex_unlock(&dev->struct_mutex);
4529 intel_guc_suspend(dev_priv);
4531 cancel_delayed_work_sync(&dev_priv->gpu_error.hangcheck_work);
4532 cancel_delayed_work_sync(&dev_priv->gt.retire_work);
4534 /* As the idle_work is rearming if it detects a race, play safe and
4535 * repeat the flush until it is definitely idle.
4537 while (flush_delayed_work(&dev_priv->gt.idle_work))
4540 i915_gem_drain_freed_objects(dev_priv);
4542 /* Assert that we sucessfully flushed all the work and
4543 * reset the GPU back to its idle, low power state.
4545 WARN_ON(dev_priv->gt.awake);
4546 WARN_ON(!intel_engines_are_idle(dev_priv));
4549 * Neither the BIOS, ourselves or any other kernel
4550 * expects the system to be in execlists mode on startup,
4551 * so we need to reset the GPU back to legacy mode. And the only
4552 * known way to disable logical contexts is through a GPU reset.
4554 * So in order to leave the system in a known default configuration,
4555 * always reset the GPU upon unload and suspend. Afterwards we then
4556 * clean up the GEM state tracking, flushing off the requests and
4557 * leaving the system in a known idle state.
4559 * Note that is of the upmost importance that the GPU is idle and
4560 * all stray writes are flushed *before* we dismantle the backing
4561 * storage for the pinned objects.
4563 * However, since we are uncertain that resetting the GPU on older
4564 * machines is a good idea, we don't - just in case it leaves the
4565 * machine in an unusable condition.
4567 i915_gem_sanitize(dev_priv);
4571 mutex_unlock(&dev->struct_mutex);
4573 intel_runtime_pm_put(dev_priv);
4577 void i915_gem_resume(struct drm_i915_private *dev_priv)
4579 struct drm_device *dev = &dev_priv->drm;
4581 WARN_ON(dev_priv->gt.awake);
4583 mutex_lock(&dev->struct_mutex);
4584 i915_gem_restore_gtt_mappings(dev_priv);
4586 /* As we didn't flush the kernel context before suspend, we cannot
4587 * guarantee that the context image is complete. So let's just reset
4588 * it and start again.
4590 dev_priv->gt.resume(dev_priv);
4592 mutex_unlock(&dev->struct_mutex);
4595 void i915_gem_init_swizzling(struct drm_i915_private *dev_priv)
4597 if (INTEL_GEN(dev_priv) < 5 ||
4598 dev_priv->mm.bit_6_swizzle_x == I915_BIT_6_SWIZZLE_NONE)
4601 I915_WRITE(DISP_ARB_CTL, I915_READ(DISP_ARB_CTL) |
4602 DISP_TILE_SURFACE_SWIZZLING);
4604 if (IS_GEN5(dev_priv))
4607 I915_WRITE(TILECTL, I915_READ(TILECTL) | TILECTL_SWZCTL);
4608 if (IS_GEN6(dev_priv))
4609 I915_WRITE(ARB_MODE, _MASKED_BIT_ENABLE(ARB_MODE_SWIZZLE_SNB));
4610 else if (IS_GEN7(dev_priv))
4611 I915_WRITE(ARB_MODE, _MASKED_BIT_ENABLE(ARB_MODE_SWIZZLE_IVB));
4612 else if (IS_GEN8(dev_priv))
4613 I915_WRITE(GAMTARBMODE, _MASKED_BIT_ENABLE(ARB_MODE_SWIZZLE_BDW));
4618 static void init_unused_ring(struct drm_i915_private *dev_priv, u32 base)
4620 I915_WRITE(RING_CTL(base), 0);
4621 I915_WRITE(RING_HEAD(base), 0);
4622 I915_WRITE(RING_TAIL(base), 0);
4623 I915_WRITE(RING_START(base), 0);
4626 static void init_unused_rings(struct drm_i915_private *dev_priv)
4628 if (IS_I830(dev_priv)) {
4629 init_unused_ring(dev_priv, PRB1_BASE);
4630 init_unused_ring(dev_priv, SRB0_BASE);
4631 init_unused_ring(dev_priv, SRB1_BASE);
4632 init_unused_ring(dev_priv, SRB2_BASE);
4633 init_unused_ring(dev_priv, SRB3_BASE);
4634 } else if (IS_GEN2(dev_priv)) {
4635 init_unused_ring(dev_priv, SRB0_BASE);
4636 init_unused_ring(dev_priv, SRB1_BASE);
4637 } else if (IS_GEN3(dev_priv)) {
4638 init_unused_ring(dev_priv, PRB1_BASE);
4639 init_unused_ring(dev_priv, PRB2_BASE);
4643 static int __i915_gem_restart_engines(void *data)
4645 struct drm_i915_private *i915 = data;
4646 struct intel_engine_cs *engine;
4647 enum intel_engine_id id;
4650 for_each_engine(engine, i915, id) {
4651 err = engine->init_hw(engine);
4659 int i915_gem_init_hw(struct drm_i915_private *dev_priv)
4663 dev_priv->gt.last_init_time = ktime_get();
4665 /* Double layer security blanket, see i915_gem_init() */
4666 intel_uncore_forcewake_get(dev_priv, FORCEWAKE_ALL);
4668 if (HAS_EDRAM(dev_priv) && INTEL_GEN(dev_priv) < 9)
4669 I915_WRITE(HSW_IDICR, I915_READ(HSW_IDICR) | IDIHASHMSK(0xf));
4671 if (IS_HASWELL(dev_priv))
4672 I915_WRITE(MI_PREDICATE_RESULT_2, IS_HSW_GT3(dev_priv) ?
4673 LOWER_SLICE_ENABLED : LOWER_SLICE_DISABLED);
4675 if (HAS_PCH_NOP(dev_priv)) {
4676 if (IS_IVYBRIDGE(dev_priv)) {
4677 u32 temp = I915_READ(GEN7_MSG_CTL);
4678 temp &= ~(WAIT_FOR_PCH_FLR_ACK | WAIT_FOR_PCH_RESET_ACK);
4679 I915_WRITE(GEN7_MSG_CTL, temp);
4680 } else if (INTEL_GEN(dev_priv) >= 7) {
4681 u32 temp = I915_READ(HSW_NDE_RSTWRN_OPT);
4682 temp &= ~RESET_PCH_HANDSHAKE_ENABLE;
4683 I915_WRITE(HSW_NDE_RSTWRN_OPT, temp);
4687 i915_gem_init_swizzling(dev_priv);
4690 * At least 830 can leave some of the unused rings
4691 * "active" (ie. head != tail) after resume which
4692 * will prevent c3 entry. Makes sure all unused rings
4695 init_unused_rings(dev_priv);
4697 BUG_ON(!dev_priv->kernel_context);
4699 ret = i915_ppgtt_init_hw(dev_priv);
4701 DRM_ERROR("PPGTT enable HW failed %d\n", ret);
4705 /* Need to do basic initialisation of all rings first: */
4706 ret = __i915_gem_restart_engines(dev_priv);
4710 intel_mocs_init_l3cc_table(dev_priv);
4712 /* We can't enable contexts until all firmware is loaded */
4713 ret = intel_uc_init_hw(dev_priv);
4718 intel_uncore_forcewake_put(dev_priv, FORCEWAKE_ALL);
4722 bool intel_sanitize_semaphores(struct drm_i915_private *dev_priv, int value)
4724 if (INTEL_INFO(dev_priv)->gen < 6)
4727 /* TODO: make semaphores and Execlists play nicely together */
4728 if (i915.enable_execlists)
4734 #ifdef CONFIG_INTEL_IOMMU
4735 /* Enable semaphores on SNB when IO remapping is off */
4736 if (INTEL_INFO(dev_priv)->gen == 6 && intel_iommu_gfx_mapped)
4743 int i915_gem_init(struct drm_i915_private *dev_priv)
4747 mutex_lock(&dev_priv->drm.struct_mutex);
4749 dev_priv->mm.unordered_timeline = dma_fence_context_alloc(1);
4751 if (!i915.enable_execlists) {
4752 dev_priv->gt.resume = intel_legacy_submission_resume;
4753 dev_priv->gt.cleanup_engine = intel_engine_cleanup;
4755 dev_priv->gt.resume = intel_lr_context_resume;
4756 dev_priv->gt.cleanup_engine = intel_logical_ring_cleanup;
4759 /* This is just a security blanket to placate dragons.
4760 * On some systems, we very sporadically observe that the first TLBs
4761 * used by the CS may be stale, despite us poking the TLB reset. If
4762 * we hold the forcewake during initialisation these problems
4763 * just magically go away.
4765 intel_uncore_forcewake_get(dev_priv, FORCEWAKE_ALL);
4767 i915_gem_init_userptr(dev_priv);
4769 ret = i915_gem_init_ggtt(dev_priv);
4773 ret = i915_gem_context_init(dev_priv);
4777 ret = intel_engines_init(dev_priv);
4781 ret = i915_gem_init_hw(dev_priv);
4783 /* Allow engine initialisation to fail by marking the GPU as
4784 * wedged. But we only want to do this where the GPU is angry,
4785 * for all other failure, such as an allocation failure, bail.
4787 DRM_ERROR("Failed to initialize GPU, declaring it wedged\n");
4788 i915_gem_set_wedged(dev_priv);
4793 intel_uncore_forcewake_put(dev_priv, FORCEWAKE_ALL);
4794 mutex_unlock(&dev_priv->drm.struct_mutex);
4799 void i915_gem_init_mmio(struct drm_i915_private *i915)
4801 i915_gem_sanitize(i915);
4805 i915_gem_cleanup_engines(struct drm_i915_private *dev_priv)
4807 struct intel_engine_cs *engine;
4808 enum intel_engine_id id;
4810 for_each_engine(engine, dev_priv, id)
4811 dev_priv->gt.cleanup_engine(engine);
4815 i915_gem_load_init_fences(struct drm_i915_private *dev_priv)
4819 if (INTEL_INFO(dev_priv)->gen >= 7 && !IS_VALLEYVIEW(dev_priv) &&
4820 !IS_CHERRYVIEW(dev_priv))
4821 dev_priv->num_fence_regs = 32;
4822 else if (INTEL_INFO(dev_priv)->gen >= 4 ||
4823 IS_I945G(dev_priv) || IS_I945GM(dev_priv) ||
4824 IS_G33(dev_priv) || IS_PINEVIEW(dev_priv))
4825 dev_priv->num_fence_regs = 16;
4827 dev_priv->num_fence_regs = 8;
4829 if (intel_vgpu_active(dev_priv))
4830 dev_priv->num_fence_regs =
4831 I915_READ(vgtif_reg(avail_rs.fence_num));
4833 /* Initialize fence registers to zero */
4834 for (i = 0; i < dev_priv->num_fence_regs; i++) {
4835 struct drm_i915_fence_reg *fence = &dev_priv->fence_regs[i];
4837 fence->i915 = dev_priv;
4839 list_add_tail(&fence->link, &dev_priv->mm.fence_list);
4841 i915_gem_restore_fences(dev_priv);
4843 i915_gem_detect_bit_6_swizzle(dev_priv);
4847 i915_gem_load_init(struct drm_i915_private *dev_priv)
4851 dev_priv->objects = KMEM_CACHE(drm_i915_gem_object, SLAB_HWCACHE_ALIGN);
4852 if (!dev_priv->objects)
4855 dev_priv->vmas = KMEM_CACHE(i915_vma, SLAB_HWCACHE_ALIGN);
4856 if (!dev_priv->vmas)
4859 dev_priv->requests = KMEM_CACHE(drm_i915_gem_request,
4860 SLAB_HWCACHE_ALIGN |
4861 SLAB_RECLAIM_ACCOUNT |
4862 SLAB_DESTROY_BY_RCU);
4863 if (!dev_priv->requests)
4866 dev_priv->dependencies = KMEM_CACHE(i915_dependency,
4867 SLAB_HWCACHE_ALIGN |
4868 SLAB_RECLAIM_ACCOUNT);
4869 if (!dev_priv->dependencies)
4872 mutex_lock(&dev_priv->drm.struct_mutex);
4873 INIT_LIST_HEAD(&dev_priv->gt.timelines);
4874 err = i915_gem_timeline_init__global(dev_priv);
4875 mutex_unlock(&dev_priv->drm.struct_mutex);
4877 goto err_dependencies;
4879 INIT_LIST_HEAD(&dev_priv->context_list);
4880 INIT_WORK(&dev_priv->mm.free_work, __i915_gem_free_work);
4881 init_llist_head(&dev_priv->mm.free_list);
4882 INIT_LIST_HEAD(&dev_priv->mm.unbound_list);
4883 INIT_LIST_HEAD(&dev_priv->mm.bound_list);
4884 INIT_LIST_HEAD(&dev_priv->mm.fence_list);
4885 INIT_LIST_HEAD(&dev_priv->mm.userfault_list);
4886 INIT_DELAYED_WORK(&dev_priv->gt.retire_work,
4887 i915_gem_retire_work_handler);
4888 INIT_DELAYED_WORK(&dev_priv->gt.idle_work,
4889 i915_gem_idle_work_handler);
4890 init_waitqueue_head(&dev_priv->gpu_error.wait_queue);
4891 init_waitqueue_head(&dev_priv->gpu_error.reset_queue);
4893 init_waitqueue_head(&dev_priv->pending_flip_queue);
4895 atomic_set(&dev_priv->mm.bsd_engine_dispatch_index, 0);
4897 spin_lock_init(&dev_priv->fb_tracking.lock);
4902 kmem_cache_destroy(dev_priv->dependencies);
4904 kmem_cache_destroy(dev_priv->requests);
4906 kmem_cache_destroy(dev_priv->vmas);
4908 kmem_cache_destroy(dev_priv->objects);
4913 void i915_gem_load_cleanup(struct drm_i915_private *dev_priv)
4915 i915_gem_drain_freed_objects(dev_priv);
4916 WARN_ON(!llist_empty(&dev_priv->mm.free_list));
4917 WARN_ON(dev_priv->mm.object_count);
4919 mutex_lock(&dev_priv->drm.struct_mutex);
4920 i915_gem_timeline_fini(&dev_priv->gt.global_timeline);
4921 WARN_ON(!list_empty(&dev_priv->gt.timelines));
4922 mutex_unlock(&dev_priv->drm.struct_mutex);
4924 kmem_cache_destroy(dev_priv->dependencies);
4925 kmem_cache_destroy(dev_priv->requests);
4926 kmem_cache_destroy(dev_priv->vmas);
4927 kmem_cache_destroy(dev_priv->objects);
4929 /* And ensure that our DESTROY_BY_RCU slabs are truly destroyed */
4933 int i915_gem_freeze(struct drm_i915_private *dev_priv)
4935 /* Discard all purgeable objects, let userspace recover those as
4936 * required after resuming.
4938 i915_gem_shrink_all(dev_priv);
4943 int i915_gem_freeze_late(struct drm_i915_private *dev_priv)
4945 struct drm_i915_gem_object *obj;
4946 struct list_head *phases[] = {
4947 &dev_priv->mm.unbound_list,
4948 &dev_priv->mm.bound_list,
4952 /* Called just before we write the hibernation image.
4954 * We need to update the domain tracking to reflect that the CPU
4955 * will be accessing all the pages to create and restore from the
4956 * hibernation, and so upon restoration those pages will be in the
4959 * To make sure the hibernation image contains the latest state,
4960 * we update that state just before writing out the image.
4962 * To try and reduce the hibernation image, we manually shrink
4963 * the objects as well, see i915_gem_freeze()
4966 i915_gem_shrink(dev_priv, -1UL, I915_SHRINK_UNBOUND);
4967 i915_gem_drain_freed_objects(dev_priv);
4969 mutex_lock(&dev_priv->drm.struct_mutex);
4970 for (p = phases; *p; p++) {
4971 list_for_each_entry(obj, *p, global_link) {
4972 obj->base.read_domains = I915_GEM_DOMAIN_CPU;
4973 obj->base.write_domain = I915_GEM_DOMAIN_CPU;
4976 mutex_unlock(&dev_priv->drm.struct_mutex);
4981 void i915_gem_release(struct drm_device *dev, struct drm_file *file)
4983 struct drm_i915_file_private *file_priv = file->driver_priv;
4984 struct drm_i915_gem_request *request;
4986 /* Clean up our request list when the client is going away, so that
4987 * later retire_requests won't dereference our soon-to-be-gone
4990 spin_lock(&file_priv->mm.lock);
4991 list_for_each_entry(request, &file_priv->mm.request_list, client_link)
4992 request->file_priv = NULL;
4993 spin_unlock(&file_priv->mm.lock);
4995 if (!list_empty(&file_priv->rps.link)) {
4996 spin_lock(&to_i915(dev)->rps.client_lock);
4997 list_del(&file_priv->rps.link);
4998 spin_unlock(&to_i915(dev)->rps.client_lock);
5002 int i915_gem_open(struct drm_device *dev, struct drm_file *file)
5004 struct drm_i915_file_private *file_priv;
5009 file_priv = kzalloc(sizeof(*file_priv), GFP_KERNEL);
5013 file->driver_priv = file_priv;
5014 file_priv->dev_priv = to_i915(dev);
5015 file_priv->file = file;
5016 INIT_LIST_HEAD(&file_priv->rps.link);
5018 spin_lock_init(&file_priv->mm.lock);
5019 INIT_LIST_HEAD(&file_priv->mm.request_list);
5021 file_priv->bsd_engine = -1;
5023 ret = i915_gem_context_open(dev, file);
5031 * i915_gem_track_fb - update frontbuffer tracking
5032 * @old: current GEM buffer for the frontbuffer slots
5033 * @new: new GEM buffer for the frontbuffer slots
5034 * @frontbuffer_bits: bitmask of frontbuffer slots
5036 * This updates the frontbuffer tracking bits @frontbuffer_bits by clearing them
5037 * from @old and setting them in @new. Both @old and @new can be NULL.
5039 void i915_gem_track_fb(struct drm_i915_gem_object *old,
5040 struct drm_i915_gem_object *new,
5041 unsigned frontbuffer_bits)
5043 /* Control of individual bits within the mask are guarded by
5044 * the owning plane->mutex, i.e. we can never see concurrent
5045 * manipulation of individual bits. But since the bitfield as a whole
5046 * is updated using RMW, we need to use atomics in order to update
5049 BUILD_BUG_ON(INTEL_FRONTBUFFER_BITS_PER_PIPE * I915_MAX_PIPES >
5050 sizeof(atomic_t) * BITS_PER_BYTE);
5053 WARN_ON(!(atomic_read(&old->frontbuffer_bits) & frontbuffer_bits));
5054 atomic_andnot(frontbuffer_bits, &old->frontbuffer_bits);
5058 WARN_ON(atomic_read(&new->frontbuffer_bits) & frontbuffer_bits);
5059 atomic_or(frontbuffer_bits, &new->frontbuffer_bits);
5063 /* Allocate a new GEM object and fill it with the supplied data */
5064 struct drm_i915_gem_object *
5065 i915_gem_object_create_from_data(struct drm_i915_private *dev_priv,
5066 const void *data, size_t size)
5068 struct drm_i915_gem_object *obj;
5073 obj = i915_gem_object_create(dev_priv, round_up(size, PAGE_SIZE));
5077 GEM_BUG_ON(obj->base.write_domain != I915_GEM_DOMAIN_CPU);
5079 file = obj->base.filp;
5082 unsigned int len = min_t(typeof(size), size, PAGE_SIZE);
5084 void *pgdata, *vaddr;
5086 err = pagecache_write_begin(file, file->f_mapping,
5093 memcpy(vaddr, data, len);
5096 err = pagecache_write_end(file, file->f_mapping,
5110 i915_gem_object_put(obj);
5111 return ERR_PTR(err);
5114 struct scatterlist *
5115 i915_gem_object_get_sg(struct drm_i915_gem_object *obj,
5117 unsigned int *offset)
5119 struct i915_gem_object_page_iter *iter = &obj->mm.get_page;
5120 struct scatterlist *sg;
5121 unsigned int idx, count;
5124 GEM_BUG_ON(n >= obj->base.size >> PAGE_SHIFT);
5125 GEM_BUG_ON(!i915_gem_object_has_pinned_pages(obj));
5127 /* As we iterate forward through the sg, we record each entry in a
5128 * radixtree for quick repeated (backwards) lookups. If we have seen
5129 * this index previously, we will have an entry for it.
5131 * Initial lookup is O(N), but this is amortized to O(1) for
5132 * sequential page access (where each new request is consecutive
5133 * to the previous one). Repeated lookups are O(lg(obj->base.size)),
5134 * i.e. O(1) with a large constant!
5136 if (n < READ_ONCE(iter->sg_idx))
5139 mutex_lock(&iter->lock);
5141 /* We prefer to reuse the last sg so that repeated lookup of this
5142 * (or the subsequent) sg are fast - comparing against the last
5143 * sg is faster than going through the radixtree.
5148 count = __sg_page_count(sg);
5150 while (idx + count <= n) {
5151 unsigned long exception, i;
5154 /* If we cannot allocate and insert this entry, or the
5155 * individual pages from this range, cancel updating the
5156 * sg_idx so that on this lookup we are forced to linearly
5157 * scan onwards, but on future lookups we will try the
5158 * insertion again (in which case we need to be careful of
5159 * the error return reporting that we have already inserted
5162 ret = radix_tree_insert(&iter->radix, idx, sg);
5163 if (ret && ret != -EEXIST)
5167 RADIX_TREE_EXCEPTIONAL_ENTRY |
5168 idx << RADIX_TREE_EXCEPTIONAL_SHIFT;
5169 for (i = 1; i < count; i++) {
5170 ret = radix_tree_insert(&iter->radix, idx + i,
5172 if (ret && ret != -EEXIST)
5177 sg = ____sg_next(sg);
5178 count = __sg_page_count(sg);
5185 mutex_unlock(&iter->lock);
5187 if (unlikely(n < idx)) /* insertion completed by another thread */
5190 /* In case we failed to insert the entry into the radixtree, we need
5191 * to look beyond the current sg.
5193 while (idx + count <= n) {
5195 sg = ____sg_next(sg);
5196 count = __sg_page_count(sg);
5205 sg = radix_tree_lookup(&iter->radix, n);
5208 /* If this index is in the middle of multi-page sg entry,
5209 * the radixtree will contain an exceptional entry that points
5210 * to the start of that range. We will return the pointer to
5211 * the base page and the offset of this page within the
5215 if (unlikely(radix_tree_exception(sg))) {
5216 unsigned long base =
5217 (unsigned long)sg >> RADIX_TREE_EXCEPTIONAL_SHIFT;
5219 sg = radix_tree_lookup(&iter->radix, base);
5231 i915_gem_object_get_page(struct drm_i915_gem_object *obj, unsigned int n)
5233 struct scatterlist *sg;
5234 unsigned int offset;
5236 GEM_BUG_ON(!i915_gem_object_has_struct_page(obj));
5238 sg = i915_gem_object_get_sg(obj, n, &offset);
5239 return nth_page(sg_page(sg), offset);
5242 /* Like i915_gem_object_get_page(), but mark the returned page dirty */
5244 i915_gem_object_get_dirty_page(struct drm_i915_gem_object *obj,
5249 page = i915_gem_object_get_page(obj, n);
5251 set_page_dirty(page);
5257 i915_gem_object_get_dma_address(struct drm_i915_gem_object *obj,
5260 struct scatterlist *sg;
5261 unsigned int offset;
5263 sg = i915_gem_object_get_sg(obj, n, &offset);
5264 return sg_dma_address(sg) + (offset << PAGE_SHIFT);
5267 #if IS_ENABLED(CONFIG_DRM_I915_SELFTEST)
5268 #include "selftests/scatterlist.c"
5269 #include "selftests/mock_gem_device.c"
5270 #include "selftests/huge_gem_object.c"
5271 #include "selftests/i915_gem_object.c"
5272 #include "selftests/i915_gem_coherency.c"