/** @file\r
This library implements the Extended SAL Library Class for use in boot services and runtime.\r
\r
- Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
/**\r
Constructor function to initializes physical plabel of ESAL entrypoint and register an event\r
for initialization of virtual plabel of ESAL entrypoint.\r
- \r
+\r
This is the library constructor function to call a function to initialize physical plabel of ESAL entrypoint\r
- and to register notification function for \r
+ and to register notification function for\r
EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE, which sets virtual plabel of ESAL entrypoint.\r
\r
@param ImageHandle The firmware allocated handle for the EFI image.\r
}\r
\r
/**\r
- Destructor function to close the event created by the library constructor \r
- \r
- This is the library destructor function to close the event with type of \r
+ Destructor function to close the event created by the library constructor\r
+\r
+ This is the library destructor function to close the event with type of\r
EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE, which is created by the library constructor.\r
\r
@param ImageHandle The firmware allocated handle for the EFI image.\r
\r
/**\r
Registers function of ESAL class and it's associated global.\r
- \r
+\r
This function registers function of ESAL class, together with its associated global.\r
It is worker function for RegisterEsalClass().\r
It is only for boot time.\r
\r
/**\r
Registers ESAL Class and it's associated global.\r
- \r
+\r
This function registers one or more Extended SAL services in a given\r
class along with the associated global context.\r
This function is only available prior to ExitBootServices().\r
@retval EFI_SUCCESS The Extended SAL services were registered.\r
@retval EFI_UNSUPPORTED This function was called after ExitBootServices().\r
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to register one or more of the specified services.\r
- @retval Other ClassGuid could not be installed onto a new handle. \r
+ @retval Other ClassGuid could not be installed onto a new handle.\r
\r
**/\r
EFI_STATUS\r
\r
/**\r
Calls an Extended SAL Class service that was previously registered with RegisterEsalClass().\r
- \r
+\r
This function gets the entrypoint of Extended SAL, and calls an Extended SAL Class service\r
that was previously registered with RegisterEsalClass() through this entrypoint.\r
\r
@param Arg6 Argument 6 ClassGuid/FunctionId defined\r
@param Arg7 Argument 7 ClassGuid/FunctionId defined\r
@param Arg8 Argument 8 ClassGuid/FunctionId defined\r
- \r
+\r
@retval EFI_SAL_SUCCESS ESAL procedure successfully called.\r
@retval EFI_SAL_ERROR The address of ExtendedSalProc() can not be correctly\r
initialized.\r
@retval Other Status returned from ExtendedSalProc() service of\r
- EXTENDED_SAL_BOOT_SERVICE_PROTOCOL. \r
+ EXTENDED_SAL_BOOT_SERVICE_PROTOCOL.\r
\r
**/\r
SAL_RETURN_REGS\r
\r
/**\r
Wrapper for the EsalStallFunctionId service of Extended SAL Stall Services Class.\r
- \r
+\r
This function is a wrapper for the EsalStallFunctionId service of Extended SAL\r
Stall Services Class. See EsalStallFunctionId of Extended SAL Specification.\r
\r
)\r
{\r
return EsalCall (\r
- EFI_EXTENDED_SAL_STALL_SERVICES_PROTOCOL_GUID_LO, \r
- EFI_EXTENDED_SAL_STALL_SERVICES_PROTOCOL_GUID_HI, \r
- StallFunctionId, \r
- Microseconds, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EFI_EXTENDED_SAL_STALL_SERVICES_PROTOCOL_GUID_LO,\r
+ EFI_EXTENDED_SAL_STALL_SERVICES_PROTOCOL_GUID_HI,\r
+ StallFunctionId,\r
+ Microseconds,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalSetNewPalEntryFunctionId service of Extended SAL PAL Services Services Class.\r
- \r
+\r
This function is a wrapper for the EsalSetNewPalEntryFunctionId service of Extended SAL\r
PAL Services Services Class. See EsalSetNewPalEntryFunctionId of Extended SAL Specification.\r
\r
)\r
{\r
return EsalCall (\r
- EFI_EXTENDED_SAL_PAL_SERVICES_PROTOCOL_GUID_LO, \r
+ EFI_EXTENDED_SAL_PAL_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_PAL_SERVICES_PROTOCOL_GUID_HI,\r
- SetNewPalEntryFunctionId, \r
- PhysicalAddress, \r
- PalEntryPoint, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ SetNewPalEntryFunctionId,\r
+ PhysicalAddress,\r
+ PalEntryPoint,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetNewPalEntryFunctionId service of Extended SAL PAL Services Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetNewPalEntryFunctionId service of Extended SAL\r
PAL Services Services Class. See EsalGetNewPalEntryFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_PAL_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_PAL_SERVICES_PROTOCOL_GUID_HI,\r
- GetNewPalEntryFunctionId, \r
- PhysicalAddress, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ GetNewPalEntryFunctionId,\r
+ PhysicalAddress,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetStateBufferFunctionId service of Extended SAL MCA Log Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetStateBufferFunctionId service of Extended SAL\r
MCA Log Services Class. See EsalGetStateBufferFunctionId of Extended SAL Specification.\r
\r
Regs = EsalCall (\r
EFI_EXTENDED_SAL_MCA_LOG_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MCA_LOG_SERVICES_PROTOCOL_GUID_HI,\r
- EsalGetStateBufferFunctionId, \r
- McaType, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EsalGetStateBufferFunctionId,\r
+ McaType,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
\r
\r
/**\r
Wrapper for the EsalSaveStateBufferFunctionId service of Extended SAL MCA Log Services Class.\r
- \r
+\r
This function is a wrapper for the EsalSaveStateBufferFunctionId service of Extended SAL\r
MCA Log Services Class. See EsalSaveStateBufferFunctionId of Extended SAL Specification.\r
- \r
+\r
@param McaType See type parameter of SAL Procedure SAL_GET_STATE_INFO.\r
\r
@retval EFI_SUCCESS The memory buffer containing the error record was written to nonvolatile storage.\r
return EsalCall (\r
EFI_EXTENDED_SAL_MCA_LOG_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MCA_LOG_SERVICES_PROTOCOL_GUID_HI,\r
- EsalSaveStateBufferFunctionId, \r
- McaType, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EsalSaveStateBufferFunctionId,\r
+ McaType,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetVectorsFunctionId service of Extended SAL Base Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetVectorsFunctionId service of Extended SAL\r
Base Services Class. See EsalGetVectorsFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_HI,\r
- EsalGetVectorsFunctionId, \r
- VectorType, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EsalGetVectorsFunctionId,\r
+ VectorType,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalMcGetParamsFunctionId service of Extended SAL Base Services Class.\r
- \r
+\r
This function is a wrapper for the EsalMcGetParamsFunctionId service of Extended SAL\r
Base Services Class. See EsalMcGetParamsFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_HI,\r
- EsalMcGetParamsFunctionId, \r
- ParamInfoType, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EsalMcGetParamsFunctionId,\r
+ ParamInfoType,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalMcGetParamsFunctionId service of Extended SAL Base Services Class.\r
- \r
+\r
This function is a wrapper for the EsalMcGetParamsFunctionId service of Extended SAL\r
Base Services Class. See EsalMcGetParamsFunctionId of Extended SAL Specification.\r
- \r
+\r
@retval EFI_SAL_SUCCESS Call completed without error.\r
@retval EFI_SAL_NO_INFORMATION The requested vector has not been registered\r
with the SAL Procedure SAL_MC_SET_PARAMS.\r
return EsalCall (\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_HI,\r
- EsalMcGetMcParamsFunctionId, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EsalMcGetMcParamsFunctionId,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetMcCheckinFlagsFunctionId service of Extended SAL Base Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetMcCheckinFlagsFunctionId service of Extended SAL\r
Base Services Class. See EsalGetMcCheckinFlagsFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_BASE_SERVICES_PROTOCOL_GUID_HI,\r
- EsalGetMcCheckinFlagsFunctionId, \r
- CpuIndex, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ EsalGetMcCheckinFlagsFunctionId,\r
+ CpuIndex,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalAddCpuDataFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalAddCpuDataFunctionId service of Extended SAL\r
MP Services Class. See EsalAddCpuDataFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- AddCpuDataFunctionId, \r
- CpuGlobalId, \r
- Enabled, \r
- PalCompatibility, \r
- 0, \r
- 0, \r
- 0, \r
+ AddCpuDataFunctionId,\r
+ CpuGlobalId,\r
+ Enabled,\r
+ PalCompatibility,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalRemoveCpuDataFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalRemoveCpuDataFunctionId service of Extended SAL\r
MP Services Class. See EsalRemoveCpuDataFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- RemoveCpuDataFunctionId, \r
- CpuGlobalId, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ RemoveCpuDataFunctionId,\r
+ CpuGlobalId,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalModifyCpuDataFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalModifyCpuDataFunctionId service of Extended SAL\r
MP Services Class. See EsalModifyCpuDataFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- ModifyCpuDataFunctionId, \r
- CpuGlobalId, \r
- Enabled, \r
- PalCompatibility, \r
- 0, \r
- 0, \r
- 0, \r
+ ModifyCpuDataFunctionId,\r
+ CpuGlobalId,\r
+ Enabled,\r
+ PalCompatibility,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetCpuDataByIdFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetCpuDataByIdFunctionId service of Extended SAL\r
MP Services Class. See EsalGetCpuDataByIdFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- GetCpuDataByIDFunctionId, \r
- CpuGlobalId, \r
- IndexByEnabledCpu, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ GetCpuDataByIDFunctionId,\r
+ CpuGlobalId,\r
+ IndexByEnabledCpu,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetCpuDataByIndexFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetCpuDataByIndexFunctionId service of Extended SAL\r
MP Services Class. See EsalGetCpuDataByIndexFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- GetCpuDataByIndexFunctionId, \r
- Index, \r
- IndexByEnabledCpu, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ GetCpuDataByIndexFunctionId,\r
+ Index,\r
+ IndexByEnabledCpu,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalWhoAmIFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalWhoAmIFunctionId service of Extended SAL\r
MP Services Class. See EsalWhoAmIFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- CurrentProcInfoFunctionId, \r
- IndexByEnabledCpu, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ CurrentProcInfoFunctionId,\r
+ IndexByEnabledCpu,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalNumProcessors service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalNumProcessors service of Extended SAL\r
MP Services Class. See EsalNumProcessors of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- NumProcessorsFunctionId, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ NumProcessorsFunctionId,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalSetMinStateFnctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalSetMinStateFnctionId service of Extended SAL\r
MP Services Class. See EsalSetMinStateFnctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- SetMinStateFunctionId, \r
- CpuGlobalId, \r
- MinStatePointer, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ SetMinStateFunctionId,\r
+ CpuGlobalId,\r
+ MinStatePointer,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalGetMinStateFunctionId service of Extended SAL MP Services Class.\r
- \r
+\r
This function is a wrapper for the EsalGetMinStateFunctionId service of Extended SAL\r
MP Services Class. See EsalGetMinStateFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MP_SERVICES_PROTOCOL_GUID_HI,\r
- GetMinStateFunctionId, \r
- CpuGlobalId, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ GetMinStateFunctionId,\r
+ CpuGlobalId,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
\r
/**\r
Wrapper for the EsalMcsGetStateInfoFunctionId service of Extended SAL MCA Services Class.\r
- \r
+\r
This function is a wrapper for the EsalMcsGetStateInfoFunctionId service of Extended SAL\r
MCA Services Class. See EsalMcsGetStateInfoFunctionId of Extended SAL Specification.\r
\r
Regs = EsalCall (\r
EFI_EXTENDED_SAL_MCA_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MCA_SERVICES_PROTOCOL_GUID_HI,\r
- McaGetStateInfoFunctionId, \r
- CpuGlobalId, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ McaGetStateInfoFunctionId,\r
+ CpuGlobalId,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
\r
\r
/**\r
Wrapper for the EsalMcaRegisterCpuFunctionId service of Extended SAL MCA Services Class.\r
- \r
+\r
This function is a wrapper for the EsalMcaRegisterCpuFunctionId service of Extended SAL\r
MCA Services Class. See EsalMcaRegisterCpuFunctionId of Extended SAL Specification.\r
\r
return EsalCall (\r
EFI_EXTENDED_SAL_MCA_SERVICES_PROTOCOL_GUID_LO,\r
EFI_EXTENDED_SAL_MCA_SERVICES_PROTOCOL_GUID_HI,\r
- McaRegisterCpuFunctionId, \r
- CpuGlobalId, \r
- StateBufferPointer, \r
- 0, \r
- 0, \r
- 0, \r
- 0, \r
+ McaRegisterCpuFunctionId,\r
+ CpuGlobalId,\r
+ StateBufferPointer,\r
+ 0,\r
+ 0,\r
+ 0,\r
+ 0,\r
0\r
);\r
}\r
projects / mirror_edk2.git / blobdiff