From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61803+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593444040525419.83065941912344; Mon, 29 Jun 2020 08:20:40 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id uKjvYY1788612xwm7vSbiPck; Mon, 29 Jun 2020 08:20:40 -0700 X-Received: from EUR02-AM5-obe.outbound.protection.outlook.com (EUR02-AM5-obe.outbound.protection.outlook.com [40.107.0.45]) by mx.groups.io with SMTP id smtpd.web12.21079.1593444038389694857 for ; Mon, 29 Jun 2020 08:20:39 -0700 X-Received: from MR2P264CA0090.FRAP264.PROD.OUTLOOK.COM (2603:10a6:500:32::30) by AM7PR08MB5368.eurprd08.prod.outlook.com (2603:10a6:20b:103::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20; Mon, 29 Jun 2020 15:20:35 +0000 X-Received: from VE1EUR03FT051.eop-EUR03.prod.protection.outlook.com (2603:10a6:500:32:cafe::a1) by MR2P264CA0090.outlook.office365.com (2603:10a6:500:32::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:35 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61803+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT051.mail.protection.outlook.com (10.152.19.75) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:35 +0000 X-Received: ("Tessian outbound fcb8da16d5bd:v60"); Mon, 29 Jun 2020 15:20:35 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 3c7c975aa2496884 X-CR-MTA-TID: 64aa7808 X-Received: from d4b4209bcf22.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 968BDF22-A94C-4ED5-A542-26F16199ECBF.1; Mon, 29 Jun 2020 15:20:35 +0000 X-Received: from EUR02-HE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id d4b4209bcf22.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:35 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=PytCXT2u/gzB+yGqqp2hUc0ctvlEB7aU8z8N/dhoUVHDcQJBPV/jo8w2QWlsz+AhhWd7fY1LebL8ujI5o9lseWVglvkYoOh6h8clgiWE8qqp87YR7n4LJ+EDrQUEvtyzMPwwbbhPVdywReS7wJ/IpGrJIKLDShjPqotERKjW/rkChPIneyRjkDQv8AYc/1OxqVJwPLvKdHuj/Ls6rRhhcNDKgFQKu4vllznRNmTuNZRQy6qsRm38wsWki5lcgV4AN2fzDOkJeDvZ6j3q5p9m1/JVIMvGU14ZzV2axCAKpKGJgTs1UorrujMSJjvxfeY2A2tsjt5rHa0nPJ+noe0Pig== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=i6JwS4B0a3iR+UkURtCB80ran0jw8VeA89cBT7giyQ8=; b=GJGGb8+oh429ajsW8A+MaEGunzVLIKivoFepzZ2Ga4waoLVhFL+UjqryEX5LpQB5ohbsQCliiGcYsAnZepKKcN25tHyqY9o3tKLZOzQTobwgkcHX57L0NfpCpB6FRG4BcpzXXdnZz2J2FFBeIDrjzEkaxJUuhNvnx7XnWpB3X5it05DmyCrNX8PkelAuMpCJtxQKOGexVxm5DZtUIZMJ+Wz2Igtbe62f5qBTZFmPbNZvnxq6eMARACsOG14ZZSIErW21VxVEdrXj0+hILCJbjYO/udYSUvyGNDaXWrNMqfFLh6xXXv8az7MrmQ4Kx19m6Mu/vGCh32nfoMvReg3b3Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from DB6PR0501CA0034.eurprd05.prod.outlook.com (2603:10a6:4:67::20) by VI1PR08MB3328.eurprd08.prod.outlook.com (2603:10a6:803:3f::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from DB5EUR03FT005.eop-EUR03.prod.protection.outlook.com (2603:10a6:4:67:cafe::aa) by DB6PR0501CA0034.outlook.office365.com (2603:10a6:4:67::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:27 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by DB5EUR03FT005.mail.protection.outlook.com (10.152.20.122) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX04.Arm.com (10.251.24.32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:26 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:26 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 1/8] ShellPkg/AcpiView: Extract configuration struct Date: Mon, 29 Jun 2020 16:20:01 +0100 Message-ID: <20200629152008.685-2-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(376002)(136003)(396003)(346002)(39860400002)(46966005)(6916009)(86362001)(4326008)(83380400001)(6666004)(426003)(478600001)(5660300002)(336012)(2616005)(316002)(8936002)(82310400002)(356005)(30864003)(70206006)(26005)(1076003)(47076004)(8676002)(2906002)(82740400003)(70586007)(186003)(54906003)(81166007)(36756003);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 8b449977-8b3d-42fd-2ae7-08d81c3ff8d4 X-MS-TrafficTypeDiagnostic: VI1PR08MB3328:|AM7PR08MB5368: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:1824;OLM:1824; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: RUTxJN9z9Ul7xydM140UPi7m4Yb6yOATjVHAQpBKqS1LK8fUbSM+ch6lsik/1kbvfkVrcoBXmCFvy4HLKlY4Lzx4d6x29l/dSHP1/10IiB5ApvxdmylPsT56138SJvcVEj+5y8wgSfTZnM+kkJvII5hZmI/QJUBZeApb4R2hVpAsVS04MXG+TtnmxjvP8BMg6TJIoqShSlH80z8ui05LPtFP7dTYOV/n+eyTMdD9VvR7spcsnK0xY8tSay9vgcrpITtt8Hx7utVEPmZLGdRWPRNDymlsbmFH9QkpVs+FsUz/9p1bcwv7ZHCwocJX5lUR9CLwLDq6hwGUH9lsHu50LlnhRHXtNgMFiObNb+phejw3H14FGcDfFNinwqIafBjd6AT2HRoJzoClCDPGkkLvdA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB3328 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT051.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: c504a687-cee6-467e-0085-08d81c3ff3f6 X-Microsoft-Antispam-Message-Info: PkaS9xZDuCihDQanjiZT+ONspL9HQJtQGVYvmTiSyMOqeOo1cgF3vQp/TpkKmhPNQ+7QPrPocXe9giu6QMdDfy8mIMldTvu09uo7UH6hJdGmF/0kO6zU0VSRXrILJb502YikEtMD7+Ut/ztY3qDiSOjx6ABj7W0V5XZyfHQLcyP29z5q2NwKG9p+wowiNWH9hvgamO+vMUm3UFa4+sIKhaq79shGikuf480nFCbUyb8MrjR07J6Om6KE7HPXTmGGr+kbLS7SyR+mMdVTrc286s+b6WODxtqmTZTjflxH2wmxIyigqFCOVexFglEtROE+OBujLlR1ODPYj5nWNVlyrW1QpgYKD73SRj1j6s3xwUsFhVyY0XOinWlnhE/Yl9FljecevDsFCrhMdX52mv07WQ== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:35.4637 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8b449977-8b3d-42fd-2ae7-08d81c3ff8d4 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT051.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM7PR08MB5368 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,Tomas.Pilar@arm.com X-Gm-Message-State: ke9NmnpxKNpKgqUzpp3vr5Iax1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444040; bh=TPbZP1simlMzjv9AF/t3VZ1raMju+MMNEMXPE3+U32g=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=T45Pdyb7r9RhgsFxq2S4C5M9AfGFUMhEaVMg/rtpYMYpP3csQgG+Ox4oKhCRndGLLp0 9qLwtjWDR7mwRM6ZT/DnVeQlWDRAo/yZRO/I7MpdrLKFC/eTgcFfvT3z/7ndZzsV8oE0/ j5zHd8grCkNvSbDtRWHSFG1f+1bE+NuInSU= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Remove accessor method bloat by creating a configuration struct that is linked using an extern symbol in the config header file. Directly reference the config struct for all read and write accesses in the entire module. Rationalise the remaining methods in the config header and source. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 18 +- .../AcpiTableParser.c | 4 +- .../UefiShellAcpiViewCommandLib/AcpiView.c | 67 +++---- .../AcpiViewConfig.c | 180 ++---------------- .../AcpiViewConfig.h | 138 ++------------ .../UefiShellAcpiViewCommandLib.c | 18 +- 6 files changed, 71 insertions(+), 354 deletions(-) diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index 02f6d771c7e1..3a029b01cc20 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -137,7 +137,7 @@ VerifyChecksum ( if (Log) { OriginalAttribute =3D gST->ConOut->Mode->Attribute; if (Checksum =3D=3D 0) { - if (GetColourHighlighting ()) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute ( gST->ConOut, EFI_TEXT_ATTR (EFI_GREEN, @@ -147,7 +147,7 @@ VerifyChecksum ( Print (L"Table Checksum : OK\n\n"); } else { IncrementErrorCount (); - if (GetColourHighlighting ()) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute ( gST->ConOut, EFI_TEXT_ATTR (EFI_RED, @@ -156,7 +156,7 @@ VerifyChecksum ( } Print (L"Table Checksum : FAILED (0x%X)\n\n", Checksum); } - if (GetColourHighlighting ()) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); } } @@ -507,7 +507,6 @@ ParseAcpi ( { UINT32 Index; UINT32 Offset; - BOOLEAN HighLight; UINTN OriginalAttribute; =20 // @@ -520,9 +519,8 @@ ParseAcpi ( gIndent +=3D Indent; =20 if (Trace && (AsciiName !=3D NULL)){ - HighLight =3D GetColourHighlighting (); =20 - if (HighLight) { + if (mConfig.ColourHighlighting) { OriginalAttribute =3D gST->ConOut->Mode->Attribute; gST->ConOut->SetAttribute ( gST->ConOut, @@ -537,7 +535,7 @@ ParseAcpi ( (OUTPUT_FIELD_COLUMN_WIDTH - gIndent), AsciiName ); - if (HighLight) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); } } @@ -555,8 +553,7 @@ ParseAcpi ( continue; } =20 - if (GetConsistencyChecking () && - (Offset !=3D Parser[Index].Offset)) { + if (mConfig.ConsistencyCheck && (Offset !=3D Parser[Index].Offset)) { IncrementErrorCount (); Print ( L"\nERROR: %a: Offset Mismatch for %s\n" @@ -599,8 +596,7 @@ ParseAcpi ( =20 // Validating only makes sense if we are tracing // the parsed table entries, to report by table name. - if (GetConsistencyChecking () && - (Parser[Index].FieldValidator !=3D NULL)) { + if (mConfig.ConsistencyCheck && (Parser[Index].FieldValidator !=3D= NULL)) { Parser[Index].FieldValidator (Ptr, Parser[Index].Context); } } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c= b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c index 4b618f131eac..526cb8cb7cad 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c @@ -222,13 +222,13 @@ ProcessAcpiTable ( return; } =20 - if (GetConsistencyChecking ()) { + if (mConfig.ConsistencyCheck) { VerifyChecksum (TRUE, Ptr, *AcpiTableLength); } } =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (GetMandatoryTableValidate ()) { + if (mConfig.MandatoryTableValidate) { ArmSbbrIncrementTableCount (*AcpiTableSignature); } #endif diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c b/Shel= lPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c index 9a5b013fb234..d2c14d5b8f5a 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c @@ -48,15 +48,14 @@ DumpAcpiTableToFile ( { CHAR16 FileNameBuffer[MAX_FILE_NAME_LEN]; UINTN TransferBytes; - SELECTED_ACPI_TABLE *SelectedTable; =20 - GetSelectedAcpiTable (&SelectedTable); + TransferBytes =3D Length; =20 UnicodeSPrint ( FileNameBuffer, sizeof (FileNameBuffer), L".\\%s%04d.bin", - SelectedTable->Name, + mSelectedAcpiTable.Name, mBinTableCount++ ); =20 @@ -82,11 +81,9 @@ ProcessTableReportOptions ( IN CONST UINT32 Length ) { - UINTN OriginalAttribute; - UINT8 *SignaturePtr; - BOOLEAN Log; - BOOLEAN HighLight; - SELECTED_ACPI_TABLE *SelectedTable; + UINTN OriginalAttribute; + UINT8 *SignaturePtr; + BOOLEAN Log; =20 // // set local variables to suppress incorrect compiler/analyzer warnings @@ -94,22 +91,20 @@ ProcessTableReportOptions ( OriginalAttribute =3D 0; SignaturePtr =3D (UINT8*)(UINTN)&Signature; Log =3D FALSE; - HighLight =3D GetColourHighlighting (); - GetSelectedAcpiTable (&SelectedTable); =20 - switch (GetReportOption ()) { + switch (mConfig.ReportType) { case ReportAll: Log =3D TRUE; break; case ReportSelected: - if (Signature =3D=3D SelectedTable->Type) { + if (Signature =3D=3D mSelectedAcpiTable.Type) { Log =3D TRUE; - SelectedTable->Found =3D TRUE; + mSelectedAcpiTable.Found =3D TRUE; } break; case ReportTableList: if (mTableCount =3D=3D 0) { - if (HighLight) { + if (mConfig.ColourHighlighting) { OriginalAttribute =3D gST->ConOut->Mode->Attribute; gST->ConOut->SetAttribute ( gST->ConOut, @@ -118,7 +113,7 @@ ProcessTableReportOptions ( ); } Print (L"\nInstalled Table(s):\n"); - if (HighLight) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); } } @@ -132,8 +127,8 @@ ProcessTableReportOptions ( ); break; case ReportDumpBinFile: - if (Signature =3D=3D SelectedTable->Type) { - SelectedTable->Found =3D TRUE; + if (Signature =3D=3D mSelectedAcpiTable.Type) { + mSelectedAcpiTable.Found =3D TRUE; DumpAcpiTableToFile (TablePtr, Length); } break; @@ -144,7 +139,7 @@ ProcessTableReportOptions ( } // switch =20 if (Log) { - if (HighLight) { + if (mConfig.ColourHighlighting) { OriginalAttribute =3D gST->ConOut->Mode->Attribute; gST->ConOut->SetAttribute ( gST->ConOut, @@ -159,7 +154,7 @@ ProcessTableReportOptions ( SignaturePtr[2], SignaturePtr[3] ); - if (HighLight) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); } } @@ -191,18 +186,12 @@ AcpiView ( BOOLEAN FoundAcpiTable; UINTN OriginalAttribute; UINTN PrintAttribute; - EREPORT_OPTION ReportOption; UINT8* RsdpPtr; UINT32 RsdpLength; UINT8 RsdpRevision; PARSE_ACPI_TABLE_PROC RsdpParserProc; BOOLEAN Trace; - SELECTED_ACPI_TABLE *SelectedTable; =20 - // - // set local variables to suppress incorrect compiler/analyzer warnings - // - EfiConfigurationTable =3D NULL; OriginalAttribute =3D 0; =20 // Reset Table counts @@ -213,9 +202,6 @@ AcpiView ( ResetErrorCount (); ResetWarningCount (); =20 - // Retrieve the user selection of ACPI table to process - GetSelectedAcpiTable (&SelectedTable); - // Search the table for an entry that matches the ACPI Table Guid FoundAcpiTable =3D FALSE; for (Index =3D 0; Index < SystemTable->NumberOfTableEntries; Index++) { @@ -241,7 +227,7 @@ AcpiView ( } =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (GetMandatoryTableValidate ()) { + if (mConfig.MandatoryTableValidate) { ArmSbbrResetTableCounts (); } #endif @@ -275,24 +261,23 @@ AcpiView ( } =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (GetMandatoryTableValidate ()) { - ArmSbbrReqsValidate ((ARM_SBBR_VERSION)GetMandatoryTableSpec ()); + if (mConfig.MandatoryTableValidate) { + ArmSbbrReqsValidate ((ARM_SBBR_VERSION) mConfig.MandatoryTableSpec); } #endif =20 - ReportOption =3D GetReportOption (); - if (ReportTableList !=3D ReportOption) { - if (((ReportSelected =3D=3D ReportOption) || - (ReportDumpBinFile =3D=3D ReportOption)) && - (!SelectedTable->Found)) { + if (ReportTableList !=3D mConfig.ReportType) { + if (((ReportSelected =3D=3D mConfig.ReportType) || + (ReportDumpBinFile =3D=3D mConfig.ReportType)) && + (!mSelectedAcpiTable.Found)) { Print (L"\nRequested ACPI Table not found.\n"); - } else if (GetConsistencyChecking () && - (ReportDumpBinFile !=3D ReportOption)) { + } else if (mConfig.ConsistencyCheck && + (ReportDumpBinFile !=3D mConfig.ReportType)) { OriginalAttribute =3D gST->ConOut->Mode->Attribute; =20 Print (L"\nTable Statistics:\n"); =20 - if (GetColourHighlighting ()) { + if (mConfig.ColourHighlighting) { PrintAttribute =3D (GetErrorCount () > 0) ? EFI_TEXT_ATTR ( EFI_RED, @@ -303,7 +288,7 @@ AcpiView ( } Print (L"\t%d Error(s)\n", GetErrorCount ()); =20 - if (GetColourHighlighting ()) { + if (mConfig.ColourHighlighting) { PrintAttribute =3D (GetWarningCount () > 0) ? EFI_TEXT_ATTR ( EFI_RED, @@ -315,7 +300,7 @@ AcpiView ( } Print (L"\t%d Warning(s)\n", GetWarningCount ()); =20 - if (GetColourHighlighting ()) { + if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); } } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.c = b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.c index 759a915928c7..a0a392085355 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.c @@ -10,12 +10,8 @@ =20 #include "AcpiViewConfig.h" =20 -// Report variables -STATIC BOOLEAN mConsistencyCheck; -STATIC BOOLEAN mColourHighlighting; -STATIC EREPORT_OPTION mReportType; -STATIC BOOLEAN mMandatoryTableValidate; -STATIC UINTN mMandatoryTableSpec; +// Main configuration structure +ACPI_VIEW_CONFIG mConfig; =20 // User selection of which ACPI table should be checked SELECTED_ACPI_TABLE mSelectedAcpiTable; @@ -25,17 +21,21 @@ SELECTED_ACPI_TABLE mSelectedAcpiTable; **/ VOID EFIAPI -AcpiConfigSetDefaults ( +AcpiViewConfigSetDefaults ( VOID ) { - mReportType =3D ReportAll; + // Generic defaults + mConfig.ReportType =3D ReportAll; + mConfig.ConsistencyCheck =3D TRUE; + mConfig.MandatoryTableValidate =3D FALSE; + mConfig.MandatoryTableSpec =3D 0; + mConfig.ColourHighlighting =3D FALSE; + + // Unselect acpi table mSelectedAcpiTable.Type =3D 0; mSelectedAcpiTable.Name =3D NULL; mSelectedAcpiTable.Found =3D FALSE; - mConsistencyCheck =3D TRUE; - mMandatoryTableValidate =3D FALSE; - mMandatoryTableSpec =3D 0; } =20 /** @@ -79,7 +79,7 @@ ConvertStrToAcpiSignature ( **/ VOID EFIAPI -SelectAcpiTable ( +AcpiViewConfigSelectTable ( IN CONST CHAR16 *TableName ) { @@ -88,159 +88,3 @@ SelectAcpiTable ( mSelectedAcpiTable.Name =3D TableName; mSelectedAcpiTable.Type =3D ConvertStrToAcpiSignature (mSelectedAcpiTabl= e.Name); } - -/** - This function returns the selected ACPI table. - - @param [out] SelectedAcpiTable Pointer that will contain the returned st= ruct. -**/ -VOID -EFIAPI -GetSelectedAcpiTable ( - OUT SELECTED_ACPI_TABLE **SelectedAcpiTable - ) -{ - *SelectedAcpiTable =3D &mSelectedAcpiTable; -} - -/** - This function returns the colour highlighting status. - - @retval TRUE Colour highlighting is enabled. -**/ -BOOLEAN -EFIAPI -GetColourHighlighting ( - VOID - ) -{ - return mColourHighlighting; -} - -/** - This function sets the colour highlighting status. - - @param [in] Highlight The highlight status. -**/ -VOID -EFIAPI -SetColourHighlighting ( - BOOLEAN Highlight - ) -{ - mColourHighlighting =3D Highlight; -} - -/** - This function returns the consistency checking status. - - @retval TRUE Consistency checking is enabled. -**/ -BOOLEAN -EFIAPI -GetConsistencyChecking ( - VOID - ) -{ - return mConsistencyCheck; -} - -/** - This function sets the consistency checking status. - - @param [in] ConsistencyChecking The consistency checking status. -**/ -VOID -EFIAPI -SetConsistencyChecking ( - BOOLEAN ConsistencyChecking - ) -{ - mConsistencyCheck =3D ConsistencyChecking; -} - -/** - This function returns the report options. - - @return The current report option. -**/ -EREPORT_OPTION -EFIAPI -GetReportOption ( - VOID - ) -{ - return mReportType; -} - -/** - This function sets the report options. - - @param [in] ReportType The report option to set. -**/ -VOID -EFIAPI -SetReportOption ( - EREPORT_OPTION ReportType - ) -{ - mReportType =3D ReportType; -} - -/** - This function returns the ACPI table requirements validation flag. - - @retval TRUE Check for mandatory table presence should be performed. -**/ -BOOLEAN -EFIAPI -GetMandatoryTableValidate ( - VOID - ) -{ - return mMandatoryTableValidate; -} - -/** - This function sets the ACPI table requirements validation flag. - - @param [in] Validate Enable/Disable ACPI table requirements validation. -**/ -VOID -EFIAPI -SetMandatoryTableValidate ( - BOOLEAN Validate - ) -{ - mMandatoryTableValidate =3D Validate; -} - -/** - This function returns the identifier of specification to validate ACPI t= able - requirements against. - - @return ID of specification listing mandatory tables. -**/ -UINTN -EFIAPI -GetMandatoryTableSpec ( - VOID - ) -{ - return mMandatoryTableSpec; -} - -/** - This function sets the identifier of specification to validate ACPI table - requirements against. - - @param [in] Spec ID of specification listing mandatory tables. -**/ -VOID -EFIAPI -SetMandatoryTableSpec ( - UINTN Spec - ) -{ - mMandatoryTableSpec =3D Spec; -} diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.h = b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.h index 2db4a65415d8..1883145d04a4 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewConfig.h @@ -8,96 +8,6 @@ #ifndef ACPI_VIEW_CONFIG_H_ #define ACPI_VIEW_CONFIG_H_ =20 -/** - This function returns the colour highlighting status. - - @retval TRUE Colour highlighting is enabled. -**/ -BOOLEAN -EFIAPI -GetColourHighlighting ( - VOID - ); - -/** - This function sets the colour highlighting status. - - @param [in] Highlight The highlight status. -**/ -VOID -EFIAPI -SetColourHighlighting ( - BOOLEAN Highlight - ); - -/** - This function returns the consistency checking status. - - @retval TRUE Consistency checking is enabled. -**/ -BOOLEAN -EFIAPI -GetConsistencyChecking ( - VOID - ); - -/** - This function sets the consistency checking status. - - @param [in] ConsistencyChecking The consistency checking status. -**/ -VOID -EFIAPI -SetConsistencyChecking ( - BOOLEAN ConsistencyChecking - ); - -/** - This function returns the ACPI table requirements validation flag. - - @retval TRUE Check for mandatory table presence should be performed. -**/ -BOOLEAN -EFIAPI -GetMandatoryTableValidate ( - VOID - ); - -/** - This function sets the ACPI table requirements validation flag. - - @param [in] Validate Enable/Disable ACPI table requirements validation. -**/ -VOID -EFIAPI -SetMandatoryTableValidate ( - BOOLEAN Validate - ); - -/** - This function returns the identifier of specification to validate ACPI t= able - requirements against. - - @return ID of specification listing mandatory tables. -**/ -UINTN -EFIAPI -GetMandatoryTableSpec ( - VOID - ); - -/** - This function sets the identifier of specification to validate ACPI table - requirements against. - - @param [in] Spec ID of specification listing mandatory tables. -**/ -VOID -EFIAPI -SetMandatoryTableSpec ( - UINTN Spec - ); - /** The EREPORT_OPTION enum describes ACPI table Reporting options. **/ @@ -109,28 +19,6 @@ typedef enum { ReportMax, } EREPORT_OPTION; =20 -/** - This function returns the report options. - - @return The current report option. -**/ -EREPORT_OPTION -EFIAPI -GetReportOption ( - VOID - ); - -/** - This function sets the report options. - - @param [in] ReportType The report option to set. -**/ -VOID -EFIAPI -SetReportOption ( - EREPORT_OPTION ReportType - ); - /** A structure holding the user selection detailing which ACPI table is to be examined by the AcpiView code. @@ -142,15 +30,15 @@ typedef struct { } SELECTED_ACPI_TABLE; =20 /** - This function returns the selected ACPI table. - - @param [out] SelectedAcpiTable Pointer that will contain the returned st= ruct. + Configuration struct for the acpiview command. **/ -VOID -EFIAPI -GetSelectedAcpiTable ( - OUT SELECTED_ACPI_TABLE** SelectedAcpiTable - ); +typedef struct { + BOOLEAN ConsistencyCheck; ///< Enable consistency chec= ks when processing tables + BOOLEAN ColourHighlighting; ///< Enable UEFI shell colou= r codes in output + EREPORT_OPTION ReportType; ///< Type of report to create + BOOLEAN MandatoryTableValidate; ///< Validate presence of ma= ndatory tables + UINTN MandatoryTableSpec; ///< Specification of which = tables are mandatory +} ACPI_VIEW_CONFIG; =20 /** This function selects an ACPI table in current context. @@ -161,8 +49,8 @@ GetSelectedAcpiTable ( **/ VOID EFIAPI -SelectAcpiTable ( - CONST CHAR16* TableName +AcpiViewConfigSelectTable ( + CONST CHAR16 *TableName ); =20 /** @@ -170,8 +58,12 @@ SelectAcpiTable ( **/ VOID EFIAPI -AcpiConfigSetDefaults ( +AcpiViewConfigSetDefaults ( VOID ); =20 +extern ACPI_VIEW_CONFIG mConfig; +extern SELECTED_ACPI_TABLE mSelectedAcpiTable; + #endif // ACPI_VIEW_CONFIG_H_ + diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiView= CommandLib.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiVi= ewCommandLib.c index d2f26ff89f12..9613c16f5703 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.c @@ -197,7 +197,7 @@ ShellCommandRunAcpiView ( CONST CHAR16* SelectedTableName; =20 // Set configuration defaults - AcpiConfigSetDefaults (); + AcpiViewConfigSetDefaults (); =20 ShellStatus =3D SHELL_SUCCESS; Package =3D NULL; @@ -290,31 +290,31 @@ ShellCommandRunAcpiView ( ShellStatus =3D SHELL_INVALID_PARAMETER; } else { // Turn on colour highlighting if requested - SetColourHighlighting (ShellCommandLineGetFlag (Package, L"-h")); + mConfig.ColourHighlighting =3D ShellCommandLineGetFlag (Package, L"-= h"); =20 // Surpress consistency checking if requested - SetConsistencyChecking (!ShellCommandLineGetFlag (Package, L"-q")); + mConfig.ConsistencyCheck =3D !ShellCommandLineGetFlag (Package, L"-q= "); =20 // Evaluate the parameters for mandatory ACPI table presence checks - SetMandatoryTableValidate (ShellCommandLineGetFlag (Package, L"-r")); + mConfig.MandatoryTableValidate =3D ShellCommandLineGetFlag (Package,= L"-r"); MandatoryTableSpecStr =3D ShellCommandLineGetValue (Package, L"-r"); =20 if (MandatoryTableSpecStr !=3D NULL) { - SetMandatoryTableSpec (ShellHexStrToUintn (MandatoryTableSpecStr)); + mConfig.MandatoryTableSpec =3D ShellHexStrToUintn (MandatoryTableS= pecStr); } =20 if (ShellCommandLineGetFlag (Package, L"-l")) { - SetReportOption (ReportTableList); + mConfig.ReportType =3D ReportTableList; } else { SelectedTableName =3D ShellCommandLineGetValue (Package, L"-s"); if (SelectedTableName !=3D NULL) { - SelectAcpiTable (SelectedTableName); - SetReportOption (ReportSelected); + AcpiViewConfigSelectTable (SelectedTableName); + mConfig.ReportType =3D ReportSelected; =20 if (ShellCommandLineGetFlag (Package, L"-d")) { // Create a temporary file to check if the media is writable. CHAR16 FileNameBuffer[MAX_FILE_NAME_LEN]; - SetReportOption (ReportDumpBinFile); + mConfig.ReportType =3D ReportDumpBinFile; =20 UnicodeSPrint ( FileNameBuffer, --=20 2.24.1.windows.2 -=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 (#61803): https://edk2.groups.io/g/devel/message/61803 Mute This Topic: https://groups.io/mt/75193739/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61804+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 159344404156990.91912727962153; Mon, 29 Jun 2020 08:20:41 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id Hb1PYY1788612x9VbRIzgwK4; Mon, 29 Jun 2020 08:20:41 -0700 X-Received: from EUR05-DB8-obe.outbound.protection.outlook.com (EUR05-DB8-obe.outbound.protection.outlook.com [40.107.20.66]) by mx.groups.io with SMTP id smtpd.web12.21080.1593444039182847033 for ; Mon, 29 Jun 2020 08:20:39 -0700 X-Received: from AM5P194CA0020.EURP194.PROD.OUTLOOK.COM (2603:10a6:203:8f::30) by AM6PR08MB4037.eurprd08.prod.outlook.com (2603:10a6:20b:a5::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:35 +0000 X-Received: from VE1EUR03FT013.eop-EUR03.prod.protection.outlook.com (2603:10a6:203:8f:cafe::25) by AM5P194CA0020.outlook.office365.com (2603:10a6:203:8f::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:35 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61804+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT013.mail.protection.outlook.com (10.152.19.37) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:35 +0000 X-Received: ("Tessian outbound fcb8da16d5bd:v60"); Mon, 29 Jun 2020 15:20:35 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 19d8dc579434bb8d X-CR-MTA-TID: 64aa7808 X-Received: from c6f0cd3e7385.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id FD77A156-44D0-441B-8F3C-E9B4FC14F57B.1; Mon, 29 Jun 2020 15:20:29 +0000 X-Received: from EUR01-VE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id c6f0cd3e7385.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:29 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=WEBOoE2GaaX+qABZ5roTnlMz/uC3BP5VTyrUqaipU06lgMFKhfxSiWZ3mjMDxhaJOWx0IyKK2jvcz0rV5H7ohXMr3sjoD8sPuEMRhfia67SKDJ7HgjUZYOSewo5AkajO5I2B5VIYR9M3R+6ENJ1yjZLTSsVB8O6FCiu9y5is3D9XYQr1aTxQ+GzMxJT4yeL6zZVXcPQWCan665kgNkC0BaBtMwy18+EHK3eFGqysUiM4EwDNI0LFbiUOOrvKwFCJX7fvByELeR9+4UQTdITKNRUjCFjjYwC7eV18nMrR4oZpVZ5uDLk/cZwAlxsbeBwdmuyDyZF9NB196waffDCWNw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ss5B2qsN8fCts2U8AODRCEzGLaeaHYDWBFFl7SfZbn0=; b=aPmcERy+pQWJOKHcgGwig6zgp927PW/b8rC0PanMyoExT2CM5A1mEq9lu1riztvl97i6VwGKUO9ladWOnf41bf7J6r0yKH/qAqBBb7iF6c5oGMUbsCKR6e/8w7BbhoBSSv16fgTTjL4Q+GRVBM6UT1C3fQrGj1vPiIkPlbYc7RCYl5BZeWBB/RZn0ICEXpL+pZd85MVhuERzubdaoEEqVDjDNRcujRUjWTExocXmhAchyFGdEEQ0ZqxekWFy1pqdsOIMn7GfGCposZKZanFy2m8ZEBAmnP0fochvb8L+WbXqjbhPYt717nThoNSZsqhzx+5u43CEiCD//LaVwv8bZw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from DB8PR09CA0009.eurprd09.prod.outlook.com (2603:10a6:10:a0::22) by AM7PR08MB5447.eurprd08.prod.outlook.com (2603:10a6:20b:10b::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.24; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from DB5EUR03FT035.eop-EUR03.prod.protection.outlook.com (2603:10a6:10:a0:cafe::ab) by DB8PR09CA0009.outlook.office365.com (2603:10a6:10:a0::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:27 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by DB5EUR03FT035.mail.protection.outlook.com (10.152.20.65) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX04.Arm.com (10.251.24.32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:26 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 2/8] ShellPkg/AcpiView: Declutter error counters Date: Mon, 29 Jun 2020 16:20:02 +0100 Message-ID: <20200629152008.685-3-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(39860400002)(136003)(346002)(376002)(396003)(46966005)(6916009)(1076003)(86362001)(186003)(70206006)(36756003)(6666004)(5660300002)(70586007)(26005)(83380400001)(336012)(356005)(426003)(2616005)(82310400002)(4326008)(54906003)(478600001)(81166007)(8676002)(8936002)(316002)(47076004)(2906002)(82740400003);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 439f97aa-455c-4b94-dd57-08d81c3ff8a3 X-MS-TrafficTypeDiagnostic: AM7PR08MB5447:|AM6PR08MB4037: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:107;OLM:107; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: +NMoDG8vJgUR1s8bcmaQdBkPxF5Oh24Qbo+VYGks6X7GCUZv0wVvCuEx2G/vduwA6Z86TM88olqvvtBFRJDRDJv8Uk8uzkogpViAse2CasHtj6PxQkY5R59dhuPGoiihQwv6pyw6adpag6hOxIzSHG2JEGcifNYq3yYDgM8j/ai+LBkYqkyT0V9cXOfL1ny0695s4BU9ZttvxF2VsbUyqCph9l3vV6sd3+15xuO715UeGP/CWWFkwybwlz7GWL3rsTyJ8tP5sMKk4JT2eAxdSMm80QJyfaB9SMYsU4ApHkB2ylCsSOug7Zxf0qvkGU7C4w9z54zXycn3LFWkJ3wr+noXvZPiIEiRyJOCbQVo6+78U7qUi6poIjfthdaXU0s3MMyWmHopmem3PJzL+MKrHQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM7PR08MB5447 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT013.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 08cebd74-ba67-4cb0-4ad5-08d81c3ff41e X-Microsoft-Antispam-Message-Info: BvtlpHG4eFe5OYKnUxVrGo8ojIZHQXIrtqYnbQbdBsXKCvvnxWVbHqFF1G60r5z5Z8p3ESplr71H0TBM6MgaS0Y6UnsCfADEumyABFvLLAm+fM6VXRO+WROk/lJjZxoD6FgFJVHQZpConVovp+YZnL4zzfPwizaZWv0LmjuxrmfAiW8KFxX8CtFzdD+dj0MPhxUQqHQbCKY7NDw5f1VYeCG86OGqV+0eDvg6kHCNxLEq9CDXfB6YWArTb94n2PE6FroUCK46twdKlMXY0c4RcimsYyYbaZj70IZL2jOLjxfNEi6Bms7cYDsCmezvEhuuAhGQ1PNAFt+n0oXaAfydexjLFuWxLfSlCZuvtJwinPBw2K5zb1PRJR0rH+H0edg0YKjMB817Egj/yG7iM4jaMg== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:35.1803 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 439f97aa-455c-4b94-dd57-08d81c3ff8a3 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT013.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR08MB4037 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,Tomas.Pilar@arm.com X-Gm-Message-State: KqvTZrJJhhEPH3xH5e0fST1nx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444041; bh=sMARoUWPXCGLyTM9beP7dj7AUGjCmb/fVeRsBqmdmEI=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=v+aRdqNGgpVhJ7ARQ52hlSyvd4uMd24WUtDVrw6xGh9xLwZQq07reWvPjYhlMzoJOvE pNIvRgtrz+Urp7CerBPXlpiXjJXLOzEVwmEba3ed1MmXjFff035s4FlAE4J4U6DdV9AC+ AcPWUdbtmUWNf8S/wZWcqTN+7rve3gwsG3Y= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Remove superfluous accessor methods for error and warning counters. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 54 ++----------------- .../UefiShellAcpiViewCommandLib/AcpiParser.h | 4 ++ .../UefiShellAcpiViewCommandLib/AcpiView.c | 12 ++--- .../UefiShellAcpiViewCommandLib/AcpiView.h | 36 ------------- 4 files changed, 14 insertions(+), 92 deletions(-) diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index 3a029b01cc20..7017fa93efae 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -13,8 +13,10 @@ #include "AcpiViewConfig.h" =20 STATIC UINT32 gIndent; -STATIC UINT32 mTableErrorCount; -STATIC UINT32 mTableWarningCount; + +// Publicly accessible error and warning counters. +UINT32 mTableErrorCount; +UINT32 mTableWarningCount; =20 STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; =20 @@ -25,54 +27,6 @@ STATIC CONST ACPI_PARSER AcpiHeaderParser[] =3D { PARSE_ACPI_HEADER (&AcpiHdrInfo) }; =20 -/** - This function resets the ACPI table error counter to Zero. -**/ -VOID -ResetErrorCount ( - VOID - ) -{ - mTableErrorCount =3D 0; -} - -/** - This function returns the ACPI table error count. - - @retval Returns the count of errors detected in the ACPI tables. -**/ -UINT32 -GetErrorCount ( - VOID - ) -{ - return mTableErrorCount; -} - -/** - This function resets the ACPI table warning counter to Zero. -**/ -VOID -ResetWarningCount ( - VOID - ) -{ - mTableWarningCount =3D 0; -} - -/** - This function returns the ACPI table warning count. - - @retval Returns the count of warning detected in the ACPI tables. -**/ -UINT32 -GetWarningCount ( - VOID - ) -{ - return mTableWarningCount; -} - /** This function increments the ACPI table error counter. **/ diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h index f81ccac7e118..84eae61c8889 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h @@ -16,6 +16,10 @@ /// that allows us to process the log options. #define RSDP_TABLE_INFO SIGNATURE_32('R', 'S', 'D', 'P') =20 +// Publicly accessible error and warning counters. +extern UINT32 mTableErrorCount; +extern UINT32 mTableWarningCount; + /** This function increments the ACPI table error counter. **/ diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c b/Shel= lPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c index d2c14d5b8f5a..e25e0712948b 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c @@ -199,8 +199,8 @@ AcpiView ( mBinTableCount =3D 0; =20 // Reset The error/warning counters - ResetErrorCount (); - ResetWarningCount (); + mTableErrorCount =3D 0; + mTableWarningCount =3D 0; =20 // Search the table for an entry that matches the ACPI Table Guid FoundAcpiTable =3D FALSE; @@ -278,7 +278,7 @@ AcpiView ( Print (L"\nTable Statistics:\n"); =20 if (mConfig.ColourHighlighting) { - PrintAttribute =3D (GetErrorCount () > 0) ? + PrintAttribute =3D ((mTableErrorCount) > 0) ? EFI_TEXT_ATTR ( EFI_RED, ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4) @@ -286,10 +286,10 @@ AcpiView ( OriginalAttribute; gST->ConOut->SetAttribute (gST->ConOut, PrintAttribute); } - Print (L"\t%d Error(s)\n", GetErrorCount ()); + Print (L"\t%d Error(s)\n", mTableErrorCount); =20 if (mConfig.ColourHighlighting) { - PrintAttribute =3D (GetWarningCount () > 0) ? + PrintAttribute =3D (mTableWarningCount > 0) ? EFI_TEXT_ATTR ( EFI_RED, ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4) @@ -298,7 +298,7 @@ AcpiView ( =20 gST->ConOut->SetAttribute (gST->ConOut, PrintAttribute); } - Print (L"\t%d Warning(s)\n", GetWarningCount ()); + Print (L"\t%d Warning(s)\n", mTableWarningCount); =20 if (mConfig.ColourHighlighting) { gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.h b/Shel= lPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.h index d5b95f5ee707..6fefe98a4463 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.h @@ -23,42 +23,6 @@ **/ #define RSDP_LENGTH_OFFSET 20 =20 -/** - This function resets the ACPI table error counter to Zero. -**/ -VOID -ResetErrorCount ( - VOID - ); - -/** - This function returns the ACPI table error count. - - @retval Returns the count of errors detected in the ACPI tables. -**/ -UINT32 -GetErrorCount ( - VOID - ); - -/** - This function resets the ACPI table warning counter to Zero. -**/ -VOID -ResetWarningCount ( - VOID - ); - -/** - This function returns the ACPI table warning count. - - @retval Returns the count of warning detected in the ACPI tables. -**/ -UINT32 -GetWarningCount ( - VOID - ); - /** This function processes the table reporting options for the ACPI table. =20 --=20 2.24.1.windows.2 -=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 (#61804): https://edk2.groups.io/g/devel/message/61804 Mute This Topic: https://groups.io/mt/75193740/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61811+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593444055283180.8067523468169; Mon, 29 Jun 2020 08:20:55 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id WuuhYY1788612x54T1KTFw8g; Mon, 29 Jun 2020 08:20:53 -0700 X-Received: from EUR01-DB5-obe.outbound.protection.outlook.com (EUR01-DB5-obe.outbound.protection.outlook.com [40.107.15.89]) by mx.groups.io with SMTP id smtpd.web12.21090.1593444050233579982 for ; Mon, 29 Jun 2020 08:20:50 -0700 X-Received: from MR2P264CA0031.FRAP264.PROD.OUTLOOK.COM (2603:10a6:500::19) by AM0PR08MB4322.eurprd08.prod.outlook.com (2603:10a6:208:148::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20; Mon, 29 Jun 2020 15:20:47 +0000 X-Received: from VE1EUR03FT062.eop-EUR03.prod.protection.outlook.com (2603:10a6:500:0:cafe::7c) by MR2P264CA0031.outlook.office365.com (2603:10a6:500::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:47 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61811+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT062.mail.protection.outlook.com (10.152.18.252) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:47 +0000 X-Received: ("Tessian outbound fcfbba629a49:v60"); Mon, 29 Jun 2020 15:20:46 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: bfb5772cbde5f881 X-CR-MTA-TID: 64aa7808 X-Received: from 869bd0d90171.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 307589E5-6158-4DA6-8721-1006CFBEBF5E.1; Mon, 29 Jun 2020 15:20:46 +0000 X-Received: from EUR05-DB8-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 869bd0d90171.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:46 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=atOIp4YSm39ozNRM63x4zypaRgN4zADjqzShw3Mr/0xnEhAOyXEQHFRMrNoc/Kqm9gk+wgMaG8G0Bw6X+HEOgv62Gn1l86Ic8R42AO2Oy58WCyuuMblUt/X4+7oy8BZrwN3tA3W1H8Pjl3OypmN5fMplgSpexZTyYQGAUWfPh9qc+vl0yqQKuKLQ9u/Q6IFRIu5wmZDBepnnyLAwas8BBeuWETNSSsgSjCyuPLJbxDQ9x8l3x658X6NjIT/psWQvUszOrG1srlLa0uMKZ41W3E2nPcrQlQg9eOMQQjJhPyX40WRTh0LUCghIGjlsCxgg6BUxsguBm2O2FyCmxSp8Yg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=cnE2/DQ0hKXqy2ESlB+7PiWjpkjt+L6O+L2ENMjVS4A=; b=kg+DI2dQJuDw5I4GEYSA8/dY/rhP7UCHDjYng1IFb+xkj6+tF5au+pCUgrsvguaFhP975OL91NjX9U55HZGrWJ+GqWhutuANxJtYWnVoteGLeWPvNUaCkjKFSPsj8sOHApIlMGB885ak4tNJxZp9rRFMbM4Tz5Xve1443UVHgg9XCpBJK2u2C0kJOw51S8DqM58ns+8KvSPeQHst+9RMuRaPAPs83Z3teudKOQ3b0AkllAUxyDqWG7DSDB9NTGa9FL4BWl+9C5RxwjcXM+QuVVhRWkgYPK7vNUHPTezbk+eJ3HjchGOEeXNm/lGlYMSnz2yCYh+CpUn0Xo47ZCPEfQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from AM5PR1001CA0060.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:206:15::37) by AM6PR08MB5031.eurprd08.prod.outlook.com (2603:10a6:20b:ed::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.23; Mon, 29 Jun 2020 15:20:35 +0000 X-Received: from VE1EUR03FT018.eop-EUR03.prod.protection.outlook.com (2603:10a6:206:15:cafe::c1) by AM5PR1001CA0060.outlook.office365.com (2603:10a6:206:15::37) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:35 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by VE1EUR03FT018.mail.protection.outlook.com (10.152.18.135) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:34 +0000 X-Received: from AZ-NEU-EX01.Emea.Arm.com (10.251.26.4) by AZ-NEU-EX03.Arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:28 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX01.Emea.Arm.com (10.251.26.4) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1779.2; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:27 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 3/8] ShellPkg/AcpiView: Modify error message Date: Mon, 29 Jun 2020 16:20:03 +0100 Message-ID: <20200629152008.685-4-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(136003)(39860400002)(396003)(346002)(376002)(46966005)(6666004)(356005)(6916009)(8936002)(5660300002)(478600001)(86362001)(2906002)(54906003)(8676002)(47076004)(15650500001)(83380400001)(26005)(1076003)(186003)(336012)(316002)(426003)(2616005)(36756003)(70206006)(82740400003)(82310400002)(4326008)(70586007)(81166007);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 01a0a07e-0478-4015-a16c-08d81c3fffc0 X-MS-TrafficTypeDiagnostic: AM6PR08MB5031:|AM0PR08MB4322: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:6430;OLM:6430; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: a/7Inb5WYm5OUO+7SMhlo3P5an4ARYSSyz+//ibqDFHSHuPWnCd7vadkBowY1mGYFFC1RVn/v5yf7XdRH+JBqgKR57QtBhq9wq6+2PkNQiGCP3eCPU34EkDlJzQKF2TOSnmvDQNQ+IBvkFliA1bvr6wxKiAFEdsdhYavyY9p/vByzSm8p6w3x/5PGcu1OGwBiOeqjYbwyTkaBhkq29ZPvKXFHBiVu5ShVcoBHtMy/rRjPXKeXpgimFY64xMaTlU7fQsZbz6G9j2euzBkCdATtuVeOe+sMkbTprtQ9xiRK3w9w3W8c2dlLRZnfv61Dc3Ck7TFu/RXh4mcuqEttyJP3TEwhzNbQgShX5Fj9K0MXFTgdsBysnIlSY+5E9B1ZirYwDz0vUZCVXnea6lmyrxHfQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR08MB5031 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT062.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 7c3206ad-fe24-4462-a9be-08d81c3ff85a X-Microsoft-Antispam-Message-Info: m7lIiHl+uANA9rLMLnXHuvwDkp6CJQSuJ77y/LgiCoVFI/KWRbexJbpF/gjYXAdSgK44QHL11kc3V5PUbTmgdfepRDBBL+16qI0wQncCiDfyFfjpOL/X34QLA25JFwS8mCR8jN27qsyK0SSyrhP8ETiwH3vbmOE9eO5WNMBQyPigLQgMMu+Gco+qh0//5SwIjOt9Q2BAWvw/dUKHxizTMqnzie41g25XKUmKlBg6R4Im/CD/gso4PD/rv6fBDtcrJgmyD2t+eak2GpRHurcTKQukgGZiK4ZCKDFjKIYiXz5SSbRglx1edSeY4mDJGwFtyI1XoXSPosq1Uo0a/ryOqcS1Kf6i6+9CJbmaWgSr0kgaUuRAH83rlEpquUD7sdpWVDEBZjKZFDPpZfPOSW8zvg== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:47.1087 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 01a0a07e-0478-4015-a16c-08d81c3fffc0 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT062.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR08MB4322 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,Tomas.Pilar@arm.com X-Gm-Message-State: ykCc7aJyIYLxfOeeuQahXLvjx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444053; bh=10KAqGfE2p472T2OYn9OIJmC23oaarA0CQovdfcDo+E=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=xBHJ52n0GOP6MrF0d/SdeBDgARwKW8aRqYCKZsHQxlnVgN+hOPp7Ja/fjjqULeEEkje 3DcsK6ChNqcJfmr3yeqETiL/BcR2FDvpybUeQ4D+WelXcPWlMT9sxwGWizEfIA5+4C2Wq wGgB8X4XrDhjHD5QPDI1ImbBkvvPKXBDzOk= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Modify the DumpFile error message to be more in line with the rest of the error messages in the same file. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommandLib.c | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiView= CommandLib.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiVi= ewCommandLib.c index 9613c16f5703..11e97afabc52 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.c @@ -147,10 +147,8 @@ ShellDumpBufferToFile ( ); =20 if (EFI_ERROR (Status)) { - Print (L"ERROR: Failed to write binary file.\n"); + Print (L"acpiview: Failed to write binary file.\n"); TransferBytes =3D 0; - } else { - Print (L"DONE.\n"); } =20 ShellCloseFile (&DumpFileHandle); --=20 2.24.1.windows.2 -=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 (#61811): https://edk2.groups.io/g/devel/message/61811 Mute This Topic: https://groups.io/mt/75193751/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61809+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593444050903363.3059189630228; Mon, 29 Jun 2020 08:20:50 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id LDdgYY1788612xCPJnEBEzTy; Mon, 29 Jun 2020 08:20:50 -0700 X-Received: from EUR02-AM5-obe.outbound.protection.outlook.com (EUR02-AM5-obe.outbound.protection.outlook.com [40.107.0.71]) by mx.groups.io with SMTP id smtpd.web11.21345.1593444049234200762 for ; Mon, 29 Jun 2020 08:20:49 -0700 X-Received: from MRXP264CA0043.FRAP264.PROD.OUTLOOK.COM (2603:10a6:500:14::31) by VI1PR08MB5519.eurprd08.prod.outlook.com (2603:10a6:803:133::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:46 +0000 X-Received: from VE1EUR03FT050.eop-EUR03.prod.protection.outlook.com (2603:10a6:500:14:cafe::4f) by MRXP264CA0043.outlook.office365.com (2603:10a6:500:14::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:46 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61809+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT050.mail.protection.outlook.com (10.152.19.209) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:46 +0000 X-Received: ("Tessian outbound cea5956745d7:v60"); Mon, 29 Jun 2020 15:20:46 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: d16d5cf317258a94 X-CR-MTA-TID: 64aa7808 X-Received: from 113bdbaaeaeb.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 8928D47D-B918-4D57-BD59-A043943D2427.1; Mon, 29 Jun 2020 15:20:40 +0000 X-Received: from EUR04-HE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 113bdbaaeaeb.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:40 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QD29ba7FipEy9OHYFmr2T1u8FHE7cVBOQjI2nZB7d01bKDw+HJWofmXQxuCKJk10u2QOPcx3iy0BsA96Dr7jGWEaXBbpTQHO4Bunz2ziBhbJZdB4cYFOi7FbCJ47fcL6aaIdsXAJT7Hk8LieqhG16Wo8qX2cSAY5y8ERYh4wQlJ7TrD0EHNlDR+Wc15Mn1p/BM4TdarEtTO0hZpqX27gTM3r0YNZS3y1fGET9vBbUMvTfdNjMtrRKKIW3L7G2u4femtMtN0u72nss9LqbdBC3ACa+fUMLfxRLsAGLB56P5vr98z6ocQADsATN+RHb3DnDsv8dixKO6oMceP3kKJHtg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Oi+wvNg7rczvBBScGNpqKfvu0lEyG2J71ee4F/Lkcyc=; b=Xm45y+duxVbBuxoSeZwBtJc+V7wMALuutF1PEcP7Ic088e/IEb5tbL7G9NVgbIOFJaCik1eENhHNoIFekBuTyI2XY6eKHp38wi425IPkwlONcUA7Xf78wM3hHDJcsJeBRHNANDI6UMso/luKt3zcKZytyc5dq2OEUwIuT5OrzdUuiddiYZqfe0PfIRzlcou3rwRr6WkUrJ/rt7JcmCusWTW7eQnas1ILoR82BBcrsm64eekDts66jokJfxm1DO6bwsAvbcEMdeznscAwmDGL9uFj0zKfoGPlN2q2fV26b6zDZWmwI0KnJQGHfJ5GqhHE23807GbDTipSaLSVXr2gnw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from AM6P194CA0057.EURP194.PROD.OUTLOOK.COM (2603:10a6:209:84::34) by VE1PR08MB4958.eurprd08.prod.outlook.com (2603:10a6:803:108::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:36 +0000 X-Received: from VE1EUR03FT064.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:84:cafe::32) by AM6P194CA0057.outlook.office365.com (2603:10a6:209:84::34) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:36 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by VE1EUR03FT064.mail.protection.outlook.com (10.152.19.210) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:36 +0000 X-Received: from AZ-NEU-EX01.Emea.Arm.com (10.251.26.4) by AZ-NEU-EX03.Arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:28 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX01.Emea.Arm.com (10.251.26.4) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1779.2; Mon, 29 Jun 2020 15:20:27 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:27 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 4/8] ShellPkg/AcpiView: Create a logging facility Date: Mon, 29 Jun 2020 16:20:04 +0100 Message-ID: <20200629152008.685-5-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(136003)(39860400002)(376002)(346002)(396003)(46966005)(86362001)(316002)(478600001)(426003)(5660300002)(336012)(1076003)(19627235002)(2616005)(82740400003)(83380400001)(4326008)(47076004)(6916009)(81166007)(36756003)(8676002)(8936002)(6666004)(2906002)(30864003)(70586007)(356005)(26005)(82310400002)(54906003)(186003)(70206006)(403724002);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 4b2a0c19-fe48-4889-dda0-08d81c3fff53 X-MS-TrafficTypeDiagnostic: VE1PR08MB4958:|VI1PR08MB5519: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:10000;OLM:10000; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: RQluxEZiwCc3fkmnq+WI5OA/bbfY1/YcgND4IO1vruzhd3EjQzptH31yRUSp5g1lFgAduey8UMG2Ik/vBKONIpk2r0VAJtYZD9d7Xm+aU1jeBJOVFs/4t2p0RU7DzgtseI5hEux+wZJ3rJ4xm80xwIzixUd/LTeY/STbYgn8Nd6alRr/QSArh1J+uvMxw5Wg+NIJY/hdjHU9K3oGKbc8PI18vRYBgumXn5dqPIzFADUaBpwD9T/bBobFK19Nbd6kI/nNVlCTcjvQ8MzU2ZaADrvx5Z7rbBmRPe3RwCm9WbmPAe8evTQrcM4TUe+RH2MhYNtSCn/rRnEMToXrxRTiDjU/Pku5gSlbcKUc20vNRsOvVsDxn/mquXXfU6V5efUAVgSuL2N23McAfYxcZ/5Qt5a0vvDrj+MTXV0rasXGCx8= X-MS-Exchange-Transport-CrossTenantHeadersStamped: VE1PR08MB4958 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT050.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 980c8d00-72d6-4f78-9b05-08d81c3ff923 X-Microsoft-Antispam-Message-Info: 2n+MWEabN295z8yi0KvRmb6+k4FOuX4qjBQ3sNW3NFRFvTZI1P7LaWahaS832SqnPGh658kD3yA/yj4sIKL/cKpsIEKGd/gqXYs4Xk0YsSUoQtKdux+fcT3TuqfLHbFjVaQPSXz4rWRUIVHTW0jCaMVhnRigHOWq4PahvQegVrhczg03QSlRI6C9TUwpYoL6xmQ41Z8wdEFlwDMtMm1ympeF9yBVRS754jQzngfPIrxPcsoM8RLC2hKr4sHYozj6gbkPv4QLxtiYokJV2NH5Et7fI0STVJZv8VWdfCe2EMVgBdHE7fSRI6ZfffLwIMyUJYP+w9kk2wAmtubvOpVD/4x9WvUf1BU5ALsXMnPiqGMaLAZqG6l6+pFbBVzAyzdBQeJFFx2zcJ62OGpKp7Sa2xK1dyHGsr2L6h0CZHqJxsY= X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:46.3609 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 4b2a0c19-fe48-4889-dda0-08d81c3fff53 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT050.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB5519 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,Tomas.Pilar@arm.com X-Gm-Message-State: tMGwmQThYltI5lurS7Q6VmzJx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444050; bh=xDZl/vezmmGlujsmqrcRUtstgqOx5R3t65rO1E4ChiE=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=FK8PTK4e80xX8apDiOXpnwxy6kDy92vjeXPJrv26QRbAGNlHKfOTHmqP9IlPf9amCfC QpBn+haVYpfxOjky3T2cfYYmbNr7lpIVuQjSEPn/dj4x1ZMjFTkyfJ27Iv2M7kY2BLYmn grDCdyXm/VF61/zHPNaL1i+d04i54Surxzc= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Extract error and warning logging into separate methods. Fold highlighting and other output properties into the logging methods. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 5 +- .../UefiShellAcpiViewCommandLib/AcpiViewLog.c | 230 +++++++++++++++++ .../UefiShellAcpiViewCommandLib/AcpiViewLog.h | 233 ++++++++++++++++++ .../UefiShellAcpiViewCommandLib.inf | 2 + 4 files changed, 466 insertions(+), 4 deletions(-) create mode 100644 ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLo= g.c create mode 100644 ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLo= g.h diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index 7017fa93efae..b88594cf3865 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -11,13 +11,10 @@ #include "AcpiParser.h" #include "AcpiView.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" =20 STATIC UINT32 gIndent; =20 -// Publicly accessible error and warning counters. -UINT32 mTableErrorCount; -UINT32 mTableWarningCount; - STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; =20 /** diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c b/S= hellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c new file mode 100644 index 000000000000..9b9aaa855fdc --- /dev/null +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c @@ -0,0 +1,230 @@ +/** @file + 'acpiview' logging and output facility + + Copyright (c) 2020, ARM Limited. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include "AcpiViewLog.h" +#include "AcpiViewConfig.h" +#include "AcpiParser.h" +#include + +static CHAR16 mOutputBuffer [MAX_OUTPUT_SIZE] =3D { 0 }; + +// String descriptions of error types +static const CHAR16* mErrorTypeDesc [ACPI_ERROR_MAX] =3D { + L"Not an error", ///< ACPI_ERROR_NONE + L"Generic", ///< ACPI_ERROR_GENERIC + L"Checksum", ///< ACPI_ERROR_CSUM + L"Parsing", ///< ACPI_ERROR_PARSE + L"Length", ///< ACPI_ERROR_LENGTH + L"Value", ///< ACPI_ERROR_VALUE + L"Cross-check", ///< ACPI_ERROR_CROSS +}; + +// Publicly accessible error and warning counters. +UINT32 mTableErrorCount; +UINT32 mTableWarningCount; + +/** + Change the attributes of the standard output console + to change the colour of the text according to the given + severity of a log message. + + @param[in] Severity The severity of the log message that is bei= ng + annotated with changed colour text. + @param[in] OriginalAttribute The current attributes of ConOut that will = be modified. +**/ +static +VOID +EFIAPI +ApplyColor ( + IN ACPI_LOG_SEVERITY Severity, + IN UINTN OriginalAttribute + ) +{ + if (!mConfig.ColourHighlighting) { + return; + } + + // Strip the foreground colour + UINTN NewAttribute =3D OriginalAttribute & 0xF0; + + // Add specific foreground colour based on severity + switch (Severity) { + case ACPI_DEBUG: + NewAttribute |=3D EFI_DARKGRAY; + break; + case ACPI_HIGHLIGHT: + NewAttribute |=3D EFI_LIGHTBLUE; + break; + case ACPI_GOOD: + NewAttribute |=3D EFI_GREEN; + break; + case ACPI_ITEM: + case ACPI_WARN: + NewAttribute |=3D EFI_YELLOW; + break; + case ACPI_BAD: + case ACPI_ERROR: + case ACPI_FATAL: + NewAttribute |=3D EFI_RED; + break; + case ACPI_INFO: + default: + NewAttribute |=3D OriginalAttribute; + break; + } + + gST->ConOut->SetAttribute (gST->ConOut, NewAttribute); +} + +/** + Restore ConOut text attributes. + + @param[in] OriginalAttribute The attribute set that will be restored. +**/ +static +VOID +EFIAPI +RestoreColor( + IN UINTN OriginalAttribute + ) +{ + gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); +} + +/** + Formats and prints an ascii string to screen. + + @param[in] Format String that will be formatted and printed. + @param[in] Marker The marker for variable parameters to be formatted. +**/ +static +VOID +EFIAPI +AcpiViewVSOutput ( + IN const CHAR16 *Format, + IN VA_LIST Marker + ) +{ + UnicodeVSPrint (mOutputBuffer, sizeof(mOutputBuffer), Format, Marker); + gST->ConOut->OutputString(gST->ConOut, mOutputBuffer); +} + +/** + Formats and prints and ascii string to screen. + + @param[in] Format String that will be formatted and printed. + @param[in] ... A variable number of parameters that will be formatted. +**/ +VOID +EFIAPI +AcpiViewOutput ( + IN const CHAR16 *Format, + IN ... +) +{ + VA_LIST Marker; + VA_START (Marker, Format); + + AcpiViewVSOutput (Format, Marker); + + VA_END (Marker); +} + + +/** + Prints the base file name given a full file path. + + @param[in] FullName Fully qualified file path +**/ +VOID +EFIAPI +PrintFileName ( + IN const CHAR8* FullName + ) +{ + const CHAR8* Cursor; + UINTN Size; + + Cursor =3D FullName; + Size =3D 0; + + // Find the end point of the string. + while (*Cursor && Cursor < FullName + MAX_OUTPUT_SIZE) + Cursor++; + + // Find the rightmost path separator. + while (*Cursor !=3D '\\' && *Cursor !=3D '/' && Cursor > FullName) { + Cursor--; + Size++; + } + + // Print base file name. + AcpiViewOutput (L"%.*a", Size - 1, Cursor + 1); +} + +/** + AcpiView output and logging function. Will log the event to + configured output (currently screen) and annotate with colour + and extra metadata. + + @param[in] FileName The full filename of the source file where this + event occured. + @param[in] FunctionName The name of the function where this event occur= ed. + @param[in] LineNumber The line number in the source code where this e= vent + occured. + @param[in] Severity The severity of the event that occured. + @param[in] Format The format of the string describing the event. + @param[in] ... The variable number of parameters that will for= mat the + string supplied in Format. +**/ +VOID +EFIAPI +AcpiViewLog ( + IN const CHAR8 *FileName, + IN const CHAR8 *FunctionName, + IN UINTN LineNumber, + IN ACPI_ERROR_TYPE Error, + IN ACPI_LOG_SEVERITY Severity, + IN const CHAR16 *Format, + ...) +{ + VA_LIST Marker; + UINTN OriginalAttribute; + + OriginalAttribute =3D gST->ConOut->Mode->Attribute; + ApplyColor (Severity, OriginalAttribute); + VA_START (Marker, Format); + + switch (Severity) { + case ACPI_FATAL: + AcpiViewOutput (L"FATAL "); + break; + case ACPI_ERROR: + AcpiViewOutput (L"ERROR[%s] ", mErrorTypeDesc[Error]); + mTableErrorCount++; + break; + case ACPI_WARN: + AcpiViewOutput (L"WARN "); + mTableWarningCount++; + break; + default: + break; + } + + if (Severity >=3D ACPI_WARN) { + AcpiViewOutput (L"("); + PrintFileName (FileName); + AcpiViewOutput (L":%d) ", LineNumber); + } + + AcpiViewVSOutput (Format, Marker); + AcpiViewOutput (L"\n"); + + VA_END (Marker); + RestoreColor (OriginalAttribute); +} + diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h b/S= hellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h new file mode 100644 index 000000000000..77049cd8eec2 --- /dev/null +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h @@ -0,0 +1,233 @@ +/** @file + Header file for 'acpiview' logging and output facility + + Copyright (c) 2020, ARM Limited. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#ifndef ACPI_VIEW_LOG_H_ +#define ACPI_VIEW_LOG_H_ + +#include + +/* + Categories of errors that can be logged by AcpiView. +*/ +typedef enum { + ACPI_ERROR_NONE, ///< Not an error + ACPI_ERROR_GENERIC, ///< An unspecified error + ACPI_ERROR_CSUM, ///< A checksum was invalid + ACPI_ERROR_PARSE, ///< Failed to parse item + ACPI_ERROR_LENGTH, ///< Size of a thing is incorrect + ACPI_ERROR_VALUE, ///< The value of a field was incorrect + ACPI_ERROR_CROSS, ///< A constraint on multiple items was violated + ACPI_ERROR_MAX +} ACPI_ERROR_TYPE; + +/* + Different severities of events that can be logged. +*/ +typedef enum { + ACPI_DEBUG, ///< Will not be shown unless specified on command line + ACPI_INFO, ///< Standard output + ACPI_GOOD, ///< Unspecified good outcome, green colour + ACPI_BAD, ///< Unspecified bad outcome, red colour + ACPI_ITEM, ///< Used when describing multiple items + ACPI_HIGHLIGHT, ///< A new context or section has been entered + ACPI_WARN, ///< An unusual event happened + ACPI_ERROR, ///< Acpi table is not conformant + ACPI_FATAL ///< This will abort program execution. +} ACPI_LOG_SEVERITY; + +// Publicly accessible error and warning counters. +extern UINT32 mTableErrorCount; +extern UINT32 mTableWarningCount; + +/** + AcpiView output and logging function. Will log the event to + configured output (currently screen) and annotate with colour + and extra metadata. + + @param[in] FileName The full filename of the source file where this + event occured. + @param[in] FunctionName The name of the function where this event occur= ed. + @param[in] LineNumber The line number in the source code where this e= vent + occured. + @param[in] Severity The severity of the event that occured. + @param[in] Error The type of the erorr reported. May be ACPI_ERR= OR_NONE if the event + is not an error. + @param[in] Format The format of the string describing the event. + @param[in] ... The variable number of parameters that will for= mat the + string supplied in Format. +**/ +VOID +EFIAPI +AcpiViewLog ( + IN const CHAR8 *FileName, + IN const CHAR8 *FunctionName, + IN UINTN LineNumber, + IN ACPI_ERROR_TYPE Error, + IN ACPI_LOG_SEVERITY Severity, + IN const CHAR16 *Format, + ... + ); + +/** + Formats and prints and ascii string to screen. + + @param[in] Format String that will be formatted and printed. + @param[in] ... A variable number of parameters that will be formatted. +**/ +VOID +EFIAPI +AcpiViewOutput ( + IN const CHAR16 *Format, + IN ... + ); + +/** + Check that a buffer has not been overrun by a member. Can be invoked + using the BufferOverrun macro that fills in local source metadata + (first three parameters) for logging purposes. + + @param[in] FileName Source file where this invocation is made + @param[in] FunctionName Name of the local symbol + @param[in] LineNumber Source line number of the local call + @param[in] ItemDescription User friendly name for the member being check= ed + @param[in] Position Memory address of the member + @param[in] Length Length of the member + @param[in] Buffer Memory address of the buffer where member res= ides + @param[in] BufferSize Size of the buffer where member resides + + @retval TRUE Buffer was overrun + @retval FALSE Buffer is safe +**/ +static +inline +BOOLEAN +EFIAPI +MemberIntegrityInternal ( + IN const CHAR8 *FileName, + IN const CHAR8 *FunctionName, + IN UINTN LineNumber, + IN const CHAR8 *ItemDescription, + IN UINTN Offset, + IN UINTN Length, + IN VOID *Buffer, + IN UINTN BufferSize) +{ + if (Length =3D=3D 0) { + AcpiViewLog ( + FileName, + FunctionName, + LineNumber, + ACPI_ERROR_LENGTH, + ACPI_ERROR, + L"%a at %p in buffer %p+%x has zero size!", + ItemDescription, + (UINT8 *)Buffer + Offset, + Buffer, + BufferSize); + return TRUE; + } + + if (Offset + Length > BufferSize) { + AcpiViewLog ( + FileName, + FunctionName, + LineNumber, + ACPI_ERROR_LENGTH, + ACPI_ERROR, + L"%a %p+%x overruns buffer %p+%x", + ItemDescription, + (UINT8 *) Buffer + Offset, + Length, + Buffer, + BufferSize); + } + + return (Offset + Length > BufferSize); +} + +// Determine if a member located at Offset into a Buffer lies entirely +// within the BufferSize given the member size is Length +// Evaluates to TRUE and logs error if buffer is overrun or if Length is z= ero +#define AssertMemberIntegrity(Offset, Length, Buffer, BufferSize) \ + MemberIntegrityInternal (__FILE__, __func__, __LINE__, #Length, Offset, = Length, Buffer, BufferSize) + + +/** + Checks that a boolean constraint evaluates correctly. Can be invoked + using the CheckConstraint macro that fills in the source code metadata. + + @param[in] FileName Source file where this invocation is made + @param[in] FunctionName Name of the local symbol + @param[in] LineNumber Source line number of the local call + @param[in] ConstraintText The Source code of the constraint + @param[in] Specification The specification that imposes the constraint + @param[in] Constraint The actual constraint + @ + + @retval TRUE Constraint is violated + @retval FALSE Constraint is not violated +**/ +static +inline +BOOLEAN +EFIAPI +CheckConstraintInternal ( + IN const CHAR8 *FileName, + IN const CHAR8 *FunctionName, + IN UINTN LineNumber, + IN const CHAR8 *ConstraintText, + IN const CHAR16 *Specification, + IN BOOLEAN Constraint, + IN ACPI_LOG_SEVERITY Severity +) +{ + if (!Constraint) { + AcpiViewLog ( + FileName, + FunctionName, + LineNumber, + Severity =3D=3D ACPI_ERROR ? ACPI_ERROR_VALUE : ACPI_ERROR_NONE, + Severity, + L"(%a) Constraint was violated: %a", + Specification, + ConstraintText); + } + + // Return TRUE if constraint was violated + return !Constraint; +} + +// Evaluates to TRUE and logs error if a constraint is violated +// Constraint internally cast to BOOLEAN using !!(Constraint) +#define AssertConstraint(Specification, Constraint) \ + CheckConstraintInternal ( \ + __FILE__, __func__, __LINE__, #Constraint, Specification, !!(Constrain= t), ACPI_ERROR) + +// Evaluates to TRUE and logs error if a constraint is violated +#define WarnConstraint(Specification, Constraint) \ + CheckConstraintInternal ( \ + __FILE__, __func__, __LINE__, #Constraint, Specification, Constraint, = ACPI_WARN) + + +// Maximum string size that can be printed +#define MAX_OUTPUT_SIZE 256 + +#define _AcpiLog(...) AcpiViewLog(__FILE__, __func__, __LINE__, __VA_ARGS_= _) + +// Generic Loging macro, needs severity and formatted string +#define AcpiLog(Severity, ...) _AcpiLog(ACPI_ERROR_NONE, Severity, __VA_AR= GS__) + +// Log undecorated text, needs formatted string +#define AcpiInfo(...) _AcpiLog(ACPI_ERROR_NONE, ACPI_INFO, __VA_ARGS__) + +// Log error and increment counter, needs error type and formatted string +#define AcpiError(Error, ...) _AcpiLog(Error, ACPI_ERROR, __VA_ARGS__) + +// Log a FATAL error, needs formatted string +#define AcpiFatal(...) _AcpiLog(ACPI_ERROR_GENERIC, ACPI_FATAL, __VA_ARGS_= _) + +#endif // ACPI_VIEW_LOG_H_ diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiView= CommandLib.inf b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpi= ViewCommandLib.inf index 91459f9ec632..e0586cbccec2 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.inf +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.inf @@ -27,6 +27,8 @@ [Sources.common] AcpiView.h AcpiViewConfig.c AcpiViewConfig.h + AcpiViewLog.h + AcpiViewLog.c Parsers/Bgrt/BgrtParser.c Parsers/Dbg2/Dbg2Parser.c Parsers/Dsdt/DsdtParser.c --=20 2.24.1.windows.2 -=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 (#61809): https://edk2.groups.io/g/devel/message/61809 Mute This Topic: https://groups.io/mt/75193749/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61805+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593444042728242.6021066949262; Mon, 29 Jun 2020 08:20:42 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id QFq2YY1788612xofAWRxUAHp; Mon, 29 Jun 2020 08:20:42 -0700 X-Received: from EUR05-VI1-obe.outbound.protection.outlook.com (EUR05-VI1-obe.outbound.protection.outlook.com [40.107.21.89]) by mx.groups.io with SMTP id smtpd.web10.21282.1593444041448902057 for ; Mon, 29 Jun 2020 08:20:41 -0700 X-Received: from AM6PR10CA0027.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:209:89::40) by VI1PR08MB5423.eurprd08.prod.outlook.com (2603:10a6:803:133::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:38 +0000 X-Received: from VE1EUR03FT052.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:89:cafe::64) by AM6PR10CA0027.outlook.office365.com (2603:10a6:209:89::40) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:38 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61805+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT052.mail.protection.outlook.com (10.152.19.173) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:38 +0000 X-Received: ("Tessian outbound c90b0f113c0c:v60"); Mon, 29 Jun 2020 15:20:38 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: f63e136adb6ddc61 X-CR-MTA-TID: 64aa7808 X-Received: from abeff3509665.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 7BDB59DB-64B8-4779-830E-4A9957D97670.1; Mon, 29 Jun 2020 15:20:32 +0000 X-Received: from EUR02-HE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id abeff3509665.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:32 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dHxyVQLx/5FMuclKRFROQ+Ev2suD+LlMGrM5MEWNuJkEb2ayhZ2TPUYCN5JZGjmgE10KxTKkdWla95KAHOKwj6KY9PIygrhx5AtmpqVx6iLbect+sGGYw+JJfNBWEy59+0rwH+O/Mziz5QjLX1T/ENLli2EU4ppMxfebjZY96i016mvDVLs47d2PglzI6EO7HbRf/z1xgSYGmltn/Qq24txTFtPRjNGqAvP65fdnKmcA6Dimcrk8HvWrQWOcXmmbu26CXgdo8HiosTkAimovZ0F88/YQB1sA3GMN9SOf1Z9DjZ2Rx6RLHrhZl4q0lL5cM6jvz3WjtzsugZ3vqILz9A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=S4ByWxzWGNj6F35+mZt8fYRidD0l+nclh/3TRFMr/SM=; b=IuwmLxrWftC+bly4/cSvaHuriULNqdET8aiQF2skyjzJYcN8kgfTYbzTbZEfwflEIS0+GGXZfwm2le++0CduaYCNJA7wOiL7Vqut/YcgUTZjfVXUTD2sQrwWJfv8o7AC3vKPrcglqiYAFEABAyxnM5zaqOx0H2MpM4YXty5pu9l/Bwserq/A6AhfjnLZKuN1PdVF62uh/zWNTLYNyj8H8cvlMoGGipzl0CKxunlMDAWoXo3lDzJogvdgopYkLsIeoUkKRB7zgD/9lCiGLXFw5LkpBaCKRTcCBMKxzF5cl298lWJB0YygbFsS8iAb0v+MepmSvTOQWoiv4FcGDql26w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from DB8PR09CA0010.eurprd09.prod.outlook.com (2603:10a6:10:a0::23) by DB7PR08MB3100.eurprd08.prod.outlook.com (2603:10a6:5:28::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20; Mon, 29 Jun 2020 15:20:29 +0000 X-Received: from DB5EUR03FT035.eop-EUR03.prod.protection.outlook.com (2603:10a6:10:a0:cafe::33) by DB8PR09CA0010.outlook.office365.com (2603:10a6:10:a0::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:29 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by DB5EUR03FT035.mail.protection.outlook.com (10.152.20.65) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:29 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX04.Arm.com (10.251.24.32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:28 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:28 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 5/8] ShellPkg/AcpiView: Refactor PrintFieldName Date: Mon, 29 Jun 2020 16:20:05 +0100 Message-ID: <20200629152008.685-6-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(46966005)(82310400002)(186003)(83380400001)(81166007)(6666004)(2616005)(4326008)(5660300002)(47076004)(26005)(1076003)(498600001)(8676002)(8936002)(19627235002)(2906002)(36756003)(86362001)(426003)(6916009)(70586007)(356005)(336012)(54906003)(70206006);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 3be7e46f-9a54-4296-9adc-08d81c3ffa77 X-MS-TrafficTypeDiagnostic: DB7PR08MB3100:|VI1PR08MB5423: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:4941;OLM:4941; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: xvgD7TynB4+JHUemCWdAcP/vFTDicQWqGvHc+BQKSJhbgn0VKKQHCloMmQBSNPWIhAN6WUo6Y5ry+C6Girl5/HEca83RwB/10II0uf+M92kUysJAqwbP49Xgg42MpUk6iUueS4Q9A9h7qHtRV+hWZ1xUkt8szuq1bs2EaupUFweKZ/ieiTzd+rg20nIqNbB1iu26/+XTOGaqvL2rzf8omA5YZYV3UOzOt3g+vJfQOpTXmBtN2Fu2cnW3f6jiwJ3zDxafBBEHm+NvF9gQzaYNn2cSw7uxYuQxqgD1wRZCeCBqVR+Xx74iVJ62rtJIYN5nl+3hlaXxiguAjmJFbnvieLURsE7N0rT26zJU+CGqRKqwg6vOQ7vZd7oBsH1jCq+PrSFNweUTUQoiYUdC6IueRQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB3100 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT052.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 1543cffd-be2b-43eb-e59f-08d81c3ff55c X-Microsoft-Antispam-Message-Info: qiZOwX9EzrY1BPTvR65ufpdiNpQzESRNAshfoWQZaXkqaAiABPu4qiZiq9ZHI62tln+BMkTMsGuJj0rrhgbmrDqa4ogpbjGEk9C48D/ZOkTsZpA73+bFEoj/kCmZkcrD2b+lQ+k0cJhkVVBO5UwCUIYgm+qM0pVOD0PX9DYkVCow2cjiPo1fHiO+z/KSHH0ZeYXiohrmVjz122+FnEBxN9XK0sfWa2NNizIoOPyY//P1LvbUj8X6L1/fXNJX+hLpK9AnYiDAEBARh6BvLUMhkR6GbBhBVCyIuqLiSvvUHHuN7WEzC2FeEFXAXBECJI3Mqd828U3NJIXUANeDSEFnqkEIy4Zq50FfzMh0BOv3YKt7knE0/y3Mi+LK48KvWc3UpuV0WZrTbgkEC2/Btd1nug== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:38.2097 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 3be7e46f-9a54-4296-9adc-08d81c3ffa77 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT052.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB5423 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,Tomas.Pilar@arm.com X-Gm-Message-State: lqentoorUu0Lq3svKIW7QDLgx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444042; bh=BKZSQpLkPJDkZSFCtKO8Jv8ECUT2c8i6VjRV/Cz0F6E=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=utol5btO6+PzQ6WSgxRsLQqUK6YYm3YGh3dlnIa0OC2DdC+xrPSTy9jDZaUk0ZvFZFv 3yLrTN1ROk/vzRgaku3XlE51WzbJMNadJOqQ/A94EIfPQrb3tPcuUGYQX5QyNAwgPDC+s idi04MZuiT4qbMktSYqFVl5Kb0Q1xsJFRLk= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" The AcpiView core method is refactored to take format and parameters rather than a fully formatted string. This allows for far more flexible parser writing. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 30 ---------------- .../UefiShellAcpiViewCommandLib/AcpiParser.h | 19 ---------- .../UefiShellAcpiViewCommandLib/AcpiViewLog.c | 36 +++++++++++++++++++ .../UefiShellAcpiViewCommandLib/AcpiViewLog.h | 21 +++++++++++ .../Parsers/Dbg2/Dbg2Parser.c | 1 + .../Parsers/Fadt/FadtParser.c | 1 + .../Parsers/Iort/IortParser.c | 1 + .../Parsers/Pptt/PpttParser.c | 1 + .../Parsers/Slit/SlitParser.c | 1 + .../Parsers/Srat/SratParser.c | 1 + .../Parsers/Xsdt/XsdtParser.c | 1 + 11 files changed, 64 insertions(+), 49 deletions(-) diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index b88594cf3865..54d87e2768e1 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -13,8 +13,6 @@ #include "AcpiViewConfig.h" #include "AcpiViewLog.h" =20 -STATIC UINT32 gIndent; - STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; =20 /** @@ -390,34 +388,6 @@ Dump12Chars ( ); } =20 -/** - This function indents and prints the ACPI table Field Name. - - @param [in] Indent Number of spaces to add to the global table inde= nt. - The global table indent is 0 by default; however - this value is updated on entry to the ParseAcpi() - by adding the indent value provided to ParseAcpi= () - and restored back on exit. - Therefore the total indent in the output is - dependent on from where this function is called. - @param [in] FieldName Pointer to the Field Name. -**/ -VOID -EFIAPI -PrintFieldName ( - IN UINT32 Indent, - IN CONST CHAR16* FieldName -) -{ - Print ( - L"%*a%-*s : ", - gIndent + Indent, - "", - (OUTPUT_FIELD_COLUMN_WIDTH - gIndent - Indent), - FieldName - ); -} - /** This function is used to parse an ACPI table buffer. =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h index 84eae61c8889..eb0c74eef144 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h @@ -204,25 +204,6 @@ Dump12Chars ( IN UINT8* Ptr ); =20 -/** - This function indents and prints the ACPI table Field Name. - - @param [in] Indent Number of spaces to add to the global table - indent. The global table indent is 0 by default; - however this value is updated on entry to the - ParseAcpi() by adding the indent value provided = to - ParseAcpi() and restored back on exit. Therefore - the total indent in the output is dependent on f= rom - where this function is called. - @param [in] FieldName Pointer to the Field Name. -**/ -VOID -EFIAPI -PrintFieldName ( - IN UINT32 Indent, - IN CONST CHAR16* FieldName - ); - /** This function pointer is the template for customizing the trace output =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c b/S= hellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c index 9b9aaa855fdc..11fb9efe5e11 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.c @@ -26,6 +26,7 @@ static const CHAR16* mErrorTypeDesc [ACPI_ERROR_MAX] =3D { // Publicly accessible error and warning counters. UINT32 mTableErrorCount; UINT32 mTableWarningCount; +UINT32 gIndent; =20 /** Change the attributes of the standard output console @@ -228,3 +229,38 @@ AcpiViewLog ( RestoreColor (OriginalAttribute); } =20 +/** + This function indents and prints the ACPI table Field Name. + + @param [in] Indent Number of spaces to add to the global table inde= nt. + The global table indent is 0 by default; however + this value is updated on entry to the ParseAcpi() + by adding the indent value provided to ParseAcpi= () + and restored back on exit. + Therefore the total indent in the output is + dependent on from where this function is called. + @param [in] FieldName Pointer to the format string for field name. + @param [in] ... Variable List parameters to format. +**/ +VOID +EFIAPI +PrintFieldName ( + IN UINT32 Indent, + IN CONST CHAR16* FieldNameFormat, + ... + ) +{ + VA_LIST Marker; + CHAR16 Buffer[64]; + + VA_START(Marker, FieldNameFormat); + UnicodeVSPrint(Buffer, sizeof(Buffer), FieldNameFormat, Marker); + VA_END(Marker); + + AcpiViewOutput ( + L"%*a%-*s : ", + gIndent + Indent, + "", + (OUTPUT_FIELD_COLUMN_WIDTH - gIndent - Indent), + Buffer); +} diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h b/S= hellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h index 77049cd8eec2..7527a6546d54 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiViewLog.h @@ -42,6 +42,7 @@ typedef enum { // Publicly accessible error and warning counters. extern UINT32 mTableErrorCount; extern UINT32 mTableWarningCount; +extern UINT32 gIndent; =20 /** AcpiView output and logging function. Will log the event to @@ -212,6 +213,26 @@ CheckConstraintInternal ( CheckConstraintInternal ( \ __FILE__, __func__, __LINE__, #Constraint, Specification, Constraint, = ACPI_WARN) =20 +/** + This function indents and prints the ACPI table Field Name. + + @param [in] Indent Number of spaces to add to the global table inde= nt. + The global table indent is 0 by default; however + this value is updated on entry to the ParseAcpi() + by adding the indent value provided to ParseAcpi= () + and restored back on exit. + Therefore the total indent in the output is + dependent on from where this function is called. + @param [in] FieldName Pointer to the format string for field name. + @param [in] ... Variable List parameters to format. +**/ +VOID +EFIAPI +PrintFieldName ( + IN UINT32 Indent, + IN CONST CHAR16* FieldNameFormat, + ... + ); =20 // Maximum string size that can be printed #define MAX_OUTPUT_SIZE 256 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2Pa= rser.c index 9df111ecaa7d..dd69ed6992ba 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2Parser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2Parser.c @@ -12,6 +12,7 @@ #include #include "AcpiParser.h" #include "AcpiTableParser.h" +#include "AcpiViewLog.h" =20 // Local variables pointing to the table fields STATIC CONST UINT32* OffsetDbgDeviceInfo; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/Fadt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/FadtPa= rser.c index d86718bab67d..4734864dfdcf 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/FadtParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/FadtParser.c @@ -13,6 +13,7 @@ #include "AcpiParser.h" #include "AcpiTableParser.h" #include "AcpiView.h" +#include "AcpiViewLog.h" =20 // Local variables STATIC CONST UINT32* DsdtAddress; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/Iort= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/IortPa= rser.c index f7447947b230..356f355939aa 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/IortParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/IortParser.c @@ -14,6 +14,7 @@ #include "AcpiParser.h" #include "AcpiTableParser.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" =20 // Local variables STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/Pptt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/PpttPa= rser.c index acd2b81bb325..97a5203efb5f 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/PpttParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/PpttParser.c @@ -15,6 +15,7 @@ #include "AcpiView.h" #include "AcpiViewConfig.h" #include "PpttParser.h" +#include "AcpiViewLog.h" =20 // Local variables STATIC CONST UINT8* ProcessorTopologyStructureType; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/Slit= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/SlitPa= rser.c index e4625ee8b139..cedfc8a71849 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/SlitParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/SlitParser.c @@ -13,6 +13,7 @@ #include #include "AcpiParser.h" #include "AcpiTableParser.h" +#include "AcpiViewLog.h" =20 // Local Variables STATIC CONST UINT64* SlitSystemLocalityCount; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/Srat= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/SratPa= rser.c index b9b67820b89f..568a0400bf07 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/SratParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/SratParser.c @@ -14,6 +14,7 @@ #include "AcpiParser.h" #include "AcpiTableParser.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" =20 // Local Variables STATIC CONST UINT8* SratRAType; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/Xsdt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/XsdtPa= rser.c index e39061f8e261..771c4f322b8e 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/XsdtParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/XsdtParser.c @@ -13,6 +13,7 @@ #include #include "AcpiParser.h" #include "AcpiTableParser.h" +#include "AcpiViewLog.h" =20 // Local variables STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; --=20 2.24.1.windows.2 -=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 (#61805): https://edk2.groups.io/g/devel/message/61805 Mute This Topic: https://groups.io/mt/75193742/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61808+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593444050306254.94513276465648; Mon, 29 Jun 2020 08:20:50 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id e79GYY1788612xGWcdJUPkUs; Mon, 29 Jun 2020 08:20:50 -0700 X-Received: from EUR04-VI1-obe.outbound.protection.outlook.com (EUR04-VI1-obe.outbound.protection.outlook.com [40.107.8.41]) by mx.groups.io with SMTP id smtpd.web11.21344.1593444048803696610 for ; Mon, 29 Jun 2020 08:20:49 -0700 X-Received: from AM6PR10CA0070.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:209:80::47) by DB7PR08MB3899.eurprd08.prod.outlook.com (2603:10a6:10:7f::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:44 +0000 X-Received: from AM5EUR03FT039.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:80:cafe::18) by AM6PR10CA0070.outlook.office365.com (2603:10a6:209:80::47) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:44 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61808+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by AM5EUR03FT039.mail.protection.outlook.com (10.152.17.185) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:44 +0000 X-Received: ("Tessian outbound cea5956745d7:v60"); Mon, 29 Jun 2020 15:20:44 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 4fa805c0cb2dc487 X-CR-MTA-TID: 64aa7808 X-Received: from e754df136632.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 9B150B00-F1C2-431B-85E4-2815359F3FF8.1; Mon, 29 Jun 2020 15:20:39 +0000 X-Received: from EUR02-AM5-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id e754df136632.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:39 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=CiHPM1ogeVS+VgELuw24W9IQM/Cl8GCRp4FfTHBoSk80xqECsVReS4uXwvQE6SPjJnH+Cs7DDJfl+84XNSYwOpsXV7hu2f40et5ScJAQNmKk/r7dw0i9TDlfro2WfzMgIf1Ab8FGOV9GKqPsUnObTyOwpkhbMc5OLjXuV4tppt5g50yFsgTC2Ye2X4zLTd8g+m3AJ+9fmu02YeUUT2G3xO2VZrlp5s2177nY1fjay1s2Usowg7ESX0TtNuFMqCYfxZB/BvUe8do8CaDuAl/umQeMMxYpMHCiUrR6i85xP8eiNOm1aiqDpMmNw62u61YwViRRUK8o43OAPfTw6jWHdA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=zjCR12XLrDbTrz7k+SmvR/sOZ2ZE+5YWiE19xK6Rlsw=; b=kwsgfNfaWbE2jk+IGTpABQBrVIsD1ofc26vc/AGpbNnf3fGzCCdkHDA78KM6DBD25oepm8/2xtr4HOkWG0DU9r6GXrp5GGc19OSuF3yRptsk5eA5122Wi2Zpr41/FeAptkmoYbAIThFkfgTshLWShSmd0kOSz1n7o7G/vRLk6UmaxC6JKGPy4ftqIrxgJvin+U6m+gXkzbTDbwDNcTh0P2m1lbtJOT2BuLPaI0MhjXiAzKzZsgrvZuYxNZXYNKvugtAhwJFByeFHBQoLxa4RoVfzPVZhy4FJ/3emJh4mQJsIkxm7e1vha9rEbOylnudyoLIguOqw7FHkDXSFm8gp6Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from AM6P194CA0066.EURP194.PROD.OUTLOOK.COM (2603:10a6:209:84::43) by VI1PR08MB5519.eurprd08.prod.outlook.com (2603:10a6:803:133::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:37 +0000 X-Received: from VE1EUR03FT064.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:84:cafe::89) by AM6P194CA0066.outlook.office365.com (2603:10a6:209:84::43) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:37 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by VE1EUR03FT064.mail.protection.outlook.com (10.152.19.210) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:37 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX03.Arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:28 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:28 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 6/8] ShellPkg/AcpiView: Refactor dump helpers Date: Mon, 29 Jun 2020 16:20:06 +0100 Message-ID: <20200629152008.685-7-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(136003)(346002)(376002)(39860400002)(396003)(46966005)(426003)(2616005)(4326008)(6666004)(186003)(2906002)(1076003)(19627235002)(5660300002)(336012)(316002)(54906003)(30864003)(36756003)(26005)(70586007)(8936002)(47076004)(82740400003)(82310400002)(81166007)(70206006)(6916009)(8676002)(86362001)(478600001)(356005)(83380400001);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 58dea857-f574-47d4-d16d-08d81c3ffe2d X-MS-TrafficTypeDiagnostic: VI1PR08MB5519:|DB7PR08MB3899: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:8882;OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: n4Xa3PqQty1e2xGw65H3alinPKRaSj6mmMUcBxxgNYUsXRafW3UViLPyYgcqQNyuC/+5BJ6xNeQ5RGSydXePb/OKjq9Ly4XrOdY+pnlRZaZZy8YWm7ax9VEjsdC0Wta5C0k5V0/j2eq33YsKRKDZXkJuOGmA+cForq6dootdRiULh0fXMnv+X3pwY2Ywp99kHtejvPtgjiVgswiGoQvISXZJZjJZQul9qxnksKxRhNDmklz/luia1umWFdoGB8lVv0HhZIAkvF5dS9SUW+S1m/KnFXg5SO7TKfCYF+6G9NKtD0U9Ipq0CXmkFfG0VZ1dwuM0TVrrMcsFE9QsBRZWnI9DYBp12BWt3qUxc/vfC3ntbt+LCDYKVG/D7mTZX8SCSjl9m6OVvDQW+BMuMMvEPA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB5519 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM5EUR03FT039.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 4ce124ac-c9cd-4d32-708f-08d81c3ff9cd X-Microsoft-Antispam-Message-Info: J2FDLtMaXqO2+1JDUzAlgycv7o0/2otYjfE98BxleaFQEP9pIBgVwSaailEKHSM5//Ccqgm3A/sep6sbGDwcxQf9OAzHyT7jV2WEJGTV5ORinll/48FMP+GzwJ1GPm2StvhmPJ6IVqj81Is9v5WQ9pkyvJoprscs57bsj5mqyhWy4P0JBWLQgTxHbGKXWcrRaYOg9Rpeg6Z6/hw9/xNnnLcSW4AbEm0hYyoPrdAHbsla8wgX0ANBBAwFGOnG9PAQ+pSUjvye7qMnQMNNTlGF9FrJ6x9ebvEAqmVpLWaLh67FrYByz9ohrMb0voxUhLvXqOCWKRpRStvh0OWObeLSJIWLyLVBKUu6l+1DPasvEjT+HHIkQYlwZufwVpTCvTD6uXV/+cjyddpMxh5hNReO9w== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:44.5039 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 58dea857-f574-47d4-d16d-08d81c3ffe2d X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: AM5EUR03FT039.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB3899 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,Tomas.Pilar@arm.com X-Gm-Message-State: njnKHcyeBTK2Xpm79y2RNLh4x1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444050; bh=1OAYnIWYIkbsr2OGILlVkXkemVqlbRJ3oNTh2SpAedw=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=ehTVIma1e/LLia4KiBjbLrrVlVUWrIklIbbrdFF4AjdPv0qSmz8JLyqaQieJNx47PKT P02MZmxzk5J9IcBGeHc2VZV1ojAkhlq3ocoOVVBLUmaUiYwW/Pc8IIJ+VQJlClKds+BPe xMFmIuMN3XhIrhVeUAbaqufIehOE3rwduzk= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" The dump variable helper functions are refactored into a separate header file as inline functions to declutter code. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 212 --------------- .../UefiShellAcpiViewCommandLib/AcpiParser.h | 134 +--------- .../FieldFormatHelper.h | 244 ++++++++++++++++++ .../UefiShellAcpiViewCommandLib.inf | 1 + 4 files changed, 247 insertions(+), 344 deletions(-) create mode 100644 ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldForma= tHelper.h diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index 54d87e2768e1..65108e25ff96 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -176,218 +176,6 @@ DumpRaw ( Print (L" %a\n\n", AsciiBuffer); } =20 -/** - This function traces 1 byte of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint8 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - Print (Format, *Ptr); -} - -/** - This function traces 2 bytes of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint16 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - Print (Format, *(UINT16*)Ptr); -} - -/** - This function traces 4 bytes of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint32 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - Print (Format, *(UINT32*)Ptr); -} - -/** - This function traces 8 bytes of data as specified by the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint64 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - // Some fields are not aligned and this causes alignment faults - // on ARM platforms if the compiler generates LDRD instructions. - // Perform word access so that LDRD instructions are not generated. - UINT64 Val; - - Val =3D *(UINT32*)(Ptr + sizeof (UINT32)); - - Val =3D LShiftU64(Val,32); - Val |=3D (UINT64)*(UINT32*)Ptr; - - Print (Format, Val); -} - -/** - This function traces 3 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump3Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ) -{ - Print ( - (Format !=3D NULL) ? Format : L"%c%c%c", - Ptr[0], - Ptr[1], - Ptr[2] - ); -} - -/** - This function traces 4 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump4Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ) -{ - Print ( - (Format !=3D NULL) ? Format : L"%c%c%c%c", - Ptr[0], - Ptr[1], - Ptr[2], - Ptr[3] - ); -} - -/** - This function traces 6 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump6Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ) -{ - Print ( - (Format !=3D NULL) ? Format : L"%c%c%c%c%c%c", - Ptr[0], - Ptr[1], - Ptr[2], - Ptr[3], - Ptr[4], - Ptr[5] - ); -} - -/** - This function traces 8 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump8Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ) -{ - Print ( - (Format !=3D NULL) ? Format : L"%c%c%c%c%c%c%c%c", - Ptr[0], - Ptr[1], - Ptr[2], - Ptr[3], - Ptr[4], - Ptr[5], - Ptr[6], - Ptr[7] - ); -} - -/** - This function traces 12 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump12Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ) -{ - Print ( - (Format !=3D NULL) ? Format : L"%c%c%c%c%c%c%c%c%c%c%c%c", - Ptr[0], - Ptr[1], - Ptr[2], - Ptr[3], - Ptr[4], - Ptr[5], - Ptr[6], - Ptr[7], - Ptr[8], - Ptr[9], - Ptr[10], - Ptr[11] - ); -} - /** This function is used to parse an ACPI table buffer. =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h index eb0c74eef144..54ce44132055 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h @@ -8,6 +8,8 @@ #ifndef ACPIPARSER_H_ #define ACPIPARSER_H_ =20 +#include "FieldFormatHelper.h" + #define OUTPUT_FIELD_COLUMN_WIDTH 36 =20 /// The RSDP table signature is "RSD PTR " (8 bytes) @@ -72,138 +74,6 @@ DumpRaw ( IN UINT32 Length ); =20 -/** - This function traces 1 byte of datum as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint8 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ); - -/** - This function traces 2 bytes of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint16 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ); - -/** - This function traces 4 bytes of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint32 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ); - -/** - This function traces 8 bytes of data as specified by the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -DumpUint64 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ); - -/** - This function traces 3 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump3Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ); - -/** - This function traces 4 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump4Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ); - -/** - This function traces 6 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump6Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ); - -/** - This function traces 8 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump8Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ); - -/** - This function traces 12 characters which can be optionally - formated using the format string if specified. - - If no format string is specified the Format must be NULL. - - @param [in] Format Optional format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -VOID -EFIAPI -Dump12Chars ( - IN CONST CHAR16* Format OPTIONAL, - IN UINT8* Ptr - ); - /** This function pointer is the template for customizing the trace output =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper= .h b/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper.h new file mode 100644 index 000000000000..25c70652806c --- /dev/null +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper.h @@ -0,0 +1,244 @@ +/** @file + Formatting functions used in parser definitions + + Copyright (c) 2020, ARM Limited. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#ifndef FIELD_FORMAT_HELPER_H_ +#define FIELD_FORMAT_HELPER_H_ + +#include +#include + +/** + This function traces 1 byte of data as specified in the format string. + + @param [in] Format The format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +DumpUint8 ( + IN CONST CHAR16* Format, + IN UINT8* Ptr + ) +{ + Print (Format, *Ptr); +} + +/** + This function traces 2 bytes of data as specified in the format string. + + @param [in] Format The format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +DumpUint16 ( + IN CONST CHAR16* Format, + IN UINT8* Ptr + ) +{ + Print (Format, *(UINT16*)Ptr); +} + +/** + This function traces 4 bytes of data as specified in the format string. + + @param [in] Format The format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +DumpUint32 ( + IN CONST CHAR16* Format, + IN UINT8* Ptr + ) +{ + Print (Format, *(UINT32*)Ptr); +} + +/** + This function traces 8 bytes of data as specified by the format string. + + @param [in] Format The format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +DumpUint64 ( + IN CONST CHAR16* Format, + IN UINT8* Ptr + ) +{ + // Some fields are not aligned and this causes alignment faults + // on ARM platforms if the compiler generates LDRD instructions. + // Perform word access so that LDRD instructions are not generated. + UINT64 Val; + + Val =3D *(UINT32*)(Ptr + sizeof (UINT32)); + + Val =3D LShiftU64(Val,32); + Val |=3D (UINT64)*(UINT32*)Ptr; + + Print (Format, Val); +} + +/** + This function traces 3 characters which can be optionally + formated using the format string if specified. + + If no format string is specified the Format must be NULL. + + @param [in] Format Optional format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +Dump3Chars ( + IN CONST CHAR16* Format OPTIONAL, + IN UINT8* Ptr + ) +{ + Print ( + (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c", + Ptr[0], + Ptr[1], + Ptr[2] + ); +} + +/** + This function traces 4 characters which can be optionally + formated using the format string if specified. + + If no format string is specified the Format must be NULL. + + @param [in] Format Optional format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +Dump4Chars ( + IN CONST CHAR16* Format OPTIONAL, + IN UINT8* Ptr + ) +{ + Print ( + (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c", + Ptr[0], + Ptr[1], + Ptr[2], + Ptr[3] + ); +} + +/** + This function traces 6 characters which can be optionally + formated using the format string if specified. + + If no format string is specified the Format must be NULL. + + @param [in] Format Optional format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +Dump6Chars ( + IN CONST CHAR16* Format OPTIONAL, + IN UINT8* Ptr + ) +{ + Print ( + (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c%c%c", + Ptr[0], + Ptr[1], + Ptr[2], + Ptr[3], + Ptr[4], + Ptr[5] + ); +} + +/** + This function traces 8 characters which can be optionally + formated using the format string if specified. + + If no format string is specified the Format must be NULL. + + @param [in] Format Optional format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +Dump8Chars ( + IN CONST CHAR16* Format OPTIONAL, + IN UINT8* Ptr + ) +{ + Print ( + (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c%c%c%c%c", + Ptr[0], + Ptr[1], + Ptr[2], + Ptr[3], + Ptr[4], + Ptr[5], + Ptr[6], + Ptr[7] + ); +} + +/** + This function traces 12 characters which can be optionally + formated using the format string if specified. + + If no format string is specified the Format must be NULL. + + @param [in] Format Optional format string for tracing the data. + @param [in] Ptr Pointer to the start of the buffer. +**/ +static +inline +VOID +EFIAPI +Dump12Chars ( + IN CONST CHAR16* Format OPTIONAL, + IN UINT8* Ptr + ) +{ + Print ( + (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c%c%c%c%c%c%c%c= %c", + Ptr[0], + Ptr[1], + Ptr[2], + Ptr[3], + Ptr[4], + Ptr[5], + Ptr[6], + Ptr[7], + Ptr[8], + Ptr[9], + Ptr[10], + Ptr[11] + ); +} + +#endif diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiView= CommandLib.inf b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpi= ViewCommandLib.inf index e0586cbccec2..271d09a940ee 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.inf +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/UefiShellAcpiViewCommand= Lib.inf @@ -29,6 +29,7 @@ [Sources.common] AcpiViewConfig.h AcpiViewLog.h AcpiViewLog.c + FieldFormatHelper.h Parsers/Bgrt/BgrtParser.c Parsers/Dbg2/Dbg2Parser.c Parsers/Dsdt/DsdtParser.c --=20 2.24.1.windows.2 -=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 (#61808): https://edk2.groups.io/g/devel/message/61808 Mute This Topic: https://groups.io/mt/75193748/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61810+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 159344405155469.66069147122346; Mon, 29 Jun 2020 08:20:51 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id SisOYY1788612xdv4uSZ4B5F; Mon, 29 Jun 2020 08:20:51 -0700 X-Received: from EUR04-HE1-obe.outbound.protection.outlook.com (EUR04-HE1-obe.outbound.protection.outlook.com [40.107.7.82]) by mx.groups.io with SMTP id smtpd.web12.21086.1593444049218695736 for ; Mon, 29 Jun 2020 08:20:49 -0700 X-Received: from AM5PR04CA0005.eurprd04.prod.outlook.com (2603:10a6:206:1::18) by AM6PR08MB3125.eurprd08.prod.outlook.com (2603:10a6:209:46::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:45 +0000 X-Received: from VE1EUR03FT056.eop-EUR03.prod.protection.outlook.com (2603:10a6:206:1:cafe::e9) by AM5PR04CA0005.outlook.office365.com (2603:10a6:206:1::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:45 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61810+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT056.mail.protection.outlook.com (10.152.19.28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:45 +0000 X-Received: ("Tessian outbound fcb8da16d5bd:v60"); Mon, 29 Jun 2020 15:20:45 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 0ec8cf6a0ce0c287 X-CR-MTA-TID: 64aa7808 X-Received: from b3c057d5a931.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 9F9A15F9-B1D9-498E-A033-14FE564086CC.1; Mon, 29 Jun 2020 15:20:39 +0000 X-Received: from EUR05-AM6-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id b3c057d5a931.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:39 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=m20KtdLpsOmoGiC30fUGGjAeIgD14/vq+GhpAVdt6ppn7peHVVaB6BI2thhfKb6BcEB2Ib9AEpVOBSJB6arkGqwwdKCuUEWFXd2sPh9EtwsnBH2bPk225vEI/EDR+7SW6Qv0bGyrZRPwHz4BQRUFdPGF5gmD5bRt0OJ1HtmjgL/a8/835sNl4LkH3WdxjGhBhaBoGgA7VX8pCCnKz4oH0dQwRROdT+nkpbUI6nGTAP1oGPqsPGCoWdtWhSO97PulRizLZTmPvoeqQ8pNSI+G5zynm3YOeimN4fGYZbn5psoDhwMS7u4abXET8kpVuTLeSZaSNdMd+/WZmJHVmgOo7Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=olEpI91Uh6WIjeGwzlRuxAy1zfVIHq3sd46vmdvhgFA=; b=hh8FWerxGf2wiiTwAu7HMUwwQLLvW0s4A09/hvBGfqwviida07XEn+GWK+LxgUiKrFDyJeVxVa/vlglUOsEWnogVrk5eEzfVbvQEbTxXnqrJePc3E+C5YI94sqvNjNxNCxc79KM4ttcQ1k3sr4X56Hz+xKK8TrTo6YioAom1JyIflk6HnFw6ydZem8PgUnRZK993oWxaMAxTSDASMKCHuRoOEb+r5sFe2LNTUGjNAb5chABq6MaYE+SrJ4DUQd5Gii3m5XuPRPm1jeRRvCu7aKUR1UGMvTJdEyU01XGDaEaLeAIxVE4wXHkRvghWtylq0SgfAzN/l//RhIL4SJ2uDQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from AM6P194CA0037.EURP194.PROD.OUTLOOK.COM (2603:10a6:209:84::14) by VI1PR08MB5488.eurprd08.prod.outlook.com (2603:10a6:803:137::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21; Mon, 29 Jun 2020 15:20:38 +0000 X-Received: from VE1EUR03FT064.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:84:cafe::ef) by AM6P194CA0037.outlook.office365.com (2603:10a6:209:84::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:37 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by VE1EUR03FT064.mail.protection.outlook.com (10.152.19.210) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:37 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX03.Arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:29 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:29 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 7/8] ShellPkg/AcpiView: Refactor AcpiView Date: Mon, 29 Jun 2020 16:20:07 +0100 Message-ID: <20200629152008.685-8-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(346002)(376002)(136003)(396003)(39860400002)(46966005)(86362001)(426003)(478600001)(47076004)(1076003)(8936002)(356005)(36756003)(6666004)(8676002)(82310400002)(5660300002)(2616005)(83380400001)(316002)(2906002)(81166007)(70206006)(70586007)(30864003)(54906003)(82740400003)(186003)(336012)(26005)(4326008)(6916009);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 89a1d1a6-f3a6-4e0b-f5fc-08d81c3ffe97 X-MS-TrafficTypeDiagnostic: VI1PR08MB5488:|AM6PR08MB3125: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:8273;OLM:8273; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: Sv5kEx/gtjD2hPaYQQOwLHS0eCP8ytObTtqYramyMk9MNza8xsjZJazXTr79I+eA3Uyg6Jv3Do92CIsvueF0Jiuug4EbnCoo391LclIcE6irzOEvIDv5XuTgTYjtft5XGGP+wqTyjkR2RrASqCyfS0nVGkF7Vevpzs9uL9eCqyYGB6M0fnwmdwMIEpzsTc/tBZPmvPsUnwV4uUb5qpeswVzU5yhS+6Xse4YQbsP3mqgoxM79U8ugGEwULvqVy0e1fo4j9aSnZ5Y375+cNLX+ziEHrcXa45q4NqOo2f3u80Zs9wnap4vy6oS07/Nu329yyOtP3nSMl0PJzDbgMjCKNe8nXZcKgLnzBCIN8Bmhxz0cWaxR3haeyV1YERT+0qq78peHfCZWZNLUhZB62XSwGQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB5488 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT056.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: ee6ec07e-942d-4b86-84e2-08d81c3ffa21 X-Microsoft-Antispam-Message-Info: rnmk/LA8Iq7E2QedSIH6FnUUw8JR9Y3aKApuvHgDDNgPf2/sD0qFhFkKGTDO3fasJo3ByXnMVI0hEy5vwM1sAOvJTQxkR+oEhELuSwG08Lxg3bwh4kgDKM24qVnSiiEuifZk/Uo+MVSDFL72ah2dMAqSRk4VSF7IZhiIHejNs12TPPEsA9XVO59tESlRy7Njrf+4FSr0/I9/zRq97Qaox7yZW0Az2YIvGgOxufD+NdRUmXdIeRky6VhWh2cR9pWoJXQd6BbzyzOK0X4z/c1UrQxc9gMoAf4TG4G8EBPVoM6Ab1hjEzNmcjQSM73iVCIguldjEaoKBkDS3ZyZqqvO486CiufUui1a9GovglIAShDTyHiZhp98mG2UlIm6l1TOBfR+uQ9mhFd7xZAWTF9uHw== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:45.1255 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 89a1d1a6-f3a6-4e0b-f5fc-08d81c3ffe97 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT056.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR08MB3125 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,Tomas.Pilar@arm.com X-Gm-Message-State: Yh6O6Grns9k3KM5eFnRuWZ0cx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444051; bh=SJHhjS8Os9uGhZShywx5unbIvYZvr0tFrpTtflsBPoQ=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=Yjt3W2A4oeNoMn9iPD1x4hk2uRTDH9veqOe2gyxawaCdJ3jo2ex8/dZ0iCtoRhNPtG0 v/rVVghKkqE+NnitbsTtTgFe0GVF3YAno5+k/ISoT3X9iqMwRsRQuEVRpz5dRjh4vQOki rSr0X04ma/taqNwGBUkzM94hFGqUvsBI9dA= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Refactor logging using the AcpiViewLog facility. Trim some of the source to more elegant state. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 224 ++++++++---------- .../UefiShellAcpiViewCommandLib/AcpiParser.h | 6 +- .../AcpiTableParser.c | 52 ++-- .../AcpiTableParser.h | 2 +- .../UefiShellAcpiViewCommandLib/AcpiView.c | 187 +++++---------- .../FieldFormatHelper.h | 106 +-------- 6 files changed, 187 insertions(+), 390 deletions(-) diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index 65108e25ff96..9bbf724dfdfe 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -8,6 +8,8 @@ #include #include #include +#include +#include #include "AcpiParser.h" #include "AcpiView.h" #include "AcpiViewConfig.h" @@ -46,6 +48,7 @@ IncrementWarningCount ( mTableWarningCount++; } =20 + /** This function verifies the ACPI table checksum. =20 @@ -69,12 +72,7 @@ VerifyChecksum ( { UINTN ByteCount; UINT8 Checksum; - UINTN OriginalAttribute; =20 - // - // set local variables to suppress incorrect compiler/analyzer warnings - // - OriginalAttribute =3D 0; ByteCount =3D 0; Checksum =3D 0; =20 @@ -84,29 +82,10 @@ VerifyChecksum ( } =20 if (Log) { - OriginalAttribute =3D gST->ConOut->Mode->Attribute; if (Checksum =3D=3D 0) { - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute ( - gST->ConOut, - EFI_TEXT_ATTR (EFI_GREEN, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4)) - ); - } - Print (L"Table Checksum : OK\n\n"); + AcpiLog (ACPI_GOOD, L"Table Checksum : OK\n"); } else { - IncrementErrorCount (); - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute ( - gST->ConOut, - EFI_TEXT_ATTR (EFI_RED, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4)) - ); - } - Print (L"Table Checksum : FAILED (0x%X)\n\n", Checksum); - } - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); + AcpiError (ACPI_ERROR_CSUM, L"Table Checksum (0x%X !=3D 0)\n", Check= sum); } } =20 @@ -127,53 +106,101 @@ DumpRaw ( ) { UINTN ByteCount; - UINTN PartLineChars; - UINTN AsciiBufferIndex; CHAR8 AsciiBuffer[17]; + CHAR8 HexBuffer[128]; + CHAR8 *HexCursor; =20 ByteCount =3D 0; - AsciiBufferIndex =3D 0; =20 - Print (L"Address : 0x%p\n", Ptr); - Print (L"Length : %d\n", Length); + AcpiInfo (L"Address : 0x%p", Ptr); + AcpiInfo (L"Length : %d\n", Length); =20 while (ByteCount < Length) { - if ((ByteCount & 0x0F) =3D=3D 0) { - AsciiBuffer[AsciiBufferIndex] =3D '\0'; - Print (L" %a\n%08X : ", AsciiBuffer, ByteCount); - AsciiBufferIndex =3D 0; - } else if ((ByteCount & 0x07) =3D=3D 0) { - Print (L"- "); + + // Reset ascii and hex strings + if (ByteCount % 16 =3D=3D 0) { + HexCursor =3D HexBuffer; + ZeroMem (AsciiBuffer, sizeof(AsciiBuffer)); + ZeroMem (HexBuffer, sizeof(HexBuffer)); + } else if (ByteCount % 8 =3D=3D 0) { + HexCursor +=3D AsciiSPrint (HexCursor, sizeof(HexBuffer), "- "); } =20 + // Add hex couplet to hex buffer + HexCursor +=3D AsciiSPrint (HexCursor, sizeof(HexBuffer), "%02X ", *Pt= r); + + // Add ascii letter to the ascii buffer + AsciiBuffer[ByteCount & 0xF] =3D '.'; if ((*Ptr >=3D ' ') && (*Ptr < 0x7F)) { - AsciiBuffer[AsciiBufferIndex++] =3D *Ptr; - } else { - AsciiBuffer[AsciiBufferIndex++] =3D '.'; + AsciiBuffer[ByteCount & 0xF] =3D *Ptr; } =20 - Print (L"%02X ", *Ptr++); + // Print line with fixed width hex part + if (ByteCount % 16 =3D=3D 15) { + AcpiInfo (L"%08X : %-.*a %a", ByteCount + 1, 46, HexBuffer, AsciiBuf= fer); + } =20 ByteCount++; + Ptr++; } =20 - // Justify the final line using spaces before printing - // the ASCII data. - PartLineChars =3D (Length & 0x0F); - if (PartLineChars !=3D 0) { - PartLineChars =3D 48 - (PartLineChars * 3); - if ((Length & 0x0F) <=3D 8) { - PartLineChars +=3D 2; - } - while (PartLineChars > 0) { - Print (L" "); - PartLineChars--; + // Print the last line + if (ByteCount % 16 !=3D 15) { + AcpiInfo ( + L"%08X : %-*a %.*a", + (ByteCount + 16) & ~0xF, + 46, + HexBuffer, + ByteCount & 0xF, + AsciiBuffer); } +} + +/** + Prints an arbitrary variable to screen using a given parser. + Also calls the internal validator if it exists. + + @param[in] Parser The parser to use to print to screen + @param[in] Prt Pointer to variable that should be printed +**/ +STATIC +VOID +EFIAPI +DumpAndValidate( + IN CONST ACPI_PARSER* Parser, + IN VOID* Ptr + ) +{ + // if there is a Formatter function let the function handle + // the printing else if a Format is specified in the table use + // the Format for printing + PrintFieldName (2, Parser->NameStr); + if (Parser->PrintFormatter !=3D NULL) { + Parser->PrintFormatter(Parser->Format, Ptr); + } else if (Parser->Format !=3D NULL) { + switch (Parser->Length) { + case 1: + AcpiInfo (Parser->Format, *(UINT8 *)Ptr); + break; + case 2: + AcpiInfo (Parser->Format, ReadUnaligned16 ((CONST UINT16 *)Ptr)); + break; + case 4: + AcpiInfo (Parser->Format, ReadUnaligned32 ((CONST UINT32 *)Ptr)); + break; + case 8: + AcpiInfo (Parser->Format, ReadUnaligned64 ((CONST UINT64 *)Ptr)); + break; + default: + AcpiLog (ACPI_BAD, L""); + } // switch } =20 - // Print ASCII data for the final line. - AsciiBuffer[AsciiBufferIndex] =3D '\0'; - Print (L" %a\n\n", AsciiBuffer); + // Validating only makes sense if we are tracing + // the parsed table entries, to report by table name. + if (mConfig.ConsistencyCheck && (Parser->FieldValidator !=3D NULL)) { + Parser->FieldValidator(Ptr, Parser->Context); + } } =20 /** @@ -216,39 +243,25 @@ ParseAcpi ( { UINT32 Index; UINT32 Offset; - UINTN OriginalAttribute; =20 - // - // set local variables to suppress incorrect compiler/analyzer warnings - // - OriginalAttribute =3D 0; - Offset =3D 0; + if (Length =3D=3D 0) { + AcpiLog ( + ACPI_WARN, + L"Will not parse zero-length buffer <%a>=3D%p", + AsciiName ? AsciiName : "Unknown Item", + Ptr); + return 0; + } =20 // Increment the Indent gIndent +=3D Indent; =20 if (Trace && (AsciiName !=3D NULL)){ - - if (mConfig.ColourHighlighting) { - OriginalAttribute =3D gST->ConOut->Mode->Attribute; - gST->ConOut->SetAttribute ( - gST->ConOut, - EFI_TEXT_ATTR(EFI_YELLOW, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4)) - ); - } - Print ( - L"%*a%-*a :\n", - gIndent, - "", - (OUTPUT_FIELD_COLUMN_WIDTH - gIndent), - AsciiName - ); - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); - } + AcpiLog ( + ACPI_ITEM, L"%*.a%a", gIndent, "", AsciiName); } =20 + Offset =3D 0; for (Index =3D 0; Index < ParserItems; Index++) { if ((Offset + Parser[Index].Length) > Length) { =20 @@ -263,10 +276,8 @@ ParseAcpi ( } =20 if (mConfig.ConsistencyCheck && (Offset !=3D Parser[Index].Offset)) { - IncrementErrorCount (); - Print ( - L"\nERROR: %a: Offset Mismatch for %s\n" - L"CurrentOffset =3D %d FieldOffset =3D %d\n", + AcpiError (ACPI_ERROR_PARSE, + L"%a: Offset Mismatch for %s (%d !=3D %d)", AsciiName, Parser[Index].NameStr, Offset, @@ -275,48 +286,13 @@ ParseAcpi ( } =20 if (Trace) { - // if there is a Formatter function let the function handle - // the printing else if a Format is specified in the table use - // the Format for printing - PrintFieldName (2, Parser[Index].NameStr); - if (Parser[Index].PrintFormatter !=3D NULL) { - Parser[Index].PrintFormatter (Parser[Index].Format, Ptr); - } else if (Parser[Index].Format !=3D NULL) { - switch (Parser[Index].Length) { - case 1: - DumpUint8 (Parser[Index].Format, Ptr); - break; - case 2: - DumpUint16 (Parser[Index].Format, Ptr); - break; - case 4: - DumpUint32 (Parser[Index].Format, Ptr); - break; - case 8: - DumpUint64 (Parser[Index].Format, Ptr); - break; - default: - Print ( - L"\nERROR: %a: CANNOT PARSE THIS FIELD, Field Length =3D %d\= n", - AsciiName, - Parser[Index].Length - ); - } // switch - - // Validating only makes sense if we are tracing - // the parsed table entries, to report by table name. - if (mConfig.ConsistencyCheck && (Parser[Index].FieldValidator !=3D= NULL)) { - Parser[Index].FieldValidator (Ptr, Parser[Index].Context); - } - } - Print (L"\n"); - } // if (Trace) + DumpAndValidate (&Parser[Index], &Ptr[Offset]); + } =20 if (Parser[Index].ItemPtr !=3D NULL) { - *Parser[Index].ItemPtr =3D (VOID*)Ptr; + *Parser[Index].ItemPtr =3D Ptr + Offset; } =20 - Ptr +=3D Parser[Index].Length; Offset +=3D Parser[Index].Length; } // for =20 @@ -355,7 +331,7 @@ DumpGasStruct ( IN UINT32 Length ) { - Print (L"\n"); + AcpiInfo(L""); return ParseAcpi ( TRUE, Indent, @@ -421,7 +397,7 @@ DumpAcpiHeader ( UINT32 EFIAPI ParseAcpiHeader ( - IN UINT8* Ptr, + IN VOID* Ptr, OUT CONST UINT32** Signature, OUT CONST UINT32** Length, OUT CONST UINT8** Revision diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h index 54ce44132055..bd3cdb774fb5 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h @@ -18,10 +18,6 @@ /// that allows us to process the log options. #define RSDP_TABLE_INFO SIGNATURE_32('R', 'S', 'D', 'P') =20 -// Publicly accessible error and warning counters. -extern UINT32 mTableErrorCount; -extern UINT32 mTableWarningCount; - /** This function increments the ACPI table error counter. **/ @@ -310,7 +306,7 @@ DumpAcpiHeader ( UINT32 EFIAPI ParseAcpiHeader ( - IN UINT8* Ptr, + IN VOID* Ptr, OUT CONST UINT32** Signature, OUT CONST UINT32** Length, OUT CONST UINT8** Revision diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c= b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c index 526cb8cb7cad..49acb3d03da1 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.c @@ -18,6 +18,7 @@ #include "AcpiTableParser.h" #include "AcpiView.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) #include "Arm/SbbrValidator.h" @@ -179,61 +180,43 @@ GetParser ( VOID EFIAPI ProcessAcpiTable ( - IN UINT8* Ptr + IN VOID* Ptr ) { EFI_STATUS Status; BOOLEAN Trace; - CONST UINT32* AcpiTableSignature; - CONST UINT32* AcpiTableLength; - CONST UINT8* AcpiTableRevision; - CONST UINT8* SignaturePtr; + CONST UINT32* Signature; + CONST UINT32* Length; + CONST UINT8* Revision; PARSE_ACPI_TABLE_PROC ParserProc; =20 - ParseAcpiHeader ( - Ptr, - &AcpiTableSignature, - &AcpiTableLength, - &AcpiTableRevision - ); + ParseAcpiHeader (Ptr, &Signature, &Length, &Revision); =20 - Trace =3D ProcessTableReportOptions ( - *AcpiTableSignature, - Ptr, - *AcpiTableLength - ); + Trace =3D ProcessTableReportOptions (*Signature, Ptr, *Length); =20 if (Trace) { - DumpRaw (Ptr, *AcpiTableLength); + DumpRaw (Ptr, *Length); =20 // Do not process the ACPI table any further if the table length read // is invalid. The ACPI table should at least contain the table header. - if (*AcpiTableLength < sizeof (EFI_ACPI_DESCRIPTION_HEADER)) { - SignaturePtr =3D (CONST UINT8*)AcpiTableSignature; - IncrementErrorCount (); - Print ( - L"ERROR: Invalid %c%c%c%c table length. Length =3D %d\n", - SignaturePtr[0], - SignaturePtr[1], - SignaturePtr[2], - SignaturePtr[3], - *AcpiTableLength - ); + if (*Length < sizeof (EFI_ACPI_DESCRIPTION_HEADER)) { + AcpiError ( + ACPI_ERROR_LENGTH, L"Table %4a invalid length %d", Signature, *Len= gth); return; } =20 if (mConfig.ConsistencyCheck) { - VerifyChecksum (TRUE, Ptr, *AcpiTableLength); + VerifyChecksum (TRUE, Ptr, *Length); } } =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) if (mConfig.MandatoryTableValidate) { - ArmSbbrIncrementTableCount (*AcpiTableSignature); + ArmSbbrIncrementTableCount (*Signature); } #endif =20 - Status =3D GetParser (*AcpiTableSignature, &ParserProc); + Status =3D GetParser (*Signature, &ParserProc); if (EFI_ERROR (Status)) { // No registered parser found, do default handling. if (Trace) { @@ -242,10 +225,5 @@ ProcessAcpiTable ( return; } =20 - ParserProc ( - Trace, - Ptr, - *AcpiTableLength, - *AcpiTableRevision - ); + ParserProc (Trace, Ptr, *Length, *Revision); } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.h= b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.h index 4f92596b90a6..e2afeda2379c 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiTableParser.h @@ -101,7 +101,7 @@ DeregisterParser ( VOID EFIAPI ProcessAcpiTable ( - IN UINT8* Ptr + IN VOID* Ptr ); =20 /** diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c b/Shel= lPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c index e25e0712948b..64caff6ab0fe 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiView.c @@ -10,6 +10,8 @@ - Arm Server Base Boot Requirements 1.2, September 2019 **/ =20 +#include + #include #include #include @@ -22,6 +24,7 @@ #include "AcpiTableParser.h" #include "AcpiView.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) #include "Arm/SbbrValidator.h" @@ -59,7 +62,7 @@ DumpAcpiTableToFile ( mBinTableCount++ ); =20 - Print (L"Dumping ACPI table to : %s ... ", FileNameBuffer); + AcpiInfo (L"Dumping ACPI table to : %s ... ", FileNameBuffer); =20 TransferBytes =3D ShellDumpBufferToFile (FileNameBuffer, Ptr, Length); return (Length =3D=3D TransferBytes); @@ -81,15 +84,7 @@ ProcessTableReportOptions ( IN CONST UINT32 Length ) { - UINTN OriginalAttribute; - UINT8 *SignaturePtr; BOOLEAN Log; - - // - // set local variables to suppress incorrect compiler/analyzer warnings - // - OriginalAttribute =3D 0; - SignaturePtr =3D (UINT8*)(UINTN)&Signature; Log =3D FALSE; =20 switch (mConfig.ReportType) { @@ -104,27 +99,9 @@ ProcessTableReportOptions ( break; case ReportTableList: if (mTableCount =3D=3D 0) { - if (mConfig.ColourHighlighting) { - OriginalAttribute =3D gST->ConOut->Mode->Attribute; - gST->ConOut->SetAttribute ( - gST->ConOut, - EFI_TEXT_ATTR(EFI_CYAN, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4)) - ); - } - Print (L"\nInstalled Table(s):\n"); - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); - } + AcpiLog (ACPI_HIGHLIGHT, L"\nInstalled Table(s):"); } - Print ( - L"\t%4d. %c%c%c%c\n", - ++mTableCount, - SignaturePtr[0], - SignaturePtr[1], - SignaturePtr[2], - SignaturePtr[3] - ); + AcpiInfo (L"\t%4d. %.*a", ++mTableCount, 4, &Signature); break; case ReportDumpBinFile: if (Signature =3D=3D mSelectedAcpiTable.Type) { @@ -139,31 +116,16 @@ ProcessTableReportOptions ( } // switch =20 if (Log) { - if (mConfig.ColourHighlighting) { - OriginalAttribute =3D gST->ConOut->Mode->Attribute; - gST->ConOut->SetAttribute ( - gST->ConOut, - EFI_TEXT_ATTR(EFI_LIGHTBLUE, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4)) - ); - } - Print ( - L"\n\n --------------- %c%c%c%c Table --------------- \n\n", - SignaturePtr[0], - SignaturePtr[1], - SignaturePtr[2], - SignaturePtr[3] - ); - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); - } + AcpiLog ( + ACPI_HIGHLIGHT, + L"\n --------------- %.*a Table --------------- \n", + 4, + &Signature); } =20 return Log; } =20 - - /** This function iterates the configuration table entries in the system table, retrieves the RSDP pointer and starts parsing the ACPI tab= les. @@ -183,17 +145,12 @@ AcpiView ( EFI_STATUS Status; UINTN Index; EFI_CONFIGURATION_TABLE* EfiConfigurationTable; - BOOLEAN FoundAcpiTable; - UINTN OriginalAttribute; - UINTN PrintAttribute; UINT8* RsdpPtr; UINT32 RsdpLength; UINT8 RsdpRevision; PARSE_ACPI_TABLE_PROC RsdpParserProc; BOOLEAN Trace; =20 - OriginalAttribute =3D 0; - // Reset Table counts mTableCount =3D 0; mBinTableCount =3D 0; @@ -203,107 +160,77 @@ AcpiView ( mTableWarningCount =3D 0; =20 // Search the table for an entry that matches the ACPI Table Guid - FoundAcpiTable =3D FALSE; + EfiConfigurationTable =3D NULL; for (Index =3D 0; Index < SystemTable->NumberOfTableEntries; Index++) { if (CompareGuid (&gEfiAcpiTableGuid, &(SystemTable->ConfigurationTable[Index].VendorGuid))) { EfiConfigurationTable =3D &SystemTable->ConfigurationTable[Index]; - FoundAcpiTable =3D TRUE; break; } } =20 - if (FoundAcpiTable) { - RsdpPtr =3D (UINT8*)EfiConfigurationTable->VendorTable; + if (!EfiConfigurationTable) { + AcpiFatal (L"No ACPI Table Guid in System Configuration Table."); + return EFI_NOT_FOUND; + } =20 - // The RSDP revision is 1 byte starting at offset 15 - RsdpRevision =3D *(RsdpPtr + RSDP_REVISION_OFFSET); + RsdpPtr =3D (UINT8 *)EfiConfigurationTable->VendorTable; =20 - if (RsdpRevision < 2) { - Print ( - L"ERROR: RSDP version less than 2 is not supported.\n" - ); - return EFI_UNSUPPORTED; - } + // The RSDP revision is 1 byte starting at offset 15 + RsdpRevision =3D *(RsdpPtr + RSDP_REVISION_OFFSET); =20 -#if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (mConfig.MandatoryTableValidate) { - ArmSbbrResetTableCounts (); - } -#endif + if (RsdpRevision < 2) { + AcpiFatal (L"RSDP version less than 2 is not supported."); + return EFI_UNSUPPORTED; + } =20 - // The RSDP length is 4 bytes starting at offset 20 - RsdpLength =3D *(UINT32*)(RsdpPtr + RSDP_LENGTH_OFFSET); +#if defined(MDE_CPU_ARM) || defined(MDE_CPU_AARCH64) + if (mConfig.MandatoryTableValidate) { + ArmSbbrResetTableCounts(); + } +#endif =20 - Trace =3D ProcessTableReportOptions (RSDP_TABLE_INFO, RsdpPtr, RsdpLen= gth); + // The RSDP length is 4 bytes starting at offset 20 + RsdpLength =3D *(UINT32 *)(RsdpPtr + RSDP_LENGTH_OFFSET); =20 - Status =3D GetParser (RSDP_TABLE_INFO, &RsdpParserProc); - if (EFI_ERROR (Status)) { - Print ( - L"ERROR: No registered parser found for RSDP.\n" - ); - return Status; - } + Trace =3D ProcessTableReportOptions(RSDP_TABLE_INFO, RsdpPtr, RsdpLength= ); =20 - RsdpParserProc ( - Trace, - RsdpPtr, - RsdpLength, - RsdpRevision - ); - - } else { - IncrementErrorCount (); - Print ( - L"ERROR: Failed to find ACPI Table Guid in System Configuration Tabl= e.\n" - ); - return EFI_NOT_FOUND; + Status =3D GetParser(RSDP_TABLE_INFO, &RsdpParserProc); + if (EFI_ERROR(Status)) { + AcpiFatal (L"No registered parser found for RSDP."); + return Status; } =20 + RsdpParserProc(Trace, RsdpPtr, RsdpLength, RsdpRevision); + #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) if (mConfig.MandatoryTableValidate) { ArmSbbrReqsValidate ((ARM_SBBR_VERSION) mConfig.MandatoryTableSpec); } #endif =20 - if (ReportTableList !=3D mConfig.ReportType) { - if (((ReportSelected =3D=3D mConfig.ReportType) || - (ReportDumpBinFile =3D=3D mConfig.ReportType)) && - (!mSelectedAcpiTable.Found)) { - Print (L"\nRequested ACPI Table not found.\n"); - } else if (mConfig.ConsistencyCheck && - (ReportDumpBinFile !=3D mConfig.ReportType)) { - OriginalAttribute =3D gST->ConOut->Mode->Attribute; - - Print (L"\nTable Statistics:\n"); - - if (mConfig.ColourHighlighting) { - PrintAttribute =3D ((mTableErrorCount) > 0) ? - EFI_TEXT_ATTR ( - EFI_RED, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4) - ) : - OriginalAttribute; - gST->ConOut->SetAttribute (gST->ConOut, PrintAttribute); - } - Print (L"\t%d Error(s)\n", mTableErrorCount); - - if (mConfig.ColourHighlighting) { - PrintAttribute =3D (mTableWarningCount > 0) ? - EFI_TEXT_ATTR ( - EFI_RED, - ((OriginalAttribute&(BIT4|BIT5|BIT6))>>4) - ) : - OriginalAttribute; - - gST->ConOut->SetAttribute (gST->ConOut, PrintAttribute); - } - Print (L"\t%d Warning(s)\n", mTableWarningCount); + if (mConfig.ReportType =3D=3D ReportSelected || + mConfig.ReportType =3D=3D ReportDumpBinFile) { + if (!mSelectedAcpiTable.Found) { + AcpiFatal (L"Requested ACPI Table not found."); + return EFI_SUCCESS; + } + } =20 - if (mConfig.ColourHighlighting) { - gST->ConOut->SetAttribute (gST->ConOut, OriginalAttribute); - } + if (mConfig.ConsistencyCheck) { + if (mConfig.ReportType =3D=3D ReportSelected || + mConfig.ReportType =3D=3D ReportAll) { + AcpiInfo (L"Table Statistics:"); + AcpiLog ( + mTableErrorCount ? ACPI_BAD : ACPI_GOOD, + L"\t%d Error(s)", + mTableErrorCount); + AcpiLog ( + mTableWarningCount ? ACPI_BAD : ACPI_GOOD, + L"\t%d Warning(s)\n", + mTableWarningCount); } } + return EFI_SUCCESS; } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper= .h b/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper.h index 25c70652806c..b0072b68844c 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/FieldFormatHelper.h @@ -8,90 +8,10 @@ #ifndef FIELD_FORMAT_HELPER_H_ #define FIELD_FORMAT_HELPER_H_ =20 -#include -#include - -/** - This function traces 1 byte of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -static -inline -VOID -EFIAPI -DumpUint8 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - Print (Format, *Ptr); -} - -/** - This function traces 2 bytes of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -static -inline -VOID -EFIAPI -DumpUint16 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - Print (Format, *(UINT16*)Ptr); -} - -/** - This function traces 4 bytes of data as specified in the format string. - - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -static -inline -VOID -EFIAPI -DumpUint32 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - Print (Format, *(UINT32*)Ptr); -} - -/** - This function traces 8 bytes of data as specified by the format string. +#define INLINE inline =20 - @param [in] Format The format string for tracing the data. - @param [in] Ptr Pointer to the start of the buffer. -**/ -static -inline -VOID -EFIAPI -DumpUint64 ( - IN CONST CHAR16* Format, - IN UINT8* Ptr - ) -{ - // Some fields are not aligned and this causes alignment faults - // on ARM platforms if the compiler generates LDRD instructions. - // Perform word access so that LDRD instructions are not generated. - UINT64 Val; - - Val =3D *(UINT32*)(Ptr + sizeof (UINT32)); - - Val =3D LShiftU64(Val,32); - Val |=3D (UINT64)*(UINT32*)Ptr; - - Print (Format, Val); -} +#include +#include "AcpiViewLog.h" =20 /** This function traces 3 characters which can be optionally @@ -111,8 +31,8 @@ Dump3Chars ( IN UINT8* Ptr ) { - Print ( - (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c", + AcpiInfo ( + (Format !=3D NULL) ? Format : L"%c%c%c", Ptr[0], Ptr[1], Ptr[2] @@ -137,8 +57,8 @@ Dump4Chars ( IN UINT8* Ptr ) { - Print ( - (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c", + AcpiInfo( + (Format !=3D NULL) ? Format : L"%c%c%c%c", Ptr[0], Ptr[1], Ptr[2], @@ -164,8 +84,8 @@ Dump6Chars ( IN UINT8* Ptr ) { - Print ( - (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c%c%c", + AcpiInfo( + (Format !=3D NULL) ? Format : L"%c%c%c%c%c%c", Ptr[0], Ptr[1], Ptr[2], @@ -193,8 +113,8 @@ Dump8Chars ( IN UINT8* Ptr ) { - Print ( - (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c%c%c%c%c", + AcpiInfo( + (Format !=3D NULL) ? Format : L"%c%c%c%c%c%c%c%c", Ptr[0], Ptr[1], Ptr[2], @@ -224,8 +144,8 @@ Dump12Chars ( IN UINT8* Ptr ) { - Print ( - (Format !=3D NULL) ? Format : (CONST CHAR16*) L"%c%c%c%c%c%c%c%c%c%c%c= %c", + AcpiInfo( + (Format !=3D NULL) ? Format : L"%c%c%c%c%c%c%c%c%c%c%c%c", Ptr[0], Ptr[1], Ptr[2], --=20 2.24.1.windows.2 -=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 (#61810): https://edk2.groups.io/g/devel/message/61810 Mute This Topic: https://groups.io/mt/75193750/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- From nobody Fri Apr 26 00:35:04 2024 Delivered-To: importer@patchew.org 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+61806+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one) Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593444046484121.27481152719213; Mon, 29 Jun 2020 08:20:46 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id tuJjYY1788612xoUsIdQspzm; Mon, 29 Jun 2020 08:20:46 -0700 X-Received: from EUR05-DB8-obe.outbound.protection.outlook.com (EUR05-DB8-obe.outbound.protection.outlook.com [40.107.20.49]) by mx.groups.io with SMTP id smtpd.web12.21081.1593444044599506102 for ; Mon, 29 Jun 2020 08:20:45 -0700 X-Received: from MRXP264CA0039.FRAP264.PROD.OUTLOOK.COM (2603:10a6:500:14::27) by VI1PR08MB4352.eurprd08.prod.outlook.com (2603:10a6:803:f1::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20; Mon, 29 Jun 2020 15:20:40 +0000 X-Received: from VE1EUR03FT050.eop-EUR03.prod.protection.outlook.com (2603:10a6:500:14:cafe::ee) by MRXP264CA0039.outlook.office365.com (2603:10a6:500:14::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.21 via Frontend Transport; Mon, 29 Jun 2020 15:20:40 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; 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+61806+1787277+3901457@groups.io; helo=web01.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by VE1EUR03FT050.mail.protection.outlook.com (10.152.19.209) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:40 +0000 X-Received: ("Tessian outbound cea5956745d7:v60"); Mon, 29 Jun 2020 15:20:39 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 570ba903682f435c X-CR-MTA-TID: 64aa7808 X-Received: from 38dd450864ab.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 0A0895E5-1177-48B8-B391-103336D3801F.1; Mon, 29 Jun 2020 15:20:34 +0000 X-Received: from EUR01-HE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 38dd450864ab.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 29 Jun 2020 15:20:34 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZgRZPGtM0D2BUOxiKQo0L8e+WsbBOyCZ9n83xCscPjbp+oT48bKUGu3hWGINNwJKK4GFq6e3DsO9g5VK5gLGfYY48xNSu3G2wJZ59cA5lVmrm1jafCJcqKAEDKj/M0VCrsI77NIGX5vZHO/KDiSsv8f9rt5mmpjvtf+KksVAq+2UfeTMHxJBEMaIayA5/oLCytn78ryLPRvMiix8Ll2i555OPXc6hjZ/drRzTiqNBUvtrr0d+ZOSkBs0sXbVDgVr6IthvFW0PBQjPgqCPNhf72pyYA6FPSIWGb5vZUySGEQXiUqOTsZsMo9fJfEcY7XzTljZk1fdQbGLYHcU+JkMPw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=zodAWN33AD0O7AunbmRFlLgSEoYFEwDa9YYSp7colkQ=; b=DTOCBgQuN449wyDlaU2tJOAeubHiVWjtvr64wtP4dzmyIUtdCPTGRVWY2t1e/lvA/C5AcRIoFj5YPMObyyZCJ34SQVuYO2TpGtFOhgmQS9M5AOk6fVgt0zfvR/pP8GU/qjNMd004hPXvgyijyUFDrjStZ07xDnHth9H58S+11SXXt4fn6RnUEVJxePsx3NZBF6KfDHpuARipu1t/YCj1rpX5EbTWiKmiQsVkLGTnsW6Y/tNlDj3t3dONM22YcX9ibyn/LJ6xwcJKHvXIq4qTIPJdVDejw+qaG7s3gzf3uGNYH9ou7bLcytJm2xRsCMIzlSHnDqOA1tbBb1KDJHjvGQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=arm.com; dmarc=bestguesspass action=none header.from=arm.com; dkim=none (message not signed); arc=none X-Received: from DB6PR07CA0092.eurprd07.prod.outlook.com (2603:10a6:6:2b::30) by AM6PR08MB3814.eurprd08.prod.outlook.com (2603:10a6:20b:88::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3131.23; Mon, 29 Jun 2020 15:20:30 +0000 X-Received: from DB5EUR03FT051.eop-EUR03.prod.protection.outlook.com (2603:10a6:6:2b:cafe::ca) by DB6PR07CA0092.outlook.office365.com (2603:10a6:6:2b::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3153.12 via Frontend Transport; Mon, 29 Jun 2020 15:20:30 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; X-Received: from nebula.arm.com (40.67.248.234) by DB5EUR03FT051.mail.protection.outlook.com (10.152.21.19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.3131.20 via Frontend Transport; Mon, 29 Jun 2020 15:20:30 +0000 X-Received: from AZ-NEU-EX01.Emea.Arm.com (10.251.26.4) by AZ-NEU-EX04.Arm.com (10.251.24.32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.1415.2; Mon, 29 Jun 2020 15:20:30 +0000 X-Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX01.Emea.Arm.com (10.251.26.4) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1779.2; Mon, 29 Jun 2020 15:20:29 +0000 X-Received: from localhost.localdomain (10.57.4.19) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.1415.2 via Frontend Transport; Mon, 29 Jun 2020 15:20:29 +0000 From: "Tomas Pilar (tpilar)" To: CC: , , Ray Ni , "Zhichao Gao" Subject: [edk2-devel] [PATCH 8/8] ShellPkg/AcpiView: Refactor table parsers Date: Mon, 29 Jun 2020 16:20:08 +0100 Message-ID: <20200629152008.685-9-Tomas.Pilar@arm.com> In-Reply-To: <20200629152008.685-1-Tomas.Pilar@arm.com> References: <20200629152008.685-1-Tomas.Pilar@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFTY:;SFS:(4636009)(46966005)(336012)(426003)(2616005)(47076004)(4326008)(83380400001)(1076003)(186003)(70586007)(81166007)(26005)(70206006)(36756003)(82310400002)(30864003)(6916009)(19627235002)(498600001)(5660300002)(86362001)(8936002)(6666004)(356005)(8676002)(54906003)(2906002)(559001)(579004);DIR:OUT;SFP:1101; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: e0513621-603c-4170-7a61-08d81c3ffb93 X-MS-TrafficTypeDiagnostic: AM6PR08MB3814:|VI1PR08MB4352: X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:8882;OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: ogNp1a8RjKMu2uH1Hr3rOmNPOep5Zp4NaARIiH1qRRebwueABGe/vUWGNN+0A4cQXqa+LzOWsMzoqszN8bZoVlEiuyIpqpLKj4V9JcIWQZnDfl7NfFIWdzNp4gBShGB93JwZGHPp2mbU1GQhh/vcEZCxO1HxInoOjVWbZE0sQZMLE+R2Lw+BSknJte4fX390/imjmjvvGX+RsY/G5Fxw4AilwyVTm6O2IcSb1QUBHUIGcNNisB7bMFOgFZ6EJdEgZWqQwScTQ8MTr3sKTBvRzmKRkvDdTbHuE85RVNFL/NVscZM+0+A/Q+DswGsRDobmiE6fmpRwcxPOgmeuijNAkyDOtLKI7t0Rlc5kXLtRCCJQ81FZCSqbR+mSa3785E5x8LctHaZxHQaQYOYBSgqfnQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR08MB3814 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT050.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 82a76199-211b-4f24-6728-08d81c3ff5e5 X-Microsoft-Antispam-Message-Info: zQiXOSKcd1jvxuk1ADrAL5XIy2gtmn68hGHl5/XrLpx95nf3mzk/6+CUciTPqnYVAcE1V2dSELLCInHGOL4+mN2rQ07DAEVSVuw+61JBDxZMIJFboiV/fIW1einbd+r8++uP0FhYNsyR7FvWeorWprVjv9Hr+hExuiP/z1RMfXa5JJ77OnXXUShZRme2VBb6zaCwgfERJ3DA5kmqs5kdeZQEGiSfJ5PyTlutSc+cFK92cnt5sMaS+7jAVWUEG5rR5LRFPmKhAbgegOkmLp+sp81opLoNJ/os8kkXs3L3FHoeRkmMIIeWneggi5V+8OTb8AfXWrTxsWRdMQ1TIM6vbFY33oq3DQ/XR5UXgb+fQgEjiVQ28zEiz+JTbTpAA9Wpq0rxAWN59ayB8RzZJiHGzQ== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jun 2020 15:20:40.0659 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e0513621-603c-4170-7a61-08d81c3ffb93 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR03FT050.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB4352 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,Tomas.Pilar@arm.com X-Gm-Message-State: GOPMYt81FLcVLdWZGbZUSHWsx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593444046; bh=7pfqu8J4HfNOV5T7rFoe+ixQunYBvZSupsM0IOF6xqc=; h=CC:Content-Type:Date:From:Reply-To:Subject:To; b=nea2QDefwoBAIfKKhbgnOWj1CW4ZkCdTGepm23XSa2biiq+zAXk51MVrbrpZcrtgGLo KqX1aZk65uONlaMaxSpnTRS0PnKOVzd17POEvzEu0irq7OQ+kXkdbGu0Q5ncAt7JqzKio 2CICck0EWxgnR2GlIJPuC24sSo5QFyyzSgI= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" The tests for checking specific constraints and checking for buffer overflows have been simplified to use a standard set of templates defined in the logging facility. This regularises some of the error handling and makes it easier to write more tests like this in the future. Cc: Ray Ni Cc: Zhichao Gao Signed-off-by: Tomas Pilar --- .../UefiShellAcpiViewCommandLib/AcpiParser.c | 25 --- .../UefiShellAcpiViewCommandLib/AcpiParser.h | 18 -- .../Arm/SbbrValidator.c | 65 +++--- .../Parsers/Dbg2/Dbg2Parser.c | 118 +++------- .../Parsers/Fadt/FadtParser.c | 48 ++-- .../Parsers/Gtdt/GtdtParser.c | 84 ++----- .../Parsers/Iort/IortParser.c | 207 +++++++----------- .../Parsers/Madt/MadtParser.c | 99 +++------ .../Parsers/Mcfg/McfgParser.c | 11 +- .../Parsers/Pptt/PpttParser.c | 165 +++----------- .../Parsers/Rsdp/RsdpParser.c | 42 +--- .../Parsers/Slit/SlitParser.c | 122 ++++------- .../Parsers/Spcr/SpcrParser.c | 31 +-- .../Parsers/Srat/SratParser.c | 188 +++++----------- .../Parsers/Xsdt/XsdtParser.c | 92 ++------ 15 files changed, 375 insertions(+), 940 deletions(-) diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c index 9bbf724dfdfe..58599442d210 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.c @@ -24,31 +24,6 @@ STATIC CONST ACPI_PARSER AcpiHeaderParser[] =3D { PARSE_ACPI_HEADER (&AcpiHdrInfo) }; =20 -/** - This function increments the ACPI table error counter. -**/ -VOID -EFIAPI -IncrementErrorCount ( - VOID - ) -{ - mTableErrorCount++; -} - -/** - This function increments the ACPI table warning counter. -**/ -VOID -EFIAPI -IncrementWarningCount ( - VOID - ) -{ - mTableWarningCount++; -} - - /** This function verifies the ACPI table checksum. =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h b/Sh= ellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h index bd3cdb774fb5..cdae433fef3b 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/AcpiParser.h @@ -18,24 +18,6 @@ /// that allows us to process the log options. #define RSDP_TABLE_INFO SIGNATURE_32('R', 'S', 'D', 'P') =20 -/** - This function increments the ACPI table error counter. -**/ -VOID -EFIAPI -IncrementErrorCount ( - VOID - ); - -/** - This function increments the ACPI table warning counter. -**/ -VOID -EFIAPI -IncrementWarningCount ( - VOID - ); - /** This function verifies the ACPI table checksum. =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Arm/SbbrValidator= .c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Arm/SbbrValidator.c index d3284417fa5f..ba80a5ab3b40 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Arm/SbbrValidator.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Arm/SbbrValidator.c @@ -18,15 +18,16 @@ #include #include #include "AcpiParser.h" +#include "AcpiViewLog.h" #include "Arm/SbbrValidator.h" =20 /** SBBR specification version strings **/ -STATIC CONST CHAR8* ArmSbbrVersions[ArmSbbrVersionMax] =3D { - "1.0", // ArmSbbrVersion_1_0 - "1.1", // ArmSbbrVersion_1_1 - "1.2" // ArmSbbrVersion_1_2 +STATIC CONST CHAR16* ArmSbbrVersions[ArmSbbrVersionMax] =3D { + L"SBBR-v1.0", // ArmSbbrVersion_1_0 + L"SBBR-v1.1", // ArmSbbrVersion_1_1 + L"SBBR-v1.2" // ArmSbbrVersion_1_2 }; =20 /** @@ -96,6 +97,16 @@ STATIC ACPI_TABLE_COUNTER ArmSbbrTableCounts[] =3D { {EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_STRUCTURE_SIGNATURE, 0} }; =20 +STATIC_ASSERT ( + ARRAY_SIZE (ArmSbbr10Mandatory) <=3D ARRAY_SIZE (ArmSbbrTableCounts), + "Incompatible mandatory array tables"); +STATIC_ASSERT ( + ARRAY_SIZE (ArmSbbr11Mandatory) <=3D ARRAY_SIZE (ArmSbbrTableCounts), + "Incompatible mandatory array tables"); +STATIC_ASSERT ( + ARRAY_SIZE (ArmSbbr12Mandatory) <=3D ARRAY_SIZE (ArmSbbrTableCounts), + "Incompatible mandatory array tables"); + /** Reset the platform ACPI table instance count for all SBBR-mandatory tabl= es. **/ @@ -160,7 +171,6 @@ ArmSbbrReqsValidate ( UINT32 Table; UINT32 Index; UINT32 MandatoryTable; - CONST UINT8* SignaturePtr; BOOLEAN IsArmSbbrViolated; =20 if (Version >=3D ArmSbbrVersionMax) { @@ -172,51 +182,30 @@ ArmSbbrReqsValidate ( // Go through the list of mandatory tables for the input SBBR version for (Table =3D 0; Table < ArmSbbrReqs[Version].TableCount; Table++) { MandatoryTable =3D ArmSbbrReqs[Version].Tables[Table]; - SignaturePtr =3D (CONST UINT8*)(UINTN)&MandatoryTable; =20 // Locate the instance count for the table with the given signature - Index =3D 0; - while ((Index < ARRAY_SIZE (ArmSbbrTableCounts)) && - (ArmSbbrTableCounts[Index].Signature !=3D MandatoryTable)) { - Index++; - } - - if (Index >=3D ARRAY_SIZE (ArmSbbrTableCounts)) { - IncrementErrorCount (); - Print ( - L"\nERROR: SBBR v%a: Mandatory %c%c%c%c table's instance count not= " \ - L"found\n", - ArmSbbrVersions[Version], - SignaturePtr[0], - SignaturePtr[1], - SignaturePtr[2], - SignaturePtr[3] - ); - return EFI_UNSUPPORTED; + for (Index =3D 0; Index < ARRAY_SIZE (ArmSbbrTableCounts); Index++) { + if (ArmSbbrTableCounts[Index].Signature =3D=3D MandatoryTable) { + break; + } } =20 if (ArmSbbrTableCounts[Index].Count =3D=3D 0) { IsArmSbbrViolated =3D TRUE; - IncrementErrorCount (); - Print ( - L"\nERROR: SBBR v%a: Mandatory %c%c%c%c table is missing", + AcpiError ( + ACPI_ERROR_CROSS, + L"(%a) Mandatory %4a table is missing", ArmSbbrVersions[Version], - SignaturePtr[0], - SignaturePtr[1], - SignaturePtr[2], - SignaturePtr[3] - ); + MandatoryTable); } } =20 if (!IsArmSbbrViolated) { - Print ( - L"\nINFO: SBBR v%a: All mandatory ACPI tables are installed", - ArmSbbrVersions[Version] - ); + AcpiLog ( + ACPI_GOOD, + L"(%a): Mandatory ACPI tables present", + ArmSbbrVersions[Version]); } =20 - Print (L"\n"); - return IsArmSbbrViolated ? EFI_NOT_FOUND : EFI_SUCCESS; } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2Pa= rser.c index dd69ed6992ba..933ad92312e1 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2Parser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Dbg2/Dbg2Parser.c @@ -10,6 +10,7 @@ =20 #include #include +#include #include "AcpiParser.h" #include "AcpiTableParser.h" #include "AcpiViewLog.h" @@ -42,17 +43,10 @@ ValidateNameSpaceStrLen ( IN VOID* Context ) { - UINT16 NameSpaceStrLen; + UINT16 NameSpaceStrLen =3D *(UINT16 *) Ptr; =20 - NameSpaceStrLen =3D *(UINT16*)Ptr; - - if (NameSpaceStrLen < 2) { - IncrementErrorCount (); - Print ( - L"\nERROR: NamespaceString Length =3D %d. If no Namespace device exi= sts, " \ - L"NamespaceString[] must contain a period '.'", - NameSpaceStrLen - ); + if (AssertConstraint (L"ACPI", NameSpaceStrLen > 1)) { + AcpiInfo (L"With no namespace, NamespaceString[] must be a period '.'"= ); } } =20 @@ -133,76 +127,51 @@ DumpDbgDeviceInfo ( (OEMDataOffset =3D=3D NULL) || (BaseAddrRegOffset =3D=3D NULL) || (AddrSizeOffset =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient Debug Device Information Structure length. " \ - L"Length =3D %d.\n", - Length - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse DbgDevInfo Structure"); return; } =20 // GAS - Index =3D 0; Offset =3D *BaseAddrRegOffset; - while ((Index++ < *GasCount) && - (Offset < Length)) { - PrintFieldName (4, L"BaseAddressRegister"); - Offset +=3D (UINT16)DumpGasStruct ( - Ptr + Offset, - 4, - Length - Offset - ); + for (Index =3D 0; Index < *GasCount; Index++) { + if (AssertMemberIntegrity (Offset, 1, Ptr, Length)) { + break; + } + + PrintFieldName (4, L"BaseAddressRegister[%d]", Index); + Offset +=3D (UINT16)DumpGasStruct (Ptr + Offset, 4, Length - Offset); } =20 // Make sure the array of address sizes corresponding to each GAS fit in= the // Debug Device Information structure - if ((*AddrSizeOffset + (*GasCount * sizeof (UINT32))) > Length) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid GAS count. GasCount =3D %d. RemainingBufferLength = =3D %d. " \ - L"Parsing of the Debug Device Information structure aborted.\n", - *GasCount, - Length - *AddrSizeOffset - ); + if (AssertMemberIntegrity ( + *AddrSizeOffset, *GasCount * sizeof (UINT32), Ptr, Length)) { return; } =20 // Address Size Index =3D 0; Offset =3D *AddrSizeOffset; - while ((Index++ < *GasCount) && - (Offset < Length)) { - PrintFieldName (4, L"Address Size"); - Print (L"0x%x\n", *((UINT32*)(Ptr + Offset))); + for (Index =3D 0; Index < *GasCount; Index++) { + if (AssertMemberIntegrity (Offset, 1, Ptr, Length)) { + break; + } + PrintFieldName (4, L"Address Size[%d]", Index); + AcpiInfo (L"0x%x", ReadUnaligned32 ((CONST UINT32 *)(Ptr + Offset))); Offset +=3D sizeof (UINT32); } =20 // NameSpace String - Index =3D 0; - Offset =3D *NameSpaceStringOffset; PrintFieldName (4, L"NameSpace String"); - while ((Index++ < *NameSpaceStringLength) && - (Offset < Length)) { - Print (L"%c", *(Ptr + Offset)); - Offset++; + if (!AssertMemberIntegrity ( + *NameSpaceStringOffset, *NameSpaceStringLength, Ptr, Length)) { + AcpiInfo (L"%-.*a", *NameSpaceStringLength - 1, Ptr + *NameSpaceString= Offset); } - Print (L"\n"); =20 // OEM Data if (*OEMDataOffset !=3D 0) { - Index =3D 0; - Offset =3D *OEMDataOffset; - PrintFieldName (4, L"OEM Data"); - while ((Index++ < *OEMDataLength) && - (Offset < Length)) { - Print (L"%x ", *(Ptr + Offset)); - if ((Index & 7) =3D=3D 0) { - Print (L"\n%-*s ", OUTPUT_FIELD_COLUMN_WIDTH, L""); - } - Offset++; - } - Print (L"\n"); + AcpiInfo (L"OEM Data"); + DumpRaw (Ptr + *OEMDataOffset, *OEMDataLength); } } =20 @@ -245,13 +214,8 @@ ParseAcpiDbg2 ( =20 // Check if the values used to control the parsing logic have been // successfully read. - if ((OffsetDbgDeviceInfo =3D=3D NULL) || - (NumberDbgDeviceInfo =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient table length. AcpiTableLength =3D %d\n", - AcpiTableLength - ); + if ((OffsetDbgDeviceInfo =3D=3D NULL) || (NumberDbgDeviceInfo =3D=3D NUL= L)) { + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse DbgDevInfo array"); return; } =20 @@ -259,7 +223,6 @@ ParseAcpiDbg2 ( Index =3D 0; =20 while (Index++ < *NumberDbgDeviceInfo) { - // Parse the Debug Device Information Structure header to obtain Length ParseAcpi ( FALSE, @@ -273,31 +236,20 @@ ParseAcpiDbg2 ( // Check if the values used to control the parsing logic have been // successfully read. if (DbgDevInfoLen =3D=3D NULL) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient remaining table buffer length to read the " \ - L"Debug Device Information structure's 'Length' field. " \ - L"RemainingTableBufferLength =3D %d.\n", - AcpiTableLength - Offset - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse DbgDevInfoLen"); return; } =20 // Validate Debug Device Information Structure length - if ((*DbgDevInfoLen =3D=3D 0) || - ((Offset + (*DbgDevInfoLen)) > AcpiTableLength)) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Debug Device Information Structure length. " \ - L"Length =3D %d. Offset =3D %d. AcpiTableLength =3D %d.\n", - *DbgDevInfoLen, - Offset, - AcpiTableLength - ); + if (AssertConstraint (L"ACPI", *DbgDevInfoLen > 0)) { + return; + } + + if (AssertMemberIntegrity (Offset, *DbgDevInfoLen, Ptr, AcpiTableLengt= h)) { return; } =20 - DumpDbgDeviceInfo (Ptr + Offset, (*DbgDevInfoLen)); - Offset +=3D (*DbgDevInfoLen); + DumpDbgDeviceInfo (Ptr + Offset, *DbgDevInfoLen); + Offset +=3D *DbgDevInfoLen; } } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/Fadt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/FadtPa= rser.c index 4734864dfdcf..7349784ee067 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/FadtParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Fadt/FadtParser.c @@ -69,12 +69,8 @@ ValidateFirmwareCtrl ( ) { #if defined (MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (*(UINT32*)Ptr !=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: Firmware Control must be zero for ARM platforms." - ); - } + UINT32 FirmwareControl =3D *(UINT32 *) Ptr; + AssertConstraint (L"ARM", FirmwareControl =3D=3D 0); #endif } =20 @@ -94,12 +90,8 @@ ValidateXFirmwareCtrl ( ) { #if defined (MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (*(UINT64*)Ptr !=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: X Firmware Control must be zero for ARM platforms." - ); - } + UINT32 XFirmwareControl =3D *(UINT32 *) Ptr; + AssertConstraint (L"ARM", XFirmwareControl =3D=3D 0); #endif } =20 @@ -119,12 +111,8 @@ ValidateFlags ( ) { #if defined (MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (((*(UINT32*)Ptr) & HW_REDUCED_ACPI) =3D=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: HW_REDUCED_ACPI flag must be set for ARM platforms." - ); - } + UINT32 Flags =3D *(UINT32 *) Ptr; + AssertConstraint (L"ARM", Flags & HW_REDUCED_ACPI); #endif } =20 @@ -232,15 +220,13 @@ ParseAcpiFadt ( =20 if (Trace) { if (FadtMinorRevision !=3D NULL) { - Print (L"\nSummary:\n"); + AcpiInfo (L"Summary:"); PrintFieldName (2, L"FADT Version"); - Print (L"%d.%d\n", *AcpiHdrInfo.Revision, *FadtMinorRevision); + AcpiInfo (L"%d.%d", *AcpiHdrInfo.Revision, *FadtMinorRevision); } =20 - if (*GetAcpiXsdtHeaderInfo ()->OemTableId !=3D *AcpiHdrInfo.OemTableId= ) { - IncrementErrorCount (); - Print (L"ERROR: OEM Table Id does not match with RSDT/XSDT.\n"); - } + AssertConstraint ( + L"ACPI", *GetAcpiXsdtHeaderInfo ()->OemTableId =3D=3D *AcpiHdrInfo.O= emTableId); } =20 // If X_FIRMWARE_CTRL is not zero then use X_FIRMWARE_CTRL and ignore @@ -257,9 +243,9 @@ ParseAcpiFadt ( if ((Trace) && (Flags !=3D NULL) && ((*Flags & EFI_ACPI_6_3_HW_REDUCED_ACPI) !=3D EFI_ACPI_6_3_HW_REDU= CED_ACPI)) { - IncrementErrorCount (); - Print (L"ERROR: No FACS table found, " - L"both X_FIRMWARE_CTRL and FIRMWARE_CTRL are zero.\n"); + AcpiError ( + ACPI_ERROR_CROSS, + L"No FACS table found, X_FIRMWARE_CTRL and FIRMWARE_CTRL are zero"= ); } } =20 @@ -283,9 +269,7 @@ ParseAcpiFadt ( =20 Status =3D GetParser (FacsSignature, &FacsParserProc); if (EFI_ERROR (Status)) { - Print ( - L"ERROR: No registered parser found for FACS.\n" - ); + AcpiFatal (L"No registered parser found for FACS"); return; } =20 @@ -309,8 +293,8 @@ ParseAcpiFadt ( // The DSDT Table is mandatory for ARM systems // as the CPU information MUST be presented in // the DSDT. - IncrementErrorCount (); - Print (L"ERROR: Both X_DSDT and DSDT are invalid.\n"); + AcpiError ( + ACPI_ERROR_CROSS, L"(ARM) One of X_DSDT or DSDT must be valid!"); } #endif return; diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Gtdt/Gtdt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Gtdt/GtdtPa= rser.c index d02fc4929d6f..c6b782152c63 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Gtdt/GtdtParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Gtdt/GtdtParser.c @@ -13,6 +13,7 @@ #include "AcpiParser.h" #include "AcpiTableParser.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" =20 // "The number of GT Block Timers must be less than or equal to 8" #define GT_BLOCK_TIMER_COUNT_MAX 8 @@ -41,18 +42,8 @@ ValidateGtBlockTimerCount ( IN VOID* Context ) { - UINT32 BlockTimerCount; - - BlockTimerCount =3D *(UINT32*)Ptr; - - if (BlockTimerCount > GT_BLOCK_TIMER_COUNT_MAX) { - IncrementErrorCount (); - Print ( - L"\nERROR: Timer Count =3D %d. Max Timer Count is %d.", - BlockTimerCount, - GT_BLOCK_TIMER_COUNT_MAX - ); - } + UINT32 BlockTimerCount =3D *(UINT32*)Ptr; + AssertConstraint (L"ACPI", BlockTimerCount < GT_BLOCK_TIMER_COUNT_MAX); } =20 /** @@ -70,18 +61,8 @@ ValidateGtFrameNumber ( IN VOID* Context ) { - UINT8 FrameNumber; - - FrameNumber =3D *(UINT8*)Ptr; - - if (FrameNumber >=3D GT_BLOCK_TIMER_COUNT_MAX) { - IncrementErrorCount (); - Print ( - L"\nERROR: GT Frame Number =3D %d. GT Frame Number must be in range = 0-%d.", - FrameNumber, - GT_BLOCK_TIMER_COUNT_MAX - 1 - ); - } + UINT8 GTFrameNumber =3D *Ptr; + AssertConstraint (L"ACPI", GTFrameNumber < GT_BLOCK_TIMER_COUNT_MAX); } =20 /** @@ -194,11 +175,7 @@ DumpGTBlock ( // successfully read. if ((GtBlockTimerCount =3D=3D NULL) || (GtBlockTimerOffset =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient GT Block Structure length. Length =3D %d.\n", - Length - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse GT Block Structure"); return; } =20 @@ -270,7 +247,6 @@ ParseAcpiGtdt ( { UINT32 Index; UINT32 Offset; - UINT8* TimerPtr; =20 if (!Trace) { return; @@ -287,17 +263,11 @@ ParseAcpiGtdt ( =20 // Check if the values used to control the parsing logic have been // successfully read. - if ((GtdtPlatformTimerCount =3D=3D NULL) || - (GtdtPlatformTimerOffset =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient table length. AcpiTableLength =3D %d.\n", - AcpiTableLength - ); + if ((GtdtPlatformTimerCount =3D=3D NULL) || (GtdtPlatformTimerOffset =3D= =3D NULL)) { + AcpiError (ACPI_ERROR_PARSE, L"Corrupt Platform Timer Table"); return; } =20 - TimerPtr =3D Ptr + *GtdtPlatformTimerOffset; Offset =3D *GtdtPlatformTimerOffset; Index =3D 0; =20 @@ -310,55 +280,35 @@ ParseAcpiGtdt ( FALSE, 0, NULL, - TimerPtr, + Ptr + Offset, AcpiTableLength - Offset, PARSER_PARAMS (GtPlatformTimerHeaderParser) ); =20 // Check if the values used to control the parsing logic have been // successfully read. - if ((PlatformTimerType =3D=3D NULL) || - (PlatformTimerLength =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient remaining table buffer length to read the " \ - L"Platform Timer Structure header. Length =3D %d.\n", - AcpiTableLength - Offset - ); + if ((PlatformTimerType =3D=3D NULL) || (PlatformTimerLength =3D=3D NUL= L)) { + AcpiError (ACPI_ERROR_PARSE, L"Corrupt Platform Timer Structure"); return; } =20 // Validate Platform Timer Structure length - if ((*PlatformTimerLength =3D=3D 0) || - ((Offset + (*PlatformTimerLength)) > AcpiTableLength)) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Platform Timer Structure length. " \ - L"Length =3D %d. Offset =3D %d. AcpiTableLength =3D %d.\n", - *PlatformTimerLength, - Offset, - AcpiTableLength - ); + if (AssertMemberIntegrity(Offset, *PlatformTimerLength, Ptr, AcpiTable= Length)) { return; } =20 switch (*PlatformTimerType) { case EFI_ACPI_6_3_GTDT_GT_BLOCK: - DumpGTBlock (TimerPtr, *PlatformTimerLength); + DumpGTBlock (Ptr + Offset, *PlatformTimerLength); break; case EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG: - DumpWatchdogTimer (TimerPtr, *PlatformTimerLength); + DumpWatchdogTimer (Ptr + Offset, *PlatformTimerLength); break; default: - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Platform Timer Type =3D %d\n", - *PlatformTimerType - ); - break; - } // switch + AcpiError ( + ACPI_ERROR_VALUE, L"Platform Timer Type %d", *PlatformTimerType); + } =20 - TimerPtr +=3D *PlatformTimerLength; Offset +=3D *PlatformTimerLength; } // while } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/Iort= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/IortPa= rser.c index 356f355939aa..96227853c6ca 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/IortParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Iort/IortParser.c @@ -11,6 +11,7 @@ #include #include #include +#include #include "AcpiParser.h" #include "AcpiTableParser.h" #include "AcpiViewConfig.h" @@ -49,10 +50,8 @@ ValidateItsIdMappingCount ( IN VOID* Context ) { - if (*(UINT32*)Ptr !=3D 0) { - IncrementErrorCount (); - Print (L"\nERROR: IORT ID Mapping count must be zero."); - } + UINT32 ItsNodeIdMapping =3D *(UINT32 *) Ptr; + AssertConstraint (L"ACPI", ItsNodeIdMapping =3D=3D 0); } =20 /** @@ -71,10 +70,8 @@ ValidatePmcgIdMappingCount ( IN VOID* Context ) { - if (*(UINT32*)Ptr > 1) { - IncrementErrorCount (); - Print (L"\nERROR: IORT ID Mapping count must not be greater than 1."); - } + UINT32 PmcgNodeIdMapping =3D *(UINT32 *) Ptr; + AssertConstraint (L"ACPI", PmcgNodeIdMapping <=3D 1); } =20 /** @@ -92,10 +89,8 @@ ValidateItsIdArrayReference ( IN VOID* Context ) { - if (*(UINT32*)Ptr !=3D 0) { - IncrementErrorCount (); - Print (L"\nERROR: IORT ID Mapping offset must be zero."); - } + UINT32 ItsNodeMappingArrayOffset =3D *(UINT32 *) Ptr; + AssertConstraint (L"ACPI", ItsNodeMappingArrayOffset =3D=3D 0); } =20 /** @@ -268,28 +263,21 @@ DumpIortNodeIdMappings ( { UINT32 Index; UINT32 Offset; - CHAR8 Buffer[40]; // Used for AsciiName param of ParseAcpi =20 - Index =3D 0; Offset =3D 0; + for (Index =3D 0; Index < MappingCount; Index++) { + if (AssertMemberIntegrity(Offset, 1, Ptr, Length)) { + return; + } =20 - while ((Index < MappingCount) && - (Offset < Length)) { - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "ID Mapping [%d]", - Index - ); + AcpiLog (ACPI_ITEM, L" ID Mapping[%d] (+0x%x)", Index, Offset); Offset +=3D ParseAcpi ( - TRUE, - 4, - Buffer, - Ptr + Offset, - Length - Offset, - PARSER_PARAMS (IortNodeIdMappingParser) - ); - Index++; + TRUE, + 4, + NULL, + Ptr + Offset, + Length - Offset, + PARSER_PARAMS (IortNodeIdMappingParser)); } } =20 @@ -313,7 +301,6 @@ DumpIortNodeSmmuV1V2 ( { UINT32 Index; UINT32 Offset; - CHAR8 Buffer[50]; // Used for AsciiName param of ParseAcpi =20 ParseAcpi ( TRUE, @@ -330,56 +317,41 @@ DumpIortNodeSmmuV1V2 ( (InterruptContextOffset =3D=3D NULL) || (PmuInterruptCount =3D=3D NULL) || (PmuInterruptOffset =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient SMMUv1/2 node length. Length =3D %d\n", - Length - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse the SMMUv1/2 node"); return; } =20 Offset =3D *InterruptContextOffset; - Index =3D 0; + for (Index =3D 0; Index < *InterruptContextCount; Index++) { + if (AssertMemberIntegrity(Offset, 1, Ptr, Length)) { + break; + } =20 - while ((Index < *InterruptContextCount) && - (Offset < Length)) { - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "Context Interrupts Array [%d]", - Index - ); + AcpiLog ( + ACPI_ITEM, L" Context Interrupts Array[%d] (+0x%x)", Index, Offse= t); Offset +=3D ParseAcpi ( - TRUE, - 4, - Buffer, - Ptr + Offset, - Length - Offset, - PARSER_PARAMS (InterruptArrayParser) - ); - Index++; + TRUE, + 4, + NULL, + Ptr + Offset, + Length - Offset, + PARSER_PARAMS (InterruptArrayParser)); } =20 Offset =3D *PmuInterruptOffset; - Index =3D 0; + for(Index =3D 0; Index < *PmuInterruptCount; Index++) { + if (AssertMemberIntegrity(Offset, 1, Ptr, Length)){ + break; + } =20 - while ((Index < *PmuInterruptCount) && - (Offset < Length)) { - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "PMU Interrupts Array [%d]", - Index - ); + AcpiLog (ACPI_ITEM, L" PMU Interrupts Array[%d] (+0x%x)", Index, Of= fset); Offset +=3D ParseAcpi ( - TRUE, - 4, - Buffer, - Ptr + Offset, - Length - Offset, - PARSER_PARAMS (InterruptArrayParser) - ); - Index++; + TRUE, + 4, + NULL, + Ptr + Offset, + Length - Offset, + PARSER_PARAMS (InterruptArrayParser)); } =20 DumpIortNodeIdMappings ( @@ -438,7 +410,6 @@ DumpIortNodeIts ( { UINT32 Offset; UINT32 Index; - CHAR8 Buffer[80]; // Used for AsciiName param of ParseAcpi =20 Offset =3D ParseAcpi ( TRUE, @@ -452,32 +423,26 @@ DumpIortNodeIts ( // Check if the values used to control the parsing logic have been // successfully read. if (ItsCount =3D=3D NULL) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient ITS group length. Length =3D %d.\n", - Length - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse ITS node"); return; } =20 Index =3D 0; =20 - while ((Index < *ItsCount) && - (Offset < Length)) { - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "GIC ITS Identifier Array [%d]", - Index - ); + for (Index =3D 0; Index < *ItsCount; Index++) { + if (AssertMemberIntegrity(Offset, 1, Ptr, Length)) { + return; + } + + AcpiLog ( + ACPI_ITEM, L" GIC ITS Identifier Array[%d] (+0x%x)", Index, Offse= t); Offset +=3D ParseAcpi ( - TRUE, - 4, - Buffer, - Ptr + Offset, - Length - Offset, - PARSER_PARAMS (ItsIdParser) - ); + TRUE, + 4, + NULL, + Ptr + Offset, + Length - Offset, + PARSER_PARAMS (ItsIdParser)); Index++; } =20 @@ -516,13 +481,10 @@ DumpIortNodeNamedComponent ( =20 // Estimate the Device Name length PrintFieldName (2, L"Device Object Name"); - - while ((*(Ptr + Offset) !=3D 0) && - (Offset < Length)) { - Print (L"%c", *(Ptr + Offset)); - Offset++; - } - Print (L"\n"); + AcpiInfo ( + L"%.*a", + AsciiStrnLenS ((CONST CHAR8 *)Ptr + Offset, Length - Offset), + Ptr + Offset); =20 DumpIortNodeIdMappings ( Ptr + MappingOffset, @@ -629,7 +591,6 @@ ParseAcpiIort ( { UINT32 Offset; UINT32 Index; - UINT8* NodePtr; =20 if (!Trace) { return; @@ -648,16 +609,11 @@ ParseAcpiIort ( // successfully read. if ((IortNodeCount =3D=3D NULL) || (IortNodeOffset =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient table length. AcpiTableLength =3D %d.\n", - AcpiTableLength - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse IORT Node."); return; } =20 Offset =3D *IortNodeOffset; - NodePtr =3D Ptr + Offset; Index =3D 0; =20 // Parse the specified number of IORT nodes or the IORT table buffer len= gth. @@ -669,7 +625,7 @@ ParseAcpiIort ( FALSE, 0, "IORT Node Header", - NodePtr, + Ptr + Offset, AcpiTableLength - Offset, PARSER_PARAMS (IortNodeHeaderParser) ); @@ -680,42 +636,28 @@ ParseAcpiIort ( (IortNodeLength =3D=3D NULL) || (IortIdMappingCount =3D=3D NULL) || (IortIdMappingOffset =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient remaining table buffer length to read the " \ - L"IORT node header. Length =3D %d.\n", - AcpiTableLength - Offset - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed ot parse the IORT node header"= ); return; } =20 - // Validate IORT Node length - if ((*IortNodeLength =3D=3D 0) || - ((Offset + (*IortNodeLength)) > AcpiTableLength)) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid IORT Node length. " \ - L"Length =3D %d. Offset =3D %d. AcpiTableLength =3D %d.\n", - *IortNodeLength, - Offset, - AcpiTableLength - ); + // Protect against buffer overrun + if (AssertMemberIntegrity (Offset, *IortNodeLength, Ptr, AcpiTableLeng= th)) { return; } =20 PrintFieldName (2, L"* Node Offset *"); - Print (L"0x%x\n", Offset); + AcpiInfo (L"0x%x", Offset); =20 switch (*IortNodeType) { case EFI_ACPI_IORT_TYPE_ITS_GROUP: DumpIortNodeIts ( - NodePtr, + Ptr + Offset, *IortNodeLength ); break; case EFI_ACPI_IORT_TYPE_NAMED_COMP: DumpIortNodeNamedComponent ( - NodePtr, + Ptr + Offset, *IortNodeLength, *IortIdMappingCount, *IortIdMappingOffset @@ -723,7 +665,7 @@ ParseAcpiIort ( break; case EFI_ACPI_IORT_TYPE_ROOT_COMPLEX: DumpIortNodeRootComplex ( - NodePtr, + Ptr + Offset, *IortNodeLength, *IortIdMappingCount, *IortIdMappingOffset @@ -731,7 +673,7 @@ ParseAcpiIort ( break; case EFI_ACPI_IORT_TYPE_SMMUv1v2: DumpIortNodeSmmuV1V2 ( - NodePtr, + Ptr + Offset, *IortNodeLength, *IortIdMappingCount, *IortIdMappingOffset @@ -739,7 +681,7 @@ ParseAcpiIort ( break; case EFI_ACPI_IORT_TYPE_SMMUv3: DumpIortNodeSmmuV3 ( - NodePtr, + Ptr + Offset, *IortNodeLength, *IortIdMappingCount, *IortIdMappingOffset @@ -747,7 +689,7 @@ ParseAcpiIort ( break; case EFI_ACPI_IORT_TYPE_PMCG: DumpIortNodePmcg ( - NodePtr, + Ptr + Offset, *IortNodeLength, *IortIdMappingCount, *IortIdMappingOffset @@ -755,11 +697,10 @@ ParseAcpiIort ( break; =20 default: - IncrementErrorCount (); - Print (L"ERROR: Unsupported IORT Node type =3D %d\n", *IortNodeTyp= e); + AcpiError ( + ACPI_ERROR_VALUE, L"Unsupported IORT Node type =3D %d", *IortNod= eType); } // switch =20 - NodePtr +=3D (*IortNodeLength); Offset +=3D (*IortNodeLength); } // while } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Madt/Madt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Madt/MadtPa= rser.c index 15aa2392b60c..67bbf369ee1a 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Madt/MadtParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Madt/MadtParser.c @@ -17,6 +17,7 @@ #include "AcpiTableParser.h" #include "AcpiViewConfig.h" #include "MadtParser.h" +#include "AcpiViewLog.h" =20 // Local Variables STATIC CONST UINT8* MadtInterruptControllerType; @@ -38,12 +39,8 @@ ValidateGICDSystemVectorBase ( IN VOID* Context ) { - if (*(UINT32*)Ptr !=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: System Vector Base must be zero." - ); - } + UINT32 GicdSystemVectorBase =3D *(UINT32 *) Ptr; + AssertConstraint (L"ACPI", GicdSystemVectorBase =3D=3D 0); } =20 /** @@ -63,36 +60,20 @@ ValidateSpeOverflowInterrupt ( { UINT16 SpeOverflowInterrupt; =20 - SpeOverflowInterrupt =3D *(UINT16*)Ptr; + SpeOverflowInterrupt =3D *(UINT16 *) Ptr; =20 // SPE not supported by this processor if (SpeOverflowInterrupt =3D=3D 0) { return; } =20 - if ((SpeOverflowInterrupt < ARM_PPI_ID_MIN) || - ((SpeOverflowInterrupt > ARM_PPI_ID_MAX) && - (SpeOverflowInterrupt < ARM_PPI_ID_EXTENDED_MIN)) || - (SpeOverflowInterrupt > ARM_PPI_ID_EXTENDED_MAX)) { - IncrementErrorCount (); - Print ( - L"\nERROR: SPE Overflow Interrupt ID of %d is not in the allowed PPI= ID " - L"ranges of %d-%d or %d-%d (for GICv3.1 or later).", - SpeOverflowInterrupt, - ARM_PPI_ID_MIN, - ARM_PPI_ID_MAX, - ARM_PPI_ID_EXTENDED_MIN, - ARM_PPI_ID_EXTENDED_MAX - ); - } else if (SpeOverflowInterrupt !=3D ARM_PPI_ID_PMBIRQ) { - IncrementWarningCount(); - Print ( - L"\nWARNING: SPE Overflow Interrupt ID of %d is not compliant with S= BSA " - L"Level 3 PPI ID assignment: %d.", - SpeOverflowInterrupt, - ARM_PPI_ID_PMBIRQ - ); - } + AssertConstraint (L"ACPI", SpeOverflowInterrupt > ARM_PPI_ID_MIN); + AssertConstraint ( + L"ACPI", + (SpeOverflowInterrupt < ARM_PPI_ID_MAX) || + (SpeOverflowInterrupt > ARM_PPI_ID_EXTENDED_MIN)); + AssertConstraint (L"ACPI", SpeOverflowInterrupt < ARM_PPI_ID_EXTENDED_MA= X); + WarnConstraint (L"SBSA", SpeOverflowInterrupt =3D=3D ARM_PPI_ID_PMBIRQ); } =20 /** @@ -231,7 +212,6 @@ ParseAcpiMadt ( ) { UINT32 Offset; - UINT8* InterruptContollerPtr; UINT32 GICDCount; =20 GICDCount =3D 0; @@ -248,7 +228,6 @@ ParseAcpiMadt ( AcpiTableLength, PARSER_PARAMS (MadtParser) ); - InterruptContollerPtr =3D Ptr + Offset; =20 while (Offset < AcpiTableLength) { // Parse Interrupt Controller Structure to obtain Length. @@ -256,7 +235,7 @@ ParseAcpiMadt ( FALSE, 0, NULL, - InterruptContollerPtr, + Ptr + Offset, AcpiTableLength - Offset, PARSER_PARAMS (MadtInterruptControllerHeaderParser) ); @@ -265,26 +244,14 @@ ParseAcpiMadt ( // successfully read. if ((MadtInterruptControllerType =3D=3D NULL) || (MadtInterruptControllerLength =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient remaining table buffer length to read the " \ - L"Interrupt Controller Structure header. Length =3D %d.\n", - AcpiTableLength - Offset - ); + AcpiError ( + ACPI_ERROR_PARSE, + L"Failed to read the Interrupt Controller Structure header"); return; } =20 - // Validate Interrupt Controller Structure length - if ((*MadtInterruptControllerLength =3D=3D 0) || - ((Offset + (*MadtInterruptControllerLength)) > AcpiTableLength)) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Interrupt Controller Structure length. " \ - L"Length =3D %d. Offset =3D %d. AcpiTableLength =3D %d.\n", - *MadtInterruptControllerLength, - Offset, - AcpiTableLength - ); + if (AssertMemberIntegrity ( + Offset, *MadtInterruptControllerLength, Ptr, AcpiTableLength)) { return; } =20 @@ -294,7 +261,7 @@ ParseAcpiMadt ( TRUE, 2, "GICC", - InterruptContollerPtr, + Ptr + Offset, *MadtInterruptControllerLength, PARSER_PARAMS (GicCParser) ); @@ -303,18 +270,16 @@ ParseAcpiMadt ( =20 case EFI_ACPI_6_3_GICD: { if (++GICDCount > 1) { - IncrementErrorCount (); - Print ( - L"ERROR: Only one GICD must be present," - L" GICDCount =3D %d\n", - GICDCount - ); + AcpiError ( + ACPI_ERROR_CROSS, + L"Only one GICD must be present (now %d)", + GICDCount); } ParseAcpi ( TRUE, 2, "GICD", - InterruptContollerPtr, + Ptr + Offset, *MadtInterruptControllerLength, PARSER_PARAMS (GicDParser) ); @@ -326,7 +291,7 @@ ParseAcpiMadt ( TRUE, 2, "GIC MSI Frame", - InterruptContollerPtr, + Ptr + Offset, *MadtInterruptControllerLength, PARSER_PARAMS (GicMSIFrameParser) ); @@ -338,7 +303,7 @@ ParseAcpiMadt ( TRUE, 2, "GICR", - InterruptContollerPtr, + Ptr + Offset, *MadtInterruptControllerLength, PARSER_PARAMS (GicRParser) ); @@ -350,7 +315,7 @@ ParseAcpiMadt ( TRUE, 2, "GIC ITS", - InterruptContollerPtr, + Ptr + Offset, *MadtInterruptControllerLength, PARSER_PARAMS (GicITSParser) ); @@ -358,17 +323,13 @@ ParseAcpiMadt ( } =20 default: { - IncrementErrorCount (); - Print ( - L"ERROR: Unknown Interrupt Controller Structure," - L" Type =3D %d, Length =3D %d\n", - *MadtInterruptControllerType, - *MadtInterruptControllerLength - ); + AcpiError ( + ACPI_ERROR_VALUE, + L"Interrupt Controller Structure Type =3D %d", + *MadtInterruptControllerType); } } // switch =20 - InterruptContollerPtr +=3D *MadtInterruptControllerLength; Offset +=3D *MadtInterruptControllerLength; } // while } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Mcfg/Mcfg= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Mcfg/McfgPa= rser.c index 9da4d60e8497..7a7eaa374acf 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Mcfg/McfgParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Mcfg/McfgParser.c @@ -12,6 +12,7 @@ #include #include "AcpiParser.h" #include "AcpiTableParser.h" +#include "AcpiViewLog.h" =20 // Local variables STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; @@ -57,8 +58,6 @@ ParseAcpiMcfg ( ) { UINT32 Offset; - UINT32 PciCfgOffset; - UINT8* PciCfgSpacePtr; =20 if (!Trace) { return; @@ -73,18 +72,14 @@ ParseAcpiMcfg ( PARSER_PARAMS (McfgParser) ); =20 - PciCfgSpacePtr =3D Ptr + Offset; - while (Offset < AcpiTableLength) { - PciCfgOffset =3D ParseAcpi ( + Offset +=3D ParseAcpi ( TRUE, 2, "PCI Configuration Space", - PciCfgSpacePtr, + Ptr + Offset, (AcpiTableLength - Offset), PARSER_PARAMS (PciCfgSpaceBaseAddrParser) ); - PciCfgSpacePtr +=3D PciCfgOffset; - Offset +=3D PciCfgOffset; } } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/Pptt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/PpttPa= rser.c index 97a5203efb5f..3afb4e103ea9 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/PpttParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Pptt/PpttParser.c @@ -14,6 +14,7 @@ #include "AcpiParser.h" #include "AcpiView.h" #include "AcpiViewConfig.h" +#include "AcpiViewLog.h" #include "PpttParser.h" #include "AcpiViewLog.h" =20 @@ -39,38 +40,20 @@ ValidateCacheNumberOfSets ( IN VOID* Context ) { - UINT32 NumberOfSets; - NumberOfSets =3D *(UINT32*)Ptr; + UINT32 CacheNumberOfSets =3D *(UINT32*) Ptr; =20 - if (NumberOfSets =3D=3D 0) { - IncrementErrorCount (); - Print (L"\nERROR: Cache number of sets must be greater than 0"); - return; - } + AssertConstraint (L"ACPI", CacheNumberOfSets !=3D 0); =20 #if defined(MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - if (NumberOfSets > PPTT_ARM_CCIDX_CACHE_NUMBER_OF_SETS_MAX) { - IncrementErrorCount (); - Print ( - L"\nERROR: When ARMv8.3-CCIDX is implemented the maximum cache numbe= r of " - L"sets must be less than or equal to %d", - PPTT_ARM_CCIDX_CACHE_NUMBER_OF_SETS_MAX - ); + if (AssertConstraint ( + L"ARMv8.3-CCIDX", + CacheNumberOfSets < PPTT_ARM_CCIDX_CACHE_NUMBER_OF_SETS_MAX)) { return; } =20 - if (NumberOfSets > PPTT_ARM_CACHE_NUMBER_OF_SETS_MAX) { - IncrementWarningCount (); - Print ( - L"\nWARNING: Without ARMv8.3-CCIDX, the maximum cache number of sets= " - L"must be less than or equal to %d. Ignore this message if " - L"ARMv8.3-CCIDX is implemented", - PPTT_ARM_CACHE_NUMBER_OF_SETS_MAX - ); - return; - } + WarnConstraint ( + L"No-ARMv8.3-CCIDX", CacheNumberOfSets < PPTT_ARM_CACHE_NUMBER_OF_SETS= _MAX); #endif - } =20 /** @@ -89,14 +72,8 @@ ValidateCacheAssociativity ( IN VOID* Context ) { - UINT8 Associativity; - Associativity =3D *(UINT8*)Ptr; - - if (Associativity =3D=3D 0) { - IncrementErrorCount (); - Print (L"\nERROR: Cache associativity must be greater than 0"); - return; - } + UINT8 CacheAssociativity =3D *Ptr; + AssertConstraint (L"ACPI", CacheAssociativity !=3D 0); } =20 /** @@ -120,25 +97,14 @@ ValidateCacheLineSize ( // LineSize, bits [2:0] // (Log2(Number of bytes in cache line)) - 4. =20 - UINT16 LineSize; - LineSize =3D *(UINT16*)Ptr; - - if ((LineSize < PPTT_ARM_CACHE_LINE_SIZE_MIN) || - (LineSize > PPTT_ARM_CACHE_LINE_SIZE_MAX)) { - IncrementErrorCount (); - Print ( - L"\nERROR: The cache line size must be between %d and %d bytes" - L" on ARM Platforms.", - PPTT_ARM_CACHE_LINE_SIZE_MIN, - PPTT_ARM_CACHE_LINE_SIZE_MAX - ); - return; - } + UINT16 CacheLineSize =3D *(UINT16 *) Ptr; =20 - if ((LineSize & (LineSize - 1)) !=3D 0) { - IncrementErrorCount (); - Print (L"\nERROR: The cache line size is not a power of 2."); - } + AssertConstraint ( + L"ARM", + (CacheLineSize >=3D PPTT_ARM_CACHE_LINE_SIZE_MIN && + CacheLineSize <=3D PPTT_ARM_CACHE_LINE_SIZE_MAX)); + + AssertConstraint (L"ARM", BitFieldCountOnes32 (CacheLineSize, 0, 15) =3D= =3D 1); #endif } =20 @@ -160,17 +126,8 @@ ValidateCacheAttributes ( // Reference: Advanced Configuration and Power Interface (ACPI) Specific= ation // Version 6.2 Errata A, September 2017 // Table 5-153: Cache Type Structure - UINT8 Attributes; - Attributes =3D *(UINT8*)Ptr; - - if ((Attributes & 0xE0) !=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: Attributes bits [7:5] are reserved and must be zero.", - Attributes - ); - return; - } + UINT8 Attributes =3D *(UINT8 *) Ptr; + AssertConstraint (L"ACPI", BitFieldCountOnes32 (Attributes, 5, 7) =3D=3D= 0); } =20 /** @@ -255,7 +212,6 @@ DumpProcessorHierarchyNodeStructure ( { UINT32 Offset; UINT32 Index; - CHAR16 Buffer[OUTPUT_FIELD_COLUMN_WIDTH]; =20 Offset =3D ParseAcpi ( TRUE, @@ -268,48 +224,22 @@ DumpProcessorHierarchyNodeStructure ( =20 // Check if the values used to control the parsing logic have been // successfully read. - if (NumberOfPrivateResources =3D=3D NULL) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient Processor Hierarchy Node length. Length =3D %d= .\n", - Length - ); - return; - } - - // Make sure the Private Resource array lies inside this structure - if (Offset + (*NumberOfPrivateResources * sizeof (UINT32)) > Length) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Number of Private Resources. " \ - L"PrivateResourceCount =3D %d. RemainingBufferLength =3D %d. " \ - L"Parsing of this structure aborted.\n", - *NumberOfPrivateResources, - Length - Offset - ); + if(NumberOfPrivateResources =3D=3D NULL) { + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse processor hierarchy"); return; } =20 - Index =3D 0; - // Parse the specified number of private resource references or the Proc= essor // Hierarchy Node length. Whichever is minimum. - while (Index < *NumberOfPrivateResources) { - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"Private resources [%d]", - Index - ); + for (Index =3D 0; Index < *NumberOfPrivateResources; Index++) { + if (AssertMemberIntegrity (Offset, sizeof (UINT32), Ptr, Length)) { + return; + } =20 - PrintFieldName (4, Buffer); - Print ( - L"0x%x\n", - *((UINT32*)(Ptr + Offset)) - ); + PrintFieldName (4, L"Private resources [%d]", Index); + AcpiInfo (L"0x%x", *(UINT32 *) (Ptr + Offset)); =20 Offset +=3D sizeof (UINT32); - Index++; } } =20 @@ -386,7 +316,6 @@ ParseAcpiPptt ( ) { UINT32 Offset; - UINT8* ProcessorTopologyStructurePtr; =20 if (!Trace) { return; @@ -401,15 +330,13 @@ ParseAcpiPptt ( PARSER_PARAMS (PpttParser) ); =20 - ProcessorTopologyStructurePtr =3D Ptr + Offset; - while (Offset < AcpiTableLength) { // Parse Processor Hierarchy Node Structure to obtain Type and Length. ParseAcpi ( FALSE, 0, NULL, - ProcessorTopologyStructurePtr, + Ptr + Offset, AcpiTableLength - Offset, PARSER_PARAMS (ProcessorTopologyStructureHeaderParser) ); @@ -418,62 +345,42 @@ ParseAcpiPptt ( // successfully read. if ((ProcessorTopologyStructureType =3D=3D NULL) || (ProcessorTopologyStructureLength =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient remaining table buffer length to read the " \ - L"processor topology structure header. Length =3D %d.\n", - AcpiTableLength - Offset - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse processor topology"); return; } =20 // Validate Processor Topology Structure length - if ((*ProcessorTopologyStructureLength =3D=3D 0) || - ((Offset + (*ProcessorTopologyStructureLength)) > AcpiTableLength)= ) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Processor Topology Structure length. " \ - L"Length =3D %d. Offset =3D %d. AcpiTableLength =3D %d.\n", - *ProcessorTopologyStructureLength, - Offset, - AcpiTableLength - ); + if (AssertMemberIntegrity ( + Offset, *ProcessorTopologyStructureLength, Ptr, AcpiTableLength)= ) { return; } =20 PrintFieldName (2, L"* Structure Offset *"); - Print (L"0x%x\n", Offset); + AcpiInfo (L"0x%x", Offset); =20 switch (*ProcessorTopologyStructureType) { case EFI_ACPI_6_2_PPTT_TYPE_PROCESSOR: DumpProcessorHierarchyNodeStructure ( - ProcessorTopologyStructurePtr, + Ptr + Offset, *ProcessorTopologyStructureLength ); break; case EFI_ACPI_6_2_PPTT_TYPE_CACHE: DumpCacheTypeStructure ( - ProcessorTopologyStructurePtr, + Ptr + Offset, *ProcessorTopologyStructureLength ); break; case EFI_ACPI_6_2_PPTT_TYPE_ID: DumpIDStructure ( - ProcessorTopologyStructurePtr, + Ptr + Offset, *ProcessorTopologyStructureLength ); break; default: - IncrementErrorCount (); - Print ( - L"ERROR: Unknown processor topology structure:" - L" Type =3D %d, Length =3D %d\n", - *ProcessorTopologyStructureType, - *ProcessorTopologyStructureLength - ); + AcpiError (ACPI_ERROR_VALUE, L"Unknown processor topology structur= e"); } =20 - ProcessorTopologyStructurePtr +=3D *ProcessorTopologyStructureLength; Offset +=3D *ProcessorTopologyStructureLength; } // while } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Rsdp/Rsdp= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Rsdp/RsdpPa= rser.c index f4a8732a7db7..b71b59d86ee1 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Rsdp/RsdpParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Rsdp/RsdpParser.c @@ -11,6 +11,7 @@ #include #include "AcpiParser.h" #include "AcpiTableParser.h" +#include "AcpiViewLog.h" =20 // Local Variables STATIC CONST UINT64* XsdtAddress; @@ -36,17 +37,8 @@ ValidateRsdtAddress ( // Root System Description Pointer (RSDP), ACPI ? 5.2.5. // - Within the RSDP, the RsdtAddress field must be null (zero) and the // XsdtAddresss MUST be a valid, non-null, 64-bit value. - UINT32 RsdtAddr; - - RsdtAddr =3D *(UINT32*)Ptr; - - if (RsdtAddr !=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: Rsdt Address =3D 0x%p. This must be NULL on ARM Platforms= .", - RsdtAddr - ); - } + UINT32 RsdtAddr =3D *(UINT32 *) Ptr; + AssertConstraint (L"ARM", RsdtAddr =3D=3D 0); #endif } =20 @@ -71,17 +63,8 @@ ValidateXsdtAddress ( // Root System Description Pointer (RSDP), ACPI ? 5.2.5. // - Within the RSDP, the RsdtAddress field must be null (zero) and the // XsdtAddresss MUST be a valid, non-null, 64-bit value. - UINT64 XsdtAddr; - - XsdtAddr =3D *(UINT64*)Ptr; - - if (XsdtAddr =3D=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: Xsdt Address =3D 0x%p. This must not be NULL on ARM Platf= orms.", - XsdtAddr - ); - } + UINT64 XsdtAddr =3D *(UINT64 *) Ptr; + AssertConstraint (L"ARM", XsdtAddr !=3D 0); #endif } =20 @@ -141,12 +124,7 @@ ParseAcpiRsdp ( // Check if the values used to control the parsing logic have been // successfully read. if (XsdtAddress =3D=3D NULL) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient table length. AcpiTableLength =3D %d." \ - L"RSDP parsing aborted.\n", - AcpiTableLength - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse the RSDP table"); return; } =20 @@ -154,11 +132,11 @@ ParseAcpiRsdp ( // and does not parse the RSDT table. Platforms provide the // RSDT to enable compatibility with ACPI 1.0 operating systems. // Therefore the RSDT should not be used on ARM platforms. - if ((*XsdtAddress) =3D=3D 0) { - IncrementErrorCount (); - Print (L"ERROR: XSDT Pointer is not set. RSDP parsing aborted.\n"); + if (*XsdtAddress =3D=3D 0) { + AcpiError ( + ACPI_ERROR_VALUE, L"XSDT Pointer is not set. RSDP parsing aborted."); return; } =20 - ProcessAcpiTable ((UINT8*)(UINTN)(*XsdtAddress)); + ProcessAcpiTable ((VOID *) *XsdtAddress); } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/Slit= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/SlitPa= rser.c index cedfc8a71849..2cd051e72502 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/SlitParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Slit/SlitParser.c @@ -28,11 +28,6 @@ STATIC CONST ACPI_PARSER SlitParser[] =3D { (VOID**)&SlitSystemLocalityCount, NULL, NULL} }; =20 -/** - Macro to get the value of a System Locality -**/ -#define SLIT_ELEMENT(Ptr, i, j) *(Ptr + (i * LocalityCount) + j) - /** This function parses the ACPI SLIT table. When trace is enabled this function parses the SLIT table and @@ -58,11 +53,11 @@ ParseAcpiSlit ( ) { UINT32 Offset; - UINT32 Count; - UINT32 Index; + UINT32 Index1; + UINT32 Index2; UINT32 LocalityCount; - UINT8* LocalityPtr; - CHAR16 Buffer[80]; // Used for AsciiName param of ParseAcpi + CHAR16 Buffer[256]; + UINTN StrLen; =20 if (!Trace) { return; @@ -80,11 +75,7 @@ ParseAcpiSlit ( // Check if the values used to control the parsing logic have been // successfully read. if (SlitSystemLocalityCount =3D=3D NULL) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient table length. AcpiTableLength =3D %d.\n", - AcpiTableLength - ); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse the SLIT table"); return; } =20 @@ -100,89 +91,64 @@ ParseAcpiSlit ( =3D 65535 =3D MAX_UINT16 */ - if (*SlitSystemLocalityCount > MAX_UINT16) { - IncrementErrorCount (); - Print ( - L"ERROR: The Number of System Localities provided can't be represent= ed " \ - L"in the SLIT table. SlitSystemLocalityCount =3D %ld. " \ - L"MaxLocalityCountAllowed =3D %d.\n", - *SlitSystemLocalityCount, - MAX_UINT16 - ); + if (AssertConstraint (L"ACPI", *SlitSystemLocalityCount <=3D MAX_UINT16)= ) { return; } =20 - LocalityCount =3D (UINT32)*SlitSystemLocalityCount; + LocalityCount =3D (UINT32) *SlitSystemLocalityCount; =20 // Make sure system localities fit in the table buffer provided - if (Offset + (LocalityCount * LocalityCount) > AcpiTableLength) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Number of System Localities. " \ - L"SlitSystemLocalityCount =3D %ld. AcpiTableLength =3D %d.\n", - *SlitSystemLocalityCount, - AcpiTableLength - ); + if (AssertMemberIntegrity ( + Offset, (LocalityCount * LocalityCount), Ptr, AcpiTableLength)) { return; } =20 - LocalityPtr =3D Ptr + Offset; - // We only print the Localities if the count is less than 16 // If the locality count is more than 16 then refer to the // raw data dump. if (LocalityCount < 16) { - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"Entry[0x%lx][0x%lx]", - LocalityCount, - LocalityCount - ); - PrintFieldName (0, Buffer); - Print (L"\n"); - Print (L" "); - for (Index =3D 0; Index < LocalityCount; Index++) { - Print (L" (%3d) ", Index); + PrintFieldName (0, L"Entry[0x%lx][0x%lx]", LocalityCount, LocalityCoun= t); + AcpiInfo (L""); + UnicodeSPrint (Buffer, sizeof (Buffer), L" "); + for (Index1 =3D 0; Index1 < LocalityCount; Index1++) { + StrLen =3D StrnLenS (Buffer, sizeof (Buffer)); + UnicodeSPrint ( + Buffer + StrLen, sizeof (Buffer) - StrLen, L" (%3d) ", Index1); } - Print (L"\n"); - for (Count =3D 0; Count< LocalityCount; Count++) { - Print (L" (%3d) ", Count); - for (Index =3D 0; Index < LocalityCount; Index++) { - Print (L" %3d ", SLIT_ELEMENT (LocalityPtr, Count, Index)); + AcpiInfo (L"%s", Buffer); + for (Index1 =3D 0; Index1 < LocalityCount; Index1++) { + UnicodeSPrint (Buffer, sizeof (Buffer), L" (%3d) ", Index1); + for (Index2 =3D 0; Index2 < LocalityCount; Index2++) { + StrLen =3D StrnLenS (Buffer, sizeof (Buffer)); + UnicodeSPrint ( + Buffer + StrLen, + sizeof (Buffer) - StrLen, + L" %3d ", + *(Ptr + Offset + Index1 * LocalityCount + Index2)); } - Print (L"\n"); + AcpiInfo (L"%s", Buffer); } } =20 // Validate - for (Count =3D 0; Count < LocalityCount; Count++) { - for (Index =3D 0; Index < LocalityCount; Index++) { - // Element[x][x] must be equal to 10 - if ((Count =3D=3D Index) && (SLIT_ELEMENT (LocalityPtr, Count,Index)= !=3D 10)) { - IncrementErrorCount (); - Print ( - L"ERROR: Diagonal Element[0x%lx][0x%lx] (%3d)." - L" Normalized Value is not 10\n", - Count, - Index, - SLIT_ELEMENT (LocalityPtr, Count, Index) - ); - } + for (Index1 =3D 0; Index1 < LocalityCount; Index1++) { + // Element[x][x] must be equal to 10 + if (*(Ptr + Offset + Index1 * LocalityCount + Index2) !=3D 10) { + AcpiError ( + ACPI_ERROR_VALUE, L"SLIT Element[%d][%d] !=3D 10", Index1, Index1); + } + for (Index2 =3D 0; Index2 < Index1; Index2++) { // Element[i][j] must be equal to Element[j][i] - if (SLIT_ELEMENT (LocalityPtr, Count, Index) !=3D - SLIT_ELEMENT (LocalityPtr, Index, Count)) { - IncrementErrorCount (); - Print ( - L"ERROR: Relative distances for Element[0x%lx][0x%lx] (%3d) and = \n" - L"Element[0x%lx][0x%lx] (%3d) do not match.\n", - Count, - Index, - SLIT_ELEMENT (LocalityPtr, Count, Index), - Index, - Count, - SLIT_ELEMENT (LocalityPtr, Index, Count) - ); + if ( + *(Ptr + Offset + Index1 * LocalityCount + Index2) !=3D + *(Ptr + Offset + Index2 * LocalityCount + Index1)) { + AcpiError ( + ACPI_ERROR_VALUE, + L"SLIT Element[%d][%d] !=3D SLIT Element[%d][%d]", + Index1, + Index2, + Index2, + Index1); } } } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Spcr/Spcr= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Spcr/SpcrPa= rser.c index 3b06b05dee8c..bc3c12e720f2 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Spcr/SpcrParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Spcr/SpcrParser.c @@ -14,6 +14,7 @@ #include #include "AcpiParser.h" #include "AcpiTableParser.h" +#include "AcpiViewLog.h" =20 // Local variables STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo; @@ -34,18 +35,11 @@ ValidateInterruptType ( ) { #if defined (MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - UINT8 InterruptType; - - InterruptType =3D *Ptr; - - if (InterruptType !=3D - EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERRUPT_TYPE_GIC)= { - IncrementErrorCount (); - Print ( - L"\nERROR: InterruptType =3D %d. This must be 8 on ARM Platforms", - InterruptType - ); - } + UINT8 InterruptType =3D *Ptr; + AssertConstraint ( + L"ARM", + InterruptType =3D=3D + EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERRUPT_TYPE_GIC); #endif } =20 @@ -65,17 +59,8 @@ ValidateIrq ( ) { #if defined (MDE_CPU_ARM) || defined (MDE_CPU_AARCH64) - UINT8 Irq; - - Irq =3D *Ptr; - - if (Irq !=3D 0) { - IncrementErrorCount (); - Print ( - L"\nERROR: Irq =3D %d. This must be zero on ARM Platforms\n", - Irq - ); - } + UINT8 Irq =3D *Ptr; + AssertConstraint (L"ARM", Irq =3D=3D 0); #endif } =20 diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/Srat= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/SratPa= rser.c index 568a0400bf07..eafc7e7942a3 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/SratParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Srat/SratParser.c @@ -37,10 +37,8 @@ ValidateSratReserved ( IN VOID* Context ) { - if (*(UINT32*)Ptr !=3D 1) { - IncrementErrorCount (); - Print (L"\nERROR: Reserved should be 1 for backward compatibility.\n"); - } + UINT32 Reserved =3D *(UINT32 *) Ptr; + AssertConstraint (L"Backwards-Compatibility", Reserved =3D=3D 1); } =20 /** @@ -59,18 +57,8 @@ ValidateSratDeviceHandleType ( IN VOID* Context ) { - UINT8 DeviceHandleType; - - DeviceHandleType =3D *Ptr; - - if (DeviceHandleType > EFI_ACPI_6_3_PCI_DEVICE_HANDLE) { - IncrementErrorCount (); - Print ( - L"\nERROR: Invalid Device Handle Type: %d. Must be between 0 and %d.= ", - DeviceHandleType, - EFI_ACPI_6_3_PCI_DEVICE_HANDLE - ); - } + UINT8 DeviceHandleType =3D *Ptr; + AssertConstraint (L"ACPI", DeviceHandleType < EFI_ACPI_6_3_PCI_DEVICE_HA= NDLE); } =20 /** @@ -87,9 +75,9 @@ DumpSratPciBdfNumber ( IN UINT8* Ptr ) { - CHAR16 Buffer[OUTPUT_FIELD_COLUMN_WIDTH]; - - Print (L"\n"); + UINT16 Bus; + UINT16 Device; + UINT16 Function; =20 /* The PCI BDF Number subfields are printed in the order specified in the= ACPI @@ -102,43 +90,13 @@ DumpSratPciBdfNumber ( +-----+------+------+ */ =20 + Bus =3D BitFieldRead16(*(UINT16 *) Ptr, 0, 7); + Device =3D BitFieldRead16(*(UINT16 *) Ptr, 8, 10); + Function =3D BitFieldRead16(*(UINT16 *) Ptr, 11, 15); + // Print PCI Bus Number (Bits 7:0 of Byte 2) - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"PCI Bus Number" - ); - PrintFieldName (4, Buffer); - Print ( - L"0x%x\n", - *Ptr - ); - - Ptr++; - - // Print PCI Device Number (Bits 7:3 of Byte 3) - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"PCI Device Number" - ); - PrintFieldName (4, Buffer); - Print ( - L"0x%x\n", - (*Ptr & (BIT7 | BIT6 | BIT5 | BIT4 | BIT3)) >> 3 - ); - - // PCI Function Number (Bits 2:0 of Byte 3) - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"PCI Function Number" - ); - PrintFieldName (4, Buffer); - Print ( - L"0x%x\n", - *Ptr & (BIT2 | BIT1 | BIT0) - ); + PrintFieldName (4, L"PCI Bus:Device.Function"); + AcpiInfo (L"%4X:%2X.%d", Bus, Device, Function); } =20 /** @@ -176,8 +134,7 @@ DumpSratDeviceHandle ( ) { if (SratDeviceHandleType =3D=3D NULL) { - IncrementErrorCount (); - Print (L"\nERROR: Device Handle Type read incorrectly.\n"); + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse Device Handle"); return; } =20 @@ -222,7 +179,7 @@ DumpSratApicProximity ( =20 ProximityDomain =3D Ptr[0] | (Ptr[1] << 8) | (Ptr[2] << 16); =20 - Print (Format, ProximityDomain); + AcpiInfo ((CHAR16 *)Format, ProximityDomain); } =20 /** @@ -360,7 +317,6 @@ ParseAcpiSrat ( ) { UINT32 Offset; - UINT8* ResourcePtr; UINT32 GicCAffinityIndex; UINT32 GicITSAffinityIndex; UINT32 GenericInitiatorAffinityIndex; @@ -389,155 +345,113 @@ ParseAcpiSrat ( PARSER_PARAMS (SratParser) ); =20 - ResourcePtr =3D Ptr + Offset; - while (Offset < AcpiTableLength) { ParseAcpi ( FALSE, 0, NULL, - ResourcePtr, + Ptr + Offset, AcpiTableLength - Offset, PARSER_PARAMS (SratResourceAllocationParser) ); =20 // Check if the values used to control the parsing logic have been // successfully read. - if ((SratRAType =3D=3D NULL) || - (SratRALength =3D=3D NULL)) { - IncrementErrorCount (); - Print ( - L"ERROR: Insufficient remaining table buffer length to read the " \ - L"Static Resource Allocation structure header. Length =3D %d.\n", - AcpiTableLength - Offset - ); + if ((SratRAType =3D=3D NULL) || (SratRALength =3D=3D NULL)) { + AcpiError (ACPI_ERROR_PARSE, L"Failed to parse SRAT header"); return; } =20 // Validate Static Resource Allocation Structure length - if ((*SratRALength =3D=3D 0) || - ((Offset + (*SratRALength)) > AcpiTableLength)) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid Static Resource Allocation Structure length. " \ - L"Length =3D %d. Offset =3D %d. AcpiTableLength =3D %d.\n", - *SratRALength, - Offset, - AcpiTableLength - ); + if (AssertMemberIntegrity(Offset, *SratRALength, Ptr, AcpiTableLength)= ) { return; } =20 switch (*SratRAType) { case EFI_ACPI_6_3_GICC_AFFINITY: - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "GICC Affinity Structure [%d]", - GicCAffinityIndex++ - ); + AcpiLog ( + ACPI_ITEM, L"GICC Affinity Structure [%d]", GicCAffinityIndex++); ParseAcpi ( TRUE, 2, Buffer, - ResourcePtr, + Ptr + Offset, *SratRALength, - PARSER_PARAMS (SratGicCAffinityParser) - ); + PARSER_PARAMS (SratGicCAffinityParser)); break; =20 case EFI_ACPI_6_3_GIC_ITS_AFFINITY: - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "GIC ITS Affinity Structure [%d]", - GicITSAffinityIndex++ - ); + AcpiLog ( + ACPI_ITEM, L"GIC ITS Affinity Structure [%d]", GicITSAffinityInd= ex++); ParseAcpi ( TRUE, 2, Buffer, - ResourcePtr, + Ptr + Offset, *SratRALength, - PARSER_PARAMS (SratGicITSAffinityParser) - ); + PARSER_PARAMS (SratGicITSAffinityParser)); break; =20 case EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY: - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "Generic Initiator Affinity Structure [%d]", - GenericInitiatorAffinityIndex++ - ); + AcpiLog ( + ACPI_ITEM, + L"Generic Initiator Affinity Structure [%d]", + GenericInitiatorAffinityIndex++); ParseAcpi ( TRUE, 2, Buffer, - ResourcePtr, + Ptr + Offset, *SratRALength, - PARSER_PARAMS (SratGenericInitiatorAffinityParser) - ); + PARSER_PARAMS (SratGenericInitiatorAffinityParser)); break; =20 case EFI_ACPI_6_3_MEMORY_AFFINITY: - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "Memory Affinity Structure [%d]", - MemoryAffinityIndex++ - ); + AcpiLog ( + ACPI_ITEM, L"Memory Affinity Structure [%d]", MemoryAffinityInde= x++); ParseAcpi ( TRUE, 2, Buffer, - ResourcePtr, + Ptr + Offset, *SratRALength, - PARSER_PARAMS (SratMemAffinityParser) - ); + PARSER_PARAMS (SratMemAffinityParser)); break; =20 case EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY: - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "APIC/SAPIC Affinity Structure [%d]", - ApicSapicAffinityIndex++ - ); + AcpiLog ( + ACPI_ITEM, + L"APIC/SAPIC Affinity Structure [%d]", + ApicSapicAffinityIndex++); ParseAcpi ( TRUE, 2, Buffer, - ResourcePtr, + Ptr + Offset, *SratRALength, - PARSER_PARAMS (SratApciSapicAffinityParser) - ); + PARSER_PARAMS (SratApciSapicAffinityParser)); break; =20 case EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_AFFINITY: - AsciiSPrint ( - Buffer, - sizeof (Buffer), - "X2APIC Affinity Structure [%d]", - X2ApicAffinityIndex++ - ); + AcpiLog ( + ACPI_ITEM, L"X2APIC Affinity Structure [%d]", X2ApicAffinityInde= x++); ParseAcpi ( TRUE, 2, Buffer, - ResourcePtr, + Ptr + Offset, *SratRALength, - PARSER_PARAMS (SratX2ApciAffinityParser) - ); + PARSER_PARAMS (SratX2ApciAffinityParser)); break; =20 default: - IncrementErrorCount (); - Print (L"ERROR: Unknown SRAT Affinity type =3D 0x%x\n", *SratRATyp= e); + AcpiError ( + ACPI_ERROR_VALUE, + L"Unknown SRAT Affinity type =3D 0x%x\n", + *SratRAType); break; } =20 - ResourcePtr +=3D (*SratRALength); Offset +=3D (*SratRALength); } } diff --git a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/Xsdt= Parser.c b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/XsdtPa= rser.c index 771c4f322b8e..564e231a627a 100644 --- a/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/XsdtParser.c +++ b/ShellPkg/Library/UefiShellAcpiViewCommandLib/Parsers/Xsdt/XsdtParser.c @@ -55,87 +55,43 @@ ParseAcpiXsdt ( IN UINT8 AcpiTableRevision ) { - UINT32 Offset; UINT32 TableOffset; - UINT64* TablePointer; + UINT64** TablePointer; UINTN EntryIndex; - CHAR16 Buffer[32]; =20 - Offset =3D ParseAcpi ( - Trace, - 0, - "XSDT", - Ptr, - AcpiTableLength, - PARSER_PARAMS (XsdtParser) - ); - - TableOffset =3D Offset; + TableOffset =3D ParseAcpi ( + Trace, 0, "XSDT", Ptr, AcpiTableLength, PARSER_PARAMS (XsdtParser)); =20 + EntryIndex =3D 0; if (Trace) { - EntryIndex =3D 0; - TablePointer =3D (UINT64*)(Ptr + TableOffset); - while (Offset < AcpiTableLength) { + for (TablePointer =3D (UINT64 **)(Ptr + TableOffset); + (UINT8 *) TablePointer < Ptr + AcpiTableLength; + TablePointer++) { + CONST UINT32* Signature; CONST UINT32* Length; CONST UINT8* Revision; =20 - if ((UINT64*)(UINTN)(*TablePointer) !=3D NULL) { - UINT8* SignaturePtr; - - ParseAcpiHeader ( - (UINT8*)(UINTN)(*TablePointer), - &Signature, - &Length, - &Revision - ); - - SignaturePtr =3D (UINT8*)Signature; - - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"Entry[%d] - %c%c%c%c", - EntryIndex++, - SignaturePtr[0], - SignaturePtr[1], - SignaturePtr[2], - SignaturePtr[3] - ); + if (*TablePointer !=3D NULL) { + ParseAcpiHeader (*TablePointer, &Signature, &Length, &Revision); + PrintFieldName (2, L"Entry[%d] - %.4a", EntryIndex++, Signature); + AcpiInfo (L"0x%lx", *TablePointer); } else { - UnicodeSPrint ( - Buffer, - sizeof (Buffer), - L"Entry[%d]", - EntryIndex++ - ); - } - - PrintFieldName (2, Buffer); - Print (L"0x%lx\n", *TablePointer); - - // Validate the table pointers are not NULL - if ((UINT64*)(UINTN)(*TablePointer) =3D=3D NULL) { - IncrementErrorCount (); - Print ( - L"ERROR: Invalid table entry at 0x%lx, table address is 0x%lx\n", - TablePointer, - *TablePointer - ); + PrintFieldName (2, L"Entry[%d]", EntryIndex++); + AcpiInfo (L"NULL"); + AcpiError (ACPI_ERROR_VALUE, L"Invalid table entry"); } - Offset +=3D sizeof (UINT64); - TablePointer++; - } // while + } } =20 // Process the tables - Offset =3D TableOffset; - TablePointer =3D (UINT64*)(Ptr + TableOffset); - while (Offset < AcpiTableLength) { - if ((UINT64*)(UINTN)(*TablePointer) !=3D NULL) { - ProcessAcpiTable ((UINT8*)(UINTN)(*TablePointer)); + for (TablePointer =3D (UINT64 **)(Ptr + TableOffset); + (UINT8 *) TablePointer < Ptr + AcpiTableLength; + TablePointer++) { + + if (*TablePointer !=3D NULL) { + ProcessAcpiTable (*TablePointer); } - Offset +=3D sizeof (UINT64); - TablePointer++; - } // while + + } } --=20 2.24.1.windows.2 -=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 (#61806): https://edk2.groups.io/g/devel/message/61806 Mute This Topic: https://groups.io/mt/75193744/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-