/** @file\r
The library implements the Extended SAL Library Class for boot service only modules.\r
\r
- Copyright (c) 2007 - 2012, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2007 - 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 get Extended SAL Boot Service Protocol, and initializes\r
physical plabel of ESAL entrypoint.\r
- \r
+\r
This function first locates Extended SAL Boot Service Protocol and caches it in global variable.\r
Then it initializes the physical plable of ESAL entrypoint, and stores\r
it where GetEsalEntryPoint() can easily retrieve.\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
@param ClassGuidHi GUID of function class, upper 64-bits\r
@param ModuleGlobal Module global for the class.\r
@param ... List of Function/FunctionId pairs, ended by NULL\r
- \r
+\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
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
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