1. added functions header for BaseUefiDecompressLi

2. added some internal functions header for BaseLib
3. added EFIAPI for some internal assembly files declare

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@1050 6f19259b-4bc3-4df7-8a09-765794883524

3 files changed, 80 insertions, 2 deletions

diff --git a/MdePkg/Library/BaseLib/Ebc/SetJumpLongJump.c b/MdePkg/Library/BaseLib/Ebc/SetJumpLongJump.c
index ab7716cb94..b485d3e495 100644
--- a/MdePkg/Library/BaseLib/Ebc/SetJumpLongJump.c
+++ b/MdePkg/Library/BaseLib/Ebc/SetJumpLongJump.c
@@ -14,12 +14,35 @@
 

 **/

 

+/**

+  Worker function that checks ASSERT condition for JumpBuffer

+

+  Checks ASSERT condition for JumpBuffer.

+

+  If JumpBuffer is NULL, then ASSERT().

+  For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  @param  JumpBuffer    A pointer to CPU context buffer.

+

+**/

 VOID

-EFIAPI

 InternalAssertJumpBuffer (

   IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer

   );

 

+/**

+  Saves the current CPU context that can be restored with a call to LongJump() and returns 0.

+

+  Saves the current CPU context in the buffer specified by JumpBuffer and returns 0.  The initial 

+  call to SetJump() must always return 0.  Subsequent calls to LongJump() cause a non-zero 

+  value to be returned by SetJump(). 

+

+  If JumpBuffer is NULL, then ASSERT().

+  For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  @param  JumpBuffer    A pointer to CPU context buffer.

+ 

+**/

 UINTN

 EFIAPI

 SetJump (

@@ -30,6 +53,17 @@ SetJump (
   return 0;

 }

 

+/**

+  Restores the CPU context that was saved with SetJump().

+

+  Restores the CPU context from the buffer specified by JumpBuffer.

+  This function never returns to the caller.

+  Instead is resumes execution based on the state of JumpBuffer.

+

+  @param  JumpBuffer    A pointer to CPU context buffer.

+  @param  Value         The value to return when the SetJump() context is restored.

+

+**/

 VOID

 EFIAPI

 InternalLongJump (

@@ -37,5 +71,8 @@ InternalLongJump (
   IN      UINTN                     Value

   )

 {

+  //

+  // This function cannot work on EBC

+  //

   ASSERT (FALSE);

 }

diff --git a/MdePkg/Library/BaseLib/Ebc/SwitchStack.c b/MdePkg/Library/BaseLib/Ebc/SwitchStack.c
index 8fadd4f384..0a5464b2f9 100644
--- a/MdePkg/Library/BaseLib/Ebc/SwitchStack.c
+++ b/MdePkg/Library/BaseLib/Ebc/SwitchStack.c
@@ -35,7 +35,6 @@
 

 **/

 VOID

-EFIAPI

 InternalSwitchStack (

   IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

   IN      VOID                      *Context1,  OPTIONAL

diff --git a/MdePkg/Library/BaseLib/Ebc/Synchronization.c b/MdePkg/Library/BaseLib/Ebc/Synchronization.c
index df591b287a..5d5bc2ff11 100644
--- a/MdePkg/Library/BaseLib/Ebc/Synchronization.c
+++ b/MdePkg/Library/BaseLib/Ebc/Synchronization.c
@@ -26,6 +26,22 @@ InternalSyncCompareExchange32 (
            ((*Value = ExchangeValue), CompareValue);

 }

 

+/**

+  Performs an atomic compare exchange operation on a 64-bit unsigned integer.

+

+  Performs an atomic compare exchange operation on the 64-bit unsigned integer specified 

+  by Value.  If Value is equal to CompareValue, then Value is set to ExchangeValue and 

+  CompareValue is returned.  If Value is not equal to CompareValue, then Value is returned. 

+  The compare exchange operation must be performed using MP safe mechanisms.

+

+  @param  Value         A pointer to the 64-bit value for the compare exchange

+                        operation.

+  @param  CompareValue  64-bit value used in compare operation.

+  @param  ExchangeValue 64-bit value used in exchange operation.

+

+  @return The original *Value before exchange.

+

+**/

 UINT64

 EFIAPI

 InternalSyncCompareExchange64 (

@@ -38,6 +54,19 @@ InternalSyncCompareExchange64 (
            ((*Value = ExchangeValue), CompareValue);

 }

 

+/**

+  Performs an atomic increment of an 32-bit unsigned integer.

+

+  Performs an atomic increment of the 32-bit unsigned integer specified by

+  Value and returns the incremented value. The increment operation must be

+  performed using MP safe mechanisms. The state of the return value is not

+  guaranteed to be MP safe.

+

+  @param  Value A pointer to the 32-bit value to increment.

+

+  @return The incremented value.

+

+**/

 UINT32

 EFIAPI

 InternalSyncIncrement (

@@ -47,6 +76,19 @@ InternalSyncIncrement (
   return ++*Value;

 }

 

+/**

+  Performs an atomic decrement of an 32-bit unsigned integer.

+

+  Performs an atomic decrement of the 32-bit unsigned integer specified by

+  Value and returns the decrement value. The decrement operation must be

+  performed using MP safe mechanisms. The state of the return value is not

+  guaranteed to be MP safe.

+

+  @param  Value A pointer to the 32-bit value to decrement.

+

+  @return The decrement value.

+

+**/

 UINT32

 EFIAPI

 InternalSyncDecrement (