qemu/include/hw/loader-fit.h
Peter Maydell db0dd33559 hw/mips/boston: Support dumpdtb monitor commands
The boston machine doesn't set MachineState::fdt to the DTB blob that
it has loaded or created, which means that the QMP/HMP dumpdtb
monitor commands don't work.

Setting MachineState::fdt is easy in the non-FIT codepath: we can
simply do so immediately before loading the DTB into guest memory.
The FIT codepath is a bit more awkward as currently the FIT loader
throws away the memory that the FDT was in after it loads it into
guest memory.  So we add a void *pfdt argument to load_fit() for it
to store the FDT pointer into.

There is some readjustment required of the pointer handling in
loader-fit.c, so that it applies 'const' only where it should (e.g.
the data pointer we get back from fdt_getprop() is const, because
it's into the middle of the input FDT data, but the pointer that
fit_load_image_alloc() should not be const, because it's freshly
allocated memory that the caller can change if it likes).

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org>
Message-id: 20250206151214.2947842-5-peter.maydell@linaro.org
2025-02-24 15:03:42 +00:00

56 lines
2 KiB
C

/*
* Flattened Image Tree loader.
*
* Copyright (c) 2016 Imagination Technologies
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
*/
#ifndef HW_LOADER_FIT_H
#define HW_LOADER_FIT_H
#include "exec/hwaddr.h"
struct fit_loader_match {
const char *compatible;
const void *data;
};
struct fit_loader {
const struct fit_loader_match *matches;
hwaddr (*addr_to_phys)(void *opaque, uint64_t addr);
void *(*fdt_filter)(void *opaque, const void *fdt,
const void *match_data, hwaddr *load_addr);
const void *(*kernel_filter)(void *opaque, const void *kernel,
hwaddr *load_addr, hwaddr *entry_addr);
};
/**
* load_fit: load a FIT format image
* @ldr: structure defining board specific properties and hooks
* @filename: image to load
* @pfdt: pointer to update with address of FDT blob
* @opaque: opaque value passed back to the hook functions in @ldr
* Returns: 0 on success, or a negative errno on failure
*
* @pfdt is used to tell the caller about the FDT blob. On return, it
* has been set to point to the FDT blob, and it is now the caller's
* responsibility to free that memory with g_free(). Usually the caller
* will want to pass in &machine->fdt here, to record the FDT blob for
* the dumpdtb option and QMP/HMP commands.
*/
int load_fit(const struct fit_loader *ldr, const char *filename, void **pfdt,
void *opaque);
#endif /* HW_LOADER_FIT_H */