/* * SPDX-License-Identifier: MIT * * i915_sw_fence.h - library routines for N:M synchronisation points * * Copyright (C) 2016 Intel Corporation */ #ifndef _I915_SW_FENCE_H_ #define _I915_SW_FENCE_H_ #include <linux/dma-fence.h> #include <linux/gfp.h> #include <linux/kref.h> #include <linux/notifier.h> /* for NOTIFY_DONE */ #include <linux/wait.h> struct completion; struct reservation_object; struct i915_sw_fence { wait_queue_head_t wait; unsigned long flags; atomic_t pending; }; #define I915_SW_FENCE_CHECKED_BIT 0 /* used internally for DAG checking */ #define I915_SW_FENCE_PRIVATE_BIT 1 /* available for use by owner */ #define I915_SW_FENCE_MASK (~3) enum i915_sw_fence_notify { FENCE_COMPLETE, FENCE_FREE }; typedef int (*i915_sw_fence_notify_t)(struct i915_sw_fence *, enum i915_sw_fence_notify state); #define __i915_sw_fence_call __aligned(4) void __i915_sw_fence_init(struct i915_sw_fence *fence, i915_sw_fence_notify_t fn, const char *name, struct lock_class_key *key); #ifdef CONFIG_LOCKDEP #define i915_sw_fence_init(fence, fn) \ do { \ static struct lock_class_key __key; \ \ __i915_sw_fence_init((fence), (fn), #fence, &__key); \ } while (0) #else #define i915_sw_fence_init(fence, fn) \ __i915_sw_fence_init((fence), (fn), NULL, NULL) #endif #ifdef CONFIG_DRM_I915_SW_FENCE_DEBUG_OBJECTS void i915_sw_fence_fini(struct i915_sw_fence *fence); #else static inline void i915_sw_fence_fini(struct i915_sw_fence *fence) {} #endif void i915_sw_fence_commit(struct i915_sw_fence *fence); int i915_sw_fence_await_sw_fence(struct i915_sw_fence *fence, struct i915_sw_fence *after, wait_queue_entry_t *wq); int i915_sw_fence_await_sw_fence_gfp(struct i915_sw_fence *fence, struct i915_sw_fence *after, gfp_t gfp); struct i915_sw_dma_fence_cb { struct dma_fence_cb base; struct i915_sw_fence *fence; }; int __i915_sw_fence_await_dma_fence(struct i915_sw_fence *fence, struct dma_fence *dma, struct i915_sw_dma_fence_cb *cb); int i915_sw_fence_await_dma_fence(struct i915_sw_fence *fence, struct dma_fence *dma, unsigned long timeout, gfp_t gfp); int i915_sw_fence_await_reservation(struct i915_sw_fence *fence, struct reservation_object *resv, const struct dma_fence_ops *exclude, bool write, unsigned long timeout, gfp_t gfp); void i915_sw_fence_await(struct i915_sw_fence *fence); void i915_sw_fence_complete(struct i915_sw_fence *fence); static inline bool i915_sw_fence_signaled(const struct i915_sw_fence *fence) { return atomic_read(&fence->pending) <= 0; } static inline bool i915_sw_fence_done(const struct i915_sw_fence *fence) { return atomic_read(&fence->pending) < 0; } static inline void i915_sw_fence_wait(struct i915_sw_fence *fence) { wait_event(fence->wait, i915_sw_fence_done(fence)); } #endif /* _I915_SW_FENCE_H_ */