From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) (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 6700821A16EC6 for ; Sat, 27 May 2017 13:16:02 -0700 (PDT) Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 27 May 2017 13:16:58 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.38,404,1491289200"; d="scan'208";a="1175182259" Received: from mdkinney-mobl.amr.corp.intel.com ([10.252.129.193]) by fmsmga002.fm.intel.com with ESMTP; 27 May 2017 13:16:58 -0700 From: Michael Kinney To: edk2-devel@lists.01.org Cc: Liming Gao , Yonghong Zhu , Kevin W Shaw Date: Sat, 27 May 2017 13:16:53 -0700 Message-Id: <1495916213-32912-2-git-send-email-michael.d.kinney@intel.com> X-Mailer: git-send-email 2.6.3.windows.1 In-Reply-To: <1495916213-32912-1-git-send-email-michael.d.kinney@intel.com> References: <1495916213-32912-1-git-send-email-michael.d.kinney@intel.com> Subject: [edk2-BuildSpecification PATCH V2] Add EBNF for --pcd flag command line flag 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 20:16:02 -0000 https://bugzilla.tianocore.org/show_bug.cgi?id=523 Cc: Liming Gao Cc: Yonghong Zhu Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael Kinney --- README.md | 3 ++- appendix_d_buildexe_command/d4_usage.md | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 34 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 16fcc4a..00fd89d 100644 --- a/README.md +++ b/README.md @@ -200,7 +200,7 @@ Copyright (c) 2008-2017, Intel Corporation. All rights reserved. | | Remove Unicode file storage requirement; refer to the Multi-String UNI File Format Specification instead. | | | | Clarify BUILDRULEORDER | | | | Add support for INF statement in an FD region. | | -| 1.27 | Convert to Gitbook | April 2017 | +| 1.27 | Convert to Gitbook | May 2017 | | | [#471](https://bugzilla.tianocore.org/show_bug.cgi?id=471) Build spec: only copy the "TianoCore" Userextension section into "As Built" INF | | | | [#472](https://bugzilla.tianocore.org/show_bug.cgi?id=472) [Build Spec] Extend macro usage in the !include statements for DSC/FDF files | | | | [#483](https://bugzilla.tianocore.org/show_bug.cgi?id=483) Build Spec: add description for merge Pre-build and Post-build into build process | | @@ -212,3 +212,4 @@ Copyright (c) 2008-2017, Intel Corporation. All rights reserved. | | [#504](https://bugzilla.tianocore.org/show_bug.cgi?id=504) Update build report to support -Y HASH option | | | | [#508](https://bugzilla.tianocore.org/show_bug.cgi?id=508) Build Spec: Add sections to PCD report for PCDs only used in conditions PCDs that are not used anywhere | | | | [#480](https://bugzilla.tianocore.org/show_bug.cgi?id=480) Build spec: add description for Override PCD value on the command line | | +| | [#523](https://bugzilla.tianocore.org/show_bug.cgi?id=523) Build spec: add EBNF for the --pcd syntax in the Section D.4 | | diff --git a/appendix_d_buildexe_command/d4_usage.md b/appendix_d_buildexe_command/d4_usage.md index 6271d4f..b71f2d0 100644 --- a/appendix_d_buildexe_command/d4_usage.md +++ b/appendix_d_buildexe_command/d4_usage.md @@ -173,3 +173,35 @@ precedence over Macros defined in the DSC and FDF files. ::=

::= "-"

"-"

"-"

"-" ``` + +### D.4.3 PCD Option Definition + +This section provides the EBNF for the `--pcd` option, which allows users to +specify PCD values on the command-line. PCD values on the command-line take +precedence over PCD provided in DSC, FDF, INF, and DEC files. + +#### Prototype + +```c + ::= "--pcd" ["=" ] + ::= 0x20 + ::= + + ::= [ "."] + ::= C Variable Name of the Token Space GUID + ::= C Variable Name of the PCD + ::= {} {} {} {} + ::= {} {} + ::= {(0-9)} {(1-9)(0-9)+} + ::= {"0x"} {"0X"} (a-fA-F0-9){1,16} + ::= {} {} + ::= {"TRUE"} {"True"} {"true"} {"1"} {"0x1"} {"0x01"} + ::= {"FALSE"} {"False"} {"false"} {"0"} {"0x0"} {"0x00"} + ::= ["L"] + ::= * + ::= 0x22 + ::= {0x21} {(0x23 - 0x5B)} {(0x5D - 0x7E)} {} + ::= "\" {"n"} {"t"} {"f"} {"r"} {"b"} {"0"} {"\"} {0x22} + ::= "H" "{" "}" + ::= ["," ]* + ::= {"0x"} {"0X"} (a-fA-F0-9){1,2} +``` -- 2.6.3.windows.1