SmmCpuPlatformHookLibNull.c File Reference

#include <PiSmm.h>
#include <Library/SmmCpuPlatformHookLib.h>

Go to the source code of this file.

Functions
BOOLEAN EFIAPI	PlatformValidSmi (VOID)
BOOLEAN EFIAPI	ClearTopLevelSmiStatus (VOID)
EFI_STATUS EFIAPI	PlatformSmmBspElection (OUT BOOLEAN *IsBsp)
EFI_STATUS EFIAPI	GetPlatformPageTableAttribute (IN UINT64 Address, IN OUT SMM_PAGE_SIZE_TYPE *PageSize, IN OUT UINTN *NumOfPages, IN OUT UINTN *PageAttribute)
EFI_STATUS EFIAPI	SmmCpuPlatformHookBeforeMmiHandler (VOID)

Detailed Description

SMM CPU Platform Hook NULL library instance.

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

Definition in file SmmCpuPlatformHookLibNull.c.

Function Documentation

ClearTopLevelSmiStatus()

BOOLEAN EFIAPI ClearTopLevelSmiStatus

(

VOID

)

Clears platform top level SMI status bit.

This function clears platform top level SMI status bit.

Return values

TRUE	The platform top level SMI status is cleared.
FALSE	The platform top level SMI status cannot be cleared.

Definition at line 43 of file SmmCpuPlatformHookLibNull.c.

GetPlatformPageTableAttribute()

EFI_STATUS EFIAPI GetPlatformPageTableAttribute	(	IN UINT64	Address,
		IN OUT SMM_PAGE_SIZE_TYPE *	PageSize,
		IN OUT UINTN *	NumOfPages,
		IN OUT UINTN *	PageAttribute
	)

Get platform page table attribute.

This function gets page table attribute of platform.

Parameters

Address	Input parameter. Obtain the page table entries attribute on this address.
PageSize	Output parameter. The size of the page.
NumOfPages	Output parameter. Number of page.
PageAttribute	Output parameter. Paging Attributes (WB, UC, etc).

Return values

EFI_SUCCESS	The platform page table attribute from the address is determined.
EFI_UNSUPPORTED	The platform does not support getting page table attribute for the address.

Definition at line 94 of file SmmCpuPlatformHookLibNull.c.

PlatformSmmBspElection()

EFI_STATUS EFIAPI PlatformSmmBspElection

(

OUT BOOLEAN *

IsBsp

)

Performs platform specific way of SMM BSP election.

This function performs platform specific way of SMM BSP election.

Parameters

IsBsp

Output parameter. TRUE: the CPU this function executes on is elected to be the SMM BSP. FALSE: the CPU this function executes on is to be SMM AP.

Return values

EFI_SUCCESS	The function executes successfully.
EFI_NOT_READY	The function does not determine whether this CPU should be BSP or AP. This may occur if hardware init sequence to enable the determination is yet to be done, or the function chooses not to do BSP election and will let SMM CPU driver to use its default BSP election process.
EFI_DEVICE_ERROR	The function cannot determine whether this CPU should be BSP or AP due to hardware error.

Definition at line 71 of file SmmCpuPlatformHookLibNull.c.

PlatformValidSmi()

BOOLEAN EFIAPI PlatformValidSmi

(

VOID

)

Checks if platform produces a valid SMI.

This function checks if platform produces a valid SMI. This function is called at SMM entry to detect if this is a spurious SMI. This function must be implemented in an MP safe way because it is called by multiple CPU threads.

Return values

TRUE	There is a valid SMI
FALSE	There is no valid SMI

Definition at line 25 of file SmmCpuPlatformHookLibNull.c.

SmmCpuPlatformHookBeforeMmiHandler()

EFI_STATUS EFIAPI SmmCpuPlatformHookBeforeMmiHandler

(

VOID

)

SMM CPU Platform Hook before executing MMI Handler.

This function can be used to perform the platform specific items before executing MMI Handler.

Return values

EFI_SUCCESS	The smm cpu platform hook before executing MMI Handler is executed successfully.
EFI_UNSUPPORTED	The smm cpu platform hook before executing MMI Handler is unsupported.

Definition at line 115 of file SmmCpuPlatformHookLibNull.c.