bug 1532344: geckodriver: document how to self-service arm7hf builds; r=me a=doc
☠☠ backed out by 70fcbe1d49a5 ☠ ☠
authorAndreas Tolfsen <ato@sny.no>
Mon, 04 Mar 2019 17:29:52 +0000
changeset 520187 86c23cbb3eb148241e305a0b2372dc8a6d17195d
parent 520186 c54ee394e03c12095ec81ea539a8972894a0b741
child 520188 962e8a03ecba09cc14ff295977f78a76a6a5aa58
push id10862
push userffxbld-merge
push dateMon, 11 Mar 2019 13:01:11 +0000
treeherdermozilla-beta@a2e7f5c935da [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersme, doc
bugs1532344
milestone67.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
bug 1532344: geckodriver: document how to self-service arm7hf builds; r=me a=doc DONTBUILD
testing/geckodriver/doc/ARM.md
testing/geckodriver/doc/index.rst
new file mode 100644
--- /dev/null
+++ b/testing/geckodriver/doc/ARM.md
@@ -0,0 +1,39 @@
+Self-serving an ARM build
+=========================
+
+Mozilla [announced the intent] to deprecate ARMv7 HF builds of
+geckodriver in September 2018.  This does not mean you can no longer
+use geckodriver on ARM systems, and this document explains how you
+can self-service a build for ARMv7 HF.
+
+Assuming you have already checked out [central], the steps to
+cross-compile ARMv7 from a Linux host system is as follows:
+
+  1. If you don’t have Rust installed:
+
+     	# curl https://sh.rustup.rs -sSf | sh
+
+  2. Install cross-compiler toolchain:
+
+     	# apt install gcc-arm-linux-gnueabihf libc6-armhf-cross libc6-dev-armhf-cross
+
+  3. Createa a new shell, or to reuse the existing shell:
+
+     	source $HOME/.cargo/env
+
+  4. Install rustc target toolchain:
+
+     	% rustup target install armv7-unknown-linux-gnueabihf
+
+  5. Put this in testing/geckodriver/.cargo/config:
+
+     	[target.armv7-unknown-linux-gnueabihf]
+     	linker = "arm-linux-gnueabihf-gcc"
+
+  6. Build geckodriver from testing/geckodriver:
+
+     	% cd testing/geckodriver
+     	% cargo build --release --target armv7-unknown-linux-gnueabihf
+
+[announce the intent]: https://lists.mozilla.org/pipermail/tools-marionette/2018-September/000035.html
+[central]: https://hg.mozilla.org/mozilla-central/
--- a/testing/geckodriver/doc/index.rst
+++ b/testing/geckodriver/doc/index.rst
@@ -37,16 +37,17 @@ For users
 For developers
 ==============
 .. toctree::
    :maxdepth: 1
 
    Building.md
    Testing.md
    Releasing.md
+   ARM.md
 
 
 Communication
 =============
 
 The mailing list for geckodriver discussion is
 tools-marionette@lists.mozilla.org (`subscribe`_, `archive`_).