From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 39BA021CB0317 for ; Thu, 20 Jul 2017 00:16:30 -0700 (PDT) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 20 Jul 2017 00:18:25 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.40,382,1496127600"; d="scan'208,217";a="128881005" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by fmsmga005.fm.intel.com with ESMTP; 20 Jul 2017 00:18:25 -0700 Received: from fmsmsx154.amr.corp.intel.com (10.18.116.70) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Thu, 20 Jul 2017 00:18:25 -0700 Received: from shsmsx102.ccr.corp.intel.com (10.239.4.154) by FMSMSX154.amr.corp.intel.com (10.18.116.70) with Microsoft SMTP Server (TLS) id 14.3.319.2; Thu, 20 Jul 2017 00:18:24 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.116]) by shsmsx102.ccr.corp.intel.com ([169.254.2.146]) with mapi id 14.03.0319.002; Thu, 20 Jul 2017 15:18:21 +0800 From: "Long, Qin" To: "edk2-devel@lists.01.org" CC: "Long, Qin" Thread-Topic: Adding OpenSSL as the submodule of EDKII project... Thread-Index: AdMBIidJH8D+kMRjQ6yErten60mJSw== Date: Thu, 20 Jul 2017 07:18:20 +0000 Message-ID: Accept-Language: zh-CN, en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.239.127.40] MIME-Version: 1.0 X-Content-Filtered-By: Mailman/MimeDel 2.1.22 Subject: Adding OpenSSL as the submodule of EDKII project... 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: Thu, 20 Jul 2017 07:16:30 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Hi, The Git submodule allows us to keep another Git repository in a subdirector= y of main project. The Submodule repository has its own history, which does= not interfere with the history of the current repository. This can be used= to have external dependencies such as third party libraries. After the extra patch for EDKII-OpenSSL build was removed, OpenSSL can be o= ne typical use case of Git Submodule in EDKII project. The Git parent (EDKI= I) will keep track of the release version / tag IDs of Submodules when the = module owner commit. That will also help to ensure that when we check out t= he EDKII project then the openssl Submodule will also contain its right tag= s. One forked EDK2 repository with OpenSSL submodule support was available at = https://github.com/qloong/edk2 for testing. For EDKII developers, the possible impacts will include (comparing to the o= riginal openssl source download / unpacking mechanism): - Cloning EDKII project with Submodules The user can use the following commands to clone both main EDKII repo and o= penssl submodule: 1) Add the "--recursive" flag to their git clone command: $ git clone --recursive https://github.com/qloong/edk2 or 2) Manually initialize and update the submodules after the clone operation = on main project: $ git clone https://github.com/qloong/edk2 $ git submodule update -init -recursive - Pulling in Upstream Changes For Pull operations, one single "git pull" will not update the submodule re= pository. So the following combined commands can be used to pull the remote= submodule updates (e.g. updating to new supported OpenSSL release tag) $ git pull -recurse-submodules && git submodule update -recursive -remote (For any third-party GUI tools (e.g. TortoiseGit), there are also no direct= support to sync-up the primary and submodule repo. We need to use extra "P= ull..." and "Submodule Update..." to handle this case.) Let me know your comments & suggestions on this possible submodule updates = (advantage or disadvantage of this change? Any impacts? ...). Thanks. Best Regards & Thanks, LONG, Qin