[mirror_ubuntu-artful-kernel.git] / include / linux / memblock.h

#ifndef _LINUX_MEMBLOCK_H
#define _LINUX_MEMBLOCK_H
#ifdef __KERNEL__

#ifdef CONFIG_HAVE_MEMBLOCK
/*
 * Logical memory blocks.
 *
 * Copyright (C) 2001 Peter Bergner, IBM Corp.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version
 * 2 of the License, or (at your option) any later version.
 */

#include <linux/init.h>
#include <linux/mm.h>

#define INIT_MEMBLOCK_REGIONS	128
#define INIT_PHYSMEM_REGIONS	4

/* Definition of memblock flags. */
enum {
	MEMBLOCK_NONE		= 0x0,	/* No special request */
	MEMBLOCK_HOTPLUG	= 0x1,	/* hotpluggable region */
	MEMBLOCK_MIRROR		= 0x2,	/* mirrored region */
};

struct memblock_region {
	phys_addr_t base;
	phys_addr_t size;
	unsigned long flags;
#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
	int nid;
#endif
};

struct memblock_type {
	unsigned long cnt;	/* number of regions */
	unsigned long max;	/* size of the allocated array */
	phys_addr_t total_size;	/* size of all regions */
	struct memblock_region *regions;
};

struct memblock {
	bool bottom_up;  /* is bottom up direction? */
	phys_addr_t current_limit;
	struct memblock_type memory;
	struct memblock_type reserved;
#ifdef CONFIG_HAVE_MEMBLOCK_PHYS_MAP
	struct memblock_type physmem;
#endif
};

extern struct memblock memblock;
extern int memblock_debug;
#ifdef CONFIG_MOVABLE_NODE
/* If movable_node boot option specified */
extern bool movable_node_enabled;
#endif /* CONFIG_MOVABLE_NODE */

#define memblock_dbg(fmt, ...) \
	if (memblock_debug) printk(KERN_INFO pr_fmt(fmt), ##__VA_ARGS__)

phys_addr_t memblock_find_in_range_node(phys_addr_t size, phys_addr_t align,
					    phys_addr_t start, phys_addr_t end,
					    int nid, ulong flags);
phys_addr_t memblock_find_in_range(phys_addr_t start, phys_addr_t end,
				   phys_addr_t size, phys_addr_t align);
phys_addr_t get_allocated_memblock_reserved_regions_info(phys_addr_t *addr);
phys_addr_t get_allocated_memblock_memory_regions_info(phys_addr_t *addr);
void memblock_allow_resize(void);
int memblock_add_node(phys_addr_t base, phys_addr_t size, int nid);
int memblock_add(phys_addr_t base, phys_addr_t size);
int memblock_remove(phys_addr_t base, phys_addr_t size);
int memblock_free(phys_addr_t base, phys_addr_t size);
int memblock_reserve(phys_addr_t base, phys_addr_t size);
void memblock_trim_memory(phys_addr_t align);
int memblock_mark_hotplug(phys_addr_t base, phys_addr_t size);
int memblock_clear_hotplug(phys_addr_t base, phys_addr_t size);
int memblock_mark_mirror(phys_addr_t base, phys_addr_t size);
ulong choose_memblock_flags(void);

/* Low level functions */
int memblock_add_range(struct memblock_type *type,
		       phys_addr_t base, phys_addr_t size,
		       int nid, unsigned long flags);

int memblock_remove_range(struct memblock_type *type,
			  phys_addr_t base,
			  phys_addr_t size);

void __next_mem_range(u64 *idx, int nid, ulong flags,
		      struct memblock_type *type_a,
		      struct memblock_type *type_b, phys_addr_t *out_start,
		      phys_addr_t *out_end, int *out_nid);

void __next_mem_range_rev(u64 *idx, int nid, ulong flags,
			  struct memblock_type *type_a,
			  struct memblock_type *type_b, phys_addr_t *out_start,
			  phys_addr_t *out_end, int *out_nid);

/**
 * for_each_mem_range - iterate through memblock areas from type_a and not
 * included in type_b. Or just type_a if type_b is NULL.
 * @i: u64 used as loop variable
 * @type_a: ptr to memblock_type to iterate
 * @type_b: ptr to memblock_type which excludes from the iteration
 * @nid: node selector, %NUMA_NO_NODE for all nodes
 * @flags: pick from blocks based on memory attributes
 * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
 * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
 * @p_nid: ptr to int for nid of the range, can be %NULL
 */
#define for_each_mem_range(i, type_a, type_b, nid, flags,		\
			   p_start, p_end, p_nid)			\
	for (i = 0, __next_mem_range(&i, nid, flags, type_a, type_b,	\
				     p_start, p_end, p_nid);		\
	     i != (u64)ULLONG_MAX;					\
	     __next_mem_range(&i, nid, flags, type_a, type_b,		\
			      p_start, p_end, p_nid))

