1 // SPDX-License-Identifier: GPL-2.0
3 * Common EFI memory map functions.
6 #define pr_fmt(fmt) "efi: " fmt
8 #include <linux/init.h>
9 #include <linux/kernel.h>
10 #include <linux/efi.h>
12 #include <linux/memblock.h>
13 #include <linux/slab.h>
15 #include <asm/early_ioremap.h>
19 * __efi_memmap_init - Common code for mapping the EFI memory map
20 * @data: EFI memory map data
22 * This function takes care of figuring out which function to use to
23 * map the EFI memory map in efi.memmap based on how far into the boot
26 * During bootup EFI_MEMMAP_LATE in data->flags should be clear since we
27 * only have access to the early_memremap*() functions as the vmalloc
28 * space isn't setup. Once the kernel is fully booted we can fallback
29 * to the more robust memremap*() API.
31 * Returns: zero on success, a negative error code on failure.
33 int __init
__efi_memmap_init(struct efi_memory_map_data
*data
)
35 struct efi_memory_map map
;
38 phys_map
= data
->phys_map
;
40 if (data
->flags
& EFI_MEMMAP_LATE
)
41 map
.map
= memremap(phys_map
, data
->size
, MEMREMAP_WB
);
43 map
.map
= early_memremap(phys_map
, data
->size
);
46 pr_err("Could not map the memory map!\n");
50 map
.phys_map
= data
->phys_map
;
51 map
.nr_map
= data
->size
/ data
->desc_size
;
52 map
.map_end
= map
.map
+ data
->size
;
54 map
.desc_version
= data
->desc_version
;
55 map
.desc_size
= data
->desc_size
;
56 map
.flags
= data
->flags
;
58 set_bit(EFI_MEMMAP
, &efi
.flags
);
66 * efi_memmap_init_early - Map the EFI memory map data structure
67 * @data: EFI memory map data
69 * Use early_memremap() to map the passed in EFI memory map and assign
72 * Returns: zero on success, a negative error code on failure.
74 int __init
efi_memmap_init_early(struct efi_memory_map_data
*data
)
76 /* Cannot go backwards */
77 WARN_ON(efi
.memmap
.flags
& EFI_MEMMAP_LATE
);
80 return __efi_memmap_init(data
);
83 void __init
efi_memmap_unmap(void)
85 if (!efi_enabled(EFI_MEMMAP
))
88 if (!(efi
.memmap
.flags
& EFI_MEMMAP_LATE
)) {
91 size
= efi
.memmap
.desc_size
* efi
.memmap
.nr_map
;
92 early_memunmap(efi
.memmap
.map
, size
);
94 memunmap(efi
.memmap
.map
);
97 efi
.memmap
.map
= NULL
;
98 clear_bit(EFI_MEMMAP
, &efi
.flags
);
102 * efi_memmap_init_late - Map efi.memmap with memremap()
103 * @addr: Physical address of the new EFI memory map
104 * @size: Size in bytes of the new EFI memory map
106 * Setup a mapping of the EFI memory map using ioremap_cache(). This
107 * function should only be called once the vmalloc space has been
108 * setup and is therefore not suitable for calling during early EFI
109 * initialise, e.g. in efi_init(). Additionally, it expects
110 * efi_memmap_init_early() to have already been called.
112 * The reason there are two EFI memmap initialisation
113 * (efi_memmap_init_early() and this late version) is because the
114 * early EFI memmap should be explicitly unmapped once EFI
115 * initialisation is complete as the fixmap space used to map the EFI
116 * memmap (via early_memremap()) is a scarce resource.
118 * This late mapping is intended to persist for the duration of
119 * runtime so that things like efi_mem_desc_lookup() and
120 * efi_mem_attributes() always work.
122 * Returns: zero on success, a negative error code on failure.
124 int __init
efi_memmap_init_late(phys_addr_t addr
, unsigned long size
)
126 struct efi_memory_map_data data
= {
129 .flags
= EFI_MEMMAP_LATE
,
132 /* Did we forget to unmap the early EFI memmap? */
133 WARN_ON(efi
.memmap
.map
);
135 /* Were we already called? */
136 WARN_ON(efi
.memmap
.flags
& EFI_MEMMAP_LATE
);
139 * It makes no sense to allow callers to register different
140 * values for the following fields. Copy them out of the
141 * existing early EFI memmap.
143 data
.desc_version
= efi
.memmap
.desc_version
;
144 data
.desc_size
= efi
.memmap
.desc_size
;
146 return __efi_memmap_init(&data
);