#include <PiPei.h>
#include <Library/BaseLib.h>
#include <Library/DebugLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/PeiServicesLib.h>
#include <Library/PcdLib.h>
#include <Library/CpuLib.h>
#include <Library/DebugAgentLib.h>
#include <Library/IoLib.h>
#include <Library/PeCoffLib.h>
#include <Library/PeCoffGetEntryPointLib.h>
#include <Library/PeCoffExtraActionLib.h>
#include <Library/ExtractGuidedSectionLib.h>
#include <Library/LocalApicLib.h>
#include <Library/CpuExceptionHandlerLib.h>
#include <Ppi/TemporaryRamSupport.h>
#include <Ppi/MpInitLibDep.h>
#include <Library/TdxHelperLib.h>
#include <Library/CcProbeLib.h>
#include <Register/Intel/ArchitecturalMsr.h>
#include <Register/Intel/Cpuid.h>
#include "AmdSev.h"

Data Structures
struct	_SEC_IDT_TABLE

Macros
#define	SEC_IDT_ENTRY_COUNT 34

Typedefs
typedef struct _SEC_IDT_TABLE	SEC_IDT_TABLE

Functions
VOID EFIAPI	SecStartupPhase2 (IN VOID *Context)

EFI_STATUS EFIAPI	TemporaryRamMigration (IN CONST EFI_PEI_SERVICES **PeiServices, IN EFI_PHYSICAL_ADDRESS TemporaryMemoryBase, IN EFI_PHYSICAL_ADDRESS PermanentMemoryBase, IN UINTN CopySize)

EFI_STATUS	FindMainFv (IN OUT EFI_FIRMWARE_VOLUME_HEADER **BootFv)

EFI_STATUS	FindFfsSectionInstance (IN VOID Sections, IN UINTN SizeOfSections, IN EFI_SECTION_TYPE SectionType, IN UINTN Instance, OUT EFI_COMMON_SECTION_HEADER *FoundSection)

EFI_STATUS	FindFfsSectionInSections (IN VOID Sections, IN UINTN SizeOfSections, IN EFI_SECTION_TYPE SectionType, OUT EFI_COMMON_SECTION_HEADER *FoundSection)

EFI_STATUS	FindFfsFileAndSection (IN EFI_FIRMWARE_VOLUME_HEADER Fv, IN EFI_FV_FILETYPE FileType, IN EFI_SECTION_TYPE SectionType, OUT EFI_COMMON_SECTION_HEADER *FoundSection)

EFI_STATUS	DecompressMemFvs (IN OUT EFI_FIRMWARE_VOLUME_HEADER **Fv)

EFI_STATUS	FindPeiCoreImageBaseInFv (IN EFI_FIRMWARE_VOLUME_HEADER Fv, OUT EFI_PHYSICAL_ADDRESS PeiCoreImageBase)

STATIC UINT8	CmosRead8 (IN UINTN Index)

STATIC BOOLEAN	IsS3Resume (VOID)

STATIC EFI_STATUS	GetS3ResumePeiFv (IN OUT EFI_FIRMWARE_VOLUME_HEADER **PeiFv)

VOID	FindPeiCoreImageBase (IN OUT EFI_FIRMWARE_VOLUME_HEADER *BootFv, OUT EFI_PHYSICAL_ADDRESS PeiCoreImageBase)

EFI_STATUS	FindImageBase (IN EFI_FIRMWARE_VOLUME_HEADER BootFirmwareVolumePtr, OUT EFI_PHYSICAL_ADDRESS SecCoreImageBase)

VOID	FindAndReportEntryPoints (IN EFI_FIRMWARE_VOLUME_HEADER *BootFirmwareVolumePtr, OUT EFI_PEI_CORE_ENTRY_POINT PeiCoreEntryPoint)

STATIC VOID	SecMtrrSetup (VOID)

VOID EFIAPI	SecCoreStartupWithStack (IN EFI_FIRMWARE_VOLUME_HEADER BootFv, IN VOID TopOfCurrentStack)

Variables
EFI_PEI_TEMPORARY_RAM_SUPPORT_PPI	mTemporaryRamSupportPpi

EFI_PEI_PPI_DESCRIPTOR	mPrivateDispatchTableMp []

EFI_PEI_PPI_DESCRIPTOR	mPrivateDispatchTableUp []

IA32_IDT_GATE_DESCRIPTOR	mIdtEntryTemplate

Detailed Description

Main SEC phase code. Transitions to PEI.

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file SecMain.c.

Macro Definition Documentation

◆ SEC_IDT_ENTRY_COUNT

#define SEC_IDT_ENTRY_COUNT 34

Definition at line 36 of file SecMain.c.

