Security.c File Reference

#include "PeiMain.h"

Go to the source code of this file.

Functions
VOID	InitializeSecurityServices (IN EFI_PEI_SERVICES **PeiServices, IN PEI_CORE_INSTANCE *OldCoreData)
EFI_STATUS EFIAPI	SecurityPpiNotifyCallback (IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDescriptor, IN VOID *Ppi)
EFI_STATUS	VerifyPeim (IN PEI_CORE_INSTANCE *PrivateData, IN EFI_PEI_FV_HANDLE VolumeHandle, IN EFI_PEI_FILE_HANDLE FileHandle, IN UINT32 AuthenticationStatus)
EFI_STATUS	VerifyFv (IN EFI_FIRMWARE_VOLUME_HEADER *CurrentFvAddress)

Variables
EFI_PEI_NOTIFY_DESCRIPTOR	mNotifyList

Detailed Description

EFI PEI Core Security services

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

Definition in file Security.c.

Function Documentation

InitializeSecurityServices()

VOID InitializeSecurityServices	(	IN EFI_PEI_SERVICES **	PeiServices,
		IN PEI_CORE_INSTANCE *	OldCoreData
	)

Initialize the security services.

Parameters

PeiServices	An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
OldCoreData	Pointer to the old core data. NULL if being run in non-permanent memory mode.

Definition at line 26 of file Security.c.

SecurityPpiNotifyCallback()

EFI_STATUS EFIAPI SecurityPpiNotifyCallback	(	IN EFI_PEI_SERVICES **	PeiServices,
		IN EFI_PEI_NOTIFY_DESCRIPTOR *	NotifyDescriptor,
		IN VOID *	Ppi
	)

Provide a callback for when the security PPI is installed. This routine will cache installed security PPI into PeiCore's private data.

Parameters

PeiServices	An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.
NotifyDescriptor	The descriptor for the notification event.
Ppi	Pointer to the PPI in question.

Returns

Always success

Definition at line 52 of file Security.c.

VerifyFv()

EFI_STATUS VerifyFv

(

IN EFI_FIRMWARE_VOLUME_HEADER *

CurrentFvAddress

)

Verify a Firmware volume.

Parameters

CurrentFvAddress

Pointer to the current Firmware Volume under consideration

Return values

EFI_SUCCESS

Firmware Volume is legal

Definition at line 137 of file Security.c.

VerifyPeim()

EFI_STATUS VerifyPeim	(	IN PEI_CORE_INSTANCE *	PrivateData,
		IN EFI_PEI_FV_HANDLE	VolumeHandle,
		IN EFI_PEI_FILE_HANDLE	FileHandle,
		IN UINT32	AuthenticationStatus
	)

Provide a callout to the security verification service.

Parameters

PrivateData	PeiCore's private data structure
VolumeHandle	Handle of FV
FileHandle	Handle of PEIM's FFS
AuthenticationStatus	Authentication status

Return values

EFI_SUCCESS	Image is OK
EFI_SECURITY_VIOLATION	Image is illegal
EFI_NOT_FOUND	If security PPI is not installed.

Definition at line 88 of file Security.c.

Variable Documentation

mNotifyList

EFI_PEI_NOTIFY_DESCRIPTOR mNotifyList

Initial value:

= {
  EFI_PEI_PPI_DESCRIPTOR_NOTIFY_DISPATCH | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST,
  &gEfiPeiSecurity2PpiGuid,
  SecurityPpiNotifyCallback
}

Definition at line 11 of file Security.c.