xref: /freebsd/sys/dev/drm2/ttm/ttm_page_alloc.h (revision 0fca6ea1d4eea4c934cfff25ac9ee8ad6fe95583)
1 /*
2  * Copyright (c) Red Hat Inc.
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, sub license,
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
12  * next paragraph) shall be included in all copies or substantial portions
13  * of the 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 NON-INFRINGEMENT. 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
21  * DEALINGS IN THE SOFTWARE.
22  *
23  * Authors: Dave Airlie <airlied@redhat.com>
24  *          Jerome Glisse <jglisse@redhat.com>
25  */
26 #ifndef TTM_PAGE_ALLOC
27 #define TTM_PAGE_ALLOC
28 
29 #include <dev/drm2/ttm/ttm_bo_driver.h>
30 #include <dev/drm2/ttm/ttm_memory.h>
31 
32 /**
33  * Initialize pool allocator.
34  */
35 int ttm_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
36 /**
37  * Free pool allocator.
38  */
39 void ttm_page_alloc_fini(void);
40 
41 /**
42  * ttm_pool_populate:
43  *
44  * @ttm: The struct ttm_tt to contain the backing pages.
45  *
46  * Add backing pages to all of @ttm
47  */
48 extern int ttm_pool_populate(struct ttm_tt *ttm);
49 
50 /**
51  * ttm_pool_unpopulate:
52  *
53  * @ttm: The struct ttm_tt which to free backing pages.
54  *
55  * Free all pages of @ttm
56  */
57 extern void ttm_pool_unpopulate(struct ttm_tt *ttm);
58 
59 /**
60  * Output the state of pools to debugfs file
61  */
62 /* XXXKIB
63 extern int ttm_page_alloc_debugfs(struct seq_file *m, void *data);
64 */
65 
66 #ifdef CONFIG_SWIOTLB
67 /**
68  * Initialize pool allocator.
69  */
70 int ttm_dma_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
71 
72 /**
73  * Free pool allocator.
74  */
75 void ttm_dma_page_alloc_fini(void);
76 
77 /**
78  * Output the state of pools to debugfs file
79  */
80 extern int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data);
81 
82 extern int ttm_dma_populate(struct ttm_dma_tt *ttm_dma, struct device *dev);
83 extern void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma, struct device *dev);
84 
85 #else
86 static inline int ttm_dma_page_alloc_init(struct ttm_mem_global *glob,
87 					  unsigned max_pages)
88 {
89 	return -ENODEV;
90 }
91 
92 static inline void ttm_dma_page_alloc_fini(void) { return; }
93 
94 /* XXXKIB
95 static inline int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data)
96 {
97 	return 0;
98 }
99 */
100 #endif
101 
102 #endif
103