1 // SPDX-License-Identifier: GPL-2.0
3 * FDT related Helper functions used by the EFI stub on multiple
4 * architectures. This should be #included by the EFI stub
5 * implementation files.
7 * Copyright 2013 Linaro Limited; author Roy Franz
10 #include <linux/efi.h>
11 #include <linux/libfdt.h>
16 #define EFI_DT_ADDR_CELLS_DEFAULT 2
17 #define EFI_DT_SIZE_CELLS_DEFAULT 2
19 static void fdt_update_cell_size(void *fdt)
23 offset = fdt_path_offset(fdt, "/");
24 /* Set the #address-cells and #size-cells values for an empty tree */
26 fdt_setprop_u32(fdt, offset, "#address-cells", EFI_DT_ADDR_CELLS_DEFAULT);
27 fdt_setprop_u32(fdt, offset, "#size-cells", EFI_DT_SIZE_CELLS_DEFAULT);
30 static efi_status_t update_fdt(void *orig_fdt, unsigned long orig_fdt_size,
31 void *fdt, int new_fdt_size, char *cmdline_ptr)
38 /* Do some checks on provided FDT, if it exists: */
40 if (fdt_check_header(orig_fdt)) {
41 efi_err("Device Tree header not valid!\n");
42 return EFI_LOAD_ERROR;
45 * We don't get the size of the FDT if we get if from a
46 * configuration table:
48 if (orig_fdt_size && fdt_totalsize(orig_fdt) > orig_fdt_size) {
49 efi_err("Truncated device tree! foo!\n");
50 return EFI_LOAD_ERROR;
55 status = fdt_open_into(orig_fdt, fdt, new_fdt_size);
57 status = fdt_create_empty_tree(fdt, new_fdt_size);
60 * Any failure from the following function is
63 fdt_update_cell_size(fdt);
71 * Delete all memory reserve map entries. When booting via UEFI,
72 * kernel will use the UEFI memory map to find reserved regions.
74 num_rsv = fdt_num_mem_rsv(fdt);
76 fdt_del_mem_rsv(fdt, num_rsv);
78 node = fdt_subnode_offset(fdt, 0, "chosen");
80 node = fdt_add_subnode(fdt, 0, "chosen");
82 /* 'node' is an error code when negative: */
88 if (cmdline_ptr != NULL && strlen(cmdline_ptr) > 0) {
89 status = fdt_setprop(fdt, node, "bootargs", cmdline_ptr,
90 strlen(cmdline_ptr) + 1);
95 /* Add FDT entries for EFI runtime services in chosen node. */
96 node = fdt_subnode_offset(fdt, 0, "chosen");
97 fdt_val64 = cpu_to_fdt64((u64)(unsigned long)efi_system_table);
99 status = fdt_setprop_var(fdt, node, "linux,uefi-system-table", fdt_val64);
103 fdt_val64 = U64_MAX; /* placeholder */
105 status = fdt_setprop_var(fdt, node, "linux,uefi-mmap-start", fdt_val64);
109 fdt_val32 = U32_MAX; /* placeholder */
111 status = fdt_setprop_var(fdt, node, "linux,uefi-mmap-size", fdt_val32);
115 status = fdt_setprop_var(fdt, node, "linux,uefi-mmap-desc-size", fdt_val32);
119 status = fdt_setprop_var(fdt, node, "linux,uefi-mmap-desc-ver", fdt_val32);
123 if (IS_ENABLED(CONFIG_RANDOMIZE_BASE) && !efi_nokaslr) {
124 efi_status_t efi_status;
126 efi_status = efi_get_random_bytes(sizeof(fdt_val64),
128 if (efi_status == EFI_SUCCESS) {
129 status = fdt_setprop_var(fdt, node, "kaslr-seed", fdt_val64);
135 /* Shrink the FDT back to its minimum size: */
141 if (status == -FDT_ERR_NOSPACE)
142 return EFI_BUFFER_TOO_SMALL;
144 return EFI_LOAD_ERROR;
147 static efi_status_t update_fdt_memmap(void *fdt, struct efi_boot_memmap *map)
149 int node = fdt_path_offset(fdt, "/chosen");
155 return EFI_LOAD_ERROR;
157 fdt_val64 = cpu_to_fdt64((unsigned long)map->map);
159 err = fdt_setprop_inplace_var(fdt, node, "linux,uefi-mmap-start", fdt_val64);
161 return EFI_LOAD_ERROR;
163 fdt_val32 = cpu_to_fdt32(map->map_size);
165 err = fdt_setprop_inplace_var(fdt, node, "linux,uefi-mmap-size", fdt_val32);
167 return EFI_LOAD_ERROR;
169 fdt_val32 = cpu_to_fdt32(map->desc_size);
171 err = fdt_setprop_inplace_var(fdt, node, "linux,uefi-mmap-desc-size", fdt_val32);
173 return EFI_LOAD_ERROR;
175 fdt_val32 = cpu_to_fdt32(map->desc_ver);
177 err = fdt_setprop_inplace_var(fdt, node, "linux,uefi-mmap-desc-ver", fdt_val32);
179 return EFI_LOAD_ERROR;
184 struct exit_boot_struct {
185 struct efi_boot_memmap *boot_memmap;
186 efi_memory_desc_t *runtime_map;
187 int runtime_entry_count;
191 static efi_status_t exit_boot_func(struct efi_boot_memmap *map, void *priv)
193 struct exit_boot_struct *p = priv;
195 p->boot_memmap = map;
198 * Update the memory map with virtual addresses. The function will also
199 * populate @runtime_map with copies of just the EFI_MEMORY_RUNTIME
200 * entries so that we can pass it straight to SetVirtualAddressMap()
202 efi_get_virtmap(map->map, map->map_size, map->desc_size,
203 p->runtime_map, &p->runtime_entry_count);
205 return update_fdt_memmap(p->new_fdt_addr, map);
209 # define MAX_FDT_SIZE SZ_2M
213 * Allocate memory for a new FDT, then add EFI and commandline related fields
214 * to the FDT. This routine increases the FDT allocation size until the
215 * allocated memory is large enough. EFI allocations are in EFI_PAGE_SIZE
216 * granules, which are fixed at 4K bytes, so in most cases the first allocation
217 * should succeed. EFI boot services are exited at the end of this function.
218 * There must be no allocations between the get_memory_map() call and the
219 * exit_boot_services() call, so the exiting of boot services is very tightly
220 * tied to the creation of the FDT with the final memory map in it.
223 efi_status_t allocate_new_fdt_and_exit_boot(void *handle,
224 efi_loaded_image_t *image,
225 unsigned long *new_fdt_addr,
228 unsigned long desc_size;
231 struct exit_boot_struct priv;
232 unsigned long fdt_addr = 0;
233 unsigned long fdt_size = 0;
236 status = efi_alloc_virtmap(&priv.runtime_map, &desc_size,
238 if (status != EFI_SUCCESS) {
239 efi_err("Unable to retrieve UEFI memory map.\n");
245 * Unauthenticated device tree data is a security hazard, so ignore
246 * 'dtb=' unless UEFI Secure Boot is disabled. We assume that secure
247 * boot is enabled if we can't determine its state.
249 if (!IS_ENABLED(CONFIG_EFI_ARMSTUB_DTB_LOADER) ||
250 efi_get_secureboot() != efi_secureboot_mode_disabled) {
251 if (strstr(cmdline_ptr, "dtb="))
252 efi_err("Ignoring DTB from command line.\n");
254 status = efi_load_dtb(image, &fdt_addr, &fdt_size);
256 if (status != EFI_SUCCESS && status != EFI_NOT_READY) {
257 efi_err("Failed to load device tree!\n");
263 efi_info("Using DTB from command line\n");
265 /* Look for a device tree configuration table entry. */
266 fdt_addr = (uintptr_t)get_fdt(&fdt_size);
268 efi_info("Using DTB from configuration table\n");
272 efi_info("Generating empty DTB\n");
274 efi_info("Exiting boot services...\n");
276 status = efi_allocate_pages(MAX_FDT_SIZE, new_fdt_addr, ULONG_MAX);
277 if (status != EFI_SUCCESS) {
278 efi_err("Unable to allocate memory for new device tree.\n");
282 status = update_fdt((void *)fdt_addr, fdt_size,
283 (void *)*new_fdt_addr, MAX_FDT_SIZE, cmdline_ptr);
285 if (status != EFI_SUCCESS) {
286 efi_err("Unable to construct new device tree.\n");
287 goto fail_free_new_fdt;
290 priv.new_fdt_addr = (void *)*new_fdt_addr;
292 status = efi_exit_boot_services(handle, &priv, exit_boot_func);
294 if (status == EFI_SUCCESS) {
295 efi_set_virtual_address_map_t *svam;
300 /* Install the new virtual address map */
301 svam = efi_system_table->runtime->set_virtual_address_map;
302 status = svam(priv.runtime_entry_count * desc_size, desc_size,
303 desc_ver, priv.runtime_map);
306 * We are beyond the point of no return here, so if the call to
307 * SetVirtualAddressMap() failed, we need to signal that to the
308 * incoming kernel but proceed normally otherwise.
310 if (status != EFI_SUCCESS) {
311 efi_memory_desc_t *p;
315 * Set the virtual address field of all
316 * EFI_MEMORY_RUNTIME entries to U64_MAX. This will
317 * signal the incoming kernel that no virtual
318 * translation has been installed.
320 for (l = 0; l < priv.boot_memmap->map_size;
321 l += priv.boot_memmap->desc_size) {
322 p = (void *)priv.boot_memmap->map + l;
324 if (p->attribute & EFI_MEMORY_RUNTIME)
325 p->virt_addr = U64_MAX;
331 efi_err("Exit boot services failed.\n");
334 efi_free(MAX_FDT_SIZE, *new_fdt_addr);
337 efi_free(fdt_size, fdt_addr);
339 efi_bs_call(free_pool, priv.runtime_map);
341 return EFI_LOAD_ERROR;
344 efi_status_t efi_boot_kernel(void *handle, efi_loaded_image_t *image,
345 unsigned long kernel_addr, char *cmdline_ptr)
347 unsigned long fdt_addr;
350 status = allocate_new_fdt_and_exit_boot(handle, image, &fdt_addr,
352 if (status != EFI_SUCCESS) {
353 efi_err("Failed to update FDT and exit boot services\n");
357 if (IS_ENABLED(CONFIG_ARM))
358 efi_handle_post_ebs_state();
360 efi_enter_kernel(kernel_addr, fdt_addr, fdt_totalsize((void *)fdt_addr));
364 void *get_fdt(unsigned long *fdt_size)
368 fdt = get_efi_config_table(DEVICE_TREE_GUID);
373 if (fdt_check_header(fdt) != 0) {
374 efi_err("Invalid header detected on UEFI supplied FDT, ignoring ...\n");
377 *fdt_size = fdt_totalsize(fdt);