include/drm/ttm/ttm_page_alloc.h

   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  */
  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