mirror of
				https://git.proxmox.com/git/mirror_edk2
				synced 2025-10-31 10:40:34 +00:00 
			
		
		
		
	 9344f09215
			
		
	
	
		9344f09215
		
	
	
	
	
		
			
			https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com>
		
			
				
	
	
		
			146 lines
		
	
	
		
			4.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			146 lines
		
	
	
		
			4.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
|   Declaration of internal functions in BaseSynchronizationLib.
 | |
| 
 | |
|   Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
 | |
|   SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
| **/
 | |
| 
 | |
| #ifndef __BASE_SYNCHRONIZATION_LIB_INTERNALS__
 | |
| #define __BASE_SYNCHRONIZATION_LIB_INTERNALS__
 | |
| 
 | |
| #include <Base.h>
 | |
| #include <Library/SynchronizationLib.h>
 | |
| #include <Library/BaseLib.h>
 | |
| #include <Library/DebugLib.h>
 | |
| #include <Library/TimerLib.h>
 | |
| #include <Library/PcdLib.h>
 | |
| 
 | |
| /**
 | |
|   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.
 | |
| 
 | |
|   @param  Value A pointer to the 32-bit value to increment.
 | |
| 
 | |
|   @return The incremented value.
 | |
| 
 | |
| **/
 | |
| UINT32
 | |
| EFIAPI
 | |
| InternalSyncIncrement (
 | |
|   IN      volatile UINT32           *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.
 | |
| 
 | |
|   @param  Value A pointer to the 32-bit value to decrement.
 | |
| 
 | |
|   @return The decrement value.
 | |
| 
 | |
| **/
 | |
| UINT32
 | |
| EFIAPI
 | |
| InternalSyncDecrement (
 | |
|   IN      volatile UINT32           *Value
 | |
|   );
 | |
| 
 | |
| 
 | |
| /**
 | |
|   Performs an atomic compare exchange operation on a 16-bit unsigned integer.
 | |
| 
 | |
|   Performs an atomic compare exchange operation on the 16-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 16-bit value for the compare exchange
 | |
|                         operation.
 | |
|   @param  CompareValue  A 16-bit value used in compare operation.
 | |
|   @param  ExchangeValue A 16-bit value used in exchange operation.
 | |
| 
 | |
|   @return The original *Value before exchange.
 | |
| 
 | |
| **/
 | |
| UINT16
 | |
| EFIAPI
 | |
| InternalSyncCompareExchange16 (
 | |
|   IN      volatile UINT16           *Value,
 | |
|   IN      UINT16                    CompareValue,
 | |
|   IN      UINT16                    ExchangeValue
 | |
|   );
 | |
| 
 | |
| 
 | |
| /**
 | |
|   Performs an atomic compare exchange operation on a 32-bit unsigned integer.
 | |
| 
 | |
|   Performs an atomic compare exchange operation on the 32-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 32-bit value for the compare exchange
 | |
|                         operation.
 | |
|   @param  CompareValue  A 32-bit value used in compare operation.
 | |
|   @param  ExchangeValue A 32-bit value used in exchange operation.
 | |
| 
 | |
|   @return The original *Value before exchange.
 | |
| 
 | |
| **/
 | |
| UINT32
 | |
| EFIAPI
 | |
| InternalSyncCompareExchange32 (
 | |
|   IN      volatile UINT32           *Value,
 | |
|   IN      UINT32                    CompareValue,
 | |
|   IN      UINT32                    ExchangeValue
 | |
|   );
 | |
| 
 | |
| 
 | |
| /**
 | |
|   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  A 64-bit value used in compare operation.
 | |
|   @param  ExchangeValue A 64-bit value used in exchange operation.
 | |
| 
 | |
|   @return The original *Value before exchange.
 | |
| 
 | |
| **/
 | |
| UINT64
 | |
| EFIAPI
 | |
| InternalSyncCompareExchange64 (
 | |
|   IN      volatile UINT64           *Value,
 | |
|   IN      UINT64                    CompareValue,
 | |
|   IN      UINT64                    ExchangeValue
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   Internal function to retrieve the architecture specific spin lock alignment
 | |
|   requirements for optimal spin lock performance.
 | |
| 
 | |
|   @return The architecture specific spin lock alignment.
 | |
| 
 | |
| **/
 | |
| UINTN
 | |
| InternalGetSpinLockProperties (
 | |
|   VOID
 | |
|   );
 | |
| 
 | |
| #endif
 |