/**
 * for_each_mem_range_rev - reverse iterate through memblock areas from
 * type_a and not included in type_b. Or just type_a if type_b is NULL.
 * @i: u64 used as loop variable
 * @type_a: ptr to memblock_type to iterate
 * @type_b: ptr to memblock_type which excludes from the iteration
 * @nid: node selector, %NUMA_NO_NODE for all nodes
 * @flags: pick from blocks based on memory attributes
 * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
 * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
 * @p_nid: ptr to int for nid of the range, can be %NULL
 */
#define for_each_mem_range_rev(i, type_a, type_b, nid, flags,		\
			       p_start, p_end, p_nid)			\
	for (i = (u64)ULLONG_MAX,					\
		     __next_mem_range_rev(&i, nid, flags, type_a, type_b,\
					 p_start, p_end, p_nid);	\
	     i != (u64)ULLONG_MAX;					\
	     __next_mem_range_rev(&i, nid, flags, type_a, type_b,	\
				  p_start, p_end, p_nid))

#ifdef CONFIG_MOVABLE_NODE
static inline bool memblock_is_hotpluggable(struct memblock_region *m)
{
	return m->flags & MEMBLOCK_HOTPLUG;
}

static inline bool movable_node_is_enabled(void)
{
	return movable_node_enabled;
}
#else
static inline bool memblock_is_hotpluggable(struct memblock_region *m)
{
	return false;
}
static inline bool movable_node_is_enabled(void)
{
	return false;
}
#endif

static inline bool memblock_is_mirror(struct memblock_region *m)
{
	return m->flags & MEMBLOCK_MIRROR;
}

#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
int memblock_search_pfn_nid(unsigned long pfn, unsigned long *start_pfn,
			    unsigned long  *end_pfn);
void __next_mem_pfn_range(int *idx, int nid, unsigned long *out_start_pfn,
			  unsigned long *out_end_pfn, int *out_nid);

/**
 * for_each_mem_pfn_range - early memory pfn range iterator
 * @i: an integer used as loop variable
 * @nid: node selector, %MAX_NUMNODES for all nodes
 * @p_start: ptr to ulong for start pfn of the range, can be %NULL
 * @p_end: ptr to ulong for end pfn of the range, can be %NULL
 * @p_nid: ptr to int for nid of the range, can be %NULL
 *
 * Walks over configured memory ranges.
 */
#define for_each_mem_pfn_range(i, nid, p_start, p_end, p_nid)		\
	for (i = -1, __next_mem_pfn_range(&i, nid, p_start, p_end, p_nid); \
	     i >= 0; __next_mem_pfn_range(&i, nid, p_start, p_end, p_nid))
#endif /* CONFIG_HAVE_MEMBLOCK_NODE_MAP */

/**
 * for_each_free_mem_range - iterate through free memblock areas
 * @i: u64 used as loop variable
 * @nid: node selector, %NUMA_NO_NODE for all nodes
 * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
 * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
 * @p_nid: ptr to int for nid of the range, can be %NULL
 * @flags: pick from blocks based on memory attributes
 *
 * Walks over free (memory && !reserved) areas of memblock.  Available as
 * soon as memblock is initialized.
 */
#define for_each_free_mem_range(i, nid, flags, p_start, p_end, p_nid)	\
	for_each_mem_range(i, &memblock.memory, &memblock.reserved,	\
			   nid, flags, p_start, p_end, p_nid)

/**
 * for_each_free_mem_range_reverse - rev-iterate through free memblock areas
 * @i: u64 used as loop variable
 * @nid: node selector, %NUMA_NO_NODE for all nodes
 * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
 * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
 * @p_nid: ptr to int for nid of the range, can be %NULL
 * @flags: pick from blocks based on memory attributes
 *
 * Walks over free (memory && !reserved) areas of memblock in reverse
 * order.  Available as soon as memblock is initialized.
 */
#define for_each_free_mem_range_reverse(i, nid, flags, p_start, p_end,	\
					p_nid)				\
	for_each_mem_range_rev(i, &memblock.memory, &memblock.reserved,	\
			       nid, flags, p_start, p_end, p_nid)

