drivers/gpu/drm/i915/i915_gem_timeline.h

   1 /*
   2  * Copyright © 2016 Intel Corporation
   3  *
   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:
  10  *
  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
  13  * Software.
  14  *
  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
  21  * IN THE SOFTWARE.
  22  *
  23  */
  24
  25 #ifndef I915_GEM_TIMELINE_H
  26 #define I915_GEM_TIMELINE_H
  27
  28 #include <linux/list.h>
  29
  30 #include "i915_gem_request.h"
  31
  32 struct i915_gem_timeline;
  33
  34 struct intel_timeline {
  35         u64 fence_context;
  36         u32 seqno;
  37
  38         /**
  39          * Count of outstanding requests, from the time they are constructed
  40          * to the moment they are retired. Loosely coupled to hardware.
  41          */
  42         u32 inflight_seqnos;
  43
  44         spinlock_t lock;
  45
  46         /**
  47          * List of breadcrumbs associated with GPU requests currently
  48          * outstanding.
  49          */
  50         struct list_head requests;
  51
  52         /* Contains an RCU guarded pointer to the last request. No reference is
  53          * held to the request, users must carefully acquire a reference to
  54          * the request using i915_gem_active_get_request_rcu(), or hold the
  55          * struct_mutex.
  56          */
  57         struct i915_gem_active last_request;
  58         u32 sync_seqno[I915_NUM_ENGINES];
  59
  60         struct i915_gem_timeline *common;
  61 };
  62
  63 struct i915_gem_timeline {
  64         struct list_head link;
  65
  66         struct drm_i915_private *i915;
  67         const char *name;
  68
  69         struct intel_timeline engine[I915_NUM_ENGINES];
  70 };
  71
  72 int i915_gem_timeline_init(struct drm_i915_private *i915,
  73                            struct i915_gem_timeline *tl,
  74                            const char *name);
  75 int i915_gem_timeline_init__global(struct drm_i915_private *i915);
  76 void i915_gem_timeline_fini(struct i915_gem_timeline *tl);
  77
  78 #endif