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 "ttm_bo_driver.h"
30 #include "ttm_memory.h"
31 
32 /**
33  * Get count number of pages from pool to pages list.
34  *
35  * @pages: heado of empty linked list where pages are filled.
36  * @flags: ttm flags for page allocation.
37  * @cstate: ttm caching state for the page.
38  * @count: number of pages to allocate.
39  * @dma_address: The DMA (bus) address of pages (if TTM_PAGE_FLAG_DMA32 set).
40  */
41 int ttm_get_pages(struct list_head *pages,
42 		  int flags,
43 		  enum ttm_caching_state cstate,
44 		  unsigned count,
45 		  dma_addr_t *dma_address);
46 /**
47  * Put linked list of pages to pool.
48  *
49  * @pages: list of pages to free.
50  * @page_count: number of pages in the list. Zero can be passed for unknown
51  * count.
52  * @flags: ttm flags for page allocation.
53  * @cstate: ttm caching state.
54  * @dma_address: The DMA (bus) address of pages (if TTM_PAGE_FLAG_DMA32 set).
55  */
56 void ttm_put_pages(struct list_head *pages,
57 		   unsigned page_count,
58 		   int flags,
59 		   enum ttm_caching_state cstate,
60 		   dma_addr_t *dma_address);
61 /**
62  * Initialize pool allocator.
63  */
64 int ttm_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
65 /**
66  * Free pool allocator.
67  */
68 void ttm_page_alloc_fini(void);
69 
70 /**
71  * Output the state of pools to debugfs file
72  */
73 extern int ttm_page_alloc_debugfs(struct seq_file *m, void *data);
74 #endif
75