source: final-preps/abouttestsuites.xml @ 6a8ff5c

Last change on this file since 6a8ff5c was 6a8ff5c, checked in by Jim Gifford <clfs@…>, 18 years ago

r1017@server (orig r1015): chris | 2006-01-07 10:08:14 -0800
Modification to About Test Suites, and various minor fixes

  • Property mode set to 100644
File size: 2.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-final-preps-abouttestsuites">
9  <?dbhtml filename="abouttestsuites.html"?>
10
11  <title>About the Test Suites</title>
12
13  <para>TO BE REWRITTEN (and maybe moved to final-system chapter)</para>
14
15  <para>Most packages provide a test suite. Running the test suite for a
16  newly built package is a good idea because it can provide a <quote>sanity
17  check</quote> indicating that everything compiled correctly. A test suite
18  that passes its set of checks usually proves that the package is
19  functioning as the developer intended. It does not, however, guarantee
20  that the package is totally bug free.</para>
21
22  <para>Some test suites are more important than others. For example,
23  the test suites for the core toolchain packages&mdash;GCC, Binutils, and
24  Glibc&mdash;are of the utmost importance due to their central role in a
25  properly functioning system. The test suites for GCC and Glibc can
26  take a very long time to complete, especially on slower hardware, but
27  are strongly recommended.</para>
28
29  <note>
30    <para>It is not possible to run testsuites when cross-compiling, so there
31    are no instructions given for running testsuites until
32    <xref linkend="chapter-building-system"/>.</para>
33  </note>
34
35  <para>A common issue with running the test suites for Binutils and GCC
36  is running out of pseudo terminals (PTYs). This can result in a high
37  number of failing tests. This may happen for several reasons, but the
38  most likely cause is that the host system does not have the
39  <systemitem class="filesystem">devpts</systemitem> file system set up
40  correctly. This issue is discussed in greater detail at
41  <ulink url="http://www.linuxfromscratch.org/lfs/faq.html#no-ptys"/>.</para>
42
43  <para>Sometimes package test suites will fail, but for reasons which the
44  developers are aware of and have deemed non-critical. Consult the logs located
45  at <ulink url="&test-results;"/> to verify whether or not these failures are
46  expected. This site is valid for all tests throughout this book.</para>
47
48</sect1>
Note: See TracBrowser for help on using the repository browser.