static inline void memblock_set_region_flags(struct memblock_region *r,
					     unsigned long flags)
{
	r->flags |= flags;
}

static inline void memblock_clear_region_flags(struct memblock_region *r,
					       unsigned long flags)
{
	r->flags &= ~flags;
}

#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
int memblock_set_node(phys_addr_t base, phys_addr_t size,
		      struct memblock_type *type, int nid);

static inline void memblock_set_region_node(struct memblock_region *r, int nid)
{
	r->nid = nid;
}

static inline int memblock_get_region_node(const struct memblock_region *r)
{
	return r->nid;
}
#else
static inline void memblock_set_region_node(struct memblock_region *r, int nid)
{
}

static inline int memblock_get_region_node(const struct memblock_region *r)
{
	return 0;
}
#endif /* CONFIG_HAVE_MEMBLOCK_NODE_MAP */

phys_addr_t memblock_alloc_nid(phys_addr_t size, phys_addr_t align, int nid);
phys_addr_t memblock_alloc_try_nid(phys_addr_t size, phys_addr_t align, int nid);

phys_addr_t memblock_alloc(phys_addr_t size, phys_addr_t align);

#ifdef CONFIG_MOVABLE_NODE
/*
 * Set the allocation direction to bottom-up or top-down.
 */
static inline void __init memblock_set_bottom_up(bool enable)
{
	memblock.bottom_up = enable;
}

/*
 * Check if the allocation direction is bottom-up or not.
 * if this is true, that said, memblock will allocate memory
 * in bottom-up direction.
 */
static inline bool memblock_bottom_up(void)
{
	return memblock.bottom_up;
}
#else
static inline void __init memblock_set_bottom_up(bool enable) {}
static inline bool memblock_bottom_up(void) { return false; }
#endif

/* Flags for memblock_alloc_base() amd __memblock_alloc_base() */
#define MEMBLOCK_ALLOC_ANYWHERE	(~(phys_addr_t)0)
#define MEMBLOCK_ALLOC_ACCESSIBLE	0

phys_addr_t __init memblock_alloc_range(phys_addr_t size, phys_addr_t align,
					phys_addr_t start, phys_addr_t end,
					ulong flags);
phys_addr_t memblock_alloc_base(phys_addr_t size, phys_addr_t align,
				phys_addr_t max_addr);
phys_addr_t __memblock_alloc_base(phys_addr_t size, phys_addr_t align,
				  phys_addr_t max_addr);
phys_addr_t memblock_phys_mem_size(void);
phys_addr_t memblock_mem_size(unsigned long limit_pfn);
phys_addr_t memblock_start_of_DRAM(void);
phys_addr_t memblock_end_of_DRAM(void);
void memblock_enforce_memory_limit(phys_addr_t memory_limit);
int memblock_is_memory(phys_addr_t addr);
int memblock_is_region_memory(phys_addr_t base, phys_addr_t size);
int memblock_is_reserved(phys_addr_t addr);
int memblock_is_region_reserved(phys_addr_t base, phys_addr_t size);

extern void __memblock_dump_all(void);

static inline void memblock_dump_all(void)
{
	if (memblock_debug)
		__memblock_dump_all();
}

/**
 * memblock_set_current_limit - Set the current allocation limit to allow
 *                         limiting allocations to what is currently
 *                         accessible during boot
 * @limit: New limit value (physical address)
 */
void memblock_set_current_limit(phys_addr_t limit);


phys_addr_t memblock_get_current_limit(void);

/*
 * pfn conversion functions
 *
 * While the memory MEMBLOCKs should always be page aligned, the reserved
 * MEMBLOCKs may not be. This accessor attempt to provide a very clear
 * idea of what they return for such non aligned MEMBLOCKs.
 */

/**
 * memblock_region_memory_base_pfn - Return the lowest pfn intersecting with the memory region
 * @reg: memblock_region structure
 */
static inline unsigned long memblock_region_memory_base_pfn(const struct memblock_region *reg)
{
	return PFN_UP(reg->base);
}

/**
 * memblock_region_memory_end_pfn - Return the end_pfn this region
 * @reg: memblock_region structure
 */
static inline unsigned long memblock_region_memory_end_pfn(const struct memblock_region *reg)
{
	return PFN_DOWN(reg->base + reg->size);
}

/**
 * memblock_region_reserved_base_pfn - Return the lowest pfn intersecting with the reserved region
 * @reg: memblock_region structure
 */
