From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=134.134.136.65; helo=mga03.intel.com; envelope-from=zhichao.gao@intel.com; receiver=edk2-devel@lists.01.org Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 3BB92211DDA21 for ; Thu, 14 Mar 2019 22:18:15 -0700 (PDT) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 14 Mar 2019 22:18:14 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.58,481,1544515200"; d="scan'208";a="152540130" Received: from gaozhic-mobl.ccr.corp.intel.com ([10.239.196.107]) by fmsmga004.fm.intel.com with ESMTP; 14 Mar 2019 22:18:13 -0700 From: Zhichao Gao To: edk2-devel@lists.01.org Cc: Michael D Kinney , Liming Gao , Sean Brogan , Michael Turner , Bret Barkelew Date: Fri, 15 Mar 2019 13:17:33 +0800 Message-Id: <20190315051749.6564-2-zhichao.gao@intel.com> X-Mailer: git-send-email 2.16.2.windows.1 In-Reply-To: <20190315051749.6564-1-zhichao.gao@intel.com> References: <20190315051749.6564-1-zhichao.gao@intel.com> Subject: [PATCH V2 01/17] MdePkg/DebugLib.h: Add a new api DebugVPrint for DebugLib X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 15 Mar 2019 05:18:15 -0000 REF: https://bugzilla.tianocore.org/show_bug.cgi?id=1395 Add a new api DebugVPrint prototype definition in the DebugLib header file. This api would expose a print routine with VaList parameter. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Zhichao Gao Cc: Michael D Kinney Cc: Liming Gao Cc: Sean Brogan Cc: Michael Turner Cc: Bret Barkelew --- MdePkg/Include/Library/DebugLib.h | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/MdePkg/Include/Library/DebugLib.h b/MdePkg/Include/Library/DebugLib.h index e6a7a357b2..51d89bbd52 100644 --- a/MdePkg/Include/Library/DebugLib.h +++ b/MdePkg/Include/Library/DebugLib.h @@ -8,7 +8,7 @@ of size reduction when compiler optimization is disabled. If MDEPKG_NDEBUG is defined, then debug and assert related macros wrapped by it are the NULL implementations. -Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at @@ -101,6 +101,29 @@ 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 + ); + + /** Prints an assert message containing a filename, line number, and description. This may be followed by a breakpoint or a dead loop. @@ -221,6 +244,7 @@ DebugClearMemoryEnabled ( VOID ); + /** Returns TRUE if any one of the bit is set both in ErrorLevel and PcdFixedDebugPrintErrorLevel. @@ -236,6 +260,7 @@ DebugPrintLevelEnabled ( IN CONST UINTN ErrorLevel ); + /** Internal worker macro that calls DebugAssert(). @@ -273,6 +298,7 @@ DebugPrintLevelEnabled ( #define _DEBUG(Expression) DebugPrint Expression #endif + /** Macro that calls DebugAssert() if an expression evaluates to FALSE. @@ -299,6 +325,7 @@ DebugPrintLevelEnabled ( #define ASSERT(Expression) #endif + /** Macro that calls DebugPrint(). @@ -322,6 +349,7 @@ DebugPrintLevelEnabled ( #define DEBUG(Expression) #endif + /** Macro that calls DebugAssert() if an EFI_STATUS evaluates to an error code. @@ -348,6 +376,7 @@ DebugPrintLevelEnabled ( #define ASSERT_EFI_ERROR(StatusParameter) #endif + /** Macro that calls DebugAssert() if a RETURN_STATUS evaluates to an error code. @@ -375,6 +404,7 @@ DebugPrintLevelEnabled ( #define ASSERT_RETURN_ERROR(StatusParameter) #endif + /** Macro that calls DebugAssert() if a protocol is already installed in the handle database. @@ -418,6 +448,7 @@ DebugPrintLevelEnabled ( #define ASSERT_PROTOCOL_ALREADY_INSTALLED(Handle, Guid) #endif + /** Macro that marks the beginning of debug source code. -- 2.16.2.windows.1