Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v4.17
  1/*
  2 * Copyright 2008 Advanced Micro Devices, Inc.
  3 * Copyright 2008 Red Hat Inc.
  4 * Copyright 2009 Jerome Glisse.
  5 *
  6 * Permission is hereby granted, free of charge, to any person obtaining a
  7 * copy of this software and associated documentation files (the "Software"),
  8 * to deal in the Software without restriction, including without limitation
  9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 10 * and/or sell copies of the Software, and to permit persons to whom the
 11 * Software is furnished to do so, subject to the following conditions:
 12 *
 13 * The above copyright notice and this permission notice shall be included in
 14 * all copies or substantial portions of the Software.
 15 *
 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 19 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 22 * OTHER DEALINGS IN THE SOFTWARE.
 23 *
 24 * Authors: Dave Airlie
 25 *          Alex Deucher
 26 *          Jerome Glisse
 27 */
 28#ifndef __AMDGPU_OBJECT_H__
 29#define __AMDGPU_OBJECT_H__
 30
 31#include <drm/amdgpu_drm.h>
 32#include "amdgpu.h"
 
 
 
 
 
 33
 34#define AMDGPU_BO_INVALID_OFFSET	LONG_MAX
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 35
 36/* bo virtual addresses in a vm */
 37struct amdgpu_bo_va_mapping {
 38	struct amdgpu_bo_va		*bo_va;
 39	struct list_head		list;
 40	struct rb_node			rb;
 41	uint64_t			start;
 42	uint64_t			last;
 43	uint64_t			__subtree_last;
 44	uint64_t			offset;
 45	uint64_t			flags;
 46};
 47
 48/* User space allocated BO in a VM */
 49struct amdgpu_bo_va {
 50	struct amdgpu_vm_bo_base	base;
 51
 52	/* protected by bo being reserved */
 53	unsigned			ref_count;
 54
 55	/* all other members protected by the VM PD being reserved */
 56	struct dma_fence	        *last_pt_update;
 57
 58	/* mappings for this bo_va */
 59	struct list_head		invalids;
 60	struct list_head		valids;
 61
 62	/* If the mappings are cleared or filled */
 63	bool				cleared;
 
 
 64};
 65
 66struct amdgpu_bo {
 67	/* Protected by tbo.reserved */
 68	u32				preferred_domains;
 69	u32				allowed_domains;
 70	struct ttm_place		placements[AMDGPU_GEM_DOMAIN_MAX + 1];
 71	struct ttm_placement		placement;
 72	struct ttm_buffer_object	tbo;
 73	struct ttm_bo_kmap_obj		kmap;
 74	u64				flags;
 75	unsigned			pin_count;
 76	u64				tiling_flags;
 77	u64				metadata_flags;
 78	void				*metadata;
 79	u32				metadata_size;
 80	unsigned			prime_shared_count;
 81	/* list of all virtual address to which this bo is associated to */
 82	struct list_head		va;
 83	/* Constant after initialization */
 84	struct drm_gem_object		gem_base;
 85	struct amdgpu_bo		*parent;
 86	struct amdgpu_bo		*shadow;
 87
 88	struct ttm_bo_kmap_obj		dma_buf_vmap;
 89	struct amdgpu_mn		*mn;
 
 
 
 90
 91	union {
 92		struct list_head	mn_list;
 93		struct list_head	shadow_list;
 94	};
 
 
 95
 96	struct kgd_mem                  *kfd_bo;
 
 
 
 
 
 
 97};
 98
 99static inline struct amdgpu_bo *ttm_to_amdgpu_bo(struct ttm_buffer_object *tbo)