static inline unsigned long memblock_region_reserved_base_pfn(const struct memblock_region *reg)
{
	return PFN_DOWN(reg->base);
}

/**
 * memblock_region_reserved_end_pfn - Return the end_pfn this region
 * @reg: memblock_region structure
 */
static inline unsigned long memblock_region_reserved_end_pfn(const struct memblock_region *reg)
{
	return PFN_UP(reg->base + reg->size);
}

#define for_each_memblock(memblock_type, region)					\
	for (region = memblock.memblock_type.regions;				\
	     region < (memblock.memblock_type.regions + memblock.memblock_type.cnt);	\
	     region++)


#ifdef CONFIG_ARCH_DISCARD_MEMBLOCK
#define __init_memblock __meminit
#define __initdata_memblock __meminitdata
#else
#define __init_memblock
#define __initdata_memblock
#endif

#ifdef CONFIG_MEMTEST
extern void early_memtest(phys_addr_t start, phys_addr_t end);
#else
static inline void early_memtest(phys_addr_t start, phys_addr_t end)
{
}
#endif

#else
static inline phys_addr_t memblock_alloc(phys_addr_t size, phys_addr_t align)
{
	return 0;
}

#endif /* CONFIG_HAVE_MEMBLOCK */

#endif /* __KERNEL__ */

#endif /* _LINUX_MEMBLOCK_H */
Commit	Line	Data
95f72d1e YL	1	#ifndef _LINUX_MEMBLOCK_H
	2	#define _LINUX_MEMBLOCK_H
	3	#ifdef __KERNEL__
	4
f0b37fad	5	#ifdef CONFIG_HAVE_MEMBLOCK
95f72d1e YL	6	/*
	7	* Logical memory blocks.
	8	*
	9	* Copyright (C) 2001 Peter Bergner, IBM Corp.
	10	*
	11	* This program is free software; you can redistribute it and/or
	12	* modify it under the terms of the GNU General Public License
	13	* as published by the Free Software Foundation; either version
	14	* 2 of the License, or (at your option) any later version.
	15	*/
	16
	17	#include <linux/init.h>
	18	#include <linux/mm.h>
	19
37d8d4bf	20	#define INIT_MEMBLOCK_REGIONS 128
70210ed9	21	#define INIT_PHYSMEM_REGIONS 4
95f72d1e	22
66b16edf	23	/* Definition of memblock flags. */
fc6daaf9 TL	24	enum {
	25	MEMBLOCK_NONE = 0x0, /* No special request */
	26	MEMBLOCK_HOTPLUG = 0x1, /* hotpluggable region */
a3f5bafc	27	MEMBLOCK_MIRROR = 0x2, /* mirrored region */
fc6daaf9	28	};
66b16edf	29
e3239ff9	30	struct memblock_region {
2898cc4c BH	31	phys_addr_t base;
2898cc4c BH	32	phys_addr_t size;
66a20757	33	unsigned long flags;
7c0caeb8 TH	34	#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
	35	int nid;
	36	#endif
95f72d1e YL	37	};
95f72d1e YL	38
e3239ff9	39	struct memblock_type {
bf23c51f BH	40	unsigned long cnt; /* number of regions */
bf23c51f BH	41	unsigned long max; /* size of the allocated array */
1440c4e2	42	phys_addr_t total_size; /* size of all regions */
bf23c51f	43	struct memblock_region *regions;
95f72d1e YL	44	};
	45
	46	struct memblock {
79442ed1	47	bool bottom_up; /* is bottom up direction? */
2898cc4c	48	phys_addr_t current_limit;
e3239ff9 BH	49	struct memblock_type memory;
e3239ff9 BH	50	struct memblock_type reserved;
70210ed9 PH	51	#ifdef CONFIG_HAVE_MEMBLOCK_PHYS_MAP
	52	struct memblock_type physmem;
	53	#endif
95f72d1e YL	54	};
	55
	56	extern struct memblock memblock;
5e63cf43	57	extern int memblock_debug;
55ac590c TC	58	#ifdef CONFIG_MOVABLE_NODE
	59	/* If movable_node boot option specified */
	60	extern bool movable_node_enabled;
	61	#endif /* CONFIG_MOVABLE_NODE */
