Changeset 58459 in vbox for trunk/src/VBox/Devices/EFI/Firmware/SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugMp.h

Timestamp:

Oct 28, 2015 8:17:18 PM (9 years ago)

Author:

vboxsync

Message:

EFI/Firmware: 'svn merge ^{/vendor/edk2/UDK2010.SR1} /vendor/edk2/current .', reverting and removing files+dirs listed in ReadMe.vbox, resolving conflicts with help from ../UDK2014.SP1/. This is a raw untested merge.

Location:

trunk/src/VBox/Devices/EFI/Firmware

Files:

• . (modified) (1 prop)
• SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugMp.h (modified) (8 diffs)

trunk/src/VBox/Devices/EFI/Firmware/SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugMp.h

@@ -2 +2 @@
   Header file for Multi-Processor support.
 
-  Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2013, 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
@@ -26 +26 @@
   SPIN_LOCK                 MpContextSpinLock;   ///< Lock for writting MP context
   SPIN_LOCK                 DebugPortSpinLock;   ///< Lock for access debug port
+  SPIN_LOCK                 MailboxSpinLock;     ///< Lock for accessing mail box
   UINT8                     CpuBreakMask[DEBUG_CPU_MAX_COUNT/8];        ///< Bitmask of all breaking CPUs
   UINT8                     CpuStopStatusMask[DEBUG_CPU_MAX_COUNT/8];   ///< Bitmask of CPU stop status
@@ -33 +34 @@
   UINT32                    DebugTimerInitCount; ///< Record BSP's init timer count
   BOOLEAN                   IpiSentByAp;         ///< TRUR: IPI is sent by AP. TALSE: IPI is sent by BSP
-  BOOLEAN                   RunCommandSet;       ///< TRUE: RUN commmand is not executed. FALSE : RUN command is executed.
+  BOOLEAN                   RunCommandSet;       ///< TRUE: RUN commmand is executing. FALSE : RUN command has been executed.
 } DEBUG_MP_CONTEXT;
 
-extern CONST BOOLEAN               MultiProcessorDebugSupport;
 extern DEBUG_MP_CONTEXT volatile   mDebugMpContext;
 extern DEBUG_CPU_DATA   volatile   mDebugCpuData;
@@ -63 +63 @@
 
 /**
-  Acquire access control on MP context.
+  Acquire a spin lock when Multi-processor supported.
 
   It will block in the function if cannot get the access control.
-
-**/
-VOID
-AcquireMpContextControl (
-  VOID
-  );
-
-/**
-  Release access control on MP context.
-
-**/
-VOID
-ReleaseMpContextControl (
-  VOID
-  );
-
-/**
-  Acquire access control on debug port.
-
-  It will block in the function if cannot get the access control.
-
-**/
-VOID
-AcquireDebugPortControl (
-  VOID
-  );
-
-/**
-  Release access control on debug port.
-
-**/
-VOID
-ReleaseDebugPortControl (
-  VOID
+  If Multi-processor is not supported, return directly.
+
+  @param[in, out] MpSpinLock      A pointer to the spin lock.
+
+**/
+VOID
+AcquireMpSpinLock (
+  IN OUT SPIN_LOCK           *MpSpinLock
+  );
+
+/**
+  Release a spin lock when Multi-processor supported.
+
+  @param[in, out] MpSpinLock      A pointer to the spin lock.
+
+**/
+VOID
+ReleaseMpSpinLock (
+  IN OUT SPIN_LOCK           *MpSpinLock
   );
 
@@ -182 +167 @@
 
 /**
-  Initialize debug timer.
+  Set the IPI send by BPS/AP flag.
 
   @param[in] IpiSentByApFlag   TRUE means this IPI is sent by AP.
@@ -194 +179 @@
 
 /**
-  Check if any processor breaks.
+  Check the next pending breaking CPU.
 
   @retval others      There is at least one processor broken, the minimum
@@ -202 +187 @@
 **/
 UINT32
-FindCpuNotRunning (
+FindNextPendingBreakCpu (
   VOID
   );
@@ -218 +203 @@
   );
 
+/**
+  Check if the current processor is the first breaking processor.
+
+  If yes, halt other processors.  
+  
+  @param[in] ProcessorIndex   Processor index value.
+  
+  @return TRUE       This processor is the first breaking processor.
+  @return FALSE      This processor is not the first breaking processor.
+                            
+**/
+BOOLEAN
+IsFirstBreakProcessor (
+  IN UINT32              ProcessorIndex
+  );
+  
 #endif