src/final-system/common/testsuitesagain.ch

   1 %
   2 % This is part of CLFSja package.
   3 %
   4 % This is a CTIE change file for the original XML source of the CLFSbook.
   5 %
   6 @x
   7 <?xml version="1.0" encoding="ISO-8859-1"?>
   8 @y
   9 <?xml version="1.0" encoding="UTF-8"?>
  10 @z
  11
  12 @x
  13   <title>About Test Suites, Again</title>
  14 @y
  15   <title>再びテストスイートについて</title>
  16 @z
  17
  18 @x
  19   <para>In the final-system build, you are no longer cross-compiling so it
  20   is possible to run package test suites. Running the test suite for a
  21   newly built package is a good idea because it can provide a <quote>sanity
  22   check</quote> indicating that everything compiled correctly. A test suite
  23   that passes its set of checks usually proves that the package is
  24   functioning as the developer intended. It does not, however, guarantee
  25   that the package is totally bug free.</para>
  26 @y
  27   <para>
  28   最終システムのビルドではもうクロスコンパイルは行いません。
  29   そこでようやくテストスイートの実行が出来るようになります。
  30   新たに構築したパッケージに対してはテストスイートを実行しておくのがよいでしょう。
  31   テストスイートは<quote>健全性検査 (sanity check)</quote>を行い、パッケージのコンパイルが正しく行われたことを確認します。
  32   テストスイートの実行によりいくつかのチェックが行われ、開発者の意図したとおりにパッケージが正しく動作することを確認していきます。
  33   ただこれは、パッケージにバグがないことを保証するものではありません。
  34   </para>
  35 @z
  36
  37 @x
  38   <para>Some test suites are more important than others. For example, the test
  39   suites for the core toolchain packages&mdash;GCC, Binutils,
  40   and Glibc&mdash;are of the utmost
  41   importance due to their central role in a properly functioning system.
  42   The test suites for GCC and Glibc can take a very long time to complete,
  43   especially on slower hardware, but are strongly recommended.</para>
  44 @y
  45   <para>
  46   テストスイートの中には他のものにも増して重要なものがあります。
  47   例えば、ツールチェーンの要である GCC、Binutils、Glibc に対してのテストスイートです。
  48   これらのパッケージはシステム機能を確実なものとする重要な役割を担うものであるためです。
  49   GCC と Glibc におけるテストスイートはかなりの時間を要します。
  50   それが低い性能のマシンであればなおさらです。
  51   でもそれらを実行しておくことを強く推奨します。
  52   </para>
  53 @z
  54
  55 @x
  56   <para>A common issue with running the test suites for Binutils and GCC
  57   is running out of pseudo terminals (PTYs). This can result in a high
  58   number of failing tests. This may happen for several reasons, but the
  59   most likely cause (if you chrooted) is that the host system does not have the
  60   <systemitem class="filesystem">devpts</systemitem> file system set up
  61   correctly. This issue is discussed in greater detail at
  62   <ulink url="&faq-root;#no-ptys"/>.</para>
  63 @y
  64   <para>
  65   Binutils と GCC におけるテストスイートの実行では、擬似端末 (pseudo terminals; PTY) を使い尽くす問題が発生します。
  66   これにより相当数のテストが失敗します。
  67   これが発生する理由はいくつかありますが、もっともありがちな理由として (chroot 時には) ホストシステムの <systemitem
  68   class="filesystem">devpts</systemitem> ファイルシステムが正しく構成されていないことがあげられます。
  69   この点については <ulink url="&faq-root;#no-ptys"/> においてかなり詳しく説明しています。
  70   </para>
  71 @z
  72
  73 @x
  74   <para>Sometimes package test suites will fail, but for reasons which the
  75   developers are aware of and have deemed non-critical. Consult the logs located
  76   at <ulink url="&test-results;"/> to verify whether or not these failures are
  77   expected. This site is valid for all tests throughout this book.</para>
  78 @y
  79   <para>
  80   パッケージの中にはテストスイートに失敗するものがあります。
  81   しかしこれらは開発元が認識しているもので致命的なものではありません。
  82   以下の <ulink url="&test-results;"/> に示すログを参照して、失敗したテストが実は予期されているものであるかどうかを確認してください。
  83   このサイトは本書におけるすべてのテストスイートの正常な処理結果を示すものです。
  84   </para>
  85 @z