From nobody Fri May 3 11:05:26 2024 Delivered-To: importer@patchew.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; Authentication-Results: mx.zoho.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; Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1496210438977592.0280372272214; Tue, 30 May 2017 23:00:38 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 87CC721AE3CD7; Tue, 30 May 2017 22:59:34 -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 617A121AE3CCF for ; Tue, 30 May 2017 22:59:33 -0700 (PDT) Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 30 May 2017 23:00:32 -0700 Received: from mdkinney-mobl.amr.corp.intel.com ([10.252.129.193]) by orsmga001.jf.intel.com with ESMTP; 30 May 2017 23:00:32 -0700 X-Original-To: edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.38,422,1491289200"; d="scan'208";a="1136438203" From: Michael Kinney To: edk2-devel@lists.01.org Date: Tue, 30 May 2017 23:00:28 -0700 Message-Id: <1496210428-49364-2-git-send-email-michael.d.kinney@intel.com> X-Mailer: git-send-email 2.6.3.windows.1 In-Reply-To: <1496210428-49364-1-git-send-email-michael.d.kinney@intel.com> References: <1496210428-49364-1-git-send-email-michael.d.kinney@intel.com> Subject: [edk2] [edk2-DscSpecification PATCH v2] Update Precedence of PCD Values X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: 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" https://bugzilla.tianocore.org/show_bug.cgi?id=3D519 Cc: Liming Gao Cc: Yonghong Zhu Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael Kinney Reviewed-by: Yonghong Zhu =20 --- 2_dsc_overview/28_pcd_section_processing.md | 56 ++++++++++++++-----------= ---- README.md | 1 + 2 files changed, 29 insertions(+), 28 deletions(-) diff --git a/2_dsc_overview/28_pcd_section_processing.md b/2_dsc_overview/2= 8_pcd_section_processing.md index 0969b41..1adde81 100644 --- a/2_dsc_overview/28_pcd_section_processing.md +++ b/2_dsc_overview/28_pcd_section_processing.md @@ -320,45 +320,45 @@ string plus 1 byte for the null terminator, for L"str= ing" entries to be the length of the UCS-2 character string plus 2 bytes for the null terminator = and the exact length of a byte array. =20 -Precedence for determining PCD values (high to low, last in position) is as -follows: +The values that are assigned to individual PCDs required by a build may co= me +from different locations and different meta-data files. The following prov= ides +the precedence (high to low) to assign a value to a PCD. =20 -* A PCD value defined by a MACRO, ("MacroName" in this example), and the M= acro - is defined on the command-line using -D MacroName=3DValue +* Command-line, `--pcd` flags (left most has higher priority) =20 -* A PCD value defined in the FDF file SET statements +* DSC file, FeatureFlag, PatchableInModule or FixedAtBuild PCD value defin= ed + in the `[Components]` INF scoping `` section statements =20 -* A PCD value defined positionally in the FDF file +* FDF file, grammar describing automatic assignment of PCD values =20 -* A FeatureFlag, PatchableInModule or FixedAtBuild PCD value defined in the - `[Components]` INF scoping section +* FDF file, SET statements within a section =20 -* A FeatureFlag, PatchableInModule or FixedAtBuild PCD value defined in a = PCD - access method section with an architectural modifier (the access method = for a - PCD in a section with an architectural modifier takes precedence over any - other access method) +* FDF file, SET statement in the [Defines] section =20 -In this example, modules built for IA32 architecture, the PCD will use -PatchableInModule access, while modules built for all other architectures,= the -PCD will use the FixedAtBuild access method: +* DSC file, a PCD value defined in a PCD access method section with an + architectural modifier. =20 -```ini -[PcdsFixedAtBuild.common] - gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 - gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FAL= SE + In this example, modules built for IA32 architecture, the PCD will use + PatchableInModule access, while modules built for all other architecture= s, the + PCD will use the FixedAtBuild access method: =20 -[PcdsPatchableInModule.IA32] - gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 - gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FAL= SE -``` + ```ini + [PcdsFixedAtBuild.common] + gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 + gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|F= ALSE + + [PcdsPatchableInModule.IA32] + gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 + gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|F= ALSE + ``` =20 -* A PCD value defined in a PCD access method (item type) section for common - architectures +* DSC file, A PCD value defined in a PCD access method (item type) global + `[Pcd*]` section for common architectures. =20 -* A PCD value defined in an INF (provided all INF files have defined the s= ame - value) +* INF file, PCD sections, Default Values (provided all INF files have defi= ned + the same value) =20 -* A PCD default value defined in the DEC file that declares the PCD. +* DEC file, PCD sections, Default Values =20 ********** **Note:** Dynamic or DynamicEx PCD sections with architectural modifiers i= s not diff --git a/README.md b/README.md index eb6966f..5e2c17a 100644 --- a/README.md +++ b/README.md @@ -181,3 +181,4 @@ Copyright (c) 2006-2017, Intel Corporation. All rights = reserved. | | [#484](https://bugzilla.tianocore.org/show_bug.cgi?id=3D484= ) DSC spec: support Prebuild and Postbuild in the [Defines] section = = = | | | | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=3D353= ) Build spec: Allow nested includes in DSC and FDF files = = = | | | | [#521](https://bugzilla.tianocore.org/show_bug.cgi?id=3D521= ) DSC spec: add clarification for mixed PCD usage in the DSC spec = = = | | +| | [#519](https://bugzilla.tianocore.org/show_bug.cgi?id=3D519= ) DSC Spec: update Precedence of PCD Values = = = | | --=20 2.6.3.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel