MdePkg/DxeRuntimeDebugLibSerialPort: Add new APIs

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=1395

Add new APIs' implementation (DebugVPrint, DebugBPrint)
in the DebugLib instance. These APIs would expose print
routines with VaList parameter and BaseList parameter.

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Zhichao Gao <zhichao.gao@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Michael Turner <Michael.Turner@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

1 files changed, 101 insertions, 5 deletions

diff --git a/MdePkg/Library/DxeRuntimeDebugLibSerialPort/DebugLib.c b/MdePkg/Library/DxeRuntimeDebugLibSerialPort/DebugLib.c
index e1266f77fa..4af1cde488 100644
--- a/MdePkg/Library/DxeRuntimeDebugLibSerialPort/DebugLib.c
+++ b/MdePkg/Library/DxeRuntimeDebugLibSerialPort/DebugLib.c
@@ -4,7 +4,7 @@
   been called, to prevent touching hardware that is no longer owned by the

   firmware.

 

-  Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

   Copyright (c) 2018, Linaro, Ltd. All rights reserved.<BR>

 

   This program and the accompanying materials

@@ -34,6 +34,12 @@ STATIC BOOLEAN        mEfiAtRuntime = FALSE;
 //

 #define MAX_DEBUG_MESSAGE_LENGTH  0x100

 

+//

+// VA_LIST can not initialize to NULL for all compiler, so we use this to

+// indicate a null VA_LIST

+//

+VA_LIST     mVaListNull;

+

 /**

   Set AtRuntime flag as TRUE after ExitBootServices.

 

@@ -126,8 +132,40 @@ DebugPrint (
   ...

   )

 {

+  VA_LIST         Marker;

+

+  VA_START (Marker, Format);

+  DebugVPrint (ErrorLevel, Format, Marker);

+  VA_END (Marker);

+}

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled base on Null-terminated format string and a

+  VA_LIST argument list or a BASE_LIST argument list.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel      The error level of the debug message.

+  @param  Format          Format string for the debug message to print.

+  @param  VaListMarker    VA_LIST marker for the variable argument list.

+  @param  BaseListMarker  BASE_LIST marker for the variable argument list.

+

+**/

+VOID

+DebugPrintMarker (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  VA_LIST       VaListMarker,

+  IN  BASE_LIST     BaseListMarker

+  )

+{

   CHAR8    Buffer[MAX_DEBUG_MESSAGE_LENGTH];

-  VA_LIST  Marker;

 

   if (mEfiAtRuntime) {

     return;

@@ -148,9 +186,11 @@ DebugPrint (
   //

   // Convert the DEBUG() message to an ASCII String

   //

-  VA_START (Marker, Format);

-  AsciiVSPrint (Buffer, sizeof (Buffer), Format, Marker);

-  VA_END (Marker);

+  if (BaseListMarker == NULL) {

+    AsciiVSPrint (Buffer, sizeof (Buffer), Format, VaListMarker);

+  } else {

+    AsciiBSPrint (Buffer, sizeof (Buffer), Format, BaseListMarker);

+  }

 

   //

   // Send the print string to a Serial Port

@@ -160,6 +200,62 @@ DebugPrint (
 

 

 /**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel    The error level of the debug message.

+  @param  Format        Format string for the debug message to print.

+  @param  VaListMarker  VA_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+DebugVPrint (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  VA_LIST       VaListMarker

+  )

+{

+  DebugPrintMarker (ErrorLevel, Format, VaListMarker, NULL);

+}

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled.

+  This function use BASE_LIST which would provide a more compatible

+  service than VA_LIST.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel      The error level of the debug message.

+  @param  Format          Format string for the debug message to print.

+  @param  BaseListMarker  BASE_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+DebugBPrint (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  BASE_LIST     BaseListMarker

+  )

+{

+  DebugPrintMarker (ErrorLevel, Format, mVaListNull, BaseListMarker);

+}

+

+

+/**

   Prints an assert message containing a filename, line number, and description.

   This may be followed by a breakpoint or a dead loop.