From: Mike Pall Date: Sun, 10 Dec 2023 14:50:14 +0000 (+0100) Subject: Merge branch 'master' into v2.1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=420a9afa93d9f83ecb3ff05a0e37eda5e5616b65;p=thirdparty%2FLuaJIT.git Merge branch 'master' into v2.1 --- 420a9afa93d9f83ecb3ff05a0e37eda5e5616b65 diff --cc doc/install.html index 04bfe26d,7f2e40e4..b6481443 --- a/doc/install.html +++ b/doc/install.html @@@ -252,36 -235,28 +252,37 @@@ directory where luajit.exe is

Cross-compiling LuaJIT

+First, let's clear up some terminology: +

Host: This is your development system, usually based on a x64 or x86 CPU.
Target: This is the target system you want LuaJIT to run on, e.g. Android/ARM.
Toolchain: This comprises a C compiler, linker, assembler and a matching C library.
Host (or system) toolchain: This is the toolchain used to build native binaries for your host system.
Cross-compile toolchain: This is the toolchain used to build binaries for the target system. They can only be run on the target system.

The GNU Makefile-based build system allows cross-compiling on any host -for any supported target, as long as both architectures have the same -pointer size. If you want to cross-compile to any 32 bit target on an -x64 OS, you need to install the multilib development package (e.g. -libc6-dev-i386 on Debian/Ubuntu) and build a 32 bit host part -(HOST_CC="gcc -m32"). On some distro versions, multilib conflicts -with cross-compilers. The workaround is to install the x86 cross-compiler -package gcc-i686-linux-gnu and use it to build the host part -(HOST_CC=i686-linux-gnu-gcc). +for any supported target:

Yes, you need a toolchain for both your host and your target!
Both host and target architectures must have the same pointer size.
E.g. if you want to cross-compile to a 32 bit target on a 64 bit host, you need to install the multilib development package (e.g. libc6-dev-i386 on Debian/Ubuntu) and build a 32 bit host part (HOST_CC="gcc -m32").
On some distro versions, multilib conflicts with cross-compilers. The workaround is to install the x86 cross-compiler package gcc-i686-linux-gnu and use it to build the host part (HOST_CC=i686-linux-gnu-gcc).
64 bit targets always require compilation on a 64 bit host.

You need to specify TARGET_SYS whenever the host OS and the -target OS differ, or you'll get assembler or linker errors. E.g. if -you're compiling on a Windows or macOS host for embedded Linux or Android, -you need to add TARGET_SYS=Linux to the examples below. For a -minimal target OS, you may need to disable the built-in allocator in -src/Makefile and use TARGET_SYS=Other. Don't forget to -specify the same TARGET_SYS for the install step, too. +target OS differ, or you'll get assembler or linker errors:

E.g. if you're compiling on a Windows or macOS host for embedded Linux or Android, you need to add TARGET_SYS=Linux to the examples below.
For a minimal target OS, you may need to disable the built-in allocator in src/Makefile and use TARGET_SYS=Other.
Don't forget to specify the same TARGET_SYS for the install step, too.

-The examples below only show some popular targets — please check -the comments in src/Makefile for more details. +Here are some examples where host and target have the same CPU:

  # Cross-compile to a 32 bit binary on a multilib x64 OS