From f2892793be5c96c7351bd4cf2f3233c94f364afb Mon Sep 17 00:00:00 2001 From: Paul Adenot Date: Fri, 26 Jun 2020 12:52:31 +0000 Subject: [PATCH] Bug 1648393 - Update this document for Ubuntu and remove obsolete section. r=firefox-source-docs-reviewers,sylvestre Differential Revision: https://phabricator.services.mozilla.com/D81043 --- docs/setup/linux_32bit_build_on_64bit_OS.rst | 221 ++----------------- 1 file changed, 16 insertions(+), 205 deletions(-) diff --git a/docs/setup/linux_32bit_build_on_64bit_OS.rst b/docs/setup/linux_32bit_build_on_64bit_OS.rst index 4a1aa79fa5e8..7084d07b310d 100644 --- a/docs/setup/linux_32bit_build_on_64bit_OS.rst +++ b/docs/setup/linux_32bit_build_on_64bit_OS.rst @@ -1,5 +1,5 @@ -Building Firefox 32bit On Linux 64bit -===================================== +Building Firefox 32-bit On Linux 64-bit +======================================= Instructions for Fedora 20 and 19 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -17,8 +17,6 @@ are installed. glib-devel.i686 glib2-devel.i686 \ dbus-devel.i686 dbus-glib-devel.i686 \ alsa-lib-devel.i686 yasm-devel.i686 \ - gstreamer-devel.i686 gstreamer-plugins-devel.i686 \ - gstreamer-plugins-base-devel.i686 \ libxml2-devel.i686 zlib-devel.i686 \ freetype-devel.i686 \ atk-devel.i686 pango-devel.i686 fontconfig-devel.i686 \ @@ -51,218 +49,31 @@ Then you need to use a .mozconfig that looks like the following example. ac_add_options --enable-debug ac_add_options --disable-optimize -Instructions for Ubuntu 18.10 +Instructions for Ubuntu 19.10 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. warning:: +These steps were verified to work as of June 2020 - WARNING: Although Ubuntu and other Debian-derived distributions - support multiarch packages these days, there are still cases where - packages are broken, or where the 32-bit and 64-bit versions of a - package conflict. This makes it difficult to impossible to have a - 32-bit development environment co-exist with a 64-bit development - environment. **So it is recommended to follow these instructions in a - separate virtual machine!** - -These steps were verified to work as of December 2018: - -#. Set up a new virtual machine running Ubuntu 18.10. -#. Install python with ``sudo apt install python``. -#. Install mercurial or git and fetch a copy of mozilla-central. +#. Install mercurial or git and :ref:`fetch a copy ` of ``mozilla-central``. #. Run ``./mach bootstrap`` to install some dependencies. Note that this will install some amd64 packages that are not needed to build 32-bit Firefox. #. Run ``rustup target install i686-unknown-linux-gnu`` to install the 32-bit Rust target. -#. Install 32-bit dependencies with the following command (this may - uninstall some unneeded/conflicting packages that were installed by - mach bootstrap): +#. Install 32-bit dependencies with the following command (this shouldn't try to + remove packages. If this is the case, those instructions won't work as-is): -.. code:: syntaxbox + .. code:: syntaxbox - sudo apt install gcc-multilib g++-multilib libdbus-glib-1-dev:i386 \ - libgtk2.0-dev:i386 libgtk-3-dev:i386 libpango1.0-dev:i386 libxt-dev:i386 + sudo apt install gcc-multilib g++-multilib libdbus-glib-1-dev:i386 \ + libgtk2.0-dev:i386 libgtk-3-dev:i386 libpango1.0-dev:i386 libxt-dev:i386 \ + libpulse-dev:i686 -7. Create a ``.mozconfig`` file containing at least the following: +5. Create a file called ``mozconfig`` in the top-level directory of you + ``mozilla-central`` checkout, containing at least the following: -.. code:: syntaxbox + .. code:: syntaxbox - ac_add_options --target=i686-pc-linux + ac_add_options --target=i686 - CFLAGS="$CFLAGS -march=pentium-m -msse -msse2 -mfpmath=sse" - CXXFLAGS="$CXXFLAGS -march=pentium-m -msse -msse2 -mfpmath=sse" - - export PKG_CONFIG_PATH=/usr/lib/i386-linux-gnu/pkgconfig - -8. Run ``./mach build``. - -Older, generic instructions for Ubuntu -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Method 1: True Cross-Compiling -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -This method is actually cross-compiling: you take a 64-bit toolchain and -produce 32-bit binaries. This is ideally how you cross-compile. - -#. ``sudo apt-get install ia32-libs gcc-multilib g++-multilib lib32*`` -#. (I had to open Synaptic afterwards, search for package names - beginning with lib32, and install the ones that apt-get missed) -#. Use a ``.mozconfig`` like below. -#. ``make -f client.mk build`` - -:: - - export CROSS_COMPILE=1 - mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir-ff-dbg32 - mk_add_options MOZ_MAKE_FLAGS="-s -j4" - ac_add_options --enable-application=browser - - CC="gcc -m32" - CXX="g++ -m32" - AR=ar - ac_add_options --x-libraries=/usr/lib32 - ac_add_options --target=i686-pc-linux - - ac_add_options --disable-crashreporter # needed because I couldn't find a 32-bit curl-dev lib - ac_add_options --disable-libnotify # needed because I couldn't find a 32-bit libinotify-dev - ac_add_options --disable-gnomevfs # needed because I couldn't find a 32-bit libgnomevfs-dev - ac_add_options --disable-gstreamer # needed because I couldn't find a 32-bit gstreamer lib - -If you are getting an error as follows: - -:: - - error: Can't find header fontconfig/fcfreetype.h - -Add these configuration options to your ``.mozconfig``: - -:: - - ac_add_options --disable-freetypetest - ac_add_options --disable-pango - -Method 2: Create a 32-bit chroot Environment -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -In this method, we effectively create a wholly-contained 32-bit -operating system within a 64-bit operating system using ``schroot``. -This isn't technically cross-compiling, but it yields the same result: -32-bit binaries. - -This method is arguably more reliable than true cross-compiling because -the newly-created environment is completely isolated from the 64-bit -operating system and it won't be susceptible to common issues with -cross-compiling, such as unavailability of 32-bit libraries/packages -when running in 64-bit mode. Additionally, since your 32-bit environment -is completely isolated, to clean up from it, you just ``rm -rf`` the -chroot directory. Contrast this with removing dozens of 32-bit packages -from your primary operating system. - -The downside to this method is size and complexity. Since you will be -effectively creating a whole operating system within your primary -operating system, there will be lots of redundant files. You'll probably -need at least 1GB for all the new files. Additionally, the steps for -initially creating the 32-bit environment are more involved. See the -bottom of this page for a script capable of automating the whole process -of cross-compilation. - -To create a 32-bit chroot Ubuntu environment, follow the -`DebootstrapChroot `__ -instructions. Here is an example config file which works in Ubuntu -13.10: - -:: - - # /etc/schroot/chroot.d/saucy_i386 - - [saucy_i386] - description=Ubuntu 13.10 for i386 - directory=/srv/chroot/saucy_i386 - root-users=gps - type=directory - personality=linux32 - users=gps - -Once you have changed the ``root-users`` and ``users`` entries to -include your username and verified that ``$ schroot -c saucy_i386`` -works, ``$ exit`` back to your regular operating system and copy your -APT's sources list to the new environment: - -:: - - $ sudo cp /etc/apt/sources.list /srv/chroot/saucy_i386/etc/apt/sources.list - -**Note: this assumes a generic sources list. If you have modified this -file yourself, you may wish to ensure the contents are accurate when you -perform the copy.** - -The reason we copy the APT sources is because ``debootstrap``\ does not -appear to configure all the sources by default (it doesn't define the -"sources" sources, for example). - -Once your sources list is copied over, enter your new environment and -configure things: - -:: - - # Update the APT sources and install sudo into the new environment and exit back out - $ schroot -c saucy_i386 -u root - (precise_i386) # apt-get update - (precise_i386) # apt-get install sudo - (precise_i386) # exit - - # re-enter the environment as a regular user - $ schroot -c saucy_i386 - - # Install Firefox build dependencies - $ sudo apt-get build-dep firefox - -Now, your new 32-bit operating system should be ready for building -Firefox! - -| One last step is ensuring that ``configure``\ detects the proper - system type. Since you are technically running on a 64-bit kernel, - things could still be fooled. -|  Run the following program from your mozilla source tree: - -:: - - $ ./build/autoconf/config.guess - -**If this prints anything with ``x86_64``, the system type is being -incorrectly detected and you must override it.** You can fix things by -adding the following to your ``mozconfig``: - -:: - - ac_add_options --host=i686-pc-linux-gnu - ac_add_options --target=i686-pc-linux-gnu - -When you run configure (``$ mach configure``), verify that the host, -target, and build system types are what you just defined in your -``mozconfig``: - -:: - - checking host system type... i686-pc-linux-gnu - checking target system type... i686-pc-linux-gnu - checking build system type... i686-pc-linux-gnu - -If you intend to run the 32bits Firefox build in the chroot on the -64bits machine, you need to install a few packages in the host: - -:: - - sudo apt-get install gcc-multilib g++-multilib libxrender1:i386 libasound-dev:i386 libdbus-glib-1-2:i386 libgtk2.0-0:i386 libxt-dev:i386 - -Now, follow the `build -instructions `__ like normal and -you should have 32-bit builds! - -See Also -~~~~~~~~ - -- `Cross-Compiling Mozilla `__ -- `Set of scripts to automate the chroot and build process on - Ubuntu `__ +6. Run ``./mach build``.