1 /* SPDX-License-Identifier: GPL-2.0+ */
2 #ifndef _LINUX_LMB_H
3 #define _LINUX_LMB_H
4 #ifdef __KERNEL__
5
6 #include <asm/types.h>
7 #include <asm/u-boot.h>
8
9 /*
10 * Logical memory blocks.
11 *
12 * Copyright (C) 2001 Peter Bergner, IBM Corp.
13 */
14
15 /**
16 * struct lmb_property - Description of one region.
17 *
18 * @base: Base address of the region.
19 * @size: Size of the region
20 */
21 struct lmb_property {
22 phys_addr_t base;
23 phys_size_t size;
24 };
25
26 /**
27 * struct lmb_region - Description of a set of region.
28 *
29 * @cnt: Number of regions.
30 * @max: Size of the region array, max value of cnt.
31 * @region: Array of the region properties
32 */
33 struct lmb_region {
34 unsigned long cnt;
35 unsigned long max;
36 #if IS_ENABLED(CONFIG_LMB_USE_MAX_REGIONS)
37 struct lmb_property region[CONFIG_LMB_MAX_REGIONS];
38 #else
39 struct lmb_property *region;
40 #endif
41 };
42
43 /**
44 * struct lmb - Logical memory block handle.
45 *
46 * Clients provide storage for Logical memory block (lmb) handles.
47 * The content of the structure is managed by the lmb library.
48 * A lmb struct is initialized by lmb_init() functions.
49 * The lmb struct is passed to all other lmb APIs.
50 *
51 * @memory: Description of memory regions.
52 * @reserved: Description of reserved regions.
53 * @memory_regions: Array of the memory regions (statically allocated)
54 * @reserved_regions: Array of the reserved regions (statically allocated)
55 */
56 struct lmb {
57 struct lmb_region memory;
58 struct lmb_region reserved;
59 #if !IS_ENABLED(CONFIG_LMB_USE_MAX_REGIONS)
60 struct lmb_property memory_regions[CONFIG_LMB_MEMORY_REGIONS];
61 struct lmb_property reserved_regions[CONFIG_LMB_RESERVED_REGIONS];
62 #endif
63 };
64
65 extern void lmb_init(struct lmb *lmb);
66 extern void lmb_init_and_reserve(struct lmb *lmb, struct bd_info *bd,
67 void *fdt_blob);
68 extern void lmb_init_and_reserve_range(struct lmb *lmb, phys_addr_t base,
69 phys_size_t size, void *fdt_blob);
70 extern long lmb_add(struct lmb *lmb, phys_addr_t base, phys_size_t size);
71 extern long lmb_reserve(struct lmb *lmb, phys_addr_t base, phys_size_t size);
72 extern phys_addr_t lmb_alloc(struct lmb *lmb, phys_size_t size, ulong align);
73 extern phys_addr_t lmb_alloc_base(struct lmb *lmb, phys_size_t size, ulong align,
74 phys_addr_t max_addr);
75 extern phys_addr_t __lmb_alloc_base(struct lmb *lmb, phys_size_t size, ulong align,
76 phys_addr_t max_addr);
77 extern phys_addr_t lmb_alloc_addr(struct lmb *lmb, phys_addr_t base,
78 phys_size_t size);
79 extern phys_size_t lmb_get_free_size(struct lmb *lmb, phys_addr_t addr);
80 extern int lmb_is_reserved(struct lmb *lmb, phys_addr_t addr);
81 extern long lmb_free(struct lmb *lmb, phys_addr_t base, phys_size_t size);
82
83 extern void lmb_dump_all(struct lmb *lmb);
84 extern void lmb_dump_all_force(struct lmb *lmb);
85
86 static inline phys_size_t
lmb_size_bytes(struct lmb_region * type,unsigned long region_nr)87 lmb_size_bytes(struct lmb_region *type, unsigned long region_nr)
88 {
89 return type->region[region_nr].size;
90 }
91
92 void board_lmb_reserve(struct lmb *lmb);
93 void arch_lmb_reserve(struct lmb *lmb);
94
95 #endif /* __KERNEL__ */
96
97 #endif /* _LINUX_LMB_H */
98