From nobody Mon Apr 29 05:35:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+60749+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+60749+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1591344760; cv=none; d=zohomail.com; s=zohoarc; b=bzzczGNPAYcPy1V6Wr4uxSa39JfDy8Jr36FfW0+eF/9KuZUmW2ukaB14JpecL/wiCEKm9Lst9HyAQnd2h6kIvTtJDpwb7d0mUiA6rJB0wqHvay5jEXrnttcf5yFNr7zLJM10J0TPxNWJtumNYIDdJfRb61DoGCObMw5wzXwBBfE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1591344760; h=Cc:Date:From:List-Id:List-Unsubscribe:Message-ID:Reply-To:Sender:Subject:To; bh=uCXvouvnu9FEmDaAP17Sk2PMuz7Qc1c06ij1cOiGLGo=; b=AjzAhGKo52pII6az6macNsKsgalusCFh+0EO4onqW5u6d+Dd4vhimpWqFE/B6RYXpP+41zS4jdzRD8O2HNR3a5uqzXST2l59Bmm+YEWp41PWt90BOqvwAYp24XOAU6GSL8dLgSdCplermpuasZ4yKMTQO17/naOkq461StK0oks= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+60749+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1591344760298821.454048134013; Fri, 5 Jun 2020 01:12:40 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id lMrWYY1788612xulRkANXC98; Fri, 05 Jun 2020 01:12:39 -0700 X-Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by mx.groups.io with SMTP id smtpd.web12.6453.1591344759000567655 for ; Fri, 05 Jun 2020 01:12:39 -0700 IronPort-SDR: p4hPpeXK0p5C0LTF4UTfXr1xTA06bPYzWLg1VEU5ao54r7VBqypMzfnifvtWJVLXFlTciS9yUN O47yLX5SNBqA== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 05 Jun 2020 01:12:38 -0700 IronPort-SDR: 4ie2DCHKRIHqz/1BjGr1zShG5yNF3laSaymBTYDkZnpqzo1wn0yPVPVMqWyWP7d+AFMht43jhd XrpCtVaWJPqw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.73,475,1583222400"; d="scan'208";a="257970529" X-Received: from shenglei-dev.ccr.corp.intel.com ([10.239.158.52]) by fmsmga007.fm.intel.com with ESMTP; 05 Jun 2020 01:12:35 -0700 From: "Zhang, Shenglei" To: devel@edk2.groups.io Cc: Michael D Kinney , Liming Gao Subject: [edk2-devel] [PATCH] MdePkg: Remove code wrapped by DISABLE_NEW_DEPRECATED_INTERFACES Date: Fri, 5 Jun 2020 16:12:33 +0800 Message-Id: <20200605081233.20400-1-shenglei.zhang@intel.com> Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,shenglei.zhang@intel.com X-Gm-Message-State: e8MSrdvLJGDeJw4nGZGSQijix1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1591344759; bh=zzf5T2Jmdfc/qWyi4sN9RYgk1M05zKN2WFzqQVC2vfk=; h=Cc:Date:From:Reply-To:Subject:To; b=i5e6X7SobzpKWjjY1z17ndA3L9GHbqGGq+DITUWXuz5AFwSC5Vw/4dLVsOv9BOnrV+F 4gi0TbQlfzsARNFiY/XJxVP4S5nMgiwBoHsWJCG5LbbRNccEmAMfqMPc7riMcq+B77nq/ pbwEciCVPx7sTrdSeus3/Yt+dx3pseCe9M4= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D2777 Code wrapped by DISABLE_NEW_DEPRECATED_INTERFACES is deprecated. So remove it. Cc: Michael D Kinney Cc: Liming Gao Signed-off-by: Shenglei Zhang --- MdePkg/Library/BaseLib/String.c | 626 ------------------------- MdePkg/Library/BasePcdLibNull/PcdLib.c | 361 -------------- MdePkg/Library/BasePrintLib/PrintLib.c | 118 ----- MdePkg/Library/DxePcdLib/DxePcdLib.c | 399 ---------------- MdePkg/Library/PeiPcdLib/PeiPcdLib.c | 397 ---------------- MdePkg/Library/UefiLib/UefiLib.c | 92 ---- MdePkg/Include/Library/BaseLib.h | 409 ---------------- MdePkg/Include/Library/PcdLib.h | 520 -------------------- MdePkg/Include/Library/PrintLib.h | 110 ----- MdePkg/Include/Library/UefiLib.h | 53 --- MdePkg/MdePkg.dsc | 1 - 11 files changed, 3086 deletions(-) diff --git a/MdePkg/Library/BaseLib/String.c b/MdePkg/Library/BaseLib/Strin= g.c index 45198373f25c..f4854f357e3a 100644 --- a/MdePkg/Library/BaseLib/String.c +++ b/MdePkg/Library/BaseLib/String.c @@ -8,135 +8,6 @@ =20 #include "BaseLibInternals.h" =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function will be deprecated for security reason. - - Copies one Null-terminated Unicode string to another Null-terminated Uni= code - string and returns the new Unicode string. - - This function copies the contents of the Unicode string Source to the Un= icode - string Destination, and returns Destination. If Source and Destination - overlap, then the results are undefined. - - If Destination is NULL, then ASSERT(). - If Destination is not aligned on a 16-bit boundary, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source is not aligned on a 16-bit boundary, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - - @param Destination A pointer to a Null-terminated Unicode string. - @param Source A pointer to a Null-terminated Unicode string. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrCpy ( - OUT CHAR16 *Destination, - IN CONST CHAR16 *Source - ) -{ - CHAR16 *ReturnValue; - - // - // Destination cannot be NULL - // - ASSERT (Destination !=3D NULL); - ASSERT (((UINTN) Destination & BIT0) =3D=3D 0); - - // - // Destination and source cannot overlap - // - ASSERT ((UINTN)(Destination - Source) > StrLen (Source)); - ASSERT ((UINTN)(Source - Destination) > StrLen (Source)); - - ReturnValue =3D Destination; - while (*Source !=3D 0) { - *(Destination++) =3D *(Source++); - } - *Destination =3D 0; - return ReturnValue; -} - -/** - [ATTENTION] This function will be deprecated for security reason. - - Copies up to a specified length from one Null-terminated Unicode string = to - another Null-terminated Unicode string and returns the new Unicode strin= g. - - This function copies the contents of the Unicode string Source to the Un= icode - string Destination, and returns Destination. At most, Length Unicode - characters are copied from Source to Destination. If Length is 0, then - Destination is returned unmodified. If Length is greater that the number= of - Unicode characters in Source, then Destination is padded with Null Unico= de - characters. If Source and Destination overlap, then the results are - undefined. - - If Length > 0 and Destination is NULL, then ASSERT(). - If Length > 0 and Destination is not aligned on a 16-bit boundary, then = ASSERT(). - If Length > 0 and Source is NULL, then ASSERT(). - If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSER= T(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Length is greater than - PcdMaximumUnicodeStringLength, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the Null= -terminator, - then ASSERT(). - - @param Destination A pointer to a Null-terminated Unicode string. - @param Source A pointer to a Null-terminated Unicode string. - @param Length The maximum number of Unicode characters to copy. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrnCpy ( - OUT CHAR16 *Destination, - IN CONST CHAR16 *Source, - IN UINTN Length - ) -{ - CHAR16 *ReturnValue; - - if (Length =3D=3D 0) { - return Destination; - } - - // - // Destination cannot be NULL if Length is not zero - // - ASSERT (Destination !=3D NULL); - ASSERT (((UINTN) Destination & BIT0) =3D=3D 0); - - // - // Destination and source cannot overlap - // - ASSERT ((UINTN)(Destination - Source) > StrLen (Source)); - ASSERT ((UINTN)(Source - Destination) >=3D Length); - - if (PcdGet32 (PcdMaximumUnicodeStringLength) !=3D 0) { - ASSERT (Length <=3D PcdGet32 (PcdMaximumUnicodeStringLength)); - } - - ReturnValue =3D Destination; - - while ((*Source !=3D L'\0') && (Length > 0)) { - *(Destination++) =3D *(Source++); - Length--; - } - - ZeroMem (Destination, Length * sizeof (*Destination)); - return ReturnValue; -} -#endif =20 /** Returns the length of a Null-terminated Unicode string. @@ -320,121 +191,6 @@ StrnCmp ( return *FirstString - *SecondString; } =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function will be deprecated for security reason. - - Concatenates one Null-terminated Unicode string to another Null-terminat= ed - Unicode string, and returns the concatenated Unicode string. - - This function concatenates two Null-terminated Unicode strings. The cont= ents - of Null-terminated Unicode string Source are concatenated to the end of - Null-terminated Unicode string Destination. The Null-terminated concaten= ated - Unicode String is returned. If Source and Destination overlap, then the - results are undefined. - - If Destination is NULL, then ASSERT(). - If Destination is not aligned on a 16-bit boundary, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source is not aligned on a 16-bit boundary, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Destination contains m= ore - than PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and concatenating Destinat= ion - and Source results in a Unicode string with more than - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - - @param Destination A pointer to a Null-terminated Unicode string. - @param Source A pointer to a Null-terminated Unicode string. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrCat ( - IN OUT CHAR16 *Destination, - IN CONST CHAR16 *Source - ) -{ - StrCpy (Destination + StrLen (Destination), Source); - - // - // Size of the resulting string should never be zero. - // PcdMaximumUnicodeStringLength is tested inside StrLen(). - // - ASSERT (StrSize (Destination) !=3D 0); - return Destination; -} - -/** - [ATTENTION] This function will be deprecated for security reason. - - Concatenates up to a specified length one Null-terminated Unicode to the= end - of another Null-terminated Unicode string, and returns the concatenated - Unicode string. - - This function concatenates two Null-terminated Unicode strings. The cont= ents - of Null-terminated Unicode string Source are concatenated to the end of - Null-terminated Unicode string Destination, and Destination is returned.= At - most, Length Unicode characters are concatenated from Source to the end = of - Destination, and Destination is always Null-terminated. If Length is 0, = then - Destination is returned unmodified. If Source and Destination overlap, t= hen - the results are undefined. - - If Destination is NULL, then ASSERT(). - If Length > 0 and Destination is not aligned on a 16-bit boundary, then = ASSERT(). - If Length > 0 and Source is NULL, then ASSERT(). - If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSER= T(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Length is greater than - PcdMaximumUnicodeStringLength, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Destination contains m= ore - than PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and concatenating Destinat= ion - and Source results in a Unicode string with more than PcdMaximumUnicodeS= tringLength - Unicode characters, not including the Null-terminator, then ASSERT(). - - @param Destination A pointer to a Null-terminated Unicode string. - @param Source A pointer to a Null-terminated Unicode string. - @param Length The maximum number of Unicode characters to concaten= ate from - Source. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrnCat ( - IN OUT CHAR16 *Destination, - IN CONST CHAR16 *Source, - IN UINTN Length - ) -{ - UINTN DestinationLen; - - DestinationLen =3D StrLen (Destination); - StrnCpy (Destination + DestinationLen, Source, Length); - Destination[DestinationLen + Length] =3D L'\0'; - - // - // Size of the resulting string should never be zero. - // PcdMaximumUnicodeStringLength is tested inside StrLen(). - // - ASSERT (StrSize (Destination) !=3D 0); - return Destination; -} -#endif =20 /** Returns the first occurrence of a Null-terminated Unicode sub-string @@ -845,208 +601,6 @@ InternalAsciiIsHexaDecimalDigitCharacter ( (Char >=3D 'a' && Char <=3D 'f')); } =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Convert a Null-terminated Unicode string to a Null-terminated - ASCII string and returns the ASCII string. - - This function converts the content of the Unicode string Source - to the ASCII string Destination by copying the lower 8 bits of - each Unicode character. It returns Destination. - - The caller is responsible to make sure Destination points to a buffer wi= th size - equal or greater than ((StrLen (Source) + 1) * sizeof (CHAR8)) in bytes. - - If any Unicode characters in Source contain non-zero value in - the upper 8 bits, then ASSERT(). - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source is not aligned on a 16-bit boundary, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - - If PcdMaximumUnicodeStringLength is not zero, and Source contains - more than PcdMaximumUnicodeStringLength Unicode characters, not including - the Null-terminator, then ASSERT(). - - If PcdMaximumAsciiStringLength is not zero, and Source contains more - than PcdMaximumAsciiStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - - @param Source A pointer to a Null-terminated Unicode string. - @param Destination A pointer to a Null-terminated ASCII string. - - @return Destination. - -**/ -CHAR8 * -EFIAPI -UnicodeStrToAsciiStr ( - IN CONST CHAR16 *Source, - OUT CHAR8 *Destination - ) -{ - CHAR8 *ReturnValue; - - ASSERT (Destination !=3D NULL); - - // - // ASSERT if Source is long than PcdMaximumUnicodeStringLength. - // Length tests are performed inside StrLen(). - // - ASSERT (StrSize (Source) !=3D 0); - - // - // Source and Destination should not overlap - // - ASSERT ((UINTN) (Destination - (CHAR8 *) Source) >=3D StrSize (Source)); - ASSERT ((UINTN) ((CHAR8 *) Source - Destination) > StrLen (Source)); - - - ReturnValue =3D Destination; - while (*Source !=3D '\0') { - // - // If any Unicode characters in Source contain - // non-zero value in the upper 8 bits, then ASSERT(). - // - ASSERT (*Source < 0x100); - *(Destination++) =3D (CHAR8) *(Source++); - } - - *Destination =3D '\0'; - - // - // ASSERT Original Destination is less long than PcdMaximumAsciiStringLe= ngth. - // Length tests are performed inside AsciiStrLen(). - // - ASSERT (AsciiStrSize (ReturnValue) !=3D 0); - - return ReturnValue; -} - -/** - [ATTENTION] This function will be deprecated for security reason. - - Copies one Null-terminated ASCII string to another Null-terminated ASCII - string and returns the new ASCII string. - - This function copies the contents of the ASCII string Source to the ASCII - string Destination, and returns Destination. If Source and Destination - overlap, then the results are undefined. - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and Source contains more than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - - @param Destination A pointer to a Null-terminated ASCII string. - @param Source A pointer to a Null-terminated ASCII string. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrCpy ( - OUT CHAR8 *Destination, - IN CONST CHAR8 *Source - ) -{ - CHAR8 *ReturnValue; - - // - // Destination cannot be NULL - // - ASSERT (Destination !=3D NULL); - - // - // Destination and source cannot overlap - // - ASSERT ((UINTN)(Destination - Source) > AsciiStrLen (Source)); - ASSERT ((UINTN)(Source - Destination) > AsciiStrLen (Source)); - - ReturnValue =3D Destination; - while (*Source !=3D 0) { - *(Destination++) =3D *(Source++); - } - *Destination =3D 0; - return ReturnValue; -} - -/** - [ATTENTION] This function will be deprecated for security reason. - - Copies up to a specified length one Null-terminated ASCII string to anot= her - Null-terminated ASCII string and returns the new ASCII string. - - This function copies the contents of the ASCII string Source to the ASCII - string Destination, and returns Destination. At most, Length ASCII chara= cters - are copied from Source to Destination. If Length is 0, then Destination = is - returned unmodified. If Length is greater that the number of ASCII chara= cters - in Source, then Destination is padded with Null ASCII characters. If Sou= rce - and Destination overlap, then the results are undefined. - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Length is greater than - PcdMaximumAsciiStringLength, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Source contains more than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - - @param Destination A pointer to a Null-terminated ASCII string. - @param Source A pointer to a Null-terminated ASCII string. - @param Length The maximum number of ASCII characters to copy. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrnCpy ( - OUT CHAR8 *Destination, - IN CONST CHAR8 *Source, - IN UINTN Length - ) -{ - CHAR8 *ReturnValue; - - if (Length =3D=3D 0) { - return Destination; - } - - // - // Destination cannot be NULL - // - ASSERT (Destination !=3D NULL); - - // - // Destination and source cannot overlap - // - ASSERT ((UINTN)(Destination - Source) > AsciiStrLen (Source)); - ASSERT ((UINTN)(Source - Destination) >=3D Length); - - if (PcdGet32 (PcdMaximumAsciiStringLength) !=3D 0) { - ASSERT (Length <=3D PcdGet32 (PcdMaximumAsciiStringLength)); - } - - ReturnValue =3D Destination; - - while (*Source !=3D 0 && Length > 0) { - *(Destination++) =3D *(Source++); - Length--; - } - - ZeroMem (Destination, Length * sizeof (*Destination)); - return ReturnValue; -} -#endif =20 /** Returns the length of a Null-terminated ASCII string. @@ -1329,114 +883,6 @@ AsciiStrnCmp ( return *FirstString - *SecondString; } =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function will be deprecated for security reason. - - Concatenates one Null-terminated ASCII string to another Null-terminated - ASCII string, and returns the concatenated ASCII string. - - This function concatenates two Null-terminated ASCII strings. The conten= ts of - Null-terminated ASCII string Source are concatenated to the end of Null- - terminated ASCII string Destination. The Null-terminated concatenated AS= CII - String is returned. - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and Destination contains more= than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and Source contains more than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and concatenating Destination= and - Source results in a ASCII string with more than PcdMaximumAsciiStringLen= gth - ASCII characters, then ASSERT(). - - @param Destination A pointer to a Null-terminated ASCII string. - @param Source A pointer to a Null-terminated ASCII string. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrCat ( - IN OUT CHAR8 *Destination, - IN CONST CHAR8 *Source - ) -{ - AsciiStrCpy (Destination + AsciiStrLen (Destination), Source); - - // - // Size of the resulting string should never be zero. - // PcdMaximumUnicodeStringLength is tested inside StrLen(). - // - ASSERT (AsciiStrSize (Destination) !=3D 0); - return Destination; -} - -/** - [ATTENTION] This function will be deprecated for security reason. - - Concatenates up to a specified length one Null-terminated ASCII string to - the end of another Null-terminated ASCII string, and returns the - concatenated ASCII string. - - This function concatenates two Null-terminated ASCII strings. The conten= ts - of Null-terminated ASCII string Source are concatenated to the end of Nu= ll- - terminated ASCII string Destination, and Destination is returned. At mos= t, - Length ASCII characters are concatenated from Source to the end of - Destination, and Destination is always Null-terminated. If Length is 0, = then - Destination is returned unmodified. If Source and Destination overlap, t= hen - the results are undefined. - - If Length > 0 and Destination is NULL, then ASSERT(). - If Length > 0 and Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Length is greater than - PcdMaximumAsciiStringLength, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Destination contains mor= e than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Source contains more than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and concatenating Destinatio= n and - Source results in a ASCII string with more than PcdMaximumAsciiStringLen= gth - ASCII characters, not including the Null-terminator, then ASSERT(). - - @param Destination A pointer to a Null-terminated ASCII string. - @param Source A pointer to a Null-terminated ASCII string. - @param Length The maximum number of ASCII characters to concatenat= e from - Source. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrnCat ( - IN OUT CHAR8 *Destination, - IN CONST CHAR8 *Source, - IN UINTN Length - ) -{ - UINTN DestinationLen; - - DestinationLen =3D AsciiStrLen (Destination); - AsciiStrnCpy (Destination + DestinationLen, Source, Length); - Destination[DestinationLen + Length] =3D '\0'; - - // - // Size of the resulting string should never be zero. - // PcdMaximumUnicodeStringLength is tested inside StrLen(). - // - ASSERT (AsciiStrSize (Destination) !=3D 0); - return Destination; -} -#endif =20 /** Returns the first occurrence of a Null-terminated ASCII sub-string @@ -1684,78 +1130,6 @@ AsciiStrHexToUint64 ( return Result; } =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Convert one Null-terminated ASCII string to a Null-terminated - Unicode string and returns the Unicode string. - - This function converts the contents of the ASCII string Source to the Un= icode - string Destination, and returns Destination. The function terminates the - Unicode string Destination by appending a Null-terminator character at t= he end. - The caller is responsible to make sure Destination points to a buffer wi= th size - equal or greater than ((AsciiStrLen (Source) + 1) * sizeof (CHAR16)) in = bytes. - - If Destination is NULL, then ASSERT(). - If Destination is not aligned on a 16-bit boundary, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Source contains more than - PcdMaximumAsciiStringLength ASCII characters not including the Null-term= inator, - then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength ASCII characters not including the - Null-terminator, then ASSERT(). - - @param Source A pointer to a Null-terminated ASCII string. - @param Destination A pointer to a Null-terminated Unicode string. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -AsciiStrToUnicodeStr ( - IN CONST CHAR8 *Source, - OUT CHAR16 *Destination - ) -{ - CHAR16 *ReturnValue; - - ASSERT (Destination !=3D NULL); - - // - // ASSERT Source is less long than PcdMaximumAsciiStringLength - // - ASSERT (AsciiStrSize (Source) !=3D 0); - - // - // Source and Destination should not overlap - // - ASSERT ((UINTN) ((CHAR8 *) Destination - Source) > AsciiStrLen (Source)); - ASSERT ((UINTN) (Source - (CHAR8 *) Destination) >=3D (AsciiStrSize (Sou= rce) * sizeof (CHAR16))); - - - ReturnValue =3D Destination; - while (*Source !=3D '\0') { - *(Destination++) =3D (CHAR16)(UINT8) *(Source++); - } - // - // End the Destination with a NULL. - // - *Destination =3D '\0'; - - // - // ASSERT Original Destination is less long than PcdMaximumUnicodeString= Length - // - ASSERT (StrSize (ReturnValue) !=3D 0); - - return ReturnValue; -} - -#endif =20 STATIC CHAR8 EncodingTable[] =3D "ABCDEFGHIJKLMNOPQRSTUVWXYZ" "abcdefghijklmnopqrstuvwxyz" diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c b/MdePkg/Library/BasePc= dLibNull/PcdLib.c index 49447880ae8b..265fae5d7368 100644 --- a/MdePkg/Library/BasePcdLibNull/PcdLib.c +++ b/MdePkg/Library/BasePcdLibNull/PcdLib.c @@ -386,367 +386,6 @@ LibPcdGetExSize ( } =20 =20 - -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSet8 ( - IN UINTN TokenNumber, - IN UINT8 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSet16 ( - IN UINTN TokenNumber, - IN UINT16 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSet32 ( - IN UINTN TokenNumber, - IN UINT32 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSet64 ( - IN UINTN TokenNumber, - IN UINT64 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value - specified by Buffer and SizeOfBuffer. Buffer is returned. - If SizeOfBuffer is greater than the maximum size support by TokenNumber, - then set SizeOfBuffer to the maximum size supported by TokenNumber and - return NULL to indicate that the set operation was not actually performe= d. - - If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to = the - maximum size supported by TokenName and NULL must be returned. - - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pointer for the buffer been set. - -**/ -VOID * -EFIAPI -LibPcdSetPtr ( - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN CONST VOID *Buffer - ) -{ - ASSERT (FALSE); - - return NULL; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The boolean value to set. - - @return Return the value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetBool ( - IN UINTN TokenNumber, - IN BOOLEAN Value - ) -{ - ASSERT (FALSE); - - return FALSE; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSetEx8 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT8 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSetEx16 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT16 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSetEx32 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT32 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSetEx64 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT64 Value - ) -{ - ASSERT (FALSE); - - return 0; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value specif= ied by - Buffer and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greate= r than - the maximum size support by TokenNumber, then set SizeOfBuffer to the ma= ximum size - supported by TokenNumber and return NULL to indicate that the set operat= ion - was not actually performed. - - If Guid is NULL, then ASSERT(). - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value = from. - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pinter to the buffer been set. - -**/ -VOID * -EFIAPI -LibPcdSetExPtr ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN VOID *Buffer - ) -{ - ASSERT (FALSE); - - return NULL; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The Boolean value to set. - - @return Return the value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetExBool ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN BOOLEAN Value - ) -{ - ASSERT (FALSE); - - return FALSE; -} -#endif - /** This function provides a means by which to set a value for a given PCD t= oken. =20 diff --git a/MdePkg/Library/BasePrintLib/PrintLib.c b/MdePkg/Library/BasePr= intLib/PrintLib.c index af771652e4b0..8bfbab05f58c 100644 --- a/MdePkg/Library/BasePrintLib/PrintLib.c +++ b/MdePkg/Library/BasePrintLib/PrintLib.c @@ -343,65 +343,6 @@ UnicodeSPrintAsciiFormat ( return NumberOfPrinted; } =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Converts a decimal value to a Null-terminated Unicode string. - - Converts the decimal number specified by Value to a Null-terminated Unic= ode - string specified by Buffer containing at most Width characters. No paddi= ng of spaces - is ever performed. If Width is 0 then a width of MAXIMUM_VALUE_CHARACTER= S is assumed. - The number of Unicode characters in Buffer is returned not including the= Null-terminator. - If the conversion contains more than Width characters, then only the fir= st - Width characters are returned, and the total number of characters - required to perform the conversion is returned. - Additional conversion parameters are specified in Flags. - - The Flags bit LEFT_JUSTIFY is always ignored. - All conversions are left justified in Buffer. - If Width is 0, PREFIX_ZERO is ignored in Flags. - If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and= commas - are inserted every 3rd digit starting from the right. - If RADIX_HEX is set in Flags, then the output buffer will be - formatted in hexadecimal format. - If Value is < 0 and RADIX_HEX is not set in Flags, then the fist charact= er in Buffer is a '-'. - If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, - then Buffer is padded with '0' characters so the combination of the opti= onal '-' - sign character, '0' characters, digit characters for Value, and the Null= -terminator - add up to Width characters. - If both COMMA_TYPE and RADIX_HEX are set in Flags, then ASSERT(). - If Buffer is NULL, then ASSERT(). - If Buffer is not aligned on a 16-bit boundary, then ASSERT(). - If unsupported bits are set in Flags, then ASSERT(). - If both COMMA_TYPE and RADIX_HEX are set in Flags, then ASSERT(). - If Width >=3D MAXIMUM_VALUE_CHARACTERS, then ASSERT() - - @param Buffer The pointer to the output buffer for the produced Null-t= erminated - Unicode string. - @param Flags The bitmask of flags that specify left justification, ze= ro pad, and commas. - @param Value The 64-bit signed value to convert to a string. - @param Width The maximum number of Unicode characters to place in Buf= fer, not including - the Null-terminator. - - @return The number of Unicode characters in Buffer not including the Nul= l-terminator. - -**/ -UINTN -EFIAPI -UnicodeValueToString ( - IN OUT CHAR16 *Buffer, - IN UINTN Flags, - IN INT64 Value, - IN UINTN Width - ) -{ - ASSERT_UNICODE_BUFFER(Buffer); - return BasePrintLibConvertValueToString ((CHAR8 *)Buffer, Flags, Value, = Width, 2); -} - -#endif =20 /** Converts a decimal value to a Null-terminated Unicode string. @@ -780,65 +721,6 @@ AsciiSPrintUnicodeFormat ( return NumberOfPrinted; } =20 - -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Converts a decimal value to a Null-terminated ASCII string. - - Converts the decimal number specified by Value to a Null-terminated ASCI= I string - specified by Buffer containing at most Width characters. No padding of s= paces - is ever performed. - If Width is 0 then a width of MAXIMUM_VALUE_CHARACTERS is assumed. - The number of ASCII characters in Buffer is returned not including the N= ull-terminator. - If the conversion contains more than Width characters, then only the fir= st Width - characters are returned, and the total number of characters required to = perform - the conversion is returned. - Additional conversion parameters are specified in Flags. - The Flags bit LEFT_JUSTIFY is always ignored. - All conversions are left justified in Buffer. - If Width is 0, PREFIX_ZERO is ignored in Flags. - If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and= commas - are inserted every 3rd digit starting from the right. - If RADIX_HEX is set in Flags, then the output buffer will be - formatted in hexadecimal format. - If Value is < 0 and RADIX_HEX is not set in Flags, then the fist charact= er in Buffer is a '-'. - If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, - then Buffer is padded with '0' characters so the combination of the opti= onal '-' - sign character, '0' characters, digit characters for Value, and the Null= -terminator - add up to Width characters. - - If Buffer is NULL, then ASSERT(). - If unsupported bits are set in Flags, then ASSERT(). - If both COMMA_TYPE and RADIX_HEX are set in Flags, then ASSERT(). - If Width >=3D MAXIMUM_VALUE_CHARACTERS, then ASSERT() - - @param Buffer The pointer to the output buffer for the produced Null-t= erminated - ASCII string. - @param Flags The bitmask of flags that specify left justification, ze= ro pad, and commas. - @param Value The 64-bit signed value to convert to a string. - @param Width The maximum number of ASCII characters to place in Buffe= r, not including - the Null-terminator. - - @return The number of ASCII characters in Buffer not including the Null-= terminator. - -**/ -UINTN -EFIAPI -AsciiValueToString ( - OUT CHAR8 *Buffer, - IN UINTN Flags, - IN INT64 Value, - IN UINTN Width - ) -{ - return BasePrintLibConvertValueToString (Buffer, Flags, Value, Width, 1); -} - -#endif - /** Converts a decimal value to a Null-terminated Ascii string. =20 diff --git a/MdePkg/Library/DxePcdLib/DxePcdLib.c b/MdePkg/Library/DxePcdLi= b/DxePcdLib.c index 6e3e4e70697f..2accaeda2cd6 100644 --- a/MdePkg/Library/DxePcdLib/DxePcdLib.c +++ b/MdePkg/Library/DxePcdLib/DxePcdLib.c @@ -474,405 +474,6 @@ LibPcdGetExSize ( } =20 =20 - -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSet8 ( - IN UINTN TokenNumber, - IN UINT8 Value - ) -{ - GetPcdProtocol()->Set8 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSet16 ( - IN UINTN TokenNumber, - IN UINT16 Value - ) -{ - GetPcdProtocol()->Set16 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSet32 ( - IN UINTN TokenNumber, - IN UINT32 Value - ) -{ - GetPcdProtocol()->Set32 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSet64 ( - IN UINTN TokenNumber, - IN UINT64 Value - ) -{ - GetPcdProtocol()->Set64 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value - specified by Buffer and SizeOfBuffer. Buffer is returned. - If SizeOfBuffer is greater than the maximum size support by TokenNumber, - then set SizeOfBuffer to the maximum size supported by TokenNumber and - return NULL to indicate that the set operation was not actually performe= d. - - If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to = the - maximum size supported by TokenName and NULL must be returned. - - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pointer for the buffer been set. - -**/ -VOID * -EFIAPI -LibPcdSetPtr ( - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN CONST VOID *Buffer - ) -{ - EFI_STATUS Status; - UINTN InputSizeOfBuffer; - - ASSERT (SizeOfBuffer !=3D NULL); - - if (*SizeOfBuffer > 0) { - ASSERT (Buffer !=3D NULL); - } - - InputSizeOfBuffer =3D *SizeOfBuffer; - Status =3D GetPcdProtocol()->SetPtr (TokenNumber, SizeOfBuffer, (VOID *)= Buffer); - if (EFI_ERROR (Status) && (*SizeOfBuffer < InputSizeOfBuffer)) { - return NULL; - } - - return (VOID *)Buffer; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The boolean value to set. - - @return Return the value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetBool ( - IN UINTN TokenNumber, - IN BOOLEAN Value - ) -{ - GetPcdProtocol()->SetBool (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSetEx8 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT8 Value - ) -{ - ASSERT (Guid !=3D NULL); - - GetPiPcdProtocol()->Set8 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSetEx16 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT16 Value - ) -{ - ASSERT (Guid !=3D NULL); - - GetPiPcdProtocol()->Set16 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSetEx32 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT32 Value - ) -{ - ASSERT (Guid !=3D NULL); - - GetPiPcdProtocol()->Set32 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSetEx64 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT64 Value - ) -{ - ASSERT (Guid !=3D NULL); - - GetPiPcdProtocol()->Set64 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value specif= ied by - Buffer and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greate= r than - the maximum size support by TokenNumber, then set SizeOfBuffer to the ma= ximum size - supported by TokenNumber and return NULL to indicate that the set operat= ion - was not actually performed. - - If Guid is NULL, then ASSERT(). - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value = from. - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pointer to the buffer been set. - -**/ -VOID * -EFIAPI -LibPcdSetExPtr ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN VOID *Buffer - ) -{ - EFI_STATUS Status; - UINTN InputSizeOfBuffer; - - ASSERT (Guid !=3D NULL); - - ASSERT (SizeOfBuffer !=3D NULL); - - if (*SizeOfBuffer > 0) { - ASSERT (Buffer !=3D NULL); - } - - InputSizeOfBuffer =3D *SizeOfBuffer; - Status =3D GetPiPcdProtocol()->SetPtr (Guid, TokenNumber, SizeOfBuffer, = Buffer); - if (EFI_ERROR (Status) && (*SizeOfBuffer < InputSizeOfBuffer)) { - return NULL; - } - - return Buffer; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The Boolean value to set. - - @return Return the value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetExBool ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN BOOLEAN Value - ) -{ - ASSERT (Guid !=3D NULL); - - GetPiPcdProtocol()->SetBool (Guid, TokenNumber, Value); - - return Value; -} -#endif - /** This function provides a means by which to set a value for a given PCD t= oken. =20 diff --git a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c b/MdePkg/Library/PeiPcdLi= b/PeiPcdLib.c index 916a2c0844eb..d979b28cc8dd 100644 --- a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c +++ b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c @@ -474,403 +474,6 @@ LibPcdGetExSize ( } =20 =20 - -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSet8 ( - IN UINTN TokenNumber, - IN UINT8 Value - ) -{ - (GetPcdPpiPointer ())->Set8 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSet16 ( - IN UINTN TokenNumber, - IN UINT16 Value - ) -{ - (GetPcdPpiPointer ())->Set16 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSet32 ( - IN UINTN TokenNumber, - IN UINT32 Value - ) -{ - (GetPcdPpiPointer ())->Set32 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSet64 ( - IN UINTN TokenNumber, - IN UINT64 Value - ) -{ - (GetPcdPpiPointer ())->Set64 (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value - specified by Buffer and SizeOfBuffer. Buffer is returned. - If SizeOfBuffer is greater than the maximum size support by TokenNumber, - then set SizeOfBuffer to the maximum size supported by TokenNumber and - return NULL to indicate that the set operation was not actually performe= d. - - If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to = the - maximum size supported by TokenName and NULL must be returned. - - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pointer for the buffer been set. - -**/ -VOID * -EFIAPI -LibPcdSetPtr ( - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN CONST VOID *Buffer - ) -{ - EFI_STATUS Status; - UINTN InputSizeOfBuffer; - - ASSERT (SizeOfBuffer !=3D NULL); - - if (*SizeOfBuffer > 0) { - ASSERT (Buffer !=3D NULL); - } - - InputSizeOfBuffer =3D *SizeOfBuffer; - Status =3D (GetPcdPpiPointer ())->SetPtr (TokenNumber, SizeOfBuffer, (VO= ID *) Buffer); - if (EFI_ERROR (Status) && (*SizeOfBuffer < InputSizeOfBuffer)) { - return NULL; - } - - return (VOID *) Buffer; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The boolean value to set. - - @return Return the value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetBool ( - IN UINTN TokenNumber, - IN BOOLEAN Value - ) -{ - (GetPcdPpiPointer ())->SetBool (TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSetEx8 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT8 Value - ) -{ - ASSERT (Guid !=3D NULL); - - (GetPiPcdPpiPointer ())->Set8 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSetEx16 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT16 Value - ) -{ - ASSERT (Guid !=3D NULL); - - (GetPiPcdPpiPointer ())->Set16 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSetEx32 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT32 Value - ) -{ - ASSERT (Guid !=3D NULL); - - (GetPiPcdPpiPointer ())->Set32 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSetEx64 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT64 Value - ) -{ - ASSERT (Guid !=3D NULL); - - (GetPiPcdPpiPointer ())->Set64 (Guid, TokenNumber, Value); - - return Value; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value specif= ied by - Buffer and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greate= r than - the maximum size support by TokenNumber, then set SizeOfBuffer to the ma= ximum size - supported by TokenNumber and return NULL to indicate that the set operat= ion - was not actually performed. - - If Guid is NULL, then ASSERT(). - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value = from. - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pinter to the buffer been set. - -**/ -VOID * -EFIAPI -LibPcdSetExPtr ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN VOID *Buffer - ) -{ - EFI_STATUS Status; - UINTN InputSizeOfBuffer; - - ASSERT (SizeOfBuffer !=3D NULL); - if (*SizeOfBuffer > 0) { - ASSERT (Buffer !=3D NULL); - } - ASSERT (Guid !=3D NULL); - - InputSizeOfBuffer =3D *SizeOfBuffer; - Status =3D (GetPiPcdPpiPointer ())->SetPtr (Guid, TokenNumber, SizeOfBuf= fer, Buffer); - if (EFI_ERROR (Status) && (*SizeOfBuffer < InputSizeOfBuffer)) { - return NULL; - } - - return Buffer; -} - - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid The pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The Boolean value to set. - - @return Return the value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetExBool ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN BOOLEAN Value - ) -{ - ASSERT (Guid !=3D NULL); - - (GetPiPcdPpiPointer ())->SetBool (Guid, TokenNumber, Value); - - return Value; -} -#endif - /** This function provides a means by which to set a value for a given PCD t= oken. =20 diff --git a/MdePkg/Library/UefiLib/UefiLib.c b/MdePkg/Library/UefiLib/Uefi= Lib.c index 07c45d1e91ff..835218f9824f 100644 --- a/MdePkg/Library/UefiLib/UefiLib.c +++ b/MdePkg/Library/UefiLib/UefiLib.c @@ -1285,98 +1285,6 @@ FreeUnicodeStringTable ( return EFI_SUCCESS; } =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function will be deprecated for security reason. - - Returns a pointer to an allocated buffer that contains the contents of a - variable retrieved through the UEFI Runtime Service GetVariable(). The - returned buffer is allocated using AllocatePool(). The caller is respon= sible - for freeing this buffer with FreePool(). - - If Name is NULL, then ASSERT(). - If Guid is NULL, then ASSERT(). - - @param[in] Name The pointer to a Null-terminated Unicode string. - @param[in] Guid The pointer to an EFI_GUID structure - - @retval NULL The variable could not be retrieved. - @retval NULL There are not enough resources available for the variable= contents. - @retval Other A pointer to allocated buffer containing the variable con= tents. - -**/ -VOID * -EFIAPI -GetVariable ( - IN CONST CHAR16 *Name, - IN CONST EFI_GUID *Guid - ) -{ - EFI_STATUS Status; - UINTN Size; - VOID *Value; - - ASSERT (Name !=3D NULL); - ASSERT (Guid !=3D NULL); - - // - // Try to get the variable size. - // - Value =3D NULL; - Size =3D 0; - Status =3D gRT->GetVariable ((CHAR16 *) Name, (EFI_GUID *) Guid, NULL, &= Size, Value); - if (Status !=3D EFI_BUFFER_TOO_SMALL) { - return NULL; - } - - // - // Allocate buffer to get the variable. - // - Value =3D AllocatePool (Size); - if (Value =3D=3D NULL) { - return NULL; - } - - // - // Get the variable data. - // - Status =3D gRT->GetVariable ((CHAR16 *) Name, (EFI_GUID *) Guid, NULL, &= Size, Value); - if (EFI_ERROR (Status)) { - FreePool(Value); - return NULL; - } - - return Value; -} - -/** - [ATTENTION] This function will be deprecated for security reason. - - Returns a pointer to an allocated buffer that contains the contents of a - variable retrieved through the UEFI Runtime Service GetVariable(). This - function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables. - The returned buffer is allocated using AllocatePool(). The caller is - responsible for freeing this buffer with FreePool(). - - If Name is NULL, then ASSERT(). - - @param[in] Name The pointer to a Null-terminated Unicode string. - - @retval NULL The variable could not be retrieved. - @retval NULL There are not enough resources available for the variable= contents. - @retval Other A pointer to allocated buffer containing the variable con= tents. - -**/ -VOID * -EFIAPI -GetEfiGlobalVariable ( - IN CONST CHAR16 *Name - ) -{ - return GetVariable (Name, &gEfiGlobalVariableGuid); -} -#endif =20 /** Returns the status whether get the variable success. The function retrie= ves diff --git a/MdePkg/Include/Library/BaseLib.h b/MdePkg/Include/Library/Base= Lib.h index 8e7b87cbda4e..b92a1a3a4028 100644 --- a/MdePkg/Include/Library/BaseLib.h +++ b/MdePkg/Include/Library/BaseLib.h @@ -962,82 +962,6 @@ AsciiStrHexToUint64S ( ); =20 =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Copies one Null-terminated Unicode string to another Null-terminated Uni= code - string and returns the new Unicode string. - - This function copies the contents of the Unicode string Source to the Un= icode - string Destination, and returns Destination. If Source and Destination - overlap, then the results are undefined. - - If Destination is NULL, then ASSERT(). - If Destination is not aligned on a 16-bit boundary, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source is not aligned on a 16-bit boundary, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters not including the - Null-terminator, then ASSERT(). - - @param Destination The pointer to a Null-terminated Unicode string. - @param Source The pointer to a Null-terminated Unicode string. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrCpy ( - OUT CHAR16 *Destination, - IN CONST CHAR16 *Source - ); - - -/** - [ATTENTION] This function is deprecated for security reason. - - Copies up to a specified length from one Null-terminated Unicode string = to - another Null-terminated Unicode string and returns the new Unicode strin= g. - - This function copies the contents of the Unicode string Source to the Un= icode - string Destination, and returns Destination. At most, Length Unicode - characters are copied from Source to Destination. If Length is 0, then - Destination is returned unmodified. If Length is greater that the number= of - Unicode characters in Source, then Destination is padded with Null Unico= de - characters. If Source and Destination overlap, then the results are - undefined. - - If Length > 0 and Destination is NULL, then ASSERT(). - If Length > 0 and Destination is not aligned on a 16-bit boundary, then = ASSERT(). - If Length > 0 and Source is NULL, then ASSERT(). - If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSER= T(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Length is greater than - PcdMaximumUnicodeStringLength, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the Null= -terminator, - then ASSERT(). - - @param Destination The pointer to a Null-terminated Unicode string. - @param Source The pointer to a Null-terminated Unicode string. - @param Length The maximum number of Unicode characters to copy. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrnCpy ( - OUT CHAR16 *Destination, - IN CONST CHAR16 *Source, - IN UINTN Length - ); -#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES) - /** Returns the length of a Null-terminated Unicode string. =20 @@ -1164,99 +1088,6 @@ StrnCmp ( ); =20 =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Concatenates one Null-terminated Unicode string to another Null-terminat= ed - Unicode string, and returns the concatenated Unicode string. - - This function concatenates two Null-terminated Unicode strings. The cont= ents - of Null-terminated Unicode string Source are concatenated to the end of - Null-terminated Unicode string Destination. The Null-terminated concaten= ated - Unicode String is returned. If Source and Destination overlap, then the - results are undefined. - - If Destination is NULL, then ASSERT(). - If Destination is not aligned on a 16-bit boundary, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source is not aligned on a 16-bit boundary, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Destination contains m= ore - than PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and concatenating Destinat= ion - and Source results in a Unicode string with more than - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - - @param Destination The pointer to a Null-terminated Unicode string. - @param Source The pointer to a Null-terminated Unicode string. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrCat ( - IN OUT CHAR16 *Destination, - IN CONST CHAR16 *Source - ); - - -/** - [ATTENTION] This function is deprecated for security reason. - - Concatenates up to a specified length one Null-terminated Unicode to the= end - of another Null-terminated Unicode string, and returns the concatenated - Unicode string. - - This function concatenates two Null-terminated Unicode strings. The cont= ents - of Null-terminated Unicode string Source are concatenated to the end of - Null-terminated Unicode string Destination, and Destination is returned.= At - most, Length Unicode characters are concatenated from Source to the end = of - Destination, and Destination is always Null-terminated. If Length is 0, = then - Destination is returned unmodified. If Source and Destination overlap, t= hen - the results are undefined. - - If Destination is NULL, then ASSERT(). - If Length > 0 and Destination is not aligned on a 16-bit boundary, then = ASSERT(). - If Length > 0 and Source is NULL, then ASSERT(). - If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSER= T(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Length is greater than - PcdMaximumUnicodeStringLength, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Destination contains m= ore - than PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength Unicode characters, not including the - Null-terminator, then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and concatenating Destinat= ion - and Source results in a Unicode string with more than PcdMaximumUnicodeS= tringLength - Unicode characters, not including the Null-terminator, then ASSERT(). - - @param Destination The pointer to a Null-terminated Unicode string. - @param Source The pointer to a Null-terminated Unicode string. - @param Length The maximum number of Unicode characters to concaten= ate from - Source. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -StrnCat ( - IN OUT CHAR16 *Destination, - IN CONST CHAR16 *Source, - IN UINTN Length - ); -#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES) - /** Returns the first occurrence of a Null-terminated Unicode sub-string in a Null-terminated Unicode string. @@ -1655,51 +1486,6 @@ StrHexToBytes ( IN UINTN MaxBufferSize ); =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Convert a Null-terminated Unicode string to a Null-terminated - ASCII string and returns the ASCII string. - - This function converts the content of the Unicode string Source - to the ASCII string Destination by copying the lower 8 bits of - each Unicode character. It returns Destination. - - The caller is responsible to make sure Destination points to a buffer wi= th size - equal or greater than ((StrLen (Source) + 1) * sizeof (CHAR8)) in bytes. - - If any Unicode characters in Source contain non-zero value in - the upper 8 bits, then ASSERT(). - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source is not aligned on a 16-bit boundary, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - - If PcdMaximumUnicodeStringLength is not zero, and Source contains - more than PcdMaximumUnicodeStringLength Unicode characters not including - the Null-terminator, then ASSERT(). - - If PcdMaximumAsciiStringLength is not zero, and Source contains more - than PcdMaximumAsciiStringLength Unicode characters not including the - Null-terminator, then ASSERT(). - - @param Source The pointer to a Null-terminated Unicode string. - @param Destination The pointer to a Null-terminated ASCII string. - - @return Destination. - -**/ -CHAR8 * -EFIAPI -UnicodeStrToAsciiStr ( - IN CONST CHAR16 *Source, - OUT CHAR8 *Destination - ); - -#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES) =20 /** Convert a Null-terminated Unicode string to a Null-terminated @@ -1802,76 +1588,6 @@ UnicodeStrnToAsciiStrS ( OUT UINTN *DestinationLength ); =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Copies one Null-terminated ASCII string to another Null-terminated ASCII - string and returns the new ASCII string. - - This function copies the contents of the ASCII string Source to the ASCII - string Destination, and returns Destination. If Source and Destination - overlap, then the results are undefined. - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and Source contains more than - PcdMaximumAsciiStringLength ASCII characters not including the Null-term= inator, - then ASSERT(). - - @param Destination The pointer to a Null-terminated ASCII string. - @param Source The pointer to a Null-terminated ASCII string. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrCpy ( - OUT CHAR8 *Destination, - IN CONST CHAR8 *Source - ); - - -/** - [ATTENTION] This function is deprecated for security reason. - - Copies up to a specified length one Null-terminated ASCII string to anot= her - Null-terminated ASCII string and returns the new ASCII string. - - This function copies the contents of the ASCII string Source to the ASCII - string Destination, and returns Destination. At most, Length ASCII chara= cters - are copied from Source to Destination. If Length is 0, then Destination = is - returned unmodified. If Length is greater that the number of ASCII chara= cters - in Source, then Destination is padded with Null ASCII characters. If Sou= rce - and Destination overlap, then the results are undefined. - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Length is greater than - PcdMaximumAsciiStringLength, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Source contains more than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - - @param Destination The pointer to a Null-terminated ASCII string. - @param Source The pointer to a Null-terminated ASCII string. - @param Length The maximum number of ASCII characters to copy. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrnCpy ( - OUT CHAR8 *Destination, - IN CONST CHAR8 *Source, - IN UINTN Length - ); -#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES) =20 /** Returns the length of a Null-terminated ASCII string. @@ -2031,92 +1747,6 @@ AsciiStrnCmp ( ); =20 =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Concatenates one Null-terminated ASCII string to another Null-terminated - ASCII string, and returns the concatenated ASCII string. - - This function concatenates two Null-terminated ASCII strings. The conten= ts of - Null-terminated ASCII string Source are concatenated to the end of Null- - terminated ASCII string Destination. The Null-terminated concatenated AS= CII - String is returned. - - If Destination is NULL, then ASSERT(). - If Source is NULL, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and Destination contains more= than - PcdMaximumAsciiStringLength ASCII characters not including the Null-term= inator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and Source contains more than - PcdMaximumAsciiStringLength ASCII characters not including the Null-term= inator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero and concatenating Destination= and - Source results in a ASCII string with more than PcdMaximumAsciiStringLen= gth - ASCII characters, then ASSERT(). - - @param Destination The pointer to a Null-terminated ASCII string. - @param Source The pointer to a Null-terminated ASCII string. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrCat ( - IN OUT CHAR8 *Destination, - IN CONST CHAR8 *Source - ); - - -/** - [ATTENTION] This function is deprecated for security reason. - - Concatenates up to a specified length one Null-terminated ASCII string to - the end of another Null-terminated ASCII string, and returns the - concatenated ASCII string. - - This function concatenates two Null-terminated ASCII strings. The conten= ts - of Null-terminated ASCII string Source are concatenated to the end of Nu= ll- - terminated ASCII string Destination, and Destination is returned. At mos= t, - Length ASCII characters are concatenated from Source to the end of - Destination, and Destination is always Null-terminated. If Length is 0, = then - Destination is returned unmodified. If Source and Destination overlap, t= hen - the results are undefined. - - If Length > 0 and Destination is NULL, then ASSERT(). - If Length > 0 and Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Length is greater than - PcdMaximumAsciiStringLength, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Destination contains mor= e than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Source contains more than - PcdMaximumAsciiStringLength ASCII characters, not including the Null-ter= minator, - then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and concatenating Destinatio= n and - Source results in a ASCII string with more than PcdMaximumAsciiStringLen= gth - ASCII characters, not including the Null-terminator, then ASSERT(). - - @param Destination The pointer to a Null-terminated ASCII string. - @param Source The pointer to a Null-terminated ASCII string. - @param Length The maximum number of ASCII characters to concatenat= e from - Source. - - @return Destination - -**/ -CHAR8 * -EFIAPI -AsciiStrnCat ( - IN OUT CHAR8 *Destination, - IN CONST CHAR8 *Source, - IN UINTN Length - ); -#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES) - /** Returns the first occurrence of a Null-terminated ASCII sub-string in a Null-terminated ASCII string. @@ -2496,45 +2126,6 @@ AsciiStrHexToBytes ( IN UINTN MaxBufferSize ); =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Convert one Null-terminated ASCII string to a Null-terminated - Unicode string and returns the Unicode string. - - This function converts the contents of the ASCII string Source to the Un= icode - string Destination, and returns Destination. The function terminates the - Unicode string Destination by appending a Null-terminator character at t= he end. - The caller is responsible to make sure Destination points to a buffer wi= th size - equal or greater than ((AsciiStrLen (Source) + 1) * sizeof (CHAR16)) in = bytes. - - If Destination is NULL, then ASSERT(). - If Destination is not aligned on a 16-bit boundary, then ASSERT(). - If Source is NULL, then ASSERT(). - If Source and Destination overlap, then ASSERT(). - If PcdMaximumAsciiStringLength is not zero, and Source contains more than - PcdMaximumAsciiStringLength ASCII characters not including the Null-term= inator, - then ASSERT(). - If PcdMaximumUnicodeStringLength is not zero, and Source contains more t= han - PcdMaximumUnicodeStringLength ASCII characters not including the - Null-terminator, then ASSERT(). - - @param Source The pointer to a Null-terminated ASCII string. - @param Destination The pointer to a Null-terminated Unicode string. - - @return Destination. - -**/ -CHAR16 * -EFIAPI -AsciiStrToUnicodeStr ( - IN CONST CHAR8 *Source, - OUT CHAR16 *Destination - ); - -#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES) =20 /** Convert one Null-terminated ASCII string to a Null-terminated diff --git a/MdePkg/Include/Library/PcdLib.h b/MdePkg/Include/Library/PcdLi= b.h index f09053e3cb86..71738857ad19 100644 --- a/MdePkg/Include/Library/PcdLib.h +++ b/MdePkg/Include/Library/PcdLib.h @@ -481,106 +481,6 @@ SPDX-License-Identifier: BSD-2-Clause-Patent **/ #define PcdGetExSize(Guid, TokenName) LibPcdGetExSize ((Guid), PcdTokenEx(= Guid,TokenName)) =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES -/** - Sets an 8-bit PCD token value based on a token name. - - Sets the 8-bit value for the token specified by TokenName. Value is retu= rned. - If TokenName is not a valid token in the token space, then the module wi= ll not build. - - @param TokenName The name of the PCD token to retrieve a current valu= e for. - @param Value The 8-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSet8(TokenName, Value) _PCD_SET_MODE_8_##TokenName = ((Value)) - - -/** - Sets a 16-bit PCD token value based on a token name. - - Sets the 16-bit value for the token specified by TokenName. Value is ret= urned. - If TokenName is not a valid token in the token space, then the module wi= ll not build. - - @param TokenName The name of the PCD token to retrieve a current valu= e for. - @param Value The 16-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSet16(TokenName, Value) _PCD_SET_MODE_16_##TokenName = ((Value)) - - -/** - Sets a 32-bit PCD token value based on a token name. - - Sets the 32-bit value for the token specified by TokenName. Value is ret= urned. - If TokenName is not a valid token in the token space, then the module wi= ll not build. - - @param TokenName The name of the PCD token to retrieve a current valu= e for. - @param Value The 32-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSet32(TokenName, Value) _PCD_SET_MODE_32_##TokenName = ((Value)) - - -/** - Sets a 64-bit PCD token value based on a token name. - - Sets the 64-bit value for the token specified by TokenName. Value is ret= urned. - If TokenName is not a valid token in the token space, then the module wi= ll not build. - - @param TokenName The name of the PCD token to retrieve a current valu= e for. - @param Value The 64-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSet64(TokenName, Value) _PCD_SET_MODE_64_##TokenName = ((Value)) - - -/** - Sets a pointer to a PCD token buffer based on a token name. - - Sets the buffer for the token specified by TokenName. Buffer is returned. - If SizeOfBuffer is greater than the maximum size supported by TokenName, - then set SizeOfBuffer to the maximum size supported by TokenName and ret= urn NULL - to indicate that the set operation was not actually performed. If SizeO= fBuffer - is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size= supported - by TokenName and NULL must be returned. - If TokenName is not a valid token in the token space, then the module wi= ll not build. - - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param TokenName The name of the PCD token to set the current val= ue for. - @param SizeOfBuffer A pointer to the size, in bytes, of Buffer. - @param Buffer A pointer to the buffer to set. - - @return Return the pointer to the Buffer that was set. - -**/ -#define PcdSetPtr(TokenName, SizeOfBuffer, Buffer) \ - _PCD_SET_MODE_PTR_##TokenName = ((SizeOfBuffer), (Buffer)) - -/** - Sets a Boolean PCD token value based on a token name. - - Sets the Boolean value for the token specified by TokenName. Value is re= turned. - If TokenName is not a valid token in the token space, then the module wi= ll not build. - - @param TokenName The name of the PCD token to set the current val= ue for. - @param Buffer The Boolean value to set. - - @return Return the Value that was set. - -**/ -#define PcdSetBool(TokenName, Value) _PCD_SET_MODE_BOOL_##TokenName= ((Value)) -#endif - /** Sets a 8-bit PCD token value based on a token name. =20 @@ -806,137 +706,6 @@ SPDX-License-Identifier: BSD-2-Clause-Patent =20 =20 =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES -/** - Sets an 8-bit PCD token value based on a GUID and a token name. - - Sets the 8-bit value for the token specified by Guid and TokenName. Valu= e is returned. - If TokenName is not a valid token in the token space specified by Guid, - then the module will not build. - - If Guid is NULL, then ASSERT(). - - @param Guid Pointer to a 128-bit unique value that designates - which namespace to retrieve a value from. - @param TokenName The name of the PCD token to set the current value = for. - @param Value The 8-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSetEx8(Guid, TokenName, Value) LibPcdSetEx8 ((Guid), PcdTok= enEx(Guid,TokenName), (Value)) - - -/** - Sets a 16-bit PCD token value based on a GUID and a token name. - - Sets the 16-bit value for the token specified by Guid and TokenName. Val= ue is returned. - If TokenName is not a valid token in the token space specified by Guid, - then the module will not build. - - If Guid is NULL, then ASSERT(). - - @param Guid Pointer to a 128-bit unique value that designates - which namespace to retrieve a value from. - @param TokenName The name of the PCD token to set the current value = for. - @param Value The 16-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSetEx16(Guid, TokenName, Value) LibPcdSetEx16 ((Guid), PcdTok= enEx(Guid,TokenName), (Value)) - - -/** - Sets a 32-bit PCD token value based on a GUID and a token name. - - Sets the 32-bit value for the token specified by Guid and TokenName. Val= ue is returned. - If TokenName is not a valid token in the token space specified by Guid, - then the module will not build. - - If Guid is NULL, then ASSERT(). - - @param Guid Pointer to a 128-bit unique value that designates - which namespace to retrieve a value from. - @param TokenName The name of the PCD token to set the current value = for. - @param Value The 32-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSetEx32(Guid, TokenName, Value) LibPcdSetEx32 ((Guid), PcdTok= enEx(Guid,TokenName), (Value)) - - -/** - Sets a 64-bit PCD token value based on a GUID and a token name. - - Sets the 64-bit value for the token specified by Guid and TokenName. Val= ue is returned. - If TokenName is not a valid token in the token space specified by Guid, - then the module will not build. - - If Guid is NULL, then ASSERT(). - - @param Guid Pointer to a 128-bit unique value that designates - which namespace to retrieve a value from. - @param TokenName The name of the PCD token to set the current value = for. - @param Value The 64-bit value to set. - - @return Return the Value that was set. - -**/ -#define PcdSetEx64(Guid, TokenName, Value) LibPcdSetEx64 ((Guid), PcdTok= enEx(Guid,TokenName), (Value)) - - -/** - Sets a pointer to a PCD token buffer based on a GUID and a token name. - - Sets the buffer for the token specified by Guid and TokenName. Buffer is= returned. - If SizeOfBuffer is greater than the maximum size supported by Guid and T= okenName, - then set SizeOfBuffer to the maximum size supported by Guid and TokenNam= e and return - NULL to indicate that the set operation was not actually performed. If S= izeOfBuffer - is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size= supported by - Guid and TokenName and NULL must be returned. - If TokenName is not a valid token in the token space specified by Guid, - then the module will not build. - - If Guid is NULL, then ASSERT(). - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param Guid Pointer to a 128-bit unique value that designates - which namespace to retrieve a value from. - @param TokenName The name of the PCD token to set the current val= ue for. - @param SizeOfBuffer A pointer to the size, in bytes, of Buffer. - @param Buffer Pointer to the buffer to set. - - @return Return the pointer to the Buffer that was set. - -**/ -#define PcdSetExPtr(Guid, TokenName, SizeOfBuffer, Buffer) \ - LibPcdSetExPtr ((Guid), PcdTok= enEx(Guid,TokenName), (SizeOfBuffer), (Buffer)) - - -/** - Sets a Boolean PCD token value based on a GUID and a token name. - - Sets the Boolean value for the token specified by Guid and TokenName. Va= lue is returned. - If TokenName is not a valid token in the token space specified by Guid, - then the module will not build. - - If Guid is NULL, then ASSERT(). - - @param Guid Pointer to a 128-bit unique value that designates - which namespace to retrieve a value from. - @param TokenName The name of the PCD token to set the current val= ue for. - @param Value The Boolean value to set. - - @return Return the Value that was set. - -**/ -#define PcdSetExBool(Guid, TokenName, Value) \ - LibPcdSetExBool((Guid), PcdTok= enEx(Guid,TokenName), (Value)) -#endif - /** Sets an 8-bit PCD token value based on a GUID and a token name. =20 @@ -1348,295 +1117,6 @@ LibPcdGetExSize ( ); =20 =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the Value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSet8 ( - IN UINTN TokenNumber, - IN UINT8 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the Value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSet16 ( - IN UINTN TokenNumber, - IN UINT16 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the Value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSet32 ( - IN UINTN TokenNumber, - IN UINT32 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the Value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSet64 ( - IN UINTN TokenNumber, - IN UINT64 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value - specified by Buffer and SizeOfBuffer. Buffer is returned. - If SizeOfBuffer is greater than the maximum size support by TokenNumber, - then set SizeOfBuffer to the maximum size supported by TokenNumber and - return NULL to indicate that the set operation was not actually performe= d. - - If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to = the - maximum size supported by TokenName and NULL must be returned. - - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pointer for the Buffer that was set. - -**/ -VOID * -EFIAPI -LibPcdSetPtr ( - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN CONST VOID *Buffer - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber - to the value specified by Value. Value is returned. - - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The boolean value to set. - - @return Return the Value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetBool ( - IN UINTN TokenNumber, - IN BOOLEAN Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 8-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid Pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 8-bit value to set. - - @return Return the Value that was set. - -**/ -UINT8 -EFIAPI -LibPcdSetEx8 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT8 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 16-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid Pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 16-bit value to set. - - @return Return the Value that was set. - -**/ -UINT16 -EFIAPI -LibPcdSetEx16 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT16 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 32-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid Pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 32-bit value to set. - - @return Return the Value that was set. - -**/ -UINT32 -EFIAPI -LibPcdSetEx32 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT32 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the 64-bit value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid Pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The 64-bit value to set. - - @return Return the Value that was set. - -**/ -UINT64 -EFIAPI -LibPcdSetEx64 ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN UINT64 Value - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets a buffer for the token specified by TokenNumber to the value specif= ied by - Buffer and SizeOfBuffer. Buffer is returned. If SizeOfBuffer is greate= r than - the maximum size support by TokenNumber, then set SizeOfBuffer to the ma= ximum size - supported by TokenNumber and return NULL to indicate that the set operat= ion - was not actually performed. - - If Guid is NULL, then ASSERT(). - If SizeOfBuffer is NULL, then ASSERT(). - If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT(). - - @param[in] Guid Pointer to a 128-bit unique value that - designates which namespace to set a value = from. - @param[in] TokenNumber The PCD token number to set a current valu= e for. - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer. - @param[in] Buffer A pointer to the buffer to set. - - @return Return the pointer to the Buffer that was set. - -**/ -VOID * -EFIAPI -LibPcdSetExPtr ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN OUT UINTN *SizeOfBuffer, - IN VOID *Buffer - ); - - -/** - This function provides a means by which to set a value for a given PCD t= oken. - - Sets the Boolean value for the token specified by TokenNumber and - Guid to the value specified by Value. Value is returned. - - If Guid is NULL, then ASSERT(). - - @param[in] Guid Pointer to a 128-bit unique value that - designates which namespace to set a value from. - @param[in] TokenNumber The PCD token number to set a current value fo= r. - @param[in] Value The Boolean value to set. - - @return Return the Value that was set. - -**/ -BOOLEAN -EFIAPI -LibPcdSetExBool ( - IN CONST GUID *Guid, - IN UINTN TokenNumber, - IN BOOLEAN Value - ); -#endif - /** This function provides a means by which to set a value for a given PCD t= oken. =20 diff --git a/MdePkg/Include/Library/PrintLib.h b/MdePkg/Include/Library/Pri= ntLib.h index dfbcd1b340be..0b38da6084e1 100644 --- a/MdePkg/Include/Library/PrintLib.h +++ b/MdePkg/Include/Library/PrintLib.h @@ -485,62 +485,6 @@ UnicodeSPrintAsciiFormat ( ... ); =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Converts a decimal value to a Null-terminated Unicode string. - - Converts the decimal number specified by Value to a Null-terminated Unic= ode - string specified by Buffer containing at most Width characters. No paddi= ng of spaces - is ever performed. If Width is 0 then a width of MAXIMUM_VALUE_CHARACTER= S is assumed. - The number of Unicode characters in Buffer is returned, not including th= e Null-terminator. - If the conversion contains more than Width characters, then only the fir= st - Width characters are returned, and the total number of characters - required to perform the conversion is returned. - Additional conversion parameters are specified in Flags. - - The Flags bit LEFT_JUSTIFY is always ignored. - All conversions are left justified in Buffer. - If Width is 0, PREFIX_ZERO is ignored in Flags. - If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and= commas - are inserted every 3rd digit starting from the right. - If RADIX_HEX is set in Flags, then the output buffer will be - formatted in hexadecimal format. - If Value is < 0 and RADIX_HEX is not set in Flags, then the fist charact= er in Buffer is a '-'. - If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, - then Buffer is padded with '0' characters so the combination of the opti= onal '-' - sign character, '0' characters, digit characters for Value, and the Null= -terminator - add up to Width characters. - If both COMMA_TYPE and RADIX_HEX are set in Flags, then ASSERT(). - If Buffer is NULL, then ASSERT(). - If Buffer is not aligned on a 16-bit boundary, then ASSERT(). - If unsupported bits are set in Flags, then ASSERT(). - If both COMMA_TYPE and RADIX_HEX are set in Flags, then ASSERT(). - If Width >=3D MAXIMUM_VALUE_CHARACTERS, then ASSERT() - - @param Buffer The pointer to the output buffer for the produced Null-t= erminated - Unicode string. - @param Flags The bitmask of flags that specify left justification, ze= ro pad, and commas. - @param Value The 64-bit signed value to convert to a string. - @param Width The maximum number of Unicode characters to place in Buf= fer, not including - the Null-terminator. - - @return The number of Unicode characters in Buffer, not including the Nu= ll-terminator. - -**/ -UINTN -EFIAPI -UnicodeValueToString ( - IN OUT CHAR16 *Buffer, - IN UINTN Flags, - IN INT64 Value, - IN UINTN Width - ); - -#endif - /** Converts a decimal value to a Null-terminated Unicode string. =20 @@ -882,60 +826,6 @@ AsciiSPrintUnicodeFormat ( ... ); =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function is deprecated for security reason. - - Converts a decimal value to a Null-terminated ASCII string. - - Converts the decimal number specified by Value to a Null-terminated ASCI= I string - specified by Buffer containing at most Width characters. No padding of s= paces - is ever performed. - If Width is 0 then a width of MAXIMUM_VALUE_CHARACTERS is assumed. - The number of ASCII characters in Buffer is returned, not including the = Null-terminator. - If the conversion contains more than Width characters, then only the fir= st Width - characters are returned, and the total number of characters required to = perform - the conversion is returned. - Additional conversion parameters are specified in Flags. - The Flags bit LEFT_JUSTIFY is always ignored. - All conversions are left justified in Buffer. - If Width is 0, PREFIX_ZERO is ignored in Flags. - If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and= commas - are inserted every 3rd digit starting from the right. - If RADIX_HEX is set in Flags, then the output buffer will be - formatted in hexadecimal format. - If Value is < 0 and RADIX_HEX is not set in Flags, then the fist charact= er in Buffer is a '-'. - If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, - then Buffer is padded with '0' characters so the combination of the opti= onal '-' - sign character, '0' characters, digit characters for Value, and the Null= -terminator - add up to Width characters. - - If Buffer is NULL, then ASSERT(). - If unsupported bits are set in Flags, then ASSERT(). - If both COMMA_TYPE and RADIX_HEX are set in Flags, then ASSERT(). - If Width >=3D MAXIMUM_VALUE_CHARACTERS, then ASSERT() - - @param Buffer A pointer to the output buffer for the produced Null-ter= minated - ASCII string. - @param Flags The bitmask of flags that specify left justification, ze= ro pad, and commas. - @param Value The 64-bit signed value to convert to a string. - @param Width The maximum number of ASCII characters to place in Buffe= r, not including - the Null-terminator. - - @return The number of ASCII characters in Buffer, not including the Null= -terminator. - -**/ -UINTN -EFIAPI -AsciiValueToString ( - OUT CHAR8 *Buffer, - IN UINTN Flags, - IN INT64 Value, - IN UINTN Width - ); - -#endif =20 /** Converts a decimal value to a Null-terminated Ascii string. diff --git a/MdePkg/Include/Library/UefiLib.h b/MdePkg/Include/Library/Uefi= Lib.h index 0abb40d6ecbd..f56ffde1230e 100644 --- a/MdePkg/Include/Library/UefiLib.h +++ b/MdePkg/Include/Library/UefiLib.h @@ -680,59 +680,6 @@ FreeUnicodeStringTable ( IN EFI_UNICODE_STRING_TABLE *UnicodeStringTable ); =20 -#ifndef DISABLE_NEW_DEPRECATED_INTERFACES - -/** - [ATTENTION] This function will be deprecated for security reason. - - Returns a pointer to an allocated buffer that contains the contents of a - variable retrieved through the UEFI Runtime Service GetVariable(). The - returned buffer is allocated using AllocatePool(). The caller is respon= sible - for freeing this buffer with FreePool(). - - If Name is NULL, then ASSERT(). - If Guid is NULL, then ASSERT(). - - @param[in] Name The pointer to a Null-terminated Unicode string. - @param[in] Guid The pointer to an EFI_GUID structure. - - @retval NULL The variable could not be retrieved. - @retval NULL There are not enough resources available for the variable= contents. - @retval Other A pointer to allocated buffer containing the variable con= tents. - -**/ -VOID * -EFIAPI -GetVariable ( - IN CONST CHAR16 *Name, - IN CONST EFI_GUID *Guid - ); - -/** - [ATTENTION] This function will be deprecated for security reason. - - Returns a pointer to an allocated buffer that contains the contents of a - variable retrieved through the UEFI Runtime Service GetVariable(). This - function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables. - The returned buffer is allocated using AllocatePool(). The caller is - responsible for freeing this buffer with FreePool(). - - If Name is NULL, then ASSERT(). - - @param[in] Name The pointer to a Null-terminated Unicode string. - - @retval NULL The variable could not be retrieved. - @retval NULL There are not enough resources available for the variable= contents. - @retval Other A pointer to allocated buffer containing the variable con= tents. - -**/ -VOID * -EFIAPI -GetEfiGlobalVariable ( - IN CONST CHAR16 *Name - ); -#endif - =20 /** Returns the status whether get the variable success. The function retrie= ves diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc index 6cd38e7ec3c9..0477e0205188 100644 --- a/MdePkg/MdePkg.dsc +++ b/MdePkg/MdePkg.dsc @@ -172,4 +172,3 @@ [Components.ARM, Components.AARCH64] MdePkg/Library/BaseStackCheckLib/BaseStackCheckLib.inf =20 [BuildOptions] - *_*_*_CC_FLAGS =3D -D DISABLE_NEW_DEPRECATED_INTERFACES --=20 2.18.0.windows.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#60749): https://edk2.groups.io/g/devel/message/60749 Mute This Topic: https://groups.io/mt/74688627/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-