<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>UefiDevicePathLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>UefiDevicePathLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiLib</Library>
<Library>UefiDriverEntryPoint</Library>
<Library>DxeReportStatusCodeLib</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library>EdkDxeRuntimeDriverLib</Library>
<Library>UefiDriverModelLib</Library>
<Library>DxeHobLib</Library>
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkScsiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkScsiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>EdkUsbLib</Library>\r
<Library>BaseLib</Library>
<Library>BaseCacheMaintenanceLib</Library>
<Library>DxeReportStatusCodeLib</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library OverrideID="1111">DxeCoreUefiDecompressLibFromHob</Library>
<Library OverrideID="1111">DxeCoreTianoDecompressLibFromHob</Library>
<Library OverrideID="3333">DxeCoreCustomDecompressLibFromHob</Library>
<Library>BaseUefiTianoDecompressLib</Library>
<Library>BaseCustomDecompressLibNull</Library>
<Library>PeiReportStatusCodeLib</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library>BaseLib</Library>
<Library>PeiMemoryAllocationLib</Library>
<Arch ArchType="IA32">
<Library>BaseCacheMaintenanceLib</Library>
<Library>BaseUefiTianoDecompressLib</Library>
<Library>BaseCustomDecompressLibNull</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library>BaseLib</Library>
<Library>PeiMemoryAllocationLib</Library>
<Library>PeiReportStatusCodeLib</Library>
<Library>PeiServicesLib</Library>
<Library>PeiHobLib</Library>
<Library>PeiReportStatusCodeLib</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library>BasePerformanceLibNull</Library>
<Arch ArchType="IA32">
<Library OverrideID="6666">BasePeCoffGetEntryPointLib</Library>
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>HiiLib</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiMemoryLib</Library> \r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>BaseLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>UefiMemoryLib</Library> \r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDevicePathLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDevicePathLib</Library>\r
</Libraries>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>UefiDevicePathLib</Library>\r
</Libraries>\r
</ModuleBuildDescription>\r
<Library>UefiMemoryLib</Library> \r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
</Libraries>\r
</ModuleBuildDescription>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Libraries>\r
<Library>UefiBootServicesTableLib</Library>\r
<Library>BaseMemoryLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>EdkDxeRuntimeDriverLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
</Libraries>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeServicesTableLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library> \r
+ <Library>PeiDxeDebugLibReportStatusCode</Library> \r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Libraries> \r
<Library>PeimEntryPoint</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiMemoryLib</Library>\r
<Library>PeiServicesLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>EdkDxeRuntimeDriverLib</Library>\r
<Arch ArchType="IPF">\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>EdkDxeRuntimeDriverLib</Library>\r
</Libraries>\r
<Library>PeiServicesLib</Library>\r
<Library OverrideID="4444">PeiServicesTablePointerLib</Library>\r
<Library>PeiHobLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>PeiMemoryLib</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
<Library>PeiMemoryAllocationLib</Library>\r
<Library>BaseMemoryLib</Library>\r
<Library>EdkDxeRuntimeDriverLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
<Arch ArchType="IPF">\r
<Library>EdkDxeSalLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
</Libraries>\r
</ModuleBuildDescription>\r
<Library>UefiDriverEntryPoint</Library>
<Library>UefiLib</Library>
<Library>BasePrintLib</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library>DxeIoLibCpuIo</Library>
<Library>BaseMemoryLib</Library>
<Library>DxeReportStatusCodeLib</Library>
<Library>UefiRuntimeServicesTableLib</Library>\r
<Library>BaseLib</Library>\r
<Library>BaseMemoryLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BasePrintLib</Library>\r
<Library>EdkGraphicsLib</Library>\r
<Library>EdkIfrSupportLib</Library>\r
<Library>UefiRuntimeServicesTableLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>UefiMemoryLib</Library>\r
<Library>BasePrintLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
</MbdHeader>
<Libraries>
<Library>PeiReportStatusCodeLib</Library>
- <Library>BaseDebugLibReportStatusCode</Library>
+ <Library>PeiDxeDebugLibReportStatusCode</Library>
<Library>BaseLib</Library>
<Library>PeiMemoryLib</Library>
<Library>PeiServicesLib</Library>
<Libraries>\r
<Library>UefiBootServicesTableLib</Library>\r
<Library>BaseMemoryLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>EdkDxeRuntimeDriverLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
<Library>DxeServicesTableLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxeRuntimeDriverLib</Library>\r
<Library>DxeHobLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkDxePrintLib</Library>\r
<Library>BaseLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDevicePathLib</Library>\r
</Libraries>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeServicesTableLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>EdkGenericBdsLib</Library>\r
<Library>BasePrintLib</Library>\r
<Library>EdkGraphicsLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>UefiDriverModelLib</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxePcdLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
<Library>UefiDevicePathLib</Library>\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeWinNtLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeWinNtLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
</MbdHeader>\r
<Libraries>\r
<Library>UefiBootServicesTableLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeHobLib</Library>\r
<Library>BaseLib</Library>\r
<Library>UefiLib</Library>\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>UefiMemoryLib</Library>\r
<Library>UefiDriverEntryPoint</Library>\r
<Library>DxeReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>DxeWinNtLib</Library>\r
<Library>DxeMemoryAllocationLib</Library>\r
</Libraries>\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiHobLib</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>PeiServicesLib</Library>\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiHobLib</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiHobLib</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
</MbdHeader>\r
<Libraries>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
<Library>PeiMemoryLib</Library>\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiServicesTablePointerLib</Library>\r
<Library>PeiHobLib</Library>\r
<Library>PeiReportStatusCodeLib</Library>\r
- <Library>BaseDebugLibReportStatusCode</Library>\r
+ <Library>PeiDxeDebugLibReportStatusCode</Library>\r
<Library>BaseLib</Library>\r
</Libraries>\r
<BuildOptions ToolChain="MSFT">\r
/** @file\r
- Memory-only library functions with no library constructor/destructor\r
+ Memory-only library functions with no library constructor/destructor\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: BaseLib.h\r
+ Module Name: BaseLib.h\r
\r
**/\r
\r
If Node is not a node in List and Node is not equal to List, then ASSERT().\r
\r
@param List A pointer to the head node of a doubly linked list.\r
- @param Node A pointer to a node in the doubly linked list.\r
+ @param Node A pointer to a node in the doubly linked list.\r
\r
@retval TRUE Node is one of the nodes in the doubly linked list.\r
@retval FALSE Node is not one of the nodes in the doubly linked list.\r
If Node is not a node in List, then ASSERT().\r
\r
@param List A pointer to the head node of a doubly linked list.\r
- @param Node A pointer to a node in the doubly linked list.\r
+ @param Node A pointer to a node in the doubly linked list.\r
\r
@retval TRUE Node is the last node in the linked list.\r
@retval FALSE Node is not the last node in the linked list.\r
/** @file\r
- Memory-only library functions with no library constructor/destructor\r
+ Memory-only library functions with no library constructor/destructor\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: BaseMemoryLib.h\r
+ Module Name: BaseMemoryLib.h\r
\r
**/\r
\r
#define __BASE_MEMORY_LIB__\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
);\r
\r
/**\r
- Set Buffer to Value for Size bytes.\r
+ Fills a target buffer with a byte value, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with Value, and returns Buffer.\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
-\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
- @param Value Value of the set operation.\r
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
);\r
\r
/**\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
);\r
\r
/**\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
);\r
\r
/**\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
);\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
-\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- OUT VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
);\r
\r
/**\r
- Compares two memory buffers of a given length.\r
+ Compares the contents of two buffers.\r
\r
- This function compares Length bytes of SourceBuffer to Length bytes of\r
- DestinationBuffer. If all Length bytes of the two buffers are identical, then\r
- 0 is returned. Otherwise, the value returned is the first mismatched byte in\r
- SourceBuffer subtracted from the first mismatched byte in DestinationBuffer.\r
+ This function compares Length bytes of SourceBuffer to Length bytes of DestinationBuffer.\r
+ If all Length bytes of the two buffers are identical, then 0 is returned. Otherwise, the\r
+ value returned is the first mismatched byte in SourceBuffer subtracted from the first\r
+ mismatched byte in DestinationBuffer.\r
+ If Length > 0 and DestinationBuffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and SourceBuffer is NULL and Length > 0, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If DestinationBuffer is NULL and Length > 0, then ASSERT().\r
- If SourceBuffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
\r
- @param DestinationBuffer First memory buffer\r
- @param SourceBuffer Second memory buffer\r
- @param Length Length of DestinationBuffer and SourceBuffer memory\r
- regions to compare\r
+ @param DestinationBuffer Pointer to the destination buffer to compare.\r
+ @param SourceBuffer Pointer to the source buffer to compare.\r
+ @param Length Number of bytes to compare.\r
\r
- @retval 0 if DestinationBuffer == SourceBuffer\r
- @retval Non-zero if DestinationBuffer != SourceBuffer\r
+ @return 0 All Length bytes of the two buffers are identical.\r
+ @retval Non-zero The first mismatched byte in SourceBuffer subtracted from the first\r
+ mismatched byte in DestinationBuffer.\r
\r
**/\r
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
);\r
\r
/**\r
- Scans a target buffer for an 8-bit value, and returns a pointer to the\r
- matching 8-bit value in the target buffer.\r
+ Scans a target buffer for an 8-bit value, and returns a pointer to the matching 8-bit value\r
+ in the target buffer.\r
\r
- This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address for an 8-bit value that matches\r
- Value. If a match is found, then a pointer to the matching byte in the target\r
- buffer is returned. If no match is found, then NULL is returned. If Length is\r
- 0, then NULL is returned.\r
+ This function searches target the buffer specified by Buffer and Length from the lowest\r
+ address to the highest address for an 8-bit value that matches Value. If a match is found,\r
+ then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
+ then NULL is returned. If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to scan.\r
+ @param Length Number of bytes in Buffer to scan.\r
+ @param Value Value to search for in the target buffer.\r
\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
-\r
- @return Pointer to the first occurrence or NULL if not found.\r
- @retval NULL if Length == 0 or Value was not found.\r
+ @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
\r
**/\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
);\r
\r
/**\r
- Scans a target buffer for a 16-bit value, and returns a pointer to the\r
- matching 16-bit value in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 16-bit increments for a 16-bit\r
- value that matches Value. If a match is found, then a pointer to the matching\r
- value in the target buffer is returned. If no match is found, then NULL is\r
- returned. If Length is 0, then NULL is returned.\r
+ Scans a target buffer for a 16-bit value, and returns a pointer to the matching 16-bit value\r
+ in the target buffer.\r
\r
- If Buffer is NULL, then ASSERT().\r
+ This function searches target the buffer specified by Buffer and Length from the lowest\r
+ address to the highest address for a 16-bit value that matches Value. If a match is found,\r
+ then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
+ then NULL is returned. If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
+ @param Buffer Pointer to the target buffer to scan.\r
+ @param Length Number of bytes in Buffer to scan.\r
+ @param Value Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Value was not found.\r
+ @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
\r
**/\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
);\r
\r
/**\r
- Scans a target buffer for a 32-bit value, and returns a pointer to the\r
- matching 32-bit value in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 32-bit increments for a 32-bit\r
- value that matches Value. If a match is found, then a pointer to the matching\r
- value in the target buffer is returned. If no match is found, then NULL is\r
- returned. If Length is 0, then NULL is returned.\r
+ Scans a target buffer for a 32-bit value, and returns a pointer to the matching 32-bit value\r
+ in the target buffer.\r
\r
- If Buffer is NULL, then ASSERT().\r
+ This function searches target the buffer specified by Buffer and Length from the lowest\r
+ address to the highest address for a 32-bit value that matches Value. If a match is found,\r
+ then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
+ then NULL is returned. If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
+ @param Buffer Pointer to the target buffer to scan.\r
+ @param Length Number of bytes in Buffer to scan.\r
+ @param Value Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence or NULL if not found.\r
- @retval NULL if Length == 0 or Value was not found.\r
+ @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
\r
**/\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
);\r
\r
/**\r
- Scans a target buffer for a 64-bit value, and returns a pointer to the\r
- matching 64-bit value in the target buffer.\r
-\r
- This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 64-bit increments for a 64-bit\r
- value that matches Value. If a match is found, then a pointer to the matching\r
- value in the target buffer is returned. If no match is found, then NULL is\r
- returned. If Length is 0, then NULL is returned.\r
+ Scans a target buffer for a 64-bit value, and returns a pointer to the matching 64-bit value\r
+ in the target buffer.\r
\r
- If Buffer is NULL, then ASSERT().\r
+ This function searches target the buffer specified by Buffer and Length from the lowest\r
+ address to the highest address for a 64-bit value that matches Value. If a match is found,\r
+ then a pointer to the matching byte in the target buffer is returned. If no match is found,\r
+ then NULL is returned. If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- @param Buffer Pointer to the target buffer to scan.\r
- @param Length Number of bytes in Buffer to scan.\r
- @param Value Value to search for in the target buffer.\r
+ @param Buffer Pointer to the target buffer to scan.\r
+ @param Length Number of bytes in Buffer to scan.\r
+ @param Value Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence or NULL if not found.\r
- @retval NULL if Length == 0 or Value was not found.\r
+ @return A pointer to the matching byte in the target buffer or NULL otherwise.\r
\r
**/\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
);\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
);\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
);\r
\r
/**\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
);\r
\r
#endif\r
/** @file\r
- Cache Maintenance Functions\r
+ Cache Maintenance Functions\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: CacheMaintenanceLib.h\r
+ Module Name: CacheMaintenanceLib.h\r
\r
**/\r
\r
/** @file\r
- Library that provides processor specific library services\r
+ Library that provides processor specific library services\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: CpuLib.h\r
+ Module Name: CpuLib.h\r
\r
**/\r
\r
/** @file\r
- Entry point to a DXE Boot Services Driver\r
+ Entry point to a DXE Boot Services Driver\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: DevicePathLib.h\r
+ Module Name: DevicePathLib.h\r
\r
**/\r
\r
#define __DEVICE_PATH_LIB_H__\r
\r
/**\r
- This function returns the size, in bytes, \r
- of the device path data structure specified by DevicePath.\r
- If DevicePath is NULL, then 0 is returned.\r
+ This function returns the size, in bytes, \r
+ of the device path data structure specified by DevicePath.\r
+ If DevicePath is NULL, then 0 is returned.\r
\r
- @param DevicePath A pointer to a device path data structure.\r
+ @param DevicePath A pointer to a device path data structure.\r
\r
- @return The size of a device path in bytes.\r
+ @return The size of a device path in bytes.\r
\r
**/\r
UINTN\r
;\r
\r
/**\r
- This function allocates space for a new copy of the device path\r
- specified by DevicePath.\r
+ This function allocates space for a new copy of the device path\r
+ specified by DevicePath.\r
\r
- @param DevicePath A pointer to a device path data structure.\r
+ @param DevicePath A pointer to a device path data structure.\r
\r
- @return The duplicated device path.\r
+ @return The duplicated device path.\r
\r
**/\r
EFI_DEVICE_PATH_PROTOCOL *\r
;\r
\r
/**\r
- This function appends the device path SecondDevicePath\r
- to every device path instance in FirstDevicePath. \r
+ This function appends the device path SecondDevicePath\r
+ to every device path instance in FirstDevicePath. \r
\r
- @param FirstDevicePath A pointer to a device path data structure.\r
- \r
- @param SecondDevicePath A pointer to a device path data structure.\r
+ @param FirstDevicePath A pointer to a device path data structure.\r
+ \r
+ @param SecondDevicePath A pointer to a device path data structure.\r
\r
- @return\r
- A pointer to the new device path is returned.\r
- NULL is returned if space for the new device path could not be allocated from pool.\r
- It is up to the caller to free the memory used by FirstDevicePath and SecondDevicePath\r
- if they are no longer needed.\r
+ @return\r
+ A pointer to the new device path is returned.\r
+ NULL is returned if space for the new device path could not be allocated from pool.\r
+ It is up to the caller to free the memory used by FirstDevicePath and SecondDevicePath\r
+ if they are no longer needed.\r
\r
**/\r
EFI_DEVICE_PATH_PROTOCOL *\r
;\r
\r
/**\r
- This function appends the device path instance Instance to the device path Source.\r
- If Source is NULL, then a new device path with one instance is created. \r
+ This function appends the device path instance Instance to the device path Source.\r
+ If Source is NULL, then a new device path with one instance is created. \r
\r
- @param Source A pointer to a device path data structure.\r
- @param Instance A pointer to a device path instance.\r
+ @param Source A pointer to a device path data structure.\r
+ @param Instance A pointer to a device path instance.\r
\r
- @return\r
- A pointer to the new device path.\r
- If there is not enough temporary pool memory available to complete this function,\r
- then NULL is returned.\r
+ @return\r
+ A pointer to the new device path.\r
+ If there is not enough temporary pool memory available to complete this function,\r
+ then NULL is returned.\r
\r
**/\r
EFI_DEVICE_PATH_PROTOCOL *\r
;\r
\r
/**\r
- Function retrieves the next device path instance from a device path data structure.\r
+ Function retrieves the next device path instance from a device path data structure.\r
\r
- @param DevicePath A pointer to a device path data structure.\r
- \r
- @param Size A pointer to the size of a device path instance in bytes.\r
+ @param DevicePath A pointer to a device path data structure.\r
+ \r
+ @param Size A pointer to the size of a device path instance in bytes.\r
\r
- @return\r
- This function returns a pointer to the current device path instance.\r
- In addition, it returns the size in bytes of the current device path instance in Size,\r
- and a pointer to the next device path instance in DevicePath.\r
- If there are no more device path instances in DevicePath, then DevicePath will be set to NULL.\r
+ @return\r
+ This function returns a pointer to the current device path instance.\r
+ In addition, it returns the size in bytes of the current device path instance in Size,\r
+ and a pointer to the next device path instance in DevicePath.\r
+ If there are no more device path instances in DevicePath, then DevicePath will be set to NULL.\r
\r
**/\r
EFI_DEVICE_PATH_PROTOCOL *\r
;\r
\r
/**\r
- Return TRUE is this is a multi instance device path.\r
+ Return TRUE is this is a multi instance device path.\r
\r
- @param DevicePath A pointer to a device path data structure.\r
+ @param DevicePath A pointer to a device path data structure.\r
\r
- @retval TRUE If DevicePath is multi-instance.\r
- @retval FALSE If DevicePath is not multi-instance or DevicePath is NULL.\r
+ @retval TRUE If DevicePath is multi-instance.\r
+ @retval FALSE If DevicePath is not multi-instance or DevicePath is NULL.\r
\r
**/\r
BOOLEAN\r
;\r
\r
/**\r
- This function retrieves the device path protocol from a handle.\r
+ This function retrieves the device path protocol from a handle.\r
\r
- @param Handle The handle from which to retrieve the device path protocol.\r
+ @param Handle The handle from which to retrieve the device path protocol.\r
\r
- @return\r
- This function returns the device path protocol from the handle specified by Handle.\r
- If Handle is NULL or Handle does not contain a device path protocol, then NULL is returned.\r
+ @return\r
+ This function returns the device path protocol from the handle specified by Handle.\r
+ If Handle is NULL or Handle does not contain a device path protocol, then NULL is returned.\r
\r
**/\r
EFI_DEVICE_PATH_PROTOCOL *\r
;\r
\r
/**\r
- This function allocates a device path for a file and appends it to an existing device path.\r
-\r
- @param Device A pointer to a device handle. This parameter is optional and may be NULL.\r
- @param FileName A pointer to a Null-terminated Unicode string.\r
-\r
- @return\r
- If Device is a valid device handle that contains a device path protocol,\r
- then a device path for the file specified by FileName is allocated\r
- and appended to the device path associated with the handle Device. The allocated device path is returned.\r
- If Device is NULL or Device is a handle that does not support the device path protocol,\r
- then a device path containing a single device path node for the file specified by FileName\r
- is allocated and returned.\r
+ This function allocates a device path for a file and appends it to an existing device path.\r
+\r
+ @param Device A pointer to a device handle. This parameter is optional and may be NULL.\r
+ @param FileName A pointer to a Null-terminated Unicode string.\r
+\r
+ @return\r
+ If Device is a valid device handle that contains a device path protocol,\r
+ then a device path for the file specified by FileName is allocated\r
+ and appended to the device path associated with the handle Device. The allocated device path is returned.\r
+ If Device is NULL or Device is a handle that does not support the device path protocol,\r
+ then a device path containing a single device path node for the file specified by FileName\r
+ is allocated and returned.\r
\r
**/\r
EFI_DEVICE_PATH_PROTOCOL *\r
/** @file\r
- Library to abstract runtime services\r
+ Library to abstract runtime services\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: DxeRuntimeDriverLib.h\r
+ Module Name: DxeRuntimeDriverLib.h\r
\r
**/\r
\r
/** @file\r
- Library that provides a global pointer to the DXE Services Table\r
+ Library that provides a global pointer to the DXE Services Table\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: DxeServicesTableLib.h\r
+ Module Name: DxeServicesTableLib.h\r
\r
**/\r
\r
/** @file\r
- Public include file for the HII Library\r
+ Public include file for the HII Library\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: HiiLib.h\r
+ Module Name: HiiLib.h\r
\r
**/\r
\r
#define __HII_LIB_H__\r
\r
/**\r
- This function allocates pool for an EFI_HII_PACKAGES structure\r
- with enough space for the variable argument list of package pointers.\r
- The allocated structure is initialized using NumberOfPackages, Guid, \r
- and the variable length argument list of package pointers.\r
+ This function allocates pool for an EFI_HII_PACKAGES structure\r
+ with enough space for the variable argument list of package pointers.\r
+ The allocated structure is initialized using NumberOfPackages, Guid, \r
+ and the variable length argument list of package pointers.\r
\r
- @param NumberOfPackages The number of HII packages to prepare.\r
- @param Guid Package GUID.\r
+ @param NumberOfPackages The number of HII packages to prepare.\r
+ @param Guid Package GUID.\r
\r
- @return\r
- The allocated and initialized packages.\r
+ @return\r
+ The allocated and initialized packages.\r
\r
**/\r
EFI_HII_PACKAGES *\r
/** @file\r
- Public include file for the HOB Library\r
+ Public include file for the HOB Library\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: HobLib.h\r
+ Module Name: HobLib.h\r
\r
**/\r
\r
/** @file\r
- I/O and MMIO Library Services\r
+ I/O and MMIO Library Services\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: IoLib.h\r
+ Module Name: IoLib.h\r
\r
**/\r
\r
/** @file\r
- Memory Allocation Library Services\r
+ Memory Allocation Library Services\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: MemoryAllocationLib.h\r
+ Module Name: MemoryAllocationLib.h\r
\r
**/\r
\r
#define __MEMORY_ALLOCATION_LIB_H__\r
\r
/**\r
- Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData.\r
+ Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData.\r
\r
- @param Pages The number of 4 KB pages to allocate.\r
+ @param Pages The number of 4 KB pages to allocate.\r
\r
- @return\r
- A pointer to the allocated buffer. The buffer returned is aligned on a 4KB boundary.\r
- If Pages is 0, then NULL is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. The buffer returned is aligned on a 4KB boundary.\r
+ If Pages is 0, then NULL is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData. \r
+ Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData. \r
\r
- @param Pages The number of 4 KB pages to allocate.\r
+ @param Pages The number of 4 KB pages to allocate.\r
\r
- @return\r
- A pointer to the allocated buffer. The buffer returned is aligned on a 4KB boundary.\r
- If Pages is 0, then NULL is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. The buffer returned is aligned on a 4KB boundary.\r
+ If Pages is 0, then NULL is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType. \r
+ Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType. \r
\r
- @param Pages The number of 4 KB pages to allocate.\r
+ @param Pages The number of 4 KB pages to allocate.\r
\r
- @return\r
- A pointer to the allocated buffer. The buffer returned is aligned on a 4KB boundary.\r
- If Pages is 0, then NULL is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. The buffer returned is aligned on a 4KB boundary.\r
+ If Pages is 0, then NULL is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Frees one or more 4KB pages that were previously allocated with \r
- one of the page allocation functions in the Memory Allocation Library.\r
+ Frees one or more 4KB pages that were previously allocated with \r
+ one of the page allocation functions in the Memory Allocation Library.\r
\r
- @param Buffer Pointer to the buffer of pages to free.\r
- @param Pages The number of 4 KB pages to free.\r
+ @param Buffer Pointer to the buffer of pages to free.\r
+ @param Pages The number of 4 KB pages to free.\r
\r
- None.\r
+ None.\r
\r
**/\r
VOID\r
;\r
\r
/**\r
- Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an alignment specified by Alignment. \r
+ Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an alignment specified by Alignment. \r
\r
- @param Pages The number of 4 KB pages to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param Pages The number of 4 KB pages to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- The allocated buffer is returned. If Pages is 0, then NULL is returned.\r
- If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ The allocated buffer is returned. If Pages is 0, then NULL is returned.\r
+ If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an alignment specified by Alignment. \r
+ Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an alignment specified by Alignment. \r
\r
- @param Pages The number of 4 KB pages to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param Pages The number of 4 KB pages to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- The allocated buffer is returned. If Pages is 0, then NULL is returned.\r
- If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ The allocated buffer is returned. If Pages is 0, then NULL is returned.\r
+ If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.\r
+ Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.\r
\r
- @param Pages The number of 4 KB pages to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param Pages The number of 4 KB pages to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- The allocated buffer is returned. If Pages is 0, then NULL is returned.\r
- If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ The allocated buffer is returned. If Pages is 0, then NULL is returned.\r
+ If there is not enough memory at the specified alignment remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Frees one or more 4KB pages that were previously allocated with \r
- one of the aligned page allocation functions in the Memory Allocation Library.\r
+ Frees one or more 4KB pages that were previously allocated with \r
+ one of the aligned page allocation functions in the Memory Allocation Library.\r
\r
- @param Buffer Pointer to the buffer of pages to free.\r
- @param Pages The number of 4 KB pages to free.\r
+ @param Buffer Pointer to the buffer of pages to free.\r
+ @param Pages The number of 4 KB pages to free.\r
\r
- None.\r
+ None.\r
\r
**/\r
VOID\r
;\r
\r
/**\r
- Allocates a buffer of type EfiBootServicesData.\r
+ Allocates a buffer of type EfiBootServicesData.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
+ @param AllocationSize The number of bytes to allocate.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates a buffer of type EfiRuntimeServicesData.\r
+ Allocates a buffer of type EfiRuntimeServicesData.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
+ @param AllocationSize The number of bytes to allocate.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates a buffer of type EfiReservedMemoryType.\r
+ Allocates a buffer of type EfiReservedMemoryType.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
+ @param AllocationSize The number of bytes to allocate.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates and zeros a buffer of type EfiBootServicesData.\r
+ Allocates and zeros a buffer of type EfiBootServicesData.\r
\r
- @param AllocationSize The number of bytes to allocate and zero.\r
+ @param AllocationSize The number of bytes to allocate and zero.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates and zeros a buffer of type EfiRuntimeServicesData.\r
+ Allocates and zeros a buffer of type EfiRuntimeServicesData.\r
\r
- @param AllocationSize The number of bytes to allocate and zero.\r
+ @param AllocationSize The number of bytes to allocate and zero.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates and zeros a buffer of type EfiReservedMemoryType.\r
+ Allocates and zeros a buffer of type EfiReservedMemoryType.\r
\r
- @param AllocationSize The number of bytes to allocate and zero.\r
+ @param AllocationSize The number of bytes to allocate and zero.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Copies a buffer to an allocated buffer of type EfiBootServicesData. \r
+ Copies a buffer to an allocated buffer of type EfiBootServicesData. \r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Buffer The buffer to copy to the allocated buffer.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Buffer The buffer to copy to the allocated buffer.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Copies a buffer to an allocated buffer of type EfiRuntimeServicesData. \r
+ Copies a buffer to an allocated buffer of type EfiRuntimeServicesData. \r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Buffer The buffer to copy to the allocated buffer.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Buffer The buffer to copy to the allocated buffer.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Copies a buffer to an allocated buffer of type EfiReservedMemoryType. \r
+ Copies a buffer to an allocated buffer of type EfiReservedMemoryType. \r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Buffer The buffer to copy to the allocated buffer.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Buffer The buffer to copy to the allocated buffer.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Frees a buffer that was previously allocated with one of the pool allocation functions \r
- in the Memory Allocation Library.\r
+ Frees a buffer that was previously allocated with one of the pool allocation functions \r
+ in the Memory Allocation Library.\r
\r
- @param Buffer Pointer to the buffer to free.\r
+ @param Buffer Pointer to the buffer to free.\r
\r
- None.\r
+ None.\r
\r
**/\r
VOID\r
;\r
\r
/**\r
- Allocates a buffer of type EfiBootServicesData at a specified alignment.\r
+ Allocates a buffer of type EfiBootServicesData at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates a buffer of type EfiRuntimeServicesData at a specified alignment.\r
+ Allocates a buffer of type EfiRuntimeServicesData at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates a buffer of type EfiReservedMemoryType at a specified alignment.\r
+ Allocates a buffer of type EfiReservedMemoryType at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
+ Allocates and zeros a buffer of type EfiBootServicesData at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates and zeros a buffer of type EfiRuntimeServicesData at a specified alignment.\r
+ Allocates and zeros a buffer of type EfiRuntimeServicesData at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Allocates and zeros a buffer of type EfiReservedMemoryType at a specified alignment.\r
+ Allocates and zeros a buffer of type EfiReservedMemoryType at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
+ Copies a buffer to an allocated buffer of type EfiBootServicesData at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Buffer The buffer to copy to the allocated buffer.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Buffer The buffer to copy to the allocated buffer.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Copies a buffer to an allocated buffer of type EfiRuntimeServicesData at a specified alignment.\r
+ Copies a buffer to an allocated buffer of type EfiRuntimeServicesData at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Buffer The buffer to copy to the allocated buffer.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Buffer The buffer to copy to the allocated buffer.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
+ Copies a buffer to an allocated buffer of type EfiReservedMemoryType at a specified alignment.\r
\r
- @param AllocationSize The number of bytes to allocate.\r
- @param Buffer The buffer to copy to the allocated buffer.\r
- @param Alignment The requested alignment of the allocation. Must be a power of two.\r
- If Alignment is zero, then byte alignment is used.\r
+ @param AllocationSize The number of bytes to allocate.\r
+ @param Buffer The buffer to copy to the allocated buffer.\r
+ @param Alignment The requested alignment of the allocation. Must be a power of two.\r
+ If Alignment is zero, then byte alignment is used.\r
\r
- @return\r
- A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
- If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
+ @return\r
+ A pointer to the allocated buffer. If AllocationSize is 0, then a valid buffer of 0 size is returned.\r
+ If there is not enough memory remaining to satisfy the request, then NULL is returned.\r
\r
**/\r
VOID *\r
;\r
\r
/**\r
- Frees a buffer that was previously allocated with one of the aligned pool allocation functions \r
- in the Memory Allocation Library.\r
+ Frees a buffer that was previously allocated with one of the aligned pool allocation functions \r
+ in the Memory Allocation Library.\r
\r
- @param Buffer Pointer to the buffer to free.\r
+ @param Buffer Pointer to the buffer to free.\r
\r
- None.\r
+ None.\r
\r
**/\r
VOID\r
/** @file\r
- PCI CF8 Library Services for PCI Segment #0\r
+ PCI CF8 Library Services for PCI Segment #0\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: PciCf8Lib.h\r
+ Module Name: PciCf8Lib.h\r
\r
**/\r
\r
/** @file\r
- Pci Express Library Services for PCI Segment #0\r
+ Pci Express Library Services for PCI Segment #0\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: PciExpressLib.h\r
+ Module Name: PciExpressLib.h\r
\r
**/\r
\r
/** @file\r
- PCI Library Services for PCI Segment #0\r
+ PCI Library Services for PCI Segment #0\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: PciLib.h\r
+ Module Name: PciLib.h\r
\r
**/\r
\r
/** @file\r
- Memory Only PE COFF loader\r
+ Memory Only PE COFF loader\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: PeCoffGetEntryPointLib.h\r
+ Module Name: PeCoffGetEntryPointLib.h\r
\r
**/\r
\r
#define __PE_COFF_GET_ENTRY_POINT_LIB_H__\r
\r
/**\r
- Loads a PE/COFF image into memory\r
+ Retrieves and returns a pointer to the entry point to a PE/COFF image that has been loaded\r
+ into system memory with the PE/COFF Loader Library functions.\r
\r
- @param Pe32Data Pointer to a PE/COFF Image\r
- \r
- @param EntryPoint Pointer to the entry point of the PE/COFF image\r
+ Retrieves the entry point to the PE/COFF image specified by Pe32Data and returns this entry\r
+ point in EntryPoint. If the entry point could not be retrieved from the PE/COFF image, then\r
+ return RETURN_INVALID_PARAMETER. Otherwise return RETURN_SUCCESS.\r
+ If Pe32Data is NULL, then ASSERT().\r
+ If EntryPoint is NULL, then ASSERT().\r
\r
- @retval EFI_SUCCESS if the EntryPoint was returned\r
- @retval EFI_INVALID_PARAMETER if the EntryPoint could not be found from Pe32Data\r
+ @param Pe32Data Pointer to the PE/COFF image that is loaded in system memory.\r
+ @param EntryPoint Pointer to entry point to the PE/COFF image to return.\r
+\r
+ @retval RETURN_SUCCESS EntryPoint was returned.\r
+ @retval RETURN_INVALID_PARAMETER The entry point could not be found in the PE/COFF image.\r
\r
**/\r
RETURN_STATUS\r
EFIAPI\r
PeCoffLoaderGetEntryPoint (\r
- IN VOID *Pe32Data,\r
- IN OUT VOID **EntryPoint\r
- )\r
-;\r
+ IN VOID *Pe32Data,\r
+ OUT VOID **EntryPoint\r
+ );\r
\r
#endif\r
/** @file\r
- Memory Only PE COFF loader\r
+ Memory Only PE COFF loader\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: PeCoffLib.h\r
+ Module Name: PeCoffLib.h\r
\r
**/\r
\r
/** @file\r
- PEI Core Library implementation\r
+ PEI Core Library implementation\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: PeiServicesLib.h\r
+ Module Name: PeiServicesLib.h\r
\r
**/\r
\r
#define __PEI_SERVICES_LIB_H__\r
\r
/**\r
- This service enables a given PEIM to register an interface into the PEI Foundation. \r
+ This service enables a given PEIM to register an interface into the PEI Foundation. \r
\r
- @param PpiList A pointer to the list of interfaces that the caller shall install.\r
+ @param PpiList A pointer to the list of interfaces that the caller shall install.\r
\r
- @retval EFI_SUCCESS The interface was successfully installed.\r
- @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL.\r
- @retval EFI_INVALID_PARAMETER Any of the PEI PPI descriptors in the list do not have\r
- the EFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field.\r
- @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.\r
+ @retval EFI_SUCCESS The interface was successfully installed.\r
+ @retval EFI_INVALID_PARAMETER The PpiList pointer is NULL.\r
+ @retval EFI_INVALID_PARAMETER Any of the PEI PPI descriptors in the list do not have\r
+ the EFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field.\r
+ @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to replace an entry in the PPI database with an alternate entry.\r
+ This service enables PEIMs to replace an entry in the PPI database with an alternate entry.\r
\r
- @param OldPpi Pointer to the old PEI PPI Descriptors.\r
- @param NewPpi Pointer to the new PEI PPI Descriptors.\r
+ @param OldPpi Pointer to the old PEI PPI Descriptors.\r
+ @param NewPpi Pointer to the new PEI PPI Descriptors.\r
\r
- @retval EFI_SUCCESS The interface was successfully installed.\r
- @retval EFI_INVALID_PARAMETER The OldPpi or NewPpi is NULL.\r
- @retval EFI_INVALID_PARAMETER Any of the PEI PPI descriptors in the list do not have\r
- the EFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field.\r
- @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.\r
- @retval EFI_NOT_FOUND The PPI for which the reinstallation was requested has not been installed.\r
+ @retval EFI_SUCCESS The interface was successfully installed.\r
+ @retval EFI_INVALID_PARAMETER The OldPpi or NewPpi is NULL.\r
+ @retval EFI_INVALID_PARAMETER Any of the PEI PPI descriptors in the list do not have\r
+ the EFI_PEI_PPI_DESCRIPTOR_PPI bit set in the Flags field.\r
+ @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.\r
+ @retval EFI_NOT_FOUND The PPI for which the reinstallation was requested has not been installed.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
-PeiServicesReinstallPpi (\r
+PeiServicesReInstallPpi (\r
IN EFI_PEI_PPI_DESCRIPTOR *OldPpi,\r
IN EFI_PEI_PPI_DESCRIPTOR *NewPpi\r
)\r
;\r
\r
/**\r
- This service enables PEIMs to discover a given instance of an interface.\r
+ This service enables PEIMs to discover a given instance of an interface.\r
\r
- @param Guid A pointer to the GUID whose corresponding interface needs to be found.\r
- @param Instance The N-th instance of the interface that is required.\r
- @param PpiDescriptor A pointer to instance of the EFI_PEI_PPI_DESCRIPTOR.\r
- @param Ppi A pointer to the instance of the interface.\r
+ @param Guid A pointer to the GUID whose corresponding interface needs to be found.\r
+ @param Instance The N-th instance of the interface that is required.\r
+ @param PpiDescriptor A pointer to instance of the EFI_PEI_PPI_DESCRIPTOR.\r
+ @param Ppi A pointer to the instance of the interface.\r
\r
- @retval EFI_SUCCESS The interface was successfully returned.\r
- @retval EFI_NOT_FOUND The PPI descriptor is not found in the database.\r
+ @retval EFI_SUCCESS The interface was successfully returned.\r
+ @retval EFI_NOT_FOUND The PPI descriptor is not found in the database.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to register a given service to be invoked\r
- when another service is installed or reinstalled.\r
+ This service enables PEIMs to register a given service to be invoked\r
+ when another service is installed or reinstalled.\r
\r
- @param NotifyList A pointer to the list of notification interfaces that the caller shall install.\r
+ @param NotifyList A pointer to the list of notification interfaces that the caller shall install.\r
\r
- @retval EFI_SUCCESS The interface was successfully installed.\r
- @retval EFI_INVALID_PARAMETER The NotifyList pointer is NULL.\r
- @retval EFI_INVALID_PARAMETER Any of the PEI notify descriptors in the list do not have\r
- the EFI_PEI_PPI_DESCRIPTOR_NOTIFY_TYPES bit set in the Flags field.\r
- @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.\r
+ @retval EFI_SUCCESS The interface was successfully installed.\r
+ @retval EFI_INVALID_PARAMETER The NotifyList pointer is NULL.\r
+ @retval EFI_INVALID_PARAMETER Any of the PEI notify descriptors in the list do not have\r
+ the EFI_PEI_PPI_DESCRIPTOR_NOTIFY_TYPES bit set in the Flags field.\r
+ @retval EFI_OUT_OF_RESOURCES There is no additional space in the PPI database.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to ascertain the present value of the boot mode. \r
+ This service enables PEIMs to ascertain the present value of the boot mode. \r
\r
- @param BootMode A pointer to contain the value of the boot mode.\r
+ @param BootMode A pointer to contain the value of the boot mode.\r
\r
- @retval EFI_SUCCESS The boot mode was returned successfully.\r
- @retval EFI_INVALID_PARAMETER BootMode is NULL.\r
+ @retval EFI_SUCCESS The boot mode was returned successfully.\r
+ @retval EFI_INVALID_PARAMETER BootMode is NULL.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to update the boot mode variable. \r
+ This service enables PEIMs to update the boot mode variable. \r
\r
- @param BootMode The value of the boot mode to set.\r
+ @param BootMode The value of the boot mode to set.\r
\r
- @retval EFI_SUCCESS The value was successfully updated\r
+ @retval EFI_SUCCESS The value was successfully updated\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables a PEIM to ascertain the address of the list of HOBs in memory.\r
+ This service enables a PEIM to ascertain the address of the list of HOBs in memory.\r
\r
- @param HobList A pointer to the list of HOBs that the PEI Foundation will initialize.\r
+ @param HobList A pointer to the list of HOBs that the PEI Foundation will initialize.\r
\r
- @retval EFI_SUCCESS The list was successfully returned.\r
- @retval EFI_NOT_AVAILABLE_YET The HOB list is not yet published.\r
+ @retval EFI_SUCCESS The list was successfully returned.\r
+ @retval EFI_NOT_AVAILABLE_YET The HOB list is not yet published.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to create various types of HOBs.\r
+ This service enables PEIMs to create various types of HOBs.\r
\r
- @param Type The type of HOB to be installed.\r
- @param Length The length of the HOB to be added.\r
- @param Hob The address of a pointer that will contain the HOB header.\r
+ @param Type The type of HOB to be installed.\r
+ @param Length The length of the HOB to be added.\r
+ @param Hob The address of a pointer that will contain the HOB header.\r
\r
- @retval EFI_SUCCESS The HOB was successfully created.\r
- @retval EFI_OUT_OF_RESOURCES There is no additional space for HOB creation.\r
+ @retval EFI_SUCCESS The HOB was successfully created.\r
+ @retval EFI_OUT_OF_RESOURCES There is no additional space for HOB creation.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to discover additional firmware volumes.\r
+ This service enables PEIMs to discover additional firmware volumes.\r
\r
- @param Instance This instance of the firmware volume to find.\r
- The value 0 is the Boot Firmware Volume (BFV).\r
- @param FwVolHeader Pointer to the firmware volume header of the volume to return.\r
+ @param Instance This instance of the firmware volume to find.\r
+ The value 0 is the Boot Firmware Volume (BFV).\r
+ @param FwVolHeader Pointer to the firmware volume header of the volume to return.\r
\r
- @retval EFI_SUCCESS The volume was found.\r
- @retval EFI_NOT_FOUND The volume was not found.\r
- @retval EFI_INVALID_PARAMETER FwVolHeader is NULL.\r
+ @retval EFI_SUCCESS The volume was found.\r
+ @retval EFI_NOT_FOUND The volume was not found.\r
+ @retval EFI_INVALID_PARAMETER FwVolHeader is NULL.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to discover additional firmware files.\r
+ This service enables PEIMs to discover additional firmware files.\r
\r
- @param SearchType A filter to find files only of this type.\r
- @param FwVolHeader Pointer to the firmware volume header of the volume to search.\r
- This parameter must point to a valid FFS volume.\r
- @param FileHeader Pointer to the current file from which to begin searching.\r
+ @param SearchType A filter to find files only of this type.\r
+ @param FwVolHeader Pointer to the firmware volume header of the volume to search.\r
+ This parameter must point to a valid FFS volume.\r
+ @param FileHeader Pointer to the current file from which to begin searching.\r
\r
- @retval EFI_SUCCESS The file was found.\r
- @retval EFI_NOT_FOUND The file was not found.\r
- @retval EFI_NOT_FOUND The header checksum was not zero.\r
+ @retval EFI_SUCCESS The file was found.\r
+ @retval EFI_NOT_FOUND The file was not found.\r
+ @retval EFI_NOT_FOUND The header checksum was not zero.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to discover sections of a given type within a valid FFS file.\r
+ This service enables PEIMs to discover sections of a given type within a valid FFS file.\r
\r
- @param SearchType The value of the section type to find.\r
- @param FfsFileHeader A pointer to the file header that contains the set of sections to be searched.\r
- @param SectionData A pointer to the discovered section, if successful.\r
+ @param SearchType The value of the section type to find.\r
+ @param FfsFileHeader A pointer to the file header that contains the set of sections to be searched.\r
+ @param SectionData A pointer to the discovered section, if successful.\r
\r
- @retval EFI_SUCCESS The section was found.\r
- @retval EFI_NOT_FOUND The section was not found.\r
+ @retval EFI_SUCCESS The section was found.\r
+ @retval EFI_NOT_FOUND The section was not found.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to register the permanent memory configuration\r
- that has been initialized with the PEI Foundation.\r
+ This service enables PEIMs to register the permanent memory configuration\r
+ that has been initialized with the PEI Foundation.\r
\r
- @param MemoryBegin The value of a region of installed memory.\r
- @param MemoryLength The corresponding length of a region of installed memory.\r
+ @param MemoryBegin The value of a region of installed memory.\r
+ @param MemoryLength The corresponding length of a region of installed memory.\r
\r
- @retval EFI_SUCCESS The region was successfully installed in a HOB.\r
- @retval EFI_INVALID_PARAMETER MemoryBegin and MemoryLength are illegal for this system.\r
- @retval EFI_OUT_OF_RESOURCES There is no additional space for HOB creation.\r
+ @retval EFI_SUCCESS The region was successfully installed in a HOB.\r
+ @retval EFI_INVALID_PARAMETER MemoryBegin and MemoryLength are illegal for this system.\r
+ @retval EFI_OUT_OF_RESOURCES There is no additional space for HOB creation.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service enables PEIMs to allocate memory after the permanent memory has been installed by a PEIM.\r
+ This service enables PEIMs to allocate memory after the permanent memory has been installed by a PEIM.\r
\r
- @param MemoryType Type of memory to allocate.\r
- @param Pages Number of pages to allocate.\r
- @param Memory Pointer of memory allocated.\r
+ @param MemoryType Type of memory to allocate.\r
+ @param Pages Number of pages to allocate.\r
+ @param Memory Pointer of memory allocated.\r
\r
- @retval EFI_SUCCESS The memory range was successfully allocated.\r
- @retval EFI_INVALID_PARAMETER Type is not equal to AllocateAnyPages.\r
- @retval EFI_NOT_AVAILABLE_YET Called with permanent memory not available.\r
- @retval EFI_OUT_OF_RESOURCES The pages could not be allocated.\r
+ @retval EFI_SUCCESS The memory range was successfully allocated.\r
+ @retval EFI_INVALID_PARAMETER Type is not equal to AllocateAnyPages.\r
+ @retval EFI_NOT_AVAILABLE_YET Called with permanent memory not available.\r
+ @retval EFI_OUT_OF_RESOURCES The pages could not be allocated.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service allocates memory from the Hand-Off Block (HOB) heap.\r
+ This service allocates memory from the Hand-Off Block (HOB) heap.\r
\r
- @param Size The number of bytes to allocate from the pool.\r
- @param Buffer If the call succeeds, a pointer to a pointer to the allocated buffer;\r
- undefined otherwise.\r
+ @param Size The number of bytes to allocate from the pool.\r
+ @param Buffer If the call succeeds, a pointer to a pointer to the allocated buffer;\r
+ undefined otherwise.\r
\r
- @retval EFI_SUCCESS The allocation was successful\r
- @retval EFI_OUT_OF_RESOURCES There is not enough heap to allocate the requested size.\r
+ @retval EFI_SUCCESS The allocation was successful\r
+ @retval EFI_OUT_OF_RESOURCES There is not enough heap to allocate the requested size.\r
\r
**/\r
EFI_STATUS\r
;\r
\r
/**\r
- This service resets the entire platform, including all processors and devices, and reboots the system. \r
+ This service resets the entire platform, including all processors and devices, and reboots the system. \r
\r
- @retval EFI_NOT_AVAILABLE_YET The service has not been installed yet.\r
+ @retval EFI_NOT_AVAILABLE_YET The service has not been installed yet.\r
\r
**/\r
EFI_STATUS\r
/** @file\r
- PEI Services Table Pointer Library services\r
+ PEI Services Table Pointer Library services\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: PeiServicesTablePointerLib.h\r
+ Module Name: PeiServicesTablePointerLib.h\r
\r
**/\r
\r
/** @file\r
- Library that provides print services\r
+ Library that provides print services\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: PrintLib.h\r
+ Module Name: PrintLib.h\r
\r
**/\r
\r
Unicode string.\r
@param Flags The bitmask of flags that specify left justification, zero pad, and commas.\r
@param Value The 64-bit signed value to convert to a string.\r
- @param Width The maximum number of Unicode characters to place in Buffer.\r
+ @param Width The maximum number of Unicode characters to place in Buffer.\r
\r
@return Total number of characters required to perform the conversion.\r
\r
ASCII string.\r
@param Flags The bitmask of flags that specify left justification, zero pad, and commas.\r
@param Value The 64-bit signed value to convert to a string.\r
- @param Width The maximum number of ASCII characters to place in Buffer.\r
+ @param Width The maximum number of ASCII characters to place in Buffer.\r
\r
@return Total number of characters required to perform the conversion.\r
\r
/** @file\r
- Declare presence of resources in the platform\r
+ Declare presence of resources in the platform\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: ResourcePublicationLib.h\r
+ Module Name: ResourcePublicationLib.h\r
\r
**/\r
\r
/** @file\r
- SMBUS Functions\r
+ SMBUS Functions\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: SmbusLib.h\r
+ Module Name: SmbusLib.h\r
\r
**/\r
\r
/** @file\r
- Timer Library Functions\r
+ Timer Library Functions\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: TimerLib.h\r
+ Module Name: TimerLib.h\r
\r
**/\r
\r
/** @file\r
- Library that provides a global pointer to the UEFI Boot Services Tables\r
+ Library that provides a global pointer to the UEFI Boot Services Tables\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: UefiBootServicesTableLib.h\r
+ Module Name: UefiBootServicesTableLib.h\r
\r
**/\r
\r
/** @file\r
- Return UEFI Decompress Protocol \r
+ Return UEFI Decompress Protocol \r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: UefiDecompressLib.h\r
+ Module Name: UefiDecompressLib.h\r
\r
**/\r
\r
/** @file\r
- UEFI Driver Model Library Services\r
+ UEFI Driver Model Library Services\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: UefiDriverModelLib.h\r
+ Module Name: UefiDriverModelLib.h\r
\r
**/\r
\r
/** @file\r
- Library that provides a global pointer to the UEFI Runtime Services Tables\r
+ Library that provides a global pointer to the UEFI Runtime Services Tables\r
\r
- Copyright (c) 2006, Intel Corporation \r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php \r
+ Copyright (c) 2006, Intel Corporation \r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
- Module Name: UefiRuntimeServicesTableLib.h\r
+ Module Name: UefiRuntimeServicesTableLib.h\r
\r
**/\r
\r
/** @file\r
- Non-existing BaseLib functions on Ia32\r
+ Non-existing BaseLib functions on Ia32\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: Non-existing.c\r
+ Module Name: Non-existing.c\r
\r
**/\r
\r
If Node is not a node in List and Node is not equal to List, then ASSERT().\r
\r
@param List A pointer to the head node of a doubly linked list.\r
- @param Node A pointer to a node in the doubly linked list.\r
+ @param Node A pointer to a node in the doubly linked list.\r
\r
@retval TRUE Node is one of the nodes in the doubly linked list.\r
@retval FALSE Node is not one of the nodes in the doubly linked list.\r
If Node is not a node in List, then ASSERT().\r
\r
@param List A pointer to the head node of a doubly linked list.\r
- @param Node A pointer to a node in the doubly linked list.\r
+ @param Node A pointer to a node in the doubly linked list.\r
\r
@retval TRUE Node is the last node in the linked list.\r
@retval FALSE Node is not the last node in the linked list.\r
/** @file\r
- Non-existing BaseLib functions on x64\r
+ Non-existing BaseLib functions on x64\r
\r
- Copyright (c) 2006, Intel Corporation\r
- All rights reserved. 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
- http://opensource.org/licenses/bsd-license.php\r
+ Copyright (c) 2006, Intel Corporation\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: Non-existing.c\r
+ Module Name: Non-existing.c\r
\r
**/\r
\r
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *Destination,\r
- IN CONST VOID *Source,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
- ASSERT (\r
- Destination == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Destination + 1\r
- );\r
- ASSERT (\r
- Source == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Source + 1\r
- );\r
- if (Destination == Source || Length == 0) {\r
- return Destination;\r
+ if (Length == 0) {\r
+ return DestinationBuffer;\r
+ }\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
+ if (DestinationBuffer == SourceBuffer) {\r
+ return DestinationBuffer;\r
}\r
- return InternalMemCopyMem (Destination, Source, Length);\r
+ return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
{\r
CONST UINT8 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT8*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT16 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT16*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT32 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT32*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT64 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT64*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
**/\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
)\r
{\r
WriteUnaligned64 (\r
}\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
)\r
{\r
return (BOOLEAN)(\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
)\r
{\r
CONST GUID *GuidPtr;\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
ASSERT (Buffer != NULL);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
}\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- Module Name: EfiSetMem.c\r
+ Module Name: SetMem.c\r
\r
**/\r
\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
if (Length == 0) {\r
VOID *\r
EFIAPI\r
SetMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
-\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
)\r
{\r
ASSERT (!(Buffer == NULL && Length > 0));\r
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *Destination,\r
- IN CONST VOID *Source,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
- ASSERT (\r
- Destination == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Destination + 1\r
- );\r
- ASSERT (\r
- Source == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Source + 1\r
- );\r
- if (Destination == Source || Length == 0) {\r
- return Destination;\r
+ if (Length == 0) {\r
+ return DestinationBuffer;\r
+ }\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
+ if (DestinationBuffer == SourceBuffer) {\r
+ return DestinationBuffer;\r
}\r
- return InternalMemCopyMem (Destination, Source, Length);\r
+ return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
**/\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
)\r
{\r
WriteUnaligned64 (\r
}\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
)\r
{\r
return (BOOLEAN)(\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
)\r
{\r
CONST GUID *GuidPtr;\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
ASSERT (Buffer != NULL);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
}\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
if (Length == 0) {\r
VOID *\r
EFIAPI\r
SetMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
-\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
)\r
{\r
ASSERT (!(Buffer == NULL && Length > 0));\r
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *Destination,\r
- IN CONST VOID *Source,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
- ASSERT (\r
- Destination == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Destination + 1\r
- );\r
- ASSERT (\r
- Source == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Source + 1\r
- );\r
- if (Destination == Source || Length == 0) {\r
- return Destination;\r
+ if (Length == 0) {\r
+ return DestinationBuffer;\r
+ }\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
+ if (DestinationBuffer == SourceBuffer) {\r
+ return DestinationBuffer;\r
}\r
- return InternalMemCopyMem (Destination, Source, Length);\r
+ return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
**/\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
)\r
{\r
WriteUnaligned64 (\r
}\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
)\r
{\r
return (BOOLEAN)(\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
)\r
{\r
CONST GUID *GuidPtr;\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
ASSERT (Buffer != NULL);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
}\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
if (Length == 0) {\r
VOID *\r
EFIAPI\r
SetMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
-\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
)\r
{\r
ASSERT (!(Buffer == NULL && Length > 0));\r
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *Destination,\r
- IN CONST VOID *Source,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
- ASSERT (\r
- Destination == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Destination + 1\r
- );\r
- ASSERT (\r
- Source == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Source + 1\r
- );\r
- if (Destination == Source || Length == 0) {\r
- return Destination;\r
+ if (Length == 0) {\r
+ return DestinationBuffer;\r
+ }\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
+ if (DestinationBuffer == SourceBuffer) {\r
+ return DestinationBuffer;\r
}\r
- return InternalMemCopyMem (Destination, Source, Length);\r
+ return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
**/\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
)\r
{\r
WriteUnaligned64 (\r
}\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
)\r
{\r
return (BOOLEAN)(\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
)\r
{\r
CONST GUID *GuidPtr;\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
ASSERT (Buffer != NULL);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
}\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
if (Length == 0) {\r
VOID *\r
EFIAPI\r
SetMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
-\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
)\r
{\r
ASSERT (!(Buffer == NULL && Length > 0));\r
//\r
RelocDir = &TeHdr->DataDirectory[0];\r
RelocBase = (EFI_IMAGE_BASE_RELOCATION *)(UINTN)(\r
- ImageContext->ImageAddress + \r
- RelocDir->VirtualAddress +\r
- sizeof(EFI_TE_IMAGE_HEADER) - \r
- TeHdr->StrippedSize\r
- );\r
+ ImageContext->ImageAddress + \r
+ RelocDir->VirtualAddress +\r
+ sizeof(EFI_TE_IMAGE_HEADER) - \r
+ TeHdr->StrippedSize\r
+ );\r
RelocBaseEnd = (EFI_IMAGE_BASE_RELOCATION *) ((UINTN) RelocBase + (UINTN) RelocDir->Size - 1);\r
}\r
\r
FixupBase = PeCoffLoaderImageAddress (ImageContext, RelocBase->VirtualAddress);\r
} else {\r
FixupBase = (CHAR8 *)(UINTN)(ImageContext->ImageAddress +\r
- RelocBase->VirtualAddress +\r
- sizeof(EFI_TE_IMAGE_HEADER) - \r
- TeHdr->StrippedSize\r
- );\r
+ RelocBase->VirtualAddress +\r
+ sizeof(EFI_TE_IMAGE_HEADER) - \r
+ TeHdr->StrippedSize\r
+ );\r
}\r
\r
if ((CHAR8 *) RelocEnd < (CHAR8 *) ((UINTN) ImageContext->ImageAddress) ||\r
TeHdr = (EFI_TE_IMAGE_HEADER *) (UINTN) (ImageContext->ImageAddress);\r
\r
FirstSection = (EFI_IMAGE_SECTION_HEADER *) (\r
- (UINTN)ImageContext->ImageAddress +\r
- sizeof(EFI_TE_IMAGE_HEADER)\r
- );\r
+ (UINTN)ImageContext->ImageAddress +\r
+ sizeof(EFI_TE_IMAGE_HEADER)\r
+ );\r
NumberOfSections = (UINTN) (TeHdr->NumberOfSections);\r
\r
}\r
);\r
} else {\r
ImageContext->EntryPoint = (PHYSICAL_ADDRESS) (\r
- (UINTN)ImageContext->ImageAddress +\r
- (UINTN)TeHdr->AddressOfEntryPoint +\r
- (UINTN)sizeof(EFI_TE_IMAGE_HEADER) -\r
+ (UINTN)ImageContext->ImageAddress +\r
+ (UINTN)TeHdr->AddressOfEntryPoint +\r
+ (UINTN)sizeof(EFI_TE_IMAGE_HEADER) -\r
(UINTN) TeHdr->StrippedSize\r
);\r
}\r
);\r
} else {\r
DebugEntry = (EFI_IMAGE_DEBUG_DIRECTORY_ENTRY *)(UINTN)(\r
- ImageContext->ImageAddress +\r
- ImageContext->DebugDirectoryEntryRva +\r
- sizeof(EFI_TE_IMAGE_HEADER) -\r
- TeHdr->StrippedSize\r
- );\r
+ ImageContext->ImageAddress +\r
+ ImageContext->DebugDirectoryEntryRva +\r
+ sizeof(EFI_TE_IMAGE_HEADER) -\r
+ TeHdr->StrippedSize\r
+ );\r
}\r
\r
if (DebugEntry != NULL) {\r
ImageContext->CodeView = PeCoffLoaderImageAddress (ImageContext, TempDebugEntryRva);\r
} else {\r
ImageContext->CodeView = (VOID *)(\r
- (UINTN)ImageContext->ImageAddress +\r
- (UINTN)TempDebugEntryRva +\r
- (UINTN)sizeof(EFI_TE_IMAGE_HEADER) -\r
+ (UINTN)ImageContext->ImageAddress +\r
+ (UINTN)TempDebugEntryRva +\r
+ (UINTN)sizeof(EFI_TE_IMAGE_HEADER) -\r
(UINTN) TeHdr->StrippedSize\r
);\r
}\r
If TimeStamp is zero, then this function reads the current time stamp\r
and adds that time stamp value to the record as the start time.\r
\r
- @param Handle Pointer to environment specific context used\r
+ @param Handle Pointer to environment specific context used\r
to identify the component being measured.\r
- @param Token Pointer to a Null-terminated ASCII string\r
+ @param Token Pointer to a Null-terminated ASCII string\r
that identifies the component being measured.\r
- @param Module Pointer to a Null-terminated ASCII string\r
+ @param Module Pointer to a Null-terminated ASCII string\r
that identifies the module being measured.\r
- @param TimeStamp 64-bit time stamp.\r
+ @param TimeStamp 64-bit time stamp.\r
\r
@retval RETURN_SUCCESS The start of the measurement was recorded.\r
- @retval RETURN_OUT_OF_RESOURCES There are not enough resources to record the measurement.\r
+ @retval RETURN_OUT_OF_RESOURCES There are not enough resources to record the measurement.\r
\r
**/\r
RETURN_STATUS\r
the current time stamp and adds that time stamp value to the record as the end time.\r
If this function is called multiple times for the same record, then the end time is overwritten.\r
\r
- @param Handle Pointer to environment specific context used\r
+ @param Handle Pointer to environment specific context used\r
to identify the component being measured.\r
- @param Token Pointer to a Null-terminated ASCII string\r
+ @param Token Pointer to a Null-terminated ASCII string\r
that identifies the component being measured.\r
- @param Module Pointer to a Null-terminated ASCII string\r
+ @param Module Pointer to a Null-terminated ASCII string\r
that identifies the module being measured.\r
- @param TimeStamp 64-bit time stamp.\r
+ @param TimeStamp 64-bit time stamp.\r
\r
@retval RETURN_SUCCESS The end of the measurement was recorded.\r
- @retval RETURN_NOT_FOUND The specified measurement record could not be found.\r
+ @retval RETURN_NOT_FOUND The specified measurement record could not be found.\r
\r
**/\r
RETURN_STATUS\r
\r
@retval TRUE The PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_ENABLED bit of\r
PcdPerformanceLibraryPropertyMask is set.\r
- @retval FALSE The PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_ENABLED bit of\r
+ @retval FALSE The PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_ENABLED bit of\r
PcdPerformanceLibraryPropertyMask is clear.\r
\r
**/\r
Unicode string.\r
@param Flags The bitmask of flags that specify left justification, zero pad, and commas.\r
@param Value The 64-bit signed value to convert to a string.\r
- @param Width The maximum number of Unicode characters to place in Buffer.\r
+ @param Width The maximum number of Unicode characters to place in Buffer.\r
\r
@return Total number of characters required to perform the conversion.\r
\r
ASCII string.\r
@param Flags The bitmask of flags that specify left justification, zero pad, and commas.\r
@param Value The 64-bit signed value to convert to a string.\r
- @param Width The maximum number of ASCII characters to place in Buffer.\r
+ @param Width The maximum number of ASCII characters to place in Buffer.\r
\r
@return Total number of characters required to perform the conversion.\r
\r
@param Flags The bitmask of flags that specify left justification, zero pad,\r
and commas.\r
@param Value The 64-bit signed value to convert to a string.\r
- @param Width The maximum number of characters to place in Buffer.\r
+ @param Width The maximum number of characters to place in Buffer.\r
@param Increment Character increment in Buffer.\r
\r
@return Total number of characters required to perform the conversion.\r
@param Flags The bitmask of flags that specify left justification, zero pad,\r
and commas.\r
@param Value The 64-bit signed value to convert to a string.\r
- @param Width The maximum number of characters to place in Buffer.\r
+ @param Width The maximum number of characters to place in Buffer.\r
@param Increment Character increment in Buffer.\r
\r
@return Total number of characters required to perform the conversion.\r
/**\r
The constructor function caches the PCD_PROTOCOL pointer.\r
\r
- @param[in] ImageHandle The firmware allocated handle for the EFI image. \r
+ @param[in] ImageHandle The firmware allocated handle for the EFI image. \r
@param[in] SystemTable A pointer to the EFI System Table.\r
\r
@retval EFI_SUCCESS The constructor always return EFI_SUCCESS.\r
--- /dev/null
+/** @file\r
+ Debug Library that fowards all messages to ReportStatusCode()\r
+\r
+ Copyright (c) 2006, Intel Corporation<BR>\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
+\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+\r
+**/\r
+\r
+\r
+/**\r
+\r
+ Prints a debug message to the debug output device if the specified error level is enabled.\r
+\r
+ If any bit in ErrorLevel is also set in PcdDebugPrintErrorLevel, then print \r
+ the message specified by Format and the associated variable argument list to \r
+ the debug output device.\r
+\r
+ If Format is NULL, then ASSERT().\r
+\r
+ @param ErrorLevel The error level of the debug message.\r
+ @param Format Format string for the debug message to print.\r
+\r
+**/\r
+VOID\r
+EFIAPI\r
+DebugPrint (\r
+ IN UINTN ErrorLevel,\r
+ IN CONST CHAR8 *Format,\r
+ ...\r
+ )\r
+{\r
+ UINT64 Buffer[EFI_STATUS_CODE_DATA_MAX_SIZE / sizeof (UINT64)];\r
+ EFI_DEBUG_INFO *DebugInfo;\r
+ UINTN TotalSize;\r
+ UINTN Index;\r
+ VA_LIST Marker;\r
+ UINT64 *ArgumentPointer;\r
+\r
+ //\r
+ // If Format is NULL, then ASSERT().\r
+ //\r
+ ASSERT (Format != NULL);\r
+\r
+ //\r
+ // Check driver Debug Level value and global debug level\r
+ //\r
+ if ((ErrorLevel & PcdGet32(PcdDebugPrintErrorLevel)) == 0) {\r
+ return;\r
+ }\r
+\r
+ TotalSize = sizeof (EFI_DEBUG_INFO) + 12 * sizeof (UINT64) + AsciiStrLen (Format) + 1;\r
+ if (TotalSize > EFI_STATUS_CODE_DATA_MAX_SIZE) {\r
+ return;\r
+ }\r
+\r
+ //\r
+ // Then EFI_DEBUG_INFO\r
+ //\r
+ DebugInfo = (EFI_DEBUG_INFO *)Buffer;\r
+ DebugInfo->ErrorLevel = (UINT32)ErrorLevel;\r
+\r
+ //\r
+ // 256 byte mini Var Arg stack. That is followed by the format string.\r
+ //\r
+ VA_START (Marker, Format);\r
+ for (Index = 0, ArgumentPointer = (UINT64 *)(DebugInfo + 1); Index < 12; Index++, ArgumentPointer++) {\r
+ *ArgumentPointer = VA_ARG (Marker, UINT64);\r
+ }\r
+ VA_END (Marker);\r
+ AsciiStrCpy ((CHAR8 *)ArgumentPointer, Format);\r
+\r
+ //\r
+ //\r
+ //\r
+ REPORT_STATUS_CODE_WITH_EXTENDED_DATA (\r
+ EFI_DEBUG_CODE,\r
+ (EFI_SOFTWARE_DXE_BS_DRIVER | EFI_DC_UNSPECIFIED),\r
+ DebugInfo,\r
+ TotalSize\r
+ );\r
+}\r
+\r
+\r
+/**\r
+\r
+ Prints an assert message containing a filename, line number, and description. \r
+ This may be followed by a breakpoint or a dead loop.\r
+\r
+ Print a message of the form "ASSERT <FileName>(<LineNumber>): <Description>\n" \r
+ to the debug output device. If DEBUG_PROPERTY_ASSERT_BREAKPOINT_ENABLED bit of \r
+ PcdDebugProperyMask is set then CpuBreakpoint() is called. Otherwise, if \r
+ DEBUG_PROPERTY_ASSERT_DEADLOOP_ENABLED bit of PcdDebugProperyMask is set then \r
+ CpuDeadLoop() is called. If neither of these bits are set, then this function \r
+ returns immediately after the message is printed to the debug output device.\r
+ DebugAssert() must actively prevent recusrsion. If DebugAssert() is called while\r
+ processing another DebugAssert(), then DebugAssert() must return immediately.\r
+\r
+ If FileName is NULL, then a <FileName> string of "(NULL) Filename" is printed.\r
+\r
+ If Description is NULL, then a <Description> string of "(NULL) Description" is printed.\r
+\r
+ @param FileName Pointer to the name of the source file that generated the assert condition.\r
+ @param LineNumber The line number in the source file that generated the assert condition\r
+ @param Description Pointer to the description of the assert condition.\r
+\r
+**/\r
+VOID\r
+EFIAPI\r
+DebugAssert (\r
+ IN CONST CHAR8 *FileName,\r
+ IN UINTN LineNumber,\r
+ IN CONST CHAR8 *Description\r
+ )\r
+{\r
+ UINT64 Buffer[EFI_STATUS_CODE_DATA_MAX_SIZE / sizeof(UINT64)];\r
+ EFI_DEBUG_ASSERT_DATA *AssertData;\r
+ UINTN TotalSize;\r
+ CHAR8 *Temp;\r
+\r
+ //\r
+ // Make sure it will all fit in the passed in buffer\r
+ //\r
+ TotalSize = sizeof (EFI_DEBUG_ASSERT_DATA) + AsciiStrLen (FileName) + 1 + AsciiStrLen (Description) + 1;\r
+ if (TotalSize <= EFI_STATUS_CODE_DATA_MAX_SIZE) {\r
+ //\r
+ // Fill in EFI_DEBUG_ASSERT_DATA\r
+ //\r
+ AssertData = (EFI_DEBUG_ASSERT_DATA *)Buffer;\r
+ AssertData->LineNumber = (UINT32)LineNumber;\r
+\r
+ //\r
+ // Copy Ascii FileName including NULL.\r
+ //\r
+ Temp = AsciiStrCpy ((CHAR8 *)(AssertData + 1), FileName);\r
+\r
+ //\r
+ // Copy Ascii Description \r
+ //\r
+ AsciiStrCpy (Temp + AsciiStrLen(FileName) + 1, Description);\r
+\r
+ REPORT_STATUS_CODE_WITH_EXTENDED_DATA (\r
+ (EFI_ERROR_CODE | EFI_ERROR_UNRECOVERED),\r
+ (EFI_SOFTWARE_DXE_BS_DRIVER | EFI_SW_EC_ILLEGAL_SOFTWARE_STATE),\r
+ AssertData,\r
+ TotalSize\r
+ );\r
+ }\r
+\r
+ //\r
+ // Generate a Breakpoint, DeadLoop, or NOP based on PCD settings\r
+ //\r
+ if ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_ASSERT_BREAKPOINT_ENABLED) != 0) {\r
+ CpuBreakpoint ();\r
+ } else if ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_ASSERT_DEADLOOP_ENABLED) != 0) {\r
+ CpuDeadLoop ();\r
+ }\r
+}\r
+\r
+\r
+/**\r
+\r
+ Fills a target buffer with PcdDebugClearMemoryValue, and returns the target buffer.\r
+\r
+ This function fills Length bytes of Buffer with the value specified by \r
+ PcdDebugClearMemoryValue, and returns Buffer.\r
+\r
+ If Buffer is NULL, then ASSERT().\r
+\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
+\r
+ @param Buffer Pointer to the target buffer to fill with PcdDebugClearMemoryValue.\r
+ @param Length Number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue. \r
+\r
+ @return Buffer\r
+\r
+**/\r
+VOID *\r
+EFIAPI\r
+DebugClearMemory (\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
+ )\r
+{\r
+ //\r
+ // If Buffer is NULL, then ASSERT().\r
+ //\r
+ ASSERT (Buffer != NULL);\r
+\r
+ //\r
+ // SetMem() checks for the the ASSERT() condition on Length and returns Buffer\r
+ //\r
+ return SetMem (Buffer, Length, PcdGet8(PcdDebugClearMemoryValue));\r
+}\r
+\r
+\r
+/**\r
+ \r
+ Returns TRUE if ASSERT() macros are enabled.\r
+\r
+ This function returns TRUE if the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of \r
+ PcdDebugProperyMask is set. Otherwise FALSE is returned.\r
+\r
+ @retval TRUE The DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set.\r
+ @retval FALSE The DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+DebugAssertEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED) != 0);\r
+}\r
+\r
+\r
+/**\r
+ \r
+ Returns TRUE if DEBUG()macros are enabled.\r
+\r
+ This function returns TRUE if the DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of \r
+ PcdDebugProperyMask is set. Otherwise FALSE is returned.\r
+\r
+ @retval TRUE The DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of PcdDebugProperyMask is set.\r
+ @retval FALSE The DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of PcdDebugProperyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+DebugPrintEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_DEBUG_PRINT_ENABLED) != 0);\r
+}\r
+\r
+\r
+/**\r
+ \r
+ Returns TRUE if DEBUG_CODE()macros are enabled.\r
+\r
+ This function returns TRUE if the DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of \r
+ PcdDebugProperyMask is set. Otherwise FALSE is returned.\r
+\r
+ @retval TRUE The DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is set.\r
+ @retval FALSE The DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+DebugCodeEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_DEBUG_CODE_ENABLED) != 0);\r
+}\r
+\r
+\r
+/**\r
+ \r
+ Returns TRUE if DEBUG_CLEAR_MEMORY()macro is enabled.\r
+\r
+ This function returns TRUE if the DEBUG_PROPERTY_DEBUG_CLEAR_MEMORY_ENABLED bit of \r
+ PcdDebugProperyMask is set. Otherwise FALSE is returned.\r
+\r
+ @retval TRUE The DEBUG_PROPERTY_DEBUG_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is set.\r
+ @retval FALSE The DEBUG_PROPERTY_DEBUG_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+DebugClearMemoryEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED) != 0);\r
+}\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!--\r
+Copyright (c) 2006, Intel Corporation\r
+All rights reserved. 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
+http://opensource.org/licenses/bsd-license.php\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+-->\r
+<LibraryModuleBuildDescription xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.TianoCore.org/2006/Edk2.0 http://www.TianoCore.org/2006/Edk2.0/SurfaceArea.xsd">\r
+ <MbdLibHeader>\r
+ <BaseName>PeiDxeDebugLibReportStatusCode</BaseName>\r
+ <Guid>bda39d3a-451b-4350-8266-81ab10fa0523</Guid>\r
+ <Version>0</Version>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 2004-2006, Intel Corporation</Copyright>\r
+ <License>\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ </License>\r
+ <Created>2006-03-09 23:16</Created>\r
+ <Modified>2006-03-19 15:17</Modified>\r
+ </MbdLibHeader>\r
+</LibraryModuleBuildDescription>\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!--\r
+Copyright (c) 2006, Intel Corporation\r
+All rights reserved. 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
+http://opensource.org/licenses/bsd-license.php\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+-->\r
+<LibraryModuleSurfaceArea xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.TianoCore.org/2006/Edk2.0 http://www.TianoCore.org/2006/Edk2.0/SurfaceArea.xsd">\r
+ <MsaLibHeader>\r
+ <BaseName>PeiDxeDebugLibReportStatusCode</BaseName>\r
+ <ModuleType>PEIM</ModuleType>\r
+ <ComponentType>LIBRARY</ComponentType>\r
+ <Guid>bda39d3a-451b-4350-8266-81ab10fa0523</Guid>\r
+ <Version>0</Version>\r
+ <Abstract>Debug Library for PEIMs that send debug messages to ReportStatusCode</Abstract>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 2004-2006, Intel Corporation</Copyright>\r
+ <License>\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ </License>\r
+ <Created>2006-03-09 23:16</Created>\r
+ <Updated>2006-03-19 15:17</Updated>\r
+ <Specification>0</Specification>\r
+ </MsaLibHeader>\r
+ <LibraryClassDefinitions>\r
+ <LibraryClass Usage="ALWAYS_PRODUCED">DebugLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">BaseLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">BaseMemoryLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">ReportStatusCodeLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">PcdLib</LibraryClass>\r
+ </LibraryClassDefinitions>\r
+ <SourceFiles>\r
+ <Filename>DebugLib.c</Filename>\r
+ </SourceFiles>\r
+ <Includes>\r
+ <PackageName>MdePkg</PackageName>\r
+ </Includes>\r
+ <PcdCoded>\r
+ <PcdEntry PcdItemType="FIXED_AT_BUILD">\r
+ <C_Name>PcdDebugPropertyMask</C_Name>\r
+ </PcdEntry>\r
+ <PcdEntry PcdItemType="FIXED_AT_BUILD">\r
+ <C_Name>PcdDebugClearMemoryValue</C_Name>\r
+ </PcdEntry>\r
+ <PcdEntry PcdItemType="PATCHABLE_IN_MODULE">\r
+ <C_Name>PcdDebugPrintErrorLevel</C_Name>\r
+ </PcdEntry>\r
+ </PcdCoded>\r
+</LibraryModuleSurfaceArea>\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?><!-- Copyright (c) 2006, Intel Corporation \r
+All rights reserved. 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
+http://opensource.org/licenses/bsd-license.php \r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.-->\r
+<project basedir="." default="PeiDxeDebugLibReportStatusCode"><!--Apply external ANT tasks-->\r
+ <taskdef resource="GenBuild.tasks"/>\r
+ <taskdef resource="net/sf/antcontrib/antlib.xml"/>\r
+ <property environment="env"/>\r
+ <property name="WORKSPACE_DIR" value="${env.WORKSPACE}"/>\r
+ <import file="${WORKSPACE_DIR}/Tools/Conf/BuildMacro.xml"/><!--MODULE_RELATIVE PATH is relative to PACKAGE_DIR-->\r
+ <property name="MODULE_RELATIVE_PATH" value="Library/PeiDxeDebugLibReportStatusCode"/>\r
+ <property name="MODULE_DIR" value="${PACKAGE_DIR}/${MODULE_RELATIVE_PATH}"/>\r
+ <property name="COMMON_FILE" value="${WORKSPACE_DIR}/Tools/Conf/Common.xml"/>\r
+ <target name="PeiDxeDebugLibReportStatusCode">\r
+ <GenBuild baseName="PeiDxeDebugLibReportStatusCode" mbdFilename="${MODULE_DIR}/PeiDxeDebugLibReportStatusCode.mbd" msaFilename="${MODULE_DIR}/PeiDxeDebugLibReportStatusCode.msa"/>\r
+ </target>\r
+ <target depends="PeiDxeDebugLibReportStatusCode_clean" name="clean"/>\r
+ <target depends="PeiDxeDebugLibReportStatusCode_cleanall" name="cleanall"/>\r
+ <target name="PeiDxeDebugLibReportStatusCode_clean">\r
+ <OutputDirSetup baseName="PeiDxeDebugLibReportStatusCode" mbdFilename="${MODULE_DIR}/PeiDxeDebugLibReportStatusCode.mbd" msaFilename="${MODULE_DIR}/PeiDxeDebugLibReportStatusCode.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/PeiDxeDebugLibReportStatusCode_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/PeiDxeDebugLibReportStatusCode_build.xml" target="clean"/>\r
+ </then>\r
+ </if>\r
+ <delete dir="${DEST_DIR_OUTPUT}" excludes="*.xml"/>\r
+ </target>\r
+ <target name="PeiDxeDebugLibReportStatusCode_cleanall">\r
+ <OutputDirSetup baseName="PeiDxeDebugLibReportStatusCode" mbdFilename="${MODULE_DIR}/PeiDxeDebugLibReportStatusCode.mbd" msaFilename="${MODULE_DIR}/PeiDxeDebugLibReportStatusCode.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/PeiDxeDebugLibReportStatusCode_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/PeiDxeDebugLibReportStatusCode_build.xml" target="cleanall"/>\r
+ </then>\r
+ </if>\r
+ <delete dir="${DEST_DIR_OUTPUT}"/>\r
+ <delete dir="${DEST_DIR_DEBUG}"/>\r
+ <delete>\r
+ <fileset dir="${BIN_DIR}" includes="**PeiDxeDebugLibReportStatusCode*"/>\r
+ </delete>\r
+ </target>\r
+</project>
\ No newline at end of file
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!--\r
+Copyright (c) 2006, Intel Corporation\r
+All rights reserved. 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
+http://opensource.org/licenses/bsd-license.php\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+-->\r
+<LibraryModuleBuildDescription xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.TianoCore.org/2006/Edk2.0 http://www.TianoCore.org/2006/Edk2.0/SurfaceArea.xsd">\r
+ <MbdLibHeader>\r
+ <BaseName>PeiDxePostCodeLibReportStatusCode</BaseName>\r
+ <Guid>55c61087-7367-4546-bc32-4937c5e6aff3</Guid>\r
+ <Version>0</Version>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 2004-2006, Intel Corporation</Copyright>\r
+ <License>\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ </License>\r
+ <Created>2006-03-09 23:16</Created>\r
+ <Modified>2006-03-19 15:17</Modified>\r
+ </MbdLibHeader>\r
+</LibraryModuleBuildDescription>\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!--\r
+Copyright (c) 2006, Intel Corporation\r
+All rights reserved. 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
+http://opensource.org/licenses/bsd-license.php\r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+-->\r
+<LibraryModuleSurfaceArea xmlns="http://www.TianoCore.org/2006/Edk2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.TianoCore.org/2006/Edk2.0 http://www.TianoCore.org/2006/Edk2.0/SurfaceArea.xsd">\r
+ <MsaLibHeader>\r
+ <BaseName>PeiDxePostCodeLibReportStatusCode</BaseName>\r
+ <ModuleType>PEIM</ModuleType>\r
+ <ComponentType>LIBRARY</ComponentType>\r
+ <Guid>55c61087-7367-4546-bc32-4937c5e6aff3</Guid>\r
+ <Version>0</Version>\r
+ <Abstract>Component description file for the entry point to a EFIDXE Drivers</Abstract>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 2004-2006, Intel Corporation</Copyright>\r
+ <License>\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ </License>\r
+ <Created>2006-03-09 23:16</Created>\r
+ <Updated>2006-03-19 15:17</Updated>\r
+ <Specification>0</Specification>\r
+ </MsaLibHeader>\r
+ <LibraryClassDefinitions>\r
+ <LibraryClass Usage="ALWAYS_PRODUCED">PostCodeLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">ReportStatusCodeLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">PcdLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">BaseLib</LibraryClass>\r
+ </LibraryClassDefinitions>\r
+ <SourceFiles>\r
+ <Filename>PostCode.c</Filename>\r
+ </SourceFiles>\r
+ <Includes>\r
+ <PackageName>MdePkg</PackageName>\r
+ </Includes>\r
+ <PcdCoded>\r
+ <PcdEntry PcdItemType="FIXED_AT_BUILD">\r
+ <C_Name>PcdPostCodePropertyMask</C_Name>\r
+ </PcdEntry>\r
+ </PcdCoded>\r
+</LibraryModuleSurfaceArea>\r
--- /dev/null
+/** @file\r
+ Report Status Code Library Post Code functions for DXE Phase.\r
+\r
+ Copyright (c) 2006, Intel Corporation<BR>\r
+ All rights reserved. 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
+ http://opensource.org/licenses/bsd-license.php \r
+\r
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+\r
+**/\r
+\r
+/**\r
+ Converts POST code value to status code value.\r
+\r
+ This macro converts the post code to status code value. Bits 0..4 of PostCode \r
+ are mapped to bits 16..20 of status code value, and bits 5..7 of PostCode are mapped to bits \r
+ 24..26 of status code value. \r
+\r
+ @param PostCode POST code value. \r
+\r
+ @return The converted status code value.\r
+\r
+**/\r
+#define POST_CODE_TO_STATUS_CODE_VALUE(PostCode) \\r
+ ((EFI_STATUS_CODE_VALUE) (((PostCode & 0x1f) << 16) | ((PostCode & 0x3) << 19)))\r
+\r
+/**\r
+ Sends an 32-bit value to a POST card.\r
+\r
+ Sends the 32-bit value specified by Value to a POST card, and returns Value. \r
+ Some implementations of this library function may perform I/O operations \r
+ directly to a POST card device. Other implementations may send Value to \r
+ ReportStatusCode(), and the status code reporting mechanism will eventually \r
+ display the 32-bit value on the status reporting device.\r
+ \r
+ PostCode() must actively prevent recursion. If PostCode() is called while \r
+ processing another any other Report Status Code Library function, then \r
+ PostCode() must return Value immediately.\r
+\r
+ @param Value The 32-bit value to write to the POST card.\r
+\r
+ @return Value\r
+\r
+**/\r
+UINT32\r
+EFIAPI\r
+PostCode (\r
+ IN UINT32 Value\r
+ )\r
+{\r
+ REPORT_STATUS_CODE (EFI_PROGRESS_CODE, POST_CODE_TO_STATUS_CODE_VALUE (Value));\r
+ return Value;\r
+}\r
+\r
+\r
+/**\r
+ Sends an 32-bit value to a POST and associated ASCII string.\r
+\r
+ Sends the 32-bit value specified by Value to a POST card, and returns Value.\r
+ If Description is not NULL, then the ASCII string specified by Description is \r
+ also passed to the handler that displays the POST card value. Some \r
+ implementations of this library function may perform I/O operations directly \r
+ to a POST card device. Other implementations may send Value to ReportStatusCode(), \r
+ and the status code reporting mechanism will eventually display the 32-bit \r
+ value on the status reporting device. \r
+\r
+ PostCodeWithDescription()must actively prevent recursion. If \r
+ PostCodeWithDescription() is called while processing another any other Report \r
+ Status Code Library function, then PostCodeWithDescription() must return Value \r
+ immediately.\r
+\r
+ @param Value The 32-bit value to write to the POST card.\r
+ @param Description Pointer to an ASCII string that is a description of the \r
+ POST code value. This is an optional parameter that may \r
+ be NULL.\r
+\r
+ @return Value\r
+\r
+**/\r
+UINT32\r
+EFIAPI\r
+PostCodeWithDescription (\r
+ IN UINT32 Value,\r
+ IN CONST CHAR8 *Description OPTIONAL\r
+ )\r
+{\r
+ if (Description == NULL) { \r
+ REPORT_STATUS_CODE (\r
+ EFI_PROGRESS_CODE,\r
+ POST_CODE_TO_STATUS_CODE_VALUE (Value)\r
+ );\r
+ } else {\r
+ REPORT_STATUS_CODE_WITH_EXTENDED_DATA (\r
+ EFI_PROGRESS_CODE,\r
+ POST_CODE_TO_STATUS_CODE_VALUE (Value),\r
+ Description,\r
+ AsciiStrSize (Description)\r
+ );\r
+ }\r
+\r
+ return Value;\r
+}\r
+\r
+\r
+/**\r
+ Returns TRUE if POST Codes are enabled.\r
+\r
+ This function returns TRUE if the POST_CODE_PROPERTY_POST_CODE_ENABLED \r
+ bit of PcdPostCodePropertyMask is set. Otherwise FALSE is returned.\r
+\r
+ @retval TRUE The POST_CODE_PROPERTY_POST_CODE_ENABLED bit of \r
+ PcdPostCodeProperyMask is set.\r
+ @retval FALSE The POST_CODE_PROPERTY_POST_CODE_ENABLED bit of \r
+ PcdPostCodeProperyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+PostCodeEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdPostCodePropertyMask) & POST_CODE_PROPERTY_POST_CODE_ENABLED) != 0);\r
+}\r
+\r
+\r
+/**\r
+ Returns TRUE if POST code descriptions are enabled.\r
+\r
+ This function returns TRUE if the \r
+ POST_CODE_PROPERTY_POST_CODE_ENABLED bit of \r
+ PcdPostCodePropertyMask is set. Otherwise FALSE is returned.\r
+\r
+ @retval TRUE The POST_CODE_PROPERTY_POST_CODE_ENABLED \r
+ bit of PcdPostCodeProperyMask is set.\r
+ @retval FALSE The POST_CODE_PROPERTY_POST_CODE_ENABLED \r
+ bit of PcdPostCodeProperyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+PostCodeDescriptionEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdPostCodePropertyMask) & POST_CODE_PROPERTY_POST_CODE_ENABLED) != 0);\r
+}\r
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?><!-- Copyright (c) 2006, Intel Corporation \r
+All rights reserved. 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
+http://opensource.org/licenses/bsd-license.php \r
+\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.-->\r
+<project basedir="." default="PeiDxePostCodeLibReportStatusCode"><!--Apply external ANT tasks-->\r
+ <taskdef resource="GenBuild.tasks"/>\r
+ <taskdef resource="net/sf/antcontrib/antlib.xml"/>\r
+ <property environment="env"/>\r
+ <property name="WORKSPACE_DIR" value="${env.WORKSPACE}"/>\r
+ <import file="${WORKSPACE_DIR}/Tools/Conf/BuildMacro.xml"/><!--MODULE_RELATIVE PATH is relative to PACKAGE_DIR-->\r
+ <property name="MODULE_RELATIVE_PATH" value="Library/PeiDxePostCodeLibReportStatusCode"/>\r
+ <property name="MODULE_DIR" value="${PACKAGE_DIR}/${MODULE_RELATIVE_PATH}"/>\r
+ <property name="COMMON_FILE" value="${WORKSPACE_DIR}/Tools/Conf/Common.xml"/>\r
+ <target name="PeiDxePostCodeLibReportStatusCode">\r
+ <GenBuild baseName="PeiDxePostCodeLibReportStatusCode" mbdFilename="${MODULE_DIR}/PeiDxePostCodeLibReportStatusCode.mbd" msaFilename="${MODULE_DIR}/PeiDxePostCodeLibReportStatusCode.msa"/>\r
+ </target>\r
+ <target depends="PeiDxePostCodeLibReportStatusCode_clean" name="clean"/>\r
+ <target depends="PeiDxePostCodeLibReportStatusCode_cleanall" name="cleanall"/>\r
+ <target name="PeiDxePostCodeLibReportStatusCode_clean">\r
+ <OutputDirSetup baseName="PeiDxePostCodeLibReportStatusCode" mbdFilename="${MODULE_DIR}/PeiDxePostCodeLibReportStatusCode.mbd" msaFilename="${MODULE_DIR}/PeiDxePostCodeLibReportStatusCode.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/PeiDxePostCodeLibReportStatusCode_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/PeiDxePostCodeLibReportStatusCode_build.xml" target="clean"/>\r
+ </then>\r
+ </if>\r
+ <delete dir="${DEST_DIR_OUTPUT}" excludes="*.xml"/>\r
+ </target>\r
+ <target name="PeiDxePostCodeLibReportStatusCode_cleanall">\r
+ <OutputDirSetup baseName="PeiDxePostCodeLibReportStatusCode" mbdFilename="${MODULE_DIR}/PeiDxePostCodeLibReportStatusCode.mbd" msaFilename="${MODULE_DIR}/PeiDxePostCodeLibReportStatusCode.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/PeiDxePostCodeLibReportStatusCode_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/PeiDxePostCodeLibReportStatusCode_build.xml" target="cleanall"/>\r
+ </then>\r
+ </if>\r
+ <delete dir="${DEST_DIR_OUTPUT}"/>\r
+ <delete dir="${DEST_DIR_DEBUG}"/>\r
+ <delete>\r
+ <fileset dir="${BIN_DIR}" includes="**PeiDxePostCodeLibReportStatusCode*"/>\r
+ </delete>\r
+ </target>\r
+</project>
\ No newline at end of file
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *Destination,\r
- IN CONST VOID *Source,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
- ASSERT (\r
- Destination == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Destination + 1\r
- );\r
- ASSERT (\r
- Source == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Source + 1\r
- );\r
- if (Destination == Source || Length == 0) {\r
- return Destination;\r
+ if (Length == 0) {\r
+ return DestinationBuffer;\r
+ }\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
+ if (DestinationBuffer == SourceBuffer) {\r
+ return DestinationBuffer;\r
}\r
- return InternalMemCopyMem (Destination, Source, Length);\r
+ return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
{\r
CONST UINT8 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT8*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT16 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT16*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT32 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT32*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT64 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT64*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
**/\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
)\r
{\r
WriteUnaligned64 (\r
}\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
)\r
{\r
return (BOOLEAN)(\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
)\r
{\r
CONST GUID *GuidPtr;\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
ASSERT (Buffer != NULL);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
}\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
if (Length == 0) {\r
VOID *\r
EFIAPI\r
SetMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
-\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
)\r
{\r
ASSERT (!(Buffer == NULL && Length > 0));\r
**/\r
EFI_STATUS\r
EFIAPI\r
-PeiServicesReinstallPpi (\r
+PeiServicesReInstallPpi (\r
IN EFI_PEI_PPI_DESCRIPTOR *OldPpi,\r
IN EFI_PEI_PPI_DESCRIPTOR *NewPpi\r
)\r
INTN\r
EFIAPI\r
CompareMem (\r
- IN CONST VOID *DestinationBuffer,\r
- IN CONST VOID *SourceBuffer,\r
- IN UINTN Length\r
+ IN CONST VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Copy Length bytes from Source to Destination.\r
+ Copies a source buffer to a destination buffer, and returns the destination buffer.\r
\r
- This function copies Length bytes from SourceBuffer to DestinationBuffer, and\r
- returns DestinationBuffer. The implementation must be reentrant, and it must\r
- handle the case where SourceBuffer overlaps DestinationBuffer.\r
+ This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns\r
+ DestinationBuffer. The implementation must be reentrant, and it must handle the case\r
+ where SourceBuffer overlaps DestinationBuffer.\r
+ If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT(). \r
+ If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT(). \r
\r
- If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then\r
- ASSERT().\r
- If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().\r
+ @param DestinationBuffer Pointer to the destination buffer of the memory copy.\r
+ @param SourceBuffer Pointer to the source buffer of the memory copy.\r
+ @param Length Number of bytes to copy from SourceBuffer to DestinationBuffer.\r
\r
- @param Destination Target of copy\r
- @param Source Place to copy from\r
- @param Length Number of bytes to copy\r
-\r
- @return Destination\r
+ @return DestinationBuffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
CopyMem (\r
- OUT VOID *Destination,\r
- IN CONST VOID *Source,\r
- IN UINTN Length\r
+ OUT VOID *DestinationBuffer,\r
+ IN CONST VOID *SourceBuffer,\r
+ IN UINTN Length\r
)\r
{\r
- ASSERT (\r
- Destination == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Destination + 1\r
- );\r
- ASSERT (\r
- Source == NULL ||\r
- Length <= MAX_ADDRESS - (UINTN)Source + 1\r
- );\r
- if (Destination == Source || Length == 0) {\r
- return Destination;\r
+ if (Length == 0) {\r
+ return DestinationBuffer;\r
+ }\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
+ if (DestinationBuffer == SourceBuffer) {\r
+ return DestinationBuffer;\r
}\r
- return InternalMemCopyMem (Destination, Source, Length);\r
+ return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
{\r
CONST UINT8 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT8*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT16 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT16*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT32 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT32*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
{\r
CONST UINT64 *Pointer;\r
\r
- ASSERT (Length > 0);\r
Pointer = (CONST UINT64*)Buffer;\r
do {\r
if (*(Pointer++) == Value) {\r
**/\r
\r
/**\r
- This function copies a source GUID to a destination GUID.\r
-\r
- This function copies the contents of the 128-bit GUID specified by SourceGuid\r
- to DestinationGuid, and returns DestinationGuid.\r
+ Copies a source GUID to a destination GUID.\r
\r
+ This function copies the contents of the 128-bit GUID specified by SourceGuid to\r
+ DestinationGuid, and returns DestinationGuid.\r
If DestinationGuid is NULL, then ASSERT().\r
If SourceGuid is NULL, then ASSERT().\r
\r
- @param DestinationGuid Pointer to the destination GUID.\r
- @param SourceGuid Pointer to the source GUID.\r
+ @param DestinationGuid Pointer to the destination GUID.\r
+ @param SourceGuid Pointer to the source GUID.\r
\r
- @return DestinationGuid\r
+ @return DestinationGuid.\r
\r
**/\r
GUID *\r
EFIAPI\r
CopyGuid (\r
- OUT GUID *DestinationGuid,\r
- IN CONST GUID *SourceGuid\r
+ OUT GUID *DestinationGuid,\r
+ IN CONST GUID *SourceGuid\r
)\r
{\r
WriteUnaligned64 (\r
}\r
\r
/**\r
- Compares two GUIDs\r
-\r
- This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE\r
- is returned. If there are any bit differences in the two GUIDs, then FALSE is\r
- returned.\r
+ Compares two GUIDs.\r
\r
+ This function compares Guid1 to Guid2. If the GUIDs are identical then TRUE is returned.\r
+ If there are any bit differences in the two GUIDs, then FALSE is returned.\r
If Guid1 is NULL, then ASSERT().\r
If Guid2 is NULL, then ASSERT().\r
\r
- @param Guid1 guid to compare\r
- @param Guid2 guid to compare\r
+ @param Guid1 A pointer to a 128 bit GUID.\r
+ @param Guid2 A pointer to a 128 bit GUID.\r
\r
- @retval TRUE if Guid1 == Guid2\r
- @retval FALSE if Guid1 != Guid2\r
+ @retval TRUE Guid1 and Guid2 are identical.\r
+ @retval FALSE Guid1 and Guid2 are not identical.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
CompareGuid (\r
- IN CONST GUID *Guid1,\r
- IN CONST GUID *Guid2\r
+ IN CONST GUID *Guid1,\r
+ IN CONST GUID *Guid2\r
)\r
{\r
return (BOOLEAN)(\r
in the target buffer.\r
\r
This function searches target the buffer specified by Buffer and Length from\r
- the lowest address to the highest address at 128-bit increments for the\r
- 128-bit GUID value that matches Guid. If a match is found, then a pointer to\r
- the matching GUID in the target buffer is returned. If no match is found,\r
- then NULL is returned. If Length is 0, then NULL is returned.\r
-\r
- If Buffer is NULL, then ASSERT().\r
+ the lowest address to the highest address at 128-bit increments for the 128-bit\r
+ GUID value that matches Guid. If a match is found, then a pointer to the matching\r
+ GUID in the target buffer is returned. If no match is found, then NULL is returned.\r
+ If Length is 0, then NULL is returned.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
@param Buffer Pointer to the target buffer to scan.\r
@param Length Number of bytes in Buffer to scan.\r
@param Guid Value to search for in the target buffer.\r
\r
- @return Pointer to the first occurrence.\r
- @retval NULL if Length == 0 or Guid was not found.\r
+ @return A pointer to the matching Guid in the target buffer or NULL otherwise.\r
+\r
**/\r
VOID *\r
EFIAPI\r
ScanGuid (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN CONST GUID *Guid\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN CONST GUID *Guid\r
)\r
{\r
CONST GUID *GuidPtr;\r
VOID *\r
EFIAPI\r
ScanMem16 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem32 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem64 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
- if (Length == 0) {\r
+ UINTN Stride;\r
+ \r
+ Stride = Length / sizeof (Value);\r
+ if (Stride == 0) {\r
return NULL;\r
}\r
\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Stride, Value);\r
}\r
VOID *\r
EFIAPI\r
ScanMem8 (\r
- IN CONST VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ IN CONST VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
ASSERT (Buffer != NULL);\r
ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
}\r
Value, and returns Buffer. Value is repeated every 16-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
If Length is not aligned on a 16-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem16 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT16 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT16 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 32-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
If Length is not aligned on a 32-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem32 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT32 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT32 Value\r
)\r
{\r
if (Length == 0) {\r
Value, and returns Buffer. Value is repeated every 64-bits in for Length\r
bytes of Buffer.\r
\r
- If Length > 0 and Buffer is NULL and Length > 0, then ASSERT().\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
If Length is not aligned on a 64-bit boundary, then ASSERT().\r
@param Length Number of bytes in Buffer to fill.\r
@param Value Value with which to fill Length bytes of Buffer.\r
\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
SetMem64 (\r
- OUT VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT64 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT64 Value\r
)\r
{\r
if (Length == 0) {\r
VOID *\r
EFIAPI\r
SetMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length,\r
- IN UINT8 Value\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length,\r
+ IN UINT8 Value\r
)\r
{\r
if (Length == 0) {\r
#include "MemLibInternals.h"\r
\r
/**\r
- Set Buffer to 0 for Size bytes.\r
+ Fills a target buffer with zeros, and returns the target buffer.\r
\r
This function fills Length bytes of Buffer with zeros, and returns Buffer.\r
+ If Length > 0 and Buffer is NULL, then ASSERT().\r
+ If Length is greater than (MAX_ADDRESS \96 Buffer + 1), then ASSERT(). \r
\r
- If Buffer is NULL and Length > 0, then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
+ @param Buffer Pointer to the target buffer to fill with zeros.\r
+ @param Length Number of bytes in Buffer to fill with zeros.\r
\r
- @param Buffer Memory to set.\r
- @param Size Number of bytes to set\r
-\r
- @return Buffer\r
+ @return Buffer.\r
\r
**/\r
VOID *\r
EFIAPI\r
ZeroMem (\r
- IN VOID *Buffer,\r
- IN UINTN Length\r
+ OUT VOID *Buffer,\r
+ IN UINTN Length\r
)\r
{\r
ASSERT (!(Buffer == NULL && Length > 0));\r
\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiServicesTablePointerLibMm7" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiReportStatusCodeLib" />\r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" />\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiCoreEntryPoint" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeimEntryPoint" />\r
\r
\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibPort80" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibDebug" />\r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" />\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" />\r
\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="UefiDriverEntryPoint" />\r
\r
\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiServicesTablePointerLibMm7" />\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiReportStatusCodeLib" />\r
- <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" />\r
+ <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" />\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiCoreEntryPoint" />\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeimEntryPoint" />\r
\r
\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="BasePostCodeLibPort80" />\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="BasePostCodeLibDebug" />\r
- <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" />\r
+ <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" />\r
\r
<ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="DxeSmmDriverEntryPoint" />\r
\r
\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiServicesTablePointerLibMm7" />\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiReportStatusCodeLib" />\r
- <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" />\r
+ <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" />\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiCoreEntryPoint" />\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeimEntryPoint" />\r
\r
\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="BasePostCodeLibPort80" />\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="BasePostCodeLibDebug" />\r
- <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" />\r
+ <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" />\r
\r
<ModuleSA Arch="X64" FvBinding="NULL" ModuleName="UefiDriverEntryPoint" />\r
\r
\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiServicesTablePointerLibMm7" />\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiReportStatusCodeLib" />\r
- <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" />\r
+ <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" />\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiCoreEntryPoint" />\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeimEntryPoint" />\r
\r
\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="BasePostCodeLibPort80" />\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="BasePostCodeLibDebug" />\r
- <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" />\r
+ <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" />\r
\r
<ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="DxeSmmDriverEntryPoint" />\r
\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA> \r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" >\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdDebugPropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA>\r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" >\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdPostCodePropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA> \r
- <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" >\r
+ <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdDebugPropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA>\r
- <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" >\r
+ <ModuleSA Arch="IPF" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdPostCodePropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA> \r
- <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" >\r
+ <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdDebugPropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA>\r
- <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" >\r
+ <ModuleSA Arch="X64" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdPostCodePropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA> \r
- <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" >\r
+ <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdDebugPropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA>\r
- <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" >\r
+ <ModuleSA Arch="EBC" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdPostCodePropertyMask</C_Name>\r
\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiServicesTablePointerLibMm7" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiReportStatusCodeLib" />\r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" />\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiCoreEntryPoint" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeimEntryPoint" />\r
\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BaseReportStatusCodeLibNull" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibPort80" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibDebug" />\r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" />\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" />\r
\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="UefiDriverEntryPoint" />\r
<ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="DxeSmmDriverEntryPoint" />\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA> \r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BaseDebugLibReportStatusCode" >\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxeDebugLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdDebugPropertyMask</C_Name>\r
</PcdData>\r
</PcdBuildDefinition>\r
</ModuleSA>\r
- <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="BasePostCodeLibReportStatusCode" >\r
+ <ModuleSA Arch="IA32" FvBinding="NULL" ModuleName="PeiDxePostCodeLibReportStatusCode" >\r
<PcdBuildDefinition>\r
<PcdData ItemType="FIXED_AT_BUILD">\r
<C_Name>PcdPostCodePropertyMask</C_Name>\r
<Filename>Library/BaseDebugLibNull/BaseDebugLibNull.msa</Filename>\r
</MsaFile>\r
<MsaFile>\r
- <Filename>Library/BaseDebugLibReportStatusCode/BaseDebugLibReportStatusCode.msa</Filename>\r
+ <Filename>Library/PeiDxeDebugLibReportStatusCode/PeiDxeDebugLibReportStatusCode.msa</Filename>\r
</MsaFile>\r
<MsaFile>\r
<Filename>Library/BasePerformanceLibNull/BasePerformanceLibNull.msa</Filename>\r
<Filename>Library/BasePostCodeLibDebug/BasePostCodeLibDebug.msa</Filename>\r
</MsaFile>\r
<MsaFile>\r
- <Filename>Library/BasePostCodeLibReportStatusCode/BasePostCodeLibReportStatusCode.msa</Filename>\r
+ <Filename>Library/PeiDxePostCodeLibReportStatusCode/PeiDxePostCodeLibReportStatusCode.msa</Filename>\r
</MsaFile>\r
<MsaFile>\r
<Filename>Library/BaseSmbusLib/BaseSmbusLib.msa</Filename>\r
projects / mirror_edk2.git / commitdiff