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 2F9C82195408C for ; Mon, 24 Apr 2017 19:29:24 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 24 Apr 2017 19:29:12 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.37,247,1488873600"; d="scan'208";a="78428637" Received: from fmsmsx103.amr.corp.intel.com ([10.18.124.201]) by orsmga002.jf.intel.com with ESMTP; 24 Apr 2017 19:29:12 -0700 Received: from fmsmsx117.amr.corp.intel.com (10.18.116.17) by FMSMSX103.amr.corp.intel.com (10.18.124.201) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 24 Apr 2017 19:29:12 -0700 Received: from shsmsx151.ccr.corp.intel.com (10.239.6.50) by fmsmsx117.amr.corp.intel.com (10.18.116.17) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 24 Apr 2017 19:29:11 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.117]) by SHSMSX151.ccr.corp.intel.com ([169.254.3.224]) with mapi id 14.03.0319.002; Tue, 25 Apr 2017 10:29:08 +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] Update build report to support -Y HASH option Thread-Index: AQHSvWdWtFTI674V7E6cTtVkKGNHbKHUzbKAgACO3lA= Date: Tue, 25 Apr 2017 02:29:08 +0000 Message-ID: References: <1493085455-10268-1-git-send-email-michael.d.kinney@intel.com> <1493085455-10268-2-git-send-email-michael.d.kinney@intel.com> In-Reply-To: <1493085455-10268-2-git-send-email-michael.d.kinney@intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.239.127.40] MIME-Version: 1.0 Subject: Re: [ edk2-BuildSpecification PATCH] Update build report to support -Y HASH option 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: Tue, 25 Apr 2017 02:29:24 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Yonghong Zhu =20 Best Regards, Zhu Yonghong -----Original Message----- From: Kinney, Michael D=20 Sent: Tuesday, April 25, 2017 9:58 AM To: edk2-devel@lists.01.org Cc: Gao, Liming ; Zhu, Yonghong ; Shaw, Kevin W Subject: [ edk2-BuildSpecification PATCH] Update build report to support -Y= HASH option https://bugzilla.tianocore.org/show_bug.cgi?id=3D504 Cc: Liming Gao Cc: Yonghong Zhu Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael Kinney --- 13_build_reports/131_build_report_generation_options.md | 4 ++++ 13_build_reports/132_sample_launch_steps_nt32_platform.md | 11 ++++++----- 13_build_reports/133_output.md | 2 +- 13_build_reports/138_module_section.md | 4 ++++ README.md | 1 + appendix_d_buildexe_command/d4_usage.md | 7 ++++--- 6 files changed, 20 insertions(+), 9 deletions(-) diff --git a/13_build_reports/131_build_report_generation_options.md b/13_b= uild_reports/131_build_report_generation_options.md index fc32590..05d7eb2 100644 --- a/13_build_reports/131_build_report_generation_options.md +++ b/13_build_reports/131_build_report_generation_options.md @@ -61,6 +61,10 @@ notification invoking sequence; Also the predicted addre= sses of module image loading, entry point and notification functions. Gene= rating this report does take a significant amount of time, more than 2x th= e standard build time. =20 +**_Module Information_** + +Details of the module, may include the HASH of the `.efi` file. + ********** **Note:** The execution order prediction report output is an html file, s= eparate from the rest of the reports. All remaining reports are generated i= n a 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 33ca1bf..099dc07 100644 --- a/13_build_reports/132_sample_launch_steps_nt32_platform.md +++ b/13_build_reports/132_sample_launch_steps_nt32_platform.md @@ -42,17 +42,18 @@ command. The following steps output the build report fo= r NT32 platform: 5. Run **build.exe -a IA32 -p Nt32Pkg\Nt32Pkg.dsc -y ReportFile.txt** * **-y**: This option specifies the output file name for build report. * **-Y**: This option specifies flags that control the type of build rep= ort. - It must be from the set of **PCD**, **LIBRARY**, **DEPEX**, **BUILD_FL= AGS**, - **FLASH**, **FIXED_ADDRESS** and **EXECUTION_ORDER**. To specify more = than - one flag, repeat the option on the command line. Example of usage: + It must be from the set of **PCD**, **LIBRARY**, **DEPEX**, **HASH**, + **BUILD_FLAGS**, **FLASH**, **FIXED_ADDRESS** and **EXECUTION_ORDER**.= To + specify more than one flag, repeat the option on the command line. Exa= mple + of usage: =20 On the command line, append the following arguments: =20 **-y report_filename.txt -Y PCD -Y FLASH -Y DEPEX** =20 The default set of flags (if **-Y** is not specified) is: **PCD**, - **LIBRARY**, **FLASH**, **DEPEX**, **BUILD_FLAGS** and **FIXED_ADDRESS= **. - + **LIBRARY**, **FLASH**, **DEPEX**, **HASH**, **BUILD_FLAGS** and + **FIXED_ADDRESS**. =20 [^1] On Microsoft Windows 7, you must be an administrator to create a dire= ctory in the root of the C: drive. It recommended that you checkout edk2 i= nto your diff --git a/13_build_reports/133_output.md b/13_build_reports/133= _output.md index ce64efd..73afb0c 100644 --- a/13_build_reports/133_output.md +++ b/13_build_reports/133_output.md @@ -101,7 +101,7 @@ Target: DEBUG Output Path: s:\edk2\Build\NT32IA32 Build Environment: Windows-7-6.1.7601-SP1 Build Duration: 00:01:53 -Report Contents: PCD, LIBRARY, BUILD_FLAGS, DEPEX, FLASH, FIXED_ADDRESS +Report Contents: PCD, LIBRARY, BUILD_FLAGS, DEPEX, HASH, FLASH, FIXED_A= DDRESS >=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= < Firmware Device (FD) FD Name: NT32 diff --git a/13_build_reports/138_module_section.md b/13_build_reports/138_= module_section.md index 23e039b..d4aa365 100644 --- a/13_build_reports/138_module_section.md +++ b/13_build_reports/138_module_section.md @@ -51,6 +51,8 @@ file GUID, module size, module build time stamp and drive= r type. =20 The following entries are options: =20 +* If using defaults or the `HASH` flag is specified: + - SHA1 HASH: %SHA1 HASH% and *%Module .efi file name% * UEFI Specification Version: %The UEFI specification version:'`UEFI_SPECIFICATION_VERSION`' in INF `[Defines]` section% * PI Specification Version: %The PI specification @@ -75,6 +77,7 @@ Module Name: SmbiosDxe Module INF Path: MdeModule\Universal\SmbiosDxe\SmbiosDxe.inf File GUID: F9D88642-0737-49BC-81B5-6889CD57D9EA Size: 0x7000 (28.00K) +SHA1 HASH: d94c3f180f25d6b562f477bc4a16b286cb66a8b6 *SmbiosDxe.ef= i Build Time Stamp: 1969-12-31 16:00:00 Driver Type: 0x7 (DRIVER) =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 @@ -91,6 +94,7 @@ Module Name: EbcDxe Module INF Path: MdeModule\Universal\EbcDxe\EbcDxe.inf File GUID: 13AC6DD0-73D0-11D4-B06B-00AA00BD6DE7 Size: 0x9000 (36.00K) +SHA1 HASH: ff4c019345614afe5c88e7fc37219c30a07f4af4 *EbcDxe.efi Time Stamp: 1969-12-31 16:00:00 Driver Type: 0x7 (DRIVER) =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/README.md b/README.md index 89578d0..b6668cc 100644 --- a/README.md +++ b/README.md @@ -208,3 +208,4 @@ Copyright (c) 2008-2017, Intel Corporation. All rights = reserved. | | [#479](https://bugzilla.tianocore.org/show_bug.cgi?id=3D479= ) Build spec: add description for nmake long command line handling = = = |= | | | [#485](https://bugzilla.tianocore.org/show_bug.cgi?id=3D485= ) Build spec: add support for mixed Pcd access method = = = |= | | | [#476](https://bugzilla.tianocore.org/show_bug.cgi?id=3D476= ) Build spec: add support for HII image package = = = |= | +| | [#504](https://bugzilla.tianocore.org/show_bug.cgi?id=3D504= ) Update build report to support -Y HASH option = = = |= | diff --git a/appendix_d_buildexe_command/d4_usage.md b/appendix_d_buildexe_= command/d4_usage.md index c262f1a..07b9092 100644 --- a/appendix_d_buildexe_command/d4_usage.md +++ b/appendix_d_buildexe_command/d4_usage.md @@ -96,11 +96,12 @@ Options: Create/overwrite the report to the specified filen= ame. -Y REPORTTYPE, --report-type=3DREPORTTYPE Flags that control the type of build report to - generate. Must be one of: [PCD, LIBRARY, FLASH, - DEPEX, BUILD_FLAGS, FIXED_ADDRESS, EXECUTION_ORDER= ]. + generate. Must be one of: [PCD, LIBRARY, FLASH, DE= PEX, + HASH, BUILD_FLAGS, FIXED_ADDRESS, EXECUTION_ORDER]= . To specify more than one flag, repeat this option = on the command line and the default flag set is [PCD, - LIBRARY, FLASH, DEPEX, BUILD_FLAGS, FIXED_ADDRESS] + LIBRARY, FLASH, DEPEX, HASH, BUILD_FLAGS, + FIXED_ADDRESS] -F FLAG, --flag=3DFLAG Specify the specific option to parse EDK UNI fil= e. Must be one of: [-c, -s]. -c is for EDK framework = UNI file, and -s is for EDK UEFI UNI file. This option= can -- 2.6.3.windows.1