drm/ttm: introduce callback for ttm_tt populate & unpopulate V4
[deliverable/linux.git] / include / drm / ttm / ttm_page_alloc.h
CommitLineData
1403b1a3
PN
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 *
0d74f86f 35 * @pages: head of empty linked list where pages are filled.
1403b1a3
PN
36 * @flags: ttm flags for page allocation.
37 * @cstate: ttm caching state for the page.
38 * @count: number of pages to allocate.
f9820a46 39 * @dma_address: The DMA (bus) address of pages (if TTM_PAGE_FLAG_DMA32 set).
1403b1a3 40 */
822c4d9a 41int ttm_get_pages(struct page **pages,
1403b1a3
PN
42 int flags,
43 enum ttm_caching_state cstate,
822c4d9a 44 unsigned npages,
a2c06ee2 45 dma_addr_t *dma_address);
1403b1a3
PN
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.
f9820a46 54 * @dma_address: The DMA (bus) address of pages (if TTM_PAGE_FLAG_DMA32 set).
1403b1a3 55 */
822c4d9a
JG
56void ttm_put_pages(struct page **pages,
57 unsigned npages,
1403b1a3 58 int flags,
f9820a46 59 enum ttm_caching_state cstate,
a2c06ee2 60 dma_addr_t *dma_address);
1403b1a3
PN
61/**
62 * Initialize pool allocator.
1403b1a3 63 */
c96af79e 64int ttm_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
1403b1a3
PN
65/**
66 * Free pool allocator.
67 */
68void ttm_page_alloc_fini(void);
69
b1e5f172
JG
70/**
71 * ttm_pool_populate:
72 *
73 * @ttm: The struct ttm_tt to contain the backing pages.
74 *
75 * Add backing pages to all of @ttm
76 */
77extern int ttm_pool_populate(struct ttm_tt *ttm);
78
79/**
80 * ttm_pool_unpopulate:
81 *
82 * @ttm: The struct ttm_tt which to free backing pages.
83 *
84 * Free all pages of @ttm
85 */
86extern void ttm_pool_unpopulate(struct ttm_tt *ttm);
87
07458661
PN
88/**
89 * Output the state of pools to debugfs file
90 */
91extern int ttm_page_alloc_debugfs(struct seq_file *m, void *data);
1403b1a3 92#endif
This page took 0.105789 seconds and 5 git commands to generate.