BOOK/chapter02/abouttestsuites.xml

   1 <sect1 id="ch-prepare-abouttestsuites">
   2 <title>About the test suites</title>
   3 <?dbhtml filename="abouttestsuites.html" dir="chapter02"?>
   4
   5 <para>Most packages provide a test suite. Running the test suite for a newly
   6 built package is generally a good idea, as it can provide a nice sanity check
   7 that everything compiled correctly. A test suite that passes its set of checks
   8 usually proves that the package is functioning mostly as the developer
   9 intended. It does not, however, guarantee that the package is totally bug
  10 free.</para>
  11
  12 <para>Some test suites are more important than others. For example, the test
  13 suites for the core toolchain packages -- GCC, Binutils, and Glibc (the C
  14 library) -- are of the utmost importance due to their central role in a
  15 properly functioning system. But be warned, the test suites for GCC and Glibc
  16 can take a very long time to complete, especially on slower hardware.</para>
  17
  18 <para>Experience has shown us that there is little to be gained from running
  19 the test suites in <xref linkend="chapter05"/>. There can be no escaping the
  20 fact that the host system always exerts influence on the tests in that chapter,
  21 often causing weird and inexplicable failures. Not only that, the tools built
  22 in <xref linkend="chapter05"/> are temporary and eventually discarded. For the
  23 average reader of this book we recommend <emphasis>not</emphasis> to run the
  24 test suites in <xref linkend="chapter05"/>. The instructions for running those
  25 test suites are still provided for the benefit of testers and developers, but
  26 they are strictly optional for everyone else.</para>
  27
  28 <para>As you progress through the book and encounter the commands to run the
  29 various test suites, we'll guide you on the relative importance of the test
  30 suite in question, so that you can decide for yourself whether to run that one
  31 or not.</para>
  32
  33 <note><para>A common problem when running the test suites for Binutils and GCC
  34 is running out of pseudo terminals (PTYs for short). The symptom is an
  35 unusually high number of failing tests. This can happen for a number of
  36 reasons. Most likely 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="chapter05"/>.</para></note>
  39
  40 </sect1>
  41