BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1603
Code: https://github.com/lgao4/edk2/tree/CLANG9
Wiki: https://github.com/lgao4/edk2/wiki/CLANG9-Tools-Chain

CLANG9 tool chain is added to directly generate PE/COFF image (EFI image).
This tool chain uses LLVM clang C compiler and lld linker, generates PE/COFF
image and PDB compatible debug symbol format. Now, it supports IA32/X64 Archs.
It must use LLVM 9 or above release. LLVM 9 is ready on 
http://releases.llvm.org/download.html#9.0.0.

CLANG9 is the cross OS tool chain. It can work on Windows/Linux/Mac host OS. 
For the same source code, with the same version LLVM tool chain, 
CLANG9 can generate the same binary image. So, the developer can 
choose the different development environment and work on the same 
code base. Besides, EDKII project build also requires third party 
tools: nasm and iasl. They both keep the same version. If so, the same 
binary image can be generated on the different host OS.

LLVM tool chain provides the compiler and linker. To build EDK2 project, 
some other tools are still required. On Windows OS, nmake and Visual Studio 
are required to call Makefile and compile BaseTools C tools. 
On Linux/Mac, binutils and gcc are required to make and compile BaseTools 
C tools. Because VS or GCC are mainly used to compile BaseTools and provide 
nmake/make tool, they can keep on the stable version without update.

To build source code, CLANG9 tool chain (-t CLANG9) can be specified
on Windows OS, set CLANG_HOST_BIN=n, set CLANG9_BIN=LLVM installed directory
CLANG_HOST_BIN is used CLANG_HOST_PREFIX. Prefix n is for nmake.
For example:
*  set CLANG_HOST_BIN=n
*  set CLANG9_BIN=C:\Program Files\LLVM\bin\
*  set IASL_PREFIX=C:\Asl\

On Linux/Mac, export CLANG9_BIN=LLVM installed directory, CLANG_HOST_BIN is 
not required, because there is no prefix for make.
For example:
*  export CLANG9_BIN=/home/clang9/bin/

Now, CLANG9 tool chain has been verified in Edk2 packages and Ovmf/Emulator
with LLVM 9.0.0 on Windows and Linux OS. 
OVMF IA32/X64/IA32X64 all boots to Shell on Windows and Linux OS. 
Emulator can boot to Shell on Windows only with CLANG9.
OVMF Ia32X64 RELEASE build generates the same BIOS images on Windows and Linux 
OS.

Cc: Jiewen Yao <jiewen....@intel.com>
Cc: Steven Shi <steven....@intel.com>
Cc: Jordan Justen <jordan.l.jus...@intel.com>
Cc: Laszlo Ersek <ler...@redhat.com>
Cc: Andrew Fish <af...@apple.com>
Cc: Ray Ni <ray...@intel.com>
Cc: Ard Biesheuvel <ard.biesheu...@linaro.org>
Cc: Jian J Wang <jian.j.w...@intel.com>
Cc: Hao A Wu <hao.a...@intel.com>
Cc: Bob Feng <bob.c.f...@intel.com>
Cc: Michael D Kinney <michael.d.kin...@intel.com>
Liming Gao (12):
  BaseTools tools_def.template: Remove unnecessary $(DEST_DIR_DEBUG)
    path
  BaseTools tools_def: Add CLANG9 tool chain to directly generate PE
    image
  BaseTools GenFw: Fix the issue to update the wrong size as SectionSize
  MdePkg Base.h: Add definition for CLANG9 tool chain
  MdePkg BaseIoLibIntrinsic: Remove __inline__ attribute for IO
    functions
  MdeModulePkg LzmaCustomDecompressLib: Update macro to be same in CLANG
    tool
  MdeModulePkg RegularExpressionDxe: Disable warning for CLANG9 tool
    chain
  CryptoPkg: Append options to make CLANG9 tool chain pass build
  CryptoPkg IntrinsicLib: Make _fltused always be used
  EmulatorPkg: Enable CLANG9 tool chain
  OvmfPkg: Enable CLANG9 tool chain
  OvmfPkg SecMain: Add build option "-fno-omit-frame-pointer" for CLANG9
    X64

 BaseTools/Source/C/GenFw/GenFw.c                                |   8 +-
 CryptoPkg/Library/IntrinsicLib/MemoryIntrinsics.c               |  10 ++-
 EmulatorPkg/Win/Host/WinHost.c                                  |  11 ++-
 MdePkg/Library/BaseIoLibIntrinsic/IoLibGcc.c                    |   6 --
 BaseTools/Conf/build_rule.template                              |  26 +++---
 BaseTools/Conf/tools_def.template                               | 124 
+++++++++++++++++++++++++---
 CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf                 |   1 +
 CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf                  |   1 +
 CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.inf              |   1 +
 CryptoPkg/Library/BaseCryptLib/SmmCryptLib.inf                  |   1 +
 CryptoPkg/Library/OpensslLib/OpensslLib.inf                     |   1 +
 CryptoPkg/Library/OpensslLib/OpensslLibCrypto.inf               |   1 +
 EmulatorPkg/EmulatorPkg.dsc                                     |   8 +-
 EmulatorPkg/EmulatorPkg.fdf                                     |   2 +-
 EmulatorPkg/Win/Host/WinHost.inf                                |   6 ++
 MdeModulePkg/Library/LzmaCustomDecompressLib/Sdk/C/7zTypes.h    |   2 +-
 .../Universal/RegularExpressionDxe/RegularExpressionDxe.inf     |   3 +
 MdePkg/Include/Base.h                                           |   6 +-
 MdePkg/Include/Ia32/ProcessorBind.h                             |   4 +-
 MdePkg/Include/X64/ProcessorBind.h                              |   2 +-
 OvmfPkg/OvmfPkgIa32.dsc                                         |   4 +-
 OvmfPkg/OvmfPkgIa32X64.dsc                                      |   4 +-
 OvmfPkg/OvmfPkgX64.dsc                                          |   4 +-
 OvmfPkg/Sec/SecMain.inf                                         |   4 +
 24 files changed, 192 insertions(+), 48 deletions(-)

-- 
2.13.0.windows.1


-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.

View/Reply Online (#48192): https://edk2.groups.io/g/devel/message/48192
Mute This Topic: https://groups.io/mt/34309053/21656
Group Owner: devel+ow...@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub  [arch...@mail-archive.com]
-=-=-=-=-=-=-=-=-=-=-=-

Reply via email to