llvm-project/llvm/cmake
Shoaib Meenai 1295088fba [cmake] Use symlinks for Windows-hosted toolchains built on Unix
When cross-compiling for Windows on Unix, the built toolchain will need
to be transferred to Windows to actually run. My opinion is that the
Unix build should use symlinks, and the transfer to Windows should take
care of making those symlinks usable. E.g., I envision tarballs to be a
common form of transfer from Unix to Windows, in which case the tarball
can be created using --dereference to follow the symlinks.

The motivation here is that, when cross-compiling for Windows on Unix,
the installation will *already* create symlinks. The reason is that the
installation script will be invoked without knowing the host system, so
the `if(UNIX)` check in the installation symlink creation script will
reflect the build system rather than the host system. We could either
make the build and install trees both contain copies or both contain
symlinks, and using symlinks is a significant space saving without (in
my opinion) having any detrimental effect on the usage of the cross-
compiled toolchain on Windows.

A secondary motivation is that Windows 10 version 1703 and later finally
lift the administrator rights requirement for creating symbolic links
(if the system is in Developer Mode), which makes symlinks a lot more
practical even on Windows. Of course Unix and Windows symlinks aren't
interoperable, but symlinks for Windows toolchains is a reasonable
future direction to be going in anyway.

Differential Revision: https://reviews.llvm.org/D41314

llvm-svn: 322061
2018-01-09 07:50:18 +00:00
..
modules [cmake] Use symlinks for Windows-hosted toolchains built on Unix 2018-01-09 07:50:18 +00:00
platforms [cmake] Fix clang-cl cross-compilation on macOS 2017-12-15 01:05:48 +00:00
README
config-ix.cmake [opt-viewer] Check for pygments.lexer.c_cpp 2018-01-02 17:53:08 +00:00
config.guess Remove Bitrig: LLVM Changes 2017-07-21 22:48:47 +00:00
dummy.cpp [CMake] Fix Xcode build with LLVM_ENABLE_OBJLIB. 2015-09-10 17:18:51 +00:00
nsis_icon.ico
nsis_logo.bmp

README

See docs/CMake.html for instructions on how to build LLVM with CMake.