100{
101	return container_of(tbo, struct amdgpu_bo, tbo);
102}
103
104/**
105 * amdgpu_mem_type_to_domain - return domain corresponding to mem_type
106 * @mem_type:	ttm memory type
107 *
108 * Returns corresponding domain of the ttm mem_type
109 */
110static inline unsigned amdgpu_mem_type_to_domain(u32 mem_type)
111{
112	switch (mem_type) {
113	case TTM_PL_VRAM:
114		return AMDGPU_GEM_DOMAIN_VRAM;
115	case TTM_PL_TT:
116		return AMDGPU_GEM_DOMAIN_GTT;
117	case TTM_PL_SYSTEM:
118		return AMDGPU_GEM_DOMAIN_CPU;
119	case AMDGPU_PL_GDS:
120		return AMDGPU_GEM_DOMAIN_GDS;
121	case AMDGPU_PL_GWS:
122		return AMDGPU_GEM_DOMAIN_GWS;
123	case AMDGPU_PL_OA:
124		return AMDGPU_GEM_DOMAIN_OA;
125	default:
126		break;
127	}
128	return 0;
129}
130
131/**
132 * amdgpu_bo_reserve - reserve bo
133 * @bo:		bo structure
134 * @no_intr:	don't return -ERESTARTSYS on pending signal
135 *
136 * Returns:
137 * -ERESTARTSYS: A wait for the buffer to become unreserved was interrupted by
138 * a signal. Release all buffer reservations and return to user-space.
139 */
140static inline int amdgpu_bo_reserve(struct amdgpu_bo *bo, bool no_intr)
141{
142	struct amdgpu_device *adev = amdgpu_ttm_adev(bo->tbo.bdev);
143	int r;
144
145	r = ttm_bo_reserve(&bo->tbo, !no_intr, false, NULL);
146	if (unlikely(r != 0)) {
147		if (r != -ERESTARTSYS)
148			dev_err(adev->dev, "%p reserve failed\n", bo);
149		return r;
150	}
151	return 0;
152}
153
154static inline void amdgpu_bo_unreserve(struct amdgpu_bo *bo)
155{
156	ttm_bo_unreserve(&bo->tbo);
157}
158
159static inline unsigned long amdgpu_bo_size(struct amdgpu_bo *bo)
160{
161	return bo->tbo.num_pages << PAGE_SHIFT;
162}
163
164static inline unsigned amdgpu_bo_ngpu_pages(struct amdgpu_bo *bo)
165{
166	return (bo->tbo.num_pages << PAGE_SHIFT) / AMDGPU_GPU_PAGE_SIZE;
167}
168
169static inline unsigned amdgpu_bo_gpu_page_alignment(struct amdgpu_bo *bo)
170{
171	return (bo->tbo.mem.page_alignment << PAGE_SHIFT) / AMDGPU_GPU_PAGE_SIZE;
172}
173
174/**
175 * amdgpu_bo_mmap_offset - return mmap offset of bo
176 * @bo:	amdgpu object for which we query the offset
177 *
178 * Returns mmap offset of the object.
179 */
180static inline u64 amdgpu_bo_mmap_offset(struct amdgpu_bo *bo)
181{
182	return drm_vma_node_offset_addr(&bo->tbo.vma_node);
183}
184
185/**
186 * amdgpu_bo_gpu_accessible - return whether the bo is currently in memory that
187 * is accessible to the GPU.
188 */
189static inline bool amdgpu_bo_gpu_accessible(struct amdgpu_bo *bo)
190{
191	switch (bo->tbo.mem.mem_type) {
192	case TTM_PL_TT: return amdgpu_gtt_mgr_has_gart_addr(&bo->tbo.mem);
193	case TTM_PL_VRAM: return true;
194	default: return false;
 
 
 
 
 
 
 
 
195	}
 
 
196}
197
198/**
199 * amdgpu_bo_explicit_sync - return whether the bo is explicitly synced
200 */
201static inline bool amdgpu_bo_explicit_sync(struct amdgpu_bo *bo)
202{
203	return bo->flags & AMDGPU_GEM_CREATE_EXPLICIT_SYNC;
204}
205
206int amdgpu_bo_create(struct amdgpu_device *adev, unsigned long size,
207		     int byte_align, u32 domain,
208		     u64 flags, enum ttm_bo_type type,
209		     struct reservation_object *resv,
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
210		     struct amdgpu_bo **bo_ptr);
211int amdgpu_bo_create_reserved(struct amdgpu_device *adev,
212			      unsigned long size, int align,
213			      u32 domain, struct amdgpu_bo **bo_ptr,
214			      u64 *gpu_addr, void **cpu_addr);
215int amdgpu_bo_create_kernel(struct amdgpu_device *adev,
216			    unsigned long size, int align,
217			    u32 domain, struct amdgpu_bo **bo_ptr,
218			    u64 *gpu_addr, void **cpu_addr);
 
 
 
 
 
 
 
 
 
