FspWrapperPlatformSecLibSample.c File Reference

#include <PiPei.h>
#include <Ppi/SecPlatformInformation.h>
#include <Ppi/SecPerformance.h>
#include <Library/LocalApicLib.h>
#include <Library/DebugLib.h>
#include <Library/BaseMemoryLib.h>

Go to the source code of this file.

Functions
EFI_STATUS EFIAPI	SecPlatformInformation (IN CONST EFI_PEI_SERVICES **PeiServices, IN OUT UINT64 *StructureSize, OUT EFI_SEC_PLATFORM_INFORMATION_RECORD *PlatformInformationRecord)
EFI_STATUS EFIAPI	SecGetPerformance (IN CONST EFI_PEI_SERVICES **PeiServices, IN PEI_SEC_PERFORMANCE_PPI *This, OUT FIRMWARE_SEC_PERFORMANCE *Performance)
EFI_PEI_PPI_DESCRIPTOR *EFIAPI	SecPlatformMain (IN OUT EFI_SEC_PEI_HAND_OFF *SecCoreData)

Variables
PEI_SEC_PERFORMANCE_PPI	mSecPerformancePpi
EFI_PEI_PPI_DESCRIPTOR	mPeiSecPlatformPpi []

Detailed Description

Sample to provide FSP wrapper platform sec related function.

Copyright (c) 2014 - 2016, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file FspWrapperPlatformSecLibSample.c.

Function Documentation

SecGetPerformance()

EFI_STATUS EFIAPI SecGetPerformance	(	IN CONST EFI_PEI_SERVICES **	PeiServices,
		IN PEI_SEC_PERFORMANCE_PPI *	This,
		OUT FIRMWARE_SEC_PERFORMANCE *	Performance
	)

This interface conveys performance information out of the Security (SEC) phase into PEI.

This service is published by the SEC phase. The SEC phase handoff has an optional EFI_PEI_PPI_DESCRIPTOR list as its final argument when control is passed from SEC into the PEI Foundation. As such, if the platform supports collecting performance data in SEC, this information is encapsulated into the data structure abstracted by this service. This information is collected for the boot-strap processor (BSP) on IA-32.

Parameters

[in]	PeiServices	The pointer to the PEI Services Table.
[in]	This	The pointer to this instance of the PEI_SEC_PERFORMANCE_PPI.
[out]	Performance	The pointer to performance data collected in SEC phase.

Return values

EFI_SUCCESS

The data was successfully returned.

Definition at line 36 of file SecGetPerformance.c.

SecPlatformInformation()

EFI_STATUS EFIAPI SecPlatformInformation	(	IN CONST EFI_PEI_SERVICES **	PeiServices,
		IN OUT UINT64 *	StructureSize,
		OUT EFI_SEC_PLATFORM_INFORMATION_RECORD *	PlatformInformationRecord
	)

This interface conveys state information out of the Security (SEC) phase into PEI.

Parameters

[in]	PeiServices	Pointer to the PEI Services Table.
[in,out]	StructureSize	Pointer to the variable describing size of the input buffer.
[out]	PlatformInformationRecord	Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.

Return values

EFI_SUCCESS	The data was successfully returned.
EFI_BUFFER_TOO_SMALL	The buffer was too small.

This interface conveys state information out of the Security (SEC) phase into PEI.

Parameters

PeiServices	Pointer to the PEI Services Table.
StructureSize	Pointer to the variable describing size of the input buffer.
PlatformInformationRecord	Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.

Return values

EFI_SUCCESS	The data was successfully returned.
EFI_BUFFER_TOO_SMALL	The buffer was too small.

Definition at line 30 of file SecPlatformInformation.c.

SecPlatformMain()

EFI_PEI_PPI_DESCRIPTOR *EFIAPI SecPlatformMain

(

IN OUT EFI_SEC_PEI_HAND_OFF *

SecCoreData

)

A developer supplied function to perform platform specific operations.

It's a developer supplied function to perform any operations appropriate to a given platform. It's invoked just before passing control to PEI core by SEC core. Platform developer may modify the SecCoreData passed to PEI Core. It returns a platform specific PPI list that platform wishes to pass to PEI core. The Generic SEC core module will merge this list to join the final list passed to PEI core.

Parameters

[in,out]

SecCoreData

The same parameter as passing to PEI core. It could be overridden by this function.

Returns

The platform specific PPI list to be passed to PEI core or NULL if there is no need of such platform specific PPI list.

Definition at line 97 of file FspWrapperPlatformSecLibSample.c.

Variable Documentation

mPeiSecPlatformPpi

EFI_PEI_PPI_DESCRIPTOR mPeiSecPlatformPpi[]

Initial value:

= {
  {
    EFI_PEI_PPI_DESCRIPTOR_PPI,
    &gTopOfTemporaryRamPpiGuid,
    NULL 
  },
  {
    EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST,
    &gPeiSecPerformancePpiGuid,
    &mSecPerformancePpi
  },
}

Definition at line 65 of file FspWrapperPlatformSecLibSample.c.

mSecPerformancePpi

PEI_SEC_PERFORMANCE_PPI mSecPerformancePpi

Initial value:

= {
  SecGetPerformance
}

Definition at line 61 of file FspWrapperPlatformSecLibSample.c.