From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 1E94C21A16EC7 for ; Sat, 27 May 2017 12:33:55 -0700 (PDT) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 27 May 2017 12:34:51 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.38,404,1491289200"; d="scan'208";a="107390447" Received: from mdkinney-mobl.amr.corp.intel.com ([10.252.129.193]) by fmsmga005.fm.intel.com with ESMTP; 27 May 2017 12:34:51 -0700 From: Michael Kinney To: edk2-devel@lists.01.org Cc: Liming Gao , Yonghong Zhu , Kevin W Shaw Date: Sat, 27 May 2017 12:34:46 -0700 Message-Id: <1495913686-36548-2-git-send-email-michael.d.kinney@intel.com> X-Mailer: git-send-email 2.6.3.windows.1 In-Reply-To: <1495913686-36548-1-git-send-email-michael.d.kinney@intel.com> References: <1495913686-36548-1-git-send-email-michael.d.kinney@intel.com> Subject: [edk2-DscSpecification PATCH] 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: , X-List-Received-Date: Sat, 27 May 2017 19:33:55 -0000 https://bugzilla.tianocore.org/show_bug.cgi?id=519 Cc: Liming Gao Cc: Yonghong Zhu Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael Kinney --- 2_dsc_overview/28_pcd_section_processing.md | 56 ++++++++++++++--------------- README.md | 5 +-- 2 files changed, 31 insertions(+), 30 deletions(-) diff --git a/2_dsc_overview/28_pcd_section_processing.md b/2_dsc_overview/28_pcd_section_processing.md index 60e7de7..3736cde 100644 --- a/2_dsc_overview/28_pcd_section_processing.md +++ b/2_dsc_overview/28_pcd_section_processing.md @@ -312,45 +312,45 @@ string plus 1 byte for the null terminator, for L"string" 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. -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 come +from different locations and different meta-data files. The following provides +the precedence (high to low) to assign a value to a PCD. -* A PCD value defined by a MACRO, ("MacroName" in this example), and the Macro - is defined on the command-line using -D MacroName=Value +* Command-line, `--pcd` flags (left most has higher priority) -* A PCD value defined in the FDF file SET statements +* DSC file, p FeatureFlag, PatchableInModule or FixedAtBuild PCD value defined + in the `[Components]` INF scoping `` section statements -* A PCD value defined positionally in the FDF file +* FDF file, grammar describing automatic assignment of PCD values -* A FeatureFlag, PatchableInModule or FixedAtBuild PCD value defined in the - `[Components]` INF scoping section +* FDF file, SET statements within a section -* 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 -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 FeatureFlag, PatchableInModule or FixedAtBuild PCD value defined + in a PCD access method section with an architectural modifier. -```ini -[PcdsFixedAtBuild.common] - gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 - gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FALSE + 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: -[PcdsPatchableInModule.IA32] - gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 - gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FALSE -``` + ```ini + [PcdsFixedAtBuild.common] + gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 + gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FALSE + + [PcdsPatchableInModule.IA32] + gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeMemorySize|1 + gEfiMdeModulePkgTokenSpaceGuid.PcdResetOnMemoryTypeInformationChange|FALSE + ``` -* 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. -* A PCD value defined in an INF (provided all INF files have defined the same - value) +* INF file, PCD sections, Default Values (provided all INF files have defined + the same value) -* A PCD default value defined in the DEC file that declares the PCD. +* DEC file, PCD sections, Default Values ********** **Note:** Dynamic or DynamicEx PCD sections with architectural modifiers is not diff --git a/README.md b/README.md index 1d1f99c..3bec3b3 100644 --- a/README.md +++ b/README.md @@ -176,7 +176,8 @@ Copyright (c) 2006-2017, Intel Corporation. All rights reserved. | | Update the DSC_SPECIFICATION version to 0x0001001A | | | | Revised WORKSPACE wording for updated build system that can handle packages located outside of the WORKSPACE directory tree (refer to the TianoCore.org/ EDKII website for additional instructions on setting up a development environment). | | | | Added new system environment variables used by the build system. | | -| 1.27 | Convert to GitBooks | April 2017 | +| 1.27 | Convert to GitBooks | May 2017 | | | [#351](https://bugzilla.tianocore.org/show_bug.cgi?id=351) [DSC Spec] Extend macro usage in the !include statement | | | | [#484](https://bugzilla.tianocore.org/show_bug.cgi?id=484) DSC spec: support Prebuild and Postbuild in the [Defines] section | | -| | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=353) Build spec: Allow nested includes in DSC and FDF files | | +| | [#353](https://bugzilla.tianocore.org/show_bug.cgi?id=353) Build spec: Allow nested includes in DSC and FDF files | | +| | [#519](https://bugzilla.tianocore.org/show_bug.cgi?id=519) DSC Spec: update Precedence of PCD Values | | -- 2.6.3.windows.1