[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH] docs/generic-loader: mention U-Boot and Intel H
Re: [Qemu-devel] [PATCH] docs/generic-loader: mention U-Boot and Intel HEX executable formats
Thu, 16 Aug 2018 08:54:11 -0700
On Thu, Aug 16, 2018 at 7:55 AM, Stefan Hajnoczi <address@hidden> wrote:
> The generic loader device supports the U-Boot and Intel HEX executable
> formats in addition to the document raw and ELF formats. Reword the
> documentation to include these formats and explain how various options
> depend on the executable format.
> Signed-off-by: Stefan Hajnoczi <address@hidden>
Reviewed-by: Alistair Francis <address@hidden>
> Based-on: <address@hidden>
> docs/generic-loader.txt | 20 ++++++++++----------
> 1 file changed, 10 insertions(+), 10 deletions(-)
> diff --git a/docs/generic-loader.txt b/docs/generic-loader.txt
> index 31bbcd42f6..a9603a2af7 100644
> --- a/docs/generic-loader.txt
> +++ b/docs/generic-loader.txt
> @@ -56,25 +56,25 @@ An example of setting CPU 0's PC to 0x8000 is:
> Loading Files
> -The loader device also allows files to be loaded into memory. It can load raw
> -files and ELF executable files. Raw files are loaded verbatim. ELF
> -files are loaded by an ELF loader. The syntax is shown below:
> +The loader device also allows files to be loaded into memory. It can load
> +U-Boot, and Intel HEX executable formats as well as raw images. The syntax
> +shown below:
> <file> - A file to be loaded into memory
> - <addr> - The addr in memory that the file should be loaded. This is
> - ignored if you are using an ELF (unless force-raw is true).
> - This is required if you aren't loading an ELF.
> + <addr> - The memory address where the file should be loaded. This is
> + required for raw images and ignored for non-raw files.
> <cpu-num> - This specifies the CPU that should be used. This is an
> optional argument and will cause the CPU's PC to be set to
> - where the image is stored or in the case of an ELF file to
> - the value in the header. This option should only be used
> - for the boot image.
> + the memory address where the raw file is loaded or the
> + point specified in the executable format header. This
> + should only be used for the boot image.
> This will also cause the image to be written to the
> CPU's address space. If not specified, the default is CPU
> <force-raw> - Setting force-raw=on forces the file to be treated as a raw
> - image. This can be used to load ELF files as if they were
> + image. This can be used to load supported executable
> + as if they were raw.
> All values are parsed using the standard QemuOps parsing. This allows the
> to specify any values in any format supported. By default the values