On 12/17/14 18:44, Olivier Martin wrote:
> Hmm, it is possible I missed something in your patch.
> But am I right to understand this patch will bypass the BDS when the
> arguments '-kernel', '-initrd' and '-append' are added to qEmu?
Yes, definitely. That's an actual goal here, and it's how OVMF works too.
> I can see an issue if someone wants to reboot the 'virt' platform for
> instance to try UEFI variable 'BootNext' after starting qEmu with the above
> parameters. It might be the case if someone wants to try to install an OS
> from qEmu after using '-kernel', '-initrd' and '-append'.
-kernel / -initrd / -append are very special flags.
First, they are development help for kernel developers who want a quick
turnaround. Build the new kernel image (with EFI stub) on the host, and
run it at once in the guest, without messing with disk images and boot
loaders.
The second use case for these options is libguestfs, which is basically
a specialized Linux guest and associated host side tools for
manipulating guest images. You issue commands on the host side, which
are transferred over virtio-serial to the linux guest, which runs a
special daemon that acts upon those commands. The point is that the disk
image can be "malicious" and this way the filesystem drivers etc. run in
the guest, not on the host.
A UEFI environment has been deemed beneficial for this guest type. It
certainly will not mess with BootNext, install another guest OS, and so
on. The variable store it will have will probably be temporary.
The third use case is "virt-install --location". This downloads an
extracted kernel and initrd image from some web directory, and boots
them. The initrd contains an Anaconda (or another Linux installer)
environment, which performs an installation from the network. Once it's
done, Anaconda calls efibootmgr to set up boot variables (which is an
immediate reason why a UEFI environment is needed), and then reboots the
machine.
And, you are right, at this point the kernel / initrd image *would* be
again booted, even on x86 guests, even on *SeaBIOS* (not OVMF) --
SeaBIOS is the firmware that has supported this first. Therefore,
'virt-install --location' instructs libvirtd to *rewire* the reboot
action of the guest, and when Anaconda reboots the guest, qemu actually
performs a complete poweroff. Then libvirt starts up the guest again in
a *new* VM instance, and that VM instance doesn't have -kernel / -initrd
/ -append any longer.
In short, the functionality here mirrors the x86 OVMF and SeaBIOS
behavior closely, because that's what the libvirt tools (and other
tools) know how to handle.
> Another issue is you must provide an '-initrd' to boot a given '-kernel' -
> you do not handle the case when there is no '-initrd'. As far as I know
> initrd is not mandatory to boot a Linux kernel.
Lack of -initrd results in a zero-sized initrd file in the synthetic
filesystem, and a kernel command line parameter that references that
zero sized file ("initrd=initrd"), so the firmware code itself does not
break.
Second, AFAICT there's basically no modern Linux system that is possible
to boot without an appropriate initrd *at all*. But, if you insist, I
can add a small check that avoids appending the "initrd=initrd" kernel
command line option if the initrd size is zero.
>
> Final comment, there is a typo issue in your comment. You wrote '-append'
> instead of '-cmdline'.
Where is that?
If you mean the commit message, then -append is correct. That's the qemu
command line parameter; not -cmdline. cmdline is just the name of the
file in the synthetic filesystem, and it could be anything at all,
because the kernel doesn't reference it. I just put it there for
consistency with the other files.
So... if you accept my explanation, then the only thing to decide is if
you'd like me to prevent appending "initrd=initrd" to the kernel command
line if the initrd has zero size.
Thanks
Laszlo
>
>> -----Original Message-----
>> From: Laszlo Ersek [mailto:[email protected]]
>> Sent: 11 December 2014 02:46
>> To: [email protected]; [email protected];
>> [email protected]; [email protected]
>> Subject: [edk2] [PATCH v3 13/13] ArmVirtualizationPkg: Intel BDS: load
>> EFI-stubbed Linux kernel from fw_cfg
>>
>> A number of tools depend on passing the kernel image, the initial
>> ramdisk,
>> and the kernel command line to the guest on the QEMU command line
>> (options
>> -kernel, -initrd, -append, respectively). At the moment, these QEMU
>> options work, but the guest kernel loaded this way is launched by a
>> minimal binary firmware that is dynamically composed by QEMU. As a
>> consequence, such a kernel has no UEFI environment.
>>
>> This patch enables -kernel, -initrd, -append to work on top of the
>> ArmVirtualizationQemu firmware build. The approach it takes is
>> different
>> from how the same functionality is implemented in OvmfPkg.
>>
>> OvmfPkg contains a full-fledged Linux boot loader (see
>> "OvmfPkg/Library/PlatformBdsLib/QemuKernel.c" and
>> "OvmfPkg/Library/LoadLinuxLib/"). OVMF's LoadLinuxLib sets up the
>> required
>> kernel environment in a sophisticated way (including x86-specific
>> artifacts like the GDT), calls ExitBootServices() itself (for legacy
>> kernels without EFI handover protocol), and jumps to the kernel (using
>> x86
>> assembly).
>>
>> In ArmVirtualizationPkg's PlatformIntelBdsLib, we require the kernel
>> being
>> loaded to have an EFI stub -- that is, to be a genuine UEFI
>> application.
>>
>> (The EFI stub is not an additional burden for guest kernels -- the EFI
>> stub is a hard requirement anyway because it needs to process the DTB
>> heavily:
>> - it removes memory nodes,
>> - it removes memreserve entries,
>> - it adds UEFI properties to the "chosen" node,
>> - it calculates and installs virt-to-phys mappings with
>> SetVirtualAddressMap() in a way that enables kexec [planned].
>>
>> Kudos to Ard Biesheuvel for summarizing the above.)
>>
>> An EFI-stubbed Linux guest kernel can be loaded with plain
>> gBS->LoadImage(). The EFI stub will look up its own
>> EFI_LOADED_IMAGE_DEVICE_PATH_PROTOCOL instance (ie. the device path
>> where
>> it has been loaded from), and it will locate the initial ramdisk named
>> by
>> the "initrd" command line parameter as a *sibling file* on the same
>> device.
>>
>> The initrd file is then loaded using the
>> EFI_SIMPLE_FILE_SYSTEM_PROTOCOL.
>>
>> This approach enables the EFI stub to load the initial ramdisk from
>> normal
>> EFI System Partitions, from remote PXE/TFTP directories -- and it
>> enables
>> us to provide the initrd from memory as well.
>>
>> In this patch:
>>
>> - We download the kernel image, the initrd image, and the kernel
>> command
>> line, using QEMU's fw_cfg interface.
>>
>> - We create a read-only EFI_SIMPLE_FILE_SYSTEM_PROTOCOL instance that
>> has
>> just a root directory, with the three downloaded files in it.
>>
>> - The handle that carries the simple file system has a single-node
>> VenHw(...) device path (not counting the terminator node).
>>
>> - We load the EFI-stubbed kernel (which is a UEFI application) with
>> gBS->LoadImage(), passing "VenHw(...)/kernel" as device path. This
>> causes gBS->LoadImage() to call back into our filesystem.
>>
>> - Appended to the downloaded command line, we pass "initrd=initrd" to
>> the
>> EFI stub.
>>
>> - Once the EFI stub is running, it loads the initial ramdisk from the
>> "sibling" device path "VenHw(...)/initrd", also calling back into our
>> filesystem.
>>
>> Contributed-under: TianoCore Contribution Agreement 1.0
>> Signed-off-by: Laszlo Ersek <[email protected]>
>> ---
>>
>> Notes:
>> v3:
>> - Include the patch in this fw_cfg patchset, fusing the two earlier
>> series.
>>
>> - Const-qualify constant fields in KERNEL_BLOB.
>>
>> This makes it easier to follow what fields are to be populated at
>> runtime.
>>
>> - StubFileRead(): don't add to NULL pointer.
>>
>> The expression
>>
>> Blob->Data + StubFile->Position
>>
>> invokes undefined behavior if Blob->Data is NULL, which is the
>> case
>> when Blob->Size equals zero. (Refer to how blobs are downloaded
>> near
>> the beginning of TryRunningQemuKernel().)
>>
>> - TryRunningQemuKernel(): set status on allocation failure.
>>
>> When AllocatePool() fails to allocate memory for the loaded
>> kernel
>> image's options, we must set Status (the return value of
>> TryRunningQemuKernel) to EFI_OUT_OF_RESOURCES.
>>
>> - TryRunningQemuKernel(): split out FetchBlob().
>>
>> The TryRunningQemuKernel() function has grown somewhat large,
>> let's
>> split out a blob reader helper function.
>>
>> - FetchBlob(): read in 1MB chunks.
>>
>> The kernel and initrd blobs can be tens of megabytes big each --
>> print
>> an informative message after every 1MB on the EFI_D_VERBOSE
>> level.
>>
>>
>> ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Platfor
>> mIntelBdsLib.inf | 10 +
>>
>> ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/IntelBd
>> sPlatform.h | 22 ++
>>
>> ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/IntelBd
>> sPlatform.c | 5 +
>>
>> ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/QemuKer
>> nel.c | 1088
>> +++++++++++++++++++++++++++++++++++++++++++++++++++++
>> 4 files changed, 1125 insertions(+)
>>
>> diff --git
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Platf
>> ormIntelBdsLib.inf
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Platf
>> ormIntelBdsLib.inf
>> index efd50f3..8db2ad5 100644
>> ---
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Platf
>> ormIntelBdsLib.inf
>> +++
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Platf
>> ormIntelBdsLib.inf
>> @@ -33,6 +33,7 @@
>> [Sources]
>> IntelBdsPlatform.c
>> IntelBdsPlatform.h
>> + QemuKernel.c
>>
>> [Packages]
>> ArmPkg/ArmPkg.dec
>> @@ -53,9 +54,15 @@
>> PcdLib
>> GenericBdsLib
>> QemuBootOrderLib
>> + QemuFwCfgLib
>> + PrintLib
>> + UefiRuntimeServicesTableLib
>>
>> [Guids]
>> gArmGlobalVariableGuid
>> + gEfiFileInfoGuid
>> + gEfiFileSystemInfoGuid
>> + gEfiFileSystemVolumeLabelInfoIdGuid
>>
>> [Pcd]
>> gArmPlatformTokenSpaceGuid.PcdDefaultConInPaths
>> @@ -65,3 +72,6 @@
>> [Protocols]
>> gEfiDevicePathFromTextProtocolGuid
>> gEfiDevicePathToTextProtocolGuid
>> + gEfiDevicePathProtocolGuid
>> + gEfiLoadedImageProtocolGuid
>> + gEfiSimpleFileSystemProtocolGuid
>> diff --git
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.h
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.h
>> index c50bda2..cfc496d 100644
>> ---
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.h
>> +++
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.h
>> @@ -38,4 +38,26 @@ PlatformBdsEnterFrontPage (
>> IN BOOLEAN ConnectAllHappened
>> );
>>
>> +/**
>> + Download the kernel, the initial ramdisk, and the kernel command
>> line from
>> + QEMU's fw_cfg. Construct a minimal SimpleFileSystem that contains
>> the two
>> + image files, and load and start the kernel from it.
>> +
>> + The kernel will be instructed via its command line to load the
>> initrd from
>> + the same Simple FileSystem.
>> +
>> + @retval EFI_NOT_FOUND Kernel image was not found.
>> + @retval EFI_OUT_OF_RESOURCES Memory allocation failed.
>> + @retval EFI_PROTOCOL_ERROR Unterminated kernel command line.
>> +
>> + @return Error codes from any of the underlying
>> + functions. On success, the function
>> doesn't
>> + return.
>> +**/
>> +EFI_STATUS
>> +EFIAPI
>> +TryRunningQemuKernel (
>> + VOID
>> + );
>> +
>> #endif // _INTEL_BDS_PLATFORM_H
>> diff --git
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.c
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.c
>> index 9b91368..42f1e7c 100644
>> ---
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.c
>> +++
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/Intel
>> BdsPlatform.c
>> @@ -305,6 +305,11 @@ PlatformBdsPolicyBehavior (
>> Status = PlatformBdsConnectConsole ();
>> ASSERT_EFI_ERROR (Status);
>>
>> + //
>> + // Process QEMU's -kernel command line option
>> + //
>> + TryRunningQemuKernel ();
>> +
>> BdsLibConnectAll ();
>> BdsLibEnumerateAllBootOption (BootOptionList);
>>
>> diff --git
>> a/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/QemuK
>> ernel.c
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/QemuK
>> ernel.c
>> new file mode 100644
>> index 0000000..42d88f3
>> --- /dev/null
>> +++
>> b/ArmPlatformPkg/ArmVirtualizationPkg/Library/PlatformIntelBdsLib/QemuK
>> ernel.c
>> @@ -0,0 +1,1088 @@
>> +/** @file
>> + Try to load an EFI-stubbed ARM Linux kernel from QEMU's fw_cfg.
>> +
>> + This implementation differs from OvmfPkg/Library/LoadLinuxLib. An
>> EFI
>> + stub in the subject kernel is a hard requirement here.
>> +
>> + Copyright (C) 2014, Red Hat, Inc.
>> +
>> + This program and the accompanying materials are licensed and made
>> available
>> + under the terms and conditions of the BSD License which accompanies
>> this
>> + distribution. The full text of the license may be found at
>> + http://opensource.org/licenses/bsd-license.php
>> +
>> + THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
>> BASIS, WITHOUT
>> + WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
>> IMPLIED.
>> +**/
>> +
>> +#include <Guid/FileInfo.h>
>> +#include <Guid/FileSystemInfo.h>
>> +#include <Guid/FileSystemVolumeLabelInfo.h>
>> +#include <Library/PrintLib.h>
>> +#include <Library/QemuFwCfgLib.h>
>> +#include <Protocol/DevicePath.h>
>> +#include <Protocol/LoadedImage.h>
>> +#include <Protocol/SimpleFileSystem.h>
>> +
>> +#include "IntelBdsPlatform.h"
>> +
>> +//
>> +// Static data that hosts the fw_cfg blobs and serves file requests.
>> +//
>> +typedef enum {
>> + KernelBlobTypeKernel,
>> + KernelBlobTypeInitrd,
>> + KernelBlobTypeCommandLine,
>> + KernelBlobTypeMax
>> +} KERNEL_BLOB_TYPE;
>> +
>> +typedef struct {
>> + FIRMWARE_CONFIG_ITEM CONST SizeKey;
>> + FIRMWARE_CONFIG_ITEM CONST DataKey;
>> + CONST CHAR16 * CONST Name;
>> + UINT32 Size;
>> + UINT8 *Data;
>> +} KERNEL_BLOB;
>> +
>> +STATIC KERNEL_BLOB mKernelBlob[KernelBlobTypeMax] = {
>> + { QemuFwCfgItemKernelSize, QemuFwCfgItemKernelData,
>> L"kernel" },
>> + { QemuFwCfgItemInitrdSize, QemuFwCfgItemInitrdData,
>> L"initrd" },
>> + { QemuFwCfgItemCommandLineSize, QemuFwCfgItemCommandLineData,
>> L"cmdline" }
>> +};
>> +
>> +STATIC UINT64 mTotalBlobBytes;
>> +
>> +//
>> +// Device path for the handle that incorporates our "EFI stub
>> filesystem". The
>> +// GUID is arbitrary and need not be standardized or advertized.
>> +//
>> +#pragma pack(1)
>> +typedef struct {
>> + VENDOR_DEVICE_PATH VenHwNode;
>> + EFI_DEVICE_PATH_PROTOCOL EndNode;
>> +} SINGLE_VENHW_NODE_DEVPATH;
>> +#pragma pack()
>> +
>> +STATIC CONST SINGLE_VENHW_NODE_DEVPATH mFileSystemDevicePath = {
>> + {
>> + { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, { sizeof
>> (VENDOR_DEVICE_PATH) } },
>> + {
>> + 0xb0fae7e7, 0x6b07, 0x49d0,
>> + { 0x9e, 0x5b, 0x3b, 0xde, 0xc8, 0x3b, 0x03, 0x9d }
>> + }
>> + },
>> +
>> + {
>> + END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE,
>> + { sizeof (EFI_DEVICE_PATH_PROTOCOL) }
>> + }
>> +};
>> +
>> +//
>> +// The "file in the EFI stub filesystem" abstraction.
>> +//
>> +STATIC EFI_TIME mInitTime;
>> +
>> +#define STUB_FILE_SIG SIGNATURE_64 ('S', 'T', 'U', 'B', 'F', 'I', 'L',
>> 'E')
>> +
>> +typedef struct {
>> + UINT64 Signature; // Carries STUB_FILE_SIG.
>> +
>> + KERNEL_BLOB_TYPE BlobType; // Index into mKernelBlob.
>> KernelBlobTypeMax
>> + // denotes the root directory of the
>> filesystem.
>> +
>> + UINT64 Position; // Byte position for regular files;
>> + // next directory entry to return for
>> the root
>> + // directory.
>> +
>> + EFI_FILE_PROTOCOL File; // Standard protocol interface.
>> +} STUB_FILE;
>> +
>> +#define STUB_FILE_FROM_FILE(FilePointer) \
>> + CR (FilePointer, STUB_FILE, File, STUB_FILE_SIG)
>> +
>> +//
>> +// Tentative definition of the file protocol template. The initializer
>> +// (external definition) will be provided later.
>> +//
>> +STATIC CONST EFI_FILE_PROTOCOL mEfiFileProtocolTemplate;
>> +
>> +
>> +//
>> +// Protocol member functions for File.
>> +//
>> +
>> +/**
>> + Opens a new file relative to the source file's location.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL instance
>> that is
>> + the file handle to the source location. This
>> would
>> + typically be an open handle to a directory.
>> +
>> + @param[out] NewHandle A pointer to the location to return the
>> opened handle
>> + for the new file.
>> +
>> + @param[in] FileName The Null-terminated string of the name of
>> the file to
>> + be opened. The file name may contain the
>> following
>> + path modifiers: "\", ".", and "..".
>> +
>> + @param[in] OpenMode The mode to open the file. The only valid
>> + combinations that the file may be opened
>> with are:
>> + Read, Read/Write, or Create/Read/Write.
>> +
>> + @param[in] Attributes Only valid for EFI_FILE_MODE_CREATE, in
>> which case
>> + these are the attribute bits for the newly
>> created
>> + file.
>> +
>> + @retval EFI_SUCCESS The file was opened.
>> + @retval EFI_NOT_FOUND The specified file could not be found
>> on the
>> + device.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_MEDIA_CHANGED The device has a different medium in
>> it or the
>> + medium is no longer supported.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_WRITE_PROTECTED An attempt was made to create a file,
>> or open a
>> + file for write when the media is
>> + write-protected.
>> + @retval EFI_ACCESS_DENIED The service denied access to the file.
>> + @retval EFI_OUT_OF_RESOURCES Not enough resources were available to
>> open the
>> + file.
>> + @retval EFI_VOLUME_FULL The volume is full.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileOpen (
>> + IN EFI_FILE_PROTOCOL *This,
>> + OUT EFI_FILE_PROTOCOL **NewHandle,
>> + IN CHAR16 *FileName,
>> + IN UINT64 OpenMode,
>> + IN UINT64 Attributes
>> + )
>> +{
>> + CONST STUB_FILE *StubFile;
>> + UINTN BlobType;
>> + STUB_FILE *NewStubFile;
>> +
>> + //
>> + // We're read-only.
>> + //
>> + switch (OpenMode) {
>> + case EFI_FILE_MODE_READ:
>> + break;
>> +
>> + case EFI_FILE_MODE_READ | EFI_FILE_MODE_WRITE:
>> + case EFI_FILE_MODE_READ | EFI_FILE_MODE_WRITE |
>> EFI_FILE_MODE_CREATE:
>> + return EFI_WRITE_PROTECTED;
>> +
>> + default:
>> + return EFI_INVALID_PARAMETER;
>> + }
>> +
>> + //
>> + // Only the root directory supports opening files in it.
>> + //
>> + StubFile = STUB_FILE_FROM_FILE (This);
>> + if (StubFile->BlobType != KernelBlobTypeMax) {
>> + return EFI_UNSUPPORTED;
>> + }
>> +
>> + //
>> + // Locate the file.
>> + //
>> + for (BlobType = 0; BlobType < KernelBlobTypeMax; ++BlobType) {
>> + if (StrCmp (FileName, mKernelBlob[BlobType].Name) == 0) {
>> + break;
>> + }
>> + }
>> + if (BlobType == KernelBlobTypeMax) {
>> + return EFI_NOT_FOUND;
>> + }
>> +
>> + //
>> + // Found it.
>> + //
>> + NewStubFile = AllocatePool (sizeof *NewStubFile);
>> + if (NewStubFile == NULL) {
>> + return EFI_OUT_OF_RESOURCES;
>> + }
>> +
>> + NewStubFile->Signature = STUB_FILE_SIG;
>> + NewStubFile->BlobType = (KERNEL_BLOB_TYPE)BlobType;
>> + NewStubFile->Position = 0;
>> + CopyMem (&NewStubFile->File, &mEfiFileProtocolTemplate,
>> + sizeof mEfiFileProtocolTemplate);
>> + *NewHandle = &NewStubFile->File;
>> +
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +/**
>> + Closes a specified file handle.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL instance that is
>> the file
>> + handle to close.
>> +
>> + @retval EFI_SUCCESS The file was closed.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileClose (
>> + IN EFI_FILE_PROTOCOL *This
>> + )
>> +{
>> + FreePool (STUB_FILE_FROM_FILE (This));
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +/**
>> + Close and delete the file handle.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL instance that is
>> the
>> + handle to the file to delete.
>> +
>> + @retval EFI_SUCCESS The file was closed and deleted,
>> and the
>> + handle was closed.
>> + @retval EFI_WARN_DELETE_FAILURE The handle was closed, but the file
>> was not
>> + deleted.
>> +
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileDelete (
>> + IN EFI_FILE_PROTOCOL *This
>> + )
>> +{
>> + FreePool (STUB_FILE_FROM_FILE (This));
>> + return EFI_WARN_DELETE_FAILURE;
>> +}
>> +
>> +
>> +/**
>> + Helper function that formats an EFI_FILE_INFO structure into the
>> + user-allocated buffer, for any valid KERNEL_BLOB_TYPE value
>> (including
>> + KernelBlobTypeMax, which stands for the root directory).
>> +
>> + The interface follows the EFI_FILE_GET_INFO -- and for directories,
>> the
>> + EFI_FILE_READ -- interfaces.
>> +
>> + @param[in] BlobType The KERNEL_BLOB_TYPE value identifying
>> the fw_cfg
>> + blob backing the STUB_FILE that
>> information is
>> + being requested about. If BlobType
>> equals
>> + KernelBlobTypeMax, then information will
>> be
>> + provided about the root directory of the
>> + filesystem.
>> +
>> + @param[in,out] BufferSize On input, the size of Buffer. On output,
>> the
>> + amount of data returned in Buffer. In
>> both cases,
>> + the size is measured in bytes.
>> +
>> + @param[out] Buffer A pointer to the data buffer to return.
>> The
>> + buffer's type is EFI_FILE_INFO.
>> +
>> + @retval EFI_SUCCESS The information was returned.
>> + @retval EFI_BUFFER_TOO_SMALL BufferSize is too small to store the
>> + EFI_FILE_INFO structure. BufferSize
>> has been
>> + updated with the size needed to
>> complete the
>> + request.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +ConvertKernelBlobTypeToFileInfo (
>> + IN KERNEL_BLOB_TYPE BlobType,
>> + IN OUT UINTN *BufferSize,
>> + OUT VOID *Buffer
>> + )
>> +{
>> + CONST CHAR16 *Name;
>> + UINT64 FileSize;
>> + UINT64 Attribute;
>> +
>> + UINTN NameSize;
>> + UINTN FileInfoSize;
>> + EFI_FILE_INFO *FileInfo;
>> + UINTN OriginalBufferSize;
>> +
>> + if (BlobType == KernelBlobTypeMax) {
>> + //
>> + // getting file info about the root directory
>> + //
>> + Name = L"\\";
>> + FileSize = KernelBlobTypeMax;
>> + Attribute = EFI_FILE_READ_ONLY | EFI_FILE_DIRECTORY;
>> + } else {
>> + CONST KERNEL_BLOB *Blob;
>> +
>> + Blob = &mKernelBlob[BlobType];
>> + Name = Blob->Name;
>> + FileSize = Blob->Size;
>> + Attribute = EFI_FILE_READ_ONLY;
>> + }
>> +
>> + NameSize = (StrLen(Name) + 1) * 2;
>> + FileInfoSize = OFFSET_OF (EFI_FILE_INFO, FileName) + NameSize;
>> + ASSERT (FileInfoSize >= sizeof *FileInfo);
>> +
>> + OriginalBufferSize = *BufferSize;
>> + *BufferSize = FileInfoSize;
>> + if (OriginalBufferSize < *BufferSize) {
>> + return EFI_BUFFER_TOO_SMALL;
>> + }
>> +
>> + FileInfo = (EFI_FILE_INFO *)Buffer;
>> + FileInfo->Size = FileInfoSize;
>> + FileInfo->FileSize = FileSize;
>> + FileInfo->PhysicalSize = FileSize;
>> + FileInfo->Attribute = Attribute;
>> +
>> + CopyMem (&FileInfo->CreateTime, &mInitTime, sizeof mInitTime);
>> + CopyMem (&FileInfo->LastAccessTime, &mInitTime, sizeof mInitTime);
>> + CopyMem (&FileInfo->ModificationTime, &mInitTime, sizeof mInitTime);
>> + CopyMem (FileInfo->FileName, Name, NameSize);
>> +
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +/**
>> + Reads data from a file, or continues scanning a directory.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL
>> instance that
>> + is the file handle to read data from.
>> +
>> + @param[in,out] BufferSize On input, the size of the Buffer. On
>> output, the
>> + amount of data returned in Buffer. In
>> both cases,
>> + the size is measured in bytes. If the
>> read goes
>> + beyond the end of the file, the read
>> length is
>> + truncated to the end of the file.
>> +
>> + If This is a directory, the function
>> reads the
>> + directory entry at the current position
>> and
>> + returns the entry (as EFI_FILE_INFO) in
>> Buffer. If
>> + there are no more directory entries, the
>> + BufferSize is set to zero on output.
>> +
>> + @param[out] Buffer The buffer into which the data is read.
>> +
>> + @retval EFI_SUCCESS Data was read.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_DEVICE_ERROR An attempt was made to read from a
>> deleted
>> + file.
>> + @retval EFI_DEVICE_ERROR On entry, the current file position is
>> beyond
>> + the end of the file.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small to store
>> the
>> + current directory entry as a
>> EFI_FILE_INFO
>> + structure. BufferSize has been updated
>> with the
>> + size needed to complete the request,
>> and the
>> + directory position has not been
>> advanced.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileRead (
>> + IN EFI_FILE_PROTOCOL *This,
>> + IN OUT UINTN *BufferSize,
>> + OUT VOID *Buffer
>> + )
>> +{
>> + STUB_FILE *StubFile;
>> + CONST KERNEL_BLOB *Blob;
>> + UINT64 Left;
>> +
>> + StubFile = STUB_FILE_FROM_FILE (This);
>> +
>> + //
>> + // Scanning the root directory?
>> + //
>> + if (StubFile->BlobType == KernelBlobTypeMax) {
>> + EFI_STATUS Status;
>> +
>> + if (StubFile->Position == KernelBlobTypeMax) {
>> + //
>> + // Scanning complete.
>> + //
>> + *BufferSize = 0;
>> + return EFI_SUCCESS;
>> + }
>> +
>> + Status = ConvertKernelBlobTypeToFileInfo (StubFile->Position,
>> BufferSize,
>> + Buffer);
>> + if (EFI_ERROR (Status)) {
>> + return Status;
>> + }
>> +
>> + ++StubFile->Position;
>> + return EFI_SUCCESS;
>> + }
>> +
>> + //
>> + // Reading a file.
>> + //
>> + Blob = &mKernelBlob[StubFile->BlobType];
>> + if (StubFile->Position > Blob->Size) {
>> + return EFI_DEVICE_ERROR;
>> + }
>> +
>> + Left = Blob->Size - StubFile->Position;
>> + if (*BufferSize > Left) {
>> + *BufferSize = (UINTN)Left;
>> + }
>> + if (Blob->Data != NULL) {
>> + CopyMem (Buffer, Blob->Data + StubFile->Position, *BufferSize);
>> + }
>> + StubFile->Position += *BufferSize;
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +/**
>> + Writes data to a file.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL
>> instance that
>> + is the file handle to write data to.
>> +
>> + @param[in,out] BufferSize On input, the size of the Buffer. On
>> output, the
>> + amount of data actually written. In both
>> cases,
>> + the size is measured in bytes.
>> +
>> + @param[in] Buffer The buffer of data to write.
>> +
>> + @retval EFI_SUCCESS Data was written.
>> + @retval EFI_UNSUPPORTED Writes to open directory files are not
>> + supported.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_DEVICE_ERROR An attempt was made to write to a
>> deleted file.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_WRITE_PROTECTED The file or medium is write-protected.
>> + @retval EFI_ACCESS_DENIED The file was opened read only.
>> + @retval EFI_VOLUME_FULL The volume is full.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileWrite (
>> + IN EFI_FILE_PROTOCOL *This,
>> + IN OUT UINTN *BufferSize,
>> + IN VOID *Buffer
>> + )
>> +{
>> + STUB_FILE *StubFile;
>> +
>> + StubFile = STUB_FILE_FROM_FILE (This);
>> + return (StubFile->BlobType == KernelBlobTypeMax) ?
>> + EFI_UNSUPPORTED :
>> + EFI_WRITE_PROTECTED;
>> +}
>> +
>> +
>> +/**
>> + Returns a file's current position.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL instance
>> that is the
>> + file handle to get the current position on.
>> +
>> + @param[out] Position The address to return the file's current
>> position
>> + value.
>> +
>> + @retval EFI_SUCCESS The position was returned.
>> + @retval EFI_UNSUPPORTED The request is not valid on open
>> directories.
>> + @retval EFI_DEVICE_ERROR An attempt was made to get the position
>> from a
>> + deleted file.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileGetPosition (
>> + IN EFI_FILE_PROTOCOL *This,
>> + OUT UINT64 *Position
>> + )
>> +{
>> + STUB_FILE *StubFile;
>> +
>> + StubFile = STUB_FILE_FROM_FILE (This);
>> + if (StubFile->BlobType == KernelBlobTypeMax) {
>> + return EFI_UNSUPPORTED;
>> + }
>> +
>> + *Position = StubFile->Position;
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +/**
>> + Sets a file's current position.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL instance
>> that is the
>> + file handle to set the requested position on.
>> +
>> + @param[in] Position The byte position from the start of the file to
>> set. For
>> + regular files, MAX_UINT64 means "seek to end".
>> For
>> + directories, zero means "rewind directory
>> scan".
>> +
>> + @retval EFI_SUCCESS The position was set.
>> + @retval EFI_UNSUPPORTED The seek request for nonzero is not valid
>> on open
>> + directories.
>> + @retval EFI_DEVICE_ERROR An attempt was made to set the position of
>> a
>> + deleted file.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileSetPosition (
>> + IN EFI_FILE_PROTOCOL *This,
>> + IN UINT64 Position
>> + )
>> +{
>> + STUB_FILE *StubFile;
>> + KERNEL_BLOB *Blob;
>> +
>> + StubFile = STUB_FILE_FROM_FILE (This);
>> +
>> + if (StubFile->BlobType == KernelBlobTypeMax) {
>> + if (Position == 0) {
>> + //
>> + // rewinding a directory scan is allowed
>> + //
>> + StubFile->Position = 0;
>> + return EFI_SUCCESS;
>> + }
>> + return EFI_UNSUPPORTED;
>> + }
>> +
>> + //
>> + // regular file seek
>> + //
>> + Blob = &mKernelBlob[StubFile->BlobType];
>> + if (Position == MAX_UINT64) {
>> + //
>> + // seek to end
>> + //
>> + StubFile->Position = Blob->Size;
>> + } else {
>> + //
>> + // absolute seek from beginning -- seeking past the end is allowed
>> + //
>> + StubFile->Position = Position;
>> + }
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +/**
>> + Returns information about a file.
>> +
>> + @param[in] This A pointer to the EFI_FILE_PROTOCOL
>> instance
>> + that is the file handle the
>> requested
>> + information is for.
>> +
>> + @param[in] InformationType The type identifier GUID for the
>> information
>> + being requested. The following
>> information
>> + types are supported, storing the
>> + corresponding structures in Buffer:
>> +
>> + - gEfiFileInfoGuid: EFI_FILE_INFO
>> +
>> + - gEfiFileSystemInfoGuid:
>> + EFI_FILE_SYSTEM_INFO
>> +
>> + -
>> gEfiFileSystemVolumeLabelInfoIdGuid:
>> + EFI_FILE_SYSTEM_VOLUME_LABEL
>> +
>> + @param[in,out] BufferSize On input, the size of Buffer. On
>> output, the
>> + amount of data returned in Buffer.
>> In both
>> + cases, the size is measured in
>> bytes.
>> +
>> + @param[out] Buffer A pointer to the data buffer to
>> return. The
>> + buffer's type is indicated by
>> + InformationType.
>> +
>> + @retval EFI_SUCCESS The information was returned.
>> + @retval EFI_UNSUPPORTED The InformationType is not known.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small to store
>> the
>> + information structure requested by
>> + InformationType. BufferSize has been
>> updated
>> + with the size needed to complete the
>> request.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileGetInfo (
>> + IN EFI_FILE_PROTOCOL *This,
>> + IN EFI_GUID *InformationType,
>> + IN OUT UINTN *BufferSize,
>> + OUT VOID *Buffer
>> + )
>> +{
>> + CONST STUB_FILE *StubFile;
>> + UINTN OriginalBufferSize;
>> +
>> + StubFile = STUB_FILE_FROM_FILE (This);
>> +
>> + if (CompareGuid (InformationType, &gEfiFileInfoGuid)) {
>> + return ConvertKernelBlobTypeToFileInfo (StubFile->BlobType,
>> BufferSize,
>> + Buffer);
>> + }
>> +
>> + OriginalBufferSize = *BufferSize;
>> +
>> + if (CompareGuid (InformationType, &gEfiFileSystemInfoGuid)) {
>> + EFI_FILE_SYSTEM_INFO *FileSystemInfo;
>> +
>> + *BufferSize = sizeof *FileSystemInfo;
>> + if (OriginalBufferSize < *BufferSize) {
>> + return EFI_BUFFER_TOO_SMALL;
>> + }
>> +
>> + FileSystemInfo = (EFI_FILE_SYSTEM_INFO *)Buffer;
>> + FileSystemInfo->Size = sizeof *FileSystemInfo;
>> + FileSystemInfo->ReadOnly = TRUE;
>> + FileSystemInfo->VolumeSize = mTotalBlobBytes;
>> + FileSystemInfo->FreeSpace = 0;
>> + FileSystemInfo->BlockSize = 1;
>> + FileSystemInfo->VolumeLabel[0] = L'\0';
>> +
>> + return EFI_SUCCESS;
>> + }
>> +
>> + if (CompareGuid (InformationType,
>> &gEfiFileSystemVolumeLabelInfoIdGuid)) {
>> + EFI_FILE_SYSTEM_VOLUME_LABEL *FileSystemVolumeLabel;
>> +
>> + *BufferSize = sizeof *FileSystemVolumeLabel;
>> + if (OriginalBufferSize < *BufferSize) {
>> + return EFI_BUFFER_TOO_SMALL;
>> + }
>> +
>> + FileSystemVolumeLabel = (EFI_FILE_SYSTEM_VOLUME_LABEL *)Buffer;
>> + FileSystemVolumeLabel->VolumeLabel[0] = L'\0';
>> +
>> + return EFI_SUCCESS;
>> + }
>> +
>> + return EFI_UNSUPPORTED;
>> +}
>> +
>> +
>> +/**
>> + Sets information about a file.
>> +
>> + @param[in] File A pointer to the EFI_FILE_PROTOCOL
>> instance that
>> + is the file handle the information is
>> for.
>> +
>> + @param[in] InformationType The type identifier for the information
>> being
>> + set.
>> +
>> + @param[in] BufferSize The size, in bytes, of Buffer.
>> +
>> + @param[in] Buffer A pointer to the data buffer to write.
>> The
>> + buffer's type is indicated by
>> InformationType.
>> +
>> + @retval EFI_SUCCESS The information was set.
>> + @retval EFI_UNSUPPORTED The InformationType is not known.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_WRITE_PROTECTED InformationType is EFI_FILE_INFO_ID
>> and the
>> + media is read-only.
>> + @retval EFI_WRITE_PROTECTED InformationType is
>> + EFI_FILE_PROTOCOL_SYSTEM_INFO_ID and
>> the media
>> + is read only.
>> + @retval EFI_WRITE_PROTECTED InformationType is
>> + EFI_FILE_SYSTEM_VOLUME_LABEL_ID and
>> the media
>> + is read-only.
>> + @retval EFI_ACCESS_DENIED An attempt is made to change the name
>> of a file
>> + to a file that is already present.
>> + @retval EFI_ACCESS_DENIED An attempt is being made to change the
>> + EFI_FILE_DIRECTORY Attribute.
>> + @retval EFI_ACCESS_DENIED An attempt is being made to change the
>> size of
>> + a directory.
>> + @retval EFI_ACCESS_DENIED InformationType is EFI_FILE_INFO_ID
>> and the
>> + file was opened read-only and an
>> attempt is
>> + being made to modify a field other
>> than
>> + Attribute.
>> + @retval EFI_VOLUME_FULL The volume is full.
>> + @retval EFI_BAD_BUFFER_SIZE BufferSize is smaller than the size of
>> the type
>> + indicated by InformationType.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileSetInfo (
>> + IN EFI_FILE_PROTOCOL *This,
>> + IN EFI_GUID *InformationType,
>> + IN UINTN BufferSize,
>> + IN VOID *Buffer
>> + )
>> +{
>> + return EFI_WRITE_PROTECTED;
>> +}
>> +
>> +
>> +/**
>> + Flushes all modified data associated with a file to a device.
>> +
>> + @param [in] This A pointer to the EFI_FILE_PROTOCOL instance that
>> is the
>> + file handle to flush.
>> +
>> + @retval EFI_SUCCESS The data was flushed.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_WRITE_PROTECTED The file or medium is write-protected.
>> + @retval EFI_ACCESS_DENIED The file was opened read-only.
>> + @retval EFI_VOLUME_FULL The volume is full.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileFlush (
>> + IN EFI_FILE_PROTOCOL *This
>> + )
>> +{
>> + return EFI_WRITE_PROTECTED;
>> +}
>> +
>> +//
>> +// External definition of the file protocol template.
>> +//
>> +STATIC CONST EFI_FILE_PROTOCOL mEfiFileProtocolTemplate = {
>> + EFI_FILE_PROTOCOL_REVISION, // revision 1
>> + StubFileOpen,
>> + StubFileClose,
>> + StubFileDelete,
>> + StubFileRead,
>> + StubFileWrite,
>> + StubFileGetPosition,
>> + StubFileSetPosition,
>> + StubFileGetInfo,
>> + StubFileSetInfo,
>> + StubFileFlush,
>> + NULL, // OpenEx, revision 2
>> + NULL, // ReadEx, revision 2
>> + NULL, // WriteEx, revision 2
>> + NULL // FlushEx, revision 2
>> +};
>> +
>> +
>> +//
>> +// Protocol member functions for SimpleFileSystem.
>> +//
>> +
>> +/**
>> + Open the root directory on a volume.
>> +
>> + @param[in] This A pointer to the volume to open the root directory
>> on.
>> +
>> + @param[out] Root A pointer to the location to return the opened
>> file handle
>> + for the root directory in.
>> +
>> + @retval EFI_SUCCESS The device was opened.
>> + @retval EFI_UNSUPPORTED This volume does not support the
>> requested file
>> + system type.
>> + @retval EFI_NO_MEDIA The device has no medium.
>> + @retval EFI_DEVICE_ERROR The device reported an error.
>> + @retval EFI_VOLUME_CORRUPTED The file system structures are
>> corrupted.
>> + @retval EFI_ACCESS_DENIED The service denied access to the file.
>> + @retval EFI_OUT_OF_RESOURCES The volume was not opened due to lack
>> of
>> + resources.
>> + @retval EFI_MEDIA_CHANGED The device has a different medium in
>> it or the
>> + medium is no longer supported. Any
>> existing
>> + file handles for this volume are no
>> longer
>> + valid. To access the files on the new
>> medium,
>> + the volume must be reopened with
>> OpenVolume().
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +EFIAPI
>> +StubFileSystemOpenVolume (
>> + IN EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *This,
>> + OUT EFI_FILE_PROTOCOL **Root
>> + )
>> +{
>> + STUB_FILE *StubFile;
>> +
>> + StubFile = AllocatePool (sizeof *StubFile);
>> + if (StubFile == NULL) {
>> + return EFI_OUT_OF_RESOURCES;
>> + }
>> +
>> + StubFile->Signature = STUB_FILE_SIG;
>> + StubFile->BlobType = KernelBlobTypeMax;
>> + StubFile->Position = 0;
>> + CopyMem (&StubFile->File, &mEfiFileProtocolTemplate,
>> + sizeof mEfiFileProtocolTemplate);
>> + *Root = &StubFile->File;
>> +
>> + return EFI_SUCCESS;
>> +}
>> +
>> +STATIC CONST EFI_SIMPLE_FILE_SYSTEM_PROTOCOL mFileSystem = {
>> + EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION,
>> + StubFileSystemOpenVolume
>> +};
>> +
>> +
>> +//
>> +// Utility functions.
>> +//
>> +
>> +/**
>> + Populate a blob in mKernelBlob.
>> +
>> + param[in,out] Blob Pointer to the KERNEL_BLOB element in
>> mKernelBlob that is
>> + to be filled from fw_cfg.
>> +
>> + @retval EFI_SUCCESS Blob has been populated. If fw_cfg
>> reported a
>> + size of zero for the blob, then Blob-
>>> Data has
>> + been left unchanged.
>> +
>> + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory for Blob-
>>> Data.
>> +**/
>> +STATIC
>> +EFI_STATUS
>> +FetchBlob (
>> + IN OUT KERNEL_BLOB *Blob
>> + )
>> +{
>> + UINT32 Left;
>> +
>> + //
>> + // Read blob size.
>> + //
>> + QemuFwCfgSelectItem (Blob->SizeKey);
>> + Blob->Size = QemuFwCfgRead32 ();
>> + if (Blob->Size == 0) {
>> + return EFI_SUCCESS;
>> + }
>> +
>> + //
>> + // Read blob.
>> + //
>> + Blob->Data = AllocatePool (Blob->Size);
>> + if (Blob->Data == NULL) {
>> + DEBUG ((EFI_D_ERROR, "%a: failed to allocate %Ld bytes for
>> \"%s\"\n",
>> + __FUNCTION__, (INT64)Blob->Size, Blob->Name));
>> + return EFI_OUT_OF_RESOURCES;
>> + }
>> +
>> + DEBUG ((EFI_D_INFO, "%a: loading %Ld bytes for \"%s\"\n",
>> __FUNCTION__,
>> + (INT64)Blob->Size, Blob->Name));
>> + QemuFwCfgSelectItem (Blob->DataKey);
>> +
>> + Left = Blob->Size;
>> + do {
>> + UINT32 Chunk;
>> +
>> + Chunk = (Left < SIZE_1MB) ? Left : SIZE_1MB;
>> + QemuFwCfgReadBytes (Chunk, Blob->Data + (Blob->Size - Left));
>> + Left -= Chunk;
>> + DEBUG ((EFI_D_VERBOSE, "%a: %Ld bytes remaining for \"%s\"\n",
>> + __FUNCTION__, (INT64)Left, Blob->Name));
>> + } while (Left > 0);
>> + return EFI_SUCCESS;
>> +}
>> +
>> +
>> +//
>> +// The entry point of the feature.
>> +//
>> +
>> +/**
>> + Download the kernel, the initial ramdisk, and the kernel command
>> line from
>> + QEMU's fw_cfg. Construct a minimal SimpleFileSystem that contains
>> the two
>> + image files, and load and start the kernel from it.
>> +
>> + The kernel will be instructed via its command line to load the
>> initrd from
>> + the same Simple FileSystem.
>> +
>> + @retval EFI_NOT_FOUND Kernel image was not found.
>> + @retval EFI_OUT_OF_RESOURCES Memory allocation failed.
>> + @retval EFI_PROTOCOL_ERROR Unterminated kernel command line.
>> +
>> + @return Error codes from any of the underlying
>> + functions. On success, the function
>> doesn't
>> + return.
>> +**/
>> +EFI_STATUS
>> +EFIAPI
>> +TryRunningQemuKernel (
>> + VOID
>> + )
>> +{
>> + UINTN BlobType;
>> + KERNEL_BLOB *CurrentBlob;
>> + KERNEL_BLOB *KernelBlob, *InitrdBlob,
>> *CommandLineBlob;
>> + EFI_STATUS Status;
>> + EFI_HANDLE FileSystemHandle;
>> + EFI_DEVICE_PATH_PROTOCOL *KernelDevicePath;
>> + EFI_HANDLE KernelImageHandle;
>> + EFI_LOADED_IMAGE_PROTOCOL *KernelLoadedImage;
>> +
>> + Status = gRT->GetTime (&mInitTime, NULL /* Capabilities */);
>> + if (EFI_ERROR (Status)) {
>> + DEBUG ((EFI_D_ERROR, "%a: GetTime(): %r\n", __FUNCTION__,
>> Status));
>> + return Status;
>> + }
>> +
>> + //
>> + // Fetch all blobs.
>> + //
>> + for (BlobType = 0; BlobType < KernelBlobTypeMax; ++BlobType) {
>> + CurrentBlob = &mKernelBlob[BlobType];
>> + Status = FetchBlob (CurrentBlob);
>> + if (EFI_ERROR (Status)) {
>> + goto FreeBlobs;
>> + }
>> + mTotalBlobBytes += CurrentBlob->Size;
>> + }
>> + KernelBlob = &mKernelBlob[KernelBlobTypeKernel];
>> + InitrdBlob = &mKernelBlob[KernelBlobTypeInitrd];
>> + CommandLineBlob = &mKernelBlob[KernelBlobTypeCommandLine];
>> +
>> + //
>> + // Create a new handle with a single VenHw() node device path
>> protocol on it,
>> + // plus a custom SimpleFileSystem protocol on it.
>> + //
>> + FileSystemHandle = NULL;
>> + Status = gBS->InstallMultipleProtocolInterfaces (&FileSystemHandle,
>> + &gEfiDevicePathProtocolGuid,
>> &mFileSystemDevicePath,
>> + &gEfiSimpleFileSystemProtocolGuid, &mFileSystem,
>> + NULL);
>> + if (EFI_ERROR (Status)) {
>> + DEBUG ((EFI_D_ERROR, "%a: InstallMultipleProtocolInterfaces():
>> %r\n",
>> + __FUNCTION__, Status));
>> + goto FreeBlobs;
>> + }
>> +
>> + //
>> + // Create a device path for the kernel image to be loaded from that
>> will call
>> + // back into our file system.
>> + //
>> + KernelDevicePath = FileDevicePath (FileSystemHandle, KernelBlob-
>>> Name);
>> + if (KernelDevicePath == NULL) {
>> + DEBUG ((EFI_D_ERROR, "%a: failed to allocate kernel device
>> path\n",
>> + __FUNCTION__));
>> + Status = EFI_OUT_OF_RESOURCES;
>> + goto UninstallProtocols;
>> + }
>> +
>> + //
>> + // Load the image. This should call back into our file system.
>> + //
>> + Status = gBS->LoadImage (
>> + FALSE, // BootPolicy: exact match
>> required
>> + gImageHandle, // ParentImageHandle
>> + KernelDevicePath,
>> + NULL, // SourceBuffer
>> + 0, // SourceSize
>> + &KernelImageHandle
>> + );
>> + if (EFI_ERROR (Status)) {
>> + DEBUG ((EFI_D_ERROR, "%a: LoadImage(): %r\n", __FUNCTION__,
>> Status));
>> + goto FreeKernelDevicePath;
>> + }
>> +
>> + //
>> + // Construct the kernel command line.
>> + //
>> + Status = gBS->OpenProtocol (
>> + KernelImageHandle,
>> + &gEfiLoadedImageProtocolGuid,
>> + (VOID **)&KernelLoadedImage,
>> + gImageHandle, // AgentHandle
>> + NULL, // ControllerHandle
>> + EFI_OPEN_PROTOCOL_GET_PROTOCOL
>> + );
>> + ASSERT_EFI_ERROR (Status);
>> +
>> + if (CommandLineBlob->Data == NULL) {
>> + KernelLoadedImage->LoadOptionsSize = 0;
>> + } else {
>> + //
>> + // Verify NUL-termination of the command line.
>> + //
>> + if (CommandLineBlob->Data[CommandLineBlob->Size - 1] != '\0') {
>> + DEBUG ((EFI_D_ERROR, "%a: kernel command line is not NUL-
>> terminated\n",
>> + __FUNCTION__));
>> + Status = EFI_PROTOCOL_ERROR;
>> + goto UnloadKernelImage;
>> + }
>> +
>> + //
>> + // Drop the terminating NUL, convert to UTF-16.
>> + //
>> + KernelLoadedImage->LoadOptionsSize = (CommandLineBlob->Size - 1) *
>> 2;
>> + }
>> +
>> + //
>> + // Append ' initrd=<name>' and NUL-terminate; all in UTF-16.
>> + //
>> + KernelLoadedImage->LoadOptionsSize += (8 + StrLen(InitrdBlob->Name)
>> + 1) * 2;
>> +
>> + KernelLoadedImage->LoadOptions = AllocatePool (
>> + KernelLoadedImage-
>>> LoadOptionsSize);
>> + if (KernelLoadedImage->LoadOptions == NULL) {
>> + KernelLoadedImage->LoadOptionsSize = 0;
>> + Status = EFI_OUT_OF_RESOURCES;
>> + goto UnloadKernelImage;
>> + }
>> +
>> + UnicodeSPrintAsciiFormat (
>> + KernelLoadedImage->LoadOptions,
>> + KernelLoadedImage->LoadOptionsSize,
>> + "%a initrd=%s",
>> + (CommandLineBlob->Data == NULL) ? "" : (CHAR8 *)CommandLineBlob-
>>> Data,
>> + InitrdBlob->Name
>> + );
>> + DEBUG ((EFI_D_INFO, "%a: command line: \"%s\"\n", __FUNCTION__,
>> + (CHAR16 *)KernelLoadedImage->LoadOptions));
>> +
>> + //
>> + // Start the image.
>> + //
>> + Status = gBS->StartImage (
>> + KernelImageHandle,
>> + NULL, // ExitDataSize
>> + NULL // ExitData
>> + );
>> + if (EFI_ERROR (Status)) {
>> + DEBUG ((EFI_D_ERROR, "%a: StartImage(): %r\n", __FUNCTION__,
>> Status));
>> + }
>> +
>> + FreePool (KernelLoadedImage->LoadOptions);
>> + KernelLoadedImage->LoadOptionsSize = 0;
>> +
>> +UnloadKernelImage:
>> + gBS->UnloadImage (KernelImageHandle);
>> +
>> +FreeKernelDevicePath:
>> + FreePool (KernelDevicePath);
>> +
>> +UninstallProtocols:
>> + gBS->UninstallMultipleProtocolInterfaces (FileSystemHandle,
>> + &gEfiSimpleFileSystemProtocolGuid, &mFileSystem,
>> + &gEfiDevicePathProtocolGuid, &mFileSystemDevicePath,
>> + NULL);
>> +
>> +FreeBlobs:
>> + while (BlobType > 0) {
>> + CurrentBlob = &mKernelBlob[--BlobType];
>> + if (CurrentBlob->Data != NULL) {
>> + FreePool (CurrentBlob->Data);
>> + CurrentBlob->Size = 0;
>> + CurrentBlob->Data = NULL;
>> + }
>> + }
>> +
>> + return Status;
>> +}
>> --
>> 1.8.3.1
>>
>>
>> -----------------------------------------------------------------------
>> -------
>> Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
>> from Actuate! Instantly Supercharge Your Business Reports and
>> Dashboards
>> with Interactivity, Sharing, Native Excel Exports, App Integration &
>> more
>> Get technology previously reserved for billion-dollar corporations,
>> FREE
>> http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.c
>> lktrk
>> _______________________________________________
>> edk2-devel mailing list
>> [email protected]
>> https://lists.sourceforge.net/lists/listinfo/edk2-devel
>
>
>
>
>
> ------------------------------------------------------------------------------
> Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
> from Actuate! Instantly Supercharge Your Business Reports and Dashboards
> with Interactivity, Sharing, Native Excel Exports, App Integration & more
> Get technology previously reserved for billion-dollar corporations, FREE
> http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.clktrk
> _______________________________________________
> edk2-devel mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/edk2-devel
>
------------------------------------------------------------------------------
Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE
http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.clktrk
_______________________________________________
edk2-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/edk2-devel
