From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web09.35513.1629783287365011497 for ; Mon, 23 Aug 2021 22:34:47 -0700 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: arm.com, ip: 217.140.110.172, mailfrom: omkar.kulkarni@arm.com) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 0575C1042; Mon, 23 Aug 2021 22:34:47 -0700 (PDT) Received: from usa.arm.com (a077433.blr.arm.com [10.162.46.10]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 8BF293F766; Mon, 23 Aug 2021 22:34:45 -0700 (PDT) From: "Omkar Anand Kulkarni" To: devel@edk2.groups.io Cc: Ard Biesheuvel , Sami Mujawar Subject: [edk2-platforms][PATCH v3 3/5] ArmPlatformPkg: retreive error source descriptors from MM Date: Tue, 24 Aug 2021 11:04:01 +0530 Message-Id: <20210824053403.24103-4-omkar.kulkarni@arm.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20210824053403.24103-1-omkar.kulkarni@arm.com> References: <20210824053403.24103-1-omkar.kulkarni@arm.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Add a driver that retreives error source descriptors from MM and populates those into the HEST ACPI table. The error source descriptors that are available from the MM side are retreived using MM Communicate 2 protocol. The first call into the MM returns the size of MM Communicate buffer required to hold all error source descriptor info. The communication buffer of that size is then allocated and the second call into MM returns the error source descriptors in the communication buffer. The retreived error source descriptors are then appended to the HEST table. Co-authored-by: Thomas Abraham Signed-off-by: Omkar Anand Kulkarni --- ArmPlatformPkg/ArmPlatformPkg.dec = | 7 + ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe.inf = | 45 +++ ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceStandaloneMm.in= f | 51 ++++ ArmPlatformPkg/Drivers/HestMmErrorSources/HestMmErrorSourceCommon.h = | 37 +++ MdePkg/Include/Protocol/MmCommunication.h = | 2 + ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe.c = | 309 +++++++++++++++++++ ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceStandaloneMm.c = | 312 ++++++++++++++++++++ 7 files changed, 763 insertions(+) diff --git a/ArmPlatformPkg/ArmPlatformPkg.dec b/ArmPlatformPkg/ArmPlatfo= rmPkg.dec index 446d93b880f9..a400f175726e 100644 --- a/ArmPlatformPkg/ArmPlatformPkg.dec +++ b/ArmPlatformPkg/ArmPlatformPkg.dec @@ -52,6 +52,8 @@ =20 [Guids.common] gArmPlatformTokenSpaceGuid =3D { 0x9c0aaed4, 0x74c5, 0x4043, { 0xb4,= 0x17, 0xa3, 0x22, 0x38, 0x14, 0xce, 0x76 } } + gArmPlatformHestErrorSourcesGuid =3D { 0x76b8ab43, 0x822d, 0x4b00, { 0= x9f, 0xd0, 0xf4, 0xa5, 0x35, 0x82, 0x47, 0x0a } } + gMmHestGetErrorSourceInfoGuid =3D { 0x7d602951, 0x678e, 0x4cc4, { 0x98= , 0xd9, 0xe3, 0x76, 0x04, 0xf6, 0x93, 0x0d } } =20 [PcdsFeatureFlag.common] gArmPlatformTokenSpaceGuid.PcdSendSgiToBringUpSecondaryCores|FALSE|BOO= LEAN|0x00000004 @@ -128,5 +130,10 @@ =20 gArmPlatformTokenSpaceGuid.PcdWatchdogCount|0x0|UINT32|0x00000033 =20 +[PcdsFixedAtBuild, PcdsPatchableInModule] + ## ACPI CPER memory space + gArmPlatformTokenSpaceGuid.PcdGhesGenericErrorDataMmBufferBase|0x00000= 000|UINT64|0x00000046 + gArmPlatformTokenSpaceGuid.PcdGhesGenericErrorDataMmBufferSize|0x00000= 000|UINT64|0x00000047 + [Protocols.common] gMmHestErrorSourceDescProtocolGuid =3D { 0x560bf236, 0xa4a8, 0x4d69, {= 0xbc, 0xf6, 0xc2, 0x97, 0x24, 0x10, 0x9d, 0x91 } } diff --git a/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe= .inf b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe.inf new file mode 100644 index 000000000000..b16ff2353aa5 --- /dev/null +++ b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe.inf @@ -0,0 +1,45 @@ +## @file +# DXE driver to get secure error sources. +# +# DXE driver to retrieve the error source descriptors from Standalone M= M and +# append those to the HEST table. +# +# Copyright (c) 2020 - 2021, ARM Limited. All rights reserved. +# SPDX-License-Identifier: BSD-2-Clause-Patent +# +## + +[Defines] + INF_VERSION =3D 0x0001001A + BASE_NAME =3D HestMmErrorSourceDxe + FILE_GUID =3D 76b8ab43-822d-4b00-9fd0-f4a53582470= a + MODULE_TYPE =3D DXE_DRIVER + VERSION_STRING =3D 1.0 + ENTRY_POINT =3D HestErrorSourceInitialize + +[Sources.common] + HestErrorSourceDxe.c + +[Packages] + ArmPkg/ArmPkg.dec + ArmPlatformPkg/ArmPlatformPkg.dec + MdeModulePkg/MdeModulePkg.dec + MdePkg/MdePkg.dec + StandaloneMmPkg/StandaloneMmPkg.dec + +[LibraryClasses] + BaseMemoryLib + DebugLib + DxeServicesTableLib + UefiDriverEntryPoint + UefiLib + +[Guids] + gMmHestGetErrorSourceInfoGuid ## PRODUCES + +[Protocols] + gHestTableProtocolGuid ## CONSUMES + gEfiMmCommunication2ProtocolGuid + +[Depex] + gHestTableProtocolGuid AND gEfiMmCommunication2ProtocolGuid diff --git a/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceSta= ndaloneMm.inf b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSource= StandaloneMm.inf new file mode 100644 index 000000000000..9d566de9bec3 --- /dev/null +++ b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceStandalone= Mm.inf @@ -0,0 +1,51 @@ +## @file +# HEST error source gateway Standalone MM driver. +# +# Collects HEST error source descriptors,by communicating with all the = MM +# drivers implementing the HEST error source descriptor protocol. +# +# Copyright (c) 2020 - 2021, ARM Limited. All rights reserved. +# SPDX-License-Identifier: BSD-2-Clause-Patent +# +## + +[Defines] + INF_VERSION =3D 0x0001001A + BASE_NAME =3D HestErrorSourceStandaloneMm + FILE_GUID =3D 3ddbebcc-9841-4ef8-87fa-305843c1922= d + MODULE_TYPE =3D MM_STANDALONE + VERSION_STRING =3D 1.0 + PI_SPECIFICATION_VERSION =3D 0x00010032 + ENTRY_POINT =3D StandaloneMmHestErrorSourceInitiali= ze + +[Sources] + HestErrorSourceStandaloneMm.c + +[Packages] + ArmPkg/ArmPkg.dec + ArmPlatformPkg/ArmPlatformPkg.dec + MdeModulePkg/MdeModulePkg.dec + MdePkg/MdePkg.dec + StandaloneMmPkg/StandaloneMmPkg.dec + +[LibraryClasses] + ArmLib + ArmSvcLib + BaseMemoryLib + DebugLib + MemoryAllocationLib + StandaloneMmDriverEntryPoint + +[Protocols] + gMmHestErrorSourceDescProtocolGuid + +[Guids] + gMmHestGetErrorSourceInfoGuid ##PRODUCES + gEfiStandaloneMmNonSecureBufferGuid + +[FixedPcd] + gArmPlatformTokenSpaceGuid.PcdGhesGenericErrorDataMmBufferBase + gArmPlatformTokenSpaceGuid.PcdGhesGenericErrorDataMmBufferSize + +[Depex] + TRUE diff --git a/ArmPlatformPkg/Drivers/HestMmErrorSources/HestMmErrorSourceC= ommon.h b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestMmErrorSourceComm= on.h new file mode 100644 index 000000000000..6ddc6bd21922 --- /dev/null +++ b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestMmErrorSourceCommon.h @@ -0,0 +1,37 @@ +/** @file + Data structures for error source descriptor information. + + This data structure forms the CommBuffer part of the MM Communication + protocol used for communicating the Hardware Error sources form MM to + Non-MM environment. + + Copyright (c) 2020 - 2021, ARM Limited. All rights reserved. + SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#ifndef HEST_ERROR_SOURCE_DESCRIPTOR_H_ +#define HEST_ERROR_SOURCE_DESCRIPTOR_H_ + +#define HEST_ERROR_SOURCE_DESC_INFO_SIZE \ + (OFFSET_OF (HEST_ERROR_SOURCE_DESC_INFO, ErrSourceDescList)) + +// +// Data Structure to communicate the error source descriptor information= from +// Standalone MM. +// +typedef struct { + // + // Total count of error source descriptors. + // + UINTN ErrSourceDescCount; + // + // Total size of all the error source descriptors. + // + UINTN ErrSourceDescSize; + // + // Array of error source descriptors that is ErrSourceDescSize in size= . + // + UINT8 ErrSourceDescList[1]; +} HEST_ERROR_SOURCE_DESC_INFO; + +#endif // HEST_ERROR_SOURCE_DESCRIPTOR_H_ diff --git a/MdePkg/Include/Protocol/MmCommunication.h b/MdePkg/Include/P= rotocol/MmCommunication.h index 34c3e2b5a9e3..acde54971fd9 100644 --- a/MdePkg/Include/Protocol/MmCommunication.h +++ b/MdePkg/Include/Protocol/MmCommunication.h @@ -12,6 +12,8 @@ #ifndef _MM_COMMUNICATION_H_ #define _MM_COMMUNICATION_H_ =20 +#define MM_COMMUNICATE_HEADER_SIZE (OFFSET_OF (EFI_MM_COMMUNICATE_HEADER= , Data)) + #pragma pack(1) =20 /// diff --git a/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe= .c b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe.c new file mode 100644 index 000000000000..28de8daf2f5e --- /dev/null +++ b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceDxe.c @@ -0,0 +1,309 @@ +/** @file + Collects and appends the HEST error source descriptors from the MM dri= vers. + + The drivers entry point locates the MM Communication protocol and call= s into + Standalone MM to get the HEST error sources length and count. It also + retrieves descriptor information. The information is then used to buil= d the + HEST table using the HEST table generation protocol. + + This driver collects the secure error source descriptor information fr= om the + MM drviers that implement HEST error source protocol. Instead of direc= tly + communicating with the individual MM drivers, it calls into + HestErrorSourceStandaloneMM driver which is a gatway MM driver. This M= M driver + in-turn communicates with individual MM drivers collecting the error s= ource + descriptor information. + + Once all the error source descriptor information is retrieved the driv= er + appends the descriptors to HEST table using the HestDxe driver. + + Copyright (c) 2020 - 2021, ARM Limited. All rights reserved. + SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include "HestMmErrorSourceCommon.h" + +STATIC HEST_TABLE_PROTOCOL *mHestProtocol; +STATIC EFI_MM_COMMUNICATION2_PROTOCOL *mMmCommunication2; + +/** + Retrieve the error source descriptors from Standalone MM. + + Initialize the MM comminication buffer by assigning the MM service to + invoke as gMmHestGetErrorSourceInfoGuid. Use the MM communication + protocol to retrieve the error source descriptors. + + @param[in] CommBuffSize Size of communicate buffer. + @param[in, out] CommBuffer The communicate buffer. + + @retval EFI_SUCCESS MM Communicate protocol call successful. + @retval Other MM Communicate protocol call failed. +**/ +STATIC +EFI_STATUS +GetErrorSourceDescriptors ( + IN UINTN CommBuffSize, + IN OUT EFI_MM_COMMUNICATE_HEADER **CommBuffer + ) +{ + EFI_STATUS Status; + + // + // Initialize the CommBuffer with MM Communicate metadata. + // + CopyGuid (&(*CommBuffer)->HeaderGuid, &gMmHestGetErrorSourceInfoGuid); + (*CommBuffer)->MessageLength =3D + CommBuffSize - + sizeof ((*CommBuffer)->HeaderGuid) - + sizeof ((*CommBuffer)->MessageLength); + + // + // Call into the Standalone MM using the MM Communicate protocol. + // + Status =3D mMmCommunication2->Communicate ( + mMmCommunication2, + NULL, + (VOID *)*CommBuffer, + NULL + ); + + return Status; +} + +/** + Collect HEST error source descriptors from all Standalone MM drivers a= nd + append them to the HEST table. + + Use MM Communication Protocol to communicate and collect the error sou= rce + descriptor information from Standalone MM. Check for the required buff= er size + returned by the MM driver. Allocate buffer of adequate size and call a= gain + into MM. + + @retval EFI_SUCCESS Successful to collect and append the er= ror + source. + descriptors to HEST table. + @retval EFI_OUT_OF_RESOURCES Memory allocation failure. + @retval Other For any other error. +**/ +STATIC +EFI_STATUS +AppendMmErrorSources ( + VOID + ) +{ + EFI_MM_COMMUNICATE_HEADER *CommunicationHeader =3D NULL; + HEST_ERROR_SOURCE_DESC_INFO *ErrorSourceDescInfo; + EFI_STATUS Status; + UINTN CommBufferSize; + + // + // Retrieve the count, length and the actual eror source descriptors f= rom + // the MM drivers. Do this by performing two MM Communicate calls, in = the + // first call pass CommBuffer which is atleast of the size of error so= urce + // descriptor info structure. Followed by another communicate call wit= h + // CommBuffer allocated to required buffer size to hold all descriptor= s. + // + // Allocate CommBuffer atleast the size of error source descriptor inf= o + // structure. + CommBufferSize =3D + MM_COMMUNICATE_HEADER_SIZE + HEST_ERROR_SOURCE_DESC_INFO_SIZE; + CommunicationHeader =3D AllocateZeroPool (CommBufferSize); + if (CommunicationHeader =3D=3D NULL) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed to allocate memory for CommunicationHeader\n", + __FUNCTION__ + )); + return EFI_OUT_OF_RESOURCES; + } + + // + // Make the first MM Communicate call to HestErrorSourceStandaloneMM g= ateway + // driver, which returns the required buffer size adequate to hold all= the + // desctriptor information. + // + Status =3D GetErrorSourceDescriptors (CommBufferSize, &CommunicationHe= ader); + if ((EFI_ERROR (Status)) && + (Status !=3D EFI_BUFFER_TOO_SMALL)) { + DEBUG (( + DEBUG_ERROR, + "%a: MM Communicate protocol call failed, status: %r\n", + __FUNCTION__, + Status + )); + FreePool (CommunicationHeader); + return Status; + } + + // Check for the length of Error Source descriptors. + ErrorSourceDescInfo =3D + (HEST_ERROR_SOURCE_DESC_INFO *)(CommunicationHeader->Data); + if ((ErrorSourceDescInfo->ErrSourceDescSize =3D=3D 0) || + (ErrorSourceDescInfo->ErrSourceDescCount =3D=3D 0)) { + DEBUG (( + DEBUG_INFO, + "HesErrorSourceDxe: HEST error source(s) not found\n" + )); + FreePool (CommunicationHeader); + return EFI_NOT_FOUND; + } + + // + // Allocate CommBuffer of required size to accomodate all the error so= urce + // descriptors. Required size of communication buffer =3D + // MM communicate metadata. + (error source desc info struct + error s= ource + // descriptor size). + // + + CommBufferSize =3D + MM_COMMUNICATE_HEADER_SIZE + + HEST_ERROR_SOURCE_DESC_INFO_SIZE + + ErrorSourceDescInfo->ErrSourceDescSize; + + // Free old MM Communicate buffer and allocate a new buffer of require= d size. + FreePool (CommunicationHeader); + CommunicationHeader =3D AllocateZeroPool (CommBufferSize); + if (CommunicationHeader =3D=3D NULL) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed to allocate memory for CommunicationHeader\n", + __FUNCTION__ + )); + return EFI_OUT_OF_RESOURCES; + } + + // + // Make second MM Communicate call to HestErrorSourceStandaloneMM driv= er to + // get the error source descriptors from the MM drivers. + // + Status =3D GetErrorSourceDescriptors (CommBufferSize, &CommunicationHe= ader); + if (EFI_ERROR (Status)) { + DEBUG (( + DEBUG_ERROR, + "%a: MM Communicate protocol failed, status: %r\n", + __FUNCTION__, + Status + )); + FreePool (CommunicationHeader); + return Status; + } + + // + // Retrieve the HEST error source descriptor information. Ensure that = there + // is a valid list of error source descriptors. + // + ErrorSourceDescInfo =3D + (HEST_ERROR_SOURCE_DESC_INFO *)(CommunicationHeader->Data); + if (ErrorSourceDescInfo->ErrSourceDescList =3D=3D NULL) { + DEBUG (( + DEBUG_INFO, + "HestErrorSourceDxe: Error source descriptor list is empty" + )); + FreePool (CommunicationHeader); + return EFI_NOT_FOUND; + } + + DEBUG (( + DEBUG_INFO, + "HestErrorSourceDxe: ErrorSources: TotalCount =3D %d TotalLength =3D= %d \n", + ErrorSourceDescInfo->ErrSourceDescCount, + ErrorSourceDescInfo->ErrSourceDescSize + )); + + // + // Append the error source descriptors to HEST table using the HEST ta= ble + // generation protocol. + // + Status =3D mHestProtocol->AppendErrorSourceDescriptors ( + ErrorSourceDescInfo->ErrSourceDescList, + ErrorSourceDescInfo->ErrSourceDescSize, + ErrorSourceDescInfo->ErrSourceDescCount + ); + if (EFI_ERROR (Status)) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed to append error source(s), status: %r\n", + __FUNCTION__, + Status + )); + } + + FreePool (CommunicationHeader); + return Status; +} + +/** + The Entry Point for HEST Error Source Dxe driver. + + Locates the HEST Table generation and MM Communication2 protocols. Usi= ng the + MM Communication2, the driver collects the Error Source Descriptor(s) = from + Standalone MM. It then appends those Error Source Descriptor(s) to the= Hest + table using the HEST Table generation protocol. + + @param[in] ImageHandle The firmware allocated handle for the Efi ima= ge. + @param[in] SystemTable A pointer to the Efi System Table. + + @retval EFI_SUCCESS The entry point is executed successfully. + @retval Other Some error occurred when executing this entry po= int. +**/ +EFI_STATUS +EFIAPI +HestErrorSourceInitialize ( + IN EFI_HANDLE ImageHandle, + IN EFI_SYSTEM_TABLE *SystemTable + ) +{ + EFI_STATUS Status; + + Status =3D gBS->LocateProtocol ( + &gHestTableProtocolGuid, + NULL, + (VOID **)&mHestProtocol + ); + if (EFI_ERROR (Status)) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed to locate HEST table generation protocol, status:%r\n"= , + __FUNCTION__, + Status + )); + return Status; + } + + Status =3D gBS->LocateProtocol ( + &gEfiMmCommunication2ProtocolGuid, + NULL, + (VOID **)&mMmCommunication2 + ); + if (EFI_ERROR (Status)) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed to locate MMCommunication2 driver protocol, status:%r\= n", + __FUNCTION__, + Status + )); + return Status; + } + + // + // Append HEST error sources retrieved from StandaloneMM, if any, into= the + // HEST ACPI table. + // + Status =3D AppendMmErrorSources (); + if (EFI_ERROR (Status)) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed appending error source desc to HEST table, status:%r\n= ", + __FUNCTION__, + Status + )); + } + return EFI_SUCCESS; +} diff --git a/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceSta= ndaloneMm.c b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceSt= andaloneMm.c new file mode 100644 index 000000000000..75dc31438180 --- /dev/null +++ b/ArmPlatformPkg/Drivers/HestMmErrorSources/HestErrorSourceStandalone= Mm.c @@ -0,0 +1,312 @@ +/** @file + MM HEST error source gateway driver. + + This MM driver installs a handler which can be used to retrieve the er= ror + source descriptors from the all MM drivers implementing the HEST error= source + descriptor protocol. + + The MM driver acts as a single point of contact to collect secure hard= ware + error sources from the MM drivers. It loops over all the MM drivers th= at + implement HEST error source descriptor protocol and collects error sou= rce + descriptor information along with the error source count and length. + + Copyright (c) 2020 - 2021, ARM Limited. All rights reserved. + SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include +#include +#include +#include +#include +#include + +#include "HestMmErrorSourceCommon.h" + +STATIC EFI_MM_SYSTEM_TABLE *mMmst =3D NULL; + +/** + Returns an array of handles that implement the HEST error source descr= iptor + protocol. + + Passing HandleBuffer as NULL will return the actual size of the buffer + required to hold the array of handles implementing the protocol. + + @param[in, out] HandleBufferSize The size of the HandleBuffer. + @param[out] HandleBuffer A pointer to the buffer containing = the list + of handles. + + @retval EFI_SUCCESS The array of handles returned in HandleBuffer. + @retval EFI_NOT_FOUND No implementation present for the protocol. + @retval Other For any other error. +**/ +STATIC +EFI_STATUS +GetHestErrorSourceProtocolHandles ( + IN OUT UINTN *HandleBufferSize, + OUT EFI_HANDLE **HandleBuffer + ) +{ + EFI_STATUS Status; + + Status =3D mMmst->MmLocateHandle ( + ByProtocol, + &gMmHestErrorSourceDescProtocolGuid, + NULL, + HandleBufferSize, + *HandleBuffer + ); + if ((EFI_ERROR (Status)) && + (Status !=3D EFI_BUFFER_TOO_SMALL)) + { + DEBUG (( + DEBUG_ERROR, + "%a: No implementation of MmHestErrorSourceDescProtocol found, \ + Status:%r\n", + __FUNCTION__, + Status + )); + return EFI_NOT_FOUND; + } + + return Status; +} + +/** + Mmi handler to retrieve HEST error source descriptor information. + + Handler for Mmi service that returns the supported HEST error source + descriptors in MM. This handler populates the CommBuffer with the + list of all error source descriptors, prepended with the length and + the number of descriptors populated into CommBuffer. + + @param[in] DispatchHandle The unique handle assigned to this ha= ndler by + MmiHandlerRegister(). + @param[in] Context Points to an optional handler context= that + is specified when the handler was reg= istered. + @param[in, out] CommBuffer Buffer used for communication of HEST= error + source descriptors. + @param[in, out] CommBufferSize The size of the CommBuffer. + + @retval EFI_SUCCESS CommBuffer has valid data. + @retval EFI_BAD_BUFFER_SIZE CommBufferSize not adequate. + @retval EFI_OUT_OF_RESOURCES System out of memory resources. + @retval EFI_INVALID_PARAMETER Invalid CommBufferSize recieved. + @retval Other For any other error. +**/ +STATIC +EFI_STATUS +EFIAPI +HestErrorSourcesInfoMmiHandler ( + IN EFI_HANDLE DispatchHandle, + IN CONST VOID *Context, OPTIONAL + IN OUT VOID *CommBuffer, OPTIONAL + IN UINTN *CommBufferSize OPTIONAL + ) +{ + MM_HEST_ERROR_SOURCE_DESC_PROTOCOL *HestErrSourceDescProtocolHandle; + HEST_ERROR_SOURCE_DESC_INFO *ErrorSourceInfoList; + EFI_HANDLE *HandleBuffer; + EFI_STATUS Status; + UINTN HandleCount; + UINTN HandleBufferSize; + UINTN Index; + UINTN SourceCount =3D 0; + UINTN SourceLength =3D 0; + VOID *ErrorSourcePtr; + UINTN TotalSourceLength =3D 0; + UINTN TotalSourceCount =3D 0; + + if (*CommBufferSize < HEST_ERROR_SOURCE_DESC_INFO_SIZE) { + // + // Ensures that the communication buffer has enough space to atleast= hold + // the ErrSourceDescCount and ErrSourceDescSize elements of the + // HEST_ERROR_SOURCE_DESC_INFO structure. + // + DEBUG (( + DEBUG_ERROR, + "%a: Invalid CommBufferSize parameter\n", + __FUNCTION__ + )); + return EFI_INVALID_PARAMETER; + } + + // + // Get all handles that implement the HEST error source descriptor pro= tocol. + // Get the buffer size required to store list of handles for the proto= col. + // + HandleBuffer =3D NULL; + HandleBufferSize =3D 0; + Status =3D GetHestErrorSourceProtocolHandles (&HandleBufferSize, &Hand= leBuffer); + if ((Status =3D=3D EFI_NOT_FOUND) || + (HandleBufferSize =3D=3D 0)) + { + return Status; + } + + // Allocate memory for HandleBuffer of size HandleBufferSize. + HandleBuffer =3D AllocateZeroPool (HandleBufferSize); + if (HandleBuffer =3D=3D NULL) { + DEBUG (( + DEBUG_ERROR, + "%a: Failed to allocate memory for HandleBuffer\n", + __FUNCTION__ + )); + return EFI_OUT_OF_RESOURCES; + } + + // Get the list of handles. + Status =3D GetHestErrorSourceProtocolHandles (&HandleBufferSize, &Hand= leBuffer); + if ((EFI_ERROR (Status)) || + (HandleBuffer =3D=3D NULL)) + { + FreePool (HandleBuffer); + return Status; + } + + // Count of handles for the protocol. + HandleCount =3D HandleBufferSize / sizeof (EFI_HANDLE); + + // + // Loop to get the count and length of the error source descriptors. + // + // This loop collects and adds the length of error source descriptors = and + // its count from all the the MM drivers implementing HEST error sourc= e. + // descriptor protocol. The total length and count values retrieved he= lp + // to determine weather the CommBuffer is big enough to hold the descr= iptor + // information. + // As mentioned in the HEST error source descriptor protocol definitio= n, + // Buffer parameter set to NULL ensures only length and the count valu= es + // are returned from the driver and no error source information is cop= ied to + // Buffer. + // + for (Index =3D 0; Index < HandleCount; ++Index) { + Status =3D mMmst->MmHandleProtocol ( + HandleBuffer[Index], + &gMmHestErrorSourceDescProtocolGuid, + (VOID **)&HestErrSourceDescProtocolHandle + ); + if (EFI_ERROR (Status)) { + continue; + } + + // + // Protocol called with Buffer parameter passed as NULL, must return + // error source length and error count for that driver. + // + Status =3D HestErrSourceDescProtocolHandle->GetHestErrorSourceDescri= ptors ( + HestErrSourceDescProtoco= lHandle, + NULL, + &SourceLength, + &SourceCount + ); + if (Status =3D=3D EFI_INVALID_PARAMETER) { + TotalSourceLength +=3D SourceLength; + TotalSourceCount +=3D SourceCount; + } + } + + // Set the count and length in the error source descriptor. + ErrorSourceInfoList =3D (HEST_ERROR_SOURCE_DESC_INFO *)(CommBuffer); + ErrorSourceInfoList->ErrSourceDescCount =3D TotalSourceCount; + ErrorSourceInfoList->ErrSourceDescSize =3D TotalSourceLength; + + // + // Check the size of CommBuffer, it should atleast be of size + // TotalSourceLength + HEST_ERROR_SOURCE_DESC_INFO_SIZE. + // + TotalSourceLength =3D TotalSourceLength + HEST_ERROR_SOURCE_DESC_INFO_= SIZE; + if ((*CommBufferSize) < TotalSourceLength) { + DEBUG (( + DEBUG_ERROR, + "%a: Invalid CommBufferSize parameter\n", + __FUNCTION__ + )); + FreePool (HandleBuffer); + return EFI_BUFFER_TOO_SMALL; + } + + // + // CommBuffer size is adequate to return all the error source descript= ors. + // So go ahead and populate it with the error source descriptor inform= ation. + // + + // Buffer pointer to append the Error Descriptors data. + ErrorSourcePtr =3D ErrorSourceInfoList->ErrSourceDescList; + + // + // Loop to retrieve error source descriptors information. + // + // Calls into each MM driver that implement the HEST error source desc= riptor + // protocol. Here the Buffer parameter passed to the protocol service = is + // valid. So the MM driver when called copies the descriptor informati= on. + // + for (Index =3D 0; Index < HandleCount; ++Index) { + Status =3D mMmst->MmHandleProtocol ( + HandleBuffer[Index], + &gMmHestErrorSourceDescProtocolGuid, + (VOID **)&HestErrSourceDescProtocolHandle + ); + if (EFI_ERROR (Status)) { + continue; + } + + Status =3D HestErrSourceDescProtocolHandle->GetHestErrorSourceDescri= ptors ( + HestErrSourceDescProtoco= lHandle, + (VOID **)&ErrorSourcePtr= , + &SourceLength, + &SourceCount + ); + if (Status =3D=3D EFI_SUCCESS) { + ErrorSourcePtr +=3D SourceLength; + } + } + + // Free the buffer holding all the protocol handles. + FreePool (HandleBuffer); + + return Status; +} + +/** + Entry point for this Stanalone MM driver. + + Registers an Mmi handler that retrieves the error source descriptors f= rom all + the MM drivers implementing the MM_HEST_ERROR_SOURCE_DESC_PROTOCOL. + + @param[in] ImageHandle The firmware allocated handle for the EFI ima= ge. + @param[in] SystemTable A pointer to the EFI System Table. + + @retval EFI_SUCCESS The entry point registered handler successfully. + @retval Other Some error occurred when executing this entry po= int. +**/ +EFI_STATUS +EFIAPI +StandaloneMmHestErrorSourceInitialize ( + IN EFI_HANDLE ImageHandle, + IN EFI_MM_SYSTEM_TABLE *SystemTable + ) +{ + EFI_HANDLE DispatchHandle; + EFI_STATUS Status; + + ASSERT (SystemTable !=3D NULL); + mMmst =3D SystemTable; + + Status =3D mMmst->MmiHandlerRegister ( + HestErrorSourcesInfoMmiHandler, + &gMmHestGetErrorSourceInfoGuid, + &DispatchHandle + ); + if (EFI_ERROR(Status)) { + DEBUG (( + DEBUG_ERROR, + "%a: Mmi handler registration failed with status : %r\n", + __FUNCTION__, + Status + )); + return Status; + } + + return Status; +} --=20 2.17.1