1641684 - Cross-compilation documentation for SpiderMonkey is out-of-date for ARM64

Status: RESOLVED FIXED

(Core :: JavaScript Engine, enhancement, P3)

Description

[Chris Fallin [:cfallin]]

I set out to cross-compile an ARM64 JS shell binary today from my Linux/x86-64 host, and then run JIT tests using that binary under qemu.

Unfortunately, the current documentation for cross-compilation appears to be somewhat lacking. For example, the docs on dev.m.o are missing at least one environment-variable setting (CPATH) that turned out to be necessary. Also, there is no documentation on how to use qemu to run the cross-compiled binary under jit_test.py.

This bug tracks an update to js/src/doc/build.rst to cover these procedures in more detail.

Comment 1

[Chris Fallin [:cfallin]]

Attachment: Bug 1641684: Add documentation about cross-compiling SpiderMonkey. r=bbouvier

This patch updates js/src/doc/build.rst to include up-to-date
instructions for cross-compiling a SpiderMonkey binary; for example, how
to build a Linux/aarch64 binary on a Linux/x86-64 host. It also adds
information about how to use qemu to run JIT-tests on this
cross-compiled binary without requiring native hardware at all. It has
been tested on the above platform pair (x86 to aarch64).

Comment 2

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/e3cb77c5f17e
Add documentation about cross-compiling SpiderMonkey. r=bbouvier

Comment 3

[Cristina Coroiu [:ccoroiu]]

https://hg.mozilla.org/mozilla-central/rev/e3cb77c5f17e