Function Documentation

◆ CmosRead8()

STATIC UINT8 CmosRead8 ( IN UINTN Index )

Reads 8-bits of CMOS data.

Reads the 8-bits of CMOS data at the location specified by Index. The 8-bit read value is returned.

Parameters

Index The CMOS location to read.

Returns: The value read.

Definition at line 533 of file SecMain.c.

◆ DecompressMemFvs()

EFI_STATUS DecompressMemFvs ( IN OUT EFI_FIRMWARE_VOLUME_HEADER ** Fv )

Locates the compressed main firmware volume and decompresses it.

Parameters

[in,out] Fv On input, the firmware volume to search On output, the decompressed BOOT/PEI FV

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted

Definition at line 341 of file SecMain.c.

◆ FindAndReportEntryPoints()

VOID FindAndReportEntryPoints	(	IN EFI_FIRMWARE_VOLUME_HEADER **	BootFirmwareVolumePtr,
		OUT EFI_PEI_CORE_ENTRY_POINT *	PeiCoreEntryPoint
	)

Definition at line 704 of file SecMain.c.

◆ FindFfsFileAndSection()

EFI_STATUS FindFfsFileAndSection	(	IN EFI_FIRMWARE_VOLUME_HEADER *	Fv,
		IN EFI_FV_FILETYPE	FileType,
		IN EFI_SECTION_TYPE	SectionType,
		OUT EFI_COMMON_SECTION_HEADER **	FoundSection
	)

Locates a FFS file with the specified file type and a section within that file with the specified section type.

Parameters

[in]	Fv	The firmware volume to search
[in]	FileType	The file type to locate
[in]	SectionType	The section type to locate
[out]	FoundSection	The FFS section if found

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted

Definition at line 268 of file SecMain.c.

◆ FindFfsSectionInSections()

EFI_STATUS FindFfsSectionInSections	(	IN VOID *	Sections,
		IN UINTN	SizeOfSections,
		IN EFI_SECTION_TYPE	SectionType,
		OUT EFI_COMMON_SECTION_HEADER **	FoundSection
	)

Locates a section within a series of sections with the specified section type.

Parameters

[in]	Sections	The sections to search
[in]	SizeOfSections	Total size of all sections
[in]	SectionType	The section type to locate
[out]	FoundSection	The FFS section if found

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted

Definition at line 237 of file SecMain.c.

◆ FindFfsSectionInstance()

EFI_STATUS FindFfsSectionInstance	(	IN VOID *	Sections,
		IN UINTN	SizeOfSections,
		IN EFI_SECTION_TYPE	SectionType,
		IN UINTN	Instance,
		OUT EFI_COMMON_SECTION_HEADER **	FoundSection
	)

Locates a section within a series of sections with the specified section type.

The Instance parameter indicates which instance of the section type to return. (0 is first instance, 1 is second...)

Parameters

[in]	Sections	The sections to search
[in]	SizeOfSections	Total size of all sections
[in]	SectionType	The section type to locate
[in]	Instance	The section instance number
[out]	FoundSection	The FFS section if found

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted

Definition at line 165 of file SecMain.c.

◆ FindImageBase()

EFI_STATUS FindImageBase	(	IN EFI_FIRMWARE_VOLUME_HEADER *	BootFirmwareVolumePtr,
		OUT EFI_PHYSICAL_ADDRESS *	SecCoreImageBase
	)

Find core image base.

Definition at line 612 of file SecMain.c.

◆ FindMainFv()

EFI_STATUS FindMainFv ( IN OUT EFI_FIRMWARE_VOLUME_HEADER ** BootFv )

Locates the main boot firmware volume.

Parameters

[in,out] BootFv On input, the base of the BootFv On output, the decompressed main firmware volume

Return values

EFI_SUCCESS	The main firmware volume was located and decompressed
EFI_NOT_FOUND	The main firmware volume was not found

Definition at line 115 of file SecMain.c.

◆ FindPeiCoreImageBase()

VOID FindPeiCoreImageBase	(	IN OUT EFI_FIRMWARE_VOLUME_HEADER **	BootFv,
		OUT EFI_PHYSICAL_ADDRESS *	PeiCoreImageBase
	)

Locates the PEI Core entry point address

Parameters

[in,out]	Fv	The firmware volume to search
[out]	PeiCoreEntryPoint	The entry point of the PEI Core image

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted

Definition at line 572 of file SecMain.c.

◆ FindPeiCoreImageBaseInFv()

EFI_STATUS FindPeiCoreImageBaseInFv	(	IN EFI_FIRMWARE_VOLUME_HEADER *	Fv,
		OUT EFI_PHYSICAL_ADDRESS *	PeiCoreImageBase
	)

