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 <drm/ttm/ttm_bo_driver.h> 30 #include <drm/ttm/ttm_memory.h> 31 32 struct device; 33 34 /** 35 * Initialize pool allocator. 36 */ 37 int ttm_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages); 38 /** 39 * Free pool allocator. 40 */ 41 void ttm_page_alloc_fini(void); 42 43 /** 44 * ttm_pool_populate: 45 * 46 * @ttm: The struct ttm_tt to contain the backing pages. 47 * 48 * Add backing pages to all of @ttm 49 */ 50 int ttm_pool_populate(struct ttm_tt *ttm); 51 52 /** 53 * ttm_pool_unpopulate: 54 * 55 * @ttm: The struct ttm_tt which to free backing pages. 56 * 57 * Free all pages of @ttm 58 */ 59 void ttm_pool_unpopulate(struct ttm_tt *ttm); 60 61 /** 62 * Populates and DMA maps pages to fullfil a ttm_dma_populate() request 63 */ 64 int ttm_populate_and_map_pages(struct device *dev, struct ttm_dma_tt *tt); 65 66 /** 67 * Unpopulates and DMA unmaps pages as part of a 68 * ttm_dma_unpopulate() request */ 69 void ttm_unmap_and_unpopulate_pages(struct device *dev, struct ttm_dma_tt *tt); 70 71 /** 72 * Output the state of pools to debugfs file 73 */ 74 int ttm_page_alloc_debugfs(struct seq_file *m, void *data); 75 76 #if defined(CONFIG_SWIOTLB) || defined(CONFIG_INTEL_IOMMU) 77 /** 78 * Initialize pool allocator. 79 */ 80 int ttm_dma_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages); 81 82 /** 83 * Free pool allocator. 84 */ 85 void ttm_dma_page_alloc_fini(void); 86 87 /** 88 * Output the state of pools to debugfs file 89 */ 90 int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data); 91 92 int ttm_dma_populate(struct ttm_dma_tt *ttm_dma, struct device *dev); 93 void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma, struct device *dev); 94 95 #else 96 static inline int ttm_dma_page_alloc_init(struct ttm_mem_global *glob, 97 unsigned max_pages) 98 { 99 return -ENODEV; 100 } 101 102 static inline void ttm_dma_page_alloc_fini(void) { return; } 103 104 static inline int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data) 105 { 106 return 0; 107 } 108 static inline int ttm_dma_populate(struct ttm_dma_tt *ttm_dma, 109 struct device *dev) 110 { 111 return -ENOMEM; 112 } 113 static inline void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma, 114 struct device *dev) 115 { 116 } 117 #endif 118 119 #endif 120