5e63cf43 YL	62
	63	#define memblock_dbg(fmt, ...) \
	64	if (memblock_debug) printk(KERN_INFO pr_fmt(fmt), ##__VA_ARGS__)
95f72d1e	65
87029ee9 GS	66	phys_addr_t memblock_find_in_range_node(phys_addr_t size, phys_addr_t align,
87029ee9 GS	67	phys_addr_t start, phys_addr_t end,
fc6daaf9	68	int nid, ulong flags);
fc769a8e TH	69	phys_addr_t memblock_find_in_range(phys_addr_t start, phys_addr_t end,
fc769a8e TH	70	phys_addr_t size, phys_addr_t align);
29f67386	71	phys_addr_t get_allocated_memblock_reserved_regions_info(phys_addr_t *addr);
5e270e25	72	phys_addr_t get_allocated_memblock_memory_regions_info(phys_addr_t *addr);
1aadc056	73	void memblock_allow_resize(void);
7fb0bc3f	74	int memblock_add_node(phys_addr_t base, phys_addr_t size, int nid);
581adcbe TH	75	int memblock_add(phys_addr_t base, phys_addr_t size);
	76	int memblock_remove(phys_addr_t base, phys_addr_t size);
	77	int memblock_free(phys_addr_t base, phys_addr_t size);
	78	int memblock_reserve(phys_addr_t base, phys_addr_t size);
6ede1fd3	79	void memblock_trim_memory(phys_addr_t align);
66b16edf TC	80	int memblock_mark_hotplug(phys_addr_t base, phys_addr_t size);
66b16edf TC	81	int memblock_clear_hotplug(phys_addr_t base, phys_addr_t size);
a3f5bafc TL	82	int memblock_mark_mirror(phys_addr_t base, phys_addr_t size);
a3f5bafc TL	83	ulong choose_memblock_flags(void);
f1af9d3a PH	84
	85	/* Low level functions */
	86	int memblock_add_range(struct memblock_type *type,
	87	phys_addr_t base, phys_addr_t size,
	88	int nid, unsigned long flags);
	89
	90	int memblock_remove_range(struct memblock_type *type,
	91	phys_addr_t base,
	92	phys_addr_t size);
	93
fc6daaf9 TL	94	void __next_mem_range(u64 *idx, int nid, ulong flags,
fc6daaf9 TL	95	struct memblock_type *type_a,
f1af9d3a PH	96	struct memblock_type type_b, phys_addr_t out_start,
	97	phys_addr_t out_end, int out_nid);
	98
fc6daaf9 TL	99	void __next_mem_range_rev(u64 *idx, int nid, ulong flags,
fc6daaf9 TL	100	struct memblock_type *type_a,
f1af9d3a PH	101	struct memblock_type type_b, phys_addr_t out_start,
	102	phys_addr_t out_end, int out_nid);
	103
	104	/**
	105	* for_each_mem_range - iterate through memblock areas from type_a and not
	106	* included in type_b. Or just type_a if type_b is NULL.
	107	* @i: u64 used as loop variable
	108	* @type_a: ptr to memblock_type to iterate
	109	* @type_b: ptr to memblock_type which excludes from the iteration
	110	* @nid: node selector, %NUMA_NO_NODE for all nodes
fc6daaf9	111	* @flags: pick from blocks based on memory attributes
f1af9d3a PH	112	* @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
	113	* @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
	114	* @p_nid: ptr to int for nid of the range, can be %NULL
	115	*/
fc6daaf9	116	#define for_each_mem_range(i, type_a, type_b, nid, flags, \
f1af9d3a	117	p_start, p_end, p_nid) \
fc6daaf9	118	for (i = 0, __next_mem_range(&i, nid, flags, type_a, type_b, \
f1af9d3a PH	119	p_start, p_end, p_nid); \
f1af9d3a PH	120	i != (u64)ULLONG_MAX; \
fc6daaf9	121	__next_mem_range(&i, nid, flags, type_a, type_b, \
f1af9d3a PH	122	p_start, p_end, p_nid))
	123
	124	/**
	125	* for_each_mem_range_rev - reverse iterate through memblock areas from
	126	* type_a and not included in type_b. Or just type_a if type_b is NULL.
	127	* @i: u64 used as loop variable
	128	* @type_a: ptr to memblock_type to iterate
	129	* @type_b: ptr to memblock_type which excludes from the iteration
	130	* @nid: node selector, %NUMA_NO_NODE for all nodes
fc6daaf9	131	* @flags: pick from blocks based on memory attributes
f1af9d3a PH	132	* @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
	133	* @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
	134	* @p_nid: ptr to int for nid of the range, can be %NULL
	135	*/