Locates the PEI Core entry point address

Parameters

[in]	Fv	The firmware volume to search
[out]	PeiCoreEntryPoint	The entry point of the PEI Core image

Return values

EFI_SUCCESS	The file and section was found
EFI_NOT_FOUND	The file and section was not found
EFI_VOLUME_CORRUPTED	The firmware volume was corrupted

Definition at line 489 of file SecMain.c.

◆ GetS3ResumePeiFv()

STATIC EFI_STATUS GetS3ResumePeiFv ( IN OUT EFI_FIRMWARE_VOLUME_HEADER ** PeiFv )

Definition at line 552 of file SecMain.c.

◆ IsS3Resume()

STATIC BOOLEAN IsS3Resume ( VOID )

Definition at line 543 of file SecMain.c.

◆ SecCoreStartupWithStack()

VOID EFIAPI SecCoreStartupWithStack	(	IN EFI_FIRMWARE_VOLUME_HEADER *	BootFv,
		IN VOID *	TopOfCurrentStack
	)

Definition at line 790 of file SecMain.c.

◆ SecMtrrSetup()

STATIC VOID SecMtrrSetup ( VOID )

Definition at line 755 of file SecMain.c.

◆ SecStartupPhase2()

VOID EFIAPI SecStartupPhase2 ( IN VOID * Context )

Caller provided function to be invoked at the end of InitializeDebugAgent().

Entry point to the C language phase of SEC. After the SEC assembly code has initialized some temporary memory and set up the stack, the control is transferred to this function.

Parameters

[in] Context The first input parameter of InitializeDebugAgent().

Definition at line 1010 of file SecMain.c.

◆ TemporaryRamMigration()

EFI_STATUS EFIAPI TemporaryRamMigration	(	IN CONST EFI_PEI_SERVICES **	PeiServices,
		IN EFI_PHYSICAL_ADDRESS	TemporaryMemoryBase,
		IN EFI_PHYSICAL_ADDRESS	PermanentMemoryBase,
		IN UINTN	CopySize
	)

Definition at line 1054 of file SecMain.c.

Variable Documentation

◆ mIdtEntryTemplate

IA32_IDT_GATE_DESCRIPTOR mIdtEntryTemplate

Initial value:

= {
  {                                      
    0xffe4,                              
    0x10,                                
    0x0,                                 
    IA32_IDT_GATE_TYPE_INTERRUPT_32,     
    0xffff                               
  }
}

Definition at line 94 of file SecMain.c.

◆ mPrivateDispatchTableMp

EFI_PEI_PPI_DESCRIPTOR mPrivateDispatchTableMp[]

Initial value:

= {
  {
    (EFI_PEI_PPI_DESCRIPTOR_PPI),
    &gEfiTemporaryRamSupportPpiGuid,
    &mTemporaryRamSupportPpi
  },
  {
    (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
    &gEfiPeiMpInitLibMpDepPpiGuid,
    NULL
  },
}

Definition at line 65 of file SecMain.c.

◆ mPrivateDispatchTableUp

EFI_PEI_PPI_DESCRIPTOR mPrivateDispatchTableUp[]

Initial value:

= {
  {
    (EFI_PEI_PPI_DESCRIPTOR_PPI),
    &gEfiTemporaryRamSupportPpiGuid,
    &mTemporaryRamSupportPpi
  },
  {
    (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
    &gEfiPeiMpInitLibUpDepPpiGuid,
    NULL
  },
}

Definition at line 78 of file SecMain.c.

◆ mTemporaryRamSupportPpi

EFI_PEI_TEMPORARY_RAM_SUPPORT_PPI mTemporaryRamSupportPpi

Initial value:

= {
  TemporaryRamMigration
}

Definition at line 61 of file SecMain.c.

Data Structures

Macros

Typedefs

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ SEC_IDT_ENTRY_COUNT

Function Documentation

◆ CmosRead8()

◆ DecompressMemFvs()

◆ FindAndReportEntryPoints()

◆ FindFfsFileAndSection()

◆ FindFfsSectionInSections()

◆ FindFfsSectionInstance()

◆ FindImageBase()

◆ FindMainFv()

◆ FindPeiCoreImageBase()

◆ FindPeiCoreImageBaseInFv()

◆ GetS3ResumePeiFv()

◆ IsS3Resume()

◆ SecCoreStartupWithStack()

◆ SecMtrrSetup()

◆ SecStartupPhase2()

◆ TemporaryRamMigration()

Variable Documentation

◆ mIdtEntryTemplate

◆ mPrivateDispatchTableMp

◆ mPrivateDispatchTableUp

◆ mTemporaryRamSupportPpi