MdePkg: Removed IPF related code
A previous commit(3cb0a311cb
) didn't
clean all IPF contents. So this change removes the rest contents.
https://bugzilla.tianocore.org/show_bug.cgi?id=1560
v2: Withdraw the removal of Mps.h. It is written in Mps.h that
MPS only was included to support Itanium-based platform power on.
But we found MPS is not so relevant to Itanium architecture.
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Shenglei Zhang <shenglei.zhang@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
This commit is contained in:
committed by
Liming Gao
parent
5a1ca93a1f
commit
4e1daa60f5
@@ -1,488 +0,0 @@
|
||||
/** @file
|
||||
Library class definition of Extended SAL Library.
|
||||
|
||||
Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
|
||||
**/
|
||||
|
||||
#ifndef _EXTENDED_SAL_LIB_H__
|
||||
#define _EXTENDED_SAL_LIB_H__
|
||||
|
||||
#include <IndustryStandard/Sal.h>
|
||||
|
||||
/**
|
||||
Register ESAL Class and its associated global.
|
||||
|
||||
This function Registers one or more Extended SAL services in a given
|
||||
class along with the associated global context.
|
||||
This function is only available prior to ExitBootServices().
|
||||
|
||||
@param ClassGuidLo GUID of function class, lower 64-bits
|
||||
@param ClassGuidHi GUID of function class, upper 64-bits
|
||||
@param ModuleGlobal Module global for Function.
|
||||
@param ... List of Function/FunctionId pairs, ended by NULL
|
||||
|
||||
@retval EFI_SUCCESS The Extended SAL services were registered.
|
||||
@retval EFI_UNSUPPORTED This function was called after ExitBootServices().
|
||||
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to register one or more of the specified services.
|
||||
@retval Other ClassGuid could not be installed onto a new handle.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
RegisterEsalClass (
|
||||
IN CONST UINT64 ClassGuidLo,
|
||||
IN CONST UINT64 ClassGuidHi,
|
||||
IN VOID *ModuleGlobal, OPTIONAL
|
||||
...
|
||||
);
|
||||
|
||||
/**
|
||||
Calls an Extended SAL Class service that was previously registered with RegisterEsalClass().
|
||||
|
||||
This function calls an Extended SAL Class service that was previously registered with RegisterEsalClass().
|
||||
|
||||
@param ClassGuidLo GUID of function, lower 64-bits
|
||||
@param ClassGuidHi GUID of function, upper 64-bits
|
||||
@param FunctionId Function in ClassGuid to call
|
||||
@param Arg2 Argument 2 ClassGuid/FunctionId defined
|
||||
@param Arg3 Argument 3 ClassGuid/FunctionId defined
|
||||
@param Arg4 Argument 4 ClassGuid/FunctionId defined
|
||||
@param Arg5 Argument 5 ClassGuid/FunctionId defined
|
||||
@param Arg6 Argument 6 ClassGuid/FunctionId defined
|
||||
@param Arg7 Argument 7 ClassGuid/FunctionId defined
|
||||
@param Arg8 Argument 8 ClassGuid/FunctionId defined
|
||||
|
||||
@retval EFI_SAL_ERROR The address of ExtendedSalProc() can not be determined
|
||||
for the current CPU execution mode.
|
||||
@retval Other See the return status from ExtendedSalProc() in the
|
||||
EXTENDED_SAL_BOOT_SERVICE_PROTOCOL.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalCall (
|
||||
IN UINT64 ClassGuidLo,
|
||||
IN UINT64 ClassGuidHi,
|
||||
IN UINT64 FunctionId,
|
||||
IN UINT64 Arg2,
|
||||
IN UINT64 Arg3,
|
||||
IN UINT64 Arg4,
|
||||
IN UINT64 Arg5,
|
||||
IN UINT64 Arg6,
|
||||
IN UINT64 Arg7,
|
||||
IN UINT64 Arg8
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalStallFunctionId service of Extended SAL Stall Services Class.
|
||||
|
||||
This function is a wrapper for the EsalStallFunctionId service of Extended SAL
|
||||
Stall Services Class. See EsalStallFunctionId of Extended SAL Specification.
|
||||
|
||||
@param Microseconds The number of microseconds to delay.
|
||||
|
||||
@retval EFI_SAL_SUCCESS Call completed without error.
|
||||
@retval EFI_SAL_INVALID_ARGUMENT Invalid argument.
|
||||
@retval EFI_SAL_VIRTUAL_ADDRESS_ERROR Virtual address not registered
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalStall (
|
||||
IN UINTN Microseconds
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalSetNewPalEntryFunctionId service of Extended SAL PAL Services Services Class.
|
||||
|
||||
This function is a wrapper for the EsalSetNewPalEntryFunctionId service of Extended SAL
|
||||
PAL Services Services Class. See EsalSetNewPalEntryFunctionId of Extended SAL Specification.
|
||||
|
||||
@param PhysicalAddress If TRUE, then PalEntryPoint is a physical address.
|
||||
If FALSE, then PalEntryPoint is a virtual address.
|
||||
@param PalEntryPoint The PAL Entry Point being set.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The PAL Entry Point was set.
|
||||
@retval EFI_SAL_VIRTUAL_ADDRESS_ERROR This function was called in virtual mode before
|
||||
virtual mappings for the specified Extended SAL
|
||||
Procedure are available.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalSetNewPalEntry (
|
||||
IN BOOLEAN PhysicalAddress,
|
||||
IN UINT64 PalEntryPoint
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetNewPalEntryFunctionId service of Extended SAL PAL Services Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetNewPalEntryFunctionId service of Extended SAL
|
||||
PAL Services Services Class. See EsalGetNewPalEntryFunctionId of Extended SAL Specification.
|
||||
|
||||
@param PhysicalAddress If TRUE, then PalEntryPoint is a physical address.
|
||||
If FALSE, then PalEntryPoint is a virtual address.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The PAL Entry Point was retrieved and returned in
|
||||
SAL_RETURN_REGS.r9.
|
||||
@retval EFI_SAL_VIRTUAL_ADDRESS_ERROR This function was called in virtual mode before
|
||||
virtual mappings for the specified Extended SAL
|
||||
Procedure are available.
|
||||
@return r9 PAL entry point retrieved.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetNewPalEntry (
|
||||
IN BOOLEAN PhysicalAddress
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetStateBufferFunctionId service of Extended SAL MCA Log Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetStateBufferFunctionId service of Extended SAL
|
||||
MCA Log Services Class. See EsalGetStateBufferFunctionId of Extended SAL Specification.
|
||||
|
||||
@param McaType See type parameter of SAL Procedure SAL_GET_STATE_INFO.
|
||||
@param McaBuffer A pointer to the base address of the returned buffer.
|
||||
Copied from SAL_RETURN_REGS.r9.
|
||||
@param BufferSize A pointer to the size, in bytes, of the returned buffer.
|
||||
Copied from SAL_RETURN_REGS.r10.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The memory buffer to store error records was returned in r9 and r10.
|
||||
@retval EFI_OUT_OF_RESOURCES A memory buffer for string error records in not available
|
||||
@return r9 Base address of the returned buffer
|
||||
@return r10 Size of the returned buffer in bytes
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetStateBuffer (
|
||||
IN UINT64 McaType,
|
||||
OUT UINT8 **McaBuffer,
|
||||
OUT UINTN *BufferSize
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalSaveStateBufferFunctionId service of Extended SAL MCA Log Services Class.
|
||||
|
||||
This function is a wrapper for the EsalSaveStateBufferFunctionId service of Extended SAL
|
||||
MCA Log Services Class. See EsalSaveStateBufferFunctionId of Extended SAL Specification.
|
||||
|
||||
@param McaType See type parameter of SAL Procedure SAL_GET_STATE_INFO.
|
||||
|
||||
@retval EFI_SUCCESS The memory buffer containing the error record was written to nonvolatile storage.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalSaveStateBuffer (
|
||||
IN UINT64 McaType
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetVectorsFunctionId service of Extended SAL Base Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetVectorsFunctionId service of Extended SAL
|
||||
Base Services Class. See EsalGetVectorsFunctionId of Extended SAL Specification.
|
||||
|
||||
@param VectorType The vector type to retrieve.
|
||||
0 - MCA, 1 - BSP INIT, 2 - BOOT_RENDEZ, 3 - AP INIT.
|
||||
|
||||
@retval EFI_SAL_SUCCESS Call completed without error.
|
||||
@retval EFI_SAL_INVALID_ARGUMENT Invalid argument.
|
||||
@retval EFI_SAL_NO_INFORMATION The requested vector has not been registered
|
||||
with the SAL Procedure SAL_SET_VECTORS.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetVectors (
|
||||
IN UINT64 VectorType
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalMcGetParamsFunctionId service of Extended SAL Base Services Class.
|
||||
|
||||
This function is a wrapper for the EsalMcGetParamsFunctionId service of Extended SAL
|
||||
Base Services Class. See EsalMcGetParamsFunctionId of Extended SAL Specification.
|
||||
|
||||
@param ParamInfoType The parameter type to retrieve.
|
||||
1 - rendezvous interrupt
|
||||
2 - wake up
|
||||
3 - Corrected Platform Error Vector.
|
||||
|
||||
@retval EFI_SAL_SUCCESS Call completed without error.
|
||||
@retval EFI_SAL_INVALID_ARGUMENT Invalid argument.
|
||||
@retval EFI_SAL_NO_INFORMATION The requested vector has not been registered
|
||||
with the SAL Procedure SAL_MC_SET_PARAMS.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalMcGetParams (
|
||||
IN UINT64 ParamInfoType
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalMcGetParamsFunctionId service of Extended SAL Base Services Class.
|
||||
|
||||
This function is a wrapper for the EsalMcGetParamsFunctionId service of Extended SAL
|
||||
Base Services Class. See EsalMcGetParamsFunctionId of Extended SAL Specification.
|
||||
|
||||
@retval EFI_SAL_SUCCESS Call completed without error.
|
||||
@retval EFI_SAL_NO_INFORMATION The requested vector has not been registered
|
||||
with the SAL Procedure SAL_MC_SET_PARAMS.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalMcGetMcParams (
|
||||
VOID
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetMcCheckinFlagsFunctionId service of Extended SAL Base Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetMcCheckinFlagsFunctionId service of Extended SAL
|
||||
Base Services Class. See EsalGetMcCheckinFlagsFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuIndex The index of the CPU of set of enabled CPUs to check.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The checkin status of the requested CPU was returned.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetMcCheckinFlags (
|
||||
IN UINT64 CpuIndex
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalAddCpuDataFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalAddCpuDataFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalAddCpuDataFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU being added.
|
||||
@param Enabled The enable flag for the CPU being added.
|
||||
TRUE means the CPU is enabled.
|
||||
FALSE means the CPU is disabled.
|
||||
@param PalCompatibility The PAL Compatibility value for the CPU being added.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The CPU was added to the database.
|
||||
@retval EFI_SAL_NOT_ENOUGH_SCRATCH There are not enough resource available to add the CPU.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalAddCpuData (
|
||||
IN UINT64 CpuGlobalId,
|
||||
IN BOOLEAN Enabled,
|
||||
IN UINT64 PalCompatibility
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalRemoveCpuDataFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalRemoveCpuDataFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalRemoveCpuDataFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU being removed.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The CPU was removed from the database.
|
||||
@retval EFI_SAL_NO_INFORMATION The specified CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalRemoveCpuData (
|
||||
IN UINT64 CpuGlobalId
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalModifyCpuDataFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalModifyCpuDataFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalModifyCpuDataFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU being modified.
|
||||
@param Enabled The enable flag for the CPU being modified.
|
||||
TRUE means the CPU is enabled.
|
||||
FALSE means the CPU is disabled.
|
||||
@param PalCompatibility The PAL Compatibility value for the CPU being modified.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The CPU database was updated.
|
||||
@retval EFI_SAL_NO_INFORMATION The specified CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalModifyCpuData (
|
||||
IN UINT64 CpuGlobalId,
|
||||
IN BOOLEAN Enabled,
|
||||
IN UINT64 PalCompatibility
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetCpuDataByIdFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetCpuDataByIdFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalGetCpuDataByIdFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU being looked up.
|
||||
@param IndexByEnabledCpu If TRUE, then the index of set of enabled CPUs of database is returned.
|
||||
If FALSE, then the index of set of all CPUs of database is returned.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The information on the specified CPU was returned.
|
||||
@retval EFI_SAL_NO_INFORMATION The specified CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetCpuDataById (
|
||||
IN UINT64 CpuGlobalId,
|
||||
IN BOOLEAN IndexByEnabledCpu
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetCpuDataByIndexFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetCpuDataByIndexFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalGetCpuDataByIndexFunctionId of Extended SAL Specification.
|
||||
|
||||
@param Index The Global ID for the CPU being modified.
|
||||
@param IndexByEnabledCpu If TRUE, then the index of set of enabled CPUs of database is returned.
|
||||
If FALSE, then the index of set of all CPUs of database is returned.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The information on the specified CPU was returned.
|
||||
@retval EFI_SAL_NO_INFORMATION The specified CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetCpuDataByIndex (
|
||||
IN UINT64 Index,
|
||||
IN BOOLEAN IndexByEnabledCpu
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalWhoAmIFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalWhoAmIFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalWhoAmIFunctionId of Extended SAL Specification.
|
||||
|
||||
@param IndexByEnabledCpu If TRUE, then the index of set of enabled CPUs of database is returned.
|
||||
If FALSE, then the index of set of all CPUs of database is returned.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The Global ID for the calling CPU was returned.
|
||||
@retval EFI_SAL_NO_INFORMATION The calling CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalWhoAmI (
|
||||
IN BOOLEAN IndexByEnabledCpu
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalNumProcessors service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalNumProcessors service of Extended SAL
|
||||
MP Services Class. See EsalNumProcessors of Extended SAL Specification.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The information on the number of CPUs in the platform
|
||||
was returned.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalNumProcessors (
|
||||
VOID
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalSetMinStateFnctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalSetMinStateFnctionId service of Extended SAL
|
||||
MP Services Class. See EsalSetMinStateFnctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU whose MINSTATE pointer is being set.
|
||||
@param MinStatePointer The physical address of the MINSTATE buffer for the CPU
|
||||
specified by CpuGlobalId.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The MINSTATE pointer was set for the specified CPU.
|
||||
@retval EFI_SAL_NO_INFORMATION The specified CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalSetMinState (
|
||||
IN UINT64 CpuGlobalId,
|
||||
IN EFI_PHYSICAL_ADDRESS MinStatePointer
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalGetMinStateFunctionId service of Extended SAL MP Services Class.
|
||||
|
||||
This function is a wrapper for the EsalGetMinStateFunctionId service of Extended SAL
|
||||
MP Services Class. See EsalGetMinStateFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU whose MINSTATE pointer is being retrieved.
|
||||
|
||||
@retval EFI_SAL_SUCCESS The MINSTATE pointer for the specified CPU was retrieved.
|
||||
@retval EFI_SAL_NO_INFORMATION The specified CPU is not in the database.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalGetMinState (
|
||||
IN UINT64 CpuGlobalId
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalMcsGetStateInfoFunctionId service of Extended SAL MCA Services Class.
|
||||
|
||||
This function is a wrapper for the EsalMcsGetStateInfoFunctionId service of Extended SAL
|
||||
MCA Services Class. See EsalMcsGetStateInfoFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU whose MCA state buffer is being retrieved.
|
||||
@param StateBufferPointer A pointer to the returned MCA state buffer.
|
||||
@param RequiredStateBufferSize A pointer to the size, in bytes, of the returned MCA state buffer.
|
||||
|
||||
@retval EFI_SUCCESS MINSTATE successfully got and size calculated.
|
||||
@retval EFI_SAL_NO_INFORMATION Fail to get MINSTATE.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalMcaGetStateInfo (
|
||||
IN UINT64 CpuGlobalId,
|
||||
OUT EFI_PHYSICAL_ADDRESS *StateBufferPointer,
|
||||
OUT UINT64 *RequiredStateBufferSize
|
||||
);
|
||||
|
||||
/**
|
||||
Wrapper for the EsalMcaRegisterCpuFunctionId service of Extended SAL MCA Services Class.
|
||||
|
||||
This function is a wrapper for the EsalMcaRegisterCpuFunctionId service of Extended SAL
|
||||
MCA Services Class. See EsalMcaRegisterCpuFunctionId of Extended SAL Specification.
|
||||
|
||||
@param CpuGlobalId The Global ID for the CPU whose MCA state buffer is being set.
|
||||
@param StateBufferPointer A pointer to the MCA state buffer.
|
||||
|
||||
@retval EFI_SAL_NO_INFORMATION Cannot get the processor info with the CpuId
|
||||
@retval EFI_SUCCESS Save the processor's state info successfully
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
EsalMcaRegisterCpu (
|
||||
IN UINT64 CpuGlobalId,
|
||||
IN EFI_PHYSICAL_ADDRESS StateBufferPointer
|
||||
);
|
||||
|
||||
#endif
|
@@ -1,57 +0,0 @@
|
||||
/** @file
|
||||
Provides library services to make PAL Calls.
|
||||
|
||||
The PAL Library provides a service to make a PAL CALL. This service is identical
|
||||
in functionality to AsmPalCall() in the functions of the Base Library specific to Intel Itanium architecture.
|
||||
The only difference is that the PAL Entry Point is not passed in. Implementations
|
||||
of this library class must manage PAL Entry Point on their own. For example, a PEI
|
||||
implementation can use a PPI to lookup the PAL Entry Point, and a DXE implementation
|
||||
can contain a constructor to look up the PAL Entry Point from a HOB. This library class
|
||||
is only available on Intel Itanium-based platforms.
|
||||
|
||||
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
|
||||
**/
|
||||
|
||||
#ifndef __PAL_CALL_LIB_H__
|
||||
#define __PAL_CALL_LIB_H__
|
||||
|
||||
#include <IndustryStandard/Pal.h>
|
||||
|
||||
/**
|
||||
Makes a PAL procedure call.
|
||||
|
||||
This is a wrapper function to make a PAL procedure call. Based on the Index value,
|
||||
this API will make static or stacked PAL call. Architected procedures may be designated
|
||||
as required or optional. If a PAL procedure is specified as optional, a unique return
|
||||
code of 0xFFFFFFFFFFFFFFFF is returned in the Status field of the PAL_CALL_RETURN structure.
|
||||
This indicates that the procedure is not present in this PAL implementation. It is the
|
||||
caller's responsibility to check for this return code after calling any optional PAL
|
||||
procedure. No parameter checking is performed on the 4 input parameters, but there are
|
||||
some common rules that the caller should follow when making a PAL call. Any address
|
||||
passed to PAL as buffers for return parameters must be 8-byte aligned. Unaligned addresses
|
||||
may cause undefined results. For those parameters defined as reserved or some fields
|
||||
defined as reserved must be zero filled or the invalid argument return value may be
|
||||
returned or undefined result may occur during the execution of the procedure.
|
||||
This function is only available on Intel Itanium-based platforms.
|
||||
|
||||
@param Index The PAL procedure Index number.
|
||||
@param Arg2 The 2nd parameter for PAL procedure calls.
|
||||
@param Arg3 The 3rd parameter for PAL procedure calls.
|
||||
@param Arg4 The 4th parameter for PAL procedure calls.
|
||||
|
||||
@return Structure returned from the PAL Call procedure, including the status and return value.
|
||||
|
||||
**/
|
||||
PAL_CALL_RETURN
|
||||
EFIAPI
|
||||
PalCall (
|
||||
IN UINT64 Index,
|
||||
IN UINT64 Arg2,
|
||||
IN UINT64 Arg3,
|
||||
IN UINT64 Arg4
|
||||
);
|
||||
|
||||
#endif
|
||||
|
@@ -1,53 +0,0 @@
|
||||
/** @file
|
||||
Provides library services to make SAL Calls.
|
||||
|
||||
Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
|
||||
SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
|
||||
**/
|
||||
|
||||
#ifndef __SAL_LIB__
|
||||
#define __SAL_LIB__
|
||||
|
||||
#include <IndustryStandard/Sal.h>
|
||||
|
||||
/**
|
||||
Makes a SAL procedure call.
|
||||
|
||||
This is a wrapper function to make a SAL procedure call.
|
||||
No parameter checking is performed on the 8 input parameters,
|
||||
but there are some common rules that the caller should follow
|
||||
when making a SAL call. Any address passed to SAL as buffers
|
||||
for return parameters must be 8-byte aligned. Unaligned
|
||||
addresses may cause undefined results. For those parameters
|
||||
defined as reserved or some fields defined as reserved must be
|
||||
zero filled or the invalid argument return value may be returned
|
||||
or undefined result may occur during the execution of the procedure.
|
||||
This function is only available on Intel Itanium-based platforms.
|
||||
|
||||
@param Index The SAL procedure Index number
|
||||
@param Arg2 The 2nd parameter for SAL procedure calls
|
||||
@param Arg3 The 3rd parameter for SAL procedure calls
|
||||
@param Arg4 The 4th parameter for SAL procedure calls
|
||||
@param Arg5 The 5th parameter for SAL procedure calls
|
||||
@param Arg6 The 6th parameter for SAL procedure calls
|
||||
@param Arg7 The 7th parameter for SAL procedure calls
|
||||
@param Arg8 The 8th parameter for SAL procedure calls
|
||||
|
||||
@return SAL returned registers.
|
||||
|
||||
**/
|
||||
SAL_RETURN_REGS
|
||||
EFIAPI
|
||||
SalCall (
|
||||
IN UINT64 Index,
|
||||
IN UINT64 Arg2,
|
||||
IN UINT64 Arg3,
|
||||
IN UINT64 Arg4,
|
||||
IN UINT64 Arg5,
|
||||
IN UINT64 Arg6,
|
||||
IN UINT64 Arg7,
|
||||
IN UINT64 Arg8
|
||||
);
|
||||
|
||||
#endif
|
Reference in New Issue
Block a user