219void amdgpu_bo_free_kernel(struct amdgpu_bo **bo, u64 *gpu_addr,
220			   void **cpu_addr);
221int amdgpu_bo_kmap(struct amdgpu_bo *bo, void **ptr);
222void *amdgpu_bo_kptr(struct amdgpu_bo *bo);
223void amdgpu_bo_kunmap(struct amdgpu_bo *bo);
224struct amdgpu_bo *amdgpu_bo_ref(struct amdgpu_bo *bo);
225void amdgpu_bo_unref(struct amdgpu_bo **bo);
226int amdgpu_bo_pin(struct amdgpu_bo *bo, u32 domain, u64 *gpu_addr);
227int amdgpu_bo_pin_restricted(struct amdgpu_bo *bo, u32 domain,
228			     u64 min_offset, u64 max_offset,
229			     u64 *gpu_addr);
230int amdgpu_bo_unpin(struct amdgpu_bo *bo);
231int amdgpu_bo_evict_vram(struct amdgpu_device *adev);
232int amdgpu_bo_init(struct amdgpu_device *adev);
233void amdgpu_bo_fini(struct amdgpu_device *adev);
234int amdgpu_bo_fbdev_mmap(struct amdgpu_bo *bo,
235				struct vm_area_struct *vma);
236int amdgpu_bo_set_tiling_flags(struct amdgpu_bo *bo, u64 tiling_flags);
237void amdgpu_bo_get_tiling_flags(struct amdgpu_bo *bo, u64 *tiling_flags);
238int amdgpu_bo_set_metadata (struct amdgpu_bo *bo, void *metadata,
239			    uint32_t metadata_size, uint64_t flags);
240int amdgpu_bo_get_metadata(struct amdgpu_bo *bo, void *buffer,
241			   size_t buffer_size, uint32_t *metadata_size,
242			   uint64_t *flags);
243void amdgpu_bo_move_notify(struct ttm_buffer_object *bo,
244			   bool evict,
245			   struct ttm_mem_reg *new_mem);
246int amdgpu_bo_fault_reserve_notify(struct ttm_buffer_object *bo);
 
247void amdgpu_bo_fence(struct amdgpu_bo *bo, struct dma_fence *fence,
248		     bool shared);
 
 
 
 
249u64 amdgpu_bo_gpu_offset(struct amdgpu_bo *bo);
250int amdgpu_bo_backup_to_shadow(struct amdgpu_device *adev,
251			       struct amdgpu_ring *ring,
252			       struct amdgpu_bo *bo,
253			       struct reservation_object *resv,
254			       struct dma_fence **fence, bool direct);
255int amdgpu_bo_validate(struct amdgpu_bo *bo);
256int amdgpu_bo_restore_from_shadow(struct amdgpu_device *adev,
257				  struct amdgpu_ring *ring,
258				  struct amdgpu_bo *bo,
259				  struct reservation_object *resv,
260				  struct dma_fence **fence,
261				  bool direct);
262
263
264/*
265 * sub allocation
266 */
267
268static inline uint64_t amdgpu_sa_bo_gpu_addr(struct amdgpu_sa_bo *sa_bo)
269{
270	return sa_bo->manager->gpu_addr + sa_bo->soffset;
271}
272
273static inline void * amdgpu_sa_bo_cpu_addr(struct amdgpu_sa_bo *sa_bo)
274{
275	return sa_bo->manager->cpu_ptr + sa_bo->soffset;
276}
277
278int amdgpu_sa_bo_manager_init(struct amdgpu_device *adev,
279				     struct amdgpu_sa_manager *sa_manager,
280				     unsigned size, u32 align, u32 domain);
281void amdgpu_sa_bo_manager_fini(struct amdgpu_device *adev,
282				      struct amdgpu_sa_manager *sa_manager);
283int amdgpu_sa_bo_manager_start(struct amdgpu_device *adev,
284				      struct amdgpu_sa_manager *sa_manager);
285int amdgpu_sa_bo_new(struct amdgpu_sa_manager *sa_manager,
286		     struct amdgpu_sa_bo **sa_bo,
287		     unsigned size, unsigned align);
288void amdgpu_sa_bo_free(struct amdgpu_device *adev,
289			      struct amdgpu_sa_bo **sa_bo,
290			      struct dma_fence *fence);
291#if defined(CONFIG_DEBUG_FS)
292void amdgpu_sa_bo_dump_debug_info(struct amdgpu_sa_manager *sa_manager,
293					 struct seq_file *m);
 
