]> git.proxmox.com Git - mirror_edk2.git/commit
Ovmf/HardwareInfoLib: Create Pei lib to parse directly from fw-cfg
authorNicolas Ojeda Leon <ncoleon@amazon.com>
Wed, 19 Jan 2022 09:49:15 +0000 (10:49 +0100)
committermergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
Wed, 22 Jun 2022 15:34:16 +0000 (15:34 +0000)
commit2b1a5b8c613301311113e1efc6fc65478e2e6365
tree2dfd284b81505c0675d8ea49080944502cf56f03
parent6c9f218bc0d967bea99b139e190a11b703de4d6c
Ovmf/HardwareInfoLib: Create Pei lib to parse directly from fw-cfg

Define the HardwareInfoLib API and create the PeiHardwareInfoLib
which implements it, specifically for Pei usage, supporting
only static accesses to parse data directly from a fw-cfg file.
All list-like APIs are implemented as unsupported and only a
fw-cfg wrapper to read hardware info elements is provided.

The Hardware Info library is intended to describe non-discoverable
hardware information and share that from the host to the guest in Ovmf
platforms. The QEMU fw-cfg extension for this library provides a first
variation to parse hardware info by reading it directly from a fw-cfg
file. This library offers a wrapper function to the plain
QmeuFwCfgReadBytes which, specifically, parses header-data pairs out
of the binary values in the file. For this purpose, the approach is
incremental, reading the file block by block and outputting the values
only for a specific known hardware type (e.g. PCI host bridges). One
element is returned in each call until the end of the file is reached.

Considering fw-cfg as the first means to transport hardware info from
the host to the guest, this wrapping library offers the possibility
to statically, and in steps, read a specific type of hardware info
elements out of the file. This method reads one hardware element of a
specific type at a time, without the need to pre-allocate memory and
read the whole file or dynamically allocate memory for each new
element found.

As a usage example, the static approach followed by this library
enables early UEFI stages to use and read hardware information
supplied by the host. For instance, in early times of the PEI stage,
hardware information can be parsed out from a fw-cfg file prescinding
from memory services, that may not yet be available, and avoiding
dynamic memory allocations.

Cc: Alexander Graf <graf@amazon.de>
Cc: Gerd Hoffmann <kraxel@redhat.com>
Acked-by: Gerd Hoffmann <kraxel@redhat.com>
Signed-off-by: Nicolas Ojeda Leon <ncoleon@amazon.com>
14 files changed:
ArmVirtPkg/ArmVirtQemu.dsc
OvmfPkg/AmdSev/AmdSevX64.dsc
OvmfPkg/Bhyve/BhyveX64.dsc
OvmfPkg/CloudHv/CloudHvX64.dsc
OvmfPkg/Include/Library/HardwareInfoLib.h [new file with mode: 0644]
OvmfPkg/Library/HardwareInfoLib/HardwareInfoPei.c [new file with mode: 0644]
OvmfPkg/Library/HardwareInfoLib/PeiHardwareInfoLib.inf [new file with mode: 0644]
OvmfPkg/Library/HardwareInfoLib/QemuFwCfgHardwareInfoLib.c [new file with mode: 0644]
OvmfPkg/Microvm/MicrovmX64.dsc
OvmfPkg/OvmfPkg.dec
OvmfPkg/OvmfPkgIa32.dsc
OvmfPkg/OvmfPkgIa32X64.dsc
OvmfPkg/OvmfPkgX64.dsc
OvmfPkg/OvmfXen.dsc