From nobody Sun May 5 03:59:23 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 1528201086220113.46960317987532; Tue, 5 Jun 2018 05:18:06 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 1EE8B210C6680; Tue, 5 Jun 2018 05:18:05 -0700 (PDT) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) (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 AF5222117FD6B for ; Tue, 5 Jun 2018 05:18:03 -0700 (PDT) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 05 Jun 2018 05:18:03 -0700 Received: from shwdeopenpsi168.ccr.corp.intel.com ([10.239.158.129]) by fmsmga001.fm.intel.com with ESMTP; 05 Jun 2018 05:18:02 -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.93; helo=mga11.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.49,478,1520924400"; d="scan'208";a="61414580" From: Yonghong Zhu To: edk2-devel@lists.01.org Date: Tue, 5 Jun 2018 20:17:59 +0800 Message-Id: <1528201079-9740-1-git-send-email-yonghong.zhu@intel.com> X-Mailer: git-send-email 2.6.1.windows.1 Subject: [edk2] [Patch] Build spec: Add a Common PCD rules section for build report X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.26 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" 1. Add a Common PCD rules section to introduce 1)the *B, *F, *P, *M's meaning, 2) the PCD display order, 3) both display hex value and integer for UINT* type PCD. 2. Update some items to match with code, eg: UEFI Spec Version 3. Update some typo, eg: Fv Name. 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 --- .../132_sample_launch_steps_nt32_platform.md | 4 +- 13_build_reports/133_output.md | 9 +- 13_build_reports/134_platform_summary.md | 58 ++++++----- 13_build_reports/135_mixed_pcd_section.md | 8 +- 13_build_reports/136_global_pcd_section.md | 67 ++++++------- 13_build_reports/137_fd_section.md | 18 ++-- 13_build_reports/138_module_section.md | 107 +++++++----------= ---- 13_build_reports/README.md | 4 +- 8 files changed, 122 insertions(+), 153 deletions(-) diff --git a/13_build_reports/132_sample_launch_steps_nt32_platform.md b/13= _build_reports/132_sample_launch_steps_nt32_platform.md index 099dc07..7c73a5d 100644 --- a/13_build_reports/132_sample_launch_steps_nt32_platform.md +++ b/13_build_reports/132_sample_launch_steps_nt32_platform.md @@ -1,9 +1,9 @@ =20 ## 13.5 Mixed PCD Section =20 -There is an optional sub-section that, when present, lists the PCDs in the -platform that use multiple access methods. This sub-section is only presen= t if +There is an optional section that, when present, lists the PCDs in the +platform that use multiple access methods. This section is only present if there are Binary modules included in the platform build and the binary mod= ule uses a different PCD access method than other modules in the same platform build. =20 -The sub-section header is: +The section header is: =20 ``` >=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D< The following PCDs use different access methods: =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D diff --git a/13_build_reports/136_global_pcd_section.md b/13_build_reports/= 136_global_pcd_section.md index 2a5b682..64f800c 100644 --- a/13_build_reports/136_global_pcd_section.md +++ b/13_build_reports/136_global_pcd_section.md @@ -29,19 +29,18 @@ =20 --> =20 ## 13.6 Global PCD Section =20 -This section contains the information for all PCDs whose values are the sa= me -for all modules in a platform. The content of global PCD sub-section is gr= ouped -by token space: +This section contains the information for all PCDs that used for all modul= es in +a platform. The content of global PCD section is grouped by token space: =20 ``` -gEfiNt32PkgTokenSpaceGuid +gEfiMdeModulePkgTokenSpaceGuid ... ... -gEfiMdeModulePkgTokenSpaceGuid +gEfiNt32PkgTokenSpaceGuid ... ... ... ``` =20 @@ -54,29 +53,22 @@ Each global PCD item contains one or more lines: =20 The first line is required: =20 `[*P|*F|*B] : () [()][()] =3D ` =20 -* `*P` means the PCD's value was obtained from the DSC file -* `*F` means the PCD's value was obtained from the FDF file. -* `*B` means the PCD's value was obtained from a build option. -* If no `*P`, `*F` or `*B` is shown, the PCD's value comes from DEC file. = If the - value obtained from either a build option, the DSC or FDF is the same as= the - value in the DEC, then `*B`, `*P` or `*F` will not be shown in the repor= t. - **Note: ** If the Pcd is a Structure PCD, `` is the Struct Name. =20 #### Examples =20 ``` *P PcdWinNtFirmwareVolume : FIXED (VOID*) =3D L"..\\Fv\\Nt= 32.fd" -*F PcdWinNtFlashNvStorageFtwWorkingBase : FIXED (UINT32) =3D 0x0028E000 - DEC DEFAULT =3D 0x0 +*F PcdWinNtFlashNvStorageFtwWorkingBase : FIXED (UINT32) =3D 0x0028E000 = (2678784) + DEC DEFAULT =3D 0x0 (0) =20 gTokenSpaceGuid -*B LogEnable : FIXED (UNIT32) =3D 0x1 - DEC DEFAULT =3D 0x0 +*B LogEnable : FIXED (UNIT32) =3D 0x1 (1) + DEC DEFAULT =3D 0x0 (0) *P TestDynamic : DYN (VOID*) (DEFAULT) =3D L"= COM1!COM2" : DYN (VOID*) (SKU1) =3D L"= COM3!COM4" : DYN (VOID*) (SKU2) =3D L"= COM5!COM6" DEC DEFAULT =3D L"COM1!C= OM0" ``` @@ -90,22 +82,22 @@ gTokenSpaceGuid `::` =20 #### Example =20 ``` -*P PcdGMchDvmtTotalSize : DYN-HII (UINT8) =3D 0 +*P PcdGMchDvmtTotalSize : DYN-HII (UINT8) =3D 0x0 (0) gSysConfigGuid: L"Setup": 0xAA ``` =20 * if `` is DYN-VPD =20 `` =20 #### Example =20 ``` -*F PcdVpdSample : DYN-VPD (UINT32) =3D 1 +*F PcdVpdSample : DYN-VPD (UINT32) =3D 0x1 (1) 0x0001FFF ``` =20 #### 13.6.2.2 Default (optional) line =20 @@ -120,34 +112,33 @@ It is formatted as follows: `DEC DEFAULT =3D ` =20 #### Example =20 ``` -*P PcdWinNtFirmwareFdSize : FIXED (UINT32) =3D 0x2a0000 - DEC DEFAULT =3D 0x0 +*P PcdWinNtFirmwareFdSize : FIXED (UINT32) =3D 0x2a0000 (2752512) + DEC DEFAULT =3D 0x0 (0) ``` =20 #### 13.6.2.3 Additional optional lines =20 Additional lines are optional and show if the PCD's value was obtained fro= m the -INF file. This will be listed if the module's final PCD value is not the s= ame -as the first line. The value can be obtained from the INF file only if a s= ingle -module uses the PCD. +INF file or DSC file components module scoped PCD section. This will be li= sted +if the module's final PCD value is not the same as the first line. =20 -*M means the PCD's value was obtained from the INF file. +*M means the PCD's value was obtained from the INF file or DSC file compon= ents +module scoped PCD section. =20 These lines are formatted as: =20 `*M Inf Filename =3D ` =20 #### Example =20 ``` -*P PcdDebugPrintErrorLevel : PATCH (UINT32) =3D 0x80000042 - DEC DEFAULT =3D 0x80000000 - =3D 0x80000000 -*M Tcp4Dxe.inf =3D 0x0 +*P PcdDebugPrintErrorLevel : PATCH (UINT32) =3D 0x80000042 (2147483714) + DEC DEFAULT =3D 0x80000000 (2147483648) +*M Tcp4Dxe.inf =3D 0x0 (0) ``` =20 ********** **Note:** Global PCD section is present when **PCD** is specified in **-Y** option. @@ -162,20 +153,10 @@ additional print a *B Flag. =20 #### Example =20 ``` gEfiMdePkgTokenSpaceGuid -*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} - .D =3D 0x64 - DEC DEFAULT =3D {0xFF,0xFF} - .A =3D 0xF - .C =3D 0xF *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 @@ -189,6 +170,16 @@ gEfiMdePkgTokenSpaceGuid .Array =3D {0x2e,0xf6,0x08,0x6f,0x20,0x5c,0x8e,0x49,0x9= 1,0x57} .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} + .D =3D 0x64 + DEC DEFAULT =3D {0xFF,0xFF} + .A =3D 0xF + .C =3D 0xF ``` diff --git a/13_build_reports/137_fd_section.md b/13_build_reports/137_fd_s= ection.md index 49c2695..43d26ec 100644 --- a/13_build_reports/137_fd_section.md +++ b/13_build_reports/137_fd_section.md @@ -1,9 +1,9 @@