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_SWIOTLB) || defined(CONFIG_INTEL_IOMMU)
 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