OvmfPkg/UefiCpuPkg/UefiPayloadPkg: Rename VmgExitLib to CcExitLib
BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=4123 VmgExitLib once was designed to provide interfaces to support #VC handler and issue VMGEXIT instruction. After TDVF (enable TDX feature in OVMF) is introduced, this library is updated to support #VE as well. Now the name of VmgExitLib cannot reflect what the lib does. This patch renames VmgExitLib to CcExitLib (Cc means Confidential Computing). This is a simple renaming and there is no logic changes. After renaming all the VmgExitLib related codes are updated with CcExitLib. These changes are in OvmfPkg/UefiCpuPkg/UefiPayloadPkg. Cc: Guo Dong <guo.dong@intel.com> Cc: Sean Rhodes <sean@starlabs.systems> Cc: James Lu <james.lu@intel.com> Cc: Gua Guo <gua.guo@intel.com> Cc: Eric Dong <eric.dong@intel.com> Cc: Ray Ni <ray.ni@intel.com> Cc: Brijesh Singh <brijesh.singh@amd.com> Cc: Erdem Aktas <erdemaktas@google.com> Cc: Gerd Hoffmann <kraxel@redhat.com> Cc: James Bottomley <jejb@linux.ibm.com> Cc: Jiewen Yao <jiewen.yao@intel.com> Cc: Tom Lendacky <thomas.lendacky@amd.com> Reviewed-by: James Lu <james.lu@intel.com> Reviewed-by: Gua Guo <gua.guo@intel.com> Reviewed-by: Jiewen Yao <jiewen.yao@intel.com> Reviewed-by: Ray Ni <ray.ni@intel.com> Signed-off-by: Min Xu <min.m.xu@intel.com>
This commit is contained in:
194
UefiCpuPkg/Library/CcExitLibNull/CcExitLibNull.c
Normal file
194
UefiCpuPkg/Library/CcExitLibNull/CcExitLibNull.c
Normal file
@@ -0,0 +1,194 @@
|
||||
/** @file
|
||||
CcExit Base Support Library.
|
||||
|
||||
Copyright (C) 2020, Advanced Micro Devices, Inc. All rights reserved.<BR>
|
||||
Copyright (c) 2020 - 2022, Intel Corporation. All rights reserved.<BR>
|
||||
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
|
||||
**/
|
||||
|
||||
#include <Base.h>
|
||||
#include <Uefi.h>
|
||||
#include <Library/CcExitLib.h>
|
||||
|
||||
/**
|
||||
Perform VMGEXIT.
|
||||
|
||||
Sets the necessary fields of the GHCB, invokes the VMGEXIT instruction and
|
||||
then handles the return actions.
|
||||
|
||||
The base library function returns an error in the form of a
|
||||
GHCB_EVENT_INJECTION representing a GP_EXCEPTION.
|
||||
|
||||
@param[in, out] Ghcb A pointer to the GHCB
|
||||
@param[in] ExitCode VMGEXIT code to be assigned to the SwExitCode
|
||||
field of the GHCB.
|
||||
@param[in] ExitInfo1 VMGEXIT information to be assigned to the
|
||||
SwExitInfo1 field of the GHCB.
|
||||
@param[in] ExitInfo2 VMGEXIT information to be assigned to the
|
||||
SwExitInfo2 field of the GHCB.
|
||||
|
||||
@retval 0 VMGEXIT succeeded.
|
||||
@return Exception number to be propagated, VMGEXIT
|
||||
processing did not succeed.
|
||||
|
||||
**/
|
||||
UINT64
|
||||
EFIAPI
|
||||
VmgExit (
|
||||
IN OUT GHCB *Ghcb,
|
||||
IN UINT64 ExitCode,
|
||||
IN UINT64 ExitInfo1,
|
||||
IN UINT64 ExitInfo2
|
||||
)
|
||||
{
|
||||
GHCB_EVENT_INJECTION Event;
|
||||
|
||||
Event.Uint64 = 0;
|
||||
Event.Elements.Vector = GP_EXCEPTION;
|
||||
Event.Elements.Type = GHCB_EVENT_INJECTION_TYPE_EXCEPTION;
|
||||
Event.Elements.Valid = 1;
|
||||
|
||||
return Event.Uint64;
|
||||
}
|
||||
|
||||
/**
|
||||
Perform pre-VMGEXIT initialization/preparation.
|
||||
|
||||
Performs the necessary steps in preparation for invoking VMGEXIT. Must be
|
||||
called before setting any fields within the GHCB.
|
||||
|
||||
@param[in, out] Ghcb A pointer to the GHCB
|
||||
@param[in, out] InterruptState A pointer to hold the current interrupt
|
||||
state, used for restoring in VmgDone ()
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
VmgInit (
|
||||
IN OUT GHCB *Ghcb,
|
||||
IN OUT BOOLEAN *InterruptState
|
||||
)
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
Perform post-VMGEXIT cleanup.
|
||||
|
||||
Performs the necessary steps to cleanup after invoking VMGEXIT. Must be
|
||||
called after obtaining needed fields within the GHCB.
|
||||
|
||||
@param[in, out] Ghcb A pointer to the GHCB
|
||||
@param[in] InterruptState An indicator to conditionally (re)enable
|
||||
interrupts
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
VmgDone (
|
||||
IN OUT GHCB *Ghcb,
|
||||
IN BOOLEAN InterruptState
|
||||
)
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
Marks a field at the specified offset as valid in the GHCB.
|
||||
|
||||
The ValidBitmap area represents the areas of the GHCB that have been marked
|
||||
valid. Set the bit in ValidBitmap for the input offset.
|
||||
|
||||
@param[in, out] Ghcb Pointer to the Guest-Hypervisor Communication Block
|
||||
@param[in] Offset Qword offset in the GHCB to mark valid
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
VmgSetOffsetValid (
|
||||
IN OUT GHCB *Ghcb,
|
||||
IN GHCB_REGISTER Offset
|
||||
)
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
Checks if a specified offset is valid in the GHCB.
|
||||
|
||||
The ValidBitmap area represents the areas of the GHCB that have been marked
|
||||
valid. Return whether the bit in the ValidBitmap is set for the input offset.
|
||||
|
||||
@param[in] Ghcb A pointer to the GHCB
|
||||
@param[in] Offset Qword offset in the GHCB to mark valid
|
||||
|
||||
@retval TRUE Offset is marked valid in the GHCB
|
||||
@retval FALSE Offset is not marked valid in the GHCB
|
||||
|
||||
**/
|
||||
BOOLEAN
|
||||
EFIAPI
|
||||
VmgIsOffsetValid (
|
||||
IN GHCB *Ghcb,
|
||||
IN GHCB_REGISTER Offset
|
||||
)
|
||||
{
|
||||
return FALSE;
|
||||
}
|
||||
|
||||
/**
|
||||
Handle a #VC exception.
|
||||
|
||||
Performs the necessary processing to handle a #VC exception.
|
||||
|
||||
The base library function returns an error equal to VC_EXCEPTION,
|
||||
to be propagated to the standard exception handling stack.
|
||||
|
||||
@param[in, out] ExceptionType Pointer to an EFI_EXCEPTION_TYPE to be set
|
||||
as value to use on error.
|
||||
@param[in, out] SystemContext Pointer to EFI_SYSTEM_CONTEXT
|
||||
|
||||
@retval EFI_SUCCESS Exception handled
|
||||
@retval EFI_UNSUPPORTED #VC not supported, (new) exception value to
|
||||
propagate provided
|
||||
@retval EFI_PROTOCOL_ERROR #VC handling failed, (new) exception value to
|
||||
propagate provided
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
VmgExitHandleVc (
|
||||
IN OUT EFI_EXCEPTION_TYPE *ExceptionType,
|
||||
IN OUT EFI_SYSTEM_CONTEXT SystemContext
|
||||
)
|
||||
{
|
||||
*ExceptionType = VC_EXCEPTION;
|
||||
|
||||
return EFI_UNSUPPORTED;
|
||||
}
|
||||
|
||||
/**
|
||||
Handle a #VE exception.
|
||||
|
||||
Performs the necessary processing to handle a #VE exception.
|
||||
|
||||
@param[in, out] ExceptionType Pointer to an EFI_EXCEPTION_TYPE to be set
|
||||
as value to use on error.
|
||||
@param[in, out] SystemContext Pointer to EFI_SYSTEM_CONTEXT
|
||||
|
||||
@retval EFI_SUCCESS Exception handled
|
||||
@retval EFI_UNSUPPORTED #VE not supported, (new) exception value to
|
||||
propagate provided
|
||||
@retval EFI_PROTOCOL_ERROR #VE handling failed, (new) exception value to
|
||||
propagate provided
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
VmTdExitHandleVe (
|
||||
IN OUT EFI_EXCEPTION_TYPE *ExceptionType,
|
||||
IN OUT EFI_SYSTEM_CONTEXT SystemContext
|
||||
)
|
||||
{
|
||||
*ExceptionType = VE_EXCEPTION;
|
||||
|
||||
return EFI_UNSUPPORTED;
|
||||
}
|
28
UefiCpuPkg/Library/CcExitLibNull/CcExitLibNull.inf
Normal file
28
UefiCpuPkg/Library/CcExitLibNull/CcExitLibNull.inf
Normal file
@@ -0,0 +1,28 @@
|
||||
## @file
|
||||
# CcExit Base Support Library.
|
||||
#
|
||||
# Copyright (C) 2020, Advanced Micro Devices, Inc. All rights reserved.<BR>
|
||||
# Copyright (c) 2020 - 2022, Intel Corporation. All rights reserved.<BR>
|
||||
# SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
#
|
||||
##
|
||||
|
||||
[Defines]
|
||||
INF_VERSION = 0x00010005
|
||||
BASE_NAME = CcExitLibNull
|
||||
MODULE_UNI_FILE = CcExitLibNull.uni
|
||||
FILE_GUID = 3cd7368f-ef9b-4a9b-9571-2ed93813677e
|
||||
MODULE_TYPE = BASE
|
||||
VERSION_STRING = 1.0
|
||||
LIBRARY_CLASS = CcExitLib
|
||||
|
||||
[Sources.common]
|
||||
CcExitLibNull.c
|
||||
|
||||
[Packages]
|
||||
MdePkg/MdePkg.dec
|
||||
UefiCpuPkg/UefiCpuPkg.dec
|
||||
|
||||
[LibraryClasses]
|
||||
BaseLib
|
||||
|
14
UefiCpuPkg/Library/CcExitLibNull/CcExitLibNull.uni
Normal file
14
UefiCpuPkg/Library/CcExitLibNull/CcExitLibNull.uni
Normal file
@@ -0,0 +1,14 @@
|
||||
// /** @file
|
||||
// CcExitLib instance.
|
||||
//
|
||||
// Copyright (C) 2020, Advanced Micro Devices, Inc. All rights reserved.<BR>
|
||||
// Copyright (c) 2020 - 2022, Intel Corporation. All rights reserved.<BR>
|
||||
// SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
//
|
||||
// **/
|
||||
|
||||
|
||||
#string STR_MODULE_ABSTRACT #language en-US "CcExitLib NULL instance"
|
||||
|
||||
#string STR_MODULE_DESCRIPTION #language en-US "CcExitLib NULL instance."
|
||||
|
Reference in New Issue
Block a user