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: head 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 */
41int 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 */
56void 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 */
64int ttm_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
 
65/**
66 * Free pool allocator.
67 */
68void ttm_page_alloc_fini(void);
69
70/**
71 * Output the state of pools to debugfs file
72 */
73extern int ttm_page_alloc_debugfs(struct seq_file *m, void *data);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
74#endif

  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, struct ttm_operation_ctx *ctx);
 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				struct ttm_operation_ctx *ctx);
 66
 67/**
 68 * Unpopulates and DMA unmaps pages as part of a
 69 * ttm_dma_unpopulate() request */
 70void ttm_unmap_and_unpopulate_pages(struct device *dev, struct ttm_dma_tt *tt);
 71
 72/**
 73 * Output the state of pools to debugfs file
 74 */
 75int ttm_page_alloc_debugfs(struct seq_file *m, void *data);
 76
 77#if defined(CONFIG_DRM_TTM_DMA_PAGE_POOL)
 78/**
 79 * Initialize pool allocator.
 80 */
 81int ttm_dma_page_alloc_init(struct ttm_mem_global *glob, unsigned max_pages);
 82
 83/**
 84 * Free pool allocator.
 85 */
 86void ttm_dma_page_alloc_fini(void);
 87
 88/**
 89 * Output the state of pools to debugfs file
 90 */
 91int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data);
 92
 93int ttm_dma_populate(struct ttm_dma_tt *ttm_dma, struct device *dev,
 94			struct ttm_operation_ctx *ctx);
 95void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma, struct device *dev);
 96
 97#else
 98static inline int ttm_dma_page_alloc_init(struct ttm_mem_global *glob,
 99					  unsigned max_pages)
100{
101	return -ENODEV;
102}
103
104static inline void ttm_dma_page_alloc_fini(void) { return; }
105
106static inline int ttm_dma_page_alloc_debugfs(struct seq_file *m, void *data)
107{
108	return 0;
109}
110static inline int ttm_dma_populate(struct ttm_dma_tt *ttm_dma,
111				struct device *dev,
112				struct ttm_operation_ctx *ctx)
113{
114	return -ENOMEM;
115}
116static inline void ttm_dma_unpopulate(struct ttm_dma_tt *ttm_dma,
117				      struct device *dev)
118{
119}
120#endif
121
122#endif