fc6daaf9	136	#define for_each_mem_range_rev(i, type_a, type_b, nid, flags, \
f1af9d3a PH	137	p_start, p_end, p_nid) \
f1af9d3a PH	138	for (i = (u64)ULLONG_MAX, \
fc6daaf9	139	__next_mem_range_rev(&i, nid, flags, type_a, type_b,\
f1af9d3a PH	140	p_start, p_end, p_nid); \
f1af9d3a PH	141	i != (u64)ULLONG_MAX; \
fc6daaf9	142	__next_mem_range_rev(&i, nid, flags, type_a, type_b, \
f1af9d3a PH	143	p_start, p_end, p_nid))
f1af9d3a PH	144
55ac590c TC	145	#ifdef CONFIG_MOVABLE_NODE
	146	static inline bool memblock_is_hotpluggable(struct memblock_region *m)
	147	{
	148	return m->flags & MEMBLOCK_HOTPLUG;
	149	}
	150
	151	static inline bool movable_node_is_enabled(void)
	152	{
	153	return movable_node_enabled;
	154	}
	155	#else
	156	static inline bool memblock_is_hotpluggable(struct memblock_region *m)
	157	{
	158	return false;
	159	}
	160	static inline bool movable_node_is_enabled(void)
	161	{
	162	return false;
	163	}
	164	#endif
e63075a3	165
a3f5bafc TL	166	static inline bool memblock_is_mirror(struct memblock_region *m)
	167	{
	168	return m->flags & MEMBLOCK_MIRROR;
	169	}
	170
0ee332c1	171	#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
e76b63f8 YL	172	int memblock_search_pfn_nid(unsigned long pfn, unsigned long *start_pfn,
e76b63f8 YL	173	unsigned long *end_pfn);
0ee332c1 TH	174	void __next_mem_pfn_range(int idx, int nid, unsigned long out_start_pfn,
	175	unsigned long out_end_pfn, int out_nid);
	176
	177	/**
	178	* for_each_mem_pfn_range - early memory pfn range iterator
	179	* @i: an integer used as loop variable
	180	* @nid: node selector, %MAX_NUMNODES for all nodes
	181	* @p_start: ptr to ulong for start pfn of the range, can be %NULL
	182	* @p_end: ptr to ulong for end pfn of the range, can be %NULL
	183	* @p_nid: ptr to int for nid of the range, can be %NULL
	184	*
f2d52fe5	185	* Walks over configured memory ranges.
0ee332c1 TH	186	*/
	187	#define for_each_mem_pfn_range(i, nid, p_start, p_end, p_nid) \
	188	for (i = -1, __next_mem_pfn_range(&i, nid, p_start, p_end, p_nid); \
	189	i >= 0; __next_mem_pfn_range(&i, nid, p_start, p_end, p_nid))
	190	#endif /* CONFIG_HAVE_MEMBLOCK_NODE_MAP */
	191
35fd0808 TH	192	/**
	193	* for_each_free_mem_range - iterate through free memblock areas
	194	* @i: u64 used as loop variable
b1154233	195	* @nid: node selector, %NUMA_NO_NODE for all nodes
35fd0808 TH	196	* @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
	197	* @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
	198	* @p_nid: ptr to int for nid of the range, can be %NULL
fc6daaf9	199	* @flags: pick from blocks based on memory attributes
35fd0808 TH	200	*
	201	* Walks over free (memory && !reserved) areas of memblock. Available as
	202	* soon as memblock is initialized.
	203	*/
fc6daaf9	204	#define for_each_free_mem_range(i, nid, flags, p_start, p_end, p_nid) \
f1af9d3a	205	for_each_mem_range(i, &memblock.memory, &memblock.reserved, \
fc6daaf9	206	nid, flags, p_start, p_end, p_nid)
7bd0b0f0 TH	207
	208	/**
	209	* for_each_free_mem_range_reverse - rev-iterate through free memblock areas
	210	* @i: u64 used as loop variable
b1154233	211	* @nid: node selector, %NUMA_NO_NODE for all nodes
7bd0b0f0 TH	212	* @p_start: ptr to phys_addr_t for start address of the range, can be %NULL
	213	* @p_end: ptr to phys_addr_t for end address of the range, can be %NULL
	214	* @p_nid: ptr to int for nid of the range, can be %NULL
fc6daaf9	215	* @flags: pick from blocks based on memory attributes
7bd0b0f0 TH	216	*
	217	* Walks over free (memory && !reserved) areas of memblock in reverse
	218	* order. Available as soon as memblock is initialized.
	219	*/
