Add new extension PerformanceLib APIs to store ID info.
Signed-off-by: Star Zeng <star.zeng@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com> git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@13215 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
@@ -3,13 +3,13 @@
|
||||
|
||||
This library provides the performance measurement interfaces and initializes performance
|
||||
logging for the SMM phase.
|
||||
It initializes SMM phase performance logging by publishing the Performance Protocol,
|
||||
It initializes SMM phase performance logging by publishing the SMM Performance and PerformanceEx Protocol,
|
||||
which is consumed by SmmPerformanceLib to logging performance data in SMM phase.
|
||||
|
||||
This library is mainly used by SMM Core to start performance logging to ensure that
|
||||
SMM Performance Protocol is installed at the very beginning of SMM phase.
|
||||
SMM Performance and PerformanceEx Protocol are installed at the very beginning of SMM phase.
|
||||
|
||||
Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>
|
||||
Copyright (c) 2011 - 2012, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
which accompanies this distribution. The full text of the license may be found at
|
||||
@@ -48,7 +48,7 @@ EFI_SMRAM_DESCRIPTOR *mSmramRanges;
|
||||
UINTN mSmramRangeCount;
|
||||
|
||||
//
|
||||
// Interfaces for performance protocol.
|
||||
// Interfaces for SMM Performance Protocol.
|
||||
//
|
||||
PERFORMANCE_PROTOCOL mPerformanceInterface = {
|
||||
StartGauge,
|
||||
@@ -56,11 +56,20 @@ PERFORMANCE_PROTOCOL mPerformanceInterface = {
|
||||
GetGauge
|
||||
};
|
||||
|
||||
//
|
||||
// Interfaces for SMM PerformanceEx Protocol.
|
||||
//
|
||||
PERFORMANCE_EX_PROTOCOL mPerformanceExInterface = {
|
||||
StartGaugeEx,
|
||||
EndGaugeEx,
|
||||
GetGaugeEx
|
||||
};
|
||||
|
||||
/**
|
||||
Searches in the gauge array with keyword Handle, Token and Module.
|
||||
Searches in the gauge array with keyword Handle, Token, Module and Identfier.
|
||||
|
||||
This internal function searches for the gauge entry in the gauge array.
|
||||
If there is an entry that exactly matches the given key word triple
|
||||
If there is an entry that exactly matches the given keywords
|
||||
and its end time stamp is zero, then the index of that gauge entry is returned;
|
||||
otherwise, the the number of gauge entries in the array is returned.
|
||||
|
||||
@@ -70,6 +79,7 @@ PERFORMANCE_PROTOCOL mPerformanceInterface = {
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param Identifier 32-bit identifier.
|
||||
|
||||
@retval The index of gauge entry in the array.
|
||||
|
||||
@@ -78,12 +88,13 @@ UINT32
|
||||
SmmSearchForGaugeEntry (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN CONST UINT32 Identifier
|
||||
)
|
||||
{
|
||||
UINT32 Index;
|
||||
UINT32 NumberOfEntries;
|
||||
GAUGE_DATA_ENTRY *GaugeEntryArray;
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryExArray;
|
||||
|
||||
if (Token == NULL) {
|
||||
Token = "";
|
||||
@@ -93,13 +104,14 @@ SmmSearchForGaugeEntry (
|
||||
}
|
||||
|
||||
NumberOfEntries = mGaugeData->NumberOfEntries;
|
||||
GaugeEntryArray = (GAUGE_DATA_ENTRY *) (mGaugeData + 1);
|
||||
GaugeEntryExArray = (GAUGE_DATA_ENTRY_EX *) (mGaugeData + 1);
|
||||
|
||||
for (Index = 0; Index < NumberOfEntries; Index++) {
|
||||
if ((GaugeEntryArray[Index].Handle == (EFI_PHYSICAL_ADDRESS) (UINTN) Handle) &&
|
||||
AsciiStrnCmp (GaugeEntryArray[Index].Token, Token, SMM_PERFORMANCE_STRING_LENGTH) == 0 &&
|
||||
AsciiStrnCmp (GaugeEntryArray[Index].Module, Module, SMM_PERFORMANCE_STRING_LENGTH) == 0 &&
|
||||
GaugeEntryArray[Index].EndTimeStamp == 0) {
|
||||
if ((GaugeEntryExArray[Index].Handle == (EFI_PHYSICAL_ADDRESS) (UINTN) Handle) &&
|
||||
AsciiStrnCmp (GaugeEntryExArray[Index].Token, Token, SMM_PERFORMANCE_STRING_LENGTH) == 0 &&
|
||||
AsciiStrnCmp (GaugeEntryExArray[Index].Module, Module, SMM_PERFORMANCE_STRING_LENGTH) == 0 &&
|
||||
(GaugeEntryExArray[Index].Identifier == Identifier) &&
|
||||
GaugeEntryExArray[Index].EndTimeStamp == 0) {
|
||||
break;
|
||||
}
|
||||
}
|
||||
@@ -107,6 +119,208 @@ SmmSearchForGaugeEntry (
|
||||
return Index;
|
||||
}
|
||||
|
||||
/**
|
||||
Adds a record at the end of the performance measurement log
|
||||
that records the start time of a performance measurement.
|
||||
|
||||
Adds a record to the end of the performance measurement log
|
||||
that contains the Handle, Token, Module and Identifier.
|
||||
The end time of the new record must be set to zero.
|
||||
If TimeStamp is not zero, then TimeStamp is used to fill in the start time in the record.
|
||||
If TimeStamp is zero, the start time in the record is filled in with the value
|
||||
read from the current time stamp.
|
||||
|
||||
@param Handle Pointer to environment specific context used
|
||||
to identify the component being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param TimeStamp 64-bit time stamp.
|
||||
@param Identifier 32-bit identifier. If the value is 0, the created record
|
||||
is same as the one created by StartGauge of PERFORMANCE_PROTOCOL.
|
||||
|
||||
@retval EFI_SUCCESS The data was read correctly from the device.
|
||||
@retval EFI_OUT_OF_RESOURCES There are not enough resources to record the measurement.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
StartGaugeEx (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN UINT64 TimeStamp,
|
||||
IN UINT32 Identifier
|
||||
)
|
||||
{
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryExArray;
|
||||
UINTN GaugeDataSize;
|
||||
GAUGE_DATA_HEADER *NewGaugeData;
|
||||
UINTN OldGaugeDataSize;
|
||||
GAUGE_DATA_HEADER *OldGaugeData;
|
||||
UINT32 Index;
|
||||
|
||||
AcquireSpinLock (&mSmmPerfLock);
|
||||
|
||||
Index = mGaugeData->NumberOfEntries;
|
||||
if (Index >= mMaxGaugeRecords) {
|
||||
//
|
||||
// Try to enlarge the scale of gauge array.
|
||||
//
|
||||
OldGaugeData = mGaugeData;
|
||||
OldGaugeDataSize = sizeof (GAUGE_DATA_HEADER) + sizeof (GAUGE_DATA_ENTRY_EX) * mMaxGaugeRecords;
|
||||
|
||||
GaugeDataSize = sizeof (GAUGE_DATA_HEADER) + sizeof (GAUGE_DATA_ENTRY_EX) * mMaxGaugeRecords * 2;
|
||||
|
||||
NewGaugeData = AllocateZeroPool (GaugeDataSize);
|
||||
if (NewGaugeData == NULL) {
|
||||
ReleaseSpinLock (&mSmmPerfLock);
|
||||
return EFI_OUT_OF_RESOURCES;
|
||||
}
|
||||
|
||||
mGaugeData = NewGaugeData;
|
||||
mMaxGaugeRecords *= 2;
|
||||
|
||||
//
|
||||
// Initialize new data array and migrate old data one.
|
||||
//
|
||||
mGaugeData = CopyMem (mGaugeData, OldGaugeData, OldGaugeDataSize);
|
||||
|
||||
FreePool (OldGaugeData);
|
||||
}
|
||||
|
||||
GaugeEntryExArray = (GAUGE_DATA_ENTRY_EX *) (mGaugeData + 1);
|
||||
GaugeEntryExArray[Index].Handle = (EFI_PHYSICAL_ADDRESS) (UINTN) Handle;
|
||||
|
||||
if (Token != NULL) {
|
||||
AsciiStrnCpy (GaugeEntryExArray[Index].Token, Token, SMM_PERFORMANCE_STRING_LENGTH);
|
||||
}
|
||||
if (Module != NULL) {
|
||||
AsciiStrnCpy (GaugeEntryExArray[Index].Module, Module, SMM_PERFORMANCE_STRING_LENGTH);
|
||||
}
|
||||
|
||||
GaugeEntryExArray[Index].EndTimeStamp = 0;
|
||||
GaugeEntryExArray[Index].Identifier = Identifier;
|
||||
|
||||
if (TimeStamp == 0) {
|
||||
TimeStamp = GetPerformanceCounter ();
|
||||
}
|
||||
GaugeEntryExArray[Index].StartTimeStamp = TimeStamp;
|
||||
|
||||
mGaugeData->NumberOfEntries++;
|
||||
|
||||
ReleaseSpinLock (&mSmmPerfLock);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Searches the performance measurement log from the beginning of the log
|
||||
for the first matching record that contains a zero end time and fills in a valid end time.
|
||||
|
||||
Searches the performance measurement log from the beginning of the log
|
||||
for the first record that matches Handle, Token, Module and Identifier and has an end time value of zero.
|
||||
If the record can not be found then return EFI_NOT_FOUND.
|
||||
If the record is found and TimeStamp is not zero,
|
||||
then the end time in the record is filled in with the value specified by TimeStamp.
|
||||
If the record is found and TimeStamp is zero, then the end time in the matching record
|
||||
is filled in with the current time stamp value.
|
||||
|
||||
@param Handle Pointer to environment specific context used
|
||||
to identify the component being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param TimeStamp 64-bit time stamp.
|
||||
@param Identifier 32-bit identifier. If the value is 0, the found record
|
||||
is same as the one found by EndGauge of PERFORMANCE_PROTOCOL.
|
||||
|
||||
@retval EFI_SUCCESS The end of the measurement was recorded.
|
||||
@retval EFI_NOT_FOUND The specified measurement record could not be found.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
EndGaugeEx (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN UINT64 TimeStamp,
|
||||
IN UINT32 Identifier
|
||||
)
|
||||
{
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryExArray;
|
||||
UINT32 Index;
|
||||
|
||||
AcquireSpinLock (&mSmmPerfLock);
|
||||
|
||||
if (TimeStamp == 0) {
|
||||
TimeStamp = GetPerformanceCounter ();
|
||||
}
|
||||
|
||||
Index = SmmSearchForGaugeEntry (Handle, Token, Module, Identifier);
|
||||
if (Index >= mGaugeData->NumberOfEntries) {
|
||||
ReleaseSpinLock (&mSmmPerfLock);
|
||||
return EFI_NOT_FOUND;
|
||||
}
|
||||
GaugeEntryExArray = (GAUGE_DATA_ENTRY_EX *) (mGaugeData + 1);
|
||||
GaugeEntryExArray[Index].EndTimeStamp = TimeStamp;
|
||||
|
||||
ReleaseSpinLock (&mSmmPerfLock);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Retrieves a previously logged performance measurement.
|
||||
It can also retrieve the log created by StartGauge and EndGauge of PERFORMANCE_PROTOCOL,
|
||||
and then assign the Identifier with 0.
|
||||
|
||||
Retrieves the performance log entry from the performance log specified by LogEntryKey.
|
||||
If it stands for a valid entry, then EFI_SUCCESS is returned and
|
||||
GaugeDataEntryEx stores the pointer to that entry.
|
||||
|
||||
@param LogEntryKey The key for the previous performance measurement log entry.
|
||||
If 0, then the first performance measurement log entry is retrieved.
|
||||
@param GaugeDataEntryEx The indirect pointer to the extended gauge data entry specified by LogEntryKey
|
||||
if the retrieval is successful.
|
||||
|
||||
@retval EFI_SUCCESS The GuageDataEntryEx is successfully found based on LogEntryKey.
|
||||
@retval EFI_NOT_FOUND The LogEntryKey is the last entry (equals to the total entry number).
|
||||
@retval EFI_INVALIDE_PARAMETER The LogEntryKey is not a valid entry (greater than the total entry number).
|
||||
@retval EFI_INVALIDE_PARAMETER GaugeDataEntryEx is NULL.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
GetGaugeEx (
|
||||
IN UINTN LogEntryKey,
|
||||
OUT GAUGE_DATA_ENTRY_EX **GaugeDataEntryEx
|
||||
)
|
||||
{
|
||||
UINTN NumberOfEntries;
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryExArray;
|
||||
|
||||
NumberOfEntries = (UINTN) (mGaugeData->NumberOfEntries);
|
||||
if (LogEntryKey > NumberOfEntries) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
if (LogEntryKey == NumberOfEntries) {
|
||||
return EFI_NOT_FOUND;
|
||||
}
|
||||
|
||||
GaugeEntryExArray = (GAUGE_DATA_ENTRY_EX *) (mGaugeData + 1);
|
||||
|
||||
if (GaugeDataEntryEx == NULL) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
*GaugeDataEntryEx = &GaugeEntryExArray[LogEntryKey];
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Adds a record at the end of the performance measurement log
|
||||
that records the start time of a performance measurement.
|
||||
@@ -139,57 +353,7 @@ StartGauge (
|
||||
IN UINT64 TimeStamp
|
||||
)
|
||||
{
|
||||
GAUGE_DATA_ENTRY *GaugeEntryArray;
|
||||
UINTN GaugeDataSize;
|
||||
UINTN OldGaugeDataSize;
|
||||
GAUGE_DATA_HEADER *OldGaugeData;
|
||||
UINT32 Index;
|
||||
|
||||
AcquireSpinLock (&mSmmPerfLock);
|
||||
|
||||
Index = mGaugeData->NumberOfEntries;
|
||||
if (Index >= mMaxGaugeRecords) {
|
||||
//
|
||||
// Try to enlarge the scale of gauge array.
|
||||
//
|
||||
OldGaugeData = mGaugeData;
|
||||
OldGaugeDataSize = sizeof (GAUGE_DATA_HEADER) + sizeof (GAUGE_DATA_ENTRY) * mMaxGaugeRecords;
|
||||
|
||||
mMaxGaugeRecords *= 2;
|
||||
GaugeDataSize = sizeof (GAUGE_DATA_HEADER) + sizeof (GAUGE_DATA_ENTRY) * mMaxGaugeRecords;
|
||||
|
||||
mGaugeData = AllocateZeroPool (GaugeDataSize);
|
||||
if (mGaugeData == NULL) {
|
||||
return EFI_OUT_OF_RESOURCES;
|
||||
}
|
||||
//
|
||||
// Initialize new data array and migrate old data one.
|
||||
//
|
||||
mGaugeData = CopyMem (mGaugeData, OldGaugeData, OldGaugeDataSize);
|
||||
|
||||
FreePool (OldGaugeData);
|
||||
}
|
||||
|
||||
GaugeEntryArray = (GAUGE_DATA_ENTRY *) (mGaugeData + 1);
|
||||
GaugeEntryArray[Index].Handle = (EFI_PHYSICAL_ADDRESS) (UINTN) Handle;
|
||||
|
||||
if (Token != NULL) {
|
||||
AsciiStrnCpy (GaugeEntryArray[Index].Token, Token, SMM_PERFORMANCE_STRING_LENGTH);
|
||||
}
|
||||
if (Module != NULL) {
|
||||
AsciiStrnCpy (GaugeEntryArray[Index].Module, Module, SMM_PERFORMANCE_STRING_LENGTH);
|
||||
}
|
||||
|
||||
if (TimeStamp == 0) {
|
||||
TimeStamp = GetPerformanceCounter ();
|
||||
}
|
||||
GaugeEntryArray[Index].StartTimeStamp = TimeStamp;
|
||||
|
||||
mGaugeData->NumberOfEntries++;
|
||||
|
||||
ReleaseSpinLock (&mSmmPerfLock);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
return StartGaugeEx (Handle, Token, Module, TimeStamp, 0);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -225,25 +389,13 @@ EndGauge (
|
||||
IN UINT64 TimeStamp
|
||||
)
|
||||
{
|
||||
GAUGE_DATA_ENTRY *GaugeEntryArray;
|
||||
UINT32 Index;
|
||||
|
||||
if (TimeStamp == 0) {
|
||||
TimeStamp = GetPerformanceCounter ();
|
||||
}
|
||||
|
||||
Index = SmmSearchForGaugeEntry (Handle, Token, Module);
|
||||
if (Index >= mGaugeData->NumberOfEntries) {
|
||||
return EFI_NOT_FOUND;
|
||||
}
|
||||
GaugeEntryArray = (GAUGE_DATA_ENTRY *) (mGaugeData + 1);
|
||||
GaugeEntryArray[Index].EndTimeStamp = TimeStamp;
|
||||
|
||||
return EFI_SUCCESS;
|
||||
return EndGaugeEx (Handle, Token, Module, TimeStamp, 0);
|
||||
}
|
||||
|
||||
/**
|
||||
Retrieves a previously logged performance measurement.
|
||||
It can also retrieve the log created by StartGaugeEx and EndGaugeEx of PERFORMANCE_EX_PROTOCOL,
|
||||
and then eliminate the Identifier.
|
||||
|
||||
Retrieves the performance log entry from the performance log specified by LogEntryKey.
|
||||
If it stands for a valid entry, then EFI_SUCCESS is returned and
|
||||
@@ -267,28 +419,23 @@ GetGauge (
|
||||
OUT GAUGE_DATA_ENTRY **GaugeDataEntry
|
||||
)
|
||||
{
|
||||
UINTN NumberOfEntries;
|
||||
GAUGE_DATA_ENTRY *LogEntryArray;
|
||||
EFI_STATUS Status;
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryEx;
|
||||
|
||||
NumberOfEntries = (UINTN) (mGaugeData->NumberOfEntries);
|
||||
if (LogEntryKey > NumberOfEntries) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
Status = GetGaugeEx (LogEntryKey, &GaugeEntryEx);
|
||||
if (EFI_ERROR (Status)) {
|
||||
return Status;
|
||||
}
|
||||
if (LogEntryKey == NumberOfEntries) {
|
||||
return EFI_NOT_FOUND;
|
||||
}
|
||||
|
||||
LogEntryArray = (GAUGE_DATA_ENTRY *) (mGaugeData + 1);
|
||||
|
||||
if (GaugeDataEntry == NULL) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
*GaugeDataEntry = &LogEntryArray[LogEntryKey];
|
||||
|
||||
*GaugeDataEntry = (GAUGE_DATA_ENTRY *) GaugeEntryEx;
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
This function check if the address is in SMRAM.
|
||||
|
||||
@@ -319,7 +466,88 @@ IsAddressInSmram (
|
||||
/**
|
||||
Communication service SMI Handler entry.
|
||||
|
||||
This SMI handler provides services for the variable wrapper driver.
|
||||
This SMI handler provides services for the performance wrapper driver.
|
||||
|
||||
@param[in] DispatchHandle The unique handle assigned to this handler by SmiHandlerRegister().
|
||||
@param[in] RegisterContext Points to an optional handler context which was specified when the
|
||||
handler was registered.
|
||||
@param[in, out] CommBuffer A pointer to a collection of data in memory that will
|
||||
be conveyed from a non-SMM environment into an SMM environment.
|
||||
@param[in, out] CommBufferSize The size of the CommBuffer.
|
||||
|
||||
@retval EFI_SUCCESS The interrupt was handled and quiesced. No other handlers
|
||||
should still be called.
|
||||
@retval EFI_WARN_INTERRUPT_SOURCE_QUIESCED The interrupt has been quiesced but other handlers should
|
||||
still be called.
|
||||
@retval EFI_WARN_INTERRUPT_SOURCE_PENDING The interrupt is still pending and other handlers should still
|
||||
be called.
|
||||
@retval EFI_INTERRUPT_PENDING The interrupt could not be quiesced.
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
SmmPerformanceHandlerEx (
|
||||
IN EFI_HANDLE DispatchHandle,
|
||||
IN CONST VOID *RegisterContext,
|
||||
IN OUT VOID *CommBuffer,
|
||||
IN OUT UINTN *CommBufferSize
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
SMM_PERF_COMMUNICATE_EX *SmmPerfCommData;
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryExArray;
|
||||
UINTN DataSize;
|
||||
|
||||
GaugeEntryExArray = NULL;
|
||||
|
||||
ASSERT (CommBuffer != NULL);
|
||||
|
||||
SmmPerfCommData = (SMM_PERF_COMMUNICATE_EX *)CommBuffer;
|
||||
|
||||
switch (SmmPerfCommData->Function) {
|
||||
case SMM_PERF_FUNCTION_GET_GAUGE_ENTRY_NUMBER :
|
||||
SmmPerfCommData->NumberOfEntries = mGaugeData->NumberOfEntries;
|
||||
Status = EFI_SUCCESS;
|
||||
break;
|
||||
|
||||
case SMM_PERF_FUNCTION_GET_GAUGE_DATA :
|
||||
if ( SmmPerfCommData->GaugeDataEx == NULL || SmmPerfCommData->NumberOfEntries == 0 ||
|
||||
(SmmPerfCommData->LogEntryKey + SmmPerfCommData->NumberOfEntries) > mGaugeData->NumberOfEntries) {
|
||||
Status = EFI_INVALID_PARAMETER;
|
||||
break;
|
||||
}
|
||||
|
||||
//
|
||||
// Sanity check
|
||||
//
|
||||
DataSize = SmmPerfCommData->NumberOfEntries * sizeof(GAUGE_DATA_ENTRY_EX);
|
||||
if (IsAddressInSmram ((EFI_PHYSICAL_ADDRESS)(UINTN)SmmPerfCommData->GaugeDataEx, DataSize)) {
|
||||
DEBUG ((EFI_D_ERROR, "Smm Performance Data buffer is in SMRAM!\n"));
|
||||
Status = EFI_ACCESS_DENIED;
|
||||
break ;
|
||||
}
|
||||
|
||||
GaugeEntryExArray = (GAUGE_DATA_ENTRY_EX *) (mGaugeData + 1);
|
||||
CopyMem(
|
||||
(UINT8 *) (SmmPerfCommData->GaugeDataEx),
|
||||
(UINT8 *) &GaugeEntryExArray[SmmPerfCommData->LogEntryKey],
|
||||
DataSize
|
||||
);
|
||||
Status = EFI_SUCCESS;
|
||||
break;
|
||||
|
||||
default:
|
||||
ASSERT (FALSE);
|
||||
Status = EFI_UNSUPPORTED;
|
||||
}
|
||||
|
||||
SmmPerfCommData->ReturnStatus = Status;
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Communication service SMI Handler entry.
|
||||
|
||||
This SMI handler provides services for the performance wrapper driver.
|
||||
|
||||
@param[in] DispatchHandle The unique handle assigned to this handler by SmiHandlerRegister().
|
||||
@param[in] RegisterContext Points to an optional handler context which was specified when the
|
||||
@@ -341,39 +569,36 @@ EFIAPI
|
||||
SmmPerformanceHandler (
|
||||
IN EFI_HANDLE DispatchHandle,
|
||||
IN CONST VOID *RegisterContext,
|
||||
IN OUT VOID *CommBuffer,
|
||||
IN OUT UINTN *CommBufferSize
|
||||
IN OUT VOID *CommBuffer,
|
||||
IN OUT UINTN *CommBufferSize
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
SMM_PERF_COMMUNICATE *SmmPerfCommData;
|
||||
GAUGE_DATA_ENTRY *GaugeData;
|
||||
GAUGE_DATA_ENTRY_EX *GaugeEntryExArray;
|
||||
UINTN DataSize;
|
||||
UINTN Index;
|
||||
UINTN LogEntryKey;
|
||||
|
||||
GaugeEntryExArray = NULL;
|
||||
|
||||
GaugeData = NULL;
|
||||
|
||||
ASSERT (CommBuffer != NULL);
|
||||
|
||||
SmmPerfCommData = (SMM_PERF_COMMUNICATE*)CommBuffer;
|
||||
SmmPerfCommData = (SMM_PERF_COMMUNICATE *)CommBuffer;
|
||||
|
||||
switch (SmmPerfCommData->Function) {
|
||||
case SMM_PERF_FUNCTION_GET_GAUGE_ENTRY_NUMBER :
|
||||
SmmPerfCommData->NumberOfEntries = mGaugeData->NumberOfEntries;
|
||||
return Status = EFI_SUCCESS;
|
||||
Status = EFI_SUCCESS;
|
||||
break;
|
||||
|
||||
case SMM_PERF_FUNCTION_GET_GAUGE_DATA :
|
||||
if ( SmmPerfCommData->GaugeData == NULL || SmmPerfCommData->NumberOfEntries <= 0 ||
|
||||
(SmmPerfCommData->LogEntryKey + SmmPerfCommData->NumberOfEntries) > mGaugeData->NumberOfEntries) {
|
||||
if ( SmmPerfCommData->GaugeData == NULL || SmmPerfCommData->NumberOfEntries == 0 ||
|
||||
(SmmPerfCommData->LogEntryKey + SmmPerfCommData->NumberOfEntries) > mGaugeData->NumberOfEntries) {
|
||||
Status = EFI_INVALID_PARAMETER;
|
||||
break;
|
||||
}
|
||||
|
||||
Status = GetGauge(SmmPerfCommData->LogEntryKey, &GaugeData);
|
||||
if (EFI_ERROR(Status)) {
|
||||
break;
|
||||
}
|
||||
|
||||
|
||||
//
|
||||
// Sanity check
|
||||
//
|
||||
@@ -384,17 +609,23 @@ SmmPerformanceHandler (
|
||||
break ;
|
||||
}
|
||||
|
||||
CopyMem(
|
||||
(UINT8*)SmmPerfCommData->GaugeData,
|
||||
(UINT8*)GaugeData,
|
||||
DataSize
|
||||
);
|
||||
GaugeEntryExArray = (GAUGE_DATA_ENTRY_EX *) (mGaugeData + 1);
|
||||
|
||||
LogEntryKey = SmmPerfCommData->LogEntryKey;
|
||||
for (Index = 0; Index < SmmPerfCommData->NumberOfEntries; Index++) {
|
||||
CopyMem(
|
||||
(UINT8 *) &(SmmPerfCommData->GaugeData[Index]),
|
||||
(UINT8 *) &GaugeEntryExArray[LogEntryKey++],
|
||||
sizeof (GAUGE_DATA_ENTRY)
|
||||
);
|
||||
}
|
||||
Status = EFI_SUCCESS;
|
||||
break;
|
||||
|
||||
default:
|
||||
ASSERT (FALSE);
|
||||
Status = EFI_UNSUPPORTED;
|
||||
}
|
||||
}
|
||||
|
||||
SmmPerfCommData->ReturnStatus = Status;
|
||||
return EFI_SUCCESS;
|
||||
@@ -402,7 +633,7 @@ SmmPerformanceHandler (
|
||||
|
||||
/**
|
||||
SmmBase2 protocol notify callback function, when SMST and SMM memory service get initialized
|
||||
this function is callbacked to to initialize the Smm Performance Lib
|
||||
this function is callbacked to initialize the Smm Performance Lib
|
||||
|
||||
@param Event The event of notify protocol.
|
||||
@param Context Notify event context.
|
||||
@@ -426,9 +657,9 @@ InitializeSmmCorePerformanceLib (
|
||||
//
|
||||
InitializeSpinLock (&mSmmPerfLock);
|
||||
|
||||
mMaxGaugeRecords = INIT_SMM_GAUGE_DATA_ENTRIES + PcdGet8 (PcdMaxPeiPerformanceLogEntries);
|
||||
mMaxGaugeRecords = INIT_SMM_GAUGE_DATA_ENTRIES;
|
||||
|
||||
mGaugeData = AllocateZeroPool (sizeof (GAUGE_DATA_HEADER) + (sizeof (GAUGE_DATA_ENTRY) * mMaxGaugeRecords));
|
||||
mGaugeData = AllocateZeroPool (sizeof (GAUGE_DATA_HEADER) + (sizeof (GAUGE_DATA_ENTRY_EX) * mMaxGaugeRecords));
|
||||
ASSERT (mGaugeData != NULL);
|
||||
|
||||
//
|
||||
@@ -464,19 +695,27 @@ InitializeSmmCorePerformanceLib (
|
||||
);
|
||||
ASSERT_EFI_ERROR (Status);
|
||||
|
||||
Status = gSmst->SmmInstallProtocolInterface (
|
||||
&mHandle,
|
||||
&gSmmPerformanceExProtocolGuid,
|
||||
EFI_NATIVE_INTERFACE,
|
||||
&mPerformanceExInterface
|
||||
);
|
||||
ASSERT_EFI_ERROR (Status);
|
||||
|
||||
///
|
||||
/// Register SMM Performance SMI handler
|
||||
///
|
||||
Handle = NULL;
|
||||
Status = gSmst->SmiHandlerRegister (SmmPerformanceHandler, &gSmmPerformanceProtocolGuid, &Handle);
|
||||
ASSERT_EFI_ERROR (Status);
|
||||
Status = gSmst->SmiHandlerRegister (SmmPerformanceHandlerEx, &gSmmPerformanceExProtocolGuid, &Handle);
|
||||
ASSERT_EFI_ERROR (Status);
|
||||
}
|
||||
|
||||
/**
|
||||
The constructor function initializes Performance infrastructure for DXE phase.
|
||||
|
||||
The constructor function publishes Performance protocol, allocates memory to log DXE performance
|
||||
and merges PEI performance data to DXE performance log.
|
||||
The constructor function initializes the Performance Measurement Enable flag and
|
||||
registers SmmBase2 protocol notify callback.
|
||||
It will ASSERT() if one of these operations fails and it will always return EFI_SUCCESS.
|
||||
|
||||
@param ImageHandle The firmware allocated handle for the EFI image.
|
||||
@@ -530,6 +769,174 @@ SmmCorePerformanceLibConstructor (
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
Adds a record at the end of the performance measurement log
|
||||
that records the start time of a performance measurement.
|
||||
|
||||
Adds a record to the end of the performance measurement log
|
||||
that contains the Handle, Token, Module and Identifier.
|
||||
The end time of the new record must be set to zero.
|
||||
If TimeStamp is not zero, then TimeStamp is used to fill in the start time in the record.
|
||||
If TimeStamp is zero, the start time in the record is filled in with the value
|
||||
read from the current time stamp.
|
||||
|
||||
@param Handle Pointer to environment specific context used
|
||||
to identify the component being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param TimeStamp 64-bit time stamp.
|
||||
@param Identifier 32-bit identifier. If the value is 0, the created record
|
||||
is same as the one created by StartPerformanceMeasurement.
|
||||
|
||||
@retval RETURN_SUCCESS The start of the measurement was recorded.
|
||||
@retval RETURN_OUT_OF_RESOURCES There are not enough resources to record the measurement.
|
||||
|
||||
**/
|
||||
RETURN_STATUS
|
||||
EFIAPI
|
||||
StartPerformanceMeasurementEx (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN UINT64 TimeStamp,
|
||||
IN UINT32 Identifier
|
||||
)
|
||||
{
|
||||
return (RETURN_STATUS) StartGaugeEx (Handle, Token, Module, TimeStamp, Identifier);
|
||||
}
|
||||
|
||||
/**
|
||||
Searches the performance measurement log from the beginning of the log
|
||||
for the first matching record that contains a zero end time and fills in a valid end time.
|
||||
|
||||
Searches the performance measurement log from the beginning of the log
|
||||
for the first record that matches Handle, Token, Module and Identifier and has an end time value of zero.
|
||||
If the record can not be found then return RETURN_NOT_FOUND.
|
||||
If the record is found and TimeStamp is not zero,
|
||||
then the end time in the record is filled in with the value specified by TimeStamp.
|
||||
If the record is found and TimeStamp is zero, then the end time in the matching record
|
||||
is filled in with the current time stamp value.
|
||||
|
||||
@param Handle Pointer to environment specific context used
|
||||
to identify the component being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param TimeStamp 64-bit time stamp.
|
||||
@param Identifier 32-bit identifier. If the value is 0, the found record
|
||||
is same as the one found by EndPerformanceMeasurement.
|
||||
|
||||
@retval RETURN_SUCCESS The end of the measurement was recorded.
|
||||
@retval RETURN_NOT_FOUND The specified measurement record could not be found.
|
||||
|
||||
**/
|
||||
RETURN_STATUS
|
||||
EFIAPI
|
||||
EndPerformanceMeasurementEx (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN UINT64 TimeStamp,
|
||||
IN UINT32 Identifier
|
||||
)
|
||||
{
|
||||
return (RETURN_STATUS) EndGaugeEx (Handle, Token, Module, TimeStamp, Identifier);
|
||||
}
|
||||
|
||||
/**
|
||||
Attempts to retrieve a performance measurement log entry from the performance measurement log.
|
||||
It can also retrieve the log created by StartPerformanceMeasurement and EndPerformanceMeasurement,
|
||||
and then assign the Identifier with 0.
|
||||
|
||||
Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is
|
||||
zero on entry, then an attempt is made to retrieve the first entry from the performance log,
|
||||
and the key for the second entry in the log is returned. If the performance log is empty,
|
||||
then no entry is retrieved and zero is returned. If LogEntryKey is not zero, then the performance
|
||||
log entry associated with LogEntryKey is retrieved, and the key for the next entry in the log is
|
||||
returned. If LogEntryKey is the key for the last entry in the log, then the last log entry is
|
||||
retrieved and an implementation specific non-zero key value that specifies the end of the performance
|
||||
log is returned. If LogEntryKey is equal this implementation specific non-zero key value, then no entry
|
||||
is retrieved and zero is returned. In the cases where a performance log entry can be returned,
|
||||
the log entry is returned in Handle, Token, Module, StartTimeStamp, EndTimeStamp and Identifier.
|
||||
If LogEntryKey is not a valid log entry key for the performance measurement log, then ASSERT().
|
||||
If Handle is NULL, then ASSERT().
|
||||
If Token is NULL, then ASSERT().
|
||||
If Module is NULL, then ASSERT().
|
||||
If StartTimeStamp is NULL, then ASSERT().
|
||||
If EndTimeStamp is NULL, then ASSERT().
|
||||
If Identifier is NULL, then ASSERT().
|
||||
|
||||
@param LogEntryKey On entry, the key of the performance measurement log entry to retrieve.
|
||||
0, then the first performance measurement log entry is retrieved.
|
||||
On exit, the key of the next performance log entry.
|
||||
@param Handle Pointer to environment specific context used to identify the component
|
||||
being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string that identifies the component
|
||||
being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string that identifies the module
|
||||
being measured.
|
||||
@param StartTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement
|
||||
was started.
|
||||
@param EndTimeStamp Pointer to the 64-bit time stamp that was recorded when the measurement
|
||||
was ended.
|
||||
@param Identifier Pointer to the 32-bit identifier that was recorded.
|
||||
|
||||
@return The key for the next performance log entry (in general case).
|
||||
|
||||
**/
|
||||
UINTN
|
||||
EFIAPI
|
||||
GetPerformanceMeasurementEx (
|
||||
IN UINTN LogEntryKey,
|
||||
OUT CONST VOID **Handle,
|
||||
OUT CONST CHAR8 **Token,
|
||||
OUT CONST CHAR8 **Module,
|
||||
OUT UINT64 *StartTimeStamp,
|
||||
OUT UINT64 *EndTimeStamp,
|
||||
OUT UINT32 *Identifier
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
GAUGE_DATA_ENTRY_EX *GaugeData;
|
||||
|
||||
GaugeData = NULL;
|
||||
|
||||
ASSERT (Handle != NULL);
|
||||
ASSERT (Token != NULL);
|
||||
ASSERT (Module != NULL);
|
||||
ASSERT (StartTimeStamp != NULL);
|
||||
ASSERT (EndTimeStamp != NULL);
|
||||
ASSERT (Identifier != NULL);
|
||||
|
||||
Status = GetGaugeEx (LogEntryKey++, &GaugeData);
|
||||
|
||||
//
|
||||
// Make sure that LogEntryKey is a valid log entry key,
|
||||
//
|
||||
ASSERT (Status != EFI_INVALID_PARAMETER);
|
||||
|
||||
if (EFI_ERROR (Status)) {
|
||||
//
|
||||
// The LogEntryKey is the last entry (equals to the total entry number).
|
||||
//
|
||||
return 0;
|
||||
}
|
||||
|
||||
ASSERT (GaugeData != NULL);
|
||||
|
||||
*Handle = (VOID *) (UINTN) GaugeData->Handle;
|
||||
*Token = GaugeData->Token;
|
||||
*Module = GaugeData->Module;
|
||||
*StartTimeStamp = GaugeData->StartTimeStamp;
|
||||
*EndTimeStamp = GaugeData->EndTimeStamp;
|
||||
*Identifier = GaugeData->Identifier;
|
||||
|
||||
return LogEntryKey;
|
||||
}
|
||||
|
||||
/**
|
||||
Adds a record at the end of the performance measurement log
|
||||
that records the start time of a performance measurement.
|
||||
@@ -562,10 +969,7 @@ StartPerformanceMeasurement (
|
||||
IN UINT64 TimeStamp
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
Status = StartGauge (Handle, Token, Module, TimeStamp);
|
||||
return (RETURN_STATUS) Status;
|
||||
return StartPerformanceMeasurementEx (Handle, Token, Module, TimeStamp, 0);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -601,14 +1005,13 @@ EndPerformanceMeasurement (
|
||||
IN UINT64 TimeStamp
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
|
||||
Status = EndGauge (Handle, Token, Module, TimeStamp);
|
||||
return (RETURN_STATUS) Status;
|
||||
return EndPerformanceMeasurementEx (Handle, Token, Module, TimeStamp, 0);
|
||||
}
|
||||
|
||||
/**
|
||||
Attempts to retrieve a performance measurement log entry from the performance measurement log.
|
||||
It can also retrieve the log created by StartPerformanceMeasurementEx and EndPerformanceMeasurementEx,
|
||||
and then eliminate the Identifier.
|
||||
|
||||
Attempts to retrieve the performance log entry specified by LogEntryKey. If LogEntryKey is
|
||||
zero on entry, then an attempt is made to retrieve the first entry from the performance log,
|
||||
@@ -655,40 +1058,8 @@ GetPerformanceMeasurement (
|
||||
OUT UINT64 *EndTimeStamp
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
GAUGE_DATA_ENTRY *GaugeData;
|
||||
|
||||
GaugeData = NULL;
|
||||
|
||||
ASSERT (Handle != NULL);
|
||||
ASSERT (Token != NULL);
|
||||
ASSERT (Module != NULL);
|
||||
ASSERT (StartTimeStamp != NULL);
|
||||
ASSERT (EndTimeStamp != NULL);
|
||||
|
||||
Status = GetGauge (LogEntryKey++, &GaugeData);
|
||||
|
||||
//
|
||||
// Make sure that LogEntryKey is a valid log entry key,
|
||||
//
|
||||
ASSERT (Status != EFI_INVALID_PARAMETER);
|
||||
|
||||
if (EFI_ERROR (Status)) {
|
||||
//
|
||||
// The LogEntryKey is the last entry (equals to the total entry number).
|
||||
//
|
||||
return 0;
|
||||
}
|
||||
|
||||
ASSERT (GaugeData != NULL);
|
||||
|
||||
*Handle = (VOID *) (UINTN) GaugeData->Handle;
|
||||
*Token = GaugeData->Token;
|
||||
*Module = GaugeData->Module;
|
||||
*StartTimeStamp = GaugeData->StartTimeStamp;
|
||||
*EndTimeStamp = GaugeData->EndTimeStamp;
|
||||
|
||||
return LogEntryKey;
|
||||
UINT32 Identifier;
|
||||
return GetPerformanceMeasurementEx (LogEntryKey, Handle, Token, Module, StartTimeStamp, EndTimeStamp, &Identifier);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -711,5 +1082,3 @@ PerformanceMeasurementEnabled (
|
||||
{
|
||||
return mPerformanceMeasurementEnabled;
|
||||
}
|
||||
|
||||
|
||||
|
@@ -3,12 +3,12 @@
|
||||
#
|
||||
# This library provides the performance measurement interfaces and initializes performance
|
||||
# logging for the SMM phase.
|
||||
# It initializes SMM phase performance logging by publishing the Performance Protocol,
|
||||
# It initializes SMM phase performance logging by publishing the SMM Performance and PerformanceEx Protocol,
|
||||
# which is consumed by SmmPerformanceLib to logging performance data in SMM phase.
|
||||
# This library is mainly used by SMM Core to start performance logging to ensure that
|
||||
# SMM Performance Protocol is installed at the very beginning of SMM phase.
|
||||
# SMM Performance and PerformanceEx Protocol are installed at the very beginning of SMM phase.
|
||||
#
|
||||
# Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>
|
||||
# Copyright (c) 2011 - 2012, Intel Corporation. All rights reserved.<BR>
|
||||
# This program and the accompanying materials
|
||||
# are licensed and made available under the terms and conditions of the BSD License
|
||||
# which accompanies this distribution. The full text of the license may be found at
|
||||
@@ -54,6 +54,7 @@
|
||||
BaseLib
|
||||
DebugLib
|
||||
SynchronizationLib
|
||||
SmmServicesTableLib
|
||||
|
||||
[Protocols]
|
||||
gEfiSmmBase2ProtocolGuid ## CONSUMES
|
||||
@@ -61,7 +62,7 @@
|
||||
|
||||
[Guids]
|
||||
gSmmPerformanceProtocolGuid ## PRODUCES
|
||||
gSmmPerformanceExProtocolGuid ## PRODUCES
|
||||
|
||||
[Pcd]
|
||||
gEfiMdeModulePkgTokenSpaceGuid.PcdMaxPeiPerformanceLogEntries
|
||||
gEfiMdePkgTokenSpaceGuid.PcdPerformanceLibraryPropertyMask
|
||||
|
@@ -1,10 +1,10 @@
|
||||
/** @file
|
||||
Master header files for SmmCorePerformanceLib instance.
|
||||
|
||||
This header file holds the prototypes of the Performance Protocol published by this
|
||||
This header file holds the prototypes of the SMM Performance and PerformanceEx Protocol published by this
|
||||
library instance at its constructor.
|
||||
|
||||
Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>
|
||||
Copyright (c) 2011 - 2012, Intel Corporation. All rights reserved.<BR>
|
||||
This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
which accompanies this distribution. The full text of the license may be found at
|
||||
@@ -37,7 +37,108 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
#include <Protocol/SmmAccess2.h>
|
||||
|
||||
//
|
||||
// Interface declarations for Performance Protocol.
|
||||
// Interface declarations for SMM PerformanceEx Protocol.
|
||||
//
|
||||
/**
|
||||
Adds a record at the end of the performance measurement log
|
||||
that records the start time of a performance measurement.
|
||||
|
||||
Adds a record to the end of the performance measurement log
|
||||
that contains the Handle, Token, Module and Identifier.
|
||||
The end time of the new record must be set to zero.
|
||||
If TimeStamp is not zero, then TimeStamp is used to fill in the start time in the record.
|
||||
If TimeStamp is zero, the start time in the record is filled in with the value
|
||||
read from the current time stamp.
|
||||
|
||||
@param Handle Pointer to environment specific context used
|
||||
to identify the component being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param TimeStamp 64-bit time stamp.
|
||||
@param Identifier 32-bit identifier. If the value is 0, the created record
|
||||
is same as the one created by StartGauge of PERFORMANCE_PROTOCOL.
|
||||
|
||||
@retval EFI_SUCCESS The data was read correctly from the device.
|
||||
@retval EFI_OUT_OF_RESOURCES There are not enough resources to record the measurement.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
StartGaugeEx (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN UINT64 TimeStamp,
|
||||
IN UINT32 Identifier
|
||||
);
|
||||
|
||||
/**
|
||||
Searches the performance measurement log from the beginning of the log
|
||||
for the first matching record that contains a zero end time and fills in a valid end time.
|
||||
|
||||
Searches the performance measurement log from the beginning of the log
|
||||
for the first record that matches Handle, Token, Module and Identifier and has an end time value of zero.
|
||||
If the record can not be found then return EFI_NOT_FOUND.
|
||||
If the record is found and TimeStamp is not zero,
|
||||
then the end time in the record is filled in with the value specified by TimeStamp.
|
||||
If the record is found and TimeStamp is zero, then the end time in the matching record
|
||||
is filled in with the current time stamp value.
|
||||
|
||||
@param Handle Pointer to environment specific context used
|
||||
to identify the component being measured.
|
||||
@param Token Pointer to a Null-terminated ASCII string
|
||||
that identifies the component being measured.
|
||||
@param Module Pointer to a Null-terminated ASCII string
|
||||
that identifies the module being measured.
|
||||
@param TimeStamp 64-bit time stamp.
|
||||
@param Identifier 32-bit identifier. If the value is 0, the found record
|
||||
is same as the one found by EndGauge of PERFORMANCE_PROTOCOL.
|
||||
|
||||
@retval EFI_SUCCESS The end of the measurement was recorded.
|
||||
@retval EFI_NOT_FOUND The specified measurement record could not be found.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
EndGaugeEx (
|
||||
IN CONST VOID *Handle, OPTIONAL
|
||||
IN CONST CHAR8 *Token, OPTIONAL
|
||||
IN CONST CHAR8 *Module, OPTIONAL
|
||||
IN UINT64 TimeStamp,
|
||||
IN UINT32 Identifier
|
||||
);
|
||||
|
||||
/**
|
||||
Retrieves a previously logged performance measurement.
|
||||
It can also retrieve the log created by StartGauge and EndGauge of PERFORMANCE_PROTOCOL,
|
||||
and then assign the Identifier with 0.
|
||||
|
||||
Retrieves the performance log entry from the performance log specified by LogEntryKey.
|
||||
If it stands for a valid entry, then EFI_SUCCESS is returned and
|
||||
GaugeDataEntryEx stores the pointer to that entry.
|
||||
|
||||
@param LogEntryKey The key for the previous performance measurement log entry.
|
||||
If 0, then the first performance measurement log entry is retrieved.
|
||||
@param GaugeDataEntryEx The indirect pointer to the extended gauge data entry specified by LogEntryKey
|
||||
if the retrieval is successful.
|
||||
|
||||
@retval EFI_SUCCESS The GuageDataEntryEx is successfully found based on LogEntryKey.
|
||||
@retval EFI_NOT_FOUND The LogEntryKey is the last entry (equals to the total entry number).
|
||||
@retval EFI_INVALIDE_PARAMETER The LogEntryKey is not a valid entry (greater than the total entry number).
|
||||
@retval EFI_INVALIDE_PARAMETER GaugeDataEntryEx is NULL.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
GetGaugeEx (
|
||||
IN UINTN LogEntryKey,
|
||||
OUT GAUGE_DATA_ENTRY_EX **GaugeDataEntryEx
|
||||
);
|
||||
|
||||
//
|
||||
// Interface declarations for SMM Performance Protocol.
|
||||
//
|
||||
/**
|
||||
Adds a record at the end of the performance measurement log
|
||||
@@ -106,6 +207,8 @@ EndGauge (
|
||||
|
||||
/**
|
||||
Retrieves a previously logged performance measurement.
|
||||
It can also retrieve the log created by StartGaugeEx and EndGaugeEx of PERFORMANCE_EX_PROTOCOL,
|
||||
and then eliminate the Identifier.
|
||||
|
||||
Retrieves the performance log entry from the performance log specified by LogEntryKey.
|
||||
If it stands for a valid entry, then EFI_SUCCESS is returned and
|
||||
|
Reference in New Issue
Block a user