From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by mx.groups.io with SMTP id smtpd.web12.2937.1634331116070071214 for ; Fri, 15 Oct 2021 13:51:56 -0700 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: intel.com, ip: 134.134.136.126, mailfrom: guo.dong@intel.com) X-IronPort-AV: E=McAfee;i="6200,9189,10138"; a="214919585" X-IronPort-AV: E=Sophos;i="5.85,376,1624345200"; d="scan'208";a="214919585" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Oct 2021 13:51:55 -0700 X-IronPort-AV: E=Sophos;i="5.85,376,1624345200"; d="scan'208";a="492697903" Received: from gdong1-mobl1.amr.corp.intel.com ([10.255.78.181]) by orsmga008-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Oct 2021 13:51:54 -0700 From: "Guo Dong" To: devel@edk2.groups.io Cc: Guo Dong , Ray Ni , Maurice Ma , Benjamin You Subject: [`edk2-devel][PATCH] UefiPayloadPkg: Fix ECC reported issues Date: Fri, 15 Oct 2021 13:51:39 -0700 Message-Id: <20211015205139.304-1-guo.dong@intel.com> X-Mailer: git-send-email 2.32.0.windows.2 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Guo Dong ECC reported some issues on UefiPayloadPkg, this patch fixed most of them except several files including ElfLib\Elf32.h, coreboot.h, CbParseLib.c, etc. It also removed unused functions in ResetSystemLib and Hob.c. Signed-off-by: Guo Dong Cc: Ray Ni Cc: Maurice Ma Cc: Benjamin You --- UefiPayloadPkg/Include/Library/BlParseLib.h | 8 += +++---- UefiPayloadPkg/Library/CbParseLib/CbParseLib.c | 22 += ++++++++++----------- UefiPayloadPkg/Library/DxeHobListLibNull/DxeHobListLibNull.c | 6 += +++++ UefiPayloadPkg/Library/PayloadEntryHobLib/Hob.c | 28 += +-------------------------- UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeLib.c | 4 += +-- UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeSupport.c | 15 += +++++++++----- UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.c | 4 += +++ UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.h | 2 +- UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformData.c | 2 +- UefiPayloadPkg/Library/ResetSystemLib/ResetSystemLib.c | 16 -= --------------- UefiPayloadPkg/Library/SblParseLib/SblParseLib.c | 2 +- UefiPayloadPkg/UefiPayloadEntry/LoadDxeCore.c | 2 +- UefiPayloadPkg/UefiPayloadEntry/PrintHob.c | 17 += +++++++++++++++- UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.c | 2 ++ UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.h | 10 += ++++----- UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry.c | 20 += ++++++++++++------- 16 files changed, 79 insertions(+), 81 deletions(-) diff --git a/UefiPayloadPkg/Include/Library/BlParseLib.h b/UefiPayloadPkg/I= nclude/Library/BlParseLib.h index 49eac31248..7aa6d626c7 100644 --- a/UefiPayloadPkg/Include/Library/BlParseLib.h +++ b/UefiPayloadPkg/Include/Library/BlParseLib.h @@ -6,6 +6,9 @@ SPDX-License-Identifier: BSD-2-Clause-Patent=0D =0D **/=0D +#ifndef __BOOTLOADER_PARSE_LIB__=0D +#define __BOOTLOADER_PARSE_LIB__=0D +=0D #include =0D #include =0D #include =0D @@ -13,9 +16,6 @@ #include =0D #include =0D =0D -#ifndef __BOOTLOADER_PARSE_LIB__=0D -#define __BOOTLOADER_PARSE_LIB__=0D -=0D #define GET_BOOTLOADER_PARAMETER() PcdGet64 (PcdBootloaderParameter)= =0D =0D typedef RETURN_STATUS \=0D @@ -73,7 +73,7 @@ ParseSystemTable ( /**=0D Find the serial port information=0D =0D - @param SERIAL_PORT_INFO Pointer to serial port info structure=0D + @param SerialPortInfo Pointer to serial port info structure=0D =0D @retval RETURN_SUCCESS Successfully find the serial port information= .=0D @retval RETURN_NOT_FOUND Failed to find the serial port information .= =0D diff --git a/UefiPayloadPkg/Library/CbParseLib/CbParseLib.c b/UefiPayloadPk= g/Library/CbParseLib/CbParseLib.c index 4be5d66ba5..7b7f39968e 100644 --- a/UefiPayloadPkg/Library/CbParseLib/CbParseLib.c +++ b/UefiPayloadPkg/Library/CbParseLib/CbParseLib.c @@ -322,7 +322,7 @@ ParseCbMemTable ( )=0D {=0D EFI_STATUS Status;=0D - struct cb_memory *rec;=0D + struct cb_memory *Rec;=0D struct cb_memory_range *Range;=0D UINT64 Start;=0D UINT64 Size;=0D @@ -339,13 +339,13 @@ ParseCbMemTable ( //=0D // Get the coreboot memory table=0D //=0D - rec =3D (struct cb_memory *)FindCbTag (CB_TAG_MEMORY);=0D - if (rec =3D=3D NULL) {=0D + Rec =3D (struct cb_memory *)FindCbTag (CB_TAG_MEMORY);=0D + if (Rec =3D=3D NULL) {=0D return Status;=0D }=0D =0D - for (Index =3D 0; Index < MEM_RANGE_COUNT(rec); Index++) {=0D - Range =3D MEM_RANGE_PTR(rec, Index);=0D + for (Index =3D 0; Index < MEM_RANGE_COUNT(Rec); Index++) {=0D + Range =3D MEM_RANGE_PTR(Rec, Index);=0D Start =3D cb_unpack64(Range->start);=0D Size =3D cb_unpack64(Range->size);=0D =0D @@ -380,7 +380,7 @@ ParseMemoryInfo ( IN VOID *Params=0D )=0D {=0D - struct cb_memory *rec;=0D + struct cb_memory *Rec;=0D struct cb_memory_range *Range;=0D UINTN Index;=0D MEMROY_MAP_ENTRY MemoryMap;=0D @@ -388,13 +388,13 @@ ParseMemoryInfo ( //=0D // Get the coreboot memory table=0D //=0D - rec =3D (struct cb_memory *)FindCbTag (CB_TAG_MEMORY);=0D - if (rec =3D=3D NULL) {=0D + Rec =3D (struct cb_memory *)FindCbTag (CB_TAG_MEMORY);=0D + if (Rec =3D=3D NULL) {=0D return RETURN_NOT_FOUND;=0D }=0D =0D - for (Index =3D 0; Index < MEM_RANGE_COUNT(rec); Index++) {=0D - Range =3D MEM_RANGE_PTR(rec, Index);=0D + for (Index =3D 0; Index < MEM_RANGE_COUNT(Rec); Index++) {=0D + Range =3D MEM_RANGE_PTR(Rec, Index);=0D MemoryMap.Base =3D cb_unpack64(Range->start);=0D MemoryMap.Size =3D cb_unpack64(Range->size);=0D MemoryMap.Type =3D (UINT8)Range->type;=0D @@ -449,7 +449,7 @@ ParseSystemTable ( /**=0D Find the serial port information=0D =0D - @param SERIAL_PORT_INFO Pointer to serial port info structure=0D + @param SerialPortInfo Pointer to serial port info structure=0D =0D @retval RETURN_SUCCESS Successfully find the serial port information= .=0D @retval RETURN_NOT_FOUND Failed to find the serial port information .= =0D diff --git a/UefiPayloadPkg/Library/DxeHobListLibNull/DxeHobListLibNull.c b= /UefiPayloadPkg/Library/DxeHobListLibNull/DxeHobListLibNull.c index 92d3e17ef0..6c69f9879e 100644 --- a/UefiPayloadPkg/Library/DxeHobListLibNull/DxeHobListLibNull.c +++ b/UefiPayloadPkg/Library/DxeHobListLibNull/DxeHobListLibNull.c @@ -10,6 +10,12 @@ =0D #include =0D =0D +/**=0D + The dummy constructor for DxeHobListLib.=0D +=0D + @retval EFI_SUCCESS=0D +=0D +**/=0D EFI_STATUS=0D EFIAPI=0D DxeHobListLibNullConstructor (=0D diff --git a/UefiPayloadPkg/Library/PayloadEntryHobLib/Hob.c b/UefiPayloadP= kg/Library/PayloadEntryHobLib/Hob.c index dd25ac2682..61cd11ba03 100644 --- a/UefiPayloadPkg/Library/PayloadEntryHobLib/Hob.c +++ b/UefiPayloadPkg/Library/PayloadEntryHobLib/Hob.c @@ -168,31 +168,6 @@ BuildResourceDescriptorHob ( Hob->ResourceLength =3D NumberOfBytes;=0D }=0D =0D -VOID=0D -EFIAPI=0D -BuildFvHobs (=0D - IN EFI_PHYSICAL_ADDRESS PhysicalStart,=0D - IN UINT64 NumberOfBytes,=0D - IN EFI_RESOURCE_ATTRIBUTE_TYPE *ResourceAttribute=0D - )=0D -{=0D -=0D - EFI_RESOURCE_ATTRIBUTE_TYPE Resource;=0D -=0D - BuildFvHob (PhysicalStart, NumberOfBytes);=0D -=0D - if (ResourceAttribute =3D=3D NULL) {=0D - Resource =3D (EFI_RESOURCE_ATTRIBUTE_PRESENT |=0D - EFI_RESOURCE_ATTRIBUTE_INITIALIZED |=0D - EFI_RESOURCE_ATTRIBUTE_TESTED |=0D - EFI_RESOURCE_ATTRIBUTE_WRITE_BACK_CACHEABLE);=0D - } else {=0D - Resource =3D *ResourceAttribute;=0D - }=0D -=0D - BuildResourceDescriptorHob (EFI_RESOURCE_FIRMWARE_DEVICE, Resource, Phys= icalStart, NumberOfBytes);=0D -}=0D -=0D /**=0D Returns the next instance of a HOB type from the starting HOB.=0D =0D @@ -283,7 +258,8 @@ EFIAPI GetNextGuidHob (=0D IN CONST EFI_GUID *Guid,=0D IN CONST VOID *HobStart=0D - ){=0D + )=0D +{=0D EFI_PEI_HOB_POINTERS GuidHob;=0D =0D GuidHob.Raw =3D (UINT8 *) HobStart;=0D diff --git a/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeLib.c b/U= efiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeLib.c index a0d7cdc306..0eddebe229 100644 --- a/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeLib.c +++ b/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeLib.c @@ -210,8 +210,8 @@ PciHostBridgeGetRootBridges ( Free the root bridge instances array returned from=0D PciHostBridgeGetRootBridges().=0D =0D - @param The root bridge instances array.=0D - @param The count of the array.=0D + @param Bridges The root bridge instances array.=0D + @param Count The count of the array.=0D **/=0D VOID=0D EFIAPI=0D diff --git a/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeSupport.c= b/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeSupport.c index b0268f0506..eb28d48b3b 100644 --- a/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeSupport.c +++ b/UefiPayloadPkg/Library/PciHostBridgeLib/PciHostBridgeSupport.c @@ -205,7 +205,7 @@ PcatPciRootBridgeParseBars ( //=0D // IO Bar=0D //=0D - if (Command & EFI_PCI_COMMAND_IO_SPACE) {=0D + if ((Command & EFI_PCI_COMMAND_IO_SPACE) !=3D 0) {=0D Mask =3D 0xfffffffc;=0D Base =3D OriginalValue & Mask;=0D Length =3D ((~(Value & Mask)) & Mask) + 0x04;=0D @@ -227,7 +227,7 @@ PcatPciRootBridgeParseBars ( //=0D // Mem Bar=0D //=0D - if (Command & EFI_PCI_COMMAND_MEMORY_SPACE) {=0D + if ((Command & EFI_PCI_COMMAND_MEMORY_SPACE) !=3D 0) {=0D =0D Mask =3D 0xfffffff0;=0D Base =3D OriginalValue & Mask;=0D @@ -306,9 +306,14 @@ ScanForRootBridges ( UINT64 Base;=0D UINT64 Limit;=0D UINT64 Value;=0D - PCI_ROOT_BRIDGE_APERTURE Io, Mem, MemAbove4G, PMem, PMemAbove4G, *MemApe= rture;=0D - PCI_ROOT_BRIDGE *RootBridges;=0D - UINTN BarOffsetEnd;=0D + PCI_ROOT_BRIDGE_APERTURE Io;=0D + PCI_ROOT_BRIDGE_APERTURE Mem;=0D + PCI_ROOT_BRIDGE_APERTURE MemAbove4G;=0D + PCI_ROOT_BRIDGE_APERTURE PMem;=0D + PCI_ROOT_BRIDGE_APERTURE PMemAbove4G;=0D + PCI_ROOT_BRIDGE_APERTURE *MemAperture;=0D + PCI_ROOT_BRIDGE *RootBridges;=0D + UINTN BarOffsetEnd;=0D =0D =0D *NumberOfRootBridges =3D 0;=0D diff --git a/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootMana= ger.c b/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.c index c4d317fa9e..dd91fcb29d 100644 --- a/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.c +++ b/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.c @@ -15,6 +15,10 @@ SPDX-License-Identifier: BSD-2-Clause-Patent =0D UNIVERSAL_PAYLOAD_PLATFORM_BOOT_MANAGER_OVERRIDE_PROTOCOL *mUniversalPayl= oadPlatformBootManagerOverrideInstance =3D NULL;=0D =0D +/**=0D + Signal EndOfDxe event and install SMM Ready to lock protocol.=0D +=0D +**/=0D VOID=0D InstallReadyToLock (=0D VOID=0D diff --git a/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootMana= ger.h b/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.h index 2f600c796f..cad7fe2b9d 100644 --- a/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.h +++ b/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformBootManager.h @@ -1,4 +1,4 @@ -/**@file=0D +/** @file=0D Head file for BDS Platform specific code=0D =0D Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.
=0D diff --git a/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformData.c b= /UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformData.c index d17e660e0f..892a7f01be 100644 --- a/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformData.c +++ b/UefiPayloadPkg/Library/PlatformBootManagerLib/PlatformData.c @@ -1,4 +1,4 @@ -/**@file=0D +/** @file=0D Defined the platform specific device path which will be filled to=0D ConIn/ConOut variables.=0D =0D diff --git a/UefiPayloadPkg/Library/ResetSystemLib/ResetSystemLib.c b/UefiP= ayloadPkg/Library/ResetSystemLib/ResetSystemLib.c index 2e4b7fe592..b35a4cc1d9 100644 --- a/UefiPayloadPkg/Library/ResetSystemLib/ResetSystemLib.c +++ b/UefiPayloadPkg/Library/ResetSystemLib/ResetSystemLib.c @@ -43,22 +43,6 @@ ResetSystemLibConstructor ( return EFI_SUCCESS;=0D }=0D =0D -=0D -VOID=0D -AcpiPmControl (=0D - UINTN SuspendType=0D - )=0D -{=0D - UINTN PmCtrlReg;=0D -=0D - ASSERT (SuspendType <=3D 7);=0D -=0D - PmCtrlReg =3D (UINTN)mAcpiBoardInfo.PmCtrlRegBase;=0D - IoAndThenOr16 (PmCtrlReg, (UINT16) ~0x3c00, (UINT16) (SuspendType << 10)= );=0D - IoOr16 (PmCtrlReg, BIT13);=0D - CpuDeadLoop ();=0D -}=0D -=0D /**=0D Calling this function causes a system-wide reset. This sets=0D all circuitry within the system to its initial state. This type of reset= =0D diff --git a/UefiPayloadPkg/Library/SblParseLib/SblParseLib.c b/UefiPayload= Pkg/Library/SblParseLib/SblParseLib.c index ccdcbfc07d..fc6b1b9a16 100644 --- a/UefiPayloadPkg/Library/SblParseLib/SblParseLib.c +++ b/UefiPayloadPkg/Library/SblParseLib/SblParseLib.c @@ -141,7 +141,7 @@ ParseSystemTable ( /**=0D Find the serial port information=0D =0D - @param SERIAL_PORT_INFO Pointer to serial port info structure=0D + @param[out] SerialPortInfo Pointer to serial port info structure=0D =0D @retval RETURN_SUCCESS Successfully find the serial port information= .=0D @retval RETURN_NOT_FOUND Failed to find the serial port information .= =0D diff --git a/UefiPayloadPkg/UefiPayloadEntry/LoadDxeCore.c b/UefiPayloadPkg= /UefiPayloadEntry/LoadDxeCore.c index 0b6cb47cd0..67eed179f0 100644 --- a/UefiPayloadPkg/UefiPayloadEntry/LoadDxeCore.c +++ b/UefiPayloadPkg/UefiPayloadEntry/LoadDxeCore.c @@ -190,7 +190,7 @@ FvFindFileByTypeGuid ( =0D @param FileHeader A pointer to the file header that contains= the set of sections to=0D be searched.=0D - @param SearchType The value of the section type to search.=0D + @param SectionType The value of the section type to search.= =0D @param SectionData A pointer to the discovered section, if su= ccessful.=0D =0D @retval EFI_SUCCESS The section was found.=0D diff --git a/UefiPayloadPkg/UefiPayloadEntry/PrintHob.c b/UefiPayloadPkg/Ue= fiPayloadEntry/PrintHob.c index 265d47ca9d..d7f3af1304 100644 --- a/UefiPayloadPkg/UefiPayloadEntry/PrintHob.c +++ b/UefiPayloadPkg/UefiPayloadEntry/PrintHob.c @@ -196,7 +196,10 @@ PrintResourceDiscriptorHob ( =0D /**=0D Print the information in Acpi Guid Hob.=0D +=0D @param[in] HobRaw A pointer to the start of gUniversalPayloadAc= piTableGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -217,6 +220,8 @@ PrintAcpiGuidHob ( /**=0D Print the information in Serial Guid Hob.=0D @param[in] HobRaw A pointer to the start of gUniversalPayloadSe= rialPortInfoGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -240,6 +245,7 @@ PrintSerialGuidHob ( /**=0D Print the information in Smbios Guid Hob.=0D @param[in] HobRaw A pointer to the start of gUniversalPayloadSm= bios3TableGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -260,6 +266,8 @@ PrintSmbios3GuidHob ( /**=0D Print the information in Smbios Guid Hob.=0D @param[in] HobRaw A pointer to the start of gUniversalPayloadSm= biosTableGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -280,6 +288,8 @@ PrintSmbiosTablGuidHob ( /**=0D Print the information in Acpi BoardInfo Guid Hob.=0D @param[in] HobRaw A pointer to the start of gUefiAcpiBoardInfoG= uid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -307,6 +317,7 @@ PrintAcpiBoardInfoGuidHob ( /**=0D Print the information in Pci RootBridge Info Guid Hob.=0D @param[in] HobRaw A pointer to the start of gUniversalPayloadPc= iRootBridgeInfoGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D =0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D @@ -362,6 +373,8 @@ PrintPciRootBridgeInfoGuidHob ( /**=0D Print the information in Extra Data Guid Hob.=0D @param[in] HobRaw A pointer to the start of gUniversalPayloadEx= traDataGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -394,6 +407,8 @@ PrintExtraDataGuidHob ( /**=0D Print the information in MemoryTypeInfoGuidHob.=0D @param[in] HobRaw A pointer to the start of gEfiMemoryTypeInfor= mationGuid HOB.=0D + @param[in] HobLength The size of the HOB data buffer.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D @@ -414,7 +429,7 @@ PrintMemoryTypeInfoGuidHob ( /**=0D Print the information in EdkiiBootManagerMenuFileGuid.=0D @param[in] HobRaw A pointer to the start of gEdkiiBootManagerMe= nuFileGuid HOB.=0D - @param[in] HobLength The size of the data buffer.=0D + @param[in] HobLength The size of the HOB data buffer.=0D @retval EFI_SUCCESS If it completed successfully.=0D **/=0D EFI_STATUS=0D diff --git a/UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.c b/UefiPaylo= adPkg/UefiPayloadEntry/UefiPayloadEntry.c index 0e6dcf10f9..adc56dc15f 100644 --- a/UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.c +++ b/UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.c @@ -389,6 +389,8 @@ BuildGenericHob ( /**=0D Entry point to the C language phase of UEFI payload.=0D =0D + @param[in] BootloaderParameter The starting address of bootloader p= arameter block.=0D +=0D @retval It will not return if SUCCESS, and return error when passin= g bootloader parameter.=0D **/=0D EFI_STATUS=0D diff --git a/UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.h b/UefiPaylo= adPkg/UefiPayloadEntry/UefiPayloadEntry.h index de51c2fba9..637ed9c20b 100644 --- a/UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.h +++ b/UefiPayloadPkg/UefiPayloadEntry/UefiPayloadEntry.h @@ -1,9 +1,9 @@ /** @file=0D -*=0D -* Copyright (c) 2021, Intel Corporation. All rights reserved.
=0D -*=0D -* SPDX-License-Identifier: BSD-2-Clause-Patent=0D -*=0D +=0D + Copyright (c) 2021, Intel Corporation. All rights reserved.
=0D +=0D + SPDX-License-Identifier: BSD-2-Clause-Patent=0D +=0D **/=0D =0D #ifndef __UEFI_PAYLOAD_ENTRY_H__=0D diff --git a/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry.c b/Uefi= PayloadPkg/UefiPayloadEntry/UniversalPayloadEntry.c index 7e67cf0f04..4d1096b323 100644 --- a/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry.c +++ b/UefiPayloadPkg/UefiPayloadEntry/UniversalPayloadEntry.c @@ -114,18 +114,19 @@ AddNewHob ( }=0D =0D /**=0D - Found the Resource Descriptor HOB that contains a range=0D + Found the Resource Descriptor HOB that contains a range (Base, Top)=0D =0D + @param[in] HobList Hob start address=0D @param[in] Base Memory start address=0D - @param[in] Top Memory Top.=0D + @param[in] Top Memory end address.=0D =0D - @return The pointer to the Resource Descriptor HOB.=0D + @retval The pointer to the Resource Descriptor HOB.=0D **/=0D EFI_HOB_RESOURCE_DESCRIPTOR *=0D FindResourceDescriptorByRange (=0D - VOID *HobList,=0D - EFI_PHYSICAL_ADDRESS Base,=0D - EFI_PHYSICAL_ADDRESS Top=0D + IN VOID *HobList,=0D + IN EFI_PHYSICAL_ADDRESS Base,=0D + IN EFI_PHYSICAL_ADDRESS Top=0D )=0D {=0D EFI_PEI_HOB_POINTERS Hob;=0D @@ -171,7 +172,7 @@ FindResourceDescriptorByRange ( @param[in] MinimalNeededSize Minimal needed size.=0D @param[in] ExceptResourceHob Ignore this Resource Descriptor.=0D =0D - @return The pointer to the Resource Descriptor HOB.=0D + @retval The pointer to the Resource Descriptor HOB.=0D **/=0D EFI_HOB_RESOURCE_DESCRIPTOR *=0D FindAnotherHighestBelow4GResourceDescriptor (=0D @@ -240,6 +241,9 @@ FindAnotherHighestBelow4GResourceDescriptor ( /**=0D It will build HOBs based on information from bootloaders.=0D =0D + @param[in] BootloaderParameter The starting memory address of bootloa= der parameter block.=0D + @param[out] DxeFv The pointer to the DXE FV in memory.=0D +=0D @retval EFI_SUCCESS If it completed successfully.=0D @retval Others If it failed to build required HOBs.=0D **/=0D @@ -376,6 +380,8 @@ BuildHobs ( /**=0D Entry point to the C language phase of UEFI payload.=0D =0D + @param[in] BootloaderParameter The starting address of bootloader p= arameter block.=0D +=0D @retval It will not return if SUCCESS, and return error when passin= g bootloader parameter.=0D **/=0D EFI_STATUS=0D --=20 2.32.0.windows.2