294#endif
 
 
 
295
296
297#endif
v5.14.15
  1/*
  2 * Copyright 2008 Advanced Micro Devices, Inc.
  3 * Copyright 2008 Red Hat Inc.
  4 * Copyright 2009 Jerome Glisse.
  5 *
  6 * Permission is hereby granted, free of charge, to any person obtaining a
  7 * copy of this software and associated documentation files (the "Software"),
  8 * to deal in the Software without restriction, including without limitation
  9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 10 * and/or sell copies of the Software, and to permit persons to whom the
 11 * Software is furnished to do so, subject to the following conditions:
 12 *
 13 * The above copyright notice and this permission notice shall be included in
 14 * all copies or substantial portions of the Software.
 15 *
 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 19 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 22 * OTHER DEALINGS IN THE SOFTWARE.
 23 *
 24 * Authors: Dave Airlie
 25 *          Alex Deucher
 26 *          Jerome Glisse
 27 */
 28#ifndef __AMDGPU_OBJECT_H__
 29#define __AMDGPU_OBJECT_H__
 30
 31#include <drm/amdgpu_drm.h>
 32#include "amdgpu.h"
 33#include "amdgpu_res_cursor.h"
 34
 35#ifdef CONFIG_MMU_NOTIFIER
 36#include <linux/mmu_notifier.h>
 37#endif
 38
 39#define AMDGPU_BO_INVALID_OFFSET	LONG_MAX
 40#define AMDGPU_BO_MAX_PLACEMENTS	3
 41
 42/* BO flag to indicate a KFD userptr BO */
 43#define AMDGPU_AMDKFD_CREATE_USERPTR_BO	(1ULL << 63)
 44#define AMDGPU_AMDKFD_CREATE_SVM_BO	(1ULL << 62)
 45
 46#define to_amdgpu_bo_user(abo) container_of((abo), struct amdgpu_bo_user, bo)
 47#define to_amdgpu_bo_vm(abo) container_of((abo), struct amdgpu_bo_vm, bo)
 48
 49struct amdgpu_bo_param {
 50	unsigned long			size;
 51	int				byte_align;
 52	u32				bo_ptr_size;
 53	u32				domain;
 54	u32				preferred_domain;
 55	u64				flags;
 56	enum ttm_bo_type		type;
 57	bool				no_wait_gpu;
 58	struct dma_resv			*resv;
 59	void				(*destroy)(struct ttm_buffer_object *bo);
 60};
 61
 62/* bo virtual addresses in a vm */
 63struct amdgpu_bo_va_mapping {
 64	struct amdgpu_bo_va		*bo_va;
 65	struct list_head		list;
 66	struct rb_node			rb;
 67	uint64_t			start;
 68	uint64_t			last;
 69	uint64_t			__subtree_last;
 70	uint64_t			offset;
 71	uint64_t			flags;
 72};
 73
 74/* User space allocated BO in a VM */
 75struct amdgpu_bo_va {
 76	struct amdgpu_vm_bo_base	base;
 77
 78	/* protected by bo being reserved */
 79	unsigned			ref_count;
 80
 81	/* all other members protected by the VM PD being reserved */
 82	struct dma_fence	        *last_pt_update;
 83
 84	/* mappings for this bo_va */
 85	struct list_head		invalids;
 86	struct list_head		valids;
 87
 88	/* If the mappings are cleared or filled */
 89	bool				cleared;
 90
 91	bool				is_xgmi;
 92};
 93
 94struct amdgpu_bo {
 95	/* Protected by tbo.reserved */
 96	u32				preferred_domains;
 97	u32				allowed_domains;
 98	struct ttm_place		placements[AMDGPU_BO_MAX_PLACEMENTS];
 99	struct ttm_placement		placement;
100	struct ttm_buffer_object	tbo;
101	struct ttm_bo_kmap_obj		kmap;
102	u64				flags;
 
 
 
 
 
103	unsigned			prime_shared_count;
104	/* per VM structure for page tables and with virtual addresses */
105	struct amdgpu_vm_bo_base	*vm_bo;
106	/* Constant after initialization */
 
107	struct amdgpu_bo		*parent;
 
108
109#ifdef CONFIG_MMU_NOTIFIER
110	struct mmu_interval_notifier	notifier;
111#endif
112	struct kgd_mem                  *kfd_bo;
113};
114
115struct amdgpu_bo_user {
116	struct amdgpu_bo		bo;
117	u64				tiling_flags;
118	u64				metadata_flags;
119	void				*metadata;
120	u32				metadata_size;
121
122};
123
124struct amdgpu_bo_vm {
125	struct amdgpu_bo		bo;
126	struct amdgpu_bo		*shadow;
127	struct list_head		shadow_list;
128	struct amdgpu_vm_bo_base        entries[];
129};
130
131static inline struct amdgpu_bo *ttm_to_amdgpu_bo(struct ttm_buffer_object *tbo)
132{
133	return container_of(tbo, struct amdgpu_bo, tbo);
134}
135
136/**
137 * amdgpu_mem_type_to_domain - return domain corresponding to mem_type
138 * @mem_type:	ttm memory type
139 *
140 * Returns corresponding domain of the ttm mem_type
141 */
142static inline unsigned amdgpu_mem_type_to_domain(u32 mem_type)
143{
144	switch (mem_type) {
145	case TTM_PL_VRAM:
146		return AMDGPU_GEM_DOMAIN_VRAM;
147	case TTM_PL_TT:
148		return AMDGPU_GEM_DOMAIN_GTT;
149	case TTM_PL_SYSTEM:
150		return AMDGPU_GEM_DOMAIN_CPU;
151	case AMDGPU_PL_GDS:
152		return AMDGPU_GEM_DOMAIN_GDS;
153	case AMDGPU_PL_GWS:
154		return AMDGPU_GEM_DOMAIN_GWS;
155	case AMDGPU_PL_OA:
156		return AMDGPU_GEM_DOMAIN_OA;
157	default:
158		break;
159	}
160	return 0;
161}
162
163/**
164 * amdgpu_bo_reserve - reserve bo
165 * @bo:		bo structure
166 * @no_intr:	don't return -ERESTARTSYS on pending signal
167 *
168 * Returns:
169 * -ERESTARTSYS: A wait for the buffer to become unreserved was interrupted by
170 * a signal. Release all buffer reservations and return to user-space.
171 */
172static inline int amdgpu_bo_reserve(struct amdgpu_bo *bo, bool no_intr)
173{
174	struct amdgpu_device *adev = amdgpu_ttm_adev(bo->tbo.bdev);
175	int r;
176
177	r = ttm_bo_reserve(&bo->tbo, !no_intr, false, NULL);
178	if (unlikely(r != 0)) {
179		if (r != -ERESTARTSYS)
180			dev_err(adev->dev, "%p reserve failed\n", bo);
181		return r;
182	}
183	return 0;
184}
185
186static inline void amdgpu_bo_unreserve(struct amdgpu_bo *bo)
187{
188	ttm_bo_unreserve(&bo->tbo);
189}
190
191static inline unsigned long amdgpu_bo_size(struct amdgpu_bo *bo)
192{
193	return bo->tbo.base.size;
194}
195
196static inline unsigned amdgpu_bo_ngpu_pages(struct amdgpu_bo *bo)
197{
198	return bo->tbo.base.size / AMDGPU_GPU_PAGE_SIZE;
199}
200
201static inline unsigned amdgpu_bo_gpu_page_alignment(struct amdgpu_bo *bo)
202{
203	return (bo->tbo.page_alignment << PAGE_SHIFT) / AMDGPU_GPU_PAGE_SIZE;
204}
205
206/**
207 * amdgpu_bo_mmap_offset - return mmap offset of bo
208 * @bo:	amdgpu object for which we query the offset
209 *
210 * Returns mmap offset of the object.
211 */
212static inline u64 amdgpu_bo_mmap_offset(struct amdgpu_bo *bo)
213{
214	return drm_vma_node_offset_addr(&bo->tbo.base.vma_node);
215}
216
217/**
218 * amdgpu_bo_in_cpu_visible_vram - check if BO is (partly) in visible VRAM
 
219 */
220static inline bool amdgpu_bo_in_cpu_visible_vram(struct amdgpu_bo *bo)
221{
222	struct amdgpu_device *adev = amdgpu_ttm_adev(bo->tbo.bdev);
223	struct amdgpu_res_cursor cursor;
224
225	if (bo->tbo.resource->mem_type != TTM_PL_VRAM)
226		return false;
227
228	amdgpu_res_first(bo->tbo.resource, 0, amdgpu_bo_size(bo), &cursor);
229	while (cursor.remaining) {
230		if (cursor.start < adev->gmc.visible_vram_size)
231			return true;
232
233		amdgpu_res_next(&cursor, cursor.size);
234	}
235
236	return false;
237}
238
239/**
240 * amdgpu_bo_explicit_sync - return whether the bo is explicitly synced
241 */
242static inline bool amdgpu_bo_explicit_sync(struct amdgpu_bo *bo)
243{
244	return bo->flags & AMDGPU_GEM_CREATE_EXPLICIT_SYNC;
245}
246
247/**
248 * amdgpu_bo_encrypted - test if the BO is encrypted
249 * @bo: pointer to a buffer object
250 *
251 * Return true if the buffer object is encrypted, false otherwise.
252 */
253static inline bool amdgpu_bo_encrypted(struct amdgpu_bo *bo)
254{
255	return bo->flags & AMDGPU_GEM_CREATE_ENCRYPTED;
256}
257
258/**
259 * amdgpu_bo_shadowed - check if the BO is shadowed
260 *
261 * @bo: BO to be tested.
262 *
263 * Returns:
264 * NULL if not shadowed or else return a BO pointer.
265 */
266static inline struct amdgpu_bo *amdgpu_bo_shadowed(struct amdgpu_bo *bo)
267{
268	if (bo->tbo.type == ttm_bo_type_kernel)
269		return to_amdgpu_bo_vm(bo)->shadow;
270
271	return NULL;
272}
273
274bool amdgpu_bo_is_amdgpu_bo(struct ttm_buffer_object *bo);
275void amdgpu_bo_placement_from_domain(struct amdgpu_bo *abo, u32 domain);
276
277int amdgpu_bo_create(struct amdgpu_device *adev,
278		     struct amdgpu_bo_param *bp,
279		     struct amdgpu_bo **bo_ptr);
280int amdgpu_bo_create_reserved(struct amdgpu_device *adev,
281			      unsigned long size, int align,
282			      u32 domain, struct amdgpu_bo **bo_ptr,
283			      u64 *gpu_addr, void **cpu_addr);
284int amdgpu_bo_create_kernel(struct amdgpu_device *adev,
285			    unsigned long size, int align,
286			    u32 domain, struct amdgpu_bo **bo_ptr,
287			    u64 *gpu_addr, void **cpu_addr);
288int amdgpu_bo_create_kernel_at(struct amdgpu_device *adev,
289			       uint64_t offset, uint64_t size, uint32_t domain,
290			       struct amdgpu_bo **bo_ptr, void **cpu_addr);
291int amdgpu_bo_create_user(struct amdgpu_device *adev,
292			  struct amdgpu_bo_param *bp,
293			  struct amdgpu_bo_user **ubo_ptr);
294int amdgpu_bo_create_vm(struct amdgpu_device *adev,
295			struct amdgpu_bo_param *bp,
296			struct amdgpu_bo_vm **ubo_ptr);
297void amdgpu_bo_free_kernel(struct amdgpu_bo **bo, u64 *gpu_addr,
298			   void **cpu_addr);
299int amdgpu_bo_kmap(struct amdgpu_bo *bo, void **ptr);
300void *amdgpu_bo_kptr(struct amdgpu_bo *bo);
301void amdgpu_bo_kunmap(struct amdgpu_bo *bo);
302struct amdgpu_bo *amdgpu_bo_ref(struct amdgpu_bo *bo);
303void amdgpu_bo_unref(struct amdgpu_bo **bo);
304int amdgpu_bo_pin(struct amdgpu_bo *bo, u32 domain);
305int amdgpu_bo_pin_restricted(struct amdgpu_bo *bo, u32 domain,
306			     u64 min_offset, u64 max_offset);
307void amdgpu_bo_unpin(struct amdgpu_bo *bo);
 
308int amdgpu_bo_evict_vram(struct amdgpu_device *adev);
309int amdgpu_bo_init(struct amdgpu_device *adev);
310void amdgpu_bo_fini(struct amdgpu_device *adev);
 
 
311int amdgpu_bo_set_tiling_flags(struct amdgpu_bo *bo, u64 tiling_flags);
312void amdgpu_bo_get_tiling_flags(struct amdgpu_bo *bo, u64 *tiling_flags);
313int amdgpu_bo_set_metadata (struct amdgpu_bo *bo, void *metadata,
314			    uint32_t metadata_size, uint64_t flags);
315int amdgpu_bo_get_metadata(struct amdgpu_bo *bo, void *buffer,
316			   size_t buffer_size, uint32_t *metadata_size,
317			   uint64_t *flags);
318void amdgpu_bo_move_notify(struct ttm_buffer_object *bo,
319			   bool evict,
320			   struct ttm_resource *new_mem);
321void amdgpu_bo_release_notify(struct ttm_buffer_object *bo);
322vm_fault_t amdgpu_bo_fault_reserve_notify(struct ttm_buffer_object *bo);
323void amdgpu_bo_fence(struct amdgpu_bo *bo, struct dma_fence *fence,
324		     bool shared);
325int amdgpu_bo_sync_wait_resv(struct amdgpu_device *adev, struct dma_resv *resv,
326			     enum amdgpu_sync_mode sync_mode, void *owner,
327			     bool intr);
328int amdgpu_bo_sync_wait(struct amdgpu_bo *bo, void *owner, bool intr);
329u64 amdgpu_bo_gpu_offset(struct amdgpu_bo *bo);
330u64 amdgpu_bo_gpu_offset_no_check(struct amdgpu_bo *bo);
 
 
 
 
331int amdgpu_bo_validate(struct amdgpu_bo *bo);
332void amdgpu_bo_get_memory(struct amdgpu_bo *bo, uint64_t *vram_mem,
333				uint64_t *gtt_mem, uint64_t *cpu_mem);
334void amdgpu_bo_add_to_shadow_list(struct amdgpu_bo_vm *vmbo);
335int amdgpu_bo_restore_shadow(struct amdgpu_bo *shadow,
336			     struct dma_fence **fence);
337uint32_t amdgpu_bo_get_preferred_pin_domain(struct amdgpu_device *adev,
338					    uint32_t domain);
339
340/*
341 * sub allocation
342 */
343
344static inline uint64_t amdgpu_sa_bo_gpu_addr(struct amdgpu_sa_bo *sa_bo)
345{
346	return sa_bo->manager->gpu_addr + sa_bo->soffset;
347}
348
349static inline void * amdgpu_sa_bo_cpu_addr(struct amdgpu_sa_bo *sa_bo)
350{
351	return sa_bo->manager->cpu_ptr + sa_bo->soffset;
352}
353
354int amdgpu_sa_bo_manager_init(struct amdgpu_device *adev,
355				     struct amdgpu_sa_manager *sa_manager,
356				     unsigned size, u32 align, u32 domain);
357void amdgpu_sa_bo_manager_fini(struct amdgpu_device *adev,
358				      struct amdgpu_sa_manager *sa_manager);
359int amdgpu_sa_bo_manager_start(struct amdgpu_device *adev,
360				      struct amdgpu_sa_manager *sa_manager);
361int amdgpu_sa_bo_new(struct amdgpu_sa_manager *sa_manager,
362		     struct amdgpu_sa_bo **sa_bo,
363		     unsigned size, unsigned align);
364void amdgpu_sa_bo_free(struct amdgpu_device *adev,
365			      struct amdgpu_sa_bo **sa_bo,
366			      struct dma_fence *fence);
367#if defined(CONFIG_DEBUG_FS)
368void amdgpu_sa_bo_dump_debug_info(struct amdgpu_sa_manager *sa_manager,
369					 struct seq_file *m);
370u64 amdgpu_bo_print_info(int id, struct amdgpu_bo *bo, struct seq_file *m);
371#endif
372void amdgpu_debugfs_sa_init(struct amdgpu_device *adev);
373
374bool amdgpu_bo_support_uswc(u64 bo_flags);
375
376
377#endif