1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef __CMA_H__
3#define __CMA_H__
4
5#include <linux/init.h>
6#include <linux/types.h>
7#include <linux/numa.h>
8
9/*
10 * There is always at least global CMA area and a few optional
11 * areas configured in kernel .config.
12 */
13#ifdef CONFIG_CMA_AREAS
14#define MAX_CMA_AREAS (1 + CONFIG_CMA_AREAS)
15#endif
16
17#define CMA_MAX_NAME 64
18
19/*
20 * the buddy -- especially pageblock merging and alloc_contig_range()
21 * -- can deal with only some pageblocks of a higher-order page being
22 * MIGRATE_CMA, we can use pageblock_nr_pages.
23 */
24#define CMA_MIN_ALIGNMENT_PAGES pageblock_nr_pages
25#define CMA_MIN_ALIGNMENT_BYTES (PAGE_SIZE * CMA_MIN_ALIGNMENT_PAGES)
26
27struct cma;
28
29extern unsigned long totalcma_pages;
30extern phys_addr_t cma_get_base(const struct cma *cma);
31extern unsigned long cma_get_size(const struct cma *cma);
32extern const char *cma_get_name(const struct cma *cma);
33
34extern int __init cma_declare_contiguous_nid(phys_addr_t base,
35 phys_addr_t size, phys_addr_t limit,
36 phys_addr_t alignment, unsigned int order_per_bit,
37 bool fixed, const char *name, struct cma **res_cma,
38 int nid);
39static inline int __init cma_declare_contiguous(phys_addr_t base,
40 phys_addr_t size, phys_addr_t limit,
41 phys_addr_t alignment, unsigned int order_per_bit,
42 bool fixed, const char *name, struct cma **res_cma)
43{
44 return cma_declare_contiguous_nid(base, size, limit, alignment,
45 order_per_bit, fixed, name, res_cma, NUMA_NO_NODE);
46}
47extern int cma_init_reserved_mem(phys_addr_t base, phys_addr_t size,
48 unsigned int order_per_bit,
49 const char *name,
50 struct cma **res_cma);
51extern struct page *cma_alloc(struct cma *cma, unsigned long count, unsigned int align,
52 bool no_warn);
53extern bool cma_pages_valid(struct cma *cma, const struct page *pages, unsigned long count);
54extern bool cma_release(struct cma *cma, const struct page *pages, unsigned long count);
55
56extern int cma_for_each_area(int (*it)(struct cma *cma, void *data), void *data);
57
58extern void cma_reserve_pages_on_error(struct cma *cma);
59#endif
60

source code of linux/include/linux/cma.h