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 6669C21A16EC6 for ; Sun, 28 May 2017 01:43:07 -0700 (PDT) Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 28 May 2017 01:44:03 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.38,408,1491289200"; d="scan'208";a="973933018" Received: from fmsmsx106.amr.corp.intel.com ([10.18.124.204]) by orsmga003.jf.intel.com with ESMTP; 28 May 2017 01:44:03 -0700 Received: from FMSMSX109.amr.corp.intel.com (10.18.116.9) by FMSMSX106.amr.corp.intel.com (10.18.124.204) with Microsoft SMTP Server (TLS) id 14.3.319.2; Sun, 28 May 2017 01:44:03 -0700 Received: from shsmsx104.ccr.corp.intel.com (10.239.4.70) by fmsmsx109.amr.corp.intel.com (10.18.116.9) with Microsoft SMTP Server (TLS) id 14.3.319.2; Sun, 28 May 2017 01:44:02 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.116]) by SHSMSX104.ccr.corp.intel.com ([10.239.4.70]) with mapi id 14.03.0319.002; Sun, 28 May 2017 16:44:00 +0800 From: "Zhu, Yonghong" To: "Kinney, Michael D" , "edk2-devel@lists.01.org" CC: "Gao, Liming" , "Shaw, Kevin W" , "Zhu, Yonghong" Thread-Topic: [edk2-BuildSpecification PATCH V2] Add EBNF for --pcd flag command line flag Thread-Index: AQHS1yYz1AC/aGvlxkiV35si2462QKIIF/OAgAFWqDA= Date: Sun, 28 May 2017 08:43:59 +0000 Message-ID: References: <1495916213-32912-1-git-send-email-michael.d.kinney@intel.com> <1495916213-32912-2-git-send-email-michael.d.kinney@intel.com> In-Reply-To: <1495916213-32912-2-git-send-email-michael.d.kinney@intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiYzIxMzg5MDgtNTFhMC00ODI5LTllNzUtNjIwY2FhZDZiZjQ5IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE1LjkuNi42IiwiVHJ1c3RlZExhYmVsSGFzaCI6IlpZOWt6dENFbkpcL3U2TkVXaTRFcm5zNTlxN1VQVStrRnlcL1FrcThOXC81MUU9In0= x-ctpclassification: CTP_IC dlp-product: dlpe-windows dlp-version: 10.0.102.7 dlp-reaction: no-action x-originating-ip: [10.239.127.40] MIME-Version: 1.0 Subject: Re: [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: Sun, 28 May 2017 08:43:07 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Yonghong Zhu Best Regards, Zhu Yonghong -----Original Message----- From: Kinney, Michael D=20 Sent: Sunday, May 28, 2017 4:17 AM To: edk2-devel@lists.01.org Cc: Gao, Liming ; Zhu, Yonghong ; Shaw, Kevin W Subject: [edk2-BuildSpecification PATCH V2] Add EBNF for --pcd flag command= line flag https://bugzilla.tianocore.org/show_bug.cgi?id=3D523 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 = = = = | A= pril 2017 | +| 1.27 | Convert to Gitbook = = = = | M= ay 2017 | | | [#471](https://bugzilla.tianocore.org/show_bug.cgi?id=3D471= ) Build spec: only copy the "TianoCore" Userextension section into "As Buil= t" INF = = |= | | | [#472](https://bugzilla.tianocore.org/show_bug.cgi?id=3D472= ) [Build Spec] Extend macro usage in the !include statements for DSC/FDF fi= les = = |= | | | [#483](https://bugzilla.tianocore.org/show_bug.cgi?id=3D483= ) 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=3D504= ) Update build report to support -Y HASH option = = = |= | | | [#508](https://bugzilla.tianocore.org/show_bug.cgi?id=3D508= ) Build Spec: Add sections to PCD report for PCDs only used in conditions P= CDs that are not used anywhere = = |= | | | [#480](https://bugzilla.tianocore.org/show_bug.cgi?id=3D480= ) Build spec: add description for Override PCD value on the command line = = = |= | +| | [#523](https://bugzilla.tianocore.org/show_bug.cgi?id=3D523= ) 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 file= s. ::=3D

::=3D "-"

"-"

"-"

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