2 * Copyright (C) 2013 Red Hat
3 * Author: Rob Clark <robdclark@gmail.com>
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 as published by
7 * the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * You should have received a copy of the GNU General Public License along with
15 * this program. If not, see <http://www.gnu.org/licenses/>.
21 #include <linux/kref.h>
22 #include <linux/reservation.h>
25 /* Additional internal-use only BO flags: */
26 #define MSM_BO_STOLEN 0x10000000 /* try to use stolen/splash memory */
28 struct msm_gem_address_space {
30 /* NOTE: mm managed at the page level, size is in # of pages
31 * and position mm_node->start is in # of pages:
34 spinlock_t lock; /* Protects drm_mm node allocation/removal */
40 struct drm_mm_node node;
42 struct msm_gem_address_space *aspace;
43 struct list_head list; /* node in msm_gem_object::vmas */
48 struct msm_gem_object {
49 struct drm_gem_object base;
54 * Advice: are the backing pages purgeable?
59 * count of active vmap'ing
63 /* And object is either:
64 * inactive - on priv->inactive_list
65 * active - on one one of the gpu's active_list.. well, at
66 * least for now we don't have (I don't think) hw sync between
67 * 2d and 3d one devices which have both, meaning we need to
68 * block on submit if a bo is already on other ring
71 struct list_head mm_list;
72 struct msm_gpu *gpu; /* non-null if active */
74 /* Transiently in the process of submit ioctl, objects associated
75 * with the submit are on submit->bo_list.. this only lasts for
76 * the duration of the ioctl, so one bo can never be on multiple
79 struct list_head submit_entry;
85 struct list_head vmas; /* list of msm_gem_vma */
87 struct llist_node freed;
89 /* For physically contiguous buffers. Used when we don't have
90 * an IOMMU. Also used for stolen/splashscreen buffer.
92 struct drm_mm_node *vram_node;
93 struct mutex lock; /* Protects resources associated with bo */
95 char name[32]; /* Identifier to print for the debugfs files */
97 #define to_msm_bo(x) container_of(x, struct msm_gem_object, base)
99 static inline bool is_active(struct msm_gem_object *msm_obj)
101 return msm_obj->gpu != NULL;
104 static inline bool is_purgeable(struct msm_gem_object *msm_obj)
106 WARN_ON(!mutex_is_locked(&msm_obj->base.dev->struct_mutex));
107 return (msm_obj->madv == MSM_MADV_DONTNEED) && msm_obj->sgt &&
108 !msm_obj->base.dma_buf && !msm_obj->base.import_attach;
111 static inline bool is_vunmapable(struct msm_gem_object *msm_obj)
113 return (msm_obj->vmap_count == 0) && msm_obj->vaddr;
116 /* The shrinker can be triggered while we hold objA->lock, and need
117 * to grab objB->lock to purge it. Lockdep just sees these as a single
118 * class of lock, so we use subclasses to teach it the difference.
120 * OBJ_LOCK_NORMAL is implicit (ie. normal mutex_lock() call), and
121 * OBJ_LOCK_SHRINKER is used by shrinker.
123 * It is *essential* that we never go down paths that could trigger the
124 * shrinker for a purgable object. This is ensured by checking that
125 * msm_obj->madv == MSM_MADV_WILLNEED.
132 void msm_gem_purge(struct drm_gem_object *obj, enum msm_gem_lock subclass);
133 void msm_gem_vunmap(struct drm_gem_object *obj, enum msm_gem_lock subclass);
134 void msm_gem_free_work(struct work_struct *work);
136 /* Created per submit-ioctl, to track bo's and cmdstream bufs, etc,
137 * associated with the cmdstream submission for synchronization (and
138 * make it easier to unwind when things go wrong, etc). This only
139 * lasts for the duration of the submit-ioctl.
141 struct msm_gem_submit {
142 struct drm_device *dev;
144 struct list_head node; /* node in ring submit list */
145 struct list_head bo_list;
146 struct ww_acquire_ctx ticket;
147 uint32_t seqno; /* Sequence number of the submit on the ring */
148 struct dma_fence *fence;
149 struct msm_gpu_submitqueue *queue;
150 struct pid *pid; /* submitting process */
151 bool valid; /* true if no cmdstream patching needed */
152 bool in_rb; /* "sudo" mode, copy cmds into RB */
153 struct msm_ringbuffer *ring;
154 unsigned int nr_cmds;
156 u32 ident; /* A "identifier" for the submit for logging */
159 uint32_t size; /* in dwords */
161 uint32_t idx; /* cmdstream buffer idx in bos[] */
162 } *cmd; /* array of size nr_cmds */
166 struct msm_gem_object *obj;
173 #endif /* __MSM_GEM_H__ */