/* * Copyright © 2016 Intel Corporation * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice (including the next * paragraph) shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS * IN THE SOFTWARE. * */ #ifndef __I915_VMA_H__ #define __I915_VMA_H__ #include <linux/io-mapping.h> #include <linux/rbtree.h> #include <drm/drm_mm.h> #include "gt/intel_ggtt_fencing.h" #include "gem/i915_gem_object.h" #include "i915_gem_gtt.h" #include "i915_active.h" #include "i915_request.h" #include "i915_vma_resource.h" #include "i915_vma_types.h" struct i915_vma * i915_vma_instance(struct drm_i915_gem_object *obj, struct i915_address_space *vm, const struct i915_gtt_view *view); void i915_vma_unpin_and_release(struct i915_vma **p_vma, unsigned int flags); #define I915_VMA_RELEASE_MAP … static inline bool i915_vma_is_active(const struct i915_vma *vma) { … } /* do not reserve memory to prevent deadlocks */ #define __EXEC_OBJECT_NO_RESERVE … #define __EXEC_OBJECT_NO_REQUEST_AWAIT … int __must_check _i915_vma_move_to_active(struct i915_vma *vma, struct i915_request *rq, struct dma_fence *fence, unsigned int flags); static inline int __must_check i915_vma_move_to_active(struct i915_vma *vma, struct i915_request *rq, unsigned int flags) { … } #define __i915_vma_flags(v) … static inline bool i915_vma_is_ggtt(const struct i915_vma *vma) { … } static inline bool i915_vma_is_dpt(const struct i915_vma *vma) { … } static inline bool i915_vma_has_ggtt_write(const struct i915_vma *vma) { … } static inline void i915_vma_set_ggtt_write(struct i915_vma *vma) { … } static inline bool i915_vma_unset_ggtt_write(struct i915_vma *vma) { … } void i915_vma_flush_writes(struct i915_vma *vma); static inline bool i915_vma_is_map_and_fenceable(const struct i915_vma *vma) { … } static inline bool i915_vma_set_userfault(struct i915_vma *vma) { … } static inline void i915_vma_unset_userfault(struct i915_vma *vma) { … } static inline bool i915_vma_has_userfault(const struct i915_vma *vma) { … } static inline bool i915_vma_is_closed(const struct i915_vma *vma) { … } /* Internal use only. */ static inline u64 __i915_vma_size(const struct i915_vma *vma) { … } /** * i915_vma_size - Obtain the va range size of the vma * @vma: The vma * * GPU virtual address space may be allocated with padding. This * function returns the effective virtual address range size * with padding subtracted. * * Return: The effective virtual address range size. */ static inline u64 i915_vma_size(const struct i915_vma *vma) { … } /* Internal use only. */ static inline u64 __i915_vma_offset(const struct i915_vma *vma) { … } /** * i915_vma_offset - Obtain the va offset of the vma * @vma: The vma * * GPU virtual address space may be allocated with padding. This * function returns the effective virtual address offset the gpu * should use to access the bound data. * * Return: The effective virtual address offset. */ static inline u64 i915_vma_offset(const struct i915_vma *vma) { … } static inline u32 i915_ggtt_offset(const struct i915_vma *vma) { … } static inline u32 i915_ggtt_pin_bias(struct i915_vma *vma) { … } static inline struct i915_vma *i915_vma_get(struct i915_vma *vma) { … } static inline struct i915_vma *i915_vma_tryget(struct i915_vma *vma) { … } static inline void i915_vma_put(struct i915_vma *vma) { … } static inline long i915_vma_compare(struct i915_vma *vma, struct i915_address_space *vm, const struct i915_gtt_view *view) { … } struct i915_vma_work *i915_vma_work(void); int i915_vma_bind(struct i915_vma *vma, unsigned int pat_index, u32 flags, struct i915_vma_work *work, struct i915_vma_resource *vma_res); bool i915_gem_valid_gtt_space(struct i915_vma *vma, unsigned long color); bool i915_vma_misplaced(const struct i915_vma *vma, u64 size, u64 alignment, u64 flags); void __i915_vma_set_map_and_fenceable(struct i915_vma *vma); void i915_vma_revoke_mmap(struct i915_vma *vma); void vma_invalidate_tlb(struct i915_address_space *vm, u32 *tlb); struct dma_fence *__i915_vma_evict(struct i915_vma *vma, bool async); int __i915_vma_unbind(struct i915_vma *vma); int __must_check i915_vma_unbind(struct i915_vma *vma); int __must_check i915_vma_unbind_async(struct i915_vma *vma, bool trylock_vm); int __must_check i915_vma_unbind_unlocked(struct i915_vma *vma); void i915_vma_unlink_ctx(struct i915_vma *vma); void i915_vma_close(struct i915_vma *vma); void i915_vma_reopen(struct i915_vma *vma); void i915_vma_destroy_locked(struct i915_vma *vma); void i915_vma_destroy(struct i915_vma *vma); #define assert_vma_held(vma) … static inline void i915_vma_lock(struct i915_vma *vma) { … } static inline void i915_vma_unlock(struct i915_vma *vma) { … } int __must_check i915_vma_pin_ww(struct i915_vma *vma, struct i915_gem_ww_ctx *ww, u64 size, u64 alignment, u64 flags); static inline int __must_check i915_vma_pin(struct i915_vma *vma, u64 size, u64 alignment, u64 flags) { … } int i915_ggtt_pin(struct i915_vma *vma, struct i915_gem_ww_ctx *ww, u32 align, unsigned int flags); static inline int i915_vma_pin_count(const struct i915_vma *vma) { … } static inline bool i915_vma_is_pinned(const struct i915_vma *vma) { … } static inline void __i915_vma_pin(struct i915_vma *vma) { … } static inline void __i915_vma_unpin(struct i915_vma *vma) { … } static inline void i915_vma_unpin(struct i915_vma *vma) { … } static inline bool i915_vma_is_bound(const struct i915_vma *vma, unsigned int where) { … } static inline bool i915_node_color_differs(const struct drm_mm_node *node, unsigned long color) { … } /** * i915_vma_pin_iomap - calls ioremap_wc to map the GGTT VMA via the aperture * @vma: VMA to iomap * * The passed in VMA has to be pinned in the global GTT mappable region. * An extra pinning of the VMA is acquired for the return iomapping, * the caller must call i915_vma_unpin_iomap to relinquish the pinning * after the iomapping is no longer required. * * Returns a valid iomapped pointer or ERR_PTR. */ void __iomem *i915_vma_pin_iomap(struct i915_vma *vma); /** * i915_vma_unpin_iomap - unpins the mapping returned from i915_vma_iomap * @vma: VMA to unpin * * Unpins the previously iomapped VMA from i915_vma_pin_iomap(). * * This function is only valid to be called on a VMA previously * iomapped by the caller with i915_vma_pin_iomap(). */ void i915_vma_unpin_iomap(struct i915_vma *vma); /** * i915_vma_pin_fence - pin fencing state * @vma: vma to pin fencing for * * This pins the fencing state (whether tiled or untiled) to make sure the * vma (and its object) is ready to be used as a scanout target. Fencing * status must be synchronize first by calling i915_vma_get_fence(): * * The resulting fence pin reference must be released again with * i915_vma_unpin_fence(). * * Returns: * True if the vma has a fence, false otherwise. */ int __must_check i915_vma_pin_fence(struct i915_vma *vma); void i915_vma_revoke_fence(struct i915_vma *vma); int __i915_vma_pin_fence(struct i915_vma *vma); static inline void __i915_vma_unpin_fence(struct i915_vma *vma) { … } /** * i915_vma_unpin_fence - unpin fencing state * @vma: vma to unpin fencing for * * This releases the fence pin reference acquired through * i915_vma_pin_fence. It will handle both objects with and without an * attached fence correctly, callers do not need to distinguish this. */ static inline void i915_vma_unpin_fence(struct i915_vma *vma) { … } static inline int i915_vma_fence_id(const struct i915_vma *vma) { … } void i915_vma_parked(struct intel_gt *gt); static inline bool i915_vma_is_scanout(const struct i915_vma *vma) { … } static inline void i915_vma_mark_scanout(struct i915_vma *vma) { … } static inline void i915_vma_clear_scanout(struct i915_vma *vma) { … } void i915_ggtt_clear_scanout(struct drm_i915_gem_object *obj); #define for_each_until(cond) … /** * for_each_ggtt_vma - Iterate over the GGTT VMA belonging to an object. * @V: the #i915_vma iterator * @OBJ: the #drm_i915_gem_object * * GGTT VMA are placed at the being of the object's vma_list, see * vma_create(), so we can stop our walk as soon as we see a ppgtt VMA, * or the list is empty ofc. */ #define for_each_ggtt_vma(V, OBJ) … struct i915_vma *i915_vma_make_unshrinkable(struct i915_vma *vma); void i915_vma_make_shrinkable(struct i915_vma *vma); void i915_vma_make_purgeable(struct i915_vma *vma); int i915_vma_wait_for_bind(struct i915_vma *vma); static inline int i915_vma_sync(struct i915_vma *vma) { … } /** * i915_vma_get_current_resource - Get the current resource of the vma * @vma: The vma to get the current resource from. * * It's illegal to call this function if the vma is not bound. * * Return: A refcounted pointer to the current vma resource * of the vma, assuming the vma is bound. */ static inline struct i915_vma_resource * i915_vma_get_current_resource(struct i915_vma *vma) { … } #if IS_ENABLED(CONFIG_DRM_I915_SELFTEST) void i915_vma_resource_init_from_vma(struct i915_vma_resource *vma_res, struct i915_vma *vma); #endif void i915_vma_module_exit(void); int i915_vma_module_init(void); I915_SELFTEST_DECLARE(…); I915_SELFTEST_DECLARE(…); #endif
Codebase Browser
linux