cma.h

 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#ifdef CONFIG_CMA_AREAS
10#define MAX_CMA_AREAS	CONFIG_CMA_AREAS
11#endif
12
13#define CMA_MAX_NAME 64
14
15/*
16 *  the buddy -- especially pageblock merging and alloc_contig_range()
17 * -- can deal with only some pageblocks of a higher-order page being
18 *  MIGRATE_CMA, we can use pageblock_nr_pages.
19 */
20#define CMA_MIN_ALIGNMENT_PAGES pageblock_nr_pages
21#define CMA_MIN_ALIGNMENT_BYTES (PAGE_SIZE * CMA_MIN_ALIGNMENT_PAGES)
22
23struct cma;
24
25extern unsigned long totalcma_pages;
26extern phys_addr_t cma_get_base(const struct cma *cma);
27extern unsigned long cma_get_size(const struct cma *cma);
28extern const char *cma_get_name(const struct cma *cma);
29
30extern int __init cma_declare_contiguous_nid(phys_addr_t base,
31			phys_addr_t size, phys_addr_t limit,
32			phys_addr_t alignment, unsigned int order_per_bit,
33			bool fixed, const char *name, struct cma **res_cma,
34			int nid);
35static inline int __init cma_declare_contiguous(phys_addr_t base,
36			phys_addr_t size, phys_addr_t limit,
37			phys_addr_t alignment, unsigned int order_per_bit,
38			bool fixed, const char *name, struct cma **res_cma)
39{
40	return cma_declare_contiguous_nid(base, size, limit, alignment,
41			order_per_bit, fixed, name, res_cma, NUMA_NO_NODE);
42}
43extern int __init cma_declare_contiguous_multi(phys_addr_t size,
44			phys_addr_t align, unsigned int order_per_bit,
45			const char *name, struct cma **res_cma, int nid);
46extern int cma_init_reserved_mem(phys_addr_t base, phys_addr_t size,
47					unsigned int order_per_bit,
48					const char *name,
49					struct cma **res_cma);
50extern struct page *cma_alloc(struct cma *cma, unsigned long count, unsigned int align,
51			      bool no_warn);
52extern bool cma_pages_valid(struct cma *cma, const struct page *pages, unsigned long count);
53extern bool cma_release(struct cma *cma, const struct page *pages, unsigned long count);
54
55extern int cma_for_each_area(int (*it)(struct cma *cma, void *data), void *data);
56extern bool cma_intersects(struct cma *cma, unsigned long start, unsigned long end);
57
58extern void cma_reserve_pages_on_error(struct cma *cma);
59
60#ifdef CONFIG_DMA_CMA
61extern bool cma_skip_dt_default_reserved_mem(void);
62#else
63static inline bool cma_skip_dt_default_reserved_mem(void)
64{
65	return false;
66}
67#endif
68
69#ifdef CONFIG_CMA
70struct folio *cma_alloc_folio(struct cma *cma, int order, gfp_t gfp);
71bool cma_free_folio(struct cma *cma, const struct folio *folio);
72bool cma_validate_zones(struct cma *cma);
73#else
74static inline struct folio *cma_alloc_folio(struct cma *cma, int order, gfp_t gfp)
75{
76	return NULL;
77}
78
79static inline bool cma_free_folio(struct cma *cma, const struct folio *folio)
80{
81	return false;
82}
83static inline bool cma_validate_zones(struct cma *cma)
84{
85	return false;
86}
87#endif
88
89#endif