newxml/chapter04/abouttestsuites.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6 <sect1 id="prepare-abouttestsuites">
   7 <title>About the test suites</title>
   8 <?dbhtml filename="abouttestsuites.html"?>
   9
  10 <para>Most packages provide a test suite. Running the test suite for a newly
  11 built package is generally a good idea, as it can provide a nice sanity check
  12 that everything compiled correctly. A test suite that passes its set of checks
  13 usually proves that the package is functioning as the developer intended. It
  14 does not, however, guarantee that the package is totally bug free.</para>
  15
  16 <para>Some test suites are more important than others. For example, the test
  17 suites for the core toolchain packages -- GCC, Binutils, and Glibc -- are of
  18 the utmost importance due to their central role in a properly functioning
  19 system. But be warned, the test suites for GCC and Glibc can take a very long
  20 time to complete, especially on slower hardware.</para>
  21
  22 <note><para>Experience has shown us that there is little to be gained from running
  23 the test suites in <xref linkend="chapter-temporary-tools"/>. There can be no
  24 escaping the fact that the host system always exerts some influence on the
  25 tests in that chapter, often causing weird and inexplicable failures. Not only
  26 that, the tools built in <xref linkend="chapter-temporary-tools"/> are
  27 temporary and eventually discarded. For the average reader of this book we
  28 recommend <emphasis>not</emphasis> to run the test suites in
  29 <xref linkend="chapter-temporary-tools"/>. The instructions for running those test
  30 suites are still provided for the benefit of testers and developers, but they
  31 are strictly optional for everyone else.</para></note>
  32
  33 <para>A common problem when running the test suites for Binutils and GCC is
  34 running out of pseudo terminals (PTYs for short). The symptom is a very high
  35 number of failing tests. This can happen for several reasons, but the most
  36 likely cause is that the host system doesn't have the
  37 <emphasis>devpts</emphasis> file system set up correctly. We'll discuss this in
  38 more detail later on in <xref linkend="chapter-temporary-tools"/>.</para>
  39
  40 <para>Sometimes package test suites will give false failures. You can
  41 consult the LFS Wiki at <ulink url="&wiki-root;"/> to verify that these
  42 failures are normal. This applies to all tests throughout the book.</para>
  43
  44 </sect1>