fc6daaf9 TL	220	#define for_each_free_mem_range_reverse(i, nid, flags, p_start, p_end, \
fc6daaf9 TL	221	p_nid) \
f1af9d3a	222	for_each_mem_range_rev(i, &memblock.memory, &memblock.reserved, \
fc6daaf9	223	nid, flags, p_start, p_end, p_nid)
7bd0b0f0	224
66b16edf TC	225	static inline void memblock_set_region_flags(struct memblock_region *r,
	226	unsigned long flags)
	227	{
	228	r->flags \|= flags;
	229	}
	230
	231	static inline void memblock_clear_region_flags(struct memblock_region *r,
	232	unsigned long flags)
	233	{
	234	r->flags &= ~flags;
	235	}
	236
7c0caeb8	237	#ifdef CONFIG_HAVE_MEMBLOCK_NODE_MAP
e7e8de59 TC	238	int memblock_set_node(phys_addr_t base, phys_addr_t size,
e7e8de59 TC	239	struct memblock_type *type, int nid);
7c0caeb8 TH	240
	241	static inline void memblock_set_region_node(struct memblock_region *r, int nid)
	242	{
	243	r->nid = nid;
	244	}
	245
	246	static inline int memblock_get_region_node(const struct memblock_region *r)
	247	{
	248	return r->nid;
	249	}
	250	#else
	251	static inline void memblock_set_region_node(struct memblock_region *r, int nid)
	252	{
	253	}
	254
	255	static inline int memblock_get_region_node(const struct memblock_region *r)
	256	{
	257	return 0;
	258	}
	259	#endif /* CONFIG_HAVE_MEMBLOCK_NODE_MAP */
	260
581adcbe TH	261	phys_addr_t memblock_alloc_nid(phys_addr_t size, phys_addr_t align, int nid);
581adcbe TH	262	phys_addr_t memblock_alloc_try_nid(phys_addr_t size, phys_addr_t align, int nid);
9d1e2492	263
581adcbe	264	phys_addr_t memblock_alloc(phys_addr_t size, phys_addr_t align);
e63075a3	265
79442ed1 TC	266	#ifdef CONFIG_MOVABLE_NODE
	267	/*
	268	* Set the allocation direction to bottom-up or top-down.
	269	*/
2cfb3665	270	static inline void __init memblock_set_bottom_up(bool enable)
79442ed1 TC	271	{
	272	memblock.bottom_up = enable;
	273	}
	274
	275	/*
	276	* Check if the allocation direction is bottom-up or not.
	277	* if this is true, that said, memblock will allocate memory
	278	* in bottom-up direction.
	279	*/
	280	static inline bool memblock_bottom_up(void)
	281	{
	282	return memblock.bottom_up;
	283	}
	284	#else
2cfb3665	285	static inline void __init memblock_set_bottom_up(bool enable) {}
79442ed1 TC	286	static inline bool memblock_bottom_up(void) { return false; }
	287	#endif
	288
e63075a3	289	/* Flags for memblock_alloc_base() amd __memblock_alloc_base() */
2898cc4c	290	#define MEMBLOCK_ALLOC_ANYWHERE (~(phys_addr_t)0)
e63075a3 BH	291	#define MEMBLOCK_ALLOC_ACCESSIBLE 0
e63075a3 BH	292
2bfc2862	293	phys_addr_t __init memblock_alloc_range(phys_addr_t size, phys_addr_t align,
fc6daaf9 TL	294	phys_addr_t start, phys_addr_t end,
fc6daaf9 TL	295	ulong flags);
581adcbe TH	296	phys_addr_t memblock_alloc_base(phys_addr_t size, phys_addr_t align,
	297	phys_addr_t max_addr);
	298	phys_addr_t __memblock_alloc_base(phys_addr_t size, phys_addr_t align,
	299	phys_addr_t max_addr);
	300	phys_addr_t memblock_phys_mem_size(void);
595ad9af	301	phys_addr_t memblock_mem_size(unsigned long limit_pfn);
581adcbe TH	302	phys_addr_t memblock_start_of_DRAM(void);
	303	phys_addr_t memblock_end_of_DRAM(void);
	304	void memblock_enforce_memory_limit(phys_addr_t memory_limit);
	305	int memblock_is_memory(phys_addr_t addr);
	306	int memblock_is_region_memory(phys_addr_t base, phys_addr_t size);
	307	int memblock_is_reserved(phys_addr_t addr);
	308	int memblock_is_region_reserved(phys_addr_t base, phys_addr_t size);
	309
