drivers/gpu/drm/i915/i915_active_types.h

   1 /*
   2  * SPDX-License-Identifier: MIT
   3  *
   4  * Copyright © 2019 Intel Corporation
   5  */
   6
   7 #ifndef _I915_ACTIVE_TYPES_H_
   8 #define _I915_ACTIVE_TYPES_H_
   9
  10 #include <linux/atomic.h>
  11 #include <linux/llist.h>
  12 #include <linux/mutex.h>
  13 #include <linux/rbtree.h>
  14 #include <linux/rcupdate.h>
  15
  16 struct drm_i915_private;
  17 struct i915_active_request;
  18 struct i915_request;
  19
  20 typedef void (*i915_active_retire_fn)(struct i915_active_request *,
  21                                       struct i915_request *);
  22
  23 struct i915_active_request {
  24         struct i915_request __rcu *request;
  25         struct list_head link;
  26         i915_active_retire_fn retire;
  27 #if IS_ENABLED(CONFIG_DRM_I915_DEBUG_GEM)
  28         /*
  29          * Incorporeal!
  30          *
  31          * Updates to the i915_active_request must be serialised under a lock
  32          * to ensure that the timeline is ordered. Normally, this is the
  33          * timeline->mutex, but another mutex may be used so long as it is
  34          * done so consistently.
  35          *
  36          * For lockdep tracking of the above, we store the lock we intend
  37          * to always use for updates of this i915_active_request during
  38          * construction and assert that is held on every update.
  39          */
  40         struct mutex *lock;
  41 #endif
  42 };
  43
  44 struct active_node;
  45
  46 struct i915_active {
  47         struct drm_i915_private *i915;
  48
  49         struct active_node *cache;
  50         struct rb_root tree;
  51         struct mutex mutex;
  52         atomic_t count;
  53
  54         unsigned long flags;
  55 #define I915_ACTIVE_GRAB_BIT 0
  56
  57         int (*active)(struct i915_active *ref);
  58         void (*retire)(struct i915_active *ref);
  59
  60         struct llist_head preallocated_barriers;
  61 };
  62
  63 #endif /* _I915_ACTIVE_TYPES_H_ */