From nobody Mon Dec 23 11:15:02 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.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 1518055723049864.8576958295379; Wed, 7 Feb 2018 18:08:43 -0800 (PST) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 8E6ED22361E63; Wed, 7 Feb 2018 18:02:57 -0800 (PST) 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 E6F7B22361E50 for ; Wed, 7 Feb 2018 18:02:56 -0800 (PST) Received: from orsmga007.jf.intel.com ([10.7.209.58]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Feb 2018 18:08:39 -0800 Received: from shwdeopenpsi168.ccr.corp.intel.com ([10.239.158.129]) by orsmga007.jf.intel.com with ESMTP; 07 Feb 2018 18:08:38 -0800 X-Original-To: edk2-devel@lists.01.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; Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=192.55.52.93; helo=mga11.intel.com; envelope-from=yonghong.zhu@intel.com; receiver=edk2-devel@lists.01.org X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,476,1511856000"; d="scan'208";a="16081341" From: Yonghong Zhu To: edk2-devel@lists.01.org Date: Thu, 8 Feb 2018 10:08:37 +0800 Message-Id: <1518055717-5920-1-git-send-email-yonghong.zhu@intel.com> X-Mailer: git-send-email 2.6.1.windows.1 Subject: [edk2] [Patch V3] Build spec: Add description about auto detect thread number X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Michael Kinney , 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" V3: Update the build option help info Add description about enable auto detect thread number when MAX_CONCURRENT_THREAD_NUMBER is not specified. Fixes: https://bugzilla.tianocore.org/show_bug.cgi?id=3D775 Cc: Liming Gao Cc: Michael Kinney Cc: Kevin W Shaw Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Yonghong Zhu --- 5_meta-data_file_specifications/53_target_txt_file.md | 8 +++++--- appendix_d_buildexe_command/d4_usage.md | 7 +++++-- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/5_meta-data_file_specifications/53_target_txt_file.md b/5_meta= -data_file_specifications/53_target_txt_file.md index ff8c2ec..755d3fb 100644 --- a/5_meta-data_file_specifications/53_target_txt_file.md +++ b/5_meta-data_file_specifications/53_target_txt_file.md @@ -116,13 +116,15 @@ Specify the name of the `tools_def.txt` tool chain ta= g name to use. If not specified in this file and it is not specified using the `-t` option on the command-line, then the build will break. =20 **_Integer_** =20 -The number of concurrent threads. The default, if not specified or set to = zero, -is 2 Recommend setting this value to one more than the number of computer = cores -or CPUs of the development workstation. +The number of concurrent threads. If not specified or set to zero, tool +automatically detect number of processor threads. Recommend setting this +value to one less than the number of computer cores or CPUs of the develop= ment +workstation. When value set to 1, means disable multi-thread build, and va= lue set +to more than 1, means user specify the thread number to build. =20 **_BuildRulesFile_** =20 Specify the file name to use for the build rules that are followed when generating Makefiles. If not specified, the file: diff --git a/appendix_d_buildexe_command/d4_usage.md b/appendix_d_buildexe_= command/d4_usage.md index 57d2656..c5c2584 100644 --- a/appendix_d_buildexe_command/d4_usage.md +++ b/appendix_d_buildexe_command/d4_usage.md @@ -60,12 +60,15 @@ Options: -x SKUID, --sku-id=3DSKUID Using this name of SKU ID to build the platform, overriding SKUID_IDENTIFIER in DSC file. -n THREADNUMBER Build the platform using multi-threaded compiler. = The value overrides target.txt's - MAX_CONCURRENT_THREAD_NUMBER. Less than 2 will dis= able - multi-thread builds. + MAX_CONCURRENT_THREAD_NUMBER. When value is set to= 0, + tool automatically detect number of processor thre= ads, + set value to 1 means disable multi-thread build, a= nd + set value to more than 1 means user specify the th= reads + number to build. -f FDFFILE, --fdf=3DFDFFILE The name of the FDF file to use, which overrides t= he setting in the DSC file. -r ROMIMAGE, --rom-image=3DROMIMAGE The name of FD to be generated. The name must be f= rom --=20 2.6.1.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel