&InquiryDataLength,\r
FALSE\r
);\r
- switch (Status) {\r
- //\r
- // no need to check HostAdapterStatus and TargetStatus\r
- //\r
- case EFI_SUCCESS:\r
- case EFI_WARN_BUFFER_TOO_SMALL:\r
+ if ((Status == EFI_SUCCESS) || (Status == EFI_WARN_BUFFER_TOO_SMALL)) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
ParseInquiryData (ScsiDiskDevice);\r
return EFI_SUCCESS;\r
-\r
- case EFI_NOT_READY:\r
+ } else if (Status == EFI_NOT_READY) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_INVALID_PARAMETER:\r
- case EFI_UNSUPPORTED:\r
+ } else if ((Status == EFI_INVALID_PARAMETER) || (Status == EFI_UNSUPPORTED)) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
*NeedRetry = FALSE;\r
return EFI_DEVICE_ERROR;\r
-\r
+ }\r
//\r
// go ahead to check HostAdapterStatus and TargetStatus\r
// (EFI_TIMEOUT, EFI_DEVICE_ERROR)\r
//\r
- default:\r
- break;\r
- }\r
-\r
Status = CheckHostAdapterStatus (HostAdapterStatus);\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_TIMEOUT:\r
- case EFI_NOT_READY:\r
+ if ((Status == EFI_TIMEOUT) || (Status == EFI_NOT_READY)) {\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
//\r
// reset the scsi channel\r
//\r
}\r
\r
Status = CheckTargetStatus (TargetStatus);\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_NOT_READY:\r
+ if (Status == EFI_NOT_READY) {\r
//\r
// reset the scsi device\r
//\r
ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
*NeedRetry = FALSE;\r
return EFI_DEVICE_ERROR;\r
}\r
&HostAdapterStatus,\r
&TargetStatus\r
);\r
- switch (Status) {\r
- //\r
- // no need to check HostAdapterStatus and TargetStatus\r
- //\r
- case EFI_NOT_READY:\r
+ if (Status == EFI_NOT_READY) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_INVALID_PARAMETER:\r
- case EFI_UNSUPPORTED:\r
+ } else if ((Status == EFI_INVALID_PARAMETER) || (Status == EFI_UNSUPPORTED)) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
*NeedRetry = FALSE;\r
return EFI_DEVICE_ERROR;\r
-\r
+ }\r
//\r
// go ahead to check HostAdapterStatus and TargetStatus\r
//\r
- default:\r
- break;\r
- }\r
-\r
Status = CheckHostAdapterStatus (HostAdapterStatus);\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_TIMEOUT:\r
- case EFI_NOT_READY:\r
+ if ((Status == EFI_TIMEOUT) || (Status == EFI_NOT_READY)) {\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
//\r
// reset the scsi channel\r
//\r
}\r
\r
Status = CheckTargetStatus (TargetStatus);\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_NOT_READY:\r
+ if (Status == EFI_NOT_READY) {\r
//\r
// reset the scsi device\r
//\r
ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
*NeedRetry = FALSE;\r
return EFI_DEVICE_ERROR;\r
}\r
&DataLength,\r
FALSE\r
);\r
- switch (CommandStatus) {\r
- //\r
- // no need to check HostAdapterStatus and TargetStatus\r
- //\r
- case EFI_SUCCESS:\r
+ if (CommandStatus == EFI_SUCCESS) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
GetMediaInfo (ScsiDiskDevice, &CapacityData);\r
return EFI_SUCCESS;\r
-\r
- case EFI_NOT_READY:\r
+ } else if (CommandStatus == EFI_NOT_READY) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_INVALID_PARAMETER:\r
- case EFI_UNSUPPORTED:\r
+ } else if ((CommandStatus == EFI_INVALID_PARAMETER) || (CommandStatus == EFI_UNSUPPORTED)) {\r
+ //\r
+ // no need to check HostAdapterStatus and TargetStatus\r
+ //\r
*NeedRetry = FALSE;\r
return EFI_DEVICE_ERROR;\r
-\r
+ }\r
//\r
// go ahead to check HostAdapterStatus and TargetStatus\r
// (EFI_TIMEOUT, EFI_DEVICE_ERROR, EFI_WARN_BUFFER_TOO_SMALL)\r
//\r
- default:\r
- break;\r
- }\r
-\r
+ \r
Status = CheckHostAdapterStatus (HostAdapterStatus);\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_TIMEOUT:\r
- case EFI_NOT_READY:\r
+ if ((Status == EFI_TIMEOUT) || (Status == EFI_NOT_READY)) {\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
//\r
// reset the scsi channel\r
//\r
}\r
\r
Status = CheckTargetStatus (TargetStatus);\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_NOT_READY:\r
+ if (Status == EFI_NOT_READY) {\r
//\r
// reset the scsi device\r
//\r
ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);\r
*NeedRetry = TRUE;\r
return EFI_DEVICE_ERROR;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
*NeedRetry = FALSE;\r
return EFI_DEVICE_ERROR;\r
}\r
&HostAdapterStatus,\r
&TargetStatus\r
);\r
- switch (Status) {\r
-\r
- case EFI_SUCCESS:\r
-\r
- //\r
- // fall through\r
- //\r
- case EFI_WARN_BUFFER_TOO_SMALL:\r
+ if ((Status == EFI_SUCCESS) || (Status == EFI_WARN_BUFFER_TOO_SMALL)) {\r
FallStatus = EFI_SUCCESS;\r
- break;\r
-\r
- case EFI_TIMEOUT:\r
-\r
- //\r
- // fall through\r
- //\r
- case EFI_NOT_READY:\r
+ } else if ((Status == EFI_TIMEOUT) || (Status == EFI_NOT_READY)) { \r
*NeedRetry = TRUE;\r
FallStatus = EFI_DEVICE_ERROR;\r
- break;\r
-\r
- case EFI_INVALID_PARAMETER:\r
- case EFI_UNSUPPORTED:\r
+ } else if ((Status == EFI_INVALID_PARAMETER) || (Status == EFI_UNSUPPORTED)) {\r
*NeedRetry = FALSE;\r
FallStatus = EFI_DEVICE_ERROR;\r
- break;\r
-\r
- case EFI_DEVICE_ERROR:\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
if (AskResetIfError) {\r
ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);\r
}\r
\r
FallStatus = EFI_DEVICE_ERROR;\r
- break;\r
}\r
\r
if (EFI_ERROR (FallStatus)) {\r
//\r
// Add code to correctly handle expected errors from CoreLocateHandle().\r
//\r
- if (EFI_ERROR(Status)) {\r
- switch (Status) {\r
- case EFI_BUFFER_TOO_SMALL:\r
- break;\r
- case EFI_INVALID_PARAMETER:\r
- return Status;\r
- default:\r
- return EFI_NOT_FOUND;\r
+ if (EFI_ERROR(Status) && Status != EFI_BUFFER_TOO_SMALL) {\r
+ if (Status != EFI_INVALID_PARAMETER) {\r
+ Status = EFI_NOT_FOUND;\r
}\r
+ return Status;\r
}\r
\r
*Buffer = CoreAllocateBootServicesPool (BufferSize);\r
// Check if the total number of PEIMs exceed the bitmap.\r
// CurrentPeim is 0-based\r
//\r
- DEBUG_CODE (\r
- if (CurrentPeim > (sizeof (*DispatchedPeimBitMap) * 8 - 1)) {\r
- ASSERT_EFI_ERROR (EFI_OUT_OF_RESOURCES);\r
- }\r
- );\r
-\r
+ ASSERT (CurrentPeim < (sizeof (*DispatchedPeimBitMap) * 8));\r
*DispatchedPeimBitMap |= (1 << CurrentPeim);\r
return;\r
}\r
<Filename>Library/EdkDxePeCoffLoaderFromHobLib/EdkDxePeCoffLoaderFromHobLib.msa</Filename>
</MsaFile>
<MsaFile>
- <Filename>Library/EdkDxePerformanceLib/EdkDxePerformanceLib.msa</Filename>
+ <Filename>Library/DxePerformanceLib/DxePerformanceLib.msa</Filename>
</MsaFile>
<MsaFile>
<Filename>Library/EdkDxePrintLib/EdkDxePrintLib.msa</Filename>
<Filename>Library/EdkPeCoffLoaderX64Lib/EdkPeCoffLoaderX64Lib.msa</Filename>
</MsaFile>
<MsaFile>
- <Filename>Library/EdkPeiPerformanceLib/EdkPeiPerformanceLib.msa</Filename>
+ <Filename>Library/PeiPerformanceLib/PeiPerformanceLib.msa</Filename>
</MsaFile>
<MsaFile>
<Filename>Library/EdkRuntimeStatusCodeLib/BsDataHubStatusCode/BsDataHubStatusCode.msa</Filename>
}\r
\r
/**\r
- Retrieves a previously logged performance measurement. \r
+ Attempts to retrieve a performance measurement log entry from the performance measurement log. \r
\r
- Retrieves the performance log entry from the performance log\r
- that immediately follows the log entry specified by LogEntryKey.\r
- If LogEntryKey is zero, then the first entry from the performance log is returned.\r
- If the log entry specified by LogEntryKey is the last entry in the performance log,\r
- then 0 is returned. Otherwise, the performance log entry is returned in Handle,\r
- Token, Module, StartTimeStamp, and EndTimeStamp.\r
- The key for the current performance log entry is returned. \r
-\r
- @param LogEntryKey The key for the previous performance measurement log entry.\r
- If 0, then the first performance measurement log entry is retrieved.\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
- that identifies the component being measured.\r
- @param Module Pointer to a Null-terminated ASCII string\r
- that identifies the module being measured.\r
- @param StartTimeStamp The 64-bit time stamp that was recorded when the measurement was started.\r
- @param EndTimeStamp The 64-bit time stamp that was recorded when the measurement was ended.\r
-\r
- @return The key for the current performance log entry.\r
+ Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is\r
+ zero on entry, then an attempt is made to retrieve the first entry from the performance log,\r
+ and the key for the second entry in the log is returned. If the performance log is empty,\r
+ then no entry is retrieved and zero is returned. If LogEntryKey is not zero, then the performance\r
+ log entry associated with LogEntryKey is retrieved, and the key for the next entry in the log is\r
+ returned. If LogEntryKey is the key for the last entry in the log, then the last log entry is\r
+ retrieved and an implementation specific non-zero key value that specifies the end of the performance\r
+ log is returned. If LogEntryKey is equal this implementation specific non-zero key value, then no entry\r
+ is retrieved and zero is returned. In the cases where a performance log entry can be returned,\r
+ the log entry is returned in Handle, Token, Module, StartTimeStamp, and EndTimeStamp.\r
+ If LogEntryKey is not a valid log entry key for the performance measurement log, then ASSERT().\r
+ If Handle is NULL, then ASSERT().\r
+ If Token is NULL, then ASSERT().\r
+ If Module is NULL, then ASSERT().\r
+ If StartTimeStamp is NULL, then ASSERT().\r
+ If EndTimeStamp is NULL, then ASSERT().\r
+\r
+ @param LogEntryKey On entry, the key of the performance measurement log entry to retrieve.\r
+ 0, then the first performance measurement log entry is retrieved.\r
+ On exit, the key of the next performance lof entry entry.\r
+ @param Handle Pointer to environment specific context used to identify the component\r
+ being measured. \r
+ @param Token Pointer to a Null-terminated ASCII string that identifies the component\r
+ being measured. \r
+ @param Module Pointer to a Null-terminated ASCII string that identifies the module\r
+ being measured.\r
+ @param StartTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was started.\r
+ @param EndTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was ended.\r
+\r
+ @return The key for the next performance log entry (in general case).\r
\r
**/\r
UINTN\r
EFIAPI\r
GetPerformanceMeasurement (\r
- UINTN LogEntryKey, \r
+ IN UINTN LogEntryKey, \r
OUT CONST VOID **Handle,\r
OUT CONST CHAR8 **Token,\r
OUT CONST CHAR8 **Module,\r
--- /dev/null
+/*++\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
+Module Name:\r
+\r
+ DxePerformanceLib.c\r
+\r
+Abstract:\r
+\r
+ Performance Library\r
+\r
+--*/\r
+\r
+STATIC PERFORMANCE_PROTOCOL *mPerformance = NULL;\r
+\r
+/**\r
+ The constructor function caches the pointer to Performance protocol.\r
+ \r
+ The constructor function locates Performance protocol from protocol database.\r
+ It will ASSERT() if that operation fails and it will always return EFI_SUCCESS. \r
+\r
+ @param ImageHandle The firmware allocated handle for the EFI image.\r
+ @param SystemTable A pointer to the EFI System Table.\r
+ \r
+ @retval EFI_SUCCESS The constructor always returns EFI_SUCCESS.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+PerformanceLibConstructor (\r
+ IN EFI_HANDLE ImageHandle,\r
+ IN EFI_SYSTEM_TABLE *SystemTable\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+\r
+ Status = gBS->LocateProtocol (&gPerformanceProtocolGuid, NULL, (VOID **) &mPerformance);\r
+ ASSERT_EFI_ERROR (Status);\r
+ ASSERT (mPerformance != NULL);\r
+\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Creates a record for the beginning of a performance measurement. \r
+ \r
+ Creates a record that contains the Handle, Token, and Module.\r
+ If TimeStamp is not zero, then TimeStamp is added to the record as the start time.\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
+ to identify the component being measured.\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
+ that identifies the module being measured.\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
+\r
+**/\r
+RETURN_STATUS\r
+EFIAPI\r
+StartPerformanceMeasurement (\r
+ IN CONST VOID *Handle, OPTIONAL\r
+ IN CONST CHAR8 *Token, OPTIONAL\r
+ IN CONST CHAR8 *Module, OPTIONAL\r
+ IN UINT64 TimeStamp\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ \r
+ Status = mPerformance->StartGauge (Handle, Token, Module, TimeStamp);\r
+\r
+ return (RETURN_STATUS) Status;\r
+}\r
+\r
+/**\r
+ Fills in the end time of a performance measurement. \r
+ \r
+ Looks up the record that matches Handle, Token, and Module.\r
+ If the record can not be found then return RETURN_NOT_FOUND.\r
+ If the record is found and TimeStamp is not zero,\r
+ then TimeStamp is added to the record as the end time.\r
+ If the record is found and TimeStamp is zero, then this function reads\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
+ to identify the component being measured.\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
+ that identifies the module being measured.\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
+\r
+**/\r
+RETURN_STATUS\r
+EFIAPI\r
+EndPerformanceMeasurement (\r
+ IN CONST VOID *Handle, OPTIONAL\r
+ IN CONST CHAR8 *Token, OPTIONAL\r
+ IN CONST CHAR8 *Module, OPTIONAL\r
+ IN UINT64 TimeStamp\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+\r
+ Status = mPerformance->EndGauge (Handle, Token, Module, TimeStamp);\r
+\r
+ return (RETURN_STATUS) Status;\r
+}\r
+\r
+/**\r
+ Attempts to retrieve a performance measurement log entry from the performance measurement log. \r
+ \r
+ Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is\r
+ zero on entry, then an attempt is made to retrieve the first entry from the performance log,\r
+ and the key for the second entry in the log is returned. If the performance log is empty,\r
+ then no entry is retrieved and zero is returned. If LogEntryKey is not zero, then the performance\r
+ log entry associated with LogEntryKey is retrieved, and the key for the next entry in the log is\r
+ returned. If LogEntryKey is the key for the last entry in the log, then the last log entry is\r
+ retrieved and an implementation specific non-zero key value that specifies the end of the performance\r
+ log is returned. If LogEntryKey is equal this implementation specific non-zero key value, then no entry\r
+ is retrieved and zero is returned. In the cases where a performance log entry can be returned,\r
+ the log entry is returned in Handle, Token, Module, StartTimeStamp, and EndTimeStamp.\r
+ If LogEntryKey is not a valid log entry key for the performance measurement log, then ASSERT().\r
+ If Handle is NULL, then ASSERT().\r
+ If Token is NULL, then ASSERT().\r
+ If Module is NULL, then ASSERT().\r
+ If StartTimeStamp is NULL, then ASSERT().\r
+ If EndTimeStamp is NULL, then ASSERT().\r
+\r
+ @param LogEntryKey On entry, the key of the performance measurement log entry to retrieve.\r
+ 0, then the first performance measurement log entry is retrieved.\r
+ On exit, the key of the next performance lof entry entry.\r
+ @param Handle Pointer to environment specific context used to identify the component\r
+ being measured. \r
+ @param Token Pointer to a Null-terminated ASCII string that identifies the component\r
+ being measured. \r
+ @param Module Pointer to a Null-terminated ASCII string that identifies the module\r
+ being measured.\r
+ @param StartTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was started.\r
+ @param EndTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was ended.\r
+\r
+ @return The key for the next performance log entry (in general case).\r
+\r
+**/\r
+UINTN\r
+EFIAPI\r
+GetPerformanceMeasurement (\r
+ IN UINTN LogEntryKey, \r
+ OUT CONST VOID **Handle,\r
+ OUT CONST CHAR8 **Token,\r
+ OUT CONST CHAR8 **Module,\r
+ OUT UINT64 *StartTimeStamp,\r
+ OUT UINT64 *EndTimeStamp\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ GAUGE_DATA_ENTRY *GaugeData;\r
+\r
+ ASSERT (Handle != NULL);\r
+ ASSERT (Token != NULL);\r
+ ASSERT (Module != NULL);\r
+ ASSERT (StartTimeStamp != NULL);\r
+ ASSERT (EndTimeStamp != NULL);\r
+\r
+ Status = mPerformance->GetGauge (LogEntryKey++, &GaugeData);\r
+ \r
+ //\r
+ // Make sure that LogEntryKey is a valid log entry key,\r
+ //\r
+ ASSERT (Status != EFI_INVALID_PARAMETER);\r
+\r
+ if (EFI_ERROR (Status)) {\r
+ //\r
+ // The LogEntryKey is the last entry (equals to the total entry number).\r
+ //\r
+ return 0;\r
+ }\r
+\r
+ ASSERT (GaugeData != NULL);\r
+\r
+ *Handle = (VOID *) (UINTN) GaugeData->Handle;\r
+ *Token = GaugeData->Token;\r
+ *Module = GaugeData->Module;\r
+ *StartTimeStamp = GaugeData->StartTimeStamp;\r
+ *EndTimeStamp = GaugeData->EndTimeStamp;\r
+\r
+ return LogEntryKey; \r
+}\r
+\r
+/**\r
+ Returns TRUE if the performance measurement macros are enabled. \r
+ \r
+ This function returns TRUE if the PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_ENABLED bit of\r
+ PcdPerformanceLibraryPropertyMask is set. Otherwise FALSE is returned.\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
+ PcdPerformanceLibraryPropertyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+PerformanceMeasurementEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdPerformanceLibraryPropertyMask) & PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_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>DxePerformanceLib</BaseName>\r
+ <Guid>8B8B4CCC-65FC-41a5-8067-308B8E42CCF2</Guid>\r
+ <Version>EDK_RELEASE_VERSION 0x00020000</Version>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 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-04-04 11:11</Created>\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>DxePerformanceLib</BaseName>\r
+ <ModuleType>DXE_DRIVER</ModuleType>\r
+ <ComponentType>LIBRARY</ComponentType>\r
+ <Guid>8B8B4CCC-65FC-41a5-8067-308B8E42CCF2</Guid>\r
+ <Version>EDK_RELEASE_VERSION 0x00020000</Version>\r
+ <Abstract>Memory-only library functions with no library constructor/destructor</Abstract>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 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-04-04 11:11</Created>\r
+ <Specification>EFI_SPECIFICATION_VERSION 0x00000000</Specification>\r
+ </MsaLibHeader>\r
+ <LibraryClassDefinitions>\r
+ <LibraryClass Usage="ALWAYS_PRODUCED">PerformanceLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">DebugLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">UefiBootServicesTableLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">TimerLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">PcdLib</LibraryClass>\r
+ </LibraryClassDefinitions>\r
+ <SourceFiles>\r
+ <Filename>DxePerformanceLib.c</Filename>\r
+ </SourceFiles>\r
+ <Includes>\r
+ <PackageName>MdePkg</PackageName>\r
+ <PackageName>EdkModulePkg</PackageName>\r
+ </Includes>\r
+ <Protocols>\r
+ <Protocol Usage="ALWAYS_CONSUMED">Performance</Protocol>\r
+ </Protocols>\r
+ <Externs>\r
+ <Extern>\r
+ <Constructor>PerformanceLibConstructor</Constructor>\r
+ </Extern>\r
+ </Externs>\r
+ <PcdCoded>\r
+ <PcdEntry PcdItemType="FIXED_AT_BUILD">\r
+ <C_Name>PcdPerformanceLibraryPropertyMask</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="DxePerformanceLib"><!--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/DxePerformanceLib"/>\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="DxePerformanceLib">\r
+ <GenBuild baseName="DxePerformanceLib" mbdFilename="${MODULE_DIR}/DxePerformanceLib.mbd" msaFilename="${MODULE_DIR}/DxePerformanceLib.msa"/>\r
+ </target>\r
+ <target depends="DxePerformanceLib_clean" name="clean"/>\r
+ <target depends="DxePerformanceLib_cleanall" name="cleanall"/>\r
+ <target name="DxePerformanceLib_clean">\r
+ <OutputDirSetup baseName="DxePerformanceLib" mbdFilename="${MODULE_DIR}/DxePerformanceLib.mbd" msaFilename="${MODULE_DIR}/DxePerformanceLib.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/DxePerformanceLib_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/DxePerformanceLib_build.xml" target="clean"/>\r
+ </then>\r
+ </if>\r
+ <delete dir="${DEST_DIR_OUTPUT}" excludes="*.xml"/>\r
+ </target>\r
+ <target name="DxePerformanceLib_cleanall">\r
+ <OutputDirSetup baseName="DxePerformanceLib" mbdFilename="${MODULE_DIR}/DxePerformanceLib.mbd" msaFilename="${MODULE_DIR}/DxePerformanceLib.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/DxePerformanceLib_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/DxePerformanceLib_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="**DxePerformanceLib*"/>\r
+ </delete>\r
+ </target>\r
+</project>
\ No newline at end of file
--- /dev/null
+/*++\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
+Module Name:\r
+\r
+ PeiPerformanceLib.c\r
+\r
+Abstract:\r
+\r
+ Performance Library\r
+\r
+--*/\r
+\r
+/**\r
+ Gets PEI the GUID HOB for PEI performance.\r
+\r
+ This internal function searches for the GUID HOB for PEI performance.\r
+ If that GUID HOB is not found, it will build a new one.\r
+ It returns the data area of that GUID HOB to record performance log. \r
+\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
+ that identifies the component being measured.\r
+ @param Module Pointer to a Null-terminated ASCII string\r
+ that identifies the module being measured.\r
+\r
+ @retval The index of log entry in the array.\r
+\r
+**/\r
+PEI_PERFORMANCE_LOG_HEADER *\r
+InternalGetPerformanceHobLog (\r
+ VOID\r
+ )\r
+{\r
+ EFI_HOB_GUID_TYPE *GuidHob;\r
+ PEI_PERFORMANCE_LOG_HEADER *PeiPerformanceLog;\r
+ UINTN PeiPerformanceLogSize;\r
+\r
+ GuidHob = GetFirstGuidHob (&gPeiPerformanceHobGuid);\r
+ \r
+ if (GuidHob != NULL) {\r
+ //\r
+ // PEI Performance HOB was found, then return the existing one.\r
+ //\r
+ PeiPerformanceLog = GET_GUID_HOB_DATA (GuidHob);\r
+ } else {\r
+ //\r
+ // PEI Performance HOB was not found, then build one.\r
+ //\r
+ PeiPerformanceLogSize = sizeof (PEI_PERFORMANCE_LOG_HEADER) + \r
+ sizeof (PEI_PERFORMANCE_LOG_ENTRY) * MAX_PEI_PERFORMANCE_LOG_ENTRIES;\r
+ PeiPerformanceLog = BuildGuidHob (&gPeiPerformanceHobGuid, PeiPerformanceLogSize);\r
+ PeiPerformanceLog = ZeroMem (PeiPerformanceLog, PeiPerformanceLogSize);\r
+ }\r
+\r
+ return PeiPerformanceLog;\r
+}\r
+\r
+/**\r
+ Searches in the log array with keyword Handle, Token and Module.\r
+\r
+ This internal function searches for the log entry in the log array.\r
+ If there is an entry that exactly matches the given key word triple\r
+ and its end time stamp is zero, then the index of that log entry is returned;\r
+ otherwise, the the number of log entries in the array is returned. \r
+\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
+ that identifies the component being measured.\r
+ @param Module Pointer to a Null-terminated ASCII string\r
+ that identifies the module being measured.\r
+\r
+ @retval The index of log entry in the array.\r
+\r
+**/\r
+UINT32\r
+InternalSearchForLogEntry (\r
+ IN PEI_PERFORMANCE_LOG_HEADER *PeiPerformanceLog,\r
+ IN CONST VOID *Handle, OPTIONAL\r
+ IN CONST CHAR8 *Token, OPTIONAL\r
+ IN CONST CHAR8 *Module OPTIONAL\r
+ )\r
+{\r
+ UINT32 Index;\r
+ UINT32 NumberOfEntries;\r
+ PEI_PERFORMANCE_LOG_ENTRY *LogEntryArray;\r
+ \r
+\r
+ if (Token == NULL) {\r
+ Token = "";\r
+ }\r
+ if (Module == NULL) {\r
+ Module = "";\r
+ }\r
+ NumberOfEntries = PeiPerformanceLog->NumberOfEntries;\r
+ LogEntryArray = (PEI_PERFORMANCE_LOG_ENTRY *) (PeiPerformanceLog + 1);\r
+ \r
+ for (Index = 0; Index < NumberOfEntries; Index++) {\r
+ if ((LogEntryArray[Index].Handle == (EFI_PHYSICAL_ADDRESS) (UINTN) Handle) &&\r
+ AsciiStrnCmp (LogEntryArray[Index].Token, Token, PEI_PERFORMANCE_STRING_LENGTH) == 0 &&\r
+ AsciiStrnCmp (LogEntryArray[Index].Module, Module, PEI_PERFORMANCE_STRING_LENGTH) == 0 &&\r
+ LogEntryArray[Index].EndTimeStamp == 0\r
+ ) {\r
+ break;\r
+ }\r
+ }\r
+ return Index;\r
+} \r
+\r
+/**\r
+ Creates a record for the beginning of a performance measurement. \r
+ \r
+ Creates a record that contains the Handle, Token, and Module.\r
+ If TimeStamp is not zero, then TimeStamp is added to the record as the start time.\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
+ to identify the component being measured.\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
+ that identifies the module being measured.\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
+\r
+**/\r
+RETURN_STATUS\r
+EFIAPI\r
+StartPerformanceMeasurement (\r
+ IN CONST VOID *Handle, OPTIONAL\r
+ IN CONST CHAR8 *Token, OPTIONAL\r
+ IN CONST CHAR8 *Module, OPTIONAL\r
+ IN UINT64 TimeStamp\r
+ )\r
+{\r
+ PEI_PERFORMANCE_LOG_HEADER *PeiPerformanceLog;\r
+ PEI_PERFORMANCE_LOG_ENTRY *LogEntryArray;\r
+ UINT32 Index;\r
+\r
+ PeiPerformanceLog = InternalGetPerformanceHobLog ();\r
+ \r
+ if (PeiPerformanceLog->NumberOfEntries >= MAX_PEI_PERFORMANCE_LOG_ENTRIES) {\r
+ return RETURN_OUT_OF_RESOURCES;\r
+ }\r
+ Index = PeiPerformanceLog->NumberOfEntries++;\r
+ LogEntryArray = (PEI_PERFORMANCE_LOG_ENTRY *) (PeiPerformanceLog + 1); \r
+ LogEntryArray[Index].Handle = (EFI_PHYSICAL_ADDRESS) (UINTN) Handle;\r
+\r
+ if (Token != NULL) {\r
+ AsciiStrnCpy (LogEntryArray[Index].Token, Token, PEI_PERFORMANCE_STRING_LENGTH);\r
+ }\r
+ if (Module != NULL) {\r
+ AsciiStrnCpy (LogEntryArray[Index].Module, Module, PEI_PERFORMANCE_STRING_LENGTH);\r
+ }\r
+\r
+ if (TimeStamp == 0) {\r
+ TimeStamp = GetPerformanceCounter ();\r
+ }\r
+ LogEntryArray[Index].StartTimeStamp = TimeStamp;\r
+\r
+ return RETURN_SUCCESS;\r
+}\r
+\r
+/**\r
+ Fills in the end time of a performance measurement. \r
+ \r
+ Looks up the record that matches Handle, Token, and Module.\r
+ If the record can not be found then return RETURN_NOT_FOUND.\r
+ If the record is found and TimeStamp is not zero,\r
+ then TimeStamp is added to the record as the end time.\r
+ If the record is found and TimeStamp is zero, then this function reads\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
+ to identify the component being measured.\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
+ that identifies the module being measured.\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
+\r
+**/\r
+RETURN_STATUS\r
+EFIAPI\r
+EndPerformanceMeasurement (\r
+ IN CONST VOID *Handle, OPTIONAL\r
+ IN CONST CHAR8 *Token, OPTIONAL\r
+ IN CONST CHAR8 *Module, OPTIONAL\r
+ IN UINT64 TimeStamp\r
+ )\r
+{\r
+ PEI_PERFORMANCE_LOG_HEADER *PeiPerformanceLog;\r
+ PEI_PERFORMANCE_LOG_ENTRY *LogEntryArray;\r
+ UINT32 Index;\r
+\r
+ if (TimeStamp == 0) {\r
+ TimeStamp = GetPerformanceCounter ();\r
+ }\r
+ \r
+ PeiPerformanceLog = InternalGetPerformanceHobLog ();\r
+ Index = InternalSearchForLogEntry (PeiPerformanceLog, Handle, Token, Module);\r
+ if (Index >= PeiPerformanceLog->NumberOfEntries) {\r
+ return RETURN_NOT_FOUND;\r
+ }\r
+ LogEntryArray = (PEI_PERFORMANCE_LOG_ENTRY *) (PeiPerformanceLog + 1);\r
+ LogEntryArray[Index].EndTimeStamp = TimeStamp;\r
+\r
+ return RETURN_SUCCESS;\r
+}\r
+\r
+/**\r
+ Attempts to retrieve a performance measurement log entry from the performance measurement log. \r
+ \r
+ Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is\r
+ zero on entry, then an attempt is made to retrieve the first entry from the performance log,\r
+ and the key for the second entry in the log is returned. If the performance log is empty,\r
+ then no entry is retrieved and zero is returned. If LogEntryKey is not zero, then the performance\r
+ log entry associated with LogEntryKey is retrieved, and the key for the next entry in the log is\r
+ returned. If LogEntryKey is the key for the last entry in the log, then the last log entry is\r
+ retrieved and an implementation specific non-zero key value that specifies the end of the performance\r
+ log is returned. If LogEntryKey is equal this implementation specific non-zero key value, then no entry\r
+ is retrieved and zero is returned. In the cases where a performance log entry can be returned,\r
+ the log entry is returned in Handle, Token, Module, StartTimeStamp, and EndTimeStamp.\r
+ If LogEntryKey is not a valid log entry key for the performance measurement log, then ASSERT().\r
+ If Handle is NULL, then ASSERT().\r
+ If Token is NULL, then ASSERT().\r
+ If Module is NULL, then ASSERT().\r
+ If StartTimeStamp is NULL, then ASSERT().\r
+ If EndTimeStamp is NULL, then ASSERT().\r
+\r
+ @param LogEntryKey On entry, the key of the performance measurement log entry to retrieve.\r
+ 0, then the first performance measurement log entry is retrieved.\r
+ On exit, the key of the next performance lof entry entry.\r
+ @param Handle Pointer to environment specific context used to identify the component\r
+ being measured. \r
+ @param Token Pointer to a Null-terminated ASCII string that identifies the component\r
+ being measured. \r
+ @param Module Pointer to a Null-terminated ASCII string that identifies the module\r
+ being measured.\r
+ @param StartTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was started.\r
+ @param EndTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was ended.\r
+\r
+ @return The key for the next performance log entry (in general case).\r
+\r
+**/\r
+UINTN\r
+EFIAPI\r
+GetPerformanceMeasurement (\r
+ IN UINTN LogEntryKey, \r
+ OUT CONST VOID **Handle,\r
+ OUT CONST CHAR8 **Token,\r
+ OUT CONST CHAR8 **Module,\r
+ OUT UINT64 *StartTimeStamp,\r
+ OUT UINT64 *EndTimeStamp\r
+ )\r
+{\r
+ PEI_PERFORMANCE_LOG_HEADER *PeiPerformanceLog;\r
+ PEI_PERFORMANCE_LOG_ENTRY *CurrentLogEntry;\r
+ PEI_PERFORMANCE_LOG_ENTRY *LogEntryArray;\r
+ UINTN NumberOfEntries;\r
+\r
+ ASSERT (Handle != NULL);\r
+ ASSERT (Token != NULL);\r
+ ASSERT (Module != NULL);\r
+ ASSERT (StartTimeStamp != NULL);\r
+ ASSERT (EndTimeStamp != NULL);\r
+ \r
+ PeiPerformanceLog = InternalGetPerformanceHobLog ();\r
+ \r
+ NumberOfEntries = (UINTN) (PeiPerformanceLog->NumberOfEntries);\r
+ LogEntryArray = (PEI_PERFORMANCE_LOG_ENTRY *) (PeiPerformanceLog + 1);\r
+ //\r
+ // Make sure that LogEntryKey is a valid log entry key.\r
+ //\r
+ ASSERT (LogEntryKey <= NumberOfEntries);\r
+ \r
+ if (LogEntryKey == NumberOfEntries) {\r
+ return 0;\r
+ }\r
+\r
+ CurrentLogEntry = &(LogEntryArray[LogEntryKey++]);\r
+\r
+ *Handle = (VOID *) (UINTN) (CurrentLogEntry->Handle);\r
+ *Token = CurrentLogEntry->Token;\r
+ *Module = CurrentLogEntry->Module;\r
+ *StartTimeStamp = CurrentLogEntry->StartTimeStamp;\r
+ *EndTimeStamp = CurrentLogEntry->EndTimeStamp;\r
+\r
+ return LogEntryKey; \r
+}\r
+\r
+/**\r
+ Returns TRUE if the performance measurement macros are enabled. \r
+ \r
+ This function returns TRUE if the PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_ENABLED bit of\r
+ PcdPerformanceLibraryPropertyMask is set. Otherwise FALSE is returned.\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
+ PcdPerformanceLibraryPropertyMask is clear.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+PerformanceMeasurementEnabled (\r
+ VOID\r
+ )\r
+{\r
+ return ((PcdGet8(PcdPerformanceLibraryPropertyMask) & PERFORMANCE_LIBRARY_PROPERTY_MEASUREMENT_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>PeiPerformanceLib</BaseName>\r
+ <Guid>F72DE735-B24F-4ef6-897F-70A85D01A047</Guid>\r
+ <Version>EDK_RELEASE_VERSION 0x00020000</Version>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 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-04-04 11:12</Created>\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>PeiPerformanceLib</BaseName>\r
+ <ModuleType>PEIM</ModuleType>\r
+ <ComponentType>LIBRARY</ComponentType>\r
+ <Guid>F72DE735-B24F-4ef6-897F-70A85D01A047</Guid>\r
+ <Version>EDK_RELEASE_VERSION 0x00020000</Version>\r
+ <Abstract>Memory-only library functions with no library constructor/destructor</Abstract>\r
+ <Description>FIX ME!</Description>\r
+ <Copyright>Copyright (c) 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-04-04 11:12</Created>\r
+ <Specification>EFI_SPECIFICATION_VERSION 0x00000000</Specification>\r
+ </MsaLibHeader>\r
+ <LibraryClassDefinitions>\r
+ <LibraryClass Usage="ALWAYS_PRODUCED">PerformanceLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">DebugLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">HobLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">BaseLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">TimerLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">PcdLib</LibraryClass>\r
+ <LibraryClass Usage="ALWAYS_CONSUMED">BaseMemoryLib</LibraryClass>\r
+ </LibraryClassDefinitions>\r
+ <SourceFiles>\r
+ <Filename>PeiPerformanceLib.c</Filename>\r
+ </SourceFiles>\r
+ <Includes>\r
+ <PackageName>MdePkg</PackageName>\r
+ <PackageName>EdkModulePkg</PackageName>\r
+ </Includes>\r
+ <Guids>\r
+ <GuidEntry Usage="SOMETIMES_CONSUMED">\r
+ <C_Name>PeiPerformanceHob</C_Name>\r
+ </GuidEntry>\r
+ </Guids>\r
+ <PcdCoded>\r
+ <PcdEntry PcdItemType="FIXED_AT_BUILD">\r
+ <C_Name>PcdPerformanceLibraryPropertyMask</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="PeiPerformanceLib"><!--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/PeiPerformanceLib"/>\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="PeiPerformanceLib">\r
+ <GenBuild baseName="PeiPerformanceLib" mbdFilename="${MODULE_DIR}/PeiPerformanceLib.mbd" msaFilename="${MODULE_DIR}/PeiPerformanceLib.msa"/>\r
+ </target>\r
+ <target depends="PeiPerformanceLib_clean" name="clean"/>\r
+ <target depends="PeiPerformanceLib_cleanall" name="cleanall"/>\r
+ <target name="PeiPerformanceLib_clean">\r
+ <OutputDirSetup baseName="PeiPerformanceLib" mbdFilename="${MODULE_DIR}/PeiPerformanceLib.mbd" msaFilename="${MODULE_DIR}/PeiPerformanceLib.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/PeiPerformanceLib_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/PeiPerformanceLib_build.xml" target="clean"/>\r
+ </then>\r
+ </if>\r
+ <delete dir="${DEST_DIR_OUTPUT}" excludes="*.xml"/>\r
+ </target>\r
+ <target name="PeiPerformanceLib_cleanall">\r
+ <OutputDirSetup baseName="PeiPerformanceLib" mbdFilename="${MODULE_DIR}/PeiPerformanceLib.mbd" msaFilename="${MODULE_DIR}/PeiPerformanceLib.msa"/>\r
+ <if>\r
+ <available file="${DEST_DIR_OUTPUT}/PeiPerformanceLib_build.xml"/>\r
+ <then>\r
+ <ant antfile="${DEST_DIR_OUTPUT}/PeiPerformanceLib_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="**PeiPerformanceLib*"/>\r
+ </delete>\r
+ </target>\r
+</project>
\ No newline at end of file
}\r
}\r
\r
- switch (StatCode) {\r
- case EFI_SUCCESS:\r
- case EFI_TIMEOUT:\r
- break;\r
-\r
- default:\r
+ if ((StatCode != EFI_SUCCESS) && (StatCode != EFI_TIMEOUT)) {\r
DEBUG (\r
(EFI_D_INFO,\r
"\nUdpRead() Exit #3 %Xh %r",\r
(VOID *) &LoadfilePtr->Private->CallbackProtocolPtr\r
);\r
\r
- switch (Status) {\r
- case EFI_SUCCESS:\r
+ if (Status == EFI_SUCCESS) {\r
//\r
// There is already a callback routine. Do nothing.\r
//\r
DEBUG ((EFI_D_WARN, "\nLoadFile() BC callback exists."));\r
- break;\r
-\r
- case EFI_UNSUPPORTED:\r
+ } else if (Status == EFI_UNSUPPORTED) {\r
//\r
// No BaseCode Callback protocol found. Add our own.\r
//\r
&NewMakeCallback\r
);\r
}\r
-\r
- break;\r
-\r
- default:\r
+ } else {\r
DEBUG ((EFI_D_WARN, "\nLoadFile() Callback check status == %xh", Status));\r
}\r
//\r
\r
DEBUG ((EFI_D_WARN, "\nBC.Loadfile() Status == %xh\n", Status));\r
\r
- switch (Status) {\r
- case EFI_SUCCESS: /* 0 */\r
+ if (Status == EFI_SUCCESS) {\r
+ /* 0 */\r
return EFI_SUCCESS;\r
-\r
- case EFI_BUFFER_TOO_SMALL: /* 5 */\r
+ } else if (Status == EFI_BUFFER_TOO_SMALL) {\r
+ /* 5 */\r
//\r
// Error is only displayed when we are actually trying to\r
// download the boot image.\r
if (Buffer == NULL) {\r
return EFI_BUFFER_TOO_SMALL;\r
}\r
-\r
AsciiPrint ("\nPXE-E05: Download buffer is smaller than requested file.\n");\r
- break;\r
-\r
- case EFI_DEVICE_ERROR: /* 7 */\r
+ } else if (Status == EFI_DEVICE_ERROR) {\r
+ /* 7 */\r
AsciiPrint ("\nPXE-E07: Network device error. Check network connection.\n");\r
- break;\r
-\r
- case EFI_OUT_OF_RESOURCES: /* 9 */\r
+ } else if (Status == EFI_OUT_OF_RESOURCES) {\r
+ /* 9 */\r
AsciiPrint ("\nPXE-E09: Could not allocate I/O buffers.\n");\r
- break;\r
-\r
- case EFI_NO_MEDIA: /* 12 */\r
+ } else if (Status == EFI_NO_MEDIA) {\r
+ /* 12 */\r
AsciiPrint ("\nPXE-E12: Could not detect network connection. Check cable.\n");\r
- break;\r
-\r
- case EFI_NO_RESPONSE: /* 16 */\r
+ } else if (Status == EFI_NO_RESPONSE) {\r
+ /* 16 */\r
AsciiPrint ("\nPXE-E16: Valid PXE offer not received.\n");\r
- break;\r
-\r
- case EFI_TIMEOUT: /* 18 */\r
+ } else if (Status == EFI_TIMEOUT) {\r
+ /* 18 */\r
AsciiPrint ("\nPXE-E18: Timeout. Server did not respond.\n");\r
- break;\r
-\r
- case EFI_ABORTED: /* 21 */\r
+ } else if (Status == EFI_ABORTED) {\r
+ /* 21 */\r
AsciiPrint ("\nPXE-E21: Remote boot cancelled.\n");\r
- break;\r
-\r
- case EFI_ICMP_ERROR: /* 22 */\r
+ } else if (Status == EFI_ICMP_ERROR) {\r
+ /* 22 */\r
AsciiPrint ("\nPXE-E22: Client received ICMP error from server.\n");\r
\r
- if (LoadfilePtr->Private->EfiBc.Mode == NULL) {\r
- break;\r
- }\r
-\r
- if (!LoadfilePtr->Private->EfiBc.Mode->IcmpErrorReceived) {\r
- break;\r
- }\r
+ if ((LoadfilePtr->Private->EfiBc.Mode != NULL) && LoadfilePtr->Private->EfiBc.Mode->IcmpErrorReceived) {\r
+ AsciiPrint (\r
+ "PXE-E98: Type: %xh Code: %xh ",\r
+ LoadfilePtr->Private->EfiBc.Mode->IcmpError.Type,\r
+ LoadfilePtr->Private->EfiBc.Mode->IcmpError.Code\r
+ );\r
\r
- AsciiPrint (\r
- "PXE-E98: Type: %xh Code: %xh ",\r
- LoadfilePtr->Private->EfiBc.Mode->IcmpError.Type,\r
- LoadfilePtr->Private->EfiBc.Mode->IcmpError.Code\r
- );\r
+ switch (LoadfilePtr->Private->EfiBc.Mode->IcmpError.Type) {\r
+ case 0x03:\r
+ switch (LoadfilePtr->Private->EfiBc.Mode->IcmpError.Code) {\r
+ case 0x00: /* net unreachable */\r
+ AsciiPrint ("Net unreachable");\r
+ break;\r
\r
- switch (LoadfilePtr->Private->EfiBc.Mode->IcmpError.Type) {\r
- case 0x03:\r
- switch (LoadfilePtr->Private->EfiBc.Mode->IcmpError.Code) {\r
- case 0x00: /* net unreachable */\r
- AsciiPrint ("Net unreachable");\r
- break;\r
+ case 0x01: /* host unreachable */\r
+ AsciiPrint ("Host unreachable");\r
+ break;\r
\r
- case 0x01: /* host unreachable */\r
- AsciiPrint ("Host unreachable");\r
- break;\r
+ case 0x02: /* protocol unreachable */\r
+ AsciiPrint ("Protocol unreachable");\r
+ break;\r
\r
- case 0x02: /* protocol unreachable */\r
- AsciiPrint ("Protocol unreachable");\r
- break;\r
+ case 0x03: /* port unreachable */\r
+ AsciiPrint ("Port unreachable");\r
+ break;\r
\r
- case 0x03: /* port unreachable */\r
- AsciiPrint ("Port unreachable");\r
- break;\r
+ case 0x04: /* Fragmentation needed */\r
+ AsciiPrint ("Fragmentation needed");\r
+ break;\r
\r
- case 0x04: /* Fragmentation needed */\r
- AsciiPrint ("Fragmentation needed");\r
- break;\r
+ case 0x05: /* Source route failed */\r
+ AsciiPrint ("Source route failed");\r
+ break;\r
+ }\r
\r
- case 0x05: /* Source route failed */\r
- AsciiPrint ("Source route failed");\r
break;\r
}\r
\r
- break;\r
+ AsciiPrint ("\n");\r
}\r
-\r
- AsciiPrint ("\n");\r
-\r
- break;\r
-\r
- case EFI_TFTP_ERROR: /* 23 */\r
+ } else if (Status == EFI_TFTP_ERROR) {\r
+ /* 23 */\r
AsciiPrint ("\nPXE-E23: Client received TFTP error from server.\n");\r
\r
- if (LoadfilePtr->Private->EfiBc.Mode == NULL) {\r
- break;\r
- }\r
-\r
- if (LoadfilePtr->Private->EfiBc.Mode->TftpErrorReceived) {\r
+ if ((LoadfilePtr->Private->EfiBc.Mode != NULL) && (LoadfilePtr->Private->EfiBc.Mode->TftpErrorReceived)) {\r
AsciiPrint (\r
"PXE-E98: Code: %xh %a\n",\r
LoadfilePtr->Private->EfiBc.Mode->TftpError.ErrorCode,\r
LoadfilePtr->Private->EfiBc.Mode->TftpError.ErrorString\r
);\r
}\r
-\r
- break;\r
-\r
- default:\r
+ } else {\r
AsciiPrint ("\nPXE-E99: Unexpected network error: %xh\n", Status);\r
}\r
\r
//\r
efi_status = PxeDhcp4Init (This, timeout, &offers, &offer_list);\r
\r
- switch (efi_status) {\r
- case EFI_NO_RESPONSE:\r
- case EFI_TIMEOUT:\r
- case EFI_SUCCESS:\r
- break;\r
-\r
- case EFI_ABORTED:\r
- default:\r
+ if ((efi_status != EFI_NO_RESPONSE) &&\r
+ (efi_status != EFI_TIMEOUT) &&\r
+ (efi_status != EFI_SUCCESS)) {\r
return efi_status;\r
}\r
//\r
//\r
// Scalable macro to set the most significant bit in a natural number\r
//\r
-#define MAX_BIT 0x8000000000000000ULL \r
-#define MAX_2_BITS 0xC000000000000000ULL\r
-\r
+#define MAX_BIT (1ULL << (sizeof (INTN) * 8 - 1)) \r
+#define MAX_2_BITS (3ULL << (sizeof (INTN) * 8 - 2))\r
\r
//\r
// Maximum legal EBC address\r
//\r
-#define MAX_ADDRESS 0xFFFFFFFFFFFFFFFFULL\r
-\r
+#define MAX_ADDRESS ((UINTN) ~0)\r
//\r
// Modifier to ensure that all protocol member functions and EFI intrinsics\r
// use the correct C calling convention. All protocol member functions and\r
\r
\r
/**\r
- Retrieves information on a PE/COFF image\r
+ Retrieves information about a PE/COFF image.\r
\r
- @param ImageContext The context of the image being loaded\r
+ Computes the PeCoffHeaderOffset, ImageAddress, ImageSize, DestinationAddress, CodeView,\r
+ PdbPointer, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva\r
+ fields of the ImageContext structure. If ImageContext is NULL, then return RETURN_INVALID_PARAMETER.\r
+ If the PE/COFF image accessed through the ImageRead service in the ImageContext structure is not\r
+ a supported PE/COFF image type, then return RETURN_UNSUPPORTED. If any errors occur while\r
+ computing the fields of ImageContext, then the error status is returned in the ImageError field of\r
+ ImageContext. \r
\r
- @retval EFI_SUCCESS The information on the PE/COFF image was collected.\r
- @retval EFI_INVALID_PARAMETER ImageContext is NULL.\r
- @retval EFI_UNSUPPORTED The PE/COFF image is not supported.\r
- @retval Otherwise The error status from reading the PE/COFF image using the\r
- ImageContext->ImageRead() function\r
+ @param ImageContext Pointer to the image context structure that describes the PE/COFF\r
+ image that needs to be examined by this function.\r
+\r
+ @retval RETURN_SUCCESS The information on the PE/COFF image was collected.\r
+ @retval RETURN_INVALID_PARAMETER ImageContext is NULL.\r
+ @retval RETURN_UNSUPPORTED The PE/COFF image is not supported.\r
\r
**/\r
RETURN_STATUS\r
;\r
\r
/**\r
- Relocates a PE/COFF image in memory\r
+ Applies relocation fixups to a PE/COFF image that was loaded with PeCoffLoaderLoadImage().\r
+\r
+ If the DestinationAddress field of ImageContext is 0, then use the ImageAddress field of\r
+ ImageContext as the relocation base address. Otherwise, use the DestinationAddress field\r
+ of ImageContext as the relocation base address. The caller must allocate the relocation\r
+ fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function. \r
+ If ImageContext is NULL, then ASSERT().\r
\r
- @param ImageContext Contains information on the loaded image to relocate\r
+ @param ImageContext Pointer to the image context structure that describes the PE/COFF\r
+ image that is being relocated.\r
\r
- @retval EFI_SUCCESS if the PE/COFF image was relocated\r
- @retval EFI_LOAD_ERROR if the image is not a valid PE/COFF image\r
- @retval EFI_UNSUPPORTED not support\r
+ @retval RETURN_SUCCESS The PE/COFF image was relocated.\r
+ Extended status information is in the ImageError field of ImageContext.\r
+ @retval RETURN_LOAD_ERROR The image in not a valid PE/COFF image.\r
+ Extended status information is in the ImageError field of ImageContext.\r
+ @retval RETURN_UNSUPPORTED A relocation record type is not supported.\r
+ Extended status information is in the ImageError field of ImageContext.\r
\r
**/\r
RETURN_STATUS\r
;\r
\r
/**\r
- Loads a PE/COFF image into memory\r
-\r
- @param ImageContext Contains information on image to load into memory\r
-\r
- @retval EFI_SUCCESS if the PE/COFF image was loaded\r
- @retval EFI_BUFFER_TOO_SMALL if the caller did not provide a large enough buffer\r
- @retval EFI_LOAD_ERROR if the image is a runtime driver with no relocations\r
- @retval EFI_INVALID_PARAMETER if the image address is invalid\r
+ Loads a PE/COFF image into memory.\r
+\r
+ Loads the PE/COFF image accessed through the ImageRead service of ImageContext into the buffer\r
+ specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate\r
+ the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.\r
+ The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed.\r
+ If ImageContext is NULL, then ASSERT().\r
+\r
+ @param ImageContext Pointer to the image context structure that describes the PE/COFF\r
+ image that is being loaded.\r
+\r
+ @retval RETURN_SUCCESS The PE/COFF image was loaded into the buffer specified by\r
+ the ImageAddress and ImageSize fields of ImageContext.\r
+ Extended status information is in the ImageError field of ImageContext.\r
+ @retval RETURN_BUFFER_TOO_SMALL The caller did not provide a large enough buffer.\r
+ Extended status information is in the ImageError field of ImageContext.\r
+ @retval RETURN_LOAD_ERROR The PE/COFF image is an EFI Runtime image with no relocations.\r
+ Extended status information is in the ImageError field of ImageContext.\r
+ @retval RETURN_INVALID_PARAMETER The image address is invalid.\r
+ Extended status information is in the ImageError field of ImageContext.\r
\r
**/\r
RETURN_STATUS\r
);\r
\r
/**\r
- Retrieves a previously logged performance measurement. \r
+ Attempts to retrieve a performance measurement log entry from the performance measurement log. \r
\r
- Looks up the record that matches Handle, Token, and Module.\r
- If the record can not be found then return RETURN_NOT_FOUND.\r
- If the record is found then the start of the measurement is returned in StartTimeStamp,\r
- and the end of the measurement is returned in EndTimeStamp.\r
-\r
- @param LogEntryKey The key for the previous performance measurement log entry.\r
- If 0, then the first performance measurement log entry is retrieved.\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
- that identifies the component being measured.\r
- @param Module Pointer to a Null-terminated ASCII string\r
- that identifies the module being measured.\r
- @param StartTimeStamp The 64-bit time stamp that was recorded when the measurement was started.\r
- @param EndTimeStamp The 64-bit time stamp that was recorded when the measurement was ended.\r
-\r
- @return The key for the current performance log entry.\r
+ Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is\r
+ zero on entry, then an attempt is made to retrieve the first entry from the performance log,\r
+ and the key for the second entry in the log is returned. If the performance log is empty,\r
+ then no entry is retrieved and zero is returned. If LogEntryKey is not zero, then the performance\r
+ log entry associated with LogEntryKey is retrieved, and the key for the next entry in the log is\r
+ returned. If LogEntryKey is the key for the last entry in the log, then the last log entry is\r
+ retrieved and an implementation specific non-zero key value that specifies the end of the performance\r
+ log is returned. If LogEntryKey is equal this implementation specific non-zero key value, then no entry\r
+ is retrieved and zero is returned. In the cases where a performance log entry can be returned,\r
+ the log entry is returned in Handle, Token, Module, StartTimeStamp, and EndTimeStamp.\r
+ If LogEntryKey is not a valid log entry key for the performance measurement log, then ASSERT().\r
+ If Handle is NULL, then ASSERT().\r
+ If Token is NULL, then ASSERT().\r
+ If Module is NULL, then ASSERT().\r
+ If StartTimeStamp is NULL, then ASSERT().\r
+ If EndTimeStamp is NULL, then ASSERT().\r
+\r
+ @param LogEntryKey On entry, the key of the performance measurement log entry to retrieve.\r
+ 0, then the first performance measurement log entry is retrieved.\r
+ On exit, the key of the next performance lof entry entry.\r
+ @param Handle Pointer to environment specific context used to identify the component\r
+ being measured. \r
+ @param Token Pointer to a Null-terminated ASCII string that identifies the component\r
+ being measured. \r
+ @param Module Pointer to a Null-terminated ASCII string that identifies the module\r
+ being measured.\r
+ @param StartTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was started.\r
+ @param EndTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was ended.\r
+\r
+ @return The key for the next performance log entry (in general case).\r
\r
**/\r
UINTN\r
EFIAPI\r
GetPerformanceMeasurement (\r
- UINTN LogEntryKey, \r
+ IN UINTN LogEntryKey, \r
OUT CONST VOID **Handle,\r
OUT CONST CHAR8 **Token,\r
OUT CONST CHAR8 **Module,\r
#define __SMBUS_LIB__\r
\r
//\r
-// PEC BIT is bit 21 in SMBUS address\r
+// PEC BIT is bit 22 in SMBUS address\r
//\r
-#define SMBUS_LIB_PEC_BIT (1 << 21)\r
+#define SMBUS_LIB_PEC_BIT (1 << 22)\r
\r
/**\r
Macro that converts SMBUS slave address, SMBUS command, SMBUS data length,\r
\r
@param SlaveAddress SMBUS Slave Address. Range 0..127.\r
@param Command SMBUS Command. Range 0..255.\r
- @param Length SMBUS Data Length. Range 0..31.\r
+ @param Length SMBUS Data Length. Range 0..32.\r
@param Pec TRUE if Packet Error Checking is enabled. Otherwise FALSE.\r
\r
**/\r
( ((Pec) ? SMBUS_LIB_PEC_BIT: 0) | \\r
(((SlaveAddress) & 0x7f) << 1) | \\r
(((Command) & 0xff) << 8) | \\r
- (((Length) & 0x1f) << 16) \\r
+ (((Length) & 0x3f) << 16) \\r
)\r
\r
/**\r
Bytes are read from the SMBUS and stored in Buffer.\r
The number of bytes read is returned, and will never return a value larger than 32-bytes.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure Buffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
If Length in SmBusAddress is not zero, then ASSERT().\r
If Buffer is NULL, then ASSERT().\r
\r
Executes an SMBUS block process call command on the SMBUS device specified by SmBusAddress.\r
The SMBUS slave address, SMBUS command, and SMBUS length fields of SmBusAddress are required.\r
- Bytes are written to the SMBUS from OutBuffer. Bytes are then read from the SMBUS into InBuffer.\r
+ Bytes are written to the SMBUS from WriteBuffer. Bytes are then read from the SMBUS into ReadBuffer.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure InBuffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure ReadBuffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
- If OutBuffer is NULL, then ASSERT().\r
- If InBuffer is NULL, then ASSERT().\r
+ If Length in SmBusAddress is zero or greater than 32, then ASSERT().\r
+ If WriteBuffer is NULL, then ASSERT().\r
+ If ReadBuffer is NULL, then ASSERT().\r
If any reserved bits of SmBusAddress are set, then ASSERT().\r
\r
-\r
@param SmBusAddress Address that encodes the SMBUS Slave Address,\r
SMBUS Command, SMBUS Data Length, and PEC.\r
- @param OutBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
- @param InBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
+ @param WriteBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
+ @param ReadBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
@param Status Return status for the executed command.\r
This is an optional parameter and may be NULL.\r
\r
EFIAPI\r
SmBusBlockProcessCall (\r
IN UINTN SmBusAddress,\r
- IN VOID *OutBuffer,\r
- OUT VOID *InBuffer,\r
+ IN VOID *WriteBuffer,\r
+ OUT VOID *ReadBuffer,\r
OUT RETURN_STATUS *Status OPTIONAL\r
)\r
;\r
\r
+\r
#endif\r
#include "MemLibInternals.h"\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
IN UINTN Length\r
)\r
{\r
- ASSERT (DestinationBuffer != NULL);\r
- ASSERT (SourceBuffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)DestinationBuffer + 1);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)SourceBuffer + 1);\r
if (Length == 0) {\r
return 0;\r
}\r
+ ASSERT (DestinationBuffer != NULL);\r
+ ASSERT (SourceBuffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
IN UINTN Length\r
)\r
{\r
- ASSERT (Length > 0);\r
while ((--Length != 0) &&\r
(*(INT8*)DestinationBuffer == *(INT8*)SourceBuffer)) {\r
DestinationBuffer = (INT8*)DestinationBuffer + 1;\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT16 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT32 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT64 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINT8 Value\r
)\r
{\r
- ASSERT (Buffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
-\r
- if ((Length /= sizeof (Value)) == 0) {\r
+ if (Length == 0) {\r
return NULL;\r
}\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+ \r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT16 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem16 (Buffer, Length, Value);\r
+ return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT32 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem32 (Buffer, Length, Value);\r
+ return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT64 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem64 (Buffer, Length, Value);\r
+ return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @param Buffer Memory to set.\r
- @param Size 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
IN VOID *Buffer,\r
- IN UINTN Size,\r
+ IN UINTN Length,\r
IN UINT8 Value\r
)\r
{\r
- if (Size == 0) {\r
+ if (Length == 0) {\r
return Buffer;\r
}\r
- ASSERT (Size - 1 <= MAX_ADDRESS - (UINTN)Buffer);\r
- return InternalMemSetMem (Buffer, Size, Value);\r
+\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+\r
+ return InternalMemSetMem (Buffer, Length, Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINTN Length\r
)\r
{\r
- ASSERT (DestinationBuffer != NULL);\r
- ASSERT (SourceBuffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)DestinationBuffer + 1);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)SourceBuffer + 1);\r
if (Length == 0) {\r
return 0;\r
}\r
+ ASSERT (DestinationBuffer != NULL);\r
+ ASSERT (SourceBuffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT16 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT32 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT64 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINT8 Value\r
)\r
{\r
- ASSERT (Buffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
-\r
- if ((Length /= sizeof (Value)) == 0) {\r
+ if (Length == 0) {\r
return NULL;\r
}\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+ \r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT16 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem16 (Buffer, Length, Value);\r
+ return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT32 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem32 (Buffer, Length, Value);\r
+ return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT64 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem64 (Buffer, Length, Value);\r
+ return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @param Buffer Memory to set.\r
- @param Size 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
IN VOID *Buffer,\r
- IN UINTN Size,\r
+ IN UINTN Length,\r
IN UINT8 Value\r
)\r
{\r
- if (Size == 0) {\r
+ if (Length == 0) {\r
return Buffer;\r
}\r
- ASSERT (Size - 1 <= MAX_ADDRESS - (UINTN)Buffer);\r
- return InternalMemSetMem (Buffer, Size, Value);\r
+\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+\r
+ return InternalMemSetMem (Buffer, Length, Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINTN Length\r
)\r
{\r
- ASSERT (DestinationBuffer != NULL);\r
- ASSERT (SourceBuffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)DestinationBuffer + 1);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)SourceBuffer + 1);\r
if (Length == 0) {\r
return 0;\r
}\r
+ ASSERT (DestinationBuffer != NULL);\r
+ ASSERT (SourceBuffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT16 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT32 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT64 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINT8 Value\r
)\r
{\r
- ASSERT (Buffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
-\r
- if ((Length /= sizeof (Value)) == 0) {\r
+ if (Length == 0) {\r
return NULL;\r
}\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+ \r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT16 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem16 (Buffer, Length, Value);\r
+ return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT32 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem32 (Buffer, Length, Value);\r
+ return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT64 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem64 (Buffer, Length, Value);\r
+ return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @param Buffer Memory to set.\r
- @param Size 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
IN VOID *Buffer,\r
- IN UINTN Size,\r
+ IN UINTN Length,\r
IN UINT8 Value\r
)\r
{\r
- if (Size == 0) {\r
+ if (Length == 0) {\r
return Buffer;\r
}\r
- ASSERT (Size - 1 <= MAX_ADDRESS - (UINTN)Buffer);\r
- return InternalMemSetMem (Buffer, Size, Value);\r
+\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+\r
+ return InternalMemSetMem (Buffer, Length, Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINTN Length\r
)\r
{\r
- ASSERT (DestinationBuffer != NULL);\r
- ASSERT (SourceBuffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)DestinationBuffer + 1);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)SourceBuffer + 1);\r
if (Length == 0) {\r
return 0;\r
}\r
+ ASSERT (DestinationBuffer != NULL);\r
+ ASSERT (SourceBuffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT16 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT32 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT64 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINT8 Value\r
)\r
{\r
- ASSERT (Buffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
-\r
- if ((Length /= sizeof (Value)) == 0) {\r
+ if (Length == 0) {\r
return NULL;\r
}\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+ \r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT16 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem16 (Buffer, Length, Value);\r
+ return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT32 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem32 (Buffer, Length, Value);\r
+ return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT64 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem64 (Buffer, Length, Value);\r
+ return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @param Buffer Memory to set.\r
- @param Size 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
IN VOID *Buffer,\r
- IN UINTN Size,\r
+ IN UINTN Length,\r
IN UINT8 Value\r
)\r
{\r
- if (Size == 0) {\r
+ if (Length == 0) {\r
return Buffer;\r
}\r
- ASSERT (Size - 1 <= MAX_ADDRESS - (UINTN)Buffer);\r
- return InternalMemSetMem (Buffer, Size, Value);\r
+\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+\r
+ return InternalMemSetMem (Buffer, Length, Value);\r
}\r
\r
**/\r
\r
+/**\r
+ Performs an Itanium-based specific relocation fixup.\r
\r
+ @param Reloc Pointer to the relocation record.\r
+ @param Fixup Pointer to the address to fix up.\r
+ @param FixupData Pointer to a buffer to log the fixups.\r
+ @param Adjust The offset to adjust the fixup.\r
\r
+ @return Status code.\r
\r
-STATIC\r
-RETURN_STATUS\r
-PeCoffLoaderGetPeHeader (\r
- IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext,\r
- OUT EFI_IMAGE_NT_HEADERS *PeHdr,\r
- OUT EFI_TE_IMAGE_HEADER *TeHdr\r
- );\r
-\r
-STATIC\r
-RETURN_STATUS\r
-PeCoffLoaderCheckImageType (\r
- IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext,\r
- IN EFI_IMAGE_NT_HEADERS *PeHdr,\r
- IN EFI_TE_IMAGE_HEADER *TeHdr\r
- );\r
-\r
-STATIC\r
-VOID *\r
-PeCoffLoaderImageAddress (\r
- IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext,\r
- IN UINTN Address\r
- );\r
-\r
+**/\r
RETURN_STATUS\r
PeCoffLoaderRelocateImageEx (\r
IN UINT16 *Reloc,\r
@param ImageContext Pointer to the image context structure that describes the PE/COFF\r
image that needs to be examined by this function.\r
\r
- @retval RETURN_SUCCESS The information on the PE/COFF image was collected.\r
- @retval RETURN_INVALID_PARAMETER ImageContext is NULL.\r
- @retval RETURN_UNSUPPORTED The PE/COFF image is not supported.\r
- @retval Others The error status from reading the PE/COFF image\r
- using the ImageContext->ImageRead() function.\r
+ @retval RETURN_SUCCESS The information on the PE/COFF image was collected.\r
+ @retval RETURN_INVALID_PARAMETER ImageContext is NULL.\r
+ @retval RETURN_UNSUPPORTED The PE/COFF image is not supported.\r
\r
**/\r
RETURN_STATUS\r
specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate\r
the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.\r
The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed.\r
+ If ImageContext is NULL, then ASSERT().\r
\r
@param ImageContext Pointer to the image context structure that describes the PE/COFF\r
image that is being loaded.\r
UINTN Size;\r
UINT32 TempDebugEntryRva;\r
\r
+ ASSERT (ImageContext != NULL);\r
+\r
PeHdr = NULL;\r
TeHdr = NULL;\r
+\r
//\r
// Assume success\r
//\r
ImageContext->ImageError = IMAGE_ERROR_INVALID_IMAGE_SIZE;\r
return RETURN_BUFFER_TOO_SMALL;\r
}\r
-\r
+ if (ImageContext->ImageAddress == 0) {\r
+ //\r
+ // Image cannot be loaded into 0 address.\r
+ //\r
+ ImageContext->ImageError = IMAGE_ERROR_INVALID_IMAGE_ADDRESS;\r
+ return RETURN_INVALID_PARAMETER;\r
+ }\r
//\r
// If there's no relocations, then make sure it's not a runtime driver,\r
// and that it's being loaded at the linked address.\r
\r
\r
/**\r
- Performs an IA-32 specific relocation fixup.\r
+ Performs an EBC specific relocation fixup.\r
\r
- @param Reloc Pointer to the relocation record.\r
+ @param Reloc Pointer to the relocation record.\r
+ @param Fixup Pointer to the address to fix up.\r
+ @param FixupData Pointer to a buffer to log the fixups.\r
+ @param Adjust The offset to adjust the fixup.\r
\r
- @param Fixup Pointer to the address to fix up.\r
-\r
- @param FixupData Pointer to a buffer to log the fixups.\r
-\r
- @param Adjust The offset to adjust the fixup.\r
-\r
- @retval EFI_UNSUPPORTED Unsupported now.\r
+ @retval EFI_UNSUPPORTED Unsupported now.\r
\r
**/\r
RETURN_STATUS\r
/**\r
Performs an IA-32 specific relocation fixup.\r
\r
- @param Reloc Pointer to the relocation record.\r
+ @param Reloc Pointer to the relocation record.\r
+ @param Fixup Pointer to the address to fix up.\r
+ @param FixupData Pointer to a buffer to log the fixups.\r
+ @param Adjust The offset to adjust the fixup.\r
\r
- @param Fixup Pointer to the address to fix up.\r
-\r
- @param FixupData Pointer to a buffer to log the fixups.\r
-\r
- @param Adjust The offset to adjust the fixup.\r
-\r
- @retval EFI_UNSUPPORTED Unsupported now.\r
+ @retval EFI_UNSUPPORTED Unsupported now.\r
\r
**/\r
RETURN_STATUS\r
/**\r
Performs an Itanium-based specific relocation fixup.\r
\r
- @param Reloc Pointer to the relocation record.\r
- \r
- @param Fixup Pointer to the address to fix up.\r
- \r
- @param FixupData Pointer to a buffer to log the fixups.\r
- \r
- @param Adjust The offset to adjust the fixup.\r
+ @param Reloc Pointer to the relocation record.\r
+ @param Fixup Pointer to the address to fix up.\r
+ @param FixupData Pointer to a buffer to log the fixups.\r
+ @param Adjust The offset to adjust the fixup.\r
\r
@return Status code.\r
\r
\r
**/\r
\r
-\r
-\r
-\r
/**\r
Performs an x64 specific relocation fixup.\r
\r
- @param Reloc Pointer to the relocation record\r
- @param Fixup Pointer to the address to fix up\r
- @param FixupData Pointer to a buffer to log the fixups\r
- @param Adjust The offset to adjust the fixup\r
+ @param Reloc Pointer to the relocation record\r
+ @param Fixup Pointer to the address to fix up\r
+ @param FixupData Pointer to a buffer to log the fixups\r
+ @param Adjust The offset to adjust the fixup\r
\r
**/\r
RETURN_STATUS\r
}\r
\r
/**\r
- Retrieves a previously logged performance measurement. \r
+ Attempts to retrieve a performance measurement log entry from the performance measurement log. \r
\r
- Retrieves the performance log entry from the performance log\r
- that immediately follows the log entry specified by LogEntryKey.\r
- If LogEntryKey is zero, then the first entry from the performance log is returned.\r
- If the log entry specified by LogEntryKey is the last entry in the performance log,\r
- then 0 is returned. Otherwise, the performance log entry is returned in Handle,\r
- Token, Module, StartTimeStamp, and EndTimeStamp.\r
- The key for the current performance log entry is returned. \r
-\r
- @param LogEntryKey The key for the previous performance measurement log entry.\r
- If 0, then the first performance measurement log entry is retrieved.\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
- that identifies the component being measured.\r
- @param Module Pointer to a Null-terminated ASCII string\r
- that identifies the module being measured.\r
- @param StartTimeStamp The 64-bit time stamp that was recorded when the measurement was started.\r
- @param EndTimeStamp The 64-bit time stamp that was recorded when the measurement was ended.\r
-\r
- @return The key for the current performance log entry.\r
+ Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is\r
+ zero on entry, then an attempt is made to retrieve the first entry from the performance log,\r
+ and the key for the second entry in the log is returned. If the performance log is empty,\r
+ then no entry is retrieved and zero is returned. If LogEntryKey is not zero, then the performance\r
+ log entry associated with LogEntryKey is retrieved, and the key for the next entry in the log is\r
+ returned. If LogEntryKey is the key for the last entry in the log, then the last log entry is\r
+ retrieved and an implementation specific non-zero key value that specifies the end of the performance\r
+ log is returned. If LogEntryKey is equal this implementation specific non-zero key value, then no entry\r
+ is retrieved and zero is returned. In the cases where a performance log entry can be returned,\r
+ the log entry is returned in Handle, Token, Module, StartTimeStamp, and EndTimeStamp.\r
+ If LogEntryKey is not a valid log entry key for the performance measurement log, then ASSERT().\r
+ If Handle is NULL, then ASSERT().\r
+ If Token is NULL, then ASSERT().\r
+ If Module is NULL, then ASSERT().\r
+ If StartTimeStamp is NULL, then ASSERT().\r
+ If EndTimeStamp is NULL, then ASSERT().\r
+\r
+ @param LogEntryKey On entry, the key of the performance measurement log entry to retrieve.\r
+ 0, then the first performance measurement log entry is retrieved.\r
+ On exit, the key of the next performance lof entry entry.\r
+ @param Handle Pointer to environment specific context used to identify the component\r
+ being measured. \r
+ @param Token Pointer to a Null-terminated ASCII string that identifies the component\r
+ being measured. \r
+ @param Module Pointer to a Null-terminated ASCII string that identifies the module\r
+ being measured.\r
+ @param StartTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was started.\r
+ @param EndTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement\r
+ was ended.\r
+\r
+ @return The key for the next performance log entry (in general case).\r
\r
**/\r
UINTN\r
EFIAPI\r
GetPerformanceMeasurement (\r
- UINTN LogEntryKey, \r
+ IN UINTN LogEntryKey, \r
OUT CONST VOID **Handle,\r
OUT CONST CHAR8 **Token,\r
OUT CONST CHAR8 **Module,\r
\r
#include "PrintLibInternal.h"\r
\r
-typedef struct {\r
- RETURN_STATUS Status;\r
- CHAR8 *String;\r
-} STATUS_LOOKUP_TABLE_ENTRY;\r
-\r
-static CONST STATUS_LOOKUP_TABLE_ENTRY StatusString[] = {\r
- { RETURN_SUCCESS, "Success" },\r
- { RETURN_LOAD_ERROR, "Load Error" },\r
- { RETURN_INVALID_PARAMETER, "Invalid Parameter" },\r
- { RETURN_UNSUPPORTED, "Unsupported" },\r
- { RETURN_BAD_BUFFER_SIZE, "Bad Buffer Size" },\r
- { RETURN_BUFFER_TOO_SMALL, "Buffer Too Small" },\r
- { RETURN_NOT_READY, "Not Ready" },\r
- { RETURN_DEVICE_ERROR, "Device Error" },\r
- { RETURN_WRITE_PROTECTED, "Write Protected" },\r
- { RETURN_OUT_OF_RESOURCES, "Out of Resources" },\r
- { RETURN_VOLUME_CORRUPTED, "Volume Corrupt" },\r
- { RETURN_VOLUME_FULL, "Volume Full" },\r
- { RETURN_NO_MEDIA, "No Media" },\r
- { RETURN_MEDIA_CHANGED, "Media changed" },\r
- { RETURN_NOT_FOUND, "Not Found" },\r
- { RETURN_ACCESS_DENIED, "Access Denied" },\r
- { RETURN_NO_RESPONSE, "No Response" },\r
- { RETURN_NO_MAPPING, "No mapping" },\r
- { RETURN_TIMEOUT, "Time out" },\r
- { RETURN_NOT_STARTED, "Not started" },\r
- { RETURN_ALREADY_STARTED, "Already started" },\r
- { RETURN_ABORTED, "Aborted" },\r
- { RETURN_ICMP_ERROR, "ICMP Error" },\r
- { RETURN_TFTP_ERROR, "TFTP Error" },\r
- { RETURN_PROTOCOL_ERROR, "Protocol Error" },\r
- { RETURN_WARN_UNKNOWN_GLYPH, "Warning Unknown Glyph" },\r
- { RETURN_WARN_DELETE_FAILURE, "Warning Delete Failure" },\r
- { RETURN_WARN_WRITE_FAILURE, "Warning Write Failure" },\r
- { RETURN_WARN_BUFFER_TOO_SMALL, "Warning Buffer Too Small" },\r
- { 0, NULL }\r
+#define WARNING_STATUS_NUMBER 4\r
+#define ERROR_STATUS_NUMBER 24\r
+\r
+STATIC CONST CHAR8 *StatusString [] = {\r
+ "Success", // RETURN_SUCCESS = 0\r
+ "Warning Unknown Glyph", // RETURN_WARN_UNKNOWN_GLYPH = 1\r
+ "Warning Delete Failure", // RETURN_WARN_DELETE_FAILURE = 2\r
+ "Warning Write Failure", // RETURN_WARN_WRITE_FAILURE = 3\r
+ "Warning Buffer Too Small", // RETURN_WARN_BUFFER_TOO_SMALL = 4\r
+ "Load Error", // RETURN_LOAD_ERROR = 1 | MAX_BIT\r
+ "Invalid Parameter", // RETURN_INVALID_PARAMETER = 2 | MAX_BIT\r
+ "Unsupported", // RETURN_UNSUPPORTED = 3 | MAX_BIT\r
+ "Bad Buffer Size", // RETURN_BAD_BUFFER_SIZE = 4 | MAX_BIT\r
+ "Buffer Too Small", // RETURN_BUFFER_TOO_SMALL, = 5 | MAX_BIT\r
+ "Not Ready", // RETURN_NOT_READY = 6 | MAX_BIT\r
+ "Device Error", // RETURN_DEVICE_ERROR = 7 | MAX_BIT\r
+ "Write Protected", // RETURN_WRITE_PROTECTED = 8 | MAX_BIT\r
+ "Out of Resources", // RETURN_OUT_OF_RESOURCES = 9 | MAX_BIT\r
+ "Volume Corrupt", // RETURN_VOLUME_CORRUPTED = 10 | MAX_BIT\r
+ "Volume Full", // RETURN_VOLUME_FULL = 11 | MAX_BIT\r
+ "No Media", // RETURN_NO_MEDIA = 12 | MAX_BIT\r
+ "Media changed", // RETURN_MEDIA_CHANGED = 13 | MAX_BIT\r
+ "Not Found", // RETURN_NOT_FOUND = 14 | MAX_BIT\r
+ "Access Denied", // RETURN_ACCESS_DENIED = 15 | MAX_BIT\r
+ "No Response", // RETURN_NO_RESPONSE = 16 | MAX_BIT\r
+ "No mapping", // RETURN_NO_MAPPING = 17 | MAX_BIT\r
+ "Time out", // RETURN_TIMEOUT = 18 | MAX_BIT\r
+ "Not started", // RETURN_NOT_STARTED = 19 | MAX_BIT\r
+ "Already started", // RETURN_ALREADY_STARTED = 20 | MAX_BIT\r
+ "Aborted", // RETURN_ABORTED = 21 | MAX_BIT\r
+ "ICMP Error", // RETURN_ICMP_ERROR = 22 | MAX_BIT\r
+ "TFTP Error", // RETURN_TFTP_ERROR = 23 | MAX_BIT\r
+ "Protocol Error" // RETURN_PROTOCOL_ERROR = 24 | MAX_BIT\r
};\r
\r
-\r
/**\r
Worker function that produces a Null-terminated string in an output buffer \r
based on a Null-terminated format string and a VA_LIST argument list.\r
UINTN Width;\r
UINTN Precision;\r
INT64 Value;\r
- CHAR8 *ArgumentString;\r
+ CONST CHAR8 *ArgumentString;\r
UINTN Character;\r
GUID *TmpGuid;\r
TIME *TmpTime;\r
return 0;\r
}\r
ASSERT (Buffer != NULL);\r
- ASSERT (Format != NULL);\r
\r
OriginalBuffer = Buffer;\r
\r
BytesPerOutputCharacter = 1;\r
}\r
if ((Flags & FORMAT_UNICODE) != 0) {\r
+ //\r
+ // Make sure format string cannot contain more than PcdMaximumUnicodeStringLength\r
+ // Unicode characters if PcdMaximumUnicodeStringLength is not zero. \r
+ //\r
+ ASSERT (StrSize ((CHAR16 *) Format) != 0);\r
BytesPerFormatCharacter = 2;\r
FormatMask = 0xffff;\r
} else {\r
+ //\r
+ // Make sure format string cannot contain more than PcdMaximumUnicodeStringLength\r
+ // Ascii characters if PcdMaximumUnicodeStringLength is not zero. \r
+ //\r
+ ASSERT (AsciiStrSize (Format) != 0);\r
BytesPerFormatCharacter = 1;\r
FormatMask = 0xff;\r
}\r
case 'r':\r
Status = VA_ARG (Marker, RETURN_STATUS);\r
ArgumentString = ValueBuffer;\r
- for (Index = 0; StatusString[Index].String != NULL; Index++) {\r
- if (Status == StatusString[Index].Status) {\r
- ArgumentString = StatusString[Index].String;\r
+ if (RETURN_ERROR (Status)) {\r
+ //\r
+ // Clear error bit\r
+ //\r
+ Index = Status & ~MAX_BIT;\r
+ if (Index > 0 && Index <= ERROR_STATUS_NUMBER) {\r
+ ArgumentString = StatusString [Index + WARNING_STATUS_NUMBER];\r
+ }\r
+ } else {\r
+ Index = Status;\r
+ if (Index <= WARNING_STATUS_NUMBER) {\r
+ ArgumentString = StatusString [Index];\r
}\r
}\r
if (ArgumentString == ValueBuffer) {\r
break;\r
\r
case '\n':\r
- ArgumentString = "\r\n";\r
+ ArgumentString = "\n\r";\r
break;\r
\r
case '%':\r
break;\r
}\r
break;\r
+ \r
+ case '\n':\r
+ ArgumentString = "\n\r";\r
+ break;\r
+\r
default:\r
ArgumentString = (CHAR8 *)&FormatCharacter;\r
Flags |= ARGUMENT_UNICODE;\r
// Null terminate the Unicode or ASCII string\r
//\r
Buffer = BasePrintLibFillBuffer (Buffer, 1, 0, BytesPerOutputCharacter);\r
+ //\r
+ // Make sure output buffer cannot contain more than PcdMaximumUnicodeStringLength\r
+ // Unicode characters if PcdMaximumUnicodeStringLength is not zero. \r
+ //\r
+ ASSERT ((((Flags & OUTPUT_UNICODE) == 0)) || (StrSize ((CHAR16 *) OriginalBuffer) != 0));\r
+ //\r
+ // Make sure output buffer cannot contain more than PcdMaximumUnicodeStringLength\r
+ // Ascii characters if PcdMaximumUnicodeStringLength is not zero. \r
+ //\r
+ ASSERT ((((Flags & OUTPUT_UNICODE) != 0)) || (AsciiStrSize (OriginalBuffer) != 0));\r
\r
+\r
return ((Buffer - OriginalBuffer) / BytesPerOutputCharacter);\r
}\r
\r
\r
#define SMBUS_LIB_SLAVE_ADDRESS(SmBusAddress) (((SmBusAddress) >> 1) & 0x7f)\r
#define SMBUS_LIB_COMMAND(SmBusAddress) (((SmBusAddress) >> 8) & 0xff)\r
-#define SMBUS_LIB_LENGTH(SmBusAddress) (((SmBusAddress) >> 16) & 0x1f)\r
+#define SMBUS_LIB_LENGTH(SmBusAddress) (((SmBusAddress) >> 16) & 0x3f)\r
#define SMBUS_LIB_PEC(SmBusAddress) ((BOOLEAN) (((SmBusAddress) & SMBUS_LIB_PEC_BIT) != 0))\r
-#define SMBUS_LIB_RESEARVED(SmBusAddress) ((SmBusAddress) & ~(((1 << 21) - 2) | SMBUS_LIB_PEC_BIT))\r
+#define SMBUS_LIB_RESEARVED(SmBusAddress) ((SmBusAddress) & ~(((1 << 22) - 2) | SMBUS_LIB_PEC_BIT))\r
\r
//\r
// Replaced by PCD\r
Bytes are read from the SMBUS and stored in Buffer.\r
The number of bytes read is returned, and will never return a value larger than 32-bytes.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure Buffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
\r
@param HostControl The value of Host Control Register to set. \r
@param SmBusAddress Address that encodes the SMBUS Slave Address,\r
SMBUS Command, SMBUS Data Length, and PEC.\r
- @param OutBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
- @param InBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
+ @param WriteBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
+ @param ReadBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
@param Status Return status for the executed command.\r
This is an optional parameter and may be NULL.\r
\r
InternalSmBusBlock (\r
IN UINT8 HostControl,\r
IN UINTN SmBusAddress,\r
- IN UINT8 *OutBuffer,\r
- OUT UINT8 *InBuffer,\r
+ IN UINT8 *WriteBuffer,\r
+ OUT UINT8 *ReadBuffer,\r
OUT RETURN_STATUS *Status\r
)\r
{\r
UINTN BytesCount;\r
UINT8 AuxiliaryControl;\r
\r
- BytesCount = SMBUS_LIB_LENGTH (SmBusAddress) + 1;\r
+ BytesCount = SMBUS_LIB_LENGTH (SmBusAddress);\r
\r
ReturnStatus = InternalSmBusAcquire ();\r
if (RETURN_ERROR (ReturnStatus)) {\r
\r
InternalSmBusIoWrite8 (SMBUS_R_HST_D0, (UINT8) BytesCount);\r
\r
- if (OutBuffer != NULL) {\r
+ if (WriteBuffer != NULL) {\r
for (Index = 0; Index < BytesCount; Index++) {\r
- InternalSmBusIoWrite8 (SMBUS_R_HOST_BLOCK_DB, OutBuffer[Index]);\r
+ InternalSmBusIoWrite8 (SMBUS_R_HOST_BLOCK_DB, WriteBuffer[Index]);\r
}\r
}\r
//\r
}\r
\r
BytesCount = InternalSmBusIoRead8 (SMBUS_R_HST_D0);\r
- if (InBuffer != NULL) {\r
+ if (ReadBuffer != NULL) {\r
for (Index = 0; Index < BytesCount; Index++) {\r
- InBuffer[Index] = InternalSmBusIoRead8 (SMBUS_R_HOST_BLOCK_DB);\r
+ ReadBuffer[Index] = InternalSmBusIoRead8 (SMBUS_R_HOST_BLOCK_DB);\r
}\r
}\r
\r
Bytes are read from the SMBUS and stored in Buffer.\r
The number of bytes read is returned, and will never return a value larger than 32-bytes.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure Buffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
If Length in SmBusAddress is not zero, then ASSERT().\r
If Buffer is NULL, then ASSERT().\r
)\r
{\r
ASSERT (Buffer != NULL);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) >= 1);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) <= 32);\r
ASSERT (SMBUS_LIB_RESEARVED (SmBusAddress) == 0);\r
\r
return InternalSmBusBlock (\r
\r
Executes an SMBUS block process call command on the SMBUS device specified by SmBusAddress.\r
The SMBUS slave address, SMBUS command, and SMBUS length fields of SmBusAddress are required.\r
- Bytes are written to the SMBUS from OutBuffer. Bytes are then read from the SMBUS into InBuffer.\r
+ Bytes are written to the SMBUS from WriteBuffer. Bytes are then read from the SMBUS into ReadBuffer.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure InBuffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure ReadBuffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
- If OutBuffer is NULL, then ASSERT().\r
- If InBuffer is NULL, then ASSERT().\r
+ If Length in SmBusAddress is zero or greater than 32, then ASSERT().\r
+ If WriteBuffer is NULL, then ASSERT().\r
+ If ReadBuffer is NULL, then ASSERT().\r
If any reserved bits of SmBusAddress are set, then ASSERT().\r
\r
@param SmBusAddress Address that encodes the SMBUS Slave Address,\r
SMBUS Command, SMBUS Data Length, and PEC.\r
- @param OutBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
- @param InBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
+ @param WriteBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
+ @param ReadBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
@param Status Return status for the executed command.\r
This is an optional parameter and may be NULL.\r
\r
EFIAPI\r
SmBusBlockProcessCall (\r
IN UINTN SmBusAddress,\r
- IN VOID *OutBuffer,\r
- OUT VOID *InBuffer,\r
+ IN VOID *WriteBuffer,\r
+ OUT VOID *ReadBuffer,\r
OUT RETURN_STATUS *Status OPTIONAL\r
)\r
{\r
- ASSERT (InBuffer != NULL);\r
- ASSERT (OutBuffer != NULL);\r
+ ASSERT (WriteBuffer != NULL);\r
+ ASSERT (ReadBuffer != NULL);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) >= 1);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) <= 32);\r
ASSERT (SMBUS_LIB_RESEARVED (SmBusAddress) == 0);\r
\r
return InternalSmBusBlock (\r
SMBUS_V_SMB_CMD_BLOCK_PROCESS,\r
SmBusAddress | SMBUS_B_WRITE,\r
- OutBuffer,\r
- InBuffer,\r
+ WriteBuffer,\r
+ ReadBuffer,\r
Status\r
);\r
}\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
\r
-Module Name: SmbusLib.c\r
-\r
**/\r
\r
#ifndef __INTERNAL_SMBUS_LIB_H\r
\r
#define SMBUS_LIB_SLAVE_ADDRESS(SmBusAddress) (((SmBusAddress) >> 1) & 0x7f)\r
#define SMBUS_LIB_COMMAND(SmBusAddress) (((SmBusAddress) >> 8) & 0xff)\r
-#define SMBUS_LIB_LENGTH(SmBusAddress) (((SmBusAddress) >> 16) & 0x1f)\r
+#define SMBUS_LIB_LENGTH(SmBusAddress) (((SmBusAddress) >> 16) & 0x3f)\r
#define SMBUS_LIB_PEC(SmBusAddress) ((BOOLEAN) (((SmBusAddress) & SMBUS_LIB_PEC_BIT) != 0))\r
-#define SMBUS_LIB_RESEARVED(SmBusAddress) ((SmBusAddress) & ~(((1 << 21) - 2) | SMBUS_LIB_PEC_BIT))\r
+#define SMBUS_LIB_RESEARVED(SmBusAddress) ((SmBusAddress) & ~(((1 << 22) - 2) | SMBUS_LIB_PEC_BIT))\r
\r
//\r
// Declaration for internal functions\r
Bytes are read from the SMBUS and stored in Buffer.\r
The number of bytes read is returned, and will never return a value larger than 32-bytes.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure Buffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
If Length in SmBusAddress is not zero, then ASSERT().\r
If Buffer is NULL, then ASSERT().\r
UINTN Length;\r
\r
ASSERT (Buffer != NULL);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) >= 1);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) <= 32);\r
ASSERT (SMBUS_LIB_RESEARVED (SmBusAddress) == 0);\r
\r
- Length = SMBUS_LIB_LENGTH (SmBusAddress) + 1;\r
+ Length = SMBUS_LIB_LENGTH (SmBusAddress);\r
return InternalSmBusExec (EfiSmbusWriteBlock, SmBusAddress, Length, Buffer, Status);\r
}\r
\r
\r
Executes an SMBUS block process call command on the SMBUS device specified by SmBusAddress.\r
The SMBUS slave address, SMBUS command, and SMBUS length fields of SmBusAddress are required.\r
- Bytes are written to the SMBUS from OutBuffer. Bytes are then read from the SMBUS into InBuffer.\r
+ Bytes are written to the SMBUS from WriteBuffer. Bytes are then read from the SMBUS into ReadBuffer.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure InBuffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure ReadBuffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
- If OutBuffer is NULL, then ASSERT().\r
- If InBuffer is NULL, then ASSERT().\r
+ If Length in SmBusAddress is zero or greater than 32, then ASSERT().\r
+ If WriteBuffer is NULL, then ASSERT().\r
+ If ReadBuffer is NULL, then ASSERT().\r
If any reserved bits of SmBusAddress are set, then ASSERT().\r
\r
-\r
@param SmBusAddress Address that encodes the SMBUS Slave Address,\r
SMBUS Command, SMBUS Data Length, and PEC.\r
- @param OutBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
- @param InBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
+ @param WriteBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
+ @param ReadBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
@param Status Return status for the executed command.\r
This is an optional parameter and may be NULL.\r
\r
EFIAPI\r
SmBusBlockProcessCall (\r
IN UINTN SmBusAddress,\r
- IN VOID *OutBuffer,\r
- OUT VOID *InBuffer,\r
+ IN VOID *WriteBuffer,\r
+ OUT VOID *ReadBuffer,\r
OUT RETURN_STATUS *Status OPTIONAL\r
)\r
{\r
UINTN Length;\r
\r
- ASSERT (InBuffer != NULL);\r
- ASSERT (OutBuffer != NULL);\r
+ ASSERT (WriteBuffer != NULL);\r
+ ASSERT (ReadBuffer != NULL);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) >= 1);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) <= 32);\r
ASSERT (SMBUS_LIB_RESEARVED (SmBusAddress) == 0);\r
\r
- Length = SMBUS_LIB_LENGTH (SmBusAddress) + 1;\r
+ Length = SMBUS_LIB_LENGTH (SmBusAddress);\r
//\r
- // Assuming that InBuffer is large enough to save another memory copy.\r
+ // Assuming that ReadBuffer is large enough to save another memory copy.\r
//\r
- InBuffer = CopyMem (InBuffer, OutBuffer, Length);\r
- return InternalSmBusExec (EfiSmbusBWBRProcessCall, SmBusAddress, Length, InBuffer, Status);\r
+ ReadBuffer = CopyMem (ReadBuffer, WriteBuffer, Length);\r
+ return InternalSmBusExec (EfiSmbusBWBRProcessCall, SmBusAddress, Length, ReadBuffer, Status);\r
}\r
#include "MemLibInternals.h"\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
IN UINTN Length\r
)\r
{\r
- ASSERT (DestinationBuffer != NULL);\r
- ASSERT (SourceBuffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)DestinationBuffer + 1);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)SourceBuffer + 1);\r
if (Length == 0) {\r
return 0;\r
}\r
+ ASSERT (DestinationBuffer != NULL);\r
+ ASSERT (SourceBuffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
IN UINTN Length\r
)\r
{\r
- ASSERT (Length > 0);\r
while ((--Length != 0) &&\r
(*(INT8*)DestinationBuffer == *(INT8*)SourceBuffer)) {\r
DestinationBuffer = (INT8*)DestinationBuffer + 1;\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT16 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT32 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT64 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINT8 Value\r
)\r
{\r
- ASSERT (Buffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
-\r
- if ((Length /= sizeof (Value)) == 0) {\r
+ if (Length == 0) {\r
return NULL;\r
}\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+ \r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT16 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem16 (Buffer, Length, Value);\r
+ return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT32 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem32 (Buffer, Length, Value);\r
+ return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT64 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem64 (Buffer, Length, Value);\r
+ return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @param Buffer Memory to set.\r
- @param Size 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
IN VOID *Buffer,\r
- IN UINTN Size,\r
+ IN UINTN Length,\r
IN UINT8 Value\r
)\r
{\r
- if (Size == 0) {\r
+ if (Length == 0) {\r
return Buffer;\r
}\r
- ASSERT (Size - 1 <= MAX_ADDRESS - (UINTN)Buffer);\r
- return InternalMemSetMem (Buffer, Size, Value);\r
+\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+\r
+ return InternalMemSetMem (Buffer, Length, Value);\r
}\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
\r
\r
-Module Name: SmbusLib.c\r
-\r
**/\r
\r
#ifndef __INTERNAL_SMBUS_LIB_H\r
\r
#define SMBUS_LIB_SLAVE_ADDRESS(SmBusAddress) (((SmBusAddress) >> 1) & 0x7f)\r
#define SMBUS_LIB_COMMAND(SmBusAddress) (((SmBusAddress) >> 8) & 0xff)\r
-#define SMBUS_LIB_LENGTH(SmBusAddress) (((SmBusAddress) >> 16) & 0x1f)\r
+#define SMBUS_LIB_LENGTH(SmBusAddress) (((SmBusAddress) >> 16) & 0x3f)\r
#define SMBUS_LIB_PEC(SmBusAddress) ((BOOLEAN) (((SmBusAddress) & SMBUS_LIB_PEC_BIT) != 0))\r
-#define SMBUS_LIB_RESEARVED(SmBusAddress) ((SmBusAddress) & ~(((1 << 21) - 2) | SMBUS_LIB_PEC_BIT))\r
+#define SMBUS_LIB_RESEARVED(SmBusAddress) ((SmBusAddress) & ~(((1 << 22) - 2) | SMBUS_LIB_PEC_BIT))\r
\r
//\r
// Declaration for internal functions\r
Bytes are read from the SMBUS and stored in Buffer.\r
The number of bytes read is returned, and will never return a value larger than 32-bytes.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure Buffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
If Length in SmBusAddress is not zero, then ASSERT().\r
If Buffer is NULL, then ASSERT().\r
UINTN Length;\r
\r
ASSERT (Buffer != NULL);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) >= 1);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) <= 32);\r
ASSERT (SMBUS_LIB_RESEARVED (SmBusAddress) == 0);\r
\r
- Length = SMBUS_LIB_LENGTH (SmBusAddress) + 1;\r
+ Length = SMBUS_LIB_LENGTH (SmBusAddress);\r
return InternalSmBusExec (EfiSmbusWriteBlock, SmBusAddress, Length, Buffer, Status);\r
}\r
\r
\r
Executes an SMBUS block process call command on the SMBUS device specified by SmBusAddress.\r
The SMBUS slave address, SMBUS command, and SMBUS length fields of SmBusAddress are required.\r
- Bytes are written to the SMBUS from OutBuffer. Bytes are then read from the SMBUS into InBuffer.\r
+ Bytes are written to the SMBUS from WriteBuffer. Bytes are then read from the SMBUS into ReadBuffer.\r
If Status is not NULL, then the status of the executed command is returned in Status.\r
- It is the caller¡¯s responsibility to make sure InBuffer is large enough for the total number of bytes read.\r
+ It is the caller's responsibility to make sure ReadBuffer is large enough for the total number of bytes read.\r
SMBUS supports a maximum transfer size of 32 bytes, so Buffer does not need to be any larger than 32 bytes.\r
- If OutBuffer is NULL, then ASSERT().\r
- If InBuffer is NULL, then ASSERT().\r
+ If Length in SmBusAddress is zero or greater than 32, then ASSERT().\r
+ If WriteBuffer is NULL, then ASSERT().\r
+ If ReadBuffer is NULL, then ASSERT().\r
If any reserved bits of SmBusAddress are set, then ASSERT().\r
\r
-\r
@param SmBusAddress Address that encodes the SMBUS Slave Address,\r
SMBUS Command, SMBUS Data Length, and PEC.\r
- @param OutBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
- @param InBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
+ @param WriteBuffer Pointer to the buffer of bytes to write to the SMBUS.\r
+ @param ReadBuffer Pointer to the buffer of bytes to read from the SMBUS.\r
@param Status Return status for the executed command.\r
This is an optional parameter and may be NULL.\r
\r
EFIAPI\r
SmBusBlockProcessCall (\r
IN UINTN SmBusAddress,\r
- IN VOID *OutBuffer,\r
- OUT VOID *InBuffer,\r
+ IN VOID *WriteBuffer,\r
+ OUT VOID *ReadBuffer,\r
OUT RETURN_STATUS *Status OPTIONAL\r
)\r
{\r
UINTN Length;\r
\r
- ASSERT (InBuffer != NULL);\r
- ASSERT (OutBuffer != NULL);\r
+ ASSERT (WriteBuffer != NULL);\r
+ ASSERT (ReadBuffer != NULL);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) >= 1);\r
+ ASSERT (SMBUS_LIB_LENGTH (SmBusAddress) <= 32);\r
ASSERT (SMBUS_LIB_RESEARVED (SmBusAddress) == 0);\r
\r
- Length = SMBUS_LIB_LENGTH (SmBusAddress) + 1;\r
+ Length = SMBUS_LIB_LENGTH (SmBusAddress);\r
//\r
- // Assuming that InBuffer is large enough to save another memory copy.\r
+ // Assuming that ReadBuffer is large enough to save another memory copy.\r
//\r
- InBuffer = CopyMem (InBuffer, OutBuffer, Length);\r
- return InternalSmBusExec (EfiSmbusBWBRProcessCall, SmBusAddress, Length, InBuffer, Status);\r
+ ReadBuffer = CopyMem (ReadBuffer, WriteBuffer, Length);\r
+ return InternalSmBusExec (EfiSmbusBWBRProcessCall, SmBusAddress, Length, ReadBuffer, Status);\r
}\r
#include "MemLibInternals.h"\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
IN UINTN Length\r
)\r
{\r
- ASSERT (DestinationBuffer != NULL);\r
- ASSERT (SourceBuffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)DestinationBuffer + 1);\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)SourceBuffer + 1);\r
if (Length == 0) {\r
return 0;\r
}\r
+ ASSERT (DestinationBuffer != NULL);\r
+ ASSERT (SourceBuffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));\r
+\r
return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);\r
}\r
IN UINTN Length\r
)\r
{\r
- ASSERT (Length > 0);\r
while ((--Length != 0) &&\r
(*(INT8*)DestinationBuffer == *(INT8*)SourceBuffer)) {\r
DestinationBuffer = (INT8*)DestinationBuffer + 1;\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT16 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem16 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT32 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem32 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ 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
- 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
-\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
IN UINT64 Value\r
)\r
{\r
+ if (Length == 0) {\r
+ return NULL;\r
+ }\r
+\r
ASSERT (Buffer != NULL);\r
ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return NULL;\r
- }\r
- return (VOID*)InternalMemScanMem64 (Buffer, Length, Value);\r
+ return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
IN UINT8 Value\r
)\r
{\r
- ASSERT (Buffer != NULL);\r
- ASSERT (Length <= MAX_ADDRESS + (UINTN)Buffer + 1);\r
-\r
- if ((Length /= sizeof (Value)) == 0) {\r
+ if (Length == 0) {\r
return NULL;\r
}\r
- return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+ \r
+ return (VOID*)InternalMemScanMem8 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT16 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem16 (Buffer, Length, Value);\r
+ return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT32 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem32 (Buffer, Length, Value);\r
+ return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);\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 and Length > 0, 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
IN UINT64 Value\r
)\r
{\r
- ASSERT (!(Buffer == NULL && Length > 0));\r
- ASSERT (Length <= MAX_ADDRESS - (UINTN)Buffer + 1);\r
+ if (Length == 0) {\r
+ return Buffer;\r
+ }\r
+\r
+ ASSERT (Buffer != NULL);\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);\r
ASSERT ((Length & (sizeof (Value) - 1)) == 0);\r
\r
- if ((Length /= sizeof (Value)) == 0) {\r
- return Buffer;\r
- }\r
- return InternalMemSetMem64 (Buffer, Length, Value);\r
+ return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);\r
}\r
#include "MemLibInternals.h"\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
+ @param Buffer Memory to set.\r
+ @param Length Number of bytes to set\r
+ @param Value Value of the set operation.\r
\r
- @param Buffer Memory to set.\r
- @param Size 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
IN VOID *Buffer,\r
- IN UINTN Size,\r
+ IN UINTN Length,\r
IN UINT8 Value\r
)\r
{\r
- if (Size == 0) {\r
+ if (Length == 0) {\r
return Buffer;\r
}\r
- ASSERT (Size - 1 <= MAX_ADDRESS - (UINTN)Buffer);\r
- return InternalMemSetMem (Buffer, Size, Value);\r
+\r
+ ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));\r
+\r
+ return InternalMemSetMem (Buffer, Length, Value);\r
}\r
projects / mirror_edk2.git / commitdiff