#### Beyond Linux® From Scratch (System V Edition) - Version 12.3

### Chapter 40. Graphical Web Browsers

- Prev

  Firefox-128.7.0esr

- Next

  Other X-based Programs

- Up
- Home

# Seamonkey-2.53.20

## Introduction to Seamonkey

Seamonkey is a browser suite, a descendant of Netscape. It includes the browser, composer, mail and news clients, and an IRC client.

It is the community-driven follow-on to the Mozilla Application Suite, created after Mozilla decided to focus on separate applications for browsing and e-mail. Those applications are Firefox-128.7.0 and Thunderbird-128.7.1esr.

This package is known to build and work properly using an LFS 12.3 platform.

### Package Information

- Download (HTTP): https://archive.seamonkey-project.org/releases/2.53.20/source/seamonkey-2.53.20.source.tar.xz

- Download MD5 sum: 1b506ff751f39b2480ba4e16afb86d6d

- Download size: 237 MB

- Estimated disk space required: 4.4 GB (150 MB installed)

- Estimated build time: 6.8 SBU (with parallelism=8)

### Additional Downloads

- Recommended patch (required for building with system ICU-75 or newer): https://www.linuxfromscratch.org/patches/blfs/12.3/seamonkey-2.53.20-cxx17-1.patch

### Note

The tarball seamonkey-2.53.20.source.tar.xz will untar to seamonkey-2.53.20 directory.

### Seamonkey Dependencies

#### Required

Cbindgen-0.28.0, GTK-3.24.48, libarchive-3.7.7, Python-3.11.1, yasm-1.3.0, and Zip-3.0

#### Recommended

ICU-76.1, libevent-2.1.12, libwebp-1.5.0, LLVM-19.1.7 (with clang), NASM-2.16.03, NSPR-4.36, nss-3.108, and PulseAudio-17.0

### Note

If you don't install recommended dependencies, then internal copies of those packages will be used. They might be tested to work, but they can be out of date or contain security holes.

#### Optional

alsa-lib-1.2.13, dbus-glib-0.112, nodejs-22.14.0, Valgrind-3.24.0, Wget-1.25.0, Wireless Tools-29, Hunspell and Watchman

## Installation of Seamonkey

The configuration of Seamonkey is accomplished by creating a `mozconfig` file containing the desired configuration options. A default `mozconfig` file is created below. To see the entire list of available configuration options (and an abbreviated description of each one), issue python3 configure.py --help. You may also wish to review the entire file and uncomment any other desired options. Create the file by issuing the following command:

    cat > mozconfig << "EOF"
    # If you have a multicore machine, all cores will be used

    # If you have installed DBus-Glib comment out this line:
    ac_add_options --disable-dbus

    # If you have installed dbus-glib, and you have installed (or will install)
    # wireless-tools, and you wish to use geolocation web services, comment out
    # this line
    ac_add_options --disable-necko-wifi

    # Uncomment these lines if you have installed optional dependencies:
    #ac_add_options --enable-system-hunspell

    # Uncomment the following option if you have not installed PulseAudio
    #ac_add_options --disable-pulseaudio
    # and uncomment this if you installed alsa-lib instead of PulseAudio
    #ac_add_options --enable-alsa

    # Comment out the following option

    # Comment out following options if you have not installed
    # recommended dependencies:
    ac_add_options --with-system-icu
    ac_add_options --with-system-libevent
    ac_add_options --with-system-nspr
    ac_add_options --with-system-nss
    ac_add_options --with-system-webp

    # Disabling debug symbols makes the build much smaller and a little
    # faster. Comment this if you need to run a debugger.
    ac_add_options --disable-debug-symbols

    # The elf-hack is reported to cause failed installs (after successful builds)
    # on some machines. It is supposed to improve startup time and it shrinks
    # libxul.so by a few MB.  With recent Binutils releases the linker already
    # supports a much safer and generic way for this.
    ac_add_options --disable-elf-hack
    ac_add_options --enable-linker=bfd
    export LDFLAGS="$LDFLAGS -Wl,-z,pack-relative-relocs"

    # Seamonkey has some additional features that are not turned on by default,
    # such as an IRC client, calendar, and DOM Inspector. The DOM Inspector
    # aids with designing web pages. Comment these options if you do not
    # desire these features.
    ac_add_options --enable-calendar
    ac_add_options --enable-dominspector
    ac_add_options --enable-irc

    # The BLFS editors recommend not changing anything below this line:
    ac_add_options --prefix=/usr
    ac_add_options --enable-application=comm/suite

    ac_add_options --disable-crashreporter
    ac_add_options --disable-updater
    ac_add_options --disable-tests

    # The SIMD code relies on the unmaintained packed_simd crate which
    # fails to build with Rustc >= 1.78.0.  We may re-enable it once
    # Mozilla ports the code to use std::simd and std::simd is stabilized.
    ac_add_options --disable-rust-simd

    ac_add_options --enable-strip
    ac_add_options --enable-install-strip

    # You cannot distribute the binary if you do this.
    ac_add_options --enable-official-branding

    ac_add_options --enable-system-ffi
    ac_add_options --enable-system-pixman
    ac_add_options --with-system-jpeg
    ac_add_options --with-system-png
    ac_add_options --with-system-zlib

    export CC=clang CXX=clang++
    EOF

### Note

If you are compiling this package in chroot you must ensure that `/dev/shm` is mounted. If you do not do this, the Python configuration will fail with a traceback report referencing `/usr/lib/pythonN.N/multiprocessing/synchronize.py`. As the `root` user, run:

    mountpoint -q /dev/shm || mount -t tmpfs devshm /dev/shm

First, if you are building with system ICU, adapt the line break mapping for ICU-74 or later, apply a patch to build this package with the C++17 standard because the headers of ICU-75 or later require some C++17 features, and adapt the build system to use the correct library with ICU-76 or later:

    (for i in {43..47}; do
       sed '/ZWJ/s/$/,CLASS_CHARACTER/' -i intl/lwbrk/LineBreaker.cpp || exit $?
    done) &&

    patch -Np1 -i ../seamonkey-2.53.20-cxx17-1.patch &&

    sed -i 's/icu-i18n/icu-uc &/' js/moz.configure

Next, remove a hunk of unused code violating the C++ standard. Clang has started to reject it even though it's unused since the 19.1.0 release:

    sed -e '/ExclusiveData(ExclusiveData&&/,/^ *}/d' \
        -i js/src/threading/ExclusiveData.h

Next, fix a problem with the bundled 'distro' python module:

    sed -e '1012 s/stderr=devnull/stderr=subprocess.DEVNULL/' \
        -e '1013 s/OSError/(OSError, subprocess.CalledProcessError)/' \
        -i third_party/python/distro/distro.py

Compile Seamonkey by running the following commands:

    export PATH_PY311=/opt/python3.11/bin:$PATH &&
    PATH=$PATH_PY311 AUTOCONF=true MACH_USE_SYSTEM_PYTHON=1 ./mach build

This package does not come with a test suite.

Install Seamonkey by issuing the following commands as the `root` user:

### Note

If sudo or su is invoked for opening a shell running as the `root` user, ensure `PATH_PY311` is correctly passed or the following command will fail. For sudo, use the `--preserve-env=PATH_PY311` option. For su, do not use the `-` or `--login` options.

    PATH=$PATH_PY311 MACH_USE_SYSTEM_PYTHON=1 ./mach install &&
    chown -R 0:0 /usr/lib/seamonkey                          &&

    cp -v $(find -name seamonkey.1 | head -n1) /usr/share/man/man1

Finally, unset the `PATH_PY311` variable:

    unset PATH_PY311

## Command Explanations

export CC=clang CXX=clang++: With the introduction of gcc-12, many more warnings are generated when compiling mozilla applications and that results in a much slower, and larger, build. Furthermore, building with GCC on i?86 is currently broken. Although upstream mozilla code defaults to using llvm unless overridden, the older configure code in Seamonkey defaults to gcc.

`./mach build --verbose`: Use this alternative if you need details of which files are being compiled, together with any C or C++ flags being used. But do not add '--verbose' to the install command, it is not accepted there.

`./mach build -jN`: The build should, by default, use all the online CPU cores. If using all the cores causes the build to swap because you have insufficient memory, using fewer cores can be faster.

## Configuring Seamonkey

For installing various Seamonkey add-ons, refer to Add-ons for Seamonkey.

Along with using the “Preferences” menu to configure Seamonkey's options and preferences to suit individual tastes, finer grain control of many options is only available using a tool not available from the general menu system. To access this tool, you'll need to open a browser window and enter `about:config` in the address bar. This will display a list of the configuration preferences and information related to each one. You can use the “Search:” bar to enter search criteria and narrow down the listed items. Changing a preference can be done using two methods. One, if the preference has a boolean value (True/False), simply double-click on the preference to toggle the value and two, for other preferences simply right-click on the desired line, choose “Modify” from the menu and change the value. Creating new preference items is accomplished in the same way, except choose “New” from the menu and provide the desired data into the fields when prompted.

If you use a desktop environment like Gnome or KDE you may wish to create a `seamonkey.desktop` file so that Seamonkey appears in the panel's menus. If you didn't enable Startup-Notification in your mozconfig change the StartupNotify line to false. As the `root` user:

    mkdir -pv /usr/share/{applications,pixmaps}              &&

    cat > /usr/share/applications/seamonkey.desktop << "EOF"
    [Desktop Entry]
    Encoding=UTF-8
    Type=Application
    Name=Seamonkey
    Comment=The Mozilla Suite
    Icon=seamonkey
    Exec=seamonkey
    Categories=Network;GTK;Application;Email;Browser;WebBrowser;News;
    StartupNotify=true
    Terminal=false
    EOF

    ln -sfv /usr/lib/seamonkey/chrome/icons/default/default128.png \
            /usr/share/pixmaps/seamonkey.png

## Contents

Installed Programs: seamonkey
Installed Libraries: Numerous libraries, browser, and email/newsgroup components, plugins, extensions, and helper modules installed in `/usr/lib/seamonkey`
Installed Directory: /usr/lib/seamonkey

### Short Descriptions

seamonkey | is the Mozilla browser/email/newsgroup/chat client suite

- Prev

  Firefox-128.7.0esr

- Next

  Other X-based Programs

- Up
- Home