1caab277bSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-only */ 2c8afe684SRob Clark /* 3c8afe684SRob Clark * Copyright (C) 2013 Red Hat 4c8afe684SRob Clark * Author: Rob Clark <robdclark@gmail.com> 5c8afe684SRob Clark */ 6c8afe684SRob Clark 7c8afe684SRob Clark #ifndef __MSM_GEM_H__ 8c8afe684SRob Clark #define __MSM_GEM_H__ 9c8afe684SRob Clark 10ee546cd3SJordan Crouse #include <linux/kref.h> 1152791eeeSChristian König #include <linux/dma-resv.h> 121d8a5ca4SRob Clark #include "drm/gpu_scheduler.h" 13c8afe684SRob Clark #include "msm_drv.h" 14c8afe684SRob Clark 1590643a24SRob Clark /* Make all GEM related WARN_ON()s ratelimited.. when things go wrong they 1690643a24SRob Clark * tend to go wrong 1000s of times in a short timespan. 1790643a24SRob Clark */ 1890643a24SRob Clark #define GEM_WARN_ON(x) WARN_RATELIMIT(x, "%s", __stringify(x)) 1990643a24SRob Clark 20072f1f91SRob Clark /* Additional internal-use only BO flags: */ 21072f1f91SRob Clark #define MSM_BO_STOLEN 0x10000000 /* try to use stolen/splash memory */ 220b462d7aSJonathan Marek #define MSM_BO_MAP_PRIV 0x20000000 /* use IOMMU_PRIV when mapping */ 23072f1f91SRob Clark 24667ce33eSRob Clark struct msm_gem_address_space { 25667ce33eSRob Clark const char *name; 26667ce33eSRob Clark /* NOTE: mm managed at the page level, size is in # of pages 27667ce33eSRob Clark * and position mm_node->start is in # of pages: 28667ce33eSRob Clark */ 29667ce33eSRob Clark struct drm_mm mm; 300e08270aSSushmita Susheelendra spinlock_t lock; /* Protects drm_mm node allocation/removal */ 31667ce33eSRob Clark struct msm_mmu *mmu; 32ee546cd3SJordan Crouse struct kref kref; 3325faf2f2SRob Clark 3425faf2f2SRob Clark /* For address spaces associated with a specific process, this 3525faf2f2SRob Clark * will be non-NULL: 3625faf2f2SRob Clark */ 3725faf2f2SRob Clark struct pid *pid; 38*bc211258SRob Clark 39*bc211258SRob Clark /* @faults: the number of GPU hangs associated with this address space */ 40*bc211258SRob Clark int faults; 41667ce33eSRob Clark }; 42667ce33eSRob Clark 43667ce33eSRob Clark struct msm_gem_vma { 44667ce33eSRob Clark struct drm_mm_node node; 45667ce33eSRob Clark uint64_t iova; 464b85f7f5SRob Clark struct msm_gem_address_space *aspace; 474b85f7f5SRob Clark struct list_head list; /* node in msm_gem_object::vmas */ 48c0ee9794SJordan Crouse bool mapped; 497ad0e8cfSJordan Crouse int inuse; 50667ce33eSRob Clark }; 51667ce33eSRob Clark 52c8afe684SRob Clark struct msm_gem_object { 53c8afe684SRob Clark struct drm_gem_object base; 54c8afe684SRob Clark 55c8afe684SRob Clark uint32_t flags; 56c8afe684SRob Clark 574cd33c48SRob Clark /** 584cd33c48SRob Clark * Advice: are the backing pages purgeable? 594cd33c48SRob Clark */ 604cd33c48SRob Clark uint8_t madv; 614cd33c48SRob Clark 62e1e9db2cSRob Clark /** 63cc8a4d5aSRob Clark * Is object on inactive_dontneed list (ie. counted in priv->shrinkable_count)? 64cc8a4d5aSRob Clark */ 65cc8a4d5aSRob Clark bool dontneed : 1; 66cc8a4d5aSRob Clark 67cc8a4d5aSRob Clark /** 6864fcbde7SRob Clark * Is object evictable (ie. counted in priv->evictable_count)? 6964fcbde7SRob Clark */ 7064fcbde7SRob Clark bool evictable : 1; 7164fcbde7SRob Clark 7264fcbde7SRob Clark /** 73e1e9db2cSRob Clark * count of active vmap'ing 74e1e9db2cSRob Clark */ 75e1e9db2cSRob Clark uint8_t vmap_count; 76e1e9db2cSRob Clark 77cc8a4d5aSRob Clark /** 786ed0897cSRob Clark * Node in list of all objects (mainly for debugfs, protected by 796ed0897cSRob Clark * priv->obj_lock 806ed0897cSRob Clark */ 816ed0897cSRob Clark struct list_head node; 826ed0897cSRob Clark 836ed0897cSRob Clark /** 84cc8a4d5aSRob Clark * An object is either: 856ed0897cSRob Clark * inactive - on priv->inactive_dontneed or priv->inactive_willneed 8664fcbde7SRob Clark * (depending on purgeability status) 877198e6b0SRob Clark * active - on one one of the gpu's active_list.. well, at 887198e6b0SRob Clark * least for now we don't have (I don't think) hw sync between 897198e6b0SRob Clark * 2d and 3d one devices which have both, meaning we need to 907198e6b0SRob Clark * block on submit if a bo is already on other ring 917198e6b0SRob Clark */ 92c8afe684SRob Clark struct list_head mm_list; 937198e6b0SRob Clark 94c8afe684SRob Clark struct page **pages; 95c8afe684SRob Clark struct sg_table *sgt; 96c8afe684SRob Clark void *vaddr; 97c8afe684SRob Clark 984b85f7f5SRob Clark struct list_head vmas; /* list of msm_gem_vma */ 997198e6b0SRob Clark 100871d812aSRob Clark /* For physically contiguous buffers. Used when we don't have 101072f1f91SRob Clark * an IOMMU. Also used for stolen/splashscreen buffer. 102871d812aSRob Clark */ 103871d812aSRob Clark struct drm_mm_node *vram_node; 1040815d774SJordan Crouse 1050815d774SJordan Crouse char name[32]; /* Identifier to print for the debugfs files */ 1069d8baa2bSAkhil P Oommen 107ab5c54cbSRob Clark int active_count; 10864fcbde7SRob Clark int pin_count; 109c8afe684SRob Clark }; 110c8afe684SRob Clark #define to_msm_bo(x) container_of(x, struct msm_gem_object, base) 111c8afe684SRob Clark 1128f642378SRob Clark uint64_t msm_gem_mmap_offset(struct drm_gem_object *obj); 1138f642378SRob Clark int msm_gem_get_iova(struct drm_gem_object *obj, 1148f642378SRob Clark struct msm_gem_address_space *aspace, uint64_t *iova); 1158f642378SRob Clark int msm_gem_get_and_pin_iova_range(struct drm_gem_object *obj, 1168f642378SRob Clark struct msm_gem_address_space *aspace, uint64_t *iova, 1178f642378SRob Clark u64 range_start, u64 range_end); 118e4b87d22SRob Clark int msm_gem_get_and_pin_iova_locked(struct drm_gem_object *obj, 119e4b87d22SRob Clark struct msm_gem_address_space *aspace, uint64_t *iova); 1208f642378SRob Clark int msm_gem_get_and_pin_iova(struct drm_gem_object *obj, 1218f642378SRob Clark struct msm_gem_address_space *aspace, uint64_t *iova); 1228f642378SRob Clark uint64_t msm_gem_iova(struct drm_gem_object *obj, 1238f642378SRob Clark struct msm_gem_address_space *aspace); 124e4b87d22SRob Clark void msm_gem_unpin_iova_locked(struct drm_gem_object *obj, 125e4b87d22SRob Clark struct msm_gem_address_space *aspace); 1268f642378SRob Clark void msm_gem_unpin_iova(struct drm_gem_object *obj, 1278f642378SRob Clark struct msm_gem_address_space *aspace); 1288f642378SRob Clark struct page **msm_gem_get_pages(struct drm_gem_object *obj); 1298f642378SRob Clark void msm_gem_put_pages(struct drm_gem_object *obj); 1308f642378SRob Clark int msm_gem_dumb_create(struct drm_file *file, struct drm_device *dev, 1318f642378SRob Clark struct drm_mode_create_dumb *args); 1328f642378SRob Clark int msm_gem_dumb_map_offset(struct drm_file *file, struct drm_device *dev, 1338f642378SRob Clark uint32_t handle, uint64_t *offset); 134e4b87d22SRob Clark void *msm_gem_get_vaddr_locked(struct drm_gem_object *obj); 1358f642378SRob Clark void *msm_gem_get_vaddr(struct drm_gem_object *obj); 1368f642378SRob Clark void *msm_gem_get_vaddr_active(struct drm_gem_object *obj); 137e4b87d22SRob Clark void msm_gem_put_vaddr_locked(struct drm_gem_object *obj); 1388f642378SRob Clark void msm_gem_put_vaddr(struct drm_gem_object *obj); 1398f642378SRob Clark int msm_gem_madvise(struct drm_gem_object *obj, unsigned madv); 1408f642378SRob Clark void msm_gem_active_get(struct drm_gem_object *obj, struct msm_gpu *gpu); 1418f642378SRob Clark void msm_gem_active_put(struct drm_gem_object *obj); 1428f642378SRob Clark int msm_gem_cpu_prep(struct drm_gem_object *obj, uint32_t op, ktime_t *timeout); 1438f642378SRob Clark int msm_gem_cpu_fini(struct drm_gem_object *obj); 1448f642378SRob Clark void msm_gem_free_object(struct drm_gem_object *obj); 1458f642378SRob Clark int msm_gem_new_handle(struct drm_device *dev, struct drm_file *file, 1468f642378SRob Clark uint32_t size, uint32_t flags, uint32_t *handle, char *name); 1478f642378SRob Clark struct drm_gem_object *msm_gem_new(struct drm_device *dev, 1488f642378SRob Clark uint32_t size, uint32_t flags); 1498f642378SRob Clark void *msm_gem_kernel_new(struct drm_device *dev, uint32_t size, 1508f642378SRob Clark uint32_t flags, struct msm_gem_address_space *aspace, 1518f642378SRob Clark struct drm_gem_object **bo, uint64_t *iova); 1528f642378SRob Clark void msm_gem_kernel_put(struct drm_gem_object *bo, 153030af2b0SRob Clark struct msm_gem_address_space *aspace); 1548f642378SRob Clark struct drm_gem_object *msm_gem_import(struct drm_device *dev, 1558f642378SRob Clark struct dma_buf *dmabuf, struct sg_table *sgt); 1568f642378SRob Clark __printf(2, 3) 1578f642378SRob Clark void msm_gem_object_set_name(struct drm_gem_object *bo, const char *fmt, ...); 158528107c8SRob Clark 159f48f3563SRob Clark #ifdef CONFIG_DEBUG_FS 160528107c8SRob Clark struct msm_gem_stats { 161528107c8SRob Clark struct { 162528107c8SRob Clark unsigned count; 163528107c8SRob Clark size_t size; 164f48f3563SRob Clark } all, active, resident, purgeable, purged; 165528107c8SRob Clark }; 166528107c8SRob Clark 167528107c8SRob Clark void msm_gem_describe(struct drm_gem_object *obj, struct seq_file *m, 168528107c8SRob Clark struct msm_gem_stats *stats); 1698f642378SRob Clark void msm_gem_describe_objects(struct list_head *list, struct seq_file *m); 1708f642378SRob Clark #endif 1718f642378SRob Clark 172a6ae74c9SRob Clark static inline void 173a6ae74c9SRob Clark msm_gem_lock(struct drm_gem_object *obj) 174a6ae74c9SRob Clark { 1756c0e3ea2SRob Clark dma_resv_lock(obj->resv, NULL); 176a6ae74c9SRob Clark } 177a6ae74c9SRob Clark 178599089c6SRob Clark static inline bool __must_check 179599089c6SRob Clark msm_gem_trylock(struct drm_gem_object *obj) 180599089c6SRob Clark { 1816c0e3ea2SRob Clark return dma_resv_trylock(obj->resv); 182599089c6SRob Clark } 183599089c6SRob Clark 184a6ae74c9SRob Clark static inline int 185a6ae74c9SRob Clark msm_gem_lock_interruptible(struct drm_gem_object *obj) 186a6ae74c9SRob Clark { 1876c0e3ea2SRob Clark return dma_resv_lock_interruptible(obj->resv, NULL); 188a6ae74c9SRob Clark } 189a6ae74c9SRob Clark 190a6ae74c9SRob Clark static inline void 191a6ae74c9SRob Clark msm_gem_unlock(struct drm_gem_object *obj) 192a6ae74c9SRob Clark { 1936c0e3ea2SRob Clark dma_resv_unlock(obj->resv); 194a6ae74c9SRob Clark } 195a6ae74c9SRob Clark 196a6ae74c9SRob Clark static inline bool 197a6ae74c9SRob Clark msm_gem_is_locked(struct drm_gem_object *obj) 198a6ae74c9SRob Clark { 1996c0e3ea2SRob Clark return dma_resv_is_locked(obj->resv); 200a6ae74c9SRob Clark } 201a6ae74c9SRob Clark 2027198e6b0SRob Clark static inline bool is_active(struct msm_gem_object *msm_obj) 2037198e6b0SRob Clark { 20490643a24SRob Clark GEM_WARN_ON(!msm_gem_is_locked(&msm_obj->base)); 205ab5c54cbSRob Clark return msm_obj->active_count; 2067198e6b0SRob Clark } 2077198e6b0SRob Clark 2080054eeb7SRob Clark /* imported/exported objects are not purgeable: */ 2090054eeb7SRob Clark static inline bool is_unpurgeable(struct msm_gem_object *msm_obj) 210cc8a4d5aSRob Clark { 21110f76165SRob Clark return msm_obj->base.import_attach || msm_obj->pin_count; 212cc8a4d5aSRob Clark } 213cc8a4d5aSRob Clark 21468209390SRob Clark static inline bool is_purgeable(struct msm_gem_object *msm_obj) 21568209390SRob Clark { 21668209390SRob Clark return (msm_obj->madv == MSM_MADV_DONTNEED) && msm_obj->sgt && 2170054eeb7SRob Clark !is_unpurgeable(msm_obj); 21868209390SRob Clark } 21968209390SRob Clark 220e1e9db2cSRob Clark static inline bool is_vunmapable(struct msm_gem_object *msm_obj) 221e1e9db2cSRob Clark { 22290643a24SRob Clark GEM_WARN_ON(!msm_gem_is_locked(&msm_obj->base)); 223e1e9db2cSRob Clark return (msm_obj->vmap_count == 0) && msm_obj->vaddr; 224e1e9db2cSRob Clark } 225e1e9db2cSRob Clark 2260054eeb7SRob Clark static inline void mark_purgeable(struct msm_gem_object *msm_obj) 227cc8a4d5aSRob Clark { 228cc8a4d5aSRob Clark struct msm_drm_private *priv = msm_obj->base.dev->dev_private; 229cc8a4d5aSRob Clark 23090643a24SRob Clark GEM_WARN_ON(!mutex_is_locked(&priv->mm_lock)); 231cc8a4d5aSRob Clark 2320054eeb7SRob Clark if (is_unpurgeable(msm_obj)) 233cc8a4d5aSRob Clark return; 234cc8a4d5aSRob Clark 23590643a24SRob Clark if (GEM_WARN_ON(msm_obj->dontneed)) 236cc8a4d5aSRob Clark return; 237cc8a4d5aSRob Clark 238cc8a4d5aSRob Clark priv->shrinkable_count += msm_obj->base.size >> PAGE_SHIFT; 239cc8a4d5aSRob Clark msm_obj->dontneed = true; 240cc8a4d5aSRob Clark } 241cc8a4d5aSRob Clark 2420054eeb7SRob Clark static inline void mark_unpurgeable(struct msm_gem_object *msm_obj) 243cc8a4d5aSRob Clark { 244cc8a4d5aSRob Clark struct msm_drm_private *priv = msm_obj->base.dev->dev_private; 245cc8a4d5aSRob Clark 24690643a24SRob Clark GEM_WARN_ON(!mutex_is_locked(&priv->mm_lock)); 247cc8a4d5aSRob Clark 2480054eeb7SRob Clark if (is_unpurgeable(msm_obj)) 249cc8a4d5aSRob Clark return; 250cc8a4d5aSRob Clark 25190643a24SRob Clark if (GEM_WARN_ON(!msm_obj->dontneed)) 252cc8a4d5aSRob Clark return; 253cc8a4d5aSRob Clark 254cc8a4d5aSRob Clark priv->shrinkable_count -= msm_obj->base.size >> PAGE_SHIFT; 25590643a24SRob Clark GEM_WARN_ON(priv->shrinkable_count < 0); 256cc8a4d5aSRob Clark msm_obj->dontneed = false; 257cc8a4d5aSRob Clark } 258cc8a4d5aSRob Clark 25964fcbde7SRob Clark static inline bool is_unevictable(struct msm_gem_object *msm_obj) 26064fcbde7SRob Clark { 26110f76165SRob Clark return is_unpurgeable(msm_obj) || msm_obj->vaddr; 26264fcbde7SRob Clark } 26364fcbde7SRob Clark 26464fcbde7SRob Clark static inline void mark_evictable(struct msm_gem_object *msm_obj) 26564fcbde7SRob Clark { 26664fcbde7SRob Clark struct msm_drm_private *priv = msm_obj->base.dev->dev_private; 26764fcbde7SRob Clark 26864fcbde7SRob Clark WARN_ON(!mutex_is_locked(&priv->mm_lock)); 26964fcbde7SRob Clark 27064fcbde7SRob Clark if (is_unevictable(msm_obj)) 27164fcbde7SRob Clark return; 27264fcbde7SRob Clark 27364fcbde7SRob Clark if (WARN_ON(msm_obj->evictable)) 27464fcbde7SRob Clark return; 27564fcbde7SRob Clark 27664fcbde7SRob Clark priv->evictable_count += msm_obj->base.size >> PAGE_SHIFT; 27764fcbde7SRob Clark msm_obj->evictable = true; 27864fcbde7SRob Clark } 27964fcbde7SRob Clark 28064fcbde7SRob Clark static inline void mark_unevictable(struct msm_gem_object *msm_obj) 28164fcbde7SRob Clark { 28264fcbde7SRob Clark struct msm_drm_private *priv = msm_obj->base.dev->dev_private; 28364fcbde7SRob Clark 28464fcbde7SRob Clark WARN_ON(!mutex_is_locked(&priv->mm_lock)); 28564fcbde7SRob Clark 28664fcbde7SRob Clark if (is_unevictable(msm_obj)) 28764fcbde7SRob Clark return; 28864fcbde7SRob Clark 28964fcbde7SRob Clark if (WARN_ON(!msm_obj->evictable)) 29064fcbde7SRob Clark return; 29164fcbde7SRob Clark 29264fcbde7SRob Clark priv->evictable_count -= msm_obj->base.size >> PAGE_SHIFT; 29364fcbde7SRob Clark WARN_ON(priv->evictable_count < 0); 29464fcbde7SRob Clark msm_obj->evictable = false; 29564fcbde7SRob Clark } 29664fcbde7SRob Clark 297599089c6SRob Clark void msm_gem_purge(struct drm_gem_object *obj); 29864fcbde7SRob Clark void msm_gem_evict(struct drm_gem_object *obj); 299599089c6SRob Clark void msm_gem_vunmap(struct drm_gem_object *obj); 3000e08270aSSushmita Susheelendra 3017198e6b0SRob Clark /* Created per submit-ioctl, to track bo's and cmdstream bufs, etc, 3027198e6b0SRob Clark * associated with the cmdstream submission for synchronization (and 303375f9a63SRob Clark * make it easier to unwind when things go wrong, etc). 3047198e6b0SRob Clark */ 3057198e6b0SRob Clark struct msm_gem_submit { 3061d8a5ca4SRob Clark struct drm_sched_job base; 307964d2f97SRob Clark struct kref ref; 3087198e6b0SRob Clark struct drm_device *dev; 3097198e6b0SRob Clark struct msm_gpu *gpu; 310295b22aeSJordan Crouse struct msm_gem_address_space *aspace; 311f97decacSJordan Crouse struct list_head node; /* node in ring submit list */ 3127198e6b0SRob Clark struct ww_acquire_ctx ticket; 313f97decacSJordan Crouse uint32_t seqno; /* Sequence number of the submit on the ring */ 3141d8a5ca4SRob Clark 3151d8a5ca4SRob Clark /* Hw fence, which is created when the scheduler executes the job, and 3161d8a5ca4SRob Clark * is signaled when the hw finishes (via seqno write from cmdstream) 3171d8a5ca4SRob Clark */ 3181d8a5ca4SRob Clark struct dma_fence *hw_fence; 3191d8a5ca4SRob Clark 3201d8a5ca4SRob Clark /* Userspace visible fence, which is signaled by the scheduler after 3211d8a5ca4SRob Clark * the hw_fence is signaled. 3221d8a5ca4SRob Clark */ 3231d8a5ca4SRob Clark struct dma_fence *user_fence; 3241d8a5ca4SRob Clark 325a61acbbeSRob Clark int fence_id; /* key into queue->fence_idr */ 326f7de1545SJordan Crouse struct msm_gpu_submitqueue *queue; 3274816b626SRob Clark struct pid *pid; /* submitting process */ 328e25e92e0SRob Clark bool fault_dumped; /* Limit devcoredump dumping to one per submit */ 329340faef2SRob Clark bool valid; /* true if no cmdstream patching needed */ 3306a8bd08dSRob Clark bool in_rb; /* "sudo" mode, copy cmds into RB */ 331f97decacSJordan Crouse struct msm_ringbuffer *ring; 332cf655d61SJordan Crouse struct msm_file_private *ctx; 3337198e6b0SRob Clark unsigned int nr_cmds; 3347198e6b0SRob Clark unsigned int nr_bos; 3354241db42SJordan Crouse u32 ident; /* A "identifier" for the submit for logging */ 3367198e6b0SRob Clark struct { 3377198e6b0SRob Clark uint32_t type; 3387198e6b0SRob Clark uint32_t size; /* in dwords */ 33978babc16SRob Clark uint64_t iova; 34020224d71SRob Clark uint32_t offset;/* in dwords */ 341a7d3c950SRob Clark uint32_t idx; /* cmdstream buffer idx in bos[] */ 34220224d71SRob Clark uint32_t nr_relocs; 34320224d71SRob Clark struct drm_msm_gem_submit_reloc *relocs; 3446b597ce2SRob Clark } *cmd; /* array of size nr_cmds */ 3457198e6b0SRob Clark struct { 3467198e6b0SRob Clark uint32_t flags; 347b673499aSKristian H. Kristensen union { 3487198e6b0SRob Clark struct msm_gem_object *obj; 349b673499aSKristian H. Kristensen uint32_t handle; 350b673499aSKristian H. Kristensen }; 35178babc16SRob Clark uint64_t iova; 3524c145df1SGustavo A. R. Silva } bos[]; 3537198e6b0SRob Clark }; 3547198e6b0SRob Clark 3551d8a5ca4SRob Clark static inline struct msm_gem_submit *to_msm_submit(struct drm_sched_job *job) 3561d8a5ca4SRob Clark { 3571d8a5ca4SRob Clark return container_of(job, struct msm_gem_submit, base); 3581d8a5ca4SRob Clark } 3591d8a5ca4SRob Clark 360964d2f97SRob Clark void __msm_gem_submit_destroy(struct kref *kref); 361964d2f97SRob Clark 362964d2f97SRob Clark static inline void msm_gem_submit_get(struct msm_gem_submit *submit) 363964d2f97SRob Clark { 364964d2f97SRob Clark kref_get(&submit->ref); 365964d2f97SRob Clark } 366964d2f97SRob Clark 367964d2f97SRob Clark static inline void msm_gem_submit_put(struct msm_gem_submit *submit) 368964d2f97SRob Clark { 369964d2f97SRob Clark kref_put(&submit->ref, __msm_gem_submit_destroy); 370964d2f97SRob Clark } 371964d2f97SRob Clark 372be40596bSRob Clark void msm_submit_retire(struct msm_gem_submit *submit); 373be40596bSRob Clark 374e515af8dSRob Clark /* helper to determine of a buffer in submit should be dumped, used for both 375e515af8dSRob Clark * devcoredump and debugfs cmdstream dumping: 376e515af8dSRob Clark */ 377e515af8dSRob Clark static inline bool 378e515af8dSRob Clark should_dump(struct msm_gem_submit *submit, int idx) 379e515af8dSRob Clark { 380e515af8dSRob Clark extern bool rd_full; 381e515af8dSRob Clark return rd_full || (submit->bos[idx].flags & MSM_SUBMIT_BO_DUMP); 382e515af8dSRob Clark } 383e515af8dSRob Clark 384c8afe684SRob Clark #endif /* __MSM_GEM_H__ */ 385