From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Permerror (SPF Permanent Error: Two or more type TXT spf records found.) identity=mailfrom; client-ip=192.55.52.43; helo=mga05.intel.com; envelope-from=hao.a.wu@intel.com; receiver=edk2-devel@lists.01.org Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) (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 9271E210FCF5C for ; Tue, 4 Sep 2018 05:20:47 -0700 (PDT) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 04 Sep 2018 05:20:47 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.53,329,1531810800"; d="scan'208";a="82863811" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by fmsmga002.fm.intel.com with ESMTP; 04 Sep 2018 05:20:47 -0700 Received: from fmsmsx158.amr.corp.intel.com (10.18.116.75) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Tue, 4 Sep 2018 05:20:46 -0700 Received: from shsmsx103.ccr.corp.intel.com (10.239.4.69) by fmsmsx158.amr.corp.intel.com (10.18.116.75) with Microsoft SMTP Server (TLS) id 14.3.319.2; Tue, 4 Sep 2018 05:20:46 -0700 Received: from shsmsx104.ccr.corp.intel.com ([169.254.5.143]) by SHSMSX103.ccr.corp.intel.com ([169.254.4.240]) with mapi id 14.03.0319.002; Tue, 4 Sep 2018 20:20:44 +0800 From: "Wu, Hao A" To: "Ni, Ruiyu" , "edk2-devel@lists.01.org" CC: "Kinney, Michael D" Thread-Topic: [PATCH] EmulatorPkg: Update package level Readme.md Thread-Index: AQHUQ+06KYSqiWzj+0qqaO1LaeiQvaTgC4EQ Date: Tue, 4 Sep 2018 12:20:44 +0000 Message-ID: References: <20180904011851.69884-1-ruiyu.ni@intel.com> In-Reply-To: <20180904011851.69884-1-ruiyu.ni@intel.com> 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 Subject: Re: [PATCH] EmulatorPkg: Update package level Readme.md X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 04 Sep 2018 12:20:47 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Hao Wu Best Regards, Hao Wu > -----Original Message----- > From: Ni, Ruiyu > Sent: Tuesday, September 04, 2018 9:19 AM > To: edk2-devel@lists.01.org > Cc: Kinney, Michael D; Wu, Hao A > Subject: [PATCH] EmulatorPkg: Update package level Readme.md >=20 > Since the emulator under Windows is enabled, the patch changes > README to include the information of emulator under Windows. > It also changes README to Readme.md for better looking. >=20 > Contributed-under: TianoCore Contribution Agreement 1.1 > Signed-off-by: Ruiyu Ni > Cc: Michael D Kinney > Cc: Hao A Wu > --- > EmulatorPkg/README | 35 -------------------------- > EmulatorPkg/Readme.md | 68 > +++++++++++++++++++++++++++++++++++++++++++++++++++ > 2 files changed, 68 insertions(+), 35 deletions(-) > delete mode 100644 EmulatorPkg/README > create mode 100644 EmulatorPkg/Readme.md >=20 > diff --git a/EmulatorPkg/README b/EmulatorPkg/README > deleted file mode 100644 > index fdb26de503..0000000000 > --- a/EmulatorPkg/README > +++ /dev/null > @@ -1,35 +0,0 @@ > - > -=3D=3D=3D EmulatorPkg Overview =3D=3D=3D > - > -EmulatorPkg provides an environment where a UEFI environment can be > -emulated under an environment where a full UEFI compatible > -environment is not possible. (For example, running under an OS > -where an OS process hosts the UEFI emulation environment.) > - > -https://github.com/tianocore/tianocore.github.io/wiki/EmulatorPkg > - > -=3D=3D=3D Status =3D=3D=3D > - > -* Builds and runs under a posix-like environment with X windows > - - Linux > - - OS X > - > -=3D=3D=3D Future Plans =3D=3D=3D > - > -* Win32 and Win64 support > - > -=3D=3D=3D Build Scripts =3D=3D=3D > - > -On systems with the bash shell you can use EmulatorPkg/build.sh to simpl= ify > -building and running EmulatorPkg. > - > -For example, to build + run: > -$ EmulatorPkg/build.sh > -$ EmulatorPkg/build.sh run > - > -The build architecture will match your host machine's architecture. > - > -On X64 host machines, you can build + run IA32 mode as well: > -$ EmulatorPkg/build.sh -a IA32 > -$ EmulatorPkg/build.sh -a IA32 run > - > diff --git a/EmulatorPkg/Readme.md b/EmulatorPkg/Readme.md > new file mode 100644 > index 0000000000..461975e859 > --- /dev/null > +++ b/EmulatorPkg/Readme.md > @@ -0,0 +1,68 @@ > +## Overview > + > +EmulatorPkg provides an environment where a UEFI environment can be > +emulated under an environment where a full UEFI compatible > +environment is not possible. (For example, running under an OS > +where an OS process hosts the UEFI emulation environment.) > + > +https://github.com/tianocore/tianocore.github.io/wiki/EmulatorPkg > + > +## Status > + > +* Builds and runs under > + * a posix-like environment with X windows > + - Linux > + - OS X > + * Windows environment > + - Win10 (verified) > + - Win8 (not verified) > + > +## How to Build & Run > +**You can use the following command to build.** > + * 32bit emulator in Windows: > + > + `build -p EmulatorPkg\EmulatorPkg.dsc -t VS2017 -D WIN_SEC_BUILD -a > IA32` > + > + * 64bit emulator in Windows: > + > + `build -p EmulatorPkg\EmulatorPkg.dsc -t VS2017 -D WIN_SEC_BUILD -a > X64` > + > + * 32bit emulator in Linux: > + > + `build -p EmulatorPkg\EmulatorPkg.dsc -t GCC5 -D UNIX_SEC_BUILD -a > IA32` > + > + * 64bit emulator in Linux: > + > + `build -p EmulatorPkg\EmulatorPkg.dsc -t GCC5 -D UNIX_SEC_BUILD -a X= 64` > + > +**You can start/run the emulator using the following command:** > + * 32bit emulator in Windows: > + > + `cd Build\EmulatorIA32\DEBUG_VS2017\IA32\ && WinHost.exe` > + > + * 64bit emulator in Windows: > + > + `cd Build\EmulatorX64\DEBUG_VS2017\X64\ && WinHost.exe` > + > + * 32bit emulator in Linux: > + > + `cd Build/EmulatorIA32/DEBUG_GCC5/IA32/ && ./Host` > + > + * 64bit emulator in Linux: > + > + `cd Build/EmulatorX64/DEBUG_GCC5/X64/ && ./Host` > + > +**On posix-like environment with the bash shell you can use > EmulatorPkg/build.sh to simplify building and running > +emulator.** > + > +For example, to build + run: > + > +`$ EmulatorPkg/build.sh` > +`$ EmulatorPkg/build.sh run` > + > +The build architecture will match your host machine's architecture. > + > +On X64 host machines, you can build + run IA32 mode as well: > + > +`$ EmulatorPkg/build.sh -a IA32` > +`$ EmulatorPkg/build.sh -a IA32 run` > -- > 2.16.1.windows.1