mirror of
https://git.linuxfromscratch.org/lfs.git
synced 2025-06-18 19:29:21 +01:00
Adjust English idiom and clarify directions (chapters 4.5 and 4.6).
This commit is contained in:
parent
ec7b046623
commit
ef93b66006
@ -13,25 +13,25 @@
|
|||||||
<para>Many people would like to know beforehand approximately how long
|
<para>Many people would like to know beforehand approximately how long
|
||||||
it takes to compile and install each package. Because Linux From
|
it takes to compile and install each package. Because Linux From
|
||||||
Scratch can be built on many different systems, it is impossible to
|
Scratch can be built on many different systems, it is impossible to
|
||||||
provide accurate time estimates. The biggest package (Glibc) will
|
provide absolute time estimates. The biggest package (Glibc) will
|
||||||
take approximately 20 minutes on the fastest systems, but could take
|
take approximately 20 minutes on the fastest systems, but could take
|
||||||
up to three days on slower systems! Instead of providing actual times,
|
up to three days on slower systems! Instead of providing actual times,
|
||||||
the Standard Build Unit (SBU) measure will be
|
the Standard Build Unit (SBU) measure will be
|
||||||
used instead.</para>
|
used instead.</para>
|
||||||
|
|
||||||
<para>The SBU measure works as follows. The first package to be compiled
|
<para>The SBU measure works as follows. The first package to be compiled
|
||||||
from this book is binutils in <xref linkend="chapter-cross-tools"/>. The
|
is binutils in <xref linkend="chapter-cross-tools"/>. The
|
||||||
time it takes to compile this package is what will be referred to as the
|
time it takes to compile this package is what we will refer to as the
|
||||||
Standard Build Unit or SBU. All other compile times will be expressed relative
|
Standard Build Unit or SBU. All other compile times will be expressed in
|
||||||
to this time.</para>
|
terms of this unit of time.</para>
|
||||||
|
|
||||||
<para>For example, consider a package whose compilation time is 4.5
|
<para>For example, consider a package whose compilation time is 4.5
|
||||||
SBUs. This means that if a system took 10 minutes to compile and
|
SBUs. This means that if your system took 10 minutes to compile and
|
||||||
install the first pass of binutils, it will take
|
install the first pass of binutils, it will take
|
||||||
<emphasis>approximately</emphasis> 45 minutes to build this example package.
|
<emphasis>approximately</emphasis> 45 minutes to build the example package.
|
||||||
Fortunately, most build times are shorter than the one for binutils.</para>
|
Fortunately, most build times are shorter than one SBU.</para>
|
||||||
|
|
||||||
<para>In general, SBUs are not entirely accurate because they depend on many
|
<para>SBUs are not entirely accurate because they depend on many
|
||||||
factors, including the host system's version of GCC. They are provided here
|
factors, including the host system's version of GCC. They are provided here
|
||||||
to give an estimate of how long it might take to install a package, but the
|
to give an estimate of how long it might take to install a package, but the
|
||||||
numbers can vary by as much as dozens of minutes in some cases.</para>
|
numbers can vary by as much as dozens of minutes in some cases.</para>
|
||||||
@ -45,15 +45,15 @@
|
|||||||
|
|
||||||
<screen role="nodump"><userinput>export MAKEFLAGS='-j4'</userinput></screen>
|
<screen role="nodump"><userinput>export MAKEFLAGS='-j4'</userinput></screen>
|
||||||
|
|
||||||
<para>or just building with:</para>
|
<para>or by building with:</para>
|
||||||
|
|
||||||
<screen role="nodump"><userinput>make -j4</userinput></screen>
|
<screen role="nodump"><userinput>make -j4</userinput></screen>
|
||||||
|
|
||||||
<para>When multiple processors are used in this way, the SBU units in the
|
<para>When multiple processors are used in this way, the SBU units in the
|
||||||
book will vary even more than they normally would. In some cases, the make
|
book will vary even more than they normally would. In some cases, the make
|
||||||
step will simply fail. Analyzing the output of the build process will also
|
step will simply fail. Analyzing the output of the build process will also
|
||||||
be more difficult because the lines of different processes will be
|
be more difficult because the lines from different processes will be
|
||||||
interleaved. If you run into a problem with a build step, revert back to a
|
interleaved. If you run into a problem with a build step, revert to a
|
||||||
single processor build to properly analyze the error messages.</para>
|
single processor build to properly analyze the error messages.</para>
|
||||||
</note>
|
</note>
|
||||||
|
|
||||||
|
@ -27,21 +27,21 @@
|
|||||||
<note>
|
<note>
|
||||||
<para>Running the test suites in <xref linkend="chapter-cross-tools"/>
|
<para>Running the test suites in <xref linkend="chapter-cross-tools"/>
|
||||||
and <xref linkend="chapter-temporary-tools"/>
|
and <xref linkend="chapter-temporary-tools"/>
|
||||||
is impossible, since the programs are compiled with a cross-compiler,
|
is pointless; since the test programs are compiled with a cross-compiler,
|
||||||
so are not supposed to be able to run on the build host.</para>
|
they probably can't run on the build host.</para>
|
||||||
</note>
|
</note>
|
||||||
|
|
||||||
<para>A common issue with running the test suites for binutils and GCC
|
<para>A common issue with running the test suites for binutils and GCC
|
||||||
is running out of pseudo terminals (PTYs). This can result in a high
|
is running out of pseudo terminals (PTYs). This can result in a large
|
||||||
number of failing tests. This may happen for several reasons, but the
|
number of failing tests. This may happen for several reasons, but the
|
||||||
most likely cause is that the host system does not have the
|
most likely cause is that the host system does not have the
|
||||||
<systemitem class="filesystem">devpts</systemitem> file system set up
|
<systemitem class="filesystem">devpts</systemitem> file system set up
|
||||||
correctly. This issue is discussed in greater detail at
|
correctly. This issue is discussed in greater detail at
|
||||||
<ulink url="&lfs-root;lfs/faq.html#no-ptys"/>.</para>
|
<ulink url="&lfs-root;lfs/faq.html#no-ptys"/>.</para>
|
||||||
|
|
||||||
<para>Sometimes package test suites will fail, but for reasons which the
|
<para>Sometimes package test suites will fail for reasons which the
|
||||||
developers are aware of and have deemed non-critical. Consult the logs located
|
developers are aware of and have deemed non-critical. Consult the logs located
|
||||||
at <ulink url="&test-results;"/> to verify whether or not these failures are
|
at <ulink url="&test-results;"/> to verify whether or not these failures are
|
||||||
expected. This site is valid for all tests throughout this book.</para>
|
expected. This site is valid for all test suites throughout this book.</para>
|
||||||
|
|
||||||
</sect1>
|
</sect1>
|
||||||
|
Loading…
Reference in New Issue
Block a user