mirror of
https://github.com/tianocore/edk2.git
synced 2025-08-26 22:07:55 +00:00
a72e6fe7ab
AmdSvsmQueryProtocol() is a helper function for QUERY_PROTOCOL calls of the core svsm protocol. Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
152 lines
3.7 KiB
C
152 lines
3.7 KiB
C
/** @file
|
|
Public header file for the AmdSvsmLib.
|
|
|
|
This library class defines some routines used for invoking an SVSM when the
|
|
guest is not running at VMPL0.
|
|
|
|
Copyright (C) 2024, Advanced Micro Devices, Inc. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef AMD_SVSM_LIB_H_
|
|
#define AMD_SVSM_LIB_H_
|
|
|
|
#include <Protocol/DebugSupport.h>
|
|
#include <Register/Amd/Ghcb.h>
|
|
|
|
/**
|
|
Report the presence of an Secure Virtual Services Module (SVSM).
|
|
|
|
Determines the presence of an SVSM.
|
|
|
|
@retval TRUE An SVSM is present
|
|
@retval FALSE An SVSM is not present
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
AmdSvsmIsSvsmPresent (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
Report the VMPL level at which the SEV-SNP guest is running.
|
|
|
|
Determines the VMPL level at which the guest is running. If an SVSM is
|
|
not present, then it must be VMPL0, otherwise return what is reported
|
|
by the SVSM.
|
|
|
|
@return The VMPL level
|
|
|
|
**/
|
|
UINT8
|
|
EFIAPI
|
|
AmdSvsmSnpGetVmpl (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
Report the Calling Area address (CAA) for the BSP of the SEV-SNP guest.
|
|
|
|
If an SVSM is present, the CAA for the BSP is returned.
|
|
|
|
@return The CAA
|
|
|
|
**/
|
|
UINT64
|
|
EFIAPI
|
|
AmdSvsmSnpGetCaa (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
Perform a PVALIDATE operation for the page ranges specified.
|
|
|
|
Validate or rescind the validation of the specified pages.
|
|
|
|
@param[in] Info Pointer to a page state change structure
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
AmdSvsmSnpPvalidate (
|
|
IN SNP_PAGE_STATE_CHANGE_INFO *Info
|
|
);
|
|
|
|
/**
|
|
Perform an RMPADJUST operation to alter the VMSA setting of a page.
|
|
|
|
Add or remove the VMSA attribute for a page.
|
|
|
|
@param[in] Vmsa Pointer to an SEV-ES save area page
|
|
@param[in] ApicId APIC ID associated with the VMSA
|
|
@param[in] SetVmsa Boolean indicator as to whether to set or
|
|
or clear the VMSA setting for the page
|
|
|
|
@retval EFI_SUCCESS RMPADJUST operation successful
|
|
@retval EFI_UNSUPPORTED Operation is not supported
|
|
@retval EFI_INVALID_PARAMETER RMPADJUST operation failed, an invalid
|
|
parameter was supplied
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
AmdSvsmSnpVmsaRmpAdjust (
|
|
IN SEV_ES_SAVE_AREA *Vmsa,
|
|
IN UINT32 ApicId,
|
|
IN BOOLEAN SetVmsa
|
|
);
|
|
|
|
/**
|
|
Perform a SVSM_VTPM_QUERY operation
|
|
|
|
Query the support provided by the SVSM vTPM.
|
|
|
|
@param[out] PlatformCommands It will contain a bitmap indicating the
|
|
supported vTPM platform commands.
|
|
@param[out] Features It will contain a bitmap indicating the
|
|
supported vTPM features.
|
|
|
|
@retval TRUE The query was processed.
|
|
@retval FALSE The query was not processed.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
AmdSvsmVtpmQuery (
|
|
OUT UINT64 *PlatformCommands,
|
|
OUT UINT64 *Features
|
|
);
|
|
|
|
/**
|
|
Perform a SVSM_VTPM_CMD operation
|
|
|
|
Send the specified vTPM platform command to the SVSM vTPM.
|
|
|
|
@param[in, out] Buffer It should contain the vTPM platform command
|
|
request. The respective response will be returned
|
|
in the same Buffer, but not all commands specify a
|
|
response.
|
|
|
|
@retval TRUE The command was processed.
|
|
@retval FALSE The command was not processed.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
AmdSvsmVtpmCmd (
|
|
IN OUT UINT8 *Buffer
|
|
);
|
|
|
|
BOOLEAN
|
|
EFIAPI
|
|
AmdSvsmQueryProtocol (
|
|
IN UINT32 ProtocolId,
|
|
IN UINT32 ProtocolVersion,
|
|
OUT UINT32 *ProtocolMin,
|
|
OUT UINT32 *ProtocolMax
|
|
);
|
|
|
|
#endif
|