4ff7b82f TH	310	extern void __memblock_dump_all(void);
	311
	312	static inline void memblock_dump_all(void)
	313	{
	314	if (memblock_debug)
	315	__memblock_dump_all();
	316	}
95f72d1e	317
e63075a3 BH	318	/**
	319	* memblock_set_current_limit - Set the current allocation limit to allow
	320	* limiting allocations to what is currently
	321	* accessible during boot
	322	* @limit: New limit value (physical address)
	323	*/
581adcbe	324	void memblock_set_current_limit(phys_addr_t limit);
e63075a3	325
35a1f0bd	326
fec51014 LA	327	phys_addr_t memblock_get_current_limit(void);
fec51014 LA	328
5b385f25 BH	329	/*
	330	* pfn conversion functions
	331	*
	332	* While the memory MEMBLOCKs should always be page aligned, the reserved
	333	* MEMBLOCKs may not be. This accessor attempt to provide a very clear
	334	* idea of what they return for such non aligned MEMBLOCKs.
	335	*/
	336
	337	/**
c7fc2de0	338	* memblock_region_memory_base_pfn - Return the lowest pfn intersecting with the memory region
5b385f25 BH	339	* @reg: memblock_region structure
5b385f25 BH	340	*/
c7fc2de0	341	static inline unsigned long memblock_region_memory_base_pfn(const struct memblock_region *reg)
5b385f25	342	{
c7fc2de0	343	return PFN_UP(reg->base);
5b385f25 BH	344	}
	345
	346	/**
c7fc2de0	347	* memblock_region_memory_end_pfn - Return the end_pfn this region
5b385f25 BH	348	* @reg: memblock_region structure
5b385f25 BH	349	*/
c7fc2de0	350	static inline unsigned long memblock_region_memory_end_pfn(const struct memblock_region *reg)
5b385f25	351	{
c7fc2de0	352	return PFN_DOWN(reg->base + reg->size);
5b385f25 BH	353	}
	354
	355	/**
c7fc2de0	356	* memblock_region_reserved_base_pfn - Return the lowest pfn intersecting with the reserved region
5b385f25 BH	357	* @reg: memblock_region structure
5b385f25 BH	358	*/
c7fc2de0	359	static inline unsigned long memblock_region_reserved_base_pfn(const struct memblock_region *reg)
5b385f25	360	{
c7fc2de0	361	return PFN_DOWN(reg->base);
5b385f25 BH	362	}
	363
	364	/**
c7fc2de0	365	* memblock_region_reserved_end_pfn - Return the end_pfn this region
5b385f25 BH	366	* @reg: memblock_region structure
5b385f25 BH	367	*/
c7fc2de0	368	static inline unsigned long memblock_region_reserved_end_pfn(const struct memblock_region *reg)
5b385f25	369	{
c7fc2de0	370	return PFN_UP(reg->base + reg->size);
5b385f25 BH	371	}
	372
	373	#define for_each_memblock(memblock_type, region) \
	374	for (region = memblock.memblock_type.regions; \
	375	region < (memblock.memblock_type.regions + memblock.memblock_type.cnt); \
	376	region++)
	377
	378
c378ddd5	379	#ifdef CONFIG_ARCH_DISCARD_MEMBLOCK
67e24bcb TH	380	#define __init_memblock __meminit
67e24bcb TH	381	#define __initdata_memblock __meminitdata
10d06439 YL	382	#else
	383	#define __init_memblock
	384	#define __initdata_memblock
	385	#endif
	386
4a20799d	387	#ifdef CONFIG_MEMTEST
7f70baee	388	extern void early_memtest(phys_addr_t start, phys_addr_t end);
4a20799d	389	#else
7f70baee	390	static inline void early_memtest(phys_addr_t start, phys_addr_t end)
4a20799d VM	391	{
	392	}
	393	#endif
	394
95dde501 YL	395	#else
	396	static inline phys_addr_t memblock_alloc(phys_addr_t size, phys_addr_t align)
	397	{
1f5026a7	398	return 0;
95dde501 YL	399	}
95dde501 YL	400
f0b37fad YL	401	#endif /* CONFIG_HAVE_MEMBLOCK */
f0b37fad YL	402
95f72d1e YL	403	#endif /* __KERNEL__ */
	404
	405	#endif /* _LINUX_MEMBLOCK_H */