blob: 87463e1e5bb822f9160739d07f98d81afe8f492b [file] [log] [blame]
Heinrich Schuchardtd46bee82021-02-20 10:00:19 +01001.. SPDX-License-Identifier: GPL-2.0+
2
3qfw command
4===========
5
6Synopsis
7--------
8
9::
10
11 qfw list
12 qfw cpus
13 qfw load [kernel_addr [initrd_addr]]
14
15Description
16-----------
17
18The *qfw* command is used to retrieve information form the QEMU firmware.
19
20The *qfw list* sub-command displays the QEMU firmware files.
21
22The *qfw cpus* sub-command displays the available CPUs.
23
24The *qfw load* command is used to load a kernel and an initial RAM disk.
25
26kernel_addr
27 address to which the file specified by the -kernel parameter of QEMU shall
28 be loaded. Defaults to environment variable *loadaddr* and further to
29 the value of *CONFIG_LOADADDR*.
30
31initrd_addr
32 address to which the file specified by the -initrd parameter of QEMU shall
33 be loaded. Defaults to environment variable *ramdiskaddr* and further to
34 the value of *CONFIG_RAMDISK_ADDR*.
35
36Examples
37--------
38
39QEMU firmware files are listed via the *qfw list* command:
40
41::
42
43 => qfw list
44 etc/boot-fail-wait
45 etc/smbios/smbios-tables
46 etc/smbios/smbios-anchor
47 etc/e820
48 genroms/kvmvapic.bin
49 genroms/linuxboot.bin
50 etc/system-states
51 etc/acpi/tables
52 etc/table-loader
53 etc/tpm/log
54 etc/acpi/rsdp
55 bootorder
56
57The available CPUs can be shown via the *qfw cpus* command:
58
59::
60
61 => qfw cpu
62 2 cpu(s) online
63
64The *-kernel* and *-initrd* parameters allow to specify a kernel and an
65initial RAM disk for QEMU:
66
67.. code-block:: bash
68
69 $ qemu-system-x86_64 -machine pc-i440fx-2.5 -bios u-boot.rom -m 1G \
70 -nographic -kernel vmlinuz -initrd initrd
71
72Now the kernel and the initial RAM disk can be loaded to the U-Boot memory via
73the *qfw load* command and booted thereafter.
74
75::
76
77 => qfw load ${kernel_addr_r} ${ramdisk_addr_r}
78 loading kernel to address 0000000001000000 size 5048f0 initrd 0000000004000000 size 3c94891
79 => zboot 1000000 5048f0 4000000 3c94891
80 Valid Boot Flag
81 Magic signature found
82 Linux kernel version 4.19.0-14-amd64 (debian-kernel@lists.debian.org) #1 SMP Debian 4.19.171-2 (2021-01-30)
83 Building boot_params at 0x00090000
84 Loading bzImage at address 100000 (5260160 bytes)
85
86Configuration
87-------------
88
89The qfw command is only available if CONFIG_CMD_QFW=y.