From nobody Fri Apr 19 17:52:06 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org; dmarc=fail(p=none dis=none) header.from=intel.com Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1533093853166471.3487592131395; Tue, 31 Jul 2018 20:24:13 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 16961210C66B9; Tue, 31 Jul 2018 20:24:12 -0700 (PDT) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id DF276210C66B3 for ; Tue, 31 Jul 2018 20:24:10 -0700 (PDT) Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 31 Jul 2018 20:24:09 -0700 Received: from shwdeopenpsi168.ccr.corp.intel.com ([10.239.158.129]) by fmsmga004.fm.intel.com with ESMTP; 31 Jul 2018 20:24:08 -0700 X-Original-To: edk2-devel@lists.01.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=192.55.52.88; helo=mga01.intel.com; envelope-from=yonghong.zhu@intel.com; receiver=edk2-devel@lists.01.org X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.51,430,1526367600"; d="scan'208";a="76267016" From: Yonghong Zhu To: edk2-devel@lists.01.org Date: Wed, 1 Aug 2018 11:24:06 +0800 Message-Id: <1533093846-12772-1-git-send-email-yonghong.zhu@intel.com> X-Mailer: git-send-email 2.6.1.windows.1 Subject: [edk2] [Patch] Build Spec: Add rules for structure pcd display in the report X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Michael Kinney , Kevin W Shaw , Liming Gao MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Cc: Liming Gao Cc: Michael Kinney Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Yonghong Zhu Reviewed-by: Liming Gao --- 13_build_reports/136_global_pcd_section.md | 32 +++++++++++++++++++++-----= ---- 1 file changed, 23 insertions(+), 9 deletions(-) diff --git a/13_build_reports/136_global_pcd_section.md b/13_build_reports/= 136_global_pcd_section.md index 64bda35..1a072b3 100644 --- a/13_build_reports/136_global_pcd_section.md +++ b/13_build_reports/136_global_pcd_section.md @@ -142,44 +142,58 @@ These lines are formatted as: ********** **Note:** Global PCD section is present when **PCD** is specified in **-Y** option. ********** =20 -#### 13.6.2.4 Field value for Structure PCD -If the Pcd is a Structure Pcd, every field value that user specified in DS= C/DEC -file and build command will print out. The field value is from DSC/DEC fil= e or -build command, not from the final structure byte array, and the field orde= r is -same as it in DSC/DEC file. when the field value is from build command, to= ol will -additional print a *B Flag. +#### 13.6.2.4 Rules for Structure PCD +If the Pcd is a Structure Pcd, it display in the report file would have tw= o parts. +One is the final Pcd value and its field value, the field value is from FD= F file, +DSC file PCD Section or build option, not from the final structure byte ar= ray, +and the field order is sorted by the field name. When the field value from= DSC file +PCD Section, it will not have additional *P Flag, when the field value fro= m FDF file, +it will have additional *F Flag before the field name, when the field valu= e from +build option, it will have additional *B Flag before the field name. The o= ther part +is the DEC default value and its field value, this part is optional. The f= ield value +in this part is from DEC file, and the field order is sorted by the field = name. + +********** +**Note:** When the structure Pcd have some value from build option, no mat= ter whether +the value is same with FDF or DSC file or DEC file, there will display a *= B Flag before +the PCD name. When the structure Pcd have some value from FDF file, no mat= ter whether +the value is same with DSC file or DEC file, there will display a *F Flag = before the +PCD name. When the structure Pcd value have some value from DSC file PCD s= ection, no +matter whether the value is same with DEC file, there will display a *P Fl= ag before +the PCD name. +********** =20 #### Example =20 ``` gEfiMdePkgTokenSpaceGuid *B TestDynamicExHii : DEXHII (TEST) (SKU1) (STANDARD) =3D= { 0xff,0x01,0x00,0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x91,0x57,0x00,= 0x00,0x00, 0x00,0x64,0x00,0x00,0x00} .A =3D 0x1 - *B .C =3D 0x0 .Array =3D {0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x9= 1,0x57} + *B .C =3D 0x0 .D =3D 0x64 : DEXHII (TEST) (SKU1) (Manufacturing= ) =3D { 0xff,0x02,0x00,0x2e,0xf6,0x08,0x6f,0x20,0x5c,0x8e,0x49,0x91,0x57,0x00,= 0x00,0x00, 0x00,0x68,0x00,0x00,0x00} .A =3D 0x2 - *B .C =3D 0x0 .Array =3D {0x2e,0xf6,0x08,0x6f,0x20,0x5c,0x8e,0x49,0x9= 1,0x57} + *B .C =3D 0x0 .D =3D 0x68 DEC DEFAULT =3D {0xFF,0xFF} .A =3D 0xF .C =3D 0xF *P TestFix : FIXED (TEST) =3D { 0xff,0x02,0x00,0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x91,0x57,0x00,= 0x00,0x00, 0x00,0x64,0x00,0x00,0x00} .A =3D 0x2 - .C =3D 0x0 .Array =3D {0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x9= 1,0x57} + .C =3D 0x0 .D =3D 0x64 DEC DEFAULT =3D {0xFF,0xFF} .A =3D 0xF .C =3D 0xF ``` --=20 2.6.1.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel