From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 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) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False 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 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.51,430,1526367600"; d="scan'208";a="76267016" 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 From: Yonghong Zhu To: edk2-devel@lists.01.org Cc: Liming Gao , Michael Kinney , Kevin W Shaw 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: [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: , X-List-Received-Date: Wed, 01 Aug 2018 03:24:11 -0000 Cc: Liming Gao Cc: Michael Kinney Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Yonghong Zhu --- 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. ********** -#### 13.6.2.4 Field value for Structure PCD -If the Pcd is a Structure Pcd, every field value that user specified in DSC/DEC -file and build command will print out. The field value is from DSC/DEC file or -build command, not from the final structure byte array, and the field order is -same as it in DSC/DEC file. when the field value is from build command, tool 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 two parts. +One is the final Pcd value and its field value, the field value is from FDF file, +DSC file PCD Section or build option, not from the final structure byte array, +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 from FDF file, +it will have additional *F Flag before the field name, when the field value from +build option, it will have additional *B Flag before the field name. The other part +is the DEC default value and its field value, this part is optional. The field 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 matter 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 matter 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 section, no +matter whether the value is same with DEC file, there will display a *P Flag before +the PCD name. +********** #### Example ``` gEfiMdePkgTokenSpaceGuid *B TestDynamicExHii : DEXHII (TEST) (SKU1) (STANDARD) = { 0xff,0x01,0x00,0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x91,0x57,0x00,0x00,0x00, 0x00,0x64,0x00,0x00,0x00} .A = 0x1 - *B .C = 0x0 .Array = {0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x91,0x57} + *B .C = 0x0 .D = 0x64 : DEXHII (TEST) (SKU1) (Manufacturing) = { 0xff,0x02,0x00,0x2e,0xf6,0x08,0x6f,0x20,0x5c,0x8e,0x49,0x91,0x57,0x00,0x00,0x00, 0x00,0x68,0x00,0x00,0x00} .A = 0x2 - *B .C = 0x0 .Array = {0x2e,0xf6,0x08,0x6f,0x20,0x5c,0x8e,0x49,0x91,0x57} + *B .C = 0x0 .D = 0x68 DEC DEFAULT = {0xFF,0xFF} .A = 0xF .C = 0xF *P TestFix : FIXED (TEST) = { 0xff,0x02,0x00,0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x91,0x57,0x00,0x00,0x00, 0x00,0x64,0x00,0x00,0x00} .A = 0x2 - .C = 0x0 .Array = {0x2e,0xf6,0x08,0x6f,0x19,0x5c,0x8e,0x49,0x91,0x57} + .C = 0x0 .D = 0x64 DEC DEFAULT = {0xFF,0xFF} .A = 0xF .C = 0xF ``` -- 2.6.1.windows.1