source: xsoft/graphweb/firefox.xml@ 13e9ee0c

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 13e9ee0c was 13e9ee0c, checked in by Ken Moffat <ken@…>, 4 years ago

Firefox-57.0.3 : fixes possible information disclosure to mozilla.org (background tab crashes have been reported since ff52 even in some cases where the user opted out of that, although they also take efforts to anonymize the data).

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19630 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 17.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY firefox-download-http "&mozilla-http;/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.xz">
8 <!ENTITY firefox-download-ftp " ">
9 <!ENTITY firefox-md5sum "86ba79e579646f13a1569deef73edf7b">
10 <!ENTITY firefox-size "239 MB">
11 <!ENTITY firefox-buildsize "7.2 GB (148 MB installed) without tests">
12 <!ENTITY firefox-time "20 SBU (with parallelism=4) without tests">
13]>
14
15<sect1 id="firefox" xreflabel="Firefox-&firefox-version;">
16 <?dbhtml filename="firefox.html" ?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Firefox-&firefox-version;</title>
24
25 <indexterm zone="firefox">
26 <primary sortas="a-Firefox">Firefox</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Firefox</title>
31
32 <para>
33 <application>Firefox</application> is a stand-alone browser based on the
34 <application>Mozilla</application> codebase.
35 </para>
36
37 &lfs81_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&firefox-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&firefox-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &firefox-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &firefox-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &firefox-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &firefox-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <note>
74 <para>
75 The build times for this version of firefox (using stylo, the new CSS
76 rendering code) seem to vary widely between different machines. On one
77 old Intel i3 the build took 33 SBU. The reason for this is not understood.
78 A build with stylo disabled is typically 1 or 2 SBU quicker and needs
79 0.8GB less disk space.
80 </para>
81 </note>
82
83 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
84 <itemizedlist spacing="compact">
85 <listitem>
86 <para>
87 Optional patch to allow system versions of <xref linkend="graphite2"/>
88 and <xref linkend="harfbuzz"/>:
89 <ulink url="&patch-root;/firefox-&firefox-version;-system_graphite2_harfbuzz-1.patch"/>
90 </para>
91 </listitem>
92 </itemizedlist>
93
94 <note>
95 <para>
96 The tarball <emphasis>firefox-&firefox-version;.source.tar.xz</emphasis>
97 will untar to <emphasis>firefox-&firefox-version;</emphasis> directory.
98 It will also reset the permissions of the current directory to 0755 if you
99 have permission to do that. If you do this in a directory where
100 the sticky bit is set, such
101 as <filename class="directory">/tmp</filename> it will end with error
102 messages:
103 </para>
104
105<literallayout>tar: .: Cannot utime: Operation not permitted
106tar: .: Cannot change mode to rwxr-xr-t: Operation not permitted
107tar: Exiting with failure status due to previous errors
108</literallayout>
109
110 <para>
111 This does finish with non-zero status, but it does
112 <emphasis>NOT</emphasis> mean there is a real problem.
113 Do not untar as the <systemitem class="username">root</systemitem> user
114 in a directory where the sticky bit is set - that will unset it.
115 </para>
116 </note>
117
118 <bridgehead renderas="sect3">Firefox Dependencies</bridgehead>
119
120 <bridgehead renderas="sect4">Required</bridgehead>
121 <para role="required">
122 <xref linkend="autoconf213"/>,
123 both <xref linkend="gtk3"/> and
124 <xref linkend="gtk2"/>,
125 <xref linkend="nss"/>,
126 <xref linkend="pulseaudio"/>
127 (or
128 <xref linkend="alsa-lib"/> if you edit the mozconfig;
129 now deprecated by mozilla),
130 <xref linkend="rust"/>,
131 <xref linkend="unzip"/>,
132 <xref linkend="yasm"/>, and
133 <xref linkend="zip"/>
134 </para>
135
136 <bridgehead renderas="sect4">Recommended</bridgehead>
137 <para role="recommended">
138 <xref linkend="icu"/>,
139 <xref linkend="libevent"/>,
140 <xref linkend="libvpx"/>,
141 <package>clang</package> from <xref linkend="llvm"/> (for stylo), and
142 <xref linkend="sqlite"/>
143 </para>
144
145 <note>
146 <para>
147 If you don't install recommended dependencies, then internal copies of
148 those packages will be used. They might be tested to work, but they can
149 be out of date or contain security holes.
150 </para>
151 </note>
152
153 <note>
154 <para>
155 With <application>Firefox-31.0</application> and later versions, you
156 must have installed <application>Openssl</application> before
157 <application>Python 2</application> or the build system will quickly
158 fail with output including "ImportError: cannot import name
159 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
160 an older version of Firefox), check if
161 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
162 exists. If it does not, reinstall <xref linkend="python2"/> (after
163 installing <xref linkend="openssl"/>). The latest version of any
164 <emphasis>currently maintained</emphasis> version of Openssl should be
165 satisfactory if already installed.
166 </para>
167 </note>
168
169 <bridgehead renderas="sect4">Optional</bridgehead>
170 <para role="optional">
171 <xref linkend="curl"/>,
172 <xref linkend="dbus-glib"/>,
173 <xref linkend="doxygen"/>,
174 <xref linkend="GConf"/>,
175 <xref role="runtime" linkend="ffmpeg"/> (runtime, to play mov, mp3 or mp4 files),
176 <xref linkend="libwebp"/>,
177 <xref linkend="openjdk"/>,
178 <xref linkend="startup-notification"/>,
179 <xref linkend="valgrind"/>,
180 <xref linkend="wget"/>,
181 <xref linkend="wireless_tools"/>,
182 <ulink url="https://hunspell.github.io/">Hunspell</ulink>,
183 <phrase revision="sysv"><ulink url="http://sourceforge.net/projects/liboauth/files/">liboauth</ulink></phrase>
184 <phrase revision="systemd"><xref linkend="liboauth"/></phrase>,
185 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
186 and (with the patch)
187 <xref linkend="graphite2"/> and
188 <xref linkend="harfbuzz"/>
189 </para>
190
191 <para condition="html" role="usernotes">
192 User Notes: <ulink url="&blfs-wiki;/firefox"/>
193 </para>
194 </sect2>
195
196 <sect2 role="installation">
197 <title>Installation of Firefox</title>
198
199 <para>
200 The configuration of <application>Firefox</application> is accomplished
201 by creating a <filename>mozconfig</filename> file containing the desired
202 configuration options. A default <filename>mozconfig</filename> is
203 created below. To see the entire list of available configuration options
204 (and an abbreviated description of some of them), issue <command>./configure
205 --help</command>. You may also wish to review the entire file and
206 uncomment any other desired options. Create the file by issuing the
207 following command:
208 </para>
209
210<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
211<literal># If you have a multicore machine, all cores will be used by default.
212# You can change the number of non-rust jobs by setting a valid number
213# of cores in this option, but when rust crates are being compiled
214# jobs will be scheduled for all the online CPU cores.
215#mk_add_options MOZ_MAKE_FLAGS="-j1"
216
217# If you have installed dbus-glib, comment out this line:
218ac_add_options --disable-dbus
219
220# If you have installed dbus-glib, and you have installed (or will install)
221# wireless-tools, and you wish to use geolocation web services, comment out
222# this line
223ac_add_options --disable-necko-wifi
224
225# API Keys for geolocation APIs - necko-wifi (above) is required for MLS
226# Uncomment the following line if you wish to use Mozilla Location Service
227#ac_add_options --with-mozilla-api-keyfile=$PWD/mozilla-key
228
229# Uncomment the following line if you wish to use Google's geolocaton API
230# (needed for use with saved maps with Google Maps)
231#ac_add_options --with-google-api-keyfile=$PWD/google-key
232
233# Uncomment these lines if you have installed optional dependencies:
234#ac_add_options --enable-system-hunspell
235#ac_add_options --enable-startup-notification
236
237# Uncomment the following option if you have not installed PulseAudio
238#ac_add_options --disable-pulseaudio
239# and uncomment this if you installed alsa-lib instead of PulseAudio
240#ac_add_options --enable-alsa
241
242# If you have installed GConf, comment out this line
243ac_add_options --disable-gconf
244
245# Stylo is the new CSS code, including the rust 'style'
246# package. It is enabled by default but requires clang.
247# Uncomment this if you do not wish to use stylo.
248#ac_add_options --disable-stylo
249
250# Comment out following options if you have not installed
251# recommended dependencies:
252ac_add_options --enable-system-sqlite
253ac_add_options --with-system-libevent
254ac_add_options --with-system-libvpx
255ac_add_options --with-system-nspr
256ac_add_options --with-system-nss
257ac_add_options --with-system-icu
258
259# If you are going to apply the patch for system graphite
260# and system harfbuzz, uncomment these lines:
261#ac_add_options --with-system-graphite2
262#ac_add_options --with-system-harfbuzz
263
264# Stripping is now enabled by default.
265# Uncomment these lines if you need to run a debugger:
266#ac_add_options --disable-strip
267#ac_add_options --disable-install-strip
268
269# The BLFS editors recommend not changing anything below this line:
270ac_add_options --prefix=/usr
271ac_add_options --enable-application=browser
272
273ac_add_options --disable-crashreporter
274ac_add_options --disable-updater
275# enabling the tests will use a lot more space and significantly
276# increase the build time, for no obvious benefit.
277ac_add_options --disable-tests
278
279# Optimization for size is broken with gcc7
280ac_add_options --enable-optimize="-O2"
281
282ac_add_options --enable-official-branding
283
284# From firefox-40, using system cairo caused firefox to crash
285# frequently when it was doing background rendering in a tab.
286# This appears to again work in firefox-56
287ac_add_options --enable-system-cairo
288ac_add_options --enable-system-ffi
289ac_add_options --enable-system-pixman
290
291ac_add_options --with-pthreads
292
293ac_add_options --with-system-bz2
294ac_add_options --with-system-jpeg
295ac_add_options --with-system-png
296ac_add_options --with-system-zlib
297
298mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir</literal>
299EOF</userinput></screen>
300
301 <para>
302 Compile <application>Firefox</application> by issuing the following
303 commands:
304 </para>
305
306 <para>
307 If you have installed system versions of graphite2 and harfbuzz and wish
308 firefox to use those instead of its shipped versions, apply the patch and
309 uncomment the appropriate entries in the <filename>mozconfig</filename>
310 file.
311 </para>
312
313<screen><userinput>patch -Np1 -i ../firefox-&firefox-version;-system_graphite2_harfbuzz-1.patch</userinput></screen>
314
315 <para>
316 If the geolocation APIs are needed:
317 </para>
318
319 <note>
320 <para>
321 <!-- Taken from Arch Linux - an immensely helpful link - Thanks -->
322 The Google and Mozilla API Keys below are specific to LFS. If using
323 these instructions for another distro, or if you intend to distribute
324 binary copies of the software using these instructions, please obtain
325 your own keys following the instructions located at
326 <ulink url="http://www.chromium.org/developers/how-tos/api-keys"/> and
327 <ulink url="https://location.services.mozilla.com/api"/> respectively.
328 <!-- BLFS Devs, register an account at Google with your
329 @linuxfromscratch.org email address, and I'll make you an administrator
330 for the 'Google APIs for LFS' project (where the API and OAuth keys
331 were created for use in the book).-->
332 </para>
333 </note>
334
335<screen><userinput>echo "AIzaSyDxKL42zsPjbke5O8_rPVpVrLrJ8aeE9rQ" > google-key
336echo "d2284a20-0505-4927-a809-7ffaf4d91e55" > mozilla-key</userinput></screen>
337
338 <note><para>
339 If you are compiling <application>Firefox</application> in chroot, make
340 sure you have <envar>$SHELL</envar> environment variable set or prepend
341 <envar>SHELL=/bin/sh</envar>.
342 </para></note>
343
344<!-- the BINDGEN_CFLAGS are to work around
345 https://bugzilla.mozilla.org/show_bug.cgi?id=1341234
346 which is reported to be fixed in ff58 -->
347<screen><userinput>export BINDGEN_CFLAGS=$(pkg-config --cflags nspr pixman-1) &amp;&amp;
348make -f client.mk &amp;&amp;
349unset BINDGEN_CFLAGS</userinput></screen>
350
351 <para>
352 The <filename>mozconfig</filename> above disables the tests because
353 they use a lot more time and disk space for no obvious benefit. If
354 you have nevertheless enabled them, you can run the tests by executing
355 <command>./mach gtest</command>. This will require a network connection,
356 and to be run from within an Xorg session - there is a popup dialog
357 when it fails to connect to ALSA (that does not create a failed test).
358 One or two tests will fail. To see the details of the failure(s) you
359 will need to log the output from that command so that you can review it.
360 </para>
361
362 <para>
363 Now, as the <systemitem class="username">root</systemitem> user:
364 </para>
365
366<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
367chown -R 0:0 /usr/lib/firefox-&firefox-version; &amp;&amp;
368
369mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
370ln -sfv ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
371<!--
372 <para>
373 Set environment variables back to their values:
374 </para>
375
376<screen><userinput>export CFLAGS=$CFLAGS_HOLD &amp;&amp;
377export CXXFLAGS=$CXXFLAGS_HOLD &amp;&amp;
378unset CFLAGS_HOLD CXXFLAGS_HOLD</userinput></screen>
379-->
380
381 </sect2>
382
383 <sect2 role="commands">
384 <title>Command Explanations</title>
385
386 <para>
387 <command>export BINDGEN_CFLAGS=$(pkg-config --cflags nspr pixman-1)</command>:
388 This works around a bug in the style rust package to allow it to find the
389 system headers for <package>nspr</package> and <package>pixman</package>.
390 </para>
391
392 <para>
393 <command>make -f client.mk ...</command>: Mozilla products are packaged to
394 allow the use of a configuration file which can be used to pass the
395 configuration settings to the <command>configure</command> command.
396 <command>make</command> uses the <filename>client.mk</filename> file to
397 get initial configuration and setup parameters.
398 </para>
399
400 <para>
401 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
402 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
403 exists.
404 </para>
405
406 <para>
407 <command>ln -sv ... /usr/lib/firefox-&firefox-version;/browser</command>:
408 This command creates a symbolic link to <filename
409 class="directory">/usr/lib/mozilla/plugins</filename>. It's not really
410 needed, as <application>Firefox</application> checks <filename
411 class="directory">/usr/lib/mozilla/plugins</filename> by default, but the
412 symbolic link is made to keep all the plugins installed in one folder.
413 </para>
414
415 </sect2>
416
417 <sect2 role="configuration">
418 <title>Configuring Firefox</title>
419
420 <para>
421 If you use a desktop environment like <application>Gnome</application> or
422 <application>KDE</application> you may like to create a
423 <filename>firefox.desktop</filename> file so that
424 <application>Firefox</application> appears in the panel's menus. If you
425 didn't enable startup-notification in your mozconfig change the
426 StartupNotify line to false. As the
427 <systemitem class="username">root</systemitem> user:
428 </para>
429
430<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
431mkdir -pv /usr/share/pixmaps &amp;&amp;
432
433cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
434<literal>[Desktop Entry]
435Encoding=UTF-8
436Name=Firefox Web Browser
437Comment=Browse the World Wide Web
438GenericName=Web Browser
439Exec=firefox %u
440Terminal=false
441Type=Application
442Icon=firefox
443Categories=GNOME;GTK;Network;WebBrowser;
444MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
445StartupNotify=true</literal>
446EOF
447
448ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
449 /usr/share/pixmaps/firefox.png</userinput></screen>
450
451 </sect2>
452
453 <sect2 role="content">
454 <title>Contents</title>
455
456 <segmentedlist>
457 <segtitle>Installed Programs</segtitle>
458 <segtitle>Installed Libraries</segtitle>
459 <segtitle>Installed Directory</segtitle>
460
461 <seglistitem>
462 <seg>
463 firefox
464 </seg>
465 <seg>
466 Numerous libraries, browser components, plugins, extensions, and
467 helper modules installed in /usr/lib/firefox-&firefox-version;
468 </seg>
469 <seg>
470 /usr/lib/firefox-&firefox-version; and /usr/lib/mozilla
471 </seg>
472 </seglistitem>
473 </segmentedlist>
474
475 <variablelist>
476 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
477 <?dbfo list-presentation="list"?>
478 <?dbhtml list-presentation="table"?>
479
480 <varlistentry id="firefox-prog">
481 <term><command>firefox</command></term>
482 <listitem>
483 <para>
484 is a <application>GTK+-3</application> internet browser that uses
485 the Mozilla Gecko rendering engine.
486 </para>
487 <indexterm zone="firefox firefox-prog">
488 <primary sortas="b-firefox">firefox</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 </variablelist>
494
495 </sect2>
496
497</sect1>
Note: See TracBrowser for help on using the repository browser.