1
0
mirror of https://github.com/rkd77/elinks.git synced 2024-11-02 08:57:19 -04:00
elinks/doc/cross_mingw.txt
2022-04-23 01:35:02 +02:00

119 lines
4.1 KiB
Plaintext

--| |--
--[ HOWTO CROSS-COMPILE ELINKS ]--
--| |--
--[ FOR LIN64, WIN64 AND ARM32 ]--
--| |--
--= 2022 04 22 =--
--| |--
Hello All,
so it could be annoying to get elinks compiled on Windows.
Or Arm or just different architecture than Linux.
if You'd like to do that there is a solution. And that's
mingw. You can cross-compile on Linux for Windows or Arm
CPU.
Now I'll assume You'd want to compile Windows x64 binary on
Linux. There is a script I provide. it's build.sh. It would
create static binary for arm, win or lin.
On Debian You'd use x86_64-w64-mingw32-gcc or rather the
mingw toolchain. It's usage it's quite straight forward just
use it as environment variable:
CC=x86_64-w64-mingw32-gcc
and to prepare the compilation configuration add:
--host=x86_64-w64-mingw32
parameter to configure.
And that's it. With the script You'll get the very basic
binary for Windows. It could be run, it would open simple
http pages. The support for the terminal is not very good.
So I would advise You to use environment variable TERM and
set it to dumb. Like this:
set TERM=dumb
Some note on the testing environment. You of course obtain
several machines and test it. But Linux handles all the
emulation by itself. As I said here we assume You have
Debian 10 at hand. And it can provide several machines at
once as testing environment.
[*] Windows
For Windows You can run it in qemu. There is plenty of
tutorials on the Net on HOWTO run Windows on it. Once You
have the Windows x64 system it's not really necessary to
open the graphical user interface. In the time of the
writting there is possibility to run openssh server on
it. To prepare the OpenSSH server just execute in admin
powershell:
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
Start-Service sshd
Set-Service -Name sshd -StartupType 'Automatic'
You have to tune the firewall. And forward the port to the
localhost of the host machine from gues. After that You get
the command prompt. I'm using sshfs to mount the host
directory with the elinks sources so there is nothing
necessary to copy and You can compile on the Linux host and
execute binary on the Windows guest.
Using GNU screen enables me to have 0-9 console screens.
Some of it are dedicated to the binaries building on the
Linux host and some one is ssh to the Windows guest and it's
prepared in the mounted sources directory via sshfs to
execute when compilation succeed.
Other option is to use Wine but currently that doesn't
provide the natural feeling of dumb terminal (see above).
[*] ARM CPU
The other architecture is from different category. In time
of writting there is Raspberry Pi, Mobile Phones, NAS etc.
Shortly You can get ARM processor in many devices. And
sometimes it's handy to browse without much stress for the
CPU that makes the common Graphical Interface unusable.
To compile the binary for ARM You can use MinGW analogically
to the Win architecture. I'd suggest following:
CC=arm-linux-gnueabihf-gcc
LD=arm-linux-gnueabihf-ld
--build=arm-linux-gnu
There are differences in the processors and currently the
64-bit ARM CPU's are out [ aarch64 ].
To test the binary You can emulate the raspberry pi in qemu
in the same manner as windows. In my case I've got qemu
running with the Raspbery Pi 2B emulation. I'm using sshfs
in the same manner and have it open on one of the GNU
screens. That makes the same efficiency in the terms of not
needing to have any other device at hand and still make the
basic tests of binaries correctness.
There is one more option to run the arm binary. And that's
qemu's command qemu-arm-static:
qemu-arm-static ./src/elinks
Finally the qemu provides runtime emulation for static
binary without any need for additional disk space etc.
Till Next Time