tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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
32struct device;
33
34/**
35 * Initialize pool allocator.
36 */
37int ttm_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
38/**
39 * Free pool allocator.
40 */
41void 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 */
50int 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 */
59void ttm_pool_unpopulate(struct ttm_tt *ttm);
60
61/**
62 * Populates and DMA maps pages to fullfil a ttm_dma_populate() request
63 */
64int 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 */
69void 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 */
74int 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 */
80int ttm_dma_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
81
82/**
83 * Free pool allocator.
84 */
85void ttm_dma_page_alloc_fini(void);
86
87/**
88 * Output the state of pools to debugfs file
89 */
90int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data);
91
92int ttm_dma_populate(struct ttm_dma_tt *ttm_dma, struct device *dev);
93void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma, struct device *dev);
94
95#else
96static inline int ttm_dma_page_alloc_init(struct ttm_mem_global *glob,
97 unsigned max_pages)
98{
99 return -ENODEV;
100}
101
102static inline void ttm_dma_page_alloc_fini(void) { return; }
103
104static inline int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data)
105{
106 return 0;
107}
108static inline int ttm_dma_populate(struct ttm_dma_tt *ttm_dma,
109 struct device *dev)
110{
111 return -ENOMEM;
112}
113static inline void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma,
114 struct device *dev)
115{
116}
117